@yagejs/core 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -550,6 +550,12 @@ interface EngineEvents {
     };
     "engine:started": undefined;
     "engine:stopped": undefined;
+    "screen:fullscreen": {
+        active: boolean;
+    };
+    "screen:orientation": {
+        type: OrientationType;
+    };
 }
 /** Typed publish/subscribe event bus. */
 declare class EventBus<E = EventMap> {
@@ -840,6 +846,22 @@ declare function createRandomService(seed?: number): RandomService;
  */
 declare const globalRandom: RandomService;
 
+/**
+ * Mirrors `GamepadAxisKey` from `@yagejs/input` as a local union so the
+ * Inspector contract gets compile-time literal checking without taking a
+ * runtime dependency on the input package.
+ */
+type InspectorGamepadAxisKey = "leftX" | "leftY" | "rightX" | "rightY" | "leftTrigger" | "rightTrigger";
+/**
+ * Options for synthetic pointer injection. Pass `id` / `type` / `isPrimary`
+ * to drive a non-primary, touch, or pen pointer in deterministic tests. All
+ * fields are optional and default to a primary mouse pointer with `id: 1`.
+ */
+interface InspectorPointerOpts {
+    id?: number;
+    type?: "mouse" | "pen" | "touch";
+    isPrimary?: boolean;
+}
 /** Backward-compatible summary snapshot returned by query helpers. */
 interface EntitySnapshot {
     id: number;
@@ -955,19 +977,48 @@ interface CameraSnapshot {
     zoom: number;
     rotation: number;
 }
+/**
+ * Per-pointer entry in {@link InputStateSnapshot.pointers}. Mirrors the runtime
+ * `PointerInfo` shape from `@yagejs/input`. Touch pointers vanish from the
+ * array once their last button releases; mouse pointers persist.
+ */
+interface PointerSnapshot {
+    /** `PointerEvent.pointerId`, or the synthetic id passed via `firePointer*`. */
+    id: number;
+    x: number;
+    y: number;
+    type: "mouse" | "pen" | "touch";
+    isPrimary: boolean;
+    buttons: number[];
+    down: boolean;
+}
 interface InputStateSnapshot {
     keys: string[];
     actions: string[];
+    /**
+     * Aggregate / primary-pointer view, retained for back-compat. `x` / `y` track
+     * the primary pointer's screen position; `buttons` / `down` reflect the
+     * any-pointer aggregate that drives the `MouseLeft`/`Middle`/`Right` action codes.
+     *
+     * For multi-touch state, read {@link InputStateSnapshot.pointers}.
+     */
     mouse: {
         x: number;
         y: number;
         buttons: number[];
         down: boolean;
     };
+    /** All currently-tracked pointers (one per active mouse, pen, or finger). */
+    pointers: PointerSnapshot[];
     gamepad: {
-        buttons: number[];
+        /** Currently-held gamepad codes (e.g. `"GamepadA"`, `"GamepadLT"`). */
+        buttons: string[];
+        /**
+         * Axis state keyed by `${padIndex}:${axisName}` (axisName is a
+         * `GamepadAxisKey` from `@yagejs/input`).
+         */
         axes: Array<{
-            index: number;
+            key: string;
             value: number;
         }>;
     };
@@ -1039,8 +1090,23 @@ declare class Inspector {
         mouseMove: (x: number, y: number) => void;
         mouseDown: (button?: 0 | 1 | 2) => void;
         mouseUp: (button?: 0 | 1 | 2) => void;
-        gamepadButton: (idx: number, pressed: boolean) => void;
-        gamepadAxis: (idx: number, value: number) => void;
+        /**
+         * Inject a synthetic pointer-move with full pointer addressing. Pass `opts`
+         * with `id` / `type: "touch"` to drive a specific finger; defaults match
+         * the primary mouse pointer (same as `mouseMove`).
+         */
+        pointerMove: (x: number, y: number, opts?: InspectorPointerOpts) => void;
+        /**
+         * Inject a synthetic pointer-down. With `opts.id` and `opts.type: "touch"`
+         * this drives a multi-touch contact, exercising `getPointers()`,
+         * per-pointer event hooks, and the any-pointer aggregate for `MouseLeft`.
+         */
+        pointerDown: (button?: 0 | 1 | 2, opts?: InspectorPointerOpts) => void;
+        pointerUp: (button?: 0 | 1 | 2, opts?: {
+            id?: number;
+        }) => void;
+        gamepadButton: (code: string, pressed: boolean) => void;
+        gamepadAxis: (side: InspectorGamepadAxisKey, value: number) => void;
         tap: (code: string, frames?: number) => void;
         hold: (code: string, frames: number) => void;
         fireAction: (name: string, frames?: number) => void;
@@ -2230,6 +2296,19 @@ interface RendererAdapter {
         x: number;
         y: number;
     };
+    /**
+     * Hit-test at virtual-space coordinates and return `true` when the topmost
+     * interactive container under `(x, y)` is parented (directly or through any
+     * ancestor) to a container marked via {@link markPointerConsumeContainer}.
+     * Optional — when absent, the input plugin's UI auto-consume fallback is a
+     * no-op.
+     *
+     * Implemented by `@yagejs/renderer` over Pixi's `EventBoundary`. The input
+     * plugin calls this on `pointerdown` drains to auto-claim presses that land
+     * on UI surfaces (UIPanel backgrounds, decorative UIText, etc.) without
+     * requiring per-component handler boilerplate.
+     */
+    hitTestUI?(x: number, y: number): boolean;
 }
 /**
  * Well-known service key for the current renderer's pointer-input adapter.
@@ -2239,6 +2318,36 @@ interface RendererAdapter {
  */
 declare const RendererAdapterKey: ServiceKey<RendererAdapter>;
 
+/**
+ * Cross-package WeakSet for marking display containers (Pixi `Container`s in
+ * the canonical setup) as "swallow pointer input." The `@yagejs/input`
+ * package's drain step consults this set via the renderer's optional
+ * `hitTestUI(x, y)` — when the topmost interactive container under a
+ * `pointerdown` is parented to a marked container, the pointer is auto-claimed
+ * (`consumePointer`-equivalent), so the press never propagates to gameplay
+ * action-map edges like `MouseLeft`.
+ *
+ * Lives in `@yagejs/core` so the renderer (read side) and the UI / sprite
+ * components (write side) can both reach it without circular imports.
+ *
+ * Untyped on `Container` to keep `@yagejs/core` free of any Pixi dependency.
+ * Callers pass their `Pixi.Container` instances directly; `WeakSet` accepts
+ * any object reference.
+ */
+/**
+ * Mark a display container as a UI-input surface. Idempotent. Call from a
+ * component's `onAdd` (or equivalent) after the underlying Pixi container is
+ * created.
+ */
+declare function markPointerConsumeContainer(container: object): void;
+/**
+ * Remove the mark. Call from a component's `onDestroy` for symmetry, or to
+ * implement an opt-out (`consumeInput: false`) escape hatch on UI primitives.
+ */
+declare function unmarkPointerConsumeContainer(container: object): void;
+/** Whether a container has been marked as a UI-input surface. */
+declare function isPointerConsumeContainer(container: object): boolean;
+
 /** Create a fully wired Engine for integration tests. */
 declare function createTestEngine(config?: EngineConfig): Promise<Engine>;
 /** Create a lightweight mock scene with EngineContext for unit tests. */
@@ -2257,4 +2366,4 @@ declare function advanceFrames(engine: Engine, n: number, dtMs?: number): void;
 
 declare const VERSION = "0.0.0";
 
-export { AssetHandle, type AssetLoader, AssetManager, AssetManagerKey, type Blueprint, type CameraSnapshot, Component, type ComponentClass, ComponentFixedUpdateSystem, type ComponentStateSnapshot, ComponentUpdateSystem, type EasingFunction, Engine, type EngineConfig, EngineContext, type EngineEvents, EngineKey, type EngineSnapshot, Entity, type EntityCallbacks, type EntityFilter, type EntitySnapshot, ErrorBoundary, ErrorBoundaryKey, type ErrorSnapshot, EventBus, EventBusKey, type EventLogEntry, type EventMap, EventToken, GameLoop, type GameLoopCallbacks, type GameLoopConfig, GameLoopKey, type InputStateSnapshot, Inspector, InspectorKey, type InspectorTimeController, type Interpolatable, type Keyframe, type KeyframeAnimationDef, KeyframeAnimator, type KeyframeTrackOptions, LoadingScene, type LogEntry, LogLevel, Logger, type LoggerConfig, LoggerKey, MathUtils, Phase, type PhysicsSnapshot, type Plugin, Process, ProcessComponent, type ProcessOptions, ProcessSlot, type ProcessSlotConfig, ProcessSystem, ProcessSystemKey, QueryCache, QueryCacheKey, QueryResult, RandomKey, type RandomService, type RendererAdapter, RendererAdapterKey, SERIALIZABLE_KEY, Scene, SceneHookRegistry, SceneHookRegistryKey, type SceneHooks, SceneManager, SceneManagerKey, type SceneSnapshot, type SceneTransition, type SceneTransitionContext, type SceneTransitionKind, type SceneTransitionOptions, type ScopedProcessQueue, Sequence, SerializableRegistry, ServiceKey, type ServiceKeyOptions, type ServiceScope, type SmoothDampResult, type SnapshotResolver, System, SystemScheduler, SystemSchedulerKey, type SystemSnapshot, TimerEntity, TraitToken, Transform, type TransformData, Tween, type UINodeSnapshot, type UITreeSnapshot, VERSION, Vec2, type Vec2Like, type WorldEntitySnapshot, type WorldSceneSnapshot, _resetEntityIdCounter, advanceFrames, createDefaultRandomSeed, createKeyframeTrack, createMockEntity, createMockScene, createRandomService, createTestEngine, defineBlueprint, defineEvent, defineTrait, easeInOutQuad, easeInQuad, easeLinear, easeOutBounce, easeOutQuad, filterEntities, getSerializableType, globalRandom, interpolate, isSerializable, makeEntityScopedQueue, makeGlobalScopedQueue, makeSceneScopedQueue, normalizeSeed, resolveTransition, serializable, trait };
+export { AssetHandle, type AssetLoader, AssetManager, AssetManagerKey, type Blueprint, type CameraSnapshot, Component, type ComponentClass, ComponentFixedUpdateSystem, type ComponentStateSnapshot, ComponentUpdateSystem, type EasingFunction, Engine, type EngineConfig, EngineContext, type EngineEvents, EngineKey, type EngineSnapshot, Entity, type EntityCallbacks, type EntityFilter, type EntitySnapshot, ErrorBoundary, ErrorBoundaryKey, type ErrorSnapshot, EventBus, EventBusKey, type EventLogEntry, type EventMap, EventToken, GameLoop, type GameLoopCallbacks, type GameLoopConfig, GameLoopKey, type InputStateSnapshot, Inspector, InspectorKey, type InspectorTimeController, type Interpolatable, type Keyframe, type KeyframeAnimationDef, KeyframeAnimator, type KeyframeTrackOptions, LoadingScene, type LogEntry, LogLevel, Logger, type LoggerConfig, LoggerKey, MathUtils, Phase, type PhysicsSnapshot, type Plugin, type PointerSnapshot, Process, ProcessComponent, type ProcessOptions, ProcessSlot, type ProcessSlotConfig, ProcessSystem, ProcessSystemKey, QueryCache, QueryCacheKey, QueryResult, RandomKey, type RandomService, type RendererAdapter, RendererAdapterKey, SERIALIZABLE_KEY, Scene, SceneHookRegistry, SceneHookRegistryKey, type SceneHooks, SceneManager, SceneManagerKey, type SceneSnapshot, type SceneTransition, type SceneTransitionContext, type SceneTransitionKind, type SceneTransitionOptions, type ScopedProcessQueue, Sequence, SerializableRegistry, ServiceKey, type ServiceKeyOptions, type ServiceScope, type SmoothDampResult, type SnapshotResolver, System, SystemScheduler, SystemSchedulerKey, type SystemSnapshot, TimerEntity, TraitToken, Transform, type TransformData, Tween, type UINodeSnapshot, type UITreeSnapshot, VERSION, Vec2, type Vec2Like, type WorldEntitySnapshot, type WorldSceneSnapshot, _resetEntityIdCounter, advanceFrames, createDefaultRandomSeed, createKeyframeTrack, createMockEntity, createMockScene, createRandomService, createTestEngine, defineBlueprint, defineEvent, defineTrait, easeInOutQuad, easeInQuad, easeLinear, easeOutBounce, easeOutQuad, filterEntities, getSerializableType, globalRandom, interpolate, isPointerConsumeContainer, isSerializable, makeEntityScopedQueue, makeGlobalScopedQueue, makeSceneScopedQueue, markPointerConsumeContainer, normalizeSeed, resolveTransition, serializable, trait, unmarkPointerConsumeContainer };

package/dist/index.d.ts

@@ -550,6 +550,12 @@ interface EngineEvents {
     };
     "engine:started": undefined;
     "engine:stopped": undefined;
+    "screen:fullscreen": {
+        active: boolean;
+    };
+    "screen:orientation": {
+        type: OrientationType;
+    };
 }
 /** Typed publish/subscribe event bus. */
 declare class EventBus<E = EventMap> {
@@ -840,6 +846,22 @@ declare function createRandomService(seed?: number): RandomService;
  */
 declare const globalRandom: RandomService;
 
+/**
+ * Mirrors `GamepadAxisKey` from `@yagejs/input` as a local union so the
+ * Inspector contract gets compile-time literal checking without taking a
+ * runtime dependency on the input package.
+ */
+type InspectorGamepadAxisKey = "leftX" | "leftY" | "rightX" | "rightY" | "leftTrigger" | "rightTrigger";
+/**
+ * Options for synthetic pointer injection. Pass `id` / `type` / `isPrimary`
+ * to drive a non-primary, touch, or pen pointer in deterministic tests. All
+ * fields are optional and default to a primary mouse pointer with `id: 1`.
+ */
+interface InspectorPointerOpts {
+    id?: number;
+    type?: "mouse" | "pen" | "touch";
+    isPrimary?: boolean;
+}
 /** Backward-compatible summary snapshot returned by query helpers. */
 interface EntitySnapshot {
     id: number;
@@ -955,19 +977,48 @@ interface CameraSnapshot {
     zoom: number;
     rotation: number;
 }
+/**
+ * Per-pointer entry in {@link InputStateSnapshot.pointers}. Mirrors the runtime
+ * `PointerInfo` shape from `@yagejs/input`. Touch pointers vanish from the
+ * array once their last button releases; mouse pointers persist.
+ */
+interface PointerSnapshot {
+    /** `PointerEvent.pointerId`, or the synthetic id passed via `firePointer*`. */
+    id: number;
+    x: number;
+    y: number;
+    type: "mouse" | "pen" | "touch";
+    isPrimary: boolean;
+    buttons: number[];
+    down: boolean;
+}
 interface InputStateSnapshot {
     keys: string[];
     actions: string[];
+    /**
+     * Aggregate / primary-pointer view, retained for back-compat. `x` / `y` track
+     * the primary pointer's screen position; `buttons` / `down` reflect the
+     * any-pointer aggregate that drives the `MouseLeft`/`Middle`/`Right` action codes.
+     *
+     * For multi-touch state, read {@link InputStateSnapshot.pointers}.
+     */
     mouse: {
         x: number;
         y: number;
         buttons: number[];
         down: boolean;
     };
+    /** All currently-tracked pointers (one per active mouse, pen, or finger). */
+    pointers: PointerSnapshot[];
     gamepad: {
-        buttons: number[];
+        /** Currently-held gamepad codes (e.g. `"GamepadA"`, `"GamepadLT"`). */
+        buttons: string[];
+        /**
+         * Axis state keyed by `${padIndex}:${axisName}` (axisName is a
+         * `GamepadAxisKey` from `@yagejs/input`).
+         */
         axes: Array<{
-            index: number;
+            key: string;
             value: number;
         }>;
     };
@@ -1039,8 +1090,23 @@ declare class Inspector {
         mouseMove: (x: number, y: number) => void;
         mouseDown: (button?: 0 | 1 | 2) => void;
         mouseUp: (button?: 0 | 1 | 2) => void;
-        gamepadButton: (idx: number, pressed: boolean) => void;
-        gamepadAxis: (idx: number, value: number) => void;
+        /**
+         * Inject a synthetic pointer-move with full pointer addressing. Pass `opts`
+         * with `id` / `type: "touch"` to drive a specific finger; defaults match
+         * the primary mouse pointer (same as `mouseMove`).
+         */
+        pointerMove: (x: number, y: number, opts?: InspectorPointerOpts) => void;
+        /**
+         * Inject a synthetic pointer-down. With `opts.id` and `opts.type: "touch"`
+         * this drives a multi-touch contact, exercising `getPointers()`,
+         * per-pointer event hooks, and the any-pointer aggregate for `MouseLeft`.
+         */
+        pointerDown: (button?: 0 | 1 | 2, opts?: InspectorPointerOpts) => void;
+        pointerUp: (button?: 0 | 1 | 2, opts?: {
+            id?: number;
+        }) => void;
+        gamepadButton: (code: string, pressed: boolean) => void;
+        gamepadAxis: (side: InspectorGamepadAxisKey, value: number) => void;
         tap: (code: string, frames?: number) => void;
         hold: (code: string, frames: number) => void;
         fireAction: (name: string, frames?: number) => void;
@@ -2230,6 +2296,19 @@ interface RendererAdapter {
         x: number;
         y: number;
     };
+    /**
+     * Hit-test at virtual-space coordinates and return `true` when the topmost
+     * interactive container under `(x, y)` is parented (directly or through any
+     * ancestor) to a container marked via {@link markPointerConsumeContainer}.
+     * Optional — when absent, the input plugin's UI auto-consume fallback is a
+     * no-op.
+     *
+     * Implemented by `@yagejs/renderer` over Pixi's `EventBoundary`. The input
+     * plugin calls this on `pointerdown` drains to auto-claim presses that land
+     * on UI surfaces (UIPanel backgrounds, decorative UIText, etc.) without
+     * requiring per-component handler boilerplate.
+     */
+    hitTestUI?(x: number, y: number): boolean;
 }
 /**
  * Well-known service key for the current renderer's pointer-input adapter.
@@ -2239,6 +2318,36 @@ interface RendererAdapter {
  */
 declare const RendererAdapterKey: ServiceKey<RendererAdapter>;
 
+/**
+ * Cross-package WeakSet for marking display containers (Pixi `Container`s in
+ * the canonical setup) as "swallow pointer input." The `@yagejs/input`
+ * package's drain step consults this set via the renderer's optional
+ * `hitTestUI(x, y)` — when the topmost interactive container under a
+ * `pointerdown` is parented to a marked container, the pointer is auto-claimed
+ * (`consumePointer`-equivalent), so the press never propagates to gameplay
+ * action-map edges like `MouseLeft`.
+ *
+ * Lives in `@yagejs/core` so the renderer (read side) and the UI / sprite
+ * components (write side) can both reach it without circular imports.
+ *
+ * Untyped on `Container` to keep `@yagejs/core` free of any Pixi dependency.
+ * Callers pass their `Pixi.Container` instances directly; `WeakSet` accepts
+ * any object reference.
+ */
+/**
+ * Mark a display container as a UI-input surface. Idempotent. Call from a
+ * component's `onAdd` (or equivalent) after the underlying Pixi container is
+ * created.
+ */
+declare function markPointerConsumeContainer(container: object): void;
+/**
+ * Remove the mark. Call from a component's `onDestroy` for symmetry, or to
+ * implement an opt-out (`consumeInput: false`) escape hatch on UI primitives.
+ */
+declare function unmarkPointerConsumeContainer(container: object): void;
+/** Whether a container has been marked as a UI-input surface. */
+declare function isPointerConsumeContainer(container: object): boolean;
+
 /** Create a fully wired Engine for integration tests. */
 declare function createTestEngine(config?: EngineConfig): Promise<Engine>;
 /** Create a lightweight mock scene with EngineContext for unit tests. */
@@ -2257,4 +2366,4 @@ declare function advanceFrames(engine: Engine, n: number, dtMs?: number): void;
 
 declare const VERSION = "0.0.0";
 
-export { AssetHandle, type AssetLoader, AssetManager, AssetManagerKey, type Blueprint, type CameraSnapshot, Component, type ComponentClass, ComponentFixedUpdateSystem, type ComponentStateSnapshot, ComponentUpdateSystem, type EasingFunction, Engine, type EngineConfig, EngineContext, type EngineEvents, EngineKey, type EngineSnapshot, Entity, type EntityCallbacks, type EntityFilter, type EntitySnapshot, ErrorBoundary, ErrorBoundaryKey, type ErrorSnapshot, EventBus, EventBusKey, type EventLogEntry, type EventMap, EventToken, GameLoop, type GameLoopCallbacks, type GameLoopConfig, GameLoopKey, type InputStateSnapshot, Inspector, InspectorKey, type InspectorTimeController, type Interpolatable, type Keyframe, type KeyframeAnimationDef, KeyframeAnimator, type KeyframeTrackOptions, LoadingScene, type LogEntry, LogLevel, Logger, type LoggerConfig, LoggerKey, MathUtils, Phase, type PhysicsSnapshot, type Plugin, Process, ProcessComponent, type ProcessOptions, ProcessSlot, type ProcessSlotConfig, ProcessSystem, ProcessSystemKey, QueryCache, QueryCacheKey, QueryResult, RandomKey, type RandomService, type RendererAdapter, RendererAdapterKey, SERIALIZABLE_KEY, Scene, SceneHookRegistry, SceneHookRegistryKey, type SceneHooks, SceneManager, SceneManagerKey, type SceneSnapshot, type SceneTransition, type SceneTransitionContext, type SceneTransitionKind, type SceneTransitionOptions, type ScopedProcessQueue, Sequence, SerializableRegistry, ServiceKey, type ServiceKeyOptions, type ServiceScope, type SmoothDampResult, type SnapshotResolver, System, SystemScheduler, SystemSchedulerKey, type SystemSnapshot, TimerEntity, TraitToken, Transform, type TransformData, Tween, type UINodeSnapshot, type UITreeSnapshot, VERSION, Vec2, type Vec2Like, type WorldEntitySnapshot, type WorldSceneSnapshot, _resetEntityIdCounter, advanceFrames, createDefaultRandomSeed, createKeyframeTrack, createMockEntity, createMockScene, createRandomService, createTestEngine, defineBlueprint, defineEvent, defineTrait, easeInOutQuad, easeInQuad, easeLinear, easeOutBounce, easeOutQuad, filterEntities, getSerializableType, globalRandom, interpolate, isSerializable, makeEntityScopedQueue, makeGlobalScopedQueue, makeSceneScopedQueue, normalizeSeed, resolveTransition, serializable, trait };
+export { AssetHandle, type AssetLoader, AssetManager, AssetManagerKey, type Blueprint, type CameraSnapshot, Component, type ComponentClass, ComponentFixedUpdateSystem, type ComponentStateSnapshot, ComponentUpdateSystem, type EasingFunction, Engine, type EngineConfig, EngineContext, type EngineEvents, EngineKey, type EngineSnapshot, Entity, type EntityCallbacks, type EntityFilter, type EntitySnapshot, ErrorBoundary, ErrorBoundaryKey, type ErrorSnapshot, EventBus, EventBusKey, type EventLogEntry, type EventMap, EventToken, GameLoop, type GameLoopCallbacks, type GameLoopConfig, GameLoopKey, type InputStateSnapshot, Inspector, InspectorKey, type InspectorTimeController, type Interpolatable, type Keyframe, type KeyframeAnimationDef, KeyframeAnimator, type KeyframeTrackOptions, LoadingScene, type LogEntry, LogLevel, Logger, type LoggerConfig, LoggerKey, MathUtils, Phase, type PhysicsSnapshot, type Plugin, type PointerSnapshot, Process, ProcessComponent, type ProcessOptions, ProcessSlot, type ProcessSlotConfig, ProcessSystem, ProcessSystemKey, QueryCache, QueryCacheKey, QueryResult, RandomKey, type RandomService, type RendererAdapter, RendererAdapterKey, SERIALIZABLE_KEY, Scene, SceneHookRegistry, SceneHookRegistryKey, type SceneHooks, SceneManager, SceneManagerKey, type SceneSnapshot, type SceneTransition, type SceneTransitionContext, type SceneTransitionKind, type SceneTransitionOptions, type ScopedProcessQueue, Sequence, SerializableRegistry, ServiceKey, type ServiceKeyOptions, type ServiceScope, type SmoothDampResult, type SnapshotResolver, System, SystemScheduler, SystemSchedulerKey, type SystemSnapshot, TimerEntity, TraitToken, Transform, type TransformData, Tween, type UINodeSnapshot, type UITreeSnapshot, VERSION, Vec2, type Vec2Like, type WorldEntitySnapshot, type WorldSceneSnapshot, _resetEntityIdCounter, advanceFrames, createDefaultRandomSeed, createKeyframeTrack, createMockEntity, createMockScene, createRandomService, createTestEngine, defineBlueprint, defineEvent, defineTrait, easeInOutQuad, easeInQuad, easeLinear, easeOutBounce, easeOutQuad, filterEntities, getSerializableType, globalRandom, interpolate, isPointerConsumeContainer, isSerializable, makeEntityScopedQueue, makeGlobalScopedQueue, makeSceneScopedQueue, markPointerConsumeContainer, normalizeSeed, resolveTransition, serializable, trait, unmarkPointerConsumeContainer };

package/dist/index.js

@@ -1803,11 +1803,30 @@ var Inspector = class {
     mouseUp: /* @__PURE__ */ __name((button = 0) => {
       this.requireInputManager().firePointerUp(button);
     }, "mouseUp"),
-    gamepadButton: /* @__PURE__ */ __name((idx, pressed) => {
-      this.requireInputManager().fireGamepadButton(idx, pressed);
+    /**
+     * Inject a synthetic pointer-move with full pointer addressing. Pass `opts`
+     * with `id` / `type: "touch"` to drive a specific finger; defaults match
+     * the primary mouse pointer (same as `mouseMove`).
+     */
+    pointerMove: /* @__PURE__ */ __name((x, y, opts) => {
+      this.requireInputManager().firePointerMove(x, y, opts);
+    }, "pointerMove"),
+    /**
+     * Inject a synthetic pointer-down. With `opts.id` and `opts.type: "touch"`
+     * this drives a multi-touch contact, exercising `getPointers()`,
+     * per-pointer event hooks, and the any-pointer aggregate for `MouseLeft`.
+     */
+    pointerDown: /* @__PURE__ */ __name((button = 0, opts) => {
+      this.requireInputManager().firePointerDown(button, opts);
+    }, "pointerDown"),
+    pointerUp: /* @__PURE__ */ __name((button = 0, opts) => {
+      this.requireInputManager().firePointerUp(button, opts);
+    }, "pointerUp"),
+    gamepadButton: /* @__PURE__ */ __name((code, pressed) => {
+      this.requireInputManager().fireGamepadButton(code, pressed);
     }, "gamepadButton"),
-    gamepadAxis: /* @__PURE__ */ __name((idx, value) => {
-      this.requireInputManager().fireGamepadAxis(idx, value);
+    gamepadAxis: /* @__PURE__ */ __name((side, value) => {
+      this.requireInputManager().fireGamepadAxis(side, value);
     }, "gamepadAxis"),
     tap: /* @__PURE__ */ __name((code, frames = 1) => {
       this.assertNonNegativeInteger(frames, "Inspector.input.tap(frames)");
@@ -2366,6 +2385,7 @@ var Inspector = class {
       keys: [],
       actions: [],
       mouse: { x: 0, y: 0, buttons: [], down: false },
+      pointers: [],
       gamepad: { buttons: [], axes: [] }
     };
   }
@@ -4389,6 +4409,21 @@ var RendererAdapterKey = new ServiceKey(
   "rendererAdapter"
 );
 
+// src/ui-consume-registry.ts
+var registry2 = /* @__PURE__ */ new WeakSet();
+function markPointerConsumeContainer(container) {
+  registry2.add(container);
+}
+__name(markPointerConsumeContainer, "markPointerConsumeContainer");
+function unmarkPointerConsumeContainer(container) {
+  registry2.delete(container);
+}
+__name(unmarkPointerConsumeContainer, "unmarkPointerConsumeContainer");
+function isPointerConsumeContainer(container) {
+  return registry2.has(container);
+}
+__name(isPointerConsumeContainer, "isPointerConsumeContainer");
+
 // src/test-utils.ts
 var _TestScene = class extends Scene {
   static {
@@ -4513,13 +4548,16 @@ export {
   getSerializableType,
   globalRandom,
   interpolate,
+  isPointerConsumeContainer,
   isSerializable,
   makeEntityScopedQueue,
   makeGlobalScopedQueue,
   makeSceneScopedQueue,
+  markPointerConsumeContainer,
   normalizeSeed,
   resolveTransition,
   serializable,
-  trait
+  trait,
+  unmarkPointerConsumeContainer
 };
 //# sourceMappingURL=index.js.map