feat: add tests and documentation for RecordPickerDialog and LookupField upgrade

- Add 15 comprehensive tests for RecordPickerDialog and LookupField two-level interaction
- Update CHANGELOG.md with new features
- Update ROADMAP.md with Record Picker milestone
- Update lookup.mdx documentation with Record Picker section and new schema fields

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

Author: Copilot

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **RecordPickerDialog Component** (`@object-ui/fields`): New enterprise-grade record selection dialog with multi-column table display, pagination, search, loading/error/empty states, and single/multi-select support. Provides the foundation for Salesforce-style Lookup experience.
+- **LookupField Two-Level Interaction** (`@object-ui/fields`): LookupField now supports a "Show All Results" button in the quick-select dialog that opens the full RecordPickerDialog with table view, pagination, and multi-column display.
+- **LookupFieldMetadata Schema Enhancement** (`@object-ui/types`): Added `lookup_columns`, `description_field`, `lookup_page_size` properties to `LookupFieldMetadata` for configuring the Record Picker display. New `LookupColumnDef` interface for typed column definitions.
+
 ### Changed
 
 - **@objectstack v3.2.6 Upgrade**: Upgraded all `@objectstack/*` packages from `^3.2.5` to `^3.2.6` across 13 package.json files (43 references)

ROADMAP.md

@@ -134,6 +134,7 @@ ObjectUI is a universal Server-Driven UI (SDUI) engine built on React + Tailwind
 - [x] Lookup field dynamic DataSource loading — popup fetches records via `DataSource.find()` with `$search` debounce, loading/error/empty states
 - [x] Lookup field context DataSource — reads DataSource from SchemaRendererContext so forms work without explicit prop
 - [x] Lookup field UX polish — arrow key navigation, description field display, quick-create entry, ARIA listbox roles
+- [x] Enterprise Record Picker — `RecordPickerDialog` component with multi-column table, pagination, search; LookupField two-level interaction (quick-select + "Show All Results" → full picker); `lookup_columns` / `lookup_page_size` schema config
 - [ ] Form conditional logic with branching
 - [ ] Multi-page forms with progress indicator
 

content/docs/fields/lookup.mdx

@@ -73,6 +73,16 @@ interface LookupFieldSchema {
 
   // Quick-create callback (shown when no results found)
   onCreateNew?: (searchQuery: string) => void;
+
+  // === Record Picker Configuration (Enterprise) ===
+  
+  // Columns to show in the Record Picker dialog table.
+  // Accepts field names or { field, label, width } objects.
+  // When omitted, auto-infers from reference_field.
+  lookup_columns?: Array<string | { field: string; label?: string; width?: string }>;
+
+  // Custom page size for the Record Picker dialog (default: 10)
+  lookup_page_size?: number;
 }
 
 interface LookupOption {
@@ -106,6 +116,38 @@ The popup will:
 2. Send `$search` queries with 300ms debounce as the user types
 3. Show loading spinner, error state with retry, and empty state
 4. Display "Showing X of Y" when more records exist than the page size
+5. Show a **"Show All Results"** button to open the full Record Picker dialog
+
+## Record Picker Dialog (Enterprise)
+
+When more results are available than displayed in the quick-select popup, a **"Show All Results"** button opens the full **RecordPickerDialog** — an enterprise-grade record selection experience.
+
+```plaintext
+// Configure the Record Picker with lookup_columns
+{
+  type: 'lookup',
+  name: 'order',
+  label: 'Order',
+  reference_to: 'orders',
+  reference_field: 'order_number',
+  description_field: 'customer_name',
+  lookup_columns: [
+    { field: 'order_number', label: 'Order #' },
+    { field: 'customer_name', label: 'Customer' },
+    { field: 'total_amount', label: 'Amount' },
+    { field: 'status', label: 'Status' },
+  ],
+  lookup_page_size: 15,
+}
+```
+
+The Record Picker dialog provides:
+- **Multi-column table** with configurable columns via `lookup_columns`
+- **Search** with debounced server-side querying
+- **Pagination** with page-by-page navigation
+- **Single/Multi-select** with visual check indicators
+- **Loading, error, and empty states**
+- Auto-inferred columns from `reference_field` when `lookup_columns` is not set
 
 ## Lookup vs Master-Detail
 
@@ -133,12 +175,15 @@ import { LookupCellRenderer } from '@object-ui/fields';
 
 ## Features
 
+- **Two-Level Interaction**: Quick-select popup + full Record Picker dialog
+- **Record Picker Dialog**: Enterprise-grade table with multi-column, pagination, search
 - **Dynamic DataSource Loading**: Automatically fetches records from referenced objects
 - **Search**: Debounced type-ahead search with `$search` parameter
 - **Multi-Select**: Support for multiple references
 - **Keyboard Navigation**: Arrow keys to navigate, Enter to select
 - **Loading/Error/Empty States**: Friendly feedback for all states
 - **Secondary Field Display**: Show description/subtitle per option
 - **Quick-Create Entry**: Optional "Create new" button when no results
-- **Pagination Hint**: Shows total count when more results available
+- **Configurable Columns**: `lookup_columns` for multi-column picker display
+- **Pagination**: Page-by-page navigation in Record Picker dialog
 - **Backward Compatible**: Falls back to static options when no DataSource