@object-ui/fields 14.0.0 → 14.1.0

package/dist/index.d.ts

@@ -57,22 +57,29 @@ export declare function formatPercent(value: number, precision?: number): string
  *   "active" → "Active"
  */
 export declare function humanizeLabel(value: string): string;
+/** Options shared by {@link formatDate} / {@link formatRelativeDate}. */
+export interface DateDisplayOptions {
+    dueLike?: boolean;
+    /** BCP-47 display locale (ADR-0053 tenant default); falls back to the runtime locale. */
+    locale?: string;
+    /** i18n translate fn for phrases `Intl` can't produce (the "Overdue Nd" wording). */
+    t?: (key: string, params?: Record<string, unknown>) => string;
+}
 /**
- * Format date as relative time (e.g., "2 days ago", "Today", "Overdue 3d")
+ * Format date as relative time (e.g., "3 days ago", "Today", "Overdue 3d"),
+ * localized via `Intl.RelativeTimeFormat` (objectstack-ai/framework#3040).
  *
  * `dueLike` gates the "Overdue" wording — a past `start_date`/`created_at`
  * isn't overdue, only a past due/deadline-semantic field is. Non-due-like
- * past dates render as "Nd ago" instead.
+ * past dates render as plain "N days ago" instead. The overdue phrase has no
+ * `Intl` equivalent, so it resolves through `options.t` (key
+ * `fields.relativeDate.overdue`) with an English fallback.
  */
-export declare function formatRelativeDate(value: string | Date | number, options?: {
-    dueLike?: boolean;
-}): string;
+export declare function formatRelativeDate(value: string | Date | number, options?: DateDisplayOptions): string;
 /**
  * Format date value
  */
-export declare function formatDate(value: string | Date | number, style?: string, options?: {
-    dueLike?: boolean;
-}): string;
+export declare function formatDate(value: string | Date | number, style?: string, options?: DateDisplayOptions): string;
 /**
  * Format datetime value
  */
@@ -167,6 +174,11 @@ export declare function ImageCellRenderer({ value }: CellRendererProps): React.R
  * 3. Fetch-on-demand: when the value is a primitive ID and `field.reference_to`
  *    is known, resolve via dataSource and show the related record's display name.
  *    Falls back to a muted placeholder while pending and on failure.
+ *
+ * Record → name resolution (1 and 3) goes through the referenced object's
+ * schema when the data source exposes it (`displayField` → nameField/titleFormat
+ * → derivation, see {@link resolveLookupRecordName}), so the chip and the
+ * picker agree (issue #2357).
  */
 export declare function LookupCellRenderer({ value, field }: CellRendererProps): React.ReactElement;
 /**