fix: address code review — remove unreachable Date check, improve LookupFilterDef docs

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

packages/fields/src/widgets/RecordPickerDialog.tsx

@@ -338,7 +338,6 @@ export function RecordPickerDialog({
   const getCellValue = useCallback((record: any, field: string): string => {
     const val = record[field];
     if (val === null || val === undefined) return '';
-    if (val instanceof Date) return val.toLocaleDateString();
     if (typeof val === 'object') {
       // Handle MongoDB types / expanded references
       if (val.$numberDecimal) return String(Number(val.$numberDecimal));

packages/types/src/field-types.ts

@@ -364,7 +364,16 @@ export interface LookupColumnDef {
 /**
  * Filter condition for the Record Picker dialog.
  * Applied as a base filter on every query — restricts which records are selectable.
+ *
+ * Operator compatibility:
+ * - `eq`, `ne` — all data types
+ * - `gt`, `lt`, `gte`, `lte` — numbers, dates
+ * - `contains` — strings
+ * - `in`, `notIn` — arrays of values (select/lookup fields)
+ *
  * @example { field: 'status', operator: 'eq', value: 'active' }
+ * @example { field: 'created_at', operator: 'gte', value: '2024-01-01' }
+ * @example { field: 'category', operator: 'in', value: ['A', 'B'] }
  */
 export interface LookupFilterDef {
   /** Field name to filter on */