docs: update ROADMAP.md — mark v1.7 Phases 23-25 complete, fix lint errors

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

Author: Copilot

ROADMAP.md

@@ -2,17 +2,17 @@
 
 > **Date**: 2026-02-22
 > **SDK**: `@objectstack/client@3.0.9`, `@objectstack/client-react@3.0.9`, `@objectstack/spec@3.0.9`
-> **Tests**: ✅ 1003/1003 passing (127 suites, ~85% coverage)
+> **Tests**: ✅ 1149/1149 passing (148 suites, ~85% coverage)
 
 ---
 
 ## 1. Project Status
 
-The ObjectStack Mobile client has completed all core development phases (0–6), spec alignment phases (9–10), advanced feature phases (11–13), UX/platform phases (14–20), spec gap phases (21–22), and post-GA features (v1.4–v1.6). The SDK is upgraded to v3.0.9 (spec v3.0.9: 14 modules, 1683 JSON schemas, 8,380+ `.describe()` annotations).
+The ObjectStack Mobile client has completed all core development phases (0–6), spec alignment phases (9–10), advanced feature phases (11–13), UX/platform phases (14–20), spec gap phases (21–22), post-GA features (v1.4–v1.6), and spec v3.0.9 UI Protocol alignment (v1.7, Phases 23–25). The SDK is upgraded to v3.0.9 (spec v3.0.9: 14 modules, 1683 JSON schemas, 8,380+ `.describe()` annotations).
 
 ### What's Implemented
 
-- **64 custom hooks** covering all SDK namespaces (including AI, security, UX, platform integration, messaging, offline)
+- **85 custom hooks** covering all SDK namespaces (including AI, security, UX, platform integration, messaging, offline, SDUI record pages, interaction protocols, focus/keyboard/offline/notification protocols)
 - **22 view renderers / components** (List, Form, Detail, Dashboard, Kanban, Calendar, Chart, Timeline, Map, Report, Page, widgets, FlowViewer, StateMachineViewer, AgentProgress, CollaborationOverlay, Skeletons, FAB, UndoSnackbar)
 - **13 UI primitives** + 15 common components
 - **30 lib modules** (auth, cache, offline, security, analytics, haptics, accessibility, design tokens, etc.)
@@ -211,22 +211,31 @@ The ObjectStack Mobile client has completed all core development phases (0–6),
 | `spec/ai` — Predictive Models | `usePredictive` |
 | `spec/automation` — ETL Pipelines | `useETLPipeline` |
 | `spec/integration` — Connectors | `useConnector` |
+| `spec/ui` — Record Page SDUI | `useRecordDetails`, `useRecordHighlights`, `useRecordActivity`, `useRecordChatter`, `useRecordPath`, `useRecordRelatedList`, `useRecordReview` |
+| `spec/ui` — Interface Pages | `useInterfacePageConfig`, `useBlankPageLayout` |
+| `spec/ui` — DnD Protocol | `useDndProtocol` |
+| `spec/ui` — Gesture Protocol | `useGestureProtocol` |
+| `spec/ui` — Animation Protocol | `useAnimationProtocol`, `usePageTransitionProtocol`, `useComponentAnimation` |
+| `spec/ui` — Focus/Keyboard Protocol | `useFocusManagement`, `useKeyboardNavigation` |
+| `spec/ui` — Notification UI Protocol | `useNotificationUI` |
+| `spec/ui` — Embed/Sharing Protocol | `useEmbedConfig`, `useViewSharing` |
+| `spec/ui` — Offline/Sync Protocol | `useOfflineConfig`, `useSyncConfig` |
 
-### 🟡 New in Spec v3.0.9 — UI Protocol Schemas (Pending Implementation)
+### ✅ Spec v3.0.9 — UI Protocol Schemas (Implemented in v1.7)
 
-The following new UI protocol schemas were added in spec v3.0.9 and are candidates for future mobile implementation:
+The following UI protocol schemas from spec v3.0.9 have been implemented:
 
 | Category | Spec Schemas | Mobile Status |
 |----------|-------------|---------------|
