@object-ui/mobile 16.1.0 → 17.2.0

package/CHANGELOG.md

@@ -1,5 +1,132 @@
 # @object-ui/mobile
 
+## 17.2.0
+
+### Minor Changes
+
+- 726b89c: `@object-ui/types` stops declaring sixteen symbols under names `@objectstack/spec` owns (objectui#3156, objectstack#4115).
+
+  Seven are now **derived** from the spec, nine are **renamed** to the local
+  dialect they always were. Both halves remove the same hazard: a local
+  declaration under a spec export's name reads as the spec's own definition to
+  the next reader, so a copy that is merely _correct today_ is a planted premise
+  tomorrow.
+
+  **Derived** — the spec now supplies the keys, by reference:
+
+  | symbol                   | derivation                                                                        |
+  | :----------------------- | :-------------------------------------------------------------------------------- |
+  | `ActionParam`            | `z.input<typeof ActionParamSchema>`, `type` widened to the local legacy spellings |
+  | `CreateExportJobRequest` | `Omit<CreateExportJobInput, 'object'>` (`object` is the method argument)          |
+  | `CreateExportJobResult`  | re-export from `@objectstack/spec/contracts`                                      |
+  | `ImportRowResult`        | re-export from `@objectstack/spec/api`                                            |
+  | `NavigationArea`         | spec keys, with `navigation` / `visible` pinned locally                           |
+  | `NavigationAreaSchema`   | `specFieldsExcept(NavigationAreaSchema.shape, …)`                                 |
+  | `Theme`                  | re-export of the spec's `ThemeInput` (the authoring shape)                        |
+  | `ExportJobFormat`        | re-export of the spec's `ExportFormat`                                            |
+
+  Four of these close real gaps rather than tidy names. `ActionParam` never
+  declared `reference` — the key `resolveActionParams()` actually reads for an
+  inline lookup target — nor `defaultFromRow`, which the metadata designer's own
+  inspector writes; it also narrowed `visible` to a bare string although the
+  resolver has always accepted the `{ dialect, source }` envelope too.
+  `CreateExportJobResult.createdAt` and `ImportRowResult.action` were optional
+  here and required by the server, leaving every consumer a branch that could
+  never run. And `NavigationArea`'s `id` now carries the spec's own length rule
+  instead of accepting any string.
+
+  **Renamed** — same word, different concept:
+
+  | was                | now                      | why                                                                                                                            |
+  | :----------------- | :----------------------- | :----------------------------------------------------------------------------------------------------------------------------- |
+  | `FileMetadata`     | `UploadedFileMetadata`   | field-VALUE payload (`url`, `original_name`), not the storage file record                                                      |
+  | `GestureType`      | `TouchGestureType`       | direction-fused (`swipe-left`), not the spec's type+direction pair                                                             |
+  | `GestureConfig`    | `TouchGestureConfig`     | gesture→`action` binding, not per-gesture tuning                                                                               |
+  | `OfflineConfig`    | `PWAOfflineConfig`       | service-worker route caching, not the offline data/sync model                                                                  |
+  | `PageRegion`       | `PageNodeRegion`         | region of the renderer page NODE, holding `SchemaNode`s                                                                        |
+  | `PageRegionSchema` | `PageNodeRegionSchema`   | zod twin of the above                                                                                                          |
+  | `ResponsiveConfig` | `MobileResponsiveConfig` | mobile box config, not the spec's SDUI grid contract                                                                           |
+  | `WidgetManifest`   | `RuntimeWidgetManifest`  | SDUI component manifest, not the field-widget plugin manifest                                                                  |
+  | `WidgetSource`     | `RuntimeWidgetSource`    | `module`/`inline`/`registry` loader union — and its `inline` carries a resolved component where the spec's carries source code |
+
+  **Migration**: the old names are gone, not deprecated — an alias would preserve
+  exactly the ambiguity being removed. Import the new name; nothing about the
+  shapes changed. `@object-ui/types` already re-exports the spec's own
+  `SpecResponsiveConfig`, and `@object-ui/react`'s `useOffline` config remains the
+  spec-shaped `OfflineConfig`, so both concepts stay reachable under
+  distinguishable names.
+
+  Each rename carries a bidirectional tripwire
+  (`packages/types/src/__tests__/page-nav-misc-spec-parity.test.ts`): it fails if
+  the spec ever claims the new name, and also if the spec retires the old one —
+  at which point the natural name can be taken back rather than the workaround
+  outliving its reason.
+
+### Patch Changes
+
+- Updated dependencies [4ae0ac4]
+- Updated dependencies [696e3c1]
+- Updated dependencies [4bf612c]
+- Updated dependencies [cb82705]
+- Updated dependencies [f572849]
+- Updated dependencies [444457c]
+- Updated dependencies [022e4c3]
+- Updated dependencies [009e25d]
+- Updated dependencies [726b89c]
+  - @object-ui/types@17.2.0
+
+## 17.1.0
+
+### Patch Changes
+
+- Updated dependencies [9e7349e]
+- Updated dependencies [8864971]
+- Updated dependencies [b41f401]
+- Updated dependencies [19e9fa0]
+- Updated dependencies [38ca8be]
+- Updated dependencies [4952edf]
+- Updated dependencies [7f0252e]
+- Updated dependencies [7639a61]
+- Updated dependencies [94e63ef]
+- Updated dependencies [c4db402]
+- Updated dependencies [5319bf1]
+- Updated dependencies [49e5671]
+- Updated dependencies [b5b97e2]
+- Updated dependencies [f59f2c1]
+- Updated dependencies [4874117]
+- Updated dependencies [ce08d55]
+- Updated dependencies [2374a49]
+- Updated dependencies [ea7f477]
+- Updated dependencies [7f23cd0]
+- Updated dependencies [24e0e0a]
+- Updated dependencies [3a6cf24]
+- Updated dependencies [aa35561]
+- Updated dependencies [03bd53b]
+- Updated dependencies [3c1f321]
+- Updated dependencies [a045a32]
+- Updated dependencies [912496d]
+- Updated dependencies [9867281]
+  - @object-ui/types@17.1.0
+
+## 17.0.0
+
+### Patch Changes
+
+- Updated dependencies [1767124]
+- Updated dependencies [8ecf5a6]
+- Updated dependencies [dfd3705]
+- Updated dependencies [6dee2cb]
+- Updated dependencies [c7cff19]
+- Updated dependencies [cd09a7b]
+- Updated dependencies [f1abf0e]
+- Updated dependencies [f05b84e]
+- Updated dependencies [662bdf9]
+- Updated dependencies [059a052]
+- Updated dependencies [53642d4]
+- Updated dependencies [8aae006]
+- Updated dependencies [d147a13]
+  - @object-ui/types@17.0.0
+
 ## 16.1.0
 
 ### Patch Changes

package/dist/MobileProvider.d.ts

@@ -6,19 +6,19 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React from 'react';
-import type { PWAConfig, OfflineConfig } from '@object-ui/types';
+import type { PWAConfig, PWAOfflineConfig } from '@object-ui/types';
 import { type BreakpointState } from './useBreakpoint';
 export interface MobileContextValue extends BreakpointState {
     /** PWA configuration */
     pwa?: PWAConfig;
     /** Offline configuration */
-    offline?: OfflineConfig;
+    offline?: PWAOfflineConfig;
 }
 export interface MobileProviderProps {
     /** PWA configuration */
     pwa?: PWAConfig;
     /** Offline configuration */
-    offline?: OfflineConfig;
+    offline?: PWAOfflineConfig;
     /** Children */
     children: React.ReactNode;
 }

package/dist/MobileProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileProvider.d.ts","sourceRoot":"","sources":["../src/MobileProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtE,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,wBAAwB;IACxB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAKD,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,eAAe;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,mBAAmB,qBAa7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,GAAG,IAAI,CAE5D"}
+{"version":3,"file":"MobileProvider.d.ts","sourceRoot":"","sources":["../src/MobileProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtE,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,wBAAwB;IACxB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAKD,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,eAAe;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,mBAAmB,qBAa7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,GAAG,IAAI,CAE5D"}

package/dist/index.d.ts

@@ -33,5 +33,5 @@ export { createOfflineDataSource, type OfflineDataSource, type OfflineDataSource
 export { useOfflineSync, type OfflineSyncState } from './useOfflineSync';
 export { getServiceWorkerSource, requestBackgroundSync, type ServiceWorkerSourceOptions, } from './serviceWorkerSource';
 export { BREAKPOINTS, resolveResponsiveValue } from './breakpoints';
-export type { BreakpointName, ResponsiveValue, ResponsiveConfig, MobileOverrides, PWAConfig, PWAIcon, CacheStrategy, OfflineConfig, OfflineRoute, GestureType, GestureConfig, GestureContext, MobileComponentConfig, SpecGestureConfig, SwipeGestureConfig, PinchGestureConfig, LongPressGestureConfig, TouchInteraction, TouchTargetConfig, } from '@object-ui/types';
+export type { BreakpointName, ResponsiveValue, MobileResponsiveConfig, MobileOverrides, PWAConfig, PWAIcon, FetchCacheStrategy, PWAOfflineConfig, OfflineRoute, TouchGestureType, TouchGestureConfig, GestureContext, MobileComponentConfig, SpecGestureConfig, SwipeGestureConfig, PinchGestureConfig, LongPressGestureConfig, TouchInteraction, TouchTargetConfig, } from '@object-ui/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGpE,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,OAAO,EACP,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGpE,YAAY,EACV,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,SAAS,EACT,OAAO,EACP,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC"}

package/dist/useGesture.d.ts

@@ -5,10 +5,10 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { GestureType, GestureContext } from '@object-ui/types';
+import type { TouchGestureType, GestureContext } from '@object-ui/types';
 export interface UseGestureOptions {
     /** Gesture type to detect */
-    type: GestureType;
+    type: TouchGestureType;
     /** Callback when gesture is detected */
     onGesture: (context: GestureContext) => void;
     /** Minimum distance for swipe detection (pixels) */

package/dist/useGesture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGesture.d.ts","sourceRoot":"","sources":["../src/useGesture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC5D,OAAO,EAAE,iBAAiB,uCAkH3B"}
+{"version":3,"file":"useGesture.d.ts","sourceRoot":"","sources":["../src/useGesture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IACvB,wCAAwC;IACxC,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC5D,OAAO,EAAE,iBAAiB,uCAqK3B"}

package/dist/useGesture.js

@@ -23,12 +23,27 @@ export function useGesture(options) {
     const ref = useRef(null);
     const startRef = useRef(null);
     const longPressTimerRef = useRef(undefined);
+    // Real double-tap needs the PREVIOUS tap's timestamp — the old
+    // implementation fired on every single qualifying tap (#2942).
+    const lastTapRef = useRef(0);
+    // Two-touch tracking for pinch/rotate: initial + latest distance/angle
+    // between the two touch points.
+    const twoTouchRef = useRef(null);
     const { type, onGesture, threshold = 50, longPressDuration = 500, enabled = true } = options;
     const handleTouchStart = useCallback((e) => {
         if (!enabled)
             return;
         const touch = e.touches[0];
         startRef.current = { x: touch.clientX, y: touch.clientY, time: Date.now() };
+        // Pinch/rotate baseline — distance and angle between the two touches.
+        if ((type === 'pinch' || type === 'rotate') && e.touches.length >= 2) {
+            const [t1, t2] = [e.touches[0], e.touches[1]];
+            const dx2 = t2.clientX - t1.clientX;
+            const dy2 = t2.clientY - t1.clientY;
+            const d = Math.hypot(dx2, dy2);
+            const a = (Math.atan2(dy2, dx2) * 180) / Math.PI;
+            twoTouchRef.current = { d0: d, a0: a, d1: d, a1: a };
+        }
         if (type === 'long-press') {
             longPressTimerRef.current = setTimeout(() => {
                 if (startRef.current) {
@@ -62,14 +77,45 @@ export function useGesture(options) {
             duration,
             velocity,
         };
+        // Pinch / rotate resolve from the two-touch delta, not the single-touch
+        // path below. Fired once on release, like the other discrete gestures.
+        if (type === 'pinch' || type === 'rotate') {
+            const t2 = twoTouchRef.current;
+            twoTouchRef.current = null;
+            startRef.current = null;
+            if (!t2 || t2.d0 <= 0)
+                return;
+            const scale = t2.d1 / t2.d0;
+            // Normalize the angle delta into (-180, 180].
+            let rotation = t2.a1 - t2.a0;
+            if (rotation > 180)
+                rotation -= 360;
+            if (rotation <= -180)
+                rotation += 360;
+            if (type === 'pinch' && Math.abs(scale - 1) >= 0.1) {
+                onGesture({ ...context, scale });
+            }
+            else if (type === 'rotate' && Math.abs(rotation) >= 15) {
+                onGesture({ ...context, rotation });
+            }
+            return;
+        }
         // Detect gesture type
         if (type === 'tap' && distance < 10 && duration < 300) {
             onGesture(context);
         }
         else if (type === 'double-tap') {
-            // Double-tap handled separately (simplified)
+            // Two qualifying taps within 350ms — a single tap must NOT fire
+            // (it used to, collapsing double-tap into tap, #2942).
             if (distance < 10 && duration < 300) {
-                onGesture(context);
+                const now = Date.now();
+                if (now - lastTapRef.current <= 350) {
+                    lastTapRef.current = 0;
+                    onGesture(context);
+                }
+                else {
+                    lastTapRef.current = now;
+                }
             }
         }
         else if (distance >= threshold) {
@@ -93,11 +139,19 @@ export function useGesture(options) {
         }
         startRef.current = null;
     }, [type, onGesture, threshold, enabled]);
-    const handleTouchMove = useCallback(() => {
+    const handleTouchMove = useCallback((e) => {
         // Cancel long-press if finger moves
         if (type === 'long-press') {
             clearTimeout(longPressTimerRef.current);
         }
+        // Track the latest two-touch distance/angle for pinch/rotate.
+        if ((type === 'pinch' || type === 'rotate') && twoTouchRef.current && e.touches.length >= 2) {
+            const [t1, t2] = [e.touches[0], e.touches[1]];
+            const dx2 = t2.clientX - t1.clientX;
+            const dy2 = t2.clientY - t1.clientY;
+            twoTouchRef.current.d1 = Math.hypot(dx2, dy2);
+            twoTouchRef.current.a1 = (Math.atan2(dy2, dx2) * 180) / Math.PI;
+        }
     }, [type]);
     useEffect(() => {
         const el = ref.current;

package/dist/useSpecGesture.d.ts

@@ -5,7 +5,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { SpecGestureConfig } from '@object-ui/types';
+import type { TouchGestureType, SpecGestureConfig } from '@object-ui/types';
 export interface UseSpecGestureOptions {
     /** Spec gesture configuration */
     config: SpecGestureConfig;
@@ -15,7 +15,33 @@ export interface UseSpecGestureOptions {
     onPinch?: (scale: number) => void;
     /** Callback when a long-press gesture is detected */
     onLongPress?: () => void;
+    /** Callback when a double-tap gesture is detected */
+    onDoubleTap?: () => void;
+    /** Callback when a pan/drag gesture is detected (any-direction move) */
+    onPan?: (direction: string) => void;
+    /** Callback when a rotate gesture is detected (degrees, CW positive) */
+    onRotate?: (rotation: number) => void;
+    /** Fallback for gestures without a dedicated callback */
+    onGesture?: (context: {
+        type: string;
+        direction?: string;
+        scale?: number;
+        rotation?: number;
+    }) => void;
 }
+/**
+ * Spec `GestureTypeSchema` (`ui/touch.zod.ts`) → the recognizer type
+ * `useGesture` implements. The spec's `drag` and `pan` are one recognizer
+ * (any-direction move past the threshold); `swipe` resolves per configured
+ * direction, so it maps through {@link SWIPE_DIRECTION_MAP} instead.
+ * Exported for the spec-parity test.
+ *
+ * Before #2942 the hook never read `config.type` at all — it branched on
+ * which SUB-OBJECT was present (`swipe` / `pinch` / `longPress`), so
+ * `pan` / `drag` / `rotate` / `double_tap` (types with no sub-object) all
+ * fell through to the `'tap'` initializer and fired on a tap.
+ */
+export declare const SPEC_GESTURE_TYPE_MAP: Record<string, TouchGestureType>;
 /**
  * Spec-aware gesture hook that maps an @objectstack/spec GestureConfig
  * to the existing useGesture hook.

package/dist/useSpecGesture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSpecGesture.d.ts","sourceRoot":"","sources":["../src/useSpecGesture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAChE,OAAO,EAAE,qBAAqB,uCAiC/B"}
+{"version":3,"file":"useSpecGesture.d.ts","sourceRoot":"","sources":["../src/useSpecGesture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,wEAAwE;IACxE,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,yDAAyD;IACzD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACxG;AASD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAQlE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAChE,OAAO,EAAE,qBAAqB,uCAoE/B"}

package/dist/useSpecGesture.js

@@ -12,6 +12,27 @@ const SWIPE_DIRECTION_MAP = {
     up: 'swipe-up',
     down: 'swipe-down',
 };
+/**
+ * Spec `GestureTypeSchema` (`ui/touch.zod.ts`) → the recognizer type
+ * `useGesture` implements. The spec's `drag` and `pan` are one recognizer
+ * (any-direction move past the threshold); `swipe` resolves per configured
+ * direction, so it maps through {@link SWIPE_DIRECTION_MAP} instead.
+ * Exported for the spec-parity test.
+ *
+ * Before #2942 the hook never read `config.type` at all — it branched on
+ * which SUB-OBJECT was present (`swipe` / `pinch` / `longPress`), so
+ * `pan` / `drag` / `rotate` / `double_tap` (types with no sub-object) all
+ * fell through to the `'tap'` initializer and fired on a tap.
+ */
+export const SPEC_GESTURE_TYPE_MAP = {
+    swipe: 'swipe-left', // per-direction; resolved via SWIPE_DIRECTION_MAP
+    pinch: 'pinch',
+    long_press: 'long-press',
+    double_tap: 'double-tap',
+    drag: 'pan',
+    pan: 'pan',
+    rotate: 'rotate',
+};
 /**
  * Spec-aware gesture hook that maps an @objectstack/spec GestureConfig
  * to the existing useGesture hook.
@@ -26,28 +47,59 @@ const SWIPE_DIRECTION_MAP = {
  * ```
  */
 export function useSpecGesture(options) {
-    const { config, onSwipe, onPinch, onLongPress } = options;
+    const { config, onSwipe, onPinch, onLongPress, onDoubleTap, onPan, onRotate, onGesture: onAny } = options;
     const enabled = config.enabled ?? true;
+    // The DECLARED type drives recognition (#2942) — `config.type` is required
+    // by the spec's `GestureConfigSchema`. The sub-object presence checks below
+    // only back-fill legacy configs that predate the type field.
+    const declared = typeof config.type === 'string'
+        ? config.type
+        : config.swipe
+            ? 'swipe'
+            : config.longPress
+                ? 'long_press'
+                : config.pinch
+                    ? 'pinch'
+                    : undefined;
     let gestureType = 'tap';
     let threshold;
     let longPressDuration;
     let onGesture = () => { };
-    if (config.swipe && onSwipe) {
-        const dir = Array.isArray(config.swipe.direction)
-            ? config.swipe.direction[0]
-            : config.swipe.direction;
-        gestureType = (dir && SWIPE_DIRECTION_MAP[dir]) ?? 'swipe-left';
-        threshold = config.swipe.threshold;
-        onGesture = (ctx) => onSwipe(ctx.direction ?? dir ?? 'left');
-    }
-    else if (config.longPress && onLongPress) {
-        gestureType = 'long-press';
-        longPressDuration = config.longPress.duration;
-        onGesture = () => onLongPress();
-    }
-    else if (config.pinch && onPinch) {
-        gestureType = 'pinch';
-        onGesture = (ctx) => onPinch(ctx.scale ?? 1);
+    const fallback = (ctx) => onAny?.(ctx);
+    switch (declared) {
+        case 'swipe': {
+            const dir = Array.isArray(config.swipe?.direction)
+                ? config.swipe?.direction[0]
+                : config.swipe?.direction;
+            gestureType = (dir ? SWIPE_DIRECTION_MAP[dir] : undefined) ?? 'swipe-left';
+            threshold = config.swipe?.threshold;
+            onGesture = (ctx) => (onSwipe ? onSwipe(ctx.direction ?? dir ?? 'left') : fallback({ type: 'swipe', ...ctx }));
+            break;
+        }
+        case 'long_press':
+            gestureType = 'long-press';
+            longPressDuration = config.longPress?.duration;
+            onGesture = () => (onLongPress ? onLongPress() : fallback({ type: 'long_press' }));
+            break;
+        case 'pinch':
+            gestureType = 'pinch';
+            onGesture = (ctx) => (onPinch ? onPinch(ctx.scale ?? 1) : fallback({ type: 'pinch', ...ctx }));
+            break;
+        case 'double_tap':
+            gestureType = 'double-tap';
+            onGesture = () => (onDoubleTap ? onDoubleTap() : fallback({ type: 'double_tap' }));
+            break;
+        case 'pan':
+        case 'drag':
+            gestureType = 'pan';
+            onGesture = (ctx) => (onPan ? onPan(ctx.direction ?? 'left') : fallback({ type: declared, ...ctx }));
+            break;
+        case 'rotate':
+            gestureType = 'rotate';
+            onGesture = (ctx) => (onRotate ? onRotate(ctx.rotation ?? 0) : fallback({ type: 'rotate', ...ctx }));
+            break;
+        default:
+            break;
     }
     return useGesture({
         type: gestureType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/mobile",
-  "version": "16.1.0",
+  "version": "17.2.0",
   "type": "module",
   "license": "MIT",
   "description": "Mobile optimization for Object UI with responsive components, PWA support, and touch gesture handling.",
@@ -30,11 +30,12 @@
     "react": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@object-ui/types": "16.1.0"
+    "@object-ui/types": "17.2.0"
   },
   "devDependencies": {
+    "@objectstack/spec": "^17.0.0-rc.1",
     "@types/react": "19.2.17",
-    "react": "19.2.7",
+    "react": "19.2.8",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   },
@@ -63,7 +64,7 @@
     "build": "tsc",
     "clean": "rm -rf dist",
     "test": "vitest run",
-    "type-check": "tsc --noEmit",
+    "type-check": "tsc --noEmit && tsc -p tsconfig.test.json",
     "lint": "eslint ."
   }
 }