@ankhorage/zora-game 0.6.2 → 0.7.1

package/dist/types/gamePresentation.d.ts

@@ -2,6 +2,23 @@ import type { GameDefinition, GameInput, GameOutput } from '@ankhorage/game';
 import type React from 'react';
 type GameOverlayCornerPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 export type GamePointerEvents = 'auto' | 'box-none' | 'box-only' | 'none';
+export type GameEntityEasing = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';
+export interface GameEntityMotionProps {
+    readonly transitionDurationMs?: number;
+    readonly transitionEasing?: GameEntityEasing;
+    readonly motionOffsetX?: number;
+    readonly motionOffsetY?: number;
+    readonly motionOpacityDelta?: number;
+    readonly motionScaleDelta?: number;
+    readonly motionRotationDelta?: number;
+    readonly motionDurationMs?: number;
+    readonly motionDelayMs?: number;
+    readonly motionEasing?: GameEntityEasing;
+    readonly motionRepeat?: boolean;
+    readonly motionAlternate?: boolean;
+    readonly motionPaused?: boolean;
+    readonly motionEssential?: boolean;
+}
 export type GameOverlayPlacement = 'fill' | 'center' | 'top' | 'bottom' | GameOverlayCornerPlacement;
 export interface GameFieldProps {
     readonly children?: React.ReactNode;
@@ -11,7 +28,7 @@ export interface GameFieldProps {
     readonly accessibilityLabel?: string;
     readonly testID?: string;
 }
-export interface GameEntityProps {
+export interface GameEntityProps extends GameEntityMotionProps {
     readonly children?: React.ReactNode;
     readonly x?: number;
     readonly y?: number;

package/dist/types/gamePresentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gamePresentation.d.ts","sourceRoot":"","sources":["../../src/types/gamePresentation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gamePresentation.d.ts","sourceRoot":"","sources":["../../src/types/gamePresentation.ts"],"names":[],"mappings":"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"}

package/dist/types/gamePresentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"gamePresentation.js","sourceRoot":"","sources":["../../src/types/gamePresentation.ts"],"names":[],"mappings":"","sourcesContent":["import type { GameDefinition, GameInput, GameOutput } from '@ankhorage/game';\nimport type React from 'react';\n\ntype GameOverlayCornerPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';\n\nexport type GamePointerEvents = 'auto' | 'box-none' | 'box-only' | 'none';\nexport type GameOverlayPlacement =\n  'fill' | 'center' | 'top' | 'bottom' | GameOverlayCornerPlacement;\n\nexport interface GameFieldProps {\n  readonly children?: React.ReactNode;\n  readonly aspectRatio?: number;\n  readonly minHeight?: number;\n  readonly clip?: boolean;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameEntityProps {\n  readonly children?: React.ReactNode;\n  readonly x?: number;\n  readonly y?: number;\n  readonly width?: number;\n  readonly height?: number;\n  readonly opacity?: number;\n  readonly scale?: number;\n  readonly rotation?: number;\n  readonly zIndex?: number;\n  readonly hidden?: boolean;\n  readonly pointerEvents?: GamePointerEvents;\n  readonly measurementId?: string;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameKeyboardBinding {\n  readonly key: string;\n  readonly eventType?: string;\n  readonly entityId?: string;\n  readonly preventDefault?: boolean;\n}\n\nexport interface GameInputZoneProps {\n  readonly eventType: string;\n  readonly entityId?: string;\n  readonly x?: number;\n  readonly y?: number;\n  readonly width?: number;\n  readonly height?: number;\n  readonly zIndex?: number;\n  readonly enabled?: boolean;\n  readonly continuous?: boolean;\n  readonly keyboardBindings?: readonly GameKeyboardBinding[];\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameMeasurementProbeProps {\n  readonly sourceId: string;\n  readonly targetId: string;\n  readonly eventType?: string;\n  readonly entityId?: string;\n  readonly delayMs?: number;\n  readonly enabled?: boolean;\n}\n\nexport interface GameOverlayProps {\n  readonly children?: React.ReactNode;\n  readonly placement?: GameOverlayPlacement;\n  readonly blocking?: boolean;\n  readonly padding?: number;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameProps extends GameFieldProps {\n  readonly definition: GameDefinition;\n  readonly input?: GameInput;\n  readonly seed?: number;\n  readonly resetKey?: string;\n  readonly autoAdvanceTime?: boolean;\n  readonly onOutput?: (output: GameOutput) => void;\n}\n"]}
+{"version":3,"file":"gamePresentation.js","sourceRoot":"","sources":["../../src/types/gamePresentation.ts"],"names":[],"mappings":"","sourcesContent":["import type { GameDefinition, GameInput, GameOutput } from '@ankhorage/game';\nimport type React from 'react';\n\ntype GameOverlayCornerPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';\n\nexport type GamePointerEvents = 'auto' | 'box-none' | 'box-only' | 'none';\nexport type GameEntityEasing = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';\n\nexport interface GameEntityMotionProps {\n  readonly transitionDurationMs?: number;\n  readonly transitionEasing?: GameEntityEasing;\n  readonly motionOffsetX?: number;\n  readonly motionOffsetY?: number;\n  readonly motionOpacityDelta?: number;\n  readonly motionScaleDelta?: number;\n  readonly motionRotationDelta?: number;\n  readonly motionDurationMs?: number;\n  readonly motionDelayMs?: number;\n  readonly motionEasing?: GameEntityEasing;\n  readonly motionRepeat?: boolean;\n  readonly motionAlternate?: boolean;\n  readonly motionPaused?: boolean;\n  readonly motionEssential?: boolean;\n}\nexport type GameOverlayPlacement =\n  'fill' | 'center' | 'top' | 'bottom' | GameOverlayCornerPlacement;\n\nexport interface GameFieldProps {\n  readonly children?: React.ReactNode;\n  readonly aspectRatio?: number;\n  readonly minHeight?: number;\n  readonly clip?: boolean;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameEntityProps extends GameEntityMotionProps {\n  readonly children?: React.ReactNode;\n  readonly x?: number;\n  readonly y?: number;\n  readonly width?: number;\n  readonly height?: number;\n  readonly opacity?: number;\n  readonly scale?: number;\n  readonly rotation?: number;\n  readonly zIndex?: number;\n  readonly hidden?: boolean;\n  readonly pointerEvents?: GamePointerEvents;\n  readonly measurementId?: string;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameKeyboardBinding {\n  readonly key: string;\n  readonly eventType?: string;\n  readonly entityId?: string;\n  readonly preventDefault?: boolean;\n}\n\nexport interface GameInputZoneProps {\n  readonly eventType: string;\n  readonly entityId?: string;\n  readonly x?: number;\n  readonly y?: number;\n  readonly width?: number;\n  readonly height?: number;\n  readonly zIndex?: number;\n  readonly enabled?: boolean;\n  readonly continuous?: boolean;\n  readonly keyboardBindings?: readonly GameKeyboardBinding[];\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameMeasurementProbeProps {\n  readonly sourceId: string;\n  readonly targetId: string;\n  readonly eventType?: string;\n  readonly entityId?: string;\n  readonly delayMs?: number;\n  readonly enabled?: boolean;\n}\n\nexport interface GameOverlayProps {\n  readonly children?: React.ReactNode;\n  readonly placement?: GameOverlayPlacement;\n  readonly blocking?: boolean;\n  readonly padding?: number;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameProps extends GameFieldProps {\n  readonly definition: GameDefinition;\n  readonly input?: GameInput;\n  readonly seed?: number;\n  readonly resetKey?: string;\n  readonly autoAdvanceTime?: boolean;\n  readonly onOutput?: (output: GameOutput) => void;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/zora-game",
-  "version": "0.6.2",
+  "version": "0.7.1",
   "type": "module",
   "description": "Generic game presentation primitives for React Native and React Native Web apps built on ZORA.",
   "homepage": "https://github.com/ankhorage/zora-game#readme",
@@ -57,7 +57,7 @@
     "node": ">=24"
   },
   "peerDependencies": {
-    "@ankhorage/zora": ">=20.0.1",
+    "@ankhorage/zora": ">=20.0.2",
     "react": "19.2.3",
     "react-native": "0.86.x"
   },
@@ -80,7 +80,7 @@
   "devDependencies": {
     "@ankhorage/devtools": "^1.15.3",
     "@ankhorage/paradox": "^0.1.26",
-    "@ankhorage/zora": "^20.0.1",
+    "@ankhorage/zora": "^20.0.2",
     "@types/bun": "^1.4.1",
     "@types/node": "^26.6.1",
     "@types/react": "^19.2.18",
@@ -94,6 +94,6 @@
   "packageManager": "bun@1.4.2",
   "dependencies": {
     "@ankhorage/game": "^0.1.1",
-    "@ankhorage/runtime": "^3.0.1"
+    "@ankhorage/runtime": "^3.0.2"
   }
 }

package/src/ZORA_PLUGIN_METADATA.test.ts

@@ -42,6 +42,23 @@ describe('ZORA game plugin metadata', () => {
     expect(gameEntity.bindings?.props?.measurementId?.value.type).toBe('string');
   });
 
+  test('exposes serializable GameEntity motion props to canonical ZORA bindings', () => {
+    const catalog = composeZoraPluginMetadata([ZORA_CORE_PLUGIN_METADATA, ZORA_PLUGIN_METADATA]);
+    const gameEntity = readComponentMeta(catalog.componentMeta.GameEntity, 'GameEntity');
+
+    expect(gameEntity.bindings?.props?.transitionDurationMs?.value.type).toBe('number');
+    expect(gameEntity.bindings?.props?.motionOffsetY?.value.type).toBe('number');
+    expect(gameEntity.bindings?.props?.motionRepeat?.value.type).toBe('boolean');
+    expect(gameEntity.props.motionEasing?.enum).toEqual([
+      'linear',
+      'ease-in',
+      'ease-out',
+      'ease-in-out',
+    ]);
+  });
+});
+
+describe('ZORA game genericity metadata', () => {
   test('keeps the generic presentation vocabulary free of product-specific concepts', () => {
     const serialized = JSON.stringify(ZORA_PLUGIN_METADATA).toLowerCase();
 

package/src/features/game-presentation/adapters/inbound/GameEntity.tsx

@@ -1,87 +1,37 @@
 import React from 'react';
-import { StyleSheet, View, type ViewStyle } from 'react-native';
+import { Animated, StyleSheet, type View, type ViewStyle } from 'react-native';
 
 import type { GameEntityProps } from '../../../../types/gamePresentation';
-import { GameRuntimeContext } from '../../composition/GameRuntimeContext';
-import { toGamePercentage } from '../../utils/toGamePercentage';
-import { measureGameEntity } from './measureGameEntity';
+import { useGameEntityAnimatedStyle } from '../../utils/useGameEntityAnimatedStyle';
+import { useGameEntityMeasurement } from '../../utils/useGameEntityMeasurement';
 
 /*** Render one generic positioned game entity without owning gameplay semantics. */
-export function GameEntity({
-  children,
-  x = 0,
-  y = 0,
-  width,
-  height,
-  opacity = 1,
-  scale = 1,
-  rotation = 0,
-  zIndex = 0,
-  hidden = false,
-  pointerEvents = 'auto',
-  measurementId,
-  accessibilityLabel,
-  testID,
-}: GameEntityProps) {
+export function GameEntity(props: GameEntityProps) {
   const elementRef = React.useRef<View | null>(null);
-  const runtime = React.useContext(GameRuntimeContext);
-  const registerMeasurement = runtime?.registerMeasurement;
-
-  React.useEffect(() => {
-    if (measurementId === undefined || registerMeasurement === undefined) return undefined;
-    return registerMeasurement(measurementId, () => measureGameEntity(elementRef.current));
-  }, [measurementId, registerMeasurement]);
+  const animatedStyle = useGameEntityAnimatedStyle(props);
+  useGameEntityMeasurement(elementRef, props.measurementId);
 
   return (
-    <View
+    <Animated.View
       ref={elementRef}
-      {...(accessibilityLabel === undefined ? {} : { accessibilityLabel })}
-      {...(testID === undefined ? {} : { testID })}
-      pointerEvents={pointerEvents}
-      style={[
-        styles.root,
-        createEntityStyle({ x, y, width, height, opacity, scale, rotation, zIndex, hidden }),
-      ]}
+      accessibilityLabel={props.accessibilityLabel}
+      testID={props.testID}
+      pointerEvents={props.pointerEvents ?? 'auto'}
+      style={[styles.root, createEntityStaticStyle(props), animatedStyle]}
     >
-      {children}
-    </View>
+      {props.children}
+    </Animated.View>
   );
 }
 
-interface GameEntityStyleInput {
-  readonly x: number;
-  readonly y: number;
-  readonly width: number | undefined;
-  readonly height: number | undefined;
-  readonly opacity: number;
-  readonly scale: number;
-  readonly rotation: number;
-  readonly zIndex: number;
-  readonly hidden: boolean;
-}
-
-/*** Convert serializable entity presentation props into a React Native view style. */
-function createEntityStyle({
-  x,
-  y,
-  width,
-  height,
-  opacity,
-  scale,
-  rotation,
-  zIndex,
-  hidden,
-}: GameEntityStyleInput): ViewStyle {
+/*** Convert non-animated GameEntity presentation props into a React Native view style. */
+function createEntityStaticStyle(props: GameEntityProps): ViewStyle {
   return {
-    display: hidden ? 'none' : 'flex',
-    left: toGamePercentage(x),
-    opacity: Math.min(1, Math.max(0, opacity)),
+    display: props.hidden === true ? 'none' : 'flex',
     position: 'absolute',
-    top: toGamePercentage(y),
-    transform: [{ scale }, { rotate: `${rotation}deg` }],
-    zIndex,
-    ...(height === undefined ? {} : { height }),
-    ...(width === undefined ? {} : { width }),
+    zIndex: props.zIndex ?? 0,
+    ...(props.height === undefined ? {} : { height: props.height }),
+    ...(props.width === undefined ? {} : { width: props.width }),
   };
 }
 

package/src/features/game-presentation/meta/gameEntityMeta.ts

@@ -23,6 +23,20 @@ export const gameEntityMeta = {
       zIndex: { value: { type: 'number' }, acceptsFallback: true },
       hidden: { value: { type: 'boolean' }, acceptsFallback: true },
       measurementId: { value: { type: 'string' }, acceptsFallback: true },
+      transitionDurationMs: { value: { type: 'number' }, acceptsFallback: true },
+      transitionEasing: { value: { type: 'string' }, acceptsFallback: true },
+      motionOffsetX: { value: { type: 'number' }, acceptsFallback: true },
+      motionOffsetY: { value: { type: 'number' }, acceptsFallback: true },
+      motionOpacityDelta: { value: { type: 'number' }, acceptsFallback: true },
+      motionScaleDelta: { value: { type: 'number' }, acceptsFallback: true },
+      motionRotationDelta: { value: { type: 'number' }, acceptsFallback: true },
+      motionDurationMs: { value: { type: 'number' }, acceptsFallback: true },
+      motionDelayMs: { value: { type: 'number' }, acceptsFallback: true },
+      motionEasing: { value: { type: 'string' }, acceptsFallback: true },
+      motionRepeat: { value: { type: 'boolean' }, acceptsFallback: true },
+      motionAlternate: { value: { type: 'boolean' }, acceptsFallback: true },
+      motionPaused: { value: { type: 'boolean' }, acceptsFallback: true },
+      motionEssential: { value: { type: 'boolean' }, acceptsFallback: true },
     },
   },
   props: {
@@ -101,6 +115,107 @@ export const gameEntityMeta = {
       label: 'Measurement id',
       authoring: { authority: 'instance' },
     },
+
+    transitionDurationMs: {
+      type: 'number',
+      category: 'Motion',
+      label: 'Transition duration (ms)',
+      default: 0,
+      authoring: { authority: 'instance' },
+    },
+    transitionEasing: {
+      type: 'enum',
+      category: 'Motion',
+      label: 'Transition easing',
+      enum: ['linear', 'ease-in', 'ease-out', 'ease-in-out'],
+      default: 'linear',
+      authoring: { authority: 'instance' },
+    },
+    motionOffsetX: {
+      type: 'number',
+      category: 'Motion',
+      label: 'Motion X offset (%)',
+      default: 0,
+      authoring: { authority: 'instance' },
+    },
+    motionOffsetY: {
+      type: 'number',
+      category: 'Motion',
+      label: 'Motion Y offset (%)',
+      default: 0,
+      authoring: { authority: 'instance' },
+    },
+    motionOpacityDelta: {
+      type: 'number',
+      category: 'Motion',
+      label: 'Motion opacity delta',
+      default: 0,
+      authoring: { authority: 'instance' },
+    },
+    motionScaleDelta: {
+      type: 'number',
+      category: 'Motion',
+      label: 'Motion scale delta',
+      default: 0,
+      authoring: { authority: 'instance' },
+    },
+    motionRotationDelta: {
+      type: 'number',
+      category: 'Motion',
+      label: 'Motion rotation delta',
+      default: 0,
+      authoring: { authority: 'instance' },
+    },
+    motionDurationMs: {
+      type: 'number',
+      category: 'Motion',
+      label: 'Motion duration (ms)',
+      default: 0,
+      authoring: { authority: 'instance' },
+    },
+    motionDelayMs: {
+      type: 'number',
+      category: 'Motion',
+      label: 'Motion delay (ms)',
+      default: 0,
+      authoring: { authority: 'instance' },
+    },
+    motionEasing: {
+      type: 'enum',
+      category: 'Motion',
+      label: 'Motion easing',
+      enum: ['linear', 'ease-in', 'ease-out', 'ease-in-out'],
+      default: 'linear',
+      authoring: { authority: 'instance' },
+    },
+    motionRepeat: {
+      type: 'boolean',
+      category: 'Motion',
+      label: 'Repeat motion',
+      default: false,
+      authoring: { authority: 'instance' },
+    },
+    motionAlternate: {
+      type: 'boolean',
+      category: 'Motion',
+      label: 'Alternate motion',
+      default: false,
+      authoring: { authority: 'instance' },
+    },
+    motionPaused: {
+      type: 'boolean',
+      category: 'Motion',
+      label: 'Pause motion',
+      default: false,
+      authoring: { authority: 'instance' },
+    },
+    motionEssential: {
+      type: 'boolean',
+      category: 'Motion',
+      label: 'Essential motion',
+      default: false,
+      authoring: { authority: 'instance' },
+    },
     accessibilityLabel: {
       type: 'string',
       category: 'Accessibility',

package/src/features/game-presentation/public.ts

@@ -1,4 +1,6 @@
 export type {
+  GameEntityEasing,
+  GameEntityMotionProps,
   GameEntityProps,
   GameFieldProps,
   GameInputZoneProps,

package/src/features/game-presentation/utils/resolveGameEntityMotionPlan.test.ts

@@ -0,0 +1,63 @@
+import { describe, expect, test } from 'bun:test';
+
+import { resolveGameEntityMotionPlan } from './resolveGameEntityMotionPlan';
+
+describe('resolveGameEntityMotionPlan configuration', () => {
+  test('preserves explicit transition and repeating alternate motion', () => {
+    expect(
+      resolveGameEntityMotionPlan(
+        {
+          transitionDurationMs: 70,
+          transitionEasing: 'ease-out',
+          motionOffsetY: 8,
+          motionDurationMs: 1200,
+          motionDelayMs: 100,
+          motionEasing: 'ease-in-out',
+          motionRepeat: true,
+          motionAlternate: true,
+        },
+        false,
+      ),
+    ).toEqual({
+      transitionDurationMs: 70,
+      transitionEasing: 'ease-out',
+      motionDurationMs: 1200,
+      motionDelayMs: 100,
+      motionEasing: 'ease-in-out',
+      motionEnabled: true,
+      motionRepeat: true,
+      motionAlternate: true,
+      motionPaused: false,
+    });
+  });
+
+  test('uses alternate only for repeating motion', () => {
+    expect(
+      resolveGameEntityMotionPlan(
+        { motionOffsetY: 5, motionDurationMs: 100, motionAlternate: true },
+        false,
+      ).motionAlternate,
+    ).toBe(false);
+  });
+});
+
+describe('resolveGameEntityMotionPlan reduced motion', () => {
+  test('disables decorative motion and transitions', () => {
+    const plan = resolveGameEntityMotionPlan(
+      { transitionDurationMs: 80, motionOffsetX: 12, motionDurationMs: 500 },
+      true,
+    );
+
+    expect(plan.transitionDurationMs).toBe(0);
+    expect(plan.motionEnabled).toBe(false);
+  });
+
+  test('keeps essential trajectories enabled', () => {
+    const plan = resolveGameEntityMotionPlan(
+      { motionOffsetY: 70, motionDurationMs: 600, motionEssential: true },
+      true,
+    );
+
+    expect(plan.motionEnabled).toBe(true);
+  });
+});

package/src/features/game-presentation/utils/resolveGameEntityMotionPlan.ts

@@ -0,0 +1,53 @@
+import type { GameEntityEasing, GameEntityMotionProps } from '../../../types/gamePresentation';
+
+export interface GameEntityMotionPlan {
+  readonly transitionDurationMs: number;
+  readonly transitionEasing: GameEntityEasing;
+  readonly motionDurationMs: number;
+  readonly motionDelayMs: number;
+  readonly motionEasing: GameEntityEasing;
+  readonly motionEnabled: boolean;
+  readonly motionRepeat: boolean;
+  readonly motionAlternate: boolean;
+  readonly motionPaused: boolean;
+}
+
+/*** Normalize serializable GameEntity motion props against the current reduced-motion preference. */
+export function resolveGameEntityMotionPlan(
+  props: GameEntityMotionProps,
+  reduceMotion: boolean,
+): GameEntityMotionPlan {
+  const essential = props.motionEssential === true;
+  const motionEnabled =
+    hasMotionOffset(props) &&
+    normalizeDuration(props.motionDurationMs) > 0 &&
+    (!reduceMotion || essential);
+
+  return {
+    transitionDurationMs: reduceMotion ? 0 : normalizeDuration(props.transitionDurationMs),
+    transitionEasing: props.transitionEasing ?? 'linear',
+    motionDurationMs: normalizeDuration(props.motionDurationMs),
+    motionDelayMs: normalizeDuration(props.motionDelayMs),
+    motionEasing: props.motionEasing ?? 'linear',
+    motionEnabled,
+    motionRepeat: props.motionRepeat === true,
+    motionAlternate: props.motionRepeat === true && props.motionAlternate === true,
+    motionPaused: props.motionPaused === true,
+  };
+}
+
+/*** Return whether any relative presentation offset requires a motion timeline. */
+function hasMotionOffset(props: GameEntityMotionProps): boolean {
+  return (
+    (props.motionOffsetX ?? 0) !== 0 ||
+    (props.motionOffsetY ?? 0) !== 0 ||
+    (props.motionOpacityDelta ?? 0) !== 0 ||
+    (props.motionScaleDelta ?? 0) !== 0 ||
+    (props.motionRotationDelta ?? 0) !== 0
+  );
+}
+
+/*** Clamp an optional duration to a finite non-negative millisecond value. */
+function normalizeDuration(value: number | undefined): number {
+  return value === undefined || !Number.isFinite(value) ? 0 : Math.max(0, value);
+}

package/src/features/game-presentation/utils/useAnimatedGameEntityValue.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+import { Animated, Easing } from 'react-native';
+
+import type { GameEntityEasing } from '../../../types/gamePresentation';
+
+/*** Animate one bound numeric GameEntity presentation value toward its latest session-driven target. */
+export function useAnimatedGameEntityValue(
+  target: number,
+  durationMs: number,
+  easing: GameEntityEasing,
+): Animated.Value {
+  const [value] = React.useState(() => new Animated.Value(target));
+
+  React.useEffect(() => {
+    value.stopAnimation();
+
+    if (durationMs === 0) {
+      value.setValue(target);
+      return undefined;
+    }
+
+    const animation = Animated.timing(value, {
+      toValue: target,
+      duration: durationMs,
+      easing: resolveGameEntityEasing(easing),
+      useNativeDriver: false,
+    });
+    animation.start();
+    return () => animation.stop();
+  }, [durationMs, easing, target, value]);
+
+  return value;
+}
+
+/*** Map serializable easing names onto React Native easing functions. */
+function resolveGameEntityEasing(easing: GameEntityEasing) {
+  if (easing === 'ease-in') return Easing.in(Easing.ease);
+  if (easing === 'ease-out') return Easing.out(Easing.ease);
+  if (easing === 'ease-in-out') return Easing.inOut(Easing.ease);
+  return Easing.linear;
+}

package/src/features/game-presentation/utils/useGameEntityAnimatedStyle.ts

@@ -0,0 +1,87 @@
+import { Animated } from 'react-native';
+
+import type { GameEntityProps } from '../../../types/gamePresentation';
+import { resolveGameEntityMotionPlan } from './resolveGameEntityMotionPlan';
+import { useAnimatedGameEntityValue } from './useAnimatedGameEntityValue';
+import { useGameEntityMotionProgress } from './useGameEntityMotionProgress';
+import { useGameReducedMotion } from './useGameReducedMotion';
+
+interface GameEntityAnimatedValues {
+  readonly x: Animated.Value;
+  readonly y: Animated.Value;
+  readonly opacity: Animated.Value;
+  readonly scale: Animated.Value;
+  readonly rotation: Animated.Value;
+  readonly progress: Animated.Value;
+}
+
+/*** Compose bound GameEntity values with optional relative presentation motion. */
+export function useGameEntityAnimatedStyle(input: GameEntityProps) {
+  const reduceMotion = useGameReducedMotion();
+  const plan = resolveGameEntityMotionPlan(input, reduceMotion);
+  const values: GameEntityAnimatedValues = {
+    x: useAnimatedGameEntityValue(input.x ?? 0, plan.transitionDurationMs, plan.transitionEasing),
+    y: useAnimatedGameEntityValue(input.y ?? 0, plan.transitionDurationMs, plan.transitionEasing),
+    opacity: useAnimatedGameEntityValue(
+      input.opacity ?? 1,
+      plan.transitionDurationMs,
+      plan.transitionEasing,
+    ),
+    scale: useAnimatedGameEntityValue(
+      input.scale ?? 1,
+      plan.transitionDurationMs,
+      plan.transitionEasing,
+    ),
+    rotation: useAnimatedGameEntityValue(
+      input.rotation ?? 0,
+      plan.transitionDurationMs,
+      plan.transitionEasing,
+    ),
+    progress: useGameEntityMotionProgress(plan),
+  };
+
+  return createGameEntityAnimatedStyle(values, input);
+}
+
+/*** Build one animated React Native style from base values and relative motion progress. */
+function createGameEntityAnimatedStyle(values: GameEntityAnimatedValues, input: GameEntityProps) {
+  const left = Animated.add(values.x, Animated.multiply(values.progress, input.motionOffsetX ?? 0));
+  const top = Animated.add(values.y, Animated.multiply(values.progress, input.motionOffsetY ?? 0));
+  const opacity = Animated.add(
+    values.opacity,
+    Animated.multiply(values.progress, input.motionOpacityDelta ?? 0),
+  );
+  const scale = Animated.add(
+    values.scale,
+    Animated.multiply(values.progress, input.motionScaleDelta ?? 0),
+  );
+  const rotation = Animated.add(
+    values.rotation,
+    Animated.multiply(values.progress, input.motionRotationDelta ?? 0),
+  );
+
+  return {
+    left: left.interpolate({
+      inputRange: [-10_000, 10_000],
+      outputRange: ['-10000%', '10000%'],
+    }),
+    top: top.interpolate({
+      inputRange: [-10_000, 10_000],
+      outputRange: ['-10000%', '10000%'],
+    }),
+    opacity: opacity.interpolate({
+      inputRange: [0, 1],
+      outputRange: [0, 1],
+      extrapolate: 'clamp',
+    }),
+    transform: [
+      { scale },
+      {
+        rotate: rotation.interpolate({
+          inputRange: [-36_000, 36_000],
+          outputRange: ['-36000deg', '36000deg'],
+        }),
+      },
+    ],
+  };
+}

package/src/features/game-presentation/utils/useGameEntityMeasurement.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { View } from 'react-native';
+
+import { measureGameEntity } from '../adapters/inbound/measureGameEntity';
+import { GameRuntimeContext } from '../composition/GameRuntimeContext';
+
+/*** Register one optional measurable GameEntity view inside its local Game scope. */
+export function useGameEntityMeasurement(
+  elementRef: React.RefObject<View | null>,
+  measurementId: string | undefined,
+): void {
+  const runtime = React.useContext(GameRuntimeContext);
+  const registerMeasurement = runtime?.registerMeasurement;
+
+  React.useEffect(() => {
+    if (measurementId === undefined || registerMeasurement === undefined) return undefined;
+    return registerMeasurement(measurementId, () => measureGameEntity(elementRef.current));
+  }, [elementRef, measurementId, registerMeasurement]);
+}