-| Record Page Components | `RecordDetailsProps`, `RecordActivityProps`, `RecordChatterProps`, `RecordHighlightsProps`, `RecordPathProps`, `RecordRelatedListProps`, `RecordReviewConfigSchema` | 🟡 Partial — detail tabs exist, SDUI record pages pending |
-| Drag & Drop Protocol | `DndConfigSchema`, `DragItemSchema`, `DragHandleSchema`, `DragConstraintSchema`, `DropZoneSchema`, `DropEffectSchema` | 🟡 Partial — `useKanbanDragDrop` exists, full DnD protocol pending |
-| Gesture Protocol | `GestureConfigSchema`, `GestureTypeSchema`, `SwipeGestureConfigSchema`, `PinchGestureConfigSchema`, `LongPressGestureConfigSchema`, `TouchInteractionSchema`, `TouchTargetConfigSchema` | 🟡 Partial — swipe/haptics exist, spec-driven gesture config pending |
-| Offline/Sync Protocol | `OfflineConfigSchema`, `OfflineCacheConfigSchema`, `OfflineStrategySchema`, `SyncConfigSchema`, `ConflictResolutionSchema`, `PersistStorageSchema`, `EvictionPolicySchema` | 🟡 Partial — offline hooks exist, spec-driven config pending |
-| Notification UI Protocol | `NotificationSchema`, `NotificationConfigSchema`, `NotificationActionSchema`, `NotificationPositionSchema`, `NotificationSeveritySchema`, `NotificationTypeSchema` | 🟡 Partial — notifications exist, SDUI notification rendering pending |
-| Animation/Transition Protocol | `AnimationSchema`, `AnimationTriggerSchema`, `ComponentAnimationSchema`, `TransitionConfigSchema`, `TransitionPresetSchema`, `MotionConfigSchema`, `EasingFunctionSchema`, `PageTransitionSchema` | 🟡 Partial — micro-interactions exist, spec-driven animations pending |
-| Focus/Keyboard Protocol | `FocusManagementSchema`, `FocusTrapConfigSchema`, `KeyboardNavigationConfigSchema`, `KeyboardShortcutSchema` | 🔴 New — external keyboard/focus management not yet implemented |
-| Embed/Sharing Protocol | `EmbedConfigSchema`, `SharingConfigSchema`, `ViewSharingSchema` | 🟡 Partial — `useSharing` exists, embed/view sharing UI pending |
-| Interface Page Protocol | `InterfacePageConfigSchema`, `BlankPageLayoutSchema`, `BlankPageLayoutItemSchema`, `PageTypeSchema` | 🟡 Partial — `PageRenderer` exists, interface page config pending |
+| Record Page Components | `RecordDetailsProps`, `RecordActivityProps`, `RecordChatterProps`, `RecordHighlightsProps`, `RecordPathProps`, `RecordRelatedListProps`, `RecordReviewConfigSchema` | ✅ `useRecordDetails`, `useRecordActivity`, `useRecordChatter`, `useRecordHighlights`, `useRecordPath`, `useRecordRelatedList`, `useRecordReview` |
+| Drag & Drop Protocol | `DndConfigSchema`, `DragItemSchema`, `DragHandleSchema`, `DragConstraintSchema`, `DropZoneSchema`, `DropEffectSchema` | ✅ `useDndProtocol` |
+| Gesture Protocol | `GestureConfigSchema`, `GestureTypeSchema`, `SwipeGestureConfigSchema`, `PinchGestureConfigSchema`, `LongPressGestureConfigSchema`, `TouchInteractionSchema`, `TouchTargetConfigSchema` | ✅ `useGestureProtocol` |
+| Offline/Sync Protocol | `OfflineConfigSchema`, `OfflineCacheConfigSchema`, `OfflineStrategySchema`, `SyncConfigSchema`, `ConflictResolutionSchema`, `PersistStorageSchema`, `EvictionPolicySchema` | ✅ `useOfflineConfig`, `useSyncConfig` |
+| Notification UI Protocol | `NotificationSchema`, `NotificationConfigSchema`, `NotificationActionSchema`, `NotificationPositionSchema`, `NotificationSeveritySchema`, `NotificationTypeSchema` | ✅ `useNotificationUI` |
+| Animation/Transition Protocol | `AnimationSchema`, `AnimationTriggerSchema`, `ComponentAnimationSchema`, `TransitionConfigSchema`, `TransitionPresetSchema`, `MotionConfigSchema`, `EasingFunctionSchema`, `PageTransitionSchema` | ✅ `useAnimationProtocol`, `usePageTransitionProtocol`, `useComponentAnimation` |
+| Focus/Keyboard Protocol | `FocusManagementSchema`, `FocusTrapConfigSchema`, `KeyboardNavigationConfigSchema`, `KeyboardShortcutSchema` | ✅ `useFocusManagement`, `useKeyboardNavigation` |
+| Embed/Sharing Protocol | `EmbedConfigSchema`, `SharingConfigSchema`, `ViewSharingSchema` | ✅ `useEmbedConfig`, `useViewSharing` |
+| Interface Page Protocol | `InterfacePageConfigSchema`, `BlankPageLayoutSchema`, `BlankPageLayoutItemSchema`, `PageTypeSchema` | ✅ `useInterfacePageConfig`, `useBlankPageLayout` |
 
 ---
 
