@godxjp/ui 20.0.0 → 20.1.0

package/dist/i18n/messages/ja.json

@@ -23,7 +23,8 @@
     },
     "datePicker": {
       "placeholder": "日付を選択",
-      "openCalendar": "カレンダーを開く"
+      "openCalendar": "カレンダーを開く",
+      "quarter": "第{quarter}四半期"
     },
     "dateRangePicker": {
       "placeholder": "期間を選択",
@@ -39,7 +40,10 @@
       "openPicker": "時刻を選択",
       "meridiem": "午前/午後",
       "am": "午前",
-      "pm": "午後"
+      "pm": "午後",
+      "now": "現在時刻",
+      "confirm": "確定",
+      "second": "秒"
     },
     "searchInput": {
       "placeholder": "検索…"
@@ -55,7 +59,7 @@
     "upload": {
       "dropzoneLabel": "ファイルをアップロード",
       "dropzoneHint": "ここにドラッグ＆ドロップ、またはクリックして選択",
-      "dropzoneMeta": "一時ストレージに保存 — フォーム保存時に promote",
+      "dropzoneMeta": "選択したファイルはここに表示されます。",
       "buttonLabel": "ファイルを選択",
       "addImage": "画像を追加",
       "uploading": "アップロード中…",
@@ -75,7 +79,17 @@
       "statusFailed": "{count} 件のアップロードに失敗",
       "removeImage": "画像を削除",
       "removeFile": "{name} を削除",
-      "cropDescription": "ズームスライダーを調整し、保存すると写真を正方形に切り抜きます。"
+      "cropDescription": "ズームスライダーを調整し、保存すると写真を正方形に切り抜きます。",
+      "preview": "プレビュー",
+      "download": "ダウンロード",
+      "retry": "再試行",
+      "start": "アップロード",
+      "cancel": "キャンセル",
+      "rejectAccept": "{name}: 許可されていない形式です。",
+      "rejectSize": "{name}: ファイルが大きすぎます。",
+      "rejectCount": "{name}: ファイル数の上限です。",
+      "rejectBeforeUpload": "{name}: ファイルの検証に失敗しました。",
+      "readFailed": "選択したフォルダーを読み取れませんでした。"
     },
     "cascader": {
       "placeholder": "選択…",
@@ -109,6 +123,9 @@
       "empty": "該当なし",
       "error": "選択肢を読み込めませんでした"
     },
+    "selection": {
+      "overflow": "他{count}件"
+    },
     "monthPicker": {
       "openGrid": "月選択を開く",
       "previousYear": "前年へ",
@@ -132,6 +149,14 @@
     },
     "formErrors": {
       "title": "入力内容にエラーがあります"
+    },
+    "form": {
+      "optional": "（任意）",
+      "success": "確認済み",
+      "warning": "確認してください",
+      "error": "入力エラー",
+      "validating": "確認中",
+      "submitFailed": "フォームを送信できませんでした。再試行してください。"
     }
   },
   "feedback": {
@@ -284,8 +309,13 @@
     }
   },
   "navigation": {
+    "tabs": {
+      "addTab": "タブを追加",
+      "removeTab": "タブを閉じる"
+    },
     "steps": {
       "ariaLabel": "進行状況",
+      "percentLabel": "現在のステップの進捗",
       "status": {
         "wait": "未完了",
         "process": "現在のステップ",
@@ -323,6 +353,7 @@
       "page": "ページ {page}",
       "pageSize": "ページサイズ",
       "pageSizeTrigger": "{size}件",
+      "jumpTo": "ページへ移動",
       "pageSizeOption": "{size} 件/ページ",
       "total": "全 {total} 件"
     },
@@ -398,7 +429,19 @@
     "error": "一覧を取得できませんでした",
     "errorDescription": "データを取得できませんでした。時間をおいて再試行してください。",
     "denied": "この一覧を表示する権限がありません",
-    "deniedDescription": "閲覧するには管理者に権限の付与を依頼してください。"
+    "deniedDescription": "閲覧するには管理者に権限の付与を依頼してください。",
+    "selectInvert": "選択を反転",
+    "selectNone": "選択を解除",
+    "selectionMenu": "選択オプション",
+    "filterColumn": "絞り込み",
+    "filterReset": "絞り込みを解除",
+    "expandColumn": "展開",
+    "expandRow": "行を展開",
+    "collapseRow": "行を折りたたむ",
+    "sortAscending": "昇順に並べ替え",
+    "sortDescending": "降順に並べ替え",
+    "sortCancel": "並べ替えを解除",
+    "selectColumn": "選択"
   },
   "dataGrid": {
     "search": "検索",
@@ -466,5 +509,13 @@
     "summaryPie": "{slices}区分の円グラフ",
     "summaryTrend": "{points}データ点の推移棒グラフ",
     "trendCurrent": "現在"
+  },
+  "rangeTimeline": {
+    "outsideRange": "表示範囲外",
+    "schedule": "スケジュール"
+  },
+  "textExamples": {
+    "preservedText": "プレーンテキスト",
+    "sampleText": "最初の行\n  字下げした行\n\n最後の行"
   }
 }

package/dist/i18n/messages/vi.json

@@ -23,7 +23,8 @@
     },
     "datePicker": {
       "placeholder": "Chọn ngày",
-      "openCalendar": "Mở lịch"
+      "openCalendar": "Mở lịch",
+      "quarter": "Quý {quarter}"
     },
     "dateRangePicker": {
       "placeholder": "Chọn khoảng ngày",
@@ -39,7 +40,10 @@
       "openPicker": "Mở chọn giờ",
       "meridiem": "Buổi",
       "am": "SA",
-      "pm": "CH"
+      "pm": "CH",
+      "now": "Bây giờ",
+      "confirm": "Chọn",
+      "second": "Giây"
     },
     "searchInput": {
       "placeholder": "Tìm kiếm…"
@@ -55,7 +59,7 @@
     "upload": {
       "dropzoneLabel": "Tải file lên",
       "dropzoneHint": "Kéo thả file vào đây, hoặc bấm để chọn",
-      "dropzoneMeta": "Upload vào temp — promote khi lưu form",
+      "dropzoneMeta": "Tệp đã chọn sẽ hiển thị tại đây.",
       "buttonLabel": "Chọn file",
       "addImage": "Thêm ảnh",
       "uploading": "Đang tải lên…",
@@ -75,7 +79,17 @@
       "statusFailed": "{count} tệp tải lên thất bại",
       "removeImage": "Xóa ảnh",
       "removeFile": "Xóa {name}",
-      "cropDescription": "Kéo thanh thu phóng rồi lưu để cắt ảnh thành hình vuông."
+      "cropDescription": "Kéo thanh thu phóng rồi lưu để cắt ảnh thành hình vuông.",
+      "preview": "Xem trước",
+      "download": "Tải xuống",
+      "retry": "Thử lại",
+      "start": "Tải lên",
+      "cancel": "Huỷ",
+      "rejectAccept": "{name}: loại tệp không được phép.",
+      "rejectSize": "{name}: tệp quá lớn.",
+      "rejectCount": "{name}: đã đủ số lượng tệp.",
+      "rejectBeforeUpload": "{name}: kiểm tra tệp thất bại.",
+      "readFailed": "Không thể đọc thư mục đã chọn."
     },
     "cascader": {
       "placeholder": "Chọn…",
@@ -109,6 +123,9 @@
       "empty": "Không có kết quả",
       "error": "Không tải được lựa chọn"
     },
+    "selection": {
+      "overflow": "+{count}"
+    },
     "monthPicker": {
       "openGrid": "Mở chọn tháng",
       "previousYear": "Năm trước",
@@ -132,6 +149,14 @@
     },
     "formErrors": {
       "title": "Dữ liệu nhập có lỗi, vui lòng kiểm tra"
+    },
+    "form": {
+      "optional": "(không bắt buộc)",
+      "success": "Hợp lệ",
+      "warning": "Cần kiểm tra",
+      "error": "Không hợp lệ",
+      "validating": "Đang kiểm tra",
+      "submitFailed": "Không thể gửi biểu mẫu. Vui lòng thử lại."
     }
   },
   "feedback": {
@@ -284,8 +309,13 @@
     }
   },
   "navigation": {
+    "tabs": {
+      "addTab": "Thêm tab",
+      "removeTab": "Đóng tab"
+    },
     "steps": {
       "ariaLabel": "Tiến trình",
+      "percentLabel": "Tiến độ bước hiện tại",
       "status": {
         "wait": "Đang chờ",
         "process": "Bước hiện tại",
@@ -323,6 +353,7 @@
       "page": "Trang {page}",
       "pageSize": "Số dòng mỗi trang",
       "pageSizeTrigger": "{size} / trang",
+      "jumpTo": "Tới trang",
       "pageSizeOption": "{size} / trang",
       "total": "Tổng {total} mục"
     },
@@ -398,7 +429,19 @@
     "error": "Không tải được danh sách này",
     "errorDescription": "Không lấy được dữ liệu. Vui lòng thử lại sau giây lát.",
     "denied": "Bạn không có quyền xem danh sách này",
-    "deniedDescription": "Hãy đề nghị quản trị viên cấp quyền xem các bản ghi này."
+    "deniedDescription": "Hãy đề nghị quản trị viên cấp quyền xem các bản ghi này.",
+    "selectInvert": "Đảo lựa chọn",
+    "selectNone": "Bỏ chọn tất cả",
+    "selectionMenu": "Tuỳ chọn lựa chọn",
+    "filterColumn": "Lọc",
+    "filterReset": "Bỏ lọc",
+    "expandColumn": "Mở rộng",
+    "expandRow": "Mở rộng hàng",
+    "collapseRow": "Thu gọn hàng",
+    "sortAscending": "Sắp xếp tăng dần",
+    "sortDescending": "Sắp xếp giảm dần",
+    "sortCancel": "Bỏ sắp xếp",
+    "selectColumn": "Chọn"
   },
   "dataGrid": {
     "search": "Tìm kiếm",
@@ -466,5 +509,13 @@
     "summaryPie": "Biểu đồ tròn gồm {slices} phần",
     "summaryTrend": "Biểu đồ cột xu hướng gồm {points} điểm dữ liệu",
     "trendCurrent": "hiện tại"
+  },
+  "rangeTimeline": {
+    "outsideRange": "Ngoài khoảng đang xem",
+    "schedule": "Lịch công việc"
+  },
+  "textExamples": {
+    "preservedText": "Văn bản thuần",
+    "sampleText": "Dòng đầu\n  Dòng thụt vào\n\nDòng cuối"
   }
 }

package/dist/inertia/index.d.ts

@@ -11,6 +11,7 @@ export interface InertiaFormLike<TData extends Record<string, unknown> = Record<
     errors: Partial<Record<string, string>>;
     /** True while a submit request is in flight. */
     processing: boolean;
+    reset?(): void;
 }
 /**
  * Wrap an Inertia `useForm()` object as a framework-agnostic {@link FormStateAdapter} so it drives
@@ -105,3 +106,22 @@ export interface InertiaLinkLike {
  * ```
  */
 export declare function inertiaSidebarLink<P extends InertiaLinkLike>(Link: ComponentType<P>): SidebarLinkComponentProp;
+/** Visit callbacks needed to connect Upload to an Inertia multipart endpoint. */
+export interface InertiaUploadCallbacks {
+    forceFormData: true;
+    async: true;
+    onProgress: (progress: {
+        percentage?: number;
+    } | undefined) => void;
+    onSuccess: () => void;
+    onError: (errors: Record<string, string>) => void;
+    onCancelToken: (token: {
+        cancel: () => void;
+    }) => void;
+    onCancel: () => void;
+    onNetworkError: (error: Error) => boolean;
+    onHttpException: () => boolean;
+    onFinish: () => void;
+}
+/** Bridge redirect-based Inertia uploads to Upload's progress/abort/retry lifecycle. */
+export declare function inertiaUpload(send: (file: File, callbacks: InertiaUploadCallbacks) => void, errorMessage: string): NonNullable<import("../props/components/data-entry.prop.js").UploadProp["onUpload"]>;

package/dist/inertia/index.js

@@ -6,7 +6,8 @@ function inertiaAdapter(form) {
     setValue: (name, value) => form.setData(name, value),
     getError: (name) => form.errors[name],
     isSubmitting: form.processing,
-    getValues: () => form.data
+    getValues: () => form.data,
+    reset: form.reset ? () => form.reset?.() : void 0
   };
 }
 function useInertiaField(form, name) {
@@ -20,8 +21,66 @@ function useInertiaField(form, name) {
 function inertiaSidebarLink(Link) {
   return createSidebarLink(Link, "href");
 }
+function inertiaUpload(send, errorMessage) {
+  return (file, _item, context) => new Promise((resolve, reject) => {
+    let cancel;
+    let settled = false;
+    const abort = () => {
+      cancel?.();
+      fail(new DOMException("Upload aborted", "AbortError"));
+    };
+    const cleanup = () => context.signal.removeEventListener("abort", abort);
+    const fail = (error) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      reject(error);
+    };
+    if (context.signal.aborted) {
+      abort();
+      return;
+    }
+    context.signal.addEventListener("abort", abort, { once: true });
+    try {
+      send(file, {
+        forceFormData: true,
+        async: true,
+        onProgress: (progress) => {
+          if (!settled) context.onProgress(progress?.percentage ?? 0);
+        },
+        onSuccess: () => {
+          if (!settled) {
+            settled = true;
+            cleanup();
+            resolve({});
+          }
+        },
+        onError: (errors) => fail(new Error(Object.values(errors)[0] ?? errorMessage)),
+        onCancelToken: (token) => {
+          cancel = token.cancel;
+          if (context.signal.aborted) token.cancel();
+        },
+        onCancel: () => fail(new DOMException("Upload aborted", "AbortError")),
+        onNetworkError: () => {
+          fail(new Error(errorMessage));
+          return false;
+        },
+        onHttpException: () => {
+          fail(new Error(errorMessage));
+          return false;
+        },
+        onFinish: () => {
+          if (!settled) fail(new Error(errorMessage));
+        }
+      });
+    } catch (error) {
+      fail(error);
+    }
+  });
+}
 export {
   inertiaAdapter,
   inertiaSidebarLink,
+  inertiaUpload,
   useInertiaField
 };

package/dist/lib/control-styles.d.ts

@@ -1,18 +1,40 @@
 /** Shared control sizing — reads `--control-height`, `--font-size-*` from density / theme. */
-export declare const controlMultilineClass = "ui-control-multiline aria-invalid:border-destructive w-full rounded-[var(--control-radius)] border-input bg-background ring-offset-background placeholder:text-muted-foreground focus-visible:outline-none";
+export declare const controlMultilineClass = "ui-control-multiline aria-invalid:border-destructive data-[status=error]:border-destructive data-[status=warning]:border-warning w-full rounded-[var(--control-radius)] border-input bg-background ring-offset-background placeholder:text-muted-foreground";
 /**
  * Multiline control with its own chrome removed, for a textarea EMBEDDED in a surface that already
  * draws the box — a chat composer inside a Card, an inline edit cell, a comment box in a panel.
  * Two nested rounded borders is the tell that this was missing.
  */
-export declare const controlMultilineGhostClass = "ui-control-multiline w-full min-h-0 border-0 bg-transparent shadow-none placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-0";
+export declare const controlMultilineGhostClass = "ui-control-multiline data-[status=error]:border-destructive data-[status=warning]:border-warning w-full min-h-0 border-0 bg-transparent shadow-none placeholder:text-muted-foreground focus-visible:ring-0";
+/**
+ * Multiline control drawn as antd's `filled` variant — a tinted surface instead of a boundary.
+ *
+ * It is a SEPARATE string rather than `controlMultilineClass` plus a modifier because
+ * `bg-background` lives in `@layer utilities`, which outranks every component-layer rule: a
+ * `.ui-control--filled` appended to the outlined list would be silently overpainted and no gate
+ * would catch it. The two lists differ only in which chrome utilities they carry.
+ */
+export declare const controlMultilineFilledClass = "ui-control-multiline ui-control--filled aria-invalid:border-destructive data-[status=error]:border-destructive data-[status=warning]:border-warning w-full rounded-[var(--control-radius)] ring-offset-background placeholder:text-muted-foreground";
 /**
  * Open-state ring for popup-style triggers (Select / Cascader / TreeSelect / SearchSelect). Radix
  * moves focus INTO the popup on open, so the trigger loses `:focus-visible` and — without this —
  * an open popover shows only a border change (no ring), inconsistent with a focused Input.
  */
 export declare const controlOpenRingClass = "ui-control-trigger";
-export declare const controlTriggerClass = "ui-control ui-control-trigger flex items-center justify-between gap-2 whitespace-nowrap rounded-[var(--control-radius)] border-input bg-background transition-[color,box-shadow] focus-visible:outline-none [&>[data-slot=select-value]]:line-clamp-1";
+/**
+ * The trigger WITHOUT a surface — no `border-input`, no `bg-background`.
+ *
+ * Those two are Tailwind utilities, and `@layer utilities` beats `@layer components`, so a
+ * `[data-variant]` / `[data-status]` rule in control.css can never recolour a trigger that carries
+ * them (the same trap that killed `.ui-app-setting-picker-icon` in gh#366 and
+ * `--control-bounded-width` in gh#375). A control that wants the antd `variant` × `status` matrix
+ * therefore composes THIS class plus `ui-control-surface`, which supplies the identical resting
+ * border and fill from `--control-surface-*`.
+ */
+export declare const controlTriggerBaseClass = "ui-control ui-control-trigger flex items-center justify-between gap-2 whitespace-nowrap rounded-[var(--control-radius)] transition-[color,box-shadow] [&>[data-slot=select-value]]:line-clamp-1";
+export declare const controlTriggerClass = "ui-control ui-control-trigger flex items-center justify-between gap-2 whitespace-nowrap rounded-[var(--control-radius)] transition-[color,box-shadow] [&>[data-slot=select-value]]:line-clamp-1 border-input bg-background";
+/** `controlTriggerBaseClass` + the token-driven surface — the select-family trigger. */
+export declare const controlSurfaceTriggerClass = "ui-control ui-control-trigger flex items-center justify-between gap-2 whitespace-nowrap rounded-[var(--control-radius)] transition-[color,box-shadow] [&>[data-slot=select-value]]:line-clamp-1 ui-control-surface";
 export declare const controlIconClass = "size-[length:var(--control-height)] shrink-0";
 export declare const controlIconSmClass = "size-[calc(var(--control-height)-0.5rem)] shrink-0";
 /** Leading/affix icon inside an input row (search, command) — sized to `--control-icon-size`. */

package/dist/lib/control-styles.js

@@ -1,7 +1,10 @@
-const controlMultilineClass = "ui-control-multiline aria-invalid:border-destructive w-full rounded-[var(--control-radius)] border-input bg-background ring-offset-background placeholder:text-muted-foreground focus-visible:outline-none";
-const controlMultilineGhostClass = "ui-control-multiline w-full min-h-0 border-0 bg-transparent shadow-none placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-0";
+const controlMultilineClass = "ui-control-multiline aria-invalid:border-destructive data-[status=error]:border-destructive data-[status=warning]:border-warning w-full rounded-[var(--control-radius)] border-input bg-background ring-offset-background placeholder:text-muted-foreground";
+const controlMultilineGhostClass = "ui-control-multiline data-[status=error]:border-destructive data-[status=warning]:border-warning w-full min-h-0 border-0 bg-transparent shadow-none placeholder:text-muted-foreground focus-visible:ring-0";
+const controlMultilineFilledClass = "ui-control-multiline ui-control--filled aria-invalid:border-destructive data-[status=error]:border-destructive data-[status=warning]:border-warning w-full rounded-[var(--control-radius)] ring-offset-background placeholder:text-muted-foreground";
 const controlOpenRingClass = "ui-control-trigger";
-const controlTriggerClass = "ui-control ui-control-trigger flex items-center justify-between gap-2 whitespace-nowrap rounded-[var(--control-radius)] border-input bg-background transition-[color,box-shadow] focus-visible:outline-none [&>[data-slot=select-value]]:line-clamp-1";
+const controlTriggerBaseClass = "ui-control ui-control-trigger flex items-center justify-between gap-2 whitespace-nowrap rounded-[var(--control-radius)] transition-[color,box-shadow] [&>[data-slot=select-value]]:line-clamp-1";
+const controlTriggerClass = `${controlTriggerBaseClass} border-input bg-background`;
+const controlSurfaceTriggerClass = `${controlTriggerBaseClass} ui-control-surface`;
 const controlIconClass = "size-[length:var(--control-height)] shrink-0";
 const controlIconSmClass = "size-[calc(var(--control-height)-0.5rem)] shrink-0";
 const controlIconLeadingClass = "size-[length:var(--control-icon-size)] shrink-0";
@@ -20,8 +23,11 @@ export {
   controlIconLeadingClass,
   controlIconSmClass,
   controlMultilineClass,
+  controlMultilineFilledClass,
   controlMultilineGhostClass,
   controlOpenRingClass,
+  controlSurfaceTriggerClass,
+  controlTriggerBaseClass,
   controlTriggerClass,
   tableCellPaddingClass,
   tableHeadHeightClass,

package/dist/lib/datetime/picker-format.d.ts

@@ -0,0 +1,8 @@
+import { type Locale } from "date-fns";
+import type { DatePickerBaseProp, PickerDateFormatProp } from "../../props/components/data-entry.prop.js";
+/** Display is independent from the canonical value submitted by the field. */
+export declare function formatPickerDate(date: Date | undefined, format: PickerDateFormatProp | undefined, locale: string, withTime?: boolean): string;
+export declare function parsePickerDate(text: string, format: PickerDateFormatProp | undefined, parser?: (text: string) => Date | undefined, withTime?: boolean): Date | undefined;
+export declare function pickerDateAllowed(date: Date, min: Date | undefined, max: Date | undefined, disabled?: (date: Date) => boolean): boolean;
+/** Normalize a reporting period with the active calendar's week convention. */
+export declare function pickerPeriodStart(date: Date, picker: DatePickerBaseProp["picker"], locale: Pick<Locale, "options">): Date;

package/dist/lib/datetime/picker-format.js

@@ -0,0 +1,54 @@
+import {
+  format as formatDate,
+  isValid,
+  parse,
+  startOfDay,
+  startOfWeek,
+  startOfMonth,
+  startOfQuarter,
+  startOfYear
+} from "date-fns";
+import { parseDateInput, toIsoDate } from "./parse.js";
+function formatPickerDate(date, format, locale, withTime = false) {
+  if (!date || !isValid(date)) return "";
+  if (typeof format === "function") return format(date);
+  if (typeof format === "object") return new Intl.DateTimeFormat(locale, format).format(date);
+  if (typeof format === "string") return formatDate(date, format);
+  return withTime ? formatDate(date, "yyyy-MM-dd HH:mm") : toIsoDate(date);
+}
+function parsePickerDate(text, format, parser, withTime = false) {
+  const raw = text.trim();
+  if (!raw) return void 0;
+  const custom = parser?.(raw);
+  if (custom && isValid(custom)) return custom;
+  const pattern = typeof format === "string" ? format : withTime ? "yyyy-MM-dd HH:mm" : void 0;
+  if (pattern) {
+    const parsed = parse(raw, pattern, new Date(2e3, 0, 1));
+    if (isValid(parsed) && formatDate(parsed, pattern) === raw) return parsed;
+  }
+  if (withTime || !/^\d{4}-\d{2}-\d{2}$/.test(raw)) return void 0;
+  return parseDateInput(raw) ?? void 0;
+}
+function pickerDateAllowed(date, min, max, disabled) {
+  return isValid(date) && (!min || startOfDay(date) >= startOfDay(min)) && (!max || startOfDay(date) <= startOfDay(max)) && !disabled?.(date);
+}
+function pickerPeriodStart(date, picker, locale) {
+  switch (picker) {
+    case "week":
+      return startOfWeek(date, { locale });
+    case "month":
+      return startOfMonth(date);
+    case "quarter":
+      return startOfQuarter(date);
+    case "year":
+      return startOfYear(date);
+    default:
+      return date;
+  }
+}
+export {
+  formatPickerDate,
+  parsePickerDate,
+  pickerDateAllowed,
+  pickerPeriodStart
+};

package/dist/props/components/charts.prop.d.ts

@@ -22,6 +22,13 @@ type ChartCartesianBase = {
     categoryKey: string;
     /** Accessible name + visible caption for the chart. REQUIRED (role="img" needs a name). */
     label: LabelProp;
+    /**
+     * Paint `label` as a visible caption above the plot. Set `false` when the chart already sits
+     * under a heading that says the same thing (a `CardTitle`, a section `<h2>`): the caption stays
+     * in the DOM as `sr-only`, so `role="img"` keeps its accessible name and only the duplicated
+     * visible title goes away.
+     */
+    showCaption?: boolean;
     /** Extra context appended to the screen-reader description. */
     description?: DescriptionProp;
     /** Canvas height preset — `xs|sm|md|lg`. Ignored when `height` is set. */
@@ -67,6 +74,13 @@ export type CompactBarTrendProp = {
     valueKey: string;
     /** Accessible name + visible caption for the chart. REQUIRED (role="img" needs a name). */
     label: LabelProp;
+    /**
+     * Paint `label` as a visible caption above the plot. Set `false` when the chart already sits
+     * under a heading that says the same thing (a `CardTitle`, a section `<h2>`): the caption stays
+     * in the DOM as `sr-only`, so `role="img"` keeps its accessible name and only the duplicated
+     * visible title goes away.
+     */
+    showCaption?: boolean;
     /** Extra context appended to the screen-reader description. */
     description?: DescriptionProp;
     /** Plot-height tier — `xs|sm|md|lg`. Defaults to `xs` (dashboard summary-card density). */
@@ -107,6 +121,13 @@ export type PieChartProp = {
     colors?: string[];
     /** Accessible name + visible caption for the chart. REQUIRED. */
     label: LabelProp;
+    /**
+     * Paint `label` as a visible caption above the plot. Set `false` when the chart already sits
+     * under a heading that says the same thing (a `CardTitle`, a section `<h2>`): the caption stays
+     * in the DOM as `sr-only`, so `role="img"` keeps its accessible name and only the duplicated
+     * visible title goes away.
+     */
+    showCaption?: boolean;
     /** Extra context appended to the screen-reader description. */
     description?: DescriptionProp;
     /** Canvas height preset — `xs|sm|md|lg`. Ignored when `height` is set. */

package/dist/props/components/data-display.prop.d.ts

@@ -7,7 +7,9 @@ export type CodeBlockProp = {
     /** Soft-wrap long lines (default true). `false` scrolls horizontally instead. */
     wrap?: boolean;
     /** Scroll inside the block past this height. Default `none` (grows with the content). */
-    maxHeight?: "sm" | "md" | "lg" | "none";
+    maxHeight?: "sm" | "md" | "lg" | "none" | {
+        value: string;
+    };
     /** Type size. Default `sm`. */
     size?: Extract<SizeProp, "xs" | "sm">;
     /** Cosmetic: lands on `data-language`; no highlighter is bundled. */
@@ -26,7 +28,7 @@ export type ProseProp = {
     className?: ClassNameProp;
     children?: ChildrenProp;
 };
-import type { ActionProp, ClassNameProp, DescriptionProp, IconProp, TitleProp, ColumnDefProp, GetRowIdProp, OnRowClickProp, OnSelectChangeProp, OnSortChangeProp, OnTableDensityChangeProp, SelectedIdsProp, SortStateProp, TableDensityProp, TablePresetProp, BreakpointProp, DensityProp, ChildrenProp, ToneProp, AvatarShapeProp, HeadingLevelProp, HandlerProp, SizeProp, LabelProp, IdProp, DescriptionsLayoutProp } from "../vocabulary/index.js";
+import type { ActionProp, ClassNameProp, DescriptionProp, IconProp, TitleProp, ColumnDefProp, GetRowIdProp, OnRowClickProp, OnSelectChangeProp, OnSortChangeProp, OnTableDensityChangeProp, SelectedIdsProp, SortStateProp, TableDensityProp, TablePresetProp, BreakpointProp, DensityProp, ChildrenProp, ToneProp, AvatarShapeProp, HeadingLevelProp, HandlerProp, SizeProp, LabelProp, IdProp, DescriptionsLayoutProp, DescriptionsColumnProp, DescriptionsSpanProp, DescriptionsItemsProp, SortDirectionProp, OnColumnFilterChangeProp, OnRowProp, TableExpandableProp, TableRowSelectionProp, TableScrollProp, TableStickyProp, TableSummaryProp } from "../vocabulary/index.js";
 /**
  * One key in a `Legend`: a tone, and the words that tone stands for.
  *
@@ -77,18 +79,28 @@ export type EmptyStateProp = {
  */
 export type DescriptionsProp = {
     /** `Descriptions.Item` children — one label/value pair each. */
-    children: React.ReactNode;
-    columns?: 1 | 2 | 3;
+    children?: React.ReactNode;
+    /**
+     * Column count. `1 | 2 | 3` keeps this library's own mobile-first ladder; any other number, or
+     * antd's responsive `{ sm, md, lg, xl }` object, drives the token-published grid instead.
+     */
+    columns?: DescriptionsColumnProp;
     /** Label placement within each item. Default `vertical` (label over value). */
     layout?: DescriptionsLayoutProp;
     /** Label text alignment inside the label column. Applies only to `layout="horizontal"`. */
     labelAlign?: "start" | "end";
+    /** Draw the grid as a bordered table with shaded label cells (antd `bordered`). */
+    bordered?: boolean;
+    /** Declarative items (antd `items`) — the alternative to composing `Descriptions.Item`. */
+    items?: DescriptionsItemsProp;
     className?: ClassNameProp;
 };
 export type DescriptionsItemProp = {
     label: React.ReactNode;
     value: React.ReactNode;
     mono?: boolean;
+    /** Columns this item occupies — number | `"filled"` | responsive object (antd `span`). */
+    span?: DescriptionsSpanProp;
 };
 /**
  * @see Avatar
@@ -264,6 +276,26 @@ export type DataTableProp<T> = {
      * measures. Default `"sm"`.
      */
     collapseBelow?: BreakpointProp;
+    /** Full row-selection configuration (antd `rowSelection`). */
+    rowSelection?: TableRowSelectionProp<T>;
+    /** Expandable detail rows (antd `expandable`). */
+    expandable?: TableExpandableProp<T>;
+    /** Footer totals row, rendered in a real `<tfoot>` (antd `summary`). */
+    summary?: TableSummaryProp<T>;
+    /** Scroll envelope — `x` a minimum inline size, `y` a maximum body block size (antd `scroll`). */
+    scroll?: TableScrollProp;
+    /** Sticky header; the object form carries `offsetHeader` (antd `sticky`). */
+    sticky?: TableStickyProp;
+    /** Per-row DOM props merged onto the `<tr>` (antd `onRow`). */
+    onRow?: OnRowProp<T>;
+    /** Outer frame + vertical rules between columns (antd `bordered`). */
+    bordered?: boolean;
+    /** Explain the next sort step in a tooltip on sortable headers (antd `showSorterTooltip`). */
+    showSorterTooltip?: boolean;
+    /** Table-wide sort cycle; a column's own `sortDirections` wins (antd `sortDirections`). */
+    sortDirections?: SortDirectionProp[];
+    /** Column filters changed — pair with a column's `filteredValue` for server filtering. */
+    onFilterChange?: OnColumnFilterChangeProp;
     className?: ClassNameProp;
     children?: ChildrenProp;
 };
@@ -362,7 +394,26 @@ export type PermissionMatrixProp = {
  */
 export type ScrollAreaAnchorProp = "none" | "bottom";
 /** @see ScrollArea */
+/**
+ * @see ScrollArea — which AXES scroll. This is not decoration: Radix sets the viewport's
+ * `overflowX`/`overflowY` inline from which scrollbars are mounted, so an axis with no `ScrollBar`
+ * is `overflow: hidden` and its content is CLIPPED, not merely un-barred.
+ *
+ * `both` is a third value rather than an array or a pair of booleans because the axes are one
+ * decision — a pane scrolls down, across, or freely — and a closed union is what `check:prop-vocabulary`
+ * and the MCP catalog can carry.
+ */
+export type ScrollAreaOrientationProp = "vertical" | "horizontal" | "both";
 export type ScrollAreaProp = {
+    /**
+     * Axes that scroll, and therefore which scrollbars render. Default `vertical` — the previous
+     * behaviour, unchanged.
+     *
+     * Reach for `horizontal` for a strip of non-shrinking columns (a board, a lane of cards): the
+     * viewport keeps its tab stop, so the strip is scrollable from the keyboard, and the consumer
+     * writes no overflow styling of its own.
+     */
+    orientation?: ScrollAreaOrientationProp;
     /**
      * Ref to the element that actually SCROLLS — the Radix viewport — not the root. The root is
      * `overflow: hidden` and never scrolls, so the component's own `ref` cannot serve.