@object-ui/fields 4.0.7 → 4.0.9

package/dist/packages/fields/src/index.d.ts

@@ -1,5 +1,11 @@
 import { default as React } from 'react';
 import { FieldMetadata } from '../../types/src';
+/**
+ * Heuristic: detect strings that look like opaque foreign-key IDs (e.g. nanoid
+ * or BSON ObjectId). Used so we don't display random gibberish to users when
+ * a lookup wasn't expanded.
+ */
+export declare function isLikelyOpaqueId(v: unknown): boolean;
 /**
  * Cell renderer props
  */
@@ -25,6 +31,12 @@ export declare function formatCurrency(value: number, currency?: string): string
  * E.g., $150,000 → $150K, $1,200,000 → $1.2M
  */
 export declare function formatCompactCurrency(value: number, currency?: string): string;
+/**
+ * Format a plain number with thousands separators, no currency symbol.
+ * Used as a safe fallback when a currency-typed field has no `currency`
+ * configured — we'd rather render `1,234.50` than silently assume USD.
+ */
+export declare function formatNumber(value: number, decimals?: number): string;
 /**
  * Format percent value
  * Handles both decimal (0.8 = 80%) and whole number (80 = 80%) inputs.
@@ -43,15 +55,15 @@ export declare function humanizeLabel(value: string): string;
 /**
  * Format date as relative time (e.g., "2 days ago", "Today", "Overdue 3d")
  */
-export declare function formatRelativeDate(value: string | Date): string;
+export declare function formatRelativeDate(value: string | Date | number): string;
 /**
  * Format date value
  */
-export declare function formatDate(value: string | Date, style?: string): string;
+export declare function formatDate(value: string | Date | number, style?: string): string;
 /**
  * Format datetime value
  */
-export declare function formatDateTime(value: string | Date): string;
+export declare function formatDateTime(value: string | Date | number): string;
 /**
  * Text field cell renderer
  */
@@ -82,8 +94,35 @@ export declare function DateCellRenderer({ value, field }: CellRendererProps): R
  * DateTime field cell renderer (Airtable-style with date and time visually separated)
  */
 export declare function DateTimeCellRenderer({ value }: CellRendererProps): React.ReactElement;
+export declare function getBadgeColorClasses(color?: string, val?: unknown): string;
+/**
+ * Resolve a semantic color name (e.g. "red", "green") for a value, suitable
+ * for callers that need a raw color token rather than CSS classes (for
+ * example, the Gantt renderer paints bars via inline styles).
+ *
+ * Resolution order: explicit option color → semantic value mapping →
+ * deterministic hash fallback. Returns `undefined` only when no value is
+ * supplied so the caller can fall back to its own default.
+ */
+export declare function getSemanticColorName(color?: string, val?: unknown): string | undefined;
 /**
- * Select field cell renderer (with badges)
+ * Map a semantic color name to its Tailwind -500 hex value. Used by
+ * inline-style consumers (Gantt bars). Falls back to the supplied default
+ * (or the platform default blue) when the name is unrecognized.
+ */
+export declare function getSemanticHex(name?: string, fallback?: string): string;
+/**
+ * Select field cell renderer.
+ *
+ * Two visual styles, controlled by `field.appearance` (renderer-level option,
+ * not part of the `@objectstack/spec` field schema):
+ *   - `'badge'` (default for spec compatibility): soft-pill colored badge.
+ *   - `'dot'`: a small colored dot followed by the option label. Used by
+ *     dense list/grid contexts to keep the table visually quiet — repeated
+ *     filled badges across many rows create heavy visual noise.
+ *
+ * Metadata always wins: callers can pass `appearance: 'badge'` on the field
+ * descriptor to force the legacy badge in any context.
  */
 export declare function SelectCellRenderer({ value, field }: CellRendererProps): React.ReactElement;
 /**
@@ -107,7 +146,14 @@ export declare function FileCellRenderer({ value, field }: CellRendererProps): R
  */
 export declare function ImageCellRenderer({ value }: CellRendererProps): React.ReactElement;
 /**
- * Lookup/Master-Detail field cell renderer
+ * Lookup/Master-Detail field cell renderer.
+ *
+ * Display order:
+ * 1. Embedded record object (`{ id, name, ... }` from `$expand`) → use its name
+ * 2. Static `field.options[]` (e.g. when the lookup is a closed enum) → look up label
+ * 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.
  */
 export declare function LookupCellRenderer({ value, field }: CellRendererProps): React.ReactElement;
 /**
@@ -124,6 +170,16 @@ export declare function UserCellRenderer({ value }: CellRendererProps): React.Re
  * @param renderer React component to render the field
  */
 export declare function registerFieldRenderer(type: string, renderer: React.FC<CellRendererProps>): void;
+/**
+ * Resolve the canonical cell-renderer key for a field. Accepts either a
+ * raw type string (back-compat) or a field-metadata object so that
+ * format hints (`format: 'phone'` etc.) can promote a plain `text`
+ * field to its richer renderer counterpart.
+ */
+export declare function resolveCellRendererType(fieldOrType: string | {
+    type?: string;
+    format?: string;
+} | null | undefined): string;
 /**
  * Get the appropriate cell renderer for a field type
  */

package/dist/packages/fields/src/widgets/RecordPickerDialog.d.ts

@@ -91,6 +91,14 @@ export interface RecordPickerDialogProps {
     columns?: Array<string | LookupColumnDef>;
     /** Primary display field (default: 'name') */
     displayField?: string;
+    /**
+     * Optional `titleFormat` template (e.g. `"{full_name}"` or
+     * `"{case_number} - {subject}"`). When set and the displayField column is
+     * auto-inferred, the column renders via the template instead of reading
+     * a possibly-missing field. Mirrors how DetailView/ObjectCalendar resolve
+     * record titles.
+     */
+    titleFormat?: string | null;
     /** Record id field (default: 'id') */
     idField?: string;
     /** Page size (default: 10) */
@@ -163,4 +171,4 @@ export interface RecordPickerDialogProps {
  * states, and single/multi-select.  Responsive: mobile-friendly width
  * via Tailwind breakpoints.
  */
-export declare function RecordPickerDialog({ open, onOpenChange, title, multiple, dataSource, objectName, columns: columnsProp, displayField, idField, pageSize, value, onSelect, onSelectRecords, lookupFilters, cellRenderer, filterColumns, renderFilterBar, renderGrid, }: RecordPickerDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function RecordPickerDialog({ open, onOpenChange, title, multiple, dataSource, objectName, columns: columnsProp, displayField, titleFormat, idField, pageSize, value, onSelect, onSelectRecords, lookupFilters, cellRenderer, filterColumns, renderFilterBar, renderGrid, }: RecordPickerDialogProps): import("react/jsx-runtime").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/fields",
-  "version": "4.0.7",
+  "version": "4.0.9",
   "description": "Field renderers and registry for Object UI",
   "license": "MIT",
   "type": "module",
@@ -26,13 +26,13 @@
   "dependencies": {
     "clsx": "^2.1.1",
     "lucide-react": "^1.14.0",
-    "tailwind-merge": "^3.5.0",
-    "@object-ui/components": "4.0.7",
-    "@object-ui/core": "4.0.7",
-    "@object-ui/i18n": "4.0.7",
-    "@object-ui/providers": "4.0.7",
-    "@object-ui/react": "4.0.7",
-    "@object-ui/types": "4.0.7"
+    "tailwind-merge": "^3.6.0",
+    "@object-ui/components": "4.0.9",
+    "@object-ui/core": "4.0.9",
+    "@object-ui/i18n": "4.0.9",
+    "@object-ui/providers": "4.0.9",
+    "@object-ui/react": "4.0.9",
+    "@object-ui/types": "4.0.9"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -43,7 +43,7 @@
     "@types/react-dom": "19.2.3",
     "@vitejs/plugin-react": "^6.0.1",
     "typescript": "^6.0.3",
-    "vite": "^8.0.10",
+    "vite": "^8.0.12",
     "vite-plugin-dts": "^5.0.0"
   },
   "publishConfig": {