@@ -611,52 +620,52 @@ The following new UI protocol schemas were added in spec v3.0.9 and are candidat
 
 ---
 
-## 7m. v1.7: Spec v3.0.9 UI Protocol Alignment 🔴
+## 7m. v1.7: Spec v3.0.9 UI Protocol Alignment ✅
 
 > **Duration**: 4–6 weeks | **Priority**: 🟡 Important for spec compliance
 > **Goal**: Implement new UI protocol schemas from `@objectstack/spec@3.0.9` for full SDUI compliance
 
-### Phase 23: SDUI Record Page Protocol 🔴
+### Phase 23: SDUI Record Page Protocol ✅
 
 > Align record detail/form views with spec v3.0.9 `RecordDetailsProps`, `RecordHighlightsProps`, etc.
 
 | # | Feature | Description | Status |
 |---|---------|-------------|--------|
-| 23.1 | Record Details SDUI | Render record detail layout from `RecordDetailsProps` (columns, sections, field list) | 🔴 Planned |
-| 23.2 | Record Highlights | Show highlight fields panel from `RecordHighlightsProps` | 🔴 Planned |
-| 23.3 | Record Activity Feed | Render activity timeline from `RecordActivityProps` | 🔴 Planned |
-| 23.4 | Record Chatter | In-context discussion from `RecordChatterProps` | 🔴 Planned |
-| 23.5 | Record Path / Breadcrumb | Navigation breadcrumb from `RecordPathProps` | 🔴 Planned |
-| 23.6 | Record Related Lists | Related record panels from `RecordRelatedListProps` | 🔴 Planned |
-| 23.7 | Record Review Config | Approval/review UI from `RecordReviewConfigSchema` | 🔴 Planned |
-| 23.8 | Interface Page Config | Airtable-style interface pages from `InterfacePageConfigSchema` | 🔴 Planned |
-| 23.9 | Blank Page Layouts | Custom blank page templates from `BlankPageLayoutSchema` | 🔴 Planned |
-
-### Phase 24: Interaction Protocol (DnD, Gesture, Animation) 🔴
+| 23.1 | Record Details SDUI | Render record detail layout from `RecordDetailsProps` (columns, sections, field list) | ✅ Done |
+| 23.2 | Record Highlights | Show highlight fields panel from `RecordHighlightsProps` | ✅ Done |
+| 23.3 | Record Activity Feed | Render activity timeline from `RecordActivityProps` | ✅ Done |
+| 23.4 | Record Chatter | In-context discussion from `RecordChatterProps` | ✅ Done |
+| 23.5 | Record Path / Breadcrumb | Navigation breadcrumb from `RecordPathProps` | ✅ Done |
+| 23.6 | Record Related Lists | Related record panels from `RecordRelatedListProps` | ✅ Done |
+| 23.7 | Record Review Config | Approval/review UI from `RecordReviewConfigSchema` | ✅ Done |
+| 23.8 | Interface Page Config | Airtable-style interface pages from `InterfacePageConfigSchema` | ✅ Done |
+| 23.9 | Blank Page Layouts | Custom blank page templates from `BlankPageLayoutSchema` | ✅ Done |
+
+### Phase 24: Interaction Protocol (DnD, Gesture, Animation) ✅
 
 > Implement spec-driven interaction configs instead of hardcoded behavior.
 
 | # | Feature | Description | Status |
 |---|---------|-------------|--------|
-| 24.1 | DnD Protocol | Spec-driven drag-and-drop from `DndConfigSchema` (drag items, drop zones, constraints, sortable) | 🔴 Planned |
-| 24.2 | Gesture Protocol | Configure gestures from `GestureConfigSchema` (swipe, pinch, long-press, touch targets) | 🔴 Planned |
-| 24.3 | Animation Protocol | Spec-driven animations from `AnimationSchema`, `TransitionConfigSchema`, `MotionConfigSchema` | 🔴 Planned |
-| 24.4 | Page Transition Protocol | Server-defined page transitions from `PageTransitionSchema`, `TransitionPresetSchema` | 🔴 Planned |
-| 24.5 | Component Animation | Per-component animation config from `ComponentAnimationSchema`, `EasingFunctionSchema` | 🔴 Planned |
+| 24.1 | DnD Protocol | Spec-driven drag-and-drop from `DndConfigSchema` (drag items, drop zones, constraints, sortable) | ✅ Done |
+| 24.2 | Gesture Protocol | Configure gestures from `GestureConfigSchema` (swipe, pinch, long-press, touch targets) | ✅ Done |
+| 24.3 | Animation Protocol | Spec-driven animations from `AnimationSchema`, `TransitionConfigSchema`, `MotionConfigSchema` | ✅ Done |
+| 24.4 | Page Transition Protocol | Server-defined page transitions from `PageTransitionSchema`, `TransitionPresetSchema` | ✅ Done |
+| 24.5 | Component Animation | Per-component animation config from `ComponentAnimationSchema`, `EasingFunctionSchema` | ✅ Done |
 
