@object-ui/mobile 17.5.0 → 17.7.0

package/dist/useSpecGesture.d.ts

@@ -21,7 +21,10 @@ export interface UseSpecGestureOptions {
     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 */
+    /**
+     * Fallback for gestures without a dedicated callback. Its `type` is the
+     * DECLARED spec gesture, never the recognizer's own name for the same move.
+     */
     onGesture?: (context: {
         type: string;
         direction?: string;
@@ -35,8 +38,10 @@ export interface UseSpecGestureOptions {
  * {@link GestureType} `useGesture` implements. Note the two sides are
  * different vocabularies, which is why this map exists at all: the retired
  * 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.
+ * (any-direction move past the threshold); `swipe` declares a SET of
+ * directions, so it recognizes on that same any-direction move and fires only
+ * when the DETECTED direction is a member of the declared set — no single
+ * recognizer name carries that, which is why its entry below is a placeholder.
  * Exported for the spec-parity test.
  *
  * Before #2942 the hook never read `config.type` at all — it branched on
@@ -47,13 +52,14 @@ export interface UseSpecGestureOptions {
 export declare const SPEC_GESTURE_TYPE_MAP: Record<string, GestureType>;
 /**
  * Spec-aware gesture hook that maps a {@link SpecGestureConfig} — the retired
- * `@objectstack/spec` `ui/touch` shape, not this package's own
- * `GestureConfig` — onto the existing useGesture hook.
+ * `@objectstack/spec` `ui/touch` tuning shape, a different contract from the
+ * direction-fused {@link GestureType} vocabulary `useGesture` speaks — onto
+ * the existing useGesture hook.
  *
  * @example
  * ```tsx
  * const ref = useSpecGesture({
- *   config: { type: 'swipe', enabled: true, swipe: { direction: 'left', threshold: 80 } },
+ *   config: { type: 'swipe', enabled: true, swipe: { direction: ['left'], threshold: 80 } },
  *   onSwipe: (dir) => console.log('Swiped', dir),
  * });
  * return <div ref={ref}>Swipe me</div>;

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,WAAW,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;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;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAQ7D,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAChE,OAAO,EAAE,qBAAqB,uCAoE/B"}
+{"version":3,"file":"useSpecGesture.d.ts","sourceRoot":"","sources":["../src/useSpecGesture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,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;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;;;OAGG;IACH,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;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAQ7D,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAChE,OAAO,EAAE,qBAAqB,uCAoF/B"}

package/dist/useSpecGesture.js

@@ -5,21 +5,17 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { useGesture } from './useGesture';
-const SWIPE_DIRECTION_MAP = {
-    left: 'swipe-left',
-    right: 'swipe-right',
-    up: 'swipe-up',
-    down: 'swipe-down',
-};
+import { useGesture } from './useGesture.js';
 /**
  * `SPEC_GESTURE_TYPES` (the retired `ui/touch` vocabulary, owned by
  * `@object-ui/types` since objectstack#4988) → the recognizer
  * {@link GestureType} `useGesture` implements. Note the two sides are
  * different vocabularies, which is why this map exists at all: the retired
  * 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.
+ * (any-direction move past the threshold); `swipe` declares a SET of
+ * directions, so it recognizes on that same any-direction move and fires only
+ * when the DETECTED direction is a member of the declared set — no single
+ * recognizer name carries that, which is why its entry below is a placeholder.
  * Exported for the spec-parity test.
  *
  * Before #2942 the hook never read `config.type` at all — it branched on
@@ -28,7 +24,7 @@ const SWIPE_DIRECTION_MAP = {
  * 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
+    swipe: 'swipe-left', // placeholder; the hook recognizes any direction and filters by the declared set
     pinch: 'pinch',
     long_press: 'long-press',
     double_tap: 'double-tap',
@@ -38,13 +34,14 @@ export const SPEC_GESTURE_TYPE_MAP = {
 };
 /**
  * Spec-aware gesture hook that maps a {@link SpecGestureConfig} — the retired
- * `@objectstack/spec` `ui/touch` shape, not this package's own
- * `GestureConfig` — onto the existing useGesture hook.
+ * `@objectstack/spec` `ui/touch` tuning shape, a different contract from the
+ * direction-fused {@link GestureType} vocabulary `useGesture` speaks — onto
+ * the existing useGesture hook.
  *
  * @example
  * ```tsx
  * const ref = useSpecGesture({
- *   config: { type: 'swipe', enabled: true, swipe: { direction: 'left', threshold: 80 } },
+ *   config: { type: 'swipe', enabled: true, swipe: { direction: ['left'], threshold: 80 } },
  *   onSwipe: (dir) => console.log('Swiped', dir),
  * });
  * return <div ref={ref}>Swipe me</div>;
@@ -69,15 +66,34 @@ export function useSpecGesture(options) {
     let threshold;
     let longPressDuration;
     let onGesture = () => { };
+    // `type` goes LAST in every payload below. The recognizer's own `type`
+    // travels inside `ctx` at runtime (`GestureContext.type`), so a `type`
+    // written BEFORE the spread is overwritten by it and the callback reports the
+    // recognizer instead of the declared spec gesture (objectui#9691). The two
+    // are different vocabularies — see `SPEC_GESTURE_TYPE_MAP` — so they agree
+    // only by coincidence, arm by arm.
     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';
+            // `SwipeGestureConfig.direction` is declared as a SET
+            // (`SpecSwipeDirection[]`), so recognition is the any-direction move past
+            // the threshold and the swipe fires only when the DETECTED direction is a
+            // MEMBER of that set. `direction[0]` would honour one element of a declared
+            // many; a scalar `direction` is rejected by the declared type and nothing
+            // re-admits it here (AGENTS.md #0.1). An empty or absent set declares no
+            // direction, so it fires for none.
+            const declaredDirections = config.swipe?.direction ?? [];
+            gestureType = 'pan';
             threshold = config.swipe?.threshold;
-            onGesture = (ctx) => (onSwipe ? onSwipe(ctx.direction ?? dir ?? 'left') : fallback({ type: 'swipe', ...ctx }));
+            onGesture = (ctx) => {
+                const detected = ctx.direction;
+                if (detected === undefined || !declaredDirections.includes(detected))
+                    return;
+                if (onSwipe)
+                    onSwipe(detected);
+                else
+                    fallback({ ...ctx, type: 'swipe' });
+            };
             break;
         }
         case 'long_press':
@@ -87,7 +103,7 @@ export function useSpecGesture(options) {
             break;
         case 'pinch':
             gestureType = 'pinch';
-            onGesture = (ctx) => (onPinch ? onPinch(ctx.scale ?? 1) : fallback({ type: 'pinch', ...ctx }));
+            onGesture = (ctx) => (onPinch ? onPinch(ctx.scale ?? 1) : fallback({ ...ctx, type: 'pinch' }));
             break;
         case 'double_tap':
             gestureType = 'double-tap';
@@ -96,11 +112,11 @@ export function useSpecGesture(options) {
         case 'pan':
         case 'drag':
             gestureType = 'pan';
-            onGesture = (ctx) => (onPan ? onPan(ctx.direction ?? 'left') : fallback({ type: declared, ...ctx }));
+            onGesture = (ctx) => (onPan ? onPan(ctx.direction ?? 'left') : fallback({ ...ctx, type: declared }));
             break;
         case 'rotate':
             gestureType = 'rotate';
-            onGesture = (ctx) => (onRotate ? onRotate(ctx.rotation ?? 0) : fallback({ type: 'rotate', ...ctx }));
+            onGesture = (ctx) => (onRotate ? onRotate(ctx.rotation ?? 0) : fallback({ ...ctx, type: 'rotate' }));
             break;
         default:
             break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/mobile",
-  "version": "17.5.0",
+  "version": "17.7.0",
   "type": "module",
   "license": "MIT",
   "description": "Mobile optimization for Object UI with responsive components, PWA support, and touch gesture handling.",
@@ -30,10 +30,10 @@
     "react": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@object-ui/types": "17.5.0"
+    "@object-ui/types": "17.7.0"
   },
   "devDependencies": {
-    "@objectstack/spec": "^17.0.0-rc.6",
+    "@objectstack/spec": "^17.0.0",
     "@types/react": "19.2.18",
     "react": "19.2.8",
     "typescript": "^6.0.3",
@@ -61,9 +61,9 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf dist",
-    "test": "vitest run",
+    "build": "tsc && node ../../scripts/check-dist-completeness.mjs",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "test": "vitest run --root ../.. packages/mobile/",
     "type-check": "tsc --noEmit && tsc -p tsconfig.test.json",
     "lint": "eslint ."
   }

package/dist/useResponsiveConfig.d.ts

@@ -1,71 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-import type { BreakpointName, SpecResponsiveConfig } from '@object-ui/types';
-/**
- * The responsive layout config this hook consumes — re-exported, not re-declared
- * (objectui#4598).
- *
- * This used to be a hand-written interface over the same four keys, under a
- * comment asserting it mirrored the schema. The assertion was true on the day it
- * was written and maintained by nobody after that: the interface named the
- * schema without ever referring to it, so a key added or retired upstream would
- * have moved the two apart in silence. `ViewNavigationConfig` (objectui#4588)
- * read the same way until it had drifted on `mode`.
- *
- * `@object-ui/types` — already this package's only runtime dependency — publishes
- * the schema's own type at `index.ts` under this exact name, imported from
- * `@objectstack/spec/ui` rather than copied. Re-exporting it costs no new
- * dependency edge and leaves the published name unchanged, so the four keys are
- * now whatever the schema says they are rather than whatever this file last
- * remembered. `@object-ui/core`'s `ResponsiveProtocol` already binds through the
- * same re-export.
- *
- * `responsive-config-spec-parity.test.ts` pins the chain to the schema itself,
- * because the one link this file cannot see is `@object-ui/types` re-growing a
- * hand copy of its own.
- *
- * @example
- * ```ts
- * const config: SpecResponsiveConfig = {
- *   columns: { xs: 12, sm: 6, lg: 4 },
- *   hiddenOn: ['xs'],
- *   order: { xs: 2, lg: 1 },
- * };
- * ```
- */
-export type { SpecResponsiveConfig };
-/**
- * Resolved responsive state from a SpecResponsiveConfig.
- */
-export interface ResolvedResponsiveState {
-    /** Whether the component is hidden at the current breakpoint */
-    hidden: boolean;
-    /** Resolved column count for the current breakpoint */
-    columns: number | undefined;
-    /** Resolved display order for the current breakpoint */
-    order: number | undefined;
-    /** Current active breakpoint name */
-    breakpoint: BreakpointName;
-}
-/**
- * Hook that consumes @objectstack/spec ResponsiveConfigSchema and
- * resolves breakpoint-aware layout state.
- *
- * @example
- * ```tsx
- * const { hidden, columns, order } = useResponsiveConfig({
- *   columns: { xs: 12, sm: 6, lg: 4 },
- *   hiddenOn: ['xs'],
- *   order: { xs: 2, lg: 1 },
- * });
- * if (hidden) return null;
- * return <div style={{ gridColumn: `span ${columns}`, order }}>...</div>;
- * ```
- */
-export declare function useResponsiveConfig(config?: SpecResponsiveConfig): ResolvedResponsiveState;
-//# sourceMappingURL=useResponsiveConfig.d.ts.map

package/dist/useResponsiveConfig.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useResponsiveConfig.d.ts","sourceRoot":"","sources":["../src/useResponsiveConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,MAAM,EAAE,OAAO,CAAC;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,wDAAwD;IACxD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,qCAAqC;IACrC,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,uBAAuB,CAoB1F"}

package/dist/useResponsiveConfig.js

@@ -1,41 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-import { useMemo } from 'react';
-import { useBreakpoint } from './useBreakpoint';
-import { resolveResponsiveValue } from './breakpoints';
-/**
- * Hook that consumes @objectstack/spec ResponsiveConfigSchema and
- * resolves breakpoint-aware layout state.
- *
- * @example
- * ```tsx
- * const { hidden, columns, order } = useResponsiveConfig({
- *   columns: { xs: 12, sm: 6, lg: 4 },
- *   hiddenOn: ['xs'],
- *   order: { xs: 2, lg: 1 },
- * });
- * if (hidden) return null;
- * return <div style={{ gridColumn: `span ${columns}`, order }}>...</div>;
- * ```
- */
-export function useResponsiveConfig(config) {
-    const { breakpoint } = useBreakpoint();
-    return useMemo(() => {
-        if (!config) {
-            return { hidden: false, columns: undefined, order: undefined, breakpoint };
-        }
-        const hidden = config.hiddenOn?.includes(breakpoint) ?? false;
-        const columns = config.columns
-            ? resolveResponsiveValue(config.columns, breakpoint)
-            : undefined;
-        const order = config.order
-            ? resolveResponsiveValue(config.order, breakpoint)
-            : undefined;
-        return { hidden, columns, order, breakpoint };
-    }, [config, breakpoint]);
-}