@danxbot/ui 5.2.0 → 6.0.0

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

@@ -137,18 +137,42 @@ declare const ring: import("tailwind-variants").TVReturnType<{
         sm: "size-10";
         md: "size-16";
         lg: "size-24";
+        /**
+         * A big donut standing in as a stat's own visual (`BigDonut`, demands'
+         * Extracted-tab EXTRACTED/AUDITS/HUMAN VERIFIED/answer-key row) needs more
+         * room than `lg` for a "count/total" fraction than a bare percentage ever
+         * did — `lg` was sized for two digits, and a real fraction runs to eight
+         * or nine characters even compacted ("1.1k/1.5k"). `xl` is that room.
+         */
+        xl: "size-32";
     };
 }, undefined, "relative grid shrink-0 place-items-center", {
     size: {
         sm: "size-10";
         md: "size-16";
         lg: "size-24";
+        /**
+         * A big donut standing in as a stat's own visual (`BigDonut`, demands'
+         * Extracted-tab EXTRACTED/AUDITS/HUMAN VERIFIED/answer-key row) needs more
+         * room than `lg` for a "count/total" fraction than a bare percentage ever
+         * did — `lg` was sized for two digits, and a real fraction runs to eight
+         * or nine characters even compacted ("1.1k/1.5k"). `xl` is that room.
+         */
+        xl: "size-32";
     };
 }, undefined, import("tailwind-variants").TVReturnTypeLike<{
     size: {
         sm: "size-10";
         md: "size-16";
         lg: "size-24";
+        /**
+         * A big donut standing in as a stat's own visual (`BigDonut`, demands'
+         * Extracted-tab EXTRACTED/AUDITS/HUMAN VERIFIED/answer-key row) needs more
+         * room than `lg` for a "count/total" fraction than a bare percentage ever
+         * did — `lg` was sized for two digits, and a real fraction runs to eight
+         * or nine characters even compacted ("1.1k/1.5k"). `xl` is that room.
+         */
+        xl: "size-32";
     };
 }, undefined>>;
 /** The tones a bar, meter or ring arc can be drawn in. */

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

@@ -0,0 +1,76 @@
+import { type ReactNode, type Ref } from "react";
+declare const readMore: import("tailwind-variants").TVReturnType<{
+    [key: string]: {
+        [key: string]: import("tailwind-variants").ClassValue | {
+            bar?: import("tailwind-variants").ClassValue;
+            content?: import("tailwind-variants").ClassValue;
+            toggle?: import("tailwind-variants").ClassValue;
+            root?: import("tailwind-variants").ClassValue;
+            viewport?: import("tailwind-variants").ClassValue;
+        };
+    };
+} | {
+    [x: string]: {
+        [x: string]: import("tailwind-variants").ClassValue | {
+            bar?: import("tailwind-variants").ClassValue;
+            content?: import("tailwind-variants").ClassValue;
+            toggle?: import("tailwind-variants").ClassValue;
+            root?: import("tailwind-variants").ClassValue;
+            viewport?: import("tailwind-variants").ClassValue;
+        };
+    };
+} | {}, {
+    root: string;
+    viewport: string[];
+    content: string;
+    bar: string;
+    toggle: string;
+}, undefined, {
+    [key: string]: {
+        [key: string]: import("tailwind-variants").ClassValue | {
+            bar?: import("tailwind-variants").ClassValue;
+            content?: import("tailwind-variants").ClassValue;
+            toggle?: import("tailwind-variants").ClassValue;
+            root?: import("tailwind-variants").ClassValue;
+            viewport?: import("tailwind-variants").ClassValue;
+        };
+    };
+} | {}, {
+    root: string;
+    viewport: string[];
+    content: string;
+    bar: string;
+    toggle: string;
+}, import("tailwind-variants").TVReturnTypeLike<unknown, {
+    root: string;
+    viewport: string[];
+    content: string;
+    bar: string;
+    toggle: string;
+}>>;
+export interface ReadMoreProps {
+    /** Collapsed line count — how many rendered lines show before the fade strip. Must be a positive integer; anything else throws. */
+    lines: number;
+    /** Typically rendered Markdown — paragraphs, headings, lists, code, images. See the module comment on why the clamp is a measured line boundary rather than a computed height. */
+    children: ReactNode;
+    /** Controlled expanded state. Omit to let the component hold its own (seeded by `defaultExpanded`). */
+    expanded?: boolean;
+    /** Uncontrolled initial state. Ignored once `expanded` is supplied. @default false */
+    defaultExpanded?: boolean;
+    /** Fires on every toggle, controlled or not. */
+    onExpandedChange?: (expanded: boolean) => void;
+    /** @default "Read more" */
+    moreLabel?: string;
+    /** @default "Show less" */
+    lessLabel?: string;
+    className?: string;
+    ref?: Ref<HTMLDivElement>;
+}
+/**
+ * Clamp block content to `lines` rendered lines behind a fade strip and a
+ * single "Read more" / "Show less" toggle. Renders neither the strip nor the
+ * toggle when the content already fits — see the module comment for how that
+ * is decided.
+ */
+export declare function ReadMore({ lines, children, expanded: expandedProp, defaultExpanded, onExpandedChange, moreLabel, lessLabel, className, ref, }: ReadMoreProps): import("react").JSX.Element;
+export { readMore as readMoreVariants };