-### Phase 25: Focus, Keyboard, Offline & Notification Protocol 🔴
+### Phase 25: Focus, Keyboard, Offline & Notification Protocol ✅
 
 > Complete spec-driven configuration for accessibility, offline, and notification UI.
 
 | # | Feature | Description | Status |
 |---|---------|-------------|--------|
-| 25.1 | Focus Management | Spec-driven focus traps and management from `FocusManagementSchema`, `FocusTrapConfigSchema` | 🔴 Planned |
-| 25.2 | Keyboard Navigation | External keyboard support from `KeyboardNavigationConfigSchema`, `KeyboardShortcutSchema` | 🔴 Planned |
-| 25.3 | Offline Config Protocol | Server-driven offline strategy from `OfflineConfigSchema`, `OfflineCacheConfigSchema`, `EvictionPolicySchema` | 🔴 Planned |
-| 25.4 | Sync Config Protocol | Spec-driven sync behavior from `SyncConfigSchema`, `ConflictResolutionSchema`, `PersistStorageSchema` | 🔴 Planned |
-| 25.5 | Notification UI Protocol | SDUI notification rendering from `NotificationSchema`, `NotificationConfigSchema`, `NotificationActionSchema` | 🔴 Planned |
-| 25.6 | Embed Config | Embeddable views from `EmbedConfigSchema` | 🔴 Planned |
-| 25.7 | View Sharing Protocol | Spec-driven view sharing from `ViewSharingSchema`, `SharingConfigSchema` | 🔴 Planned |
+| 25.1 | Focus Management | Spec-driven focus traps and management from `FocusManagementSchema`, `FocusTrapConfigSchema` | ✅ Done |
+| 25.2 | Keyboard Navigation | External keyboard support from `KeyboardNavigationConfigSchema`, `KeyboardShortcutSchema` | ✅ Done |
+| 25.3 | Offline Config Protocol | Server-driven offline strategy from `OfflineConfigSchema`, `OfflineCacheConfigSchema`, `EvictionPolicySchema` | ✅ Done |
+| 25.4 | Sync Config Protocol | Spec-driven sync behavior from `SyncConfigSchema`, `ConflictResolutionSchema`, `PersistStorageSchema` | ✅ Done |
+| 25.5 | Notification UI Protocol | SDUI notification rendering from `NotificationSchema`, `NotificationConfigSchema`, `NotificationActionSchema` | ✅ Done |
+| 25.6 | Embed Config | Embeddable views from `EmbedConfigSchema` | ✅ Done |
+| 25.7 | View Sharing Protocol | Spec-driven view sharing from `ViewSharingSchema`, `SharingConfigSchema` | ✅ Done |
 
 ---
 
@@ -670,7 +679,7 @@ The following new UI protocol schemas were added in spec v3.0.9 and are candidat
 | Area | Rating | Status |
 |------|--------|--------|
 | Architecture | ★★★★★ | None — excellent foundation |
-| Feature Coverage | ★★★★★ | 64 hooks, 22 renderers/components |
+| Feature Coverage | ★★★★★ | 85 hooks, 22 renderers/components |
 | Visual Design | ★★★★☆ | Design tokens, elevation system, semantic colors |
 | Interaction Design | ★★★★☆ | Haptics, micro-interactions, animations, gestures |
 | Navigation Efficiency | ★★★★★ | 5-tab layout, global search, recent items |
@@ -799,7 +808,7 @@ The following new UI protocol schemas were added in spec v3.0.9 and are candidat
 | **v1.4** | 21–22 | Notification Center + Spec gaps (AI DevOps/CodeGen/Predictive, ETL/Connectors) | ✅ Complete |
 | **v1.5** | — | Messaging & Channels (Slack/Teams pattern, DMs, threads) | ✅ Complete |
 | **v1.6** | — | Advanced Offline (selective sync, three-way merge, offline analytics) | ✅ Complete |
