@godxjp/ui 20.0.0 → 20.2.0

package/dist/i18n/messages/en.json

@@ -19,11 +19,14 @@
   "dataEntry": {
     "calendar": {
       "today": "Today",
-      "close": "Close"
+      "close": "Close",
+      "nav": "{label} navigation",
+      "name": "Calendar"
     },
     "datePicker": {
       "placeholder": "Select date",
-      "openCalendar": "Open calendar"
+      "openCalendar": "Open calendar",
+      "quarter": "Q{quarter}"
     },
     "dateRangePicker": {
       "placeholder": "Select date range",
@@ -39,7 +42,10 @@
       "openPicker": "Open time picker",
       "meridiem": "AM/PM",
       "am": "AM",
-      "pm": "PM"
+      "pm": "PM",
+      "now": "Now",
+      "confirm": "OK",
+      "second": "Second"
     },
     "searchInput": {
       "placeholder": "Search…"
@@ -55,7 +61,7 @@
     "upload": {
       "dropzoneLabel": "Upload files",
       "dropzoneHint": "Drag and drop files here, or click to browse",
-      "dropzoneMeta": "Uploads go to temp storage — promote on form save",
+      "dropzoneMeta": "Selected files appear here.",
       "buttonLabel": "Choose file",
       "addImage": "Add image",
       "uploading": "Uploading…",
@@ -75,7 +81,17 @@
       "statusFailed": "{count} upload(s) failed",
       "removeImage": "Remove image",
       "removeFile": "Remove {name}",
-      "cropDescription": "Drag the zoom slider, then save to crop your photo to a square."
+      "cropDescription": "Drag the zoom slider, then save to crop your photo to a square.",
+      "preview": "Preview",
+      "download": "Download",
+      "retry": "Retry",
+      "start": "Upload",
+      "cancel": "Cancel",
+      "rejectAccept": "{name}: file type is not allowed.",
+      "rejectSize": "{name}: file is too large.",
+      "rejectCount": "{name}: file limit reached.",
+      "rejectBeforeUpload": "{name}: file validation failed.",
+      "readFailed": "Could not read the selected folder."
     },
     "cascader": {
       "placeholder": "Select…",
@@ -109,6 +125,9 @@
       "empty": "No results",
       "error": "Couldn’t load options"
     },
+    "selection": {
+      "overflow": "+{count}"
+    },
     "monthPicker": {
       "openGrid": "Open month grid",
       "previousYear": "Previous year",
@@ -135,6 +154,14 @@
     },
     "formErrors": {
       "title": "Please review the following errors"
+    },
+    "form": {
+      "optional": "(optional)",
+      "success": "Valid",
+      "warning": "Please review",
+      "error": "Invalid",
+      "validating": "Validating",
+      "submitFailed": "Could not submit the form. Please try again."
     }
   },
   "feedback": {
@@ -290,8 +317,13 @@
     }
   },
   "navigation": {
+    "tabs": {
+      "addTab": "Add tab",
+      "removeTab": "Close tab"
+    },
     "steps": {
       "ariaLabel": "Progress",
+      "percentLabel": "Current step progress",
       "status": {
         "wait": "Waiting",
         "process": "Current step",
@@ -332,6 +364,7 @@
       "page": "Page {page}",
       "pageSize": "Page size",
       "pageSizeTrigger": "{size} / page",
+      "jumpTo": "Go to page",
       "pageSizeOption": "{size} / page",
       "total": {
         "one": "Total {total} item",
@@ -410,7 +443,19 @@
     "error": "Couldn't load this list",
     "errorDescription": "The data could not be retrieved. Try again in a moment.",
     "denied": "You don't have access to this list",
-    "deniedDescription": "Ask an administrator to grant you permission to view these records."
+    "deniedDescription": "Ask an administrator to grant you permission to view these records.",
+    "selectInvert": "Invert selection",
+    "selectNone": "Clear selection",
+    "selectionMenu": "Selection options",
+    "filterColumn": "Filter",
+    "filterReset": "Reset filter",
+    "expandColumn": "Expand",
+    "expandRow": "Expand row",
+    "collapseRow": "Collapse row",
+    "sortAscending": "Sort ascending",
+    "sortDescending": "Sort descending",
+    "sortCancel": "Cancel sort",
+    "selectColumn": "Select"
   },
   "dataGrid": {
     "search": "Search",
@@ -478,5 +523,13 @@
     "summaryPie": "Pie chart with {slices} slices",
     "summaryTrend": "Bar trend with {points} data points",
     "trendCurrent": "current"
+  },
+  "rangeTimeline": {
+    "outsideRange": "Outside the visible range",
+    "schedule": "Schedule"
+  },
+  "textExamples": {
+    "preservedText": "Plain text",
+    "sampleText": "First line\n  Indented line\n\nLast line"
   }
 }

package/dist/i18n/messages/ja.json

@@ -19,11 +19,14 @@
   "dataEntry": {
     "calendar": {
       "today": "今日",
-      "close": "閉じる"
+      "close": "閉じる",
+      "nav": "{label}のナビゲーション",
+      "name": "カレンダー"
     },
     "datePicker": {
       "placeholder": "日付を選択",
-      "openCalendar": "カレンダーを開く"
+      "openCalendar": "カレンダーを開く",
+      "quarter": "第{quarter}四半期"
     },
     "dateRangePicker": {
       "placeholder": "期間を選択",
@@ -39,7 +42,10 @@
       "openPicker": "時刻を選択",
       "meridiem": "午前/午後",
       "am": "午前",
-      "pm": "午後"
+      "pm": "午後",
+      "now": "現在時刻",
+      "confirm": "確定",
+      "second": "秒"
     },
     "searchInput": {
       "placeholder": "検索…"
@@ -55,7 +61,7 @@
     "upload": {
       "dropzoneLabel": "ファイルをアップロード",
       "dropzoneHint": "ここにドラッグ＆ドロップ、またはクリックして選択",
-      "dropzoneMeta": "一時ストレージに保存 — フォーム保存時に promote",
+      "dropzoneMeta": "選択したファイルはここに表示されます。",
       "buttonLabel": "ファイルを選択",
       "addImage": "画像を追加",
       "uploading": "アップロード中…",
@@ -75,7 +81,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 +125,9 @@
       "empty": "該当なし",
       "error": "選択肢を読み込めませんでした"
     },
+    "selection": {
+      "overflow": "他{count}件"
+    },
     "monthPicker": {
       "openGrid": "月選択を開く",
       "previousYear": "前年へ",
@@ -132,6 +151,14 @@
     },
     "formErrors": {
       "title": "入力内容にエラーがあります"
+    },
+    "form": {
+      "optional": "（任意）",
+      "success": "確認済み",
+      "warning": "確認してください",
+      "error": "入力エラー",
+      "validating": "確認中",
+      "submitFailed": "フォームを送信できませんでした。再試行してください。"
     }
   },
   "feedback": {
@@ -284,8 +311,13 @@
     }
   },
   "navigation": {
+    "tabs": {
+      "addTab": "タブを追加",
+      "removeTab": "タブを閉じる"
+    },
     "steps": {
       "ariaLabel": "進行状況",
+      "percentLabel": "現在のステップの進捗",
       "status": {
         "wait": "未完了",
         "process": "現在のステップ",
@@ -323,6 +355,7 @@
       "page": "ページ {page}",
       "pageSize": "ページサイズ",
       "pageSizeTrigger": "{size}件",
+      "jumpTo": "ページへ移動",
       "pageSizeOption": "{size} 件/ページ",
       "total": "全 {total} 件"
     },
@@ -398,7 +431,19 @@
     "error": "一覧を取得できませんでした",
     "errorDescription": "データを取得できませんでした。時間をおいて再試行してください。",
     "denied": "この一覧を表示する権限がありません",
-    "deniedDescription": "閲覧するには管理者に権限の付与を依頼してください。"
+    "deniedDescription": "閲覧するには管理者に権限の付与を依頼してください。",
+    "selectInvert": "選択を反転",
+    "selectNone": "選択を解除",
+    "selectionMenu": "選択オプション",
+    "filterColumn": "絞り込み",
+    "filterReset": "絞り込みを解除",
+    "expandColumn": "展開",
+    "expandRow": "行を展開",
+    "collapseRow": "行を折りたたむ",
+    "sortAscending": "昇順に並べ替え",
+    "sortDescending": "降順に並べ替え",
+    "sortCancel": "並べ替えを解除",
+    "selectColumn": "選択"
   },
   "dataGrid": {
     "search": "検索",
@@ -466,5 +511,13 @@
     "summaryPie": "{slices}区分の円グラフ",
     "summaryTrend": "{points}データ点の推移棒グラフ",
     "trendCurrent": "現在"
+  },
+  "rangeTimeline": {
+    "outsideRange": "表示範囲外",
+    "schedule": "スケジュール"
+  },
+  "textExamples": {
+    "preservedText": "プレーンテキスト",
+    "sampleText": "最初の行\n  字下げした行\n\n最後の行"
   }
 }

package/dist/i18n/messages/vi.json

@@ -19,11 +19,14 @@
   "dataEntry": {
     "calendar": {
       "today": "Hôm nay",
-      "close": "Đóng"
+      "close": "Đóng",
+      "nav": "Điều hướng {label}",
+      "name": "Lịch"
     },
     "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 +42,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 +61,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 +81,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 +125,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 +151,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 +311,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 +355,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 +431,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 +511,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/i18n/translate.d.ts

@@ -3,6 +3,25 @@ import vi from "./messages/vi.json" with { type: "json" };
 export type Messages = typeof vi;
 export declare const MESSAGE_CATALOG: Record<AppLocale, Record<string, unknown>>;
 export type MessageKey = string;
+/**
+ * ADD AN APPLICATION'S OWN STRINGS TO THE LIBRARY'S CATALOG.
+ *
+ * The catalog used to be closed: `MESSAGE_CATALOG` was exported but there was no way to extend it,
+ * so an application had to run a SECOND translation system beside this one — two lookups, two
+ * fallback chains, and two places a missing key can hide. That is a real cost for a product whose
+ * pages mix library chrome and application copy in the same sentence.
+ *
+ * MERGES, never replaces: a partial tree is layered onto what is already there, so registering
+ * `{ myApp: { title: "…" } }` cannot delete `dataEntry.calendar.today`. Registering the same key
+ * twice is last-write-wins, which is what a hot reload needs and what a second call with corrected
+ * copy expects.
+ *
+ * A LIBRARY KEY CANNOT BE SILENTLY REPLACED. Overwriting `dataEntry.*` or any other namespace this
+ * package ships would let one application change what a shared component says — invisibly, from a
+ * distance, and only in the build where that call ran. Reach for the component's own labels prop
+ * instead; every string this library renders has one.
+ */
+export declare function registerMessages(locale: AppLocale, messages: Record<string, unknown>): void;
 export type TranslateParams = Record<string, string | number>;
 /** Resolve a dot-path message with fallback locale chain, CLDR plurals, and locale number formatting. */
 export declare function translate(locale: AppLocale, fallbackLocale: AppLocale, key: MessageKey, params?: TranslateParams): string;

package/dist/i18n/translate.js

@@ -6,6 +6,29 @@ const MESSAGE_CATALOG = {
   en,
   ja
 };
+const LIBRARY_NAMESPACES = new Set(
+  Object.values(MESSAGE_CATALOG).flatMap((messages) => Object.keys(messages))
+);
+function registerMessages(locale, messages) {
+  const reserved = [...LIBRARY_NAMESPACES].filter((key) => Object.hasOwn(messages, key));
+  if (reserved.length > 0) {
+    throw new Error(
+      `@godxjp/ui i18n: [${reserved.join(", ")}] ${reserved.length === 1 ? "is a" : "are"} reserved top-level namespace(s) owned by the library. Register your strings under a namespace of your own, and change what a component says through its \`labels\` prop.`
+    );
+  }
+  MESSAGE_CATALOG[locale] = mergeDeep(MESSAGE_CATALOG[locale] ?? {}, messages);
+}
+function mergeDeep(target, source) {
+  const merged = { ...target };
+  for (const [key, value] of Object.entries(source)) {
+    const existing = merged[key];
+    merged[key] = isPlainObject(existing) && isPlainObject(value) ? mergeDeep(existing, value) : value;
+  }
+  return merged;
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function getNested(obj, path) {
   const parts = path.split(".");
   let current = obj;
@@ -75,6 +98,7 @@ export {
   MESSAGE_CATALOG,
   getSyncedFallbackLocale,
   getSyncedLocale,
+  registerMessages,
   resetI18nLocale,
   syncI18nLocale,
   translate,

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;