package/dist/types/components/provenance/ProvenanceDetail.d.ts

@@ -45,6 +45,15 @@ export interface ProvenanceDetailProps {
      * consumer putting its editor in `actions`, which reads as "here is the
      * value, and separately, down here, a form about some value".
      *
+     * AN `InlineEdit` HERE STILL NEEDS THE OVERWRITE-PROTECTION CONTRACT IT
+     * SHIPS WITH (DX-2930) — this panel can stay open while the underlying
+     * record keeps changing (a re-extraction, another reviewer's own edit), so
+     * an `onCommit={(next, base) => …}` that compares `base` against whatever
+     * the caller currently believes is authoritative, plus an
+     * `onEditingChange` that suspends re-rendering `record` while someone is
+     * mid-edit, is what stops this panel from resetting a draft out from under
+     * whoever opened it. See `content/docs/provenance.mdx` for the shape.
+     *
      * IT OVERRIDES THE ABSENCES TOO — redacted, empty and failed alike. A slot
      * that disappeared whenever the value was missing would vanish in exactly the
      * case a value editor is most wanted: a field that was never extracted is the

package/dist/types/index.d.ts

@@ -57,7 +57,8 @@ export { Progress, Meter, ProgressRing, type ProgressProps, type MeterProps, typ
 export { Stat, StatRow, Sparkline, type StatProps, type StatRowProps, type SparklineProps, type StatSize, type StatTrend, type StatSentiment, } from "./components/Stat";
 export { DataTable, TableEmptyState, CellStack, type DataTableProps, type TableDensity, } from "./components/Table";
 export { CodeEditor, CodeEditorToolbar, CodeEditorCaption, CodeEditorCopyButton, CodeEditorWrapToggle, CodeEditorViewSwitch, type CodeEditorProps, type CodeEditorToolbarProps, type CodeEditorView, } from "./components/CodeEditor";
-export { MarkdownEditor, type MarkdownEditorProps } from "./components/MarkdownEditor";
+export { MarkdownEditor, type MarkdownEditorProps, type MarkdownEditorHandle, } from "./components/MarkdownEditor";
+export { ReadMore, readMoreVariants, type ReadMoreProps } from "./components/ReadMore";
 export { MarkdownSurface, type SurfaceOptions, type Splice } from "./lib/markdown/surface";
 export { project, projectedText, ProjectionError } from "./lib/markdown/project";
 export type { Projection, PNode, PText, PElement } from "./lib/markdown/project";
@@ -91,7 +92,7 @@ export { ModelSelector, type ModelSelectorProps, type ChatModel, } from "./compo
 export { EffortControl, DEFAULT_EFFORT_LEVELS, type EffortControlProps, type EffortLevel, } from "./components/chat/EffortControl";
 export { ContextMeter, ChatStatus, type ContextMeterProps, type ContextSegment, type UsageLimit, type ChatStatusProps, } from "./components/chat/ContextMeter";
 export { cn } from "./lib/cn";
-export { formatBytes, formatTokens } from "./lib/format";
+export { formatBytes, formatTokens, formatCompactNumber } from "./lib/format";
 export { formatDate, parseDate, formatDateTime, parseDateTime, type FormatDateTimeOptions, type ParseDateTimeOptions, formatCurrency, parseCurrency, formatPhone, parsePhone, formatNumber, parseNumber, type FormatNumberOptions, formatBoolean, parseBoolean, type FormatBooleanOptions, } from "./lib/values";
 export { useFillHeight } from "./lib/use-fill-height";
 export { useTheme, useUiScale, useContrast, useMotionPreference, type Theme, type UiScale, type ContrastPreference, type MotionPreference, } from "./lib/preferences";

package/dist/types/lib/format.d.ts

@@ -1,12 +1,32 @@
 /** Binary units, because these are file sizes and every OS reports them this way. */
 export declare function formatBytes(bytes: number): string;
 /**
- * 241_600 → "241.6k".
- *
- * One decimal all the way to 1M, and exact below 1k. Unlike a file size — where
- * a tenth of a kilobyte is noise on a number nobody acts on — the tenth here is
- * the digit that moves while you work: at 1M capacity, a whole percent is
- * 10_000 tokens, so rounding to "242k" holds a figure still for several
- * exchanges and makes a live meter look frozen.
+ * 241_600 → "241.6k". A thin, token-domain-named wrapper — see
+ * `formatCompactNumber` below for the shared algorithm and its own reasoning.
+ * Kept as its own function (rather than every call site switching to the
+ * generic one directly) because "tokens" is a real vocabulary word in this
+ * package's chat components, and renaming every call site to the generic name
+ * would cost real diff for zero behavioral gain.
  */
 export declare function formatTokens(tokens: number): string;
+/**
+ * A GENERIC large count, abbreviated the way a person reads it aloud:
+ * `850` → `"850"`, `1_100` → `"1.1k"`, `3_400_000` → `"3.4M"`,
+ * `4_400_000_000` → `"4.4B"`. `null` / `undefined` / non-finite → `"—"`.
+ *
+ * One decimal per tier (k/M/B/T), trimmed of a trailing ".0" (`1_000_000` →
+ * `"1M"`, not `"1.0M"`), and exact below 1,000 — a count small enough to read
+ * digit-by-digit gets no abbreviation at all, since "850" is not improved by
+ * becoming "0.9k". This is the same one-decimal-per-tier shape `formatTokens`
+ * already used for a token budget; the difference that justified a SEPARATE,
+ * generic export rather than just widening that one is scope: `formatTokens`
+ * is a token-budget's own vocabulary (a live context meter), while this
+ * function is for any large count a screen needs to abbreviate — a field
+ * tally, a donut's fraction, a record count — with no token-specific meaning
+ * attached to its name.
+ *
+ * NEGATIVE VALUES keep their sign (`-1_100` → `"-1.1k"`) rather than being
+ * treated as absent — a generic count utility cannot assume its caller's
+ * domain never has one, the way `formatTokens`'s own callers do.
+ */
+export declare function formatCompactNumber(value: number | null | undefined): string;

package/dist/types/pure.d.ts

@@ -38,5 +38,5 @@
  * Everything exported here is ALSO exported from the main entry, so nothing
  * about this is a migration and no existing import has to change.
  */
-export { formatBytes, formatTokens } from "./lib/format";
+export { formatBytes, formatTokens, formatCompactNumber } from "./lib/format";
 export { formatDate, parseDate, formatDateTime, parseDateTime, type FormatDateTimeOptions, type ParseDateTimeOptions, formatCurrency, parseCurrency, formatPhone, parsePhone, formatNumber, parseNumber, type FormatNumberOptions, formatBoolean, parseBoolean, type FormatBooleanOptions, } from "./lib/values";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "5.2.0",
+  "version": "6.0.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",
@@ -73,7 +73,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-shell.mjs && node scripts/probe-card-header.mjs && node scripts/probe-inline-edit.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-shell.mjs && node scripts/probe-card-header.mjs && node scripts/probe-inline-edit.mjs && node scripts/probe-read-more.mjs",
     "sync": "node scripts/sync.mjs",
     "visual": "node scripts/visual-docker.mjs",
     "visual:update": "node scripts/visual-docker.mjs --update-snapshots",