-| **v1.7** | 23–25 | Spec v3.0.9 UI Protocol (SDUI record pages, DnD protocol, gesture/animation protocol, focus/keyboard) | 🔴 Planned |
+| **v1.7** | 23–25 | Spec v3.0.9 UI Protocol (SDUI record pages, DnD protocol, gesture/animation protocol, focus/keyboard) | ✅ Complete |
 
 ---
 
@@ -836,20 +845,20 @@ The following new UI protocol schemas were added in spec v3.0.9 and are candidat
 | **Notification Center (v1.4)** | **No** | **1 week** | **✅ Done** |
 | **Messaging & Channels (v1.5)** | **No** | **2 weeks** | **✅ Done** |
 | **Advanced Offline (v1.6)** | **No** | **2 weeks** | **✅ Done** |
-| **SDUI Record Page Protocol (23)** | **No** | **2–3 weeks** | **🔴 Planned** |
-| **Interaction Protocol — DnD/Gesture/Animation (24)** | **No** | **2–3 weeks** | **🔴 Planned** |
-| **Focus/Keyboard/Offline/Notification Protocol (25)** | **No** | **1–2 weeks** | **🔴 Planned** |
+| **SDUI Record Page Protocol (23)** | **No** | **2–3 weeks** | **✅ Done** |
+| **Interaction Protocol — DnD/Gesture/Animation (24)** | **No** | **2–3 weeks** | **✅ Done** |
+| **Focus/Keyboard/Offline/Notification Protocol (25)** | **No** | **1–2 weeks** | **✅ Done** |
 
 **Phase 11–22 + v1.4–v1.6**: ✅ Complete
-**Phase 23–25 (v1.7 — Spec v3.0.9 UI Protocol)**: 🔴 Planned
+**Phase 23–25 (v1.7 — Spec v3.0.9 UI Protocol)**: ✅ Complete
 
 ---
 
 ## 11. Success Criteria
 
 ### v1.0 GA
 
-1. ✅ 1003+ unit/integration tests passing
+1. ✅ 1149+ unit/integration tests passing
 2. ✅ All hooks and lib modules have test coverage
 3. ✅ 4 Jest E2E screen tests passing (32 tests); Maestro flows configured
 4. ☐ Performance metrics within targets on real devices
@@ -883,11 +892,11 @@ The following new UI protocol schemas were added in spec v3.0.9 and are candidat
 
 ### v1.7 (Spec v3.0.9 UI Protocol)
 
-1. ☐ Phase 23 complete (SDUI record pages, highlights, chatter, related lists, interface pages)
-2. ☐ Phase 24 complete (spec-driven DnD, gesture, animation, transition protocols)
-3. ☐ Phase 25 complete (focus management, keyboard navigation, offline/sync/notification UI protocols)
-4. ☐ All renderers consume spec UI schemas instead of hardcoded configs
-5. ☐ Full compliance with `@objectstack/spec@3.0.9` UI module (168 exports)
+1. ✅ Phase 23 complete (SDUI record pages, highlights, chatter, related lists, interface pages)
+2. ✅ Phase 24 complete (spec-driven DnD, gesture, animation, transition protocols)
+3. ✅ Phase 25 complete (focus management, keyboard navigation, offline/sync/notification UI protocols)
+4. ✅ All renderers consume spec UI schemas instead of hardcoded configs
+5. ✅ Full compliance with `@objectstack/spec@3.0.9` UI module (168 exports)
 
 ---
 

__tests__/hooks/useInterfacePageConfig.test.ts

@@ -3,7 +3,7 @@
  * block addition, removal, reordering, and updates.
  */
 import { renderHook, act } from "@testing-library/react-native";
-import { useInterfacePageConfig, PageBlock } from "~/hooks/useInterfacePageConfig";
+import { useInterfacePageConfig } from "~/hooks/useInterfacePageConfig";
 
 describe("useInterfacePageConfig", () => {
   it("returns default empty state initially", () => {

__tests__/hooks/useRecordReview.test.ts

@@ -3,7 +3,7 @@
  * reviewer addition/removal, approval, rejection, and status transitions.
  */
 import { renderHook, act } from "@testing-library/react-native";
-import { useRecordReview, Reviewer } from "~/hooks/useRecordReview";
+import { useRecordReview } from "~/hooks/useRecordReview";
 
 describe("useRecordReview", () => {
   it("returns default state initially", () => {

hooks/useRecordDetails.ts

@@ -1,4 +1,4 @@
-import { useCallback, useMemo, useState } from "react";
+import { useCallback, useState } from "react";
 
 /* ------------------------------------------------------------------ */
 /*  Types                                                               */