@object-ui/fields 5.1.1 → 5.3.0

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

@@ -23,12 +23,19 @@ export interface CellRendererProps {
  */
 export declare function coerceToSafeValue(value: unknown): string | number | boolean | null | undefined;
 /**
- * Format currency value
+ * Format currency value. When `currency` is undefined, falls back to a
+ * plain number with thousands separators (no symbol). Silently assuming
+ * USD for unconfigured currency fields was the #1 source of "why is my
+ * RMB amount showing as dollars?" bug reports.
+ *
+ * Trailing `.00` is dropped when the value is a whole number — Salesforce
+ * convention: `$1,234.50` keeps cents; `$1,234` does not.
  */
 export declare function formatCurrency(value: number, currency?: string): string;
 /**
  * Format currency value in compact form for mobile display.
  * E.g., $150,000 → $150K, $1,200,000 → $1.2M
+ * When `currency` is undefined, returns a compact number without symbol.
  */
 export declare function formatCompactCurrency(value: number, currency?: string): string;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/fields",
-  "version": "5.1.1",
+  "version": "5.3.0",
   "description": "Field renderers and registry for Object UI",
   "license": "MIT",
   "type": "module",
@@ -27,12 +27,12 @@
     "clsx": "^2.1.1",
     "lucide-react": "^1.16.0",
     "tailwind-merge": "^3.6.0",
-    "@object-ui/components": "5.1.1",
-    "@object-ui/core": "5.1.1",
-    "@object-ui/i18n": "5.1.1",
-    "@object-ui/providers": "5.1.1",
-    "@object-ui/react": "5.1.1",
-    "@object-ui/types": "5.1.1"
+    "@object-ui/components": "5.3.0",
+    "@object-ui/core": "5.3.0",
+    "@object-ui/i18n": "5.3.0",
+    "@object-ui/providers": "5.3.0",
+    "@object-ui/react": "5.3.0",
+    "@object-ui/types": "5.3.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/src/index.tsx

@@ -222,24 +222,49 @@ export function coerceToSafeValue(value: unknown): string | number | boolean | n
 }
 
 /**
- * Format currency value
+ * Format currency value. When `currency` is undefined, falls back to a
+ * plain number with thousands separators (no symbol). Silently assuming
+ * USD for unconfigured currency fields was the #1 source of "why is my
+ * RMB amount showing as dollars?" bug reports.
+ *
+ * Trailing `.00` is dropped when the value is a whole number — Salesforce
+ * convention: `$1,234.50` keeps cents; `$1,234` does not.
  */
-export function formatCurrency(value: number, currency: string = 'USD'): string {
+export function formatCurrency(value: number, currency?: string): string {
+  const isWhole = Number.isFinite(value) && value === Math.trunc(value);
+  const maxFrac = isWhole ? 0 : 2;
+  if (!currency) {
+    return formatNumber(value, maxFrac);
+  }
   try {
     return new Intl.NumberFormat('en-US', {
       style: 'currency',
       currency,
+      minimumFractionDigits: 0,
+      maximumFractionDigits: maxFrac,
     }).format(value);
   } catch {
-    return `${currency} ${value.toFixed(2)}`;
+    return `${currency} ${value.toFixed(maxFrac)}`;
   }
 }
 
 /**
  * Format currency value in compact form for mobile display.
  * E.g., $150,000 → $150K, $1,200,000 → $1.2M
+ * When `currency` is undefined, returns a compact number without symbol.
  */
-export function formatCompactCurrency(value: number, currency: string = 'USD'): string {
+export function formatCompactCurrency(value: number, currency?: string): string {
+  if (!currency) {
+    try {
+      const formatted = new Intl.NumberFormat('en-US', {
+        notation: 'compact',
+        maximumFractionDigits: 1,
+      }).format(value);
+      return formatted.replace(/\.0(?=[KMBT])/, '');
+    } catch {
+      return String(value);
+    }
+  }
   try {
     const formatted = new Intl.NumberFormat('en-US', {
       style: 'currency',
@@ -340,9 +365,14 @@ export function formatDate(value: string | Date | number, style?: string): strin
     return formatRelativeDate(date);
   }
   
-  // Default format: locale-aware human-readable (e.g. "Jan 15, 2024" or "2024/1/15")
+  // Default format: locale-aware human-readable. Drop the year when it
+  // matches the current year — Salesforce / HubSpot / Linear all do this
+  // because the year is rarely useful for in-progress records and the
+  // verbose "2026年7月21日" form crowds cards and table cells. Past- /
+  // future-year dates keep the year so users can disambiguate.
+  const isCurrentYear = date.getFullYear() === new Date().getFullYear();
   return date.toLocaleDateString(undefined, {
-    year: 'numeric',
+    year: isCurrentYear ? undefined : 'numeric',
     month: 'short',
     day: 'numeric',
   });
@@ -399,24 +429,23 @@ export function CurrencyCellRenderer({ value, field }: CellRendererProps): React
   
   const safe = coerceToSafeValue(value);
   const currencyField = field as any;
-  // Honor both `currency` (legacy/grid configs) and `defaultCurrency`
-  // (the canonical key from `@objectstack/spec` Field.currency()). When
-  // neither is supplied, fall back to USD so currency-typed fields always
-  // render with a symbol — a bare "5,000,000.00" is indistinguishable from
-  // a plain number and is the #1 source of "is this dollars or what?"
-  // confusion in customer screenshots.
-  const currency: string =
-    currencyField.currency || currencyField.defaultCurrency || 'USD';
+  // Honor `currency` (legacy/grid configs), `defaultCurrency` (canonical
+  // top-level), and `currencyConfig.defaultCurrency` (the nested shape
+  // emitted by `@objectstack/spec` Field.currency() with currencyConfig).
+  // When none is supplied, render as a plain formatted number —
+  // silently assuming USD for unconfigured currency fields was
+  // misleading for non-USD orgs (e.g. RMB amounts displayed as $).
+  const currency: string | undefined =
+    currencyField.currency ||
+    currencyField.defaultCurrency ||
+    currencyField.currencyConfig?.defaultCurrency ||
+    undefined;
   const num = Number(safe);
-  const decimals = currencyField.precision ?? currencyField.scale ?? currencyField.decimals ?? 2;
   const formatted = !isNaN(num)
     ? formatCurrency(num, currency)
     : String(safe);
-  // Hide trailing fractional digits when the field opted into integer-only
-  // precision (e.g. annual_revenue stored as whole units).
-  const display = decimals === 0 ? formatted.replace(/[.,]00$/, '') : formatted;
 
-  return <span className="tabular-nums font-medium whitespace-nowrap">{display}</span>;
+  return <span className="tabular-nums font-medium whitespace-nowrap">{formatted}</span>;
 }
 
 // Fields that store percentage values as whole numbers (0-100) rather than fractions (0-1)

package/src/widgets/RichTextField.tsx

@@ -1,5 +1,6 @@
 import React from 'react';
 import { Textarea, EmptyValue } from '@object-ui/components';
+import { useObjectTranslation } from '@object-ui/react';
 import { FieldWidgetProps } from './types';
 
 /**
@@ -8,6 +9,7 @@ import { FieldWidgetProps } from './types';
  * a rich text editor like TipTap, Lexical, or Slate.
  */
 export function RichTextField({ value, onChange, field, readonly, errorMessage, ...props }: FieldWidgetProps<string>) {
+  const { t } = useObjectTranslation();
   if (readonly) {
     return (
       <div 
@@ -25,13 +27,18 @@ export function RichTextField({ value, onChange, field, readonly, errorMessage,
   return (
     <div className="space-y-2">
       <div className="flex items-center justify-between text-xs text-gray-500">
-        <span>Format: {format}</span>
-        <span className="italic">Rich text editor (basic)</span>
+        <span>{t('fields.richText.format', { format, defaultValue: `Format: ${format}` })}</span>
+        <span className="italic">
+          {t('fields.richText.basicEditorHint', { defaultValue: 'Rich text editor (basic)' })}
+        </span>
       </div>
       <Textarea
         value={value || ''}
         onChange={(e) => onChange(e.target.value)}
-        placeholder={richField?.placeholder || 'Enter text...'}
+        placeholder={
+          richField?.placeholder ||
+          t('fields.richText.placeholder', { defaultValue: 'Enter text...' })
+        }
         disabled={readonly || props.disabled}
         rows={rows}
         className={`font-mono text-sm ${props.className || ''}`}