@opsydyn/effect-three 0.0.0-stage → 0.1.0

package/dist/kernel/tween.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Eased transitions of position and scale. A tween's pose is a pure function of scene
+ * time: `from + (to - from) * easing(progress)`, so frames are deterministic.
+ *
+ * @module
+ */
+import type { Object3D, Vector3Tuple } from 'three';
+import type { Easing, Vec3 } from './description.ts';
+/** Maps linear progress in [0, 1] through an easing curve. */
+export declare const easeProgress: (easing: Easing, progress: number) => number;
+/** A position and scale transition in flight. */
+export type Tween = {
+    readonly fromPosition: Vector3Tuple;
+    readonly fromScale: Vector3Tuple;
+    readonly toPosition: Vec3;
+    readonly toScale: Vec3;
+    /** Scene time the tween started, in seconds. */
+    readonly start: number;
+    readonly seconds: number;
+    readonly easing: Easing;
+};
+/** Starts a tween from the object's current pose towards the targets. */
+export declare const startTween: (object: Object3D, target: {
+    readonly position: Vec3;
+    readonly scale: Vec3;
+}, start: number, transition: {
+    readonly seconds: number;
+    readonly easing: Easing;
+}) => Tween;
+/**
+ * Writes the tween's pose at `elapsedSeconds` into the object without allocating.
+ * Returns true once the tween has finished, after writing the exact targets.
+ */
+export declare const applyTween: (object: Object3D, tween: Tween, elapsedSeconds: number) => boolean;
+//# sourceMappingURL=tween.d.ts.map

package/dist/kernel/tween.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tween.d.ts","sourceRoot":"","sources":["../../src/kernel/tween.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAIrD,8DAA8D;AAC9D,eAAO,MAAM,YAAY,WAAY,MAAM,YAAY,MAAM,KAAG,MAW/D,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,KAAK,GAAG;IAClB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,UAAU,WACb,QAAQ,UACR;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,SAClD,MAAM,cACD;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAChE,KAQD,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,UAAU,WAAY,QAAQ,SAAS,KAAK,kBAAkB,MAAM,KAAG,OAmBnF,CAAC"}

package/dist/kernel/xrInput.d.ts

@@ -0,0 +1,107 @@
+/**
+ * XR input as the scene's events: controllers and hands pointing, selecting, dragging,
+ * pushing sticks and pressing buttons, and (in AR) selecting a real surface.
+ *
+ * Behavioural reference: pmndrs/xr at `0e1acd8`. Its pointers ray-cast along each input
+ * source's target ray every frame (`packages/xr/src/pointer`), entering and leaving what
+ * they point at, capturing the object a select starts on so moving drags it, and turning
+ * select start and end into pointer down, up and click. Its controller locomotion
+ * (`controller-locomotion.ts`) reads the thumbstick each frame; here a stick reports when
+ * it is pushed past halfway in a direction and when it comes back, so a Model can snap
+ * turn and teleport by changing `xr({ origin, heading })`.
+ *
+ * @module
+ */
+import type { Vec3 } from './description.ts';
+import type { Picker, Ray, SceneEvent } from './pointer.ts';
+/** Which hand an input source is held in or is, as WebXR's `handedness`. */
+export type XrHand = 'left' | 'right' | 'none';
+/** Where a thumbstick is pushed: `forward` is away from the player. */
+export type XrStickDirection = 'center' | 'left' | 'right' | 'forward' | 'back';
+/**
+ * A controller's buttons, by the `xr-standard` gamepad mapping: the trigger, the grip
+ * (`squeeze`), a touchpad, the thumbstick pressed, and the face buttons (A and B on the
+ * right controller, X and Y on the left: `primary` and `secondary`).
+ */
+export type XrButtonName = 'trigger' | 'squeeze' | 'touchpad' | 'thumbstick' | 'primary' | 'secondary';
+/**
+ * A plane the session detected (`xr({ planes: true })`): a floor, wall or table, in the
+ * scene's space. `polygon` is its outline in its own space (on its x–z plane); `label` is
+ * what the device took it for (`floor`, `wall`, `table`…), or `''` when it did not say.
+ * Follow one with `group({ follow: planeSpace(id) })`.
+ */
+export type XrPlane = {
+    readonly id: string;
+    readonly orientation: 'horizontal' | 'vertical';
+    readonly label: string;
+    readonly position: Vec3;
+    readonly rotation: Vec3;
+    readonly polygon: ReadonlyArray<Vec3>;
+};
+/**
+ * A mesh the session detected (`xr({ meshes: true })`): furniture, a wall, the room. Its
+ * pose is in the scene's space; its geometry is lent for `xrMesh(id)` rather than sent.
+ */
+export type XrMesh = {
+    readonly id: string;
+    readonly label: string;
+    readonly position: Vec3;
+    readonly rotation: Vec3;
+};
+/** Input from an immersive session, each from an input source (`source` tells them apart). */
+export type XrInput = 
+/** A select (the trigger, or a pinch) beginning or ending, along the source's ray. */
+{
+    readonly _tag: 'SelectStart' | 'SelectEnd';
+    readonly source: number;
+    readonly ray: Ray;
+}
+/** Where the source points this frame. */
+ | {
+    readonly _tag: 'Aim';
+    readonly source: number;
+    readonly ray: Ray;
+}
+/** The source went away (put down, or the session ended). */
+ | {
+    readonly _tag: 'Lost';
+    readonly source: number;
+} | {
+    readonly _tag: 'Stick';
+    readonly source: number;
+    readonly hand: XrHand;
+    readonly direction: XrStickDirection;
+} | {
+    readonly _tag: 'Button';
+    readonly source: number;
+    readonly hand: XrHand;
+    readonly button: XrButtonName;
+    readonly pressed: boolean;
+}
+/** Gliding (`xr({ glide })`) stopped: where the player stands now, for the Model. */
+ | {
+    readonly _tag: 'Moved';
+    readonly origin: Vec3;
+    readonly heading: number;
+}
+/** The detected planes changed: all of them, as they are now. */
+ | {
+    readonly _tag: 'Planes';
+    readonly planes: ReadonlyArray<XrPlane>;
+}
+/** The detected meshes changed: all of them, as they are now. */
+ | {
+    readonly _tag: 'Meshes';
+    readonly meshes: ReadonlyArray<XrMesh>;
+}
+/** In AR, a select whose ray met a real surface: where, and the surface's normal. */
+ | {
+    readonly _tag: 'Surface';
+    readonly source: number;
+    readonly hand: XrHand;
+    readonly point: Vec3;
+    readonly normal: Vec3;
+};
+/** Creates the tracker turning one session's XR input into scene events. */
+export declare const createXrTracker: (picker: Picker) => (input: XrInput) => ReadonlyArray<SceneEvent>;
+//# sourceMappingURL=xrInput.d.ts.map

package/dist/kernel/xrInput.d.ts.map

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

package/dist/kernel/xrLocomotion.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Moving the player in an immersive session, as functions from the scene's `xr` settings
+ * to new ones: the Model keeps where the player stands, and the session follows it.
+ *
+ * Behavioural reference: pmndrs/xr at `0e1acd8`, `controller-locomotion.ts`: the right
+ * thumbstick snap-turns 45° once pushed past halfway (and must come back before turning
+ * again), and the left one moves the player along where they face. Here moving is a step
+ * per push, not a glide: sticks arrive as `XrStick` events when pushed and let back.
+ * `teleport` is `@react-three/xr`'s `TeleportTarget`: the player stands where they point.
+ *
+ * @module
+ */
+import type { Vec3, Xr } from './description.ts';
+import type { XrHand, XrStickDirection } from './xrInput.ts';
+export type LocomotionOptions = {
+    /** Degrees a snap turn turns by. Default 45, as pmndrs/xr's. */
+    readonly snapDegrees?: number;
+    /** Metres a step moves. Default 1. */
+    readonly step?: number;
+    /** The hand whose stick turns; the other moves. Default `right`, as pmndrs/xr's. */
+    readonly turnHand?: Exclude<XrHand, 'none'>;
+};
+/**
+ * The settings after a stick is pushed: the turning hand's left and right snap-turn, the
+ * other hand's stick steps forward, back, left or right. Centring changes nothing.
+ */
+export declare const locomote: (settings: Xr, stick: {
+    readonly hand: XrHand;
+    readonly direction: XrStickDirection;
+}, options?: LocomotionOptions) => Xr;
+/** The settings with the player standing at `point` (on the floor there), facing as before. */
+export declare const teleport: (settings: Xr, point: Vec3) => Xr;
+/** The settings where gliding left the player (an `XrMoved` event): its origin and heading. */
+export declare const glided: (settings: Xr, moved: {
+    readonly origin: Vec3;
+    readonly heading: number;
+}) => Xr;
+//# sourceMappingURL=xrLocomotion.d.ts.map

package/dist/kernel/xrLocomotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrLocomotion.d.ts","sourceRoot":"","sources":["../../src/kernel/xrLocomotion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,CAAC;AAWF;;;GAGG;AACH,eAAO,MAAM,QAAQ,aACT,EAAE,SACL;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;CAAE,YAC7D,iBAAiB,KACzB,EAkBF,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,QAAQ,aAAc,EAAE,SAAS,IAAI,KAAG,EAGnD,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,MAAM,aACP,EAAE,SACL;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACzD,EAAqE,CAAC"}

package/dist/runtime/FrameSource.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Where frames come from. Wraps a kernel `FrameScheduler` so a scene's per-frame callback
+ * is registered for exactly the lifetime of its scope.
+ *
+ * @module
+ */
+import { Context, Effect, Layer } from 'effect';
+import { type FrameControl, type FrameScheduler } from '../kernel/index.ts';
+/** The frame source service for `scheduler`, for providing directly with `provideService`. */
+export declare const fromScheduler: (scheduler: FrameScheduler) => {
+    /**
+     * Calls `onFrame` once per frame until the current scope closes, while awake. Returns
+     * the control that puts the subscription to sleep and wakes it.
+     */
+    subscribe: (onFrame: () => void) => Effect.Effect<FrameControl, never, import("effect/Scope").Scope>;
+};
+declare const FrameSource_base: Context.ServiceClass<FrameSource, "effect-three/FrameSource", {
+    /**
+     * Calls `onFrame` once per frame until the current scope closes, while awake. Returns
+     * the control that puts the subscription to sleep and wakes it.
+     */
+    subscribe: (onFrame: () => void) => Effect.Effect<FrameControl, never, import("effect/Scope").Scope>;
+}>;
+export declare class FrameSource extends FrameSource_base {
+}
+/** Provides a frame source backed by `scheduler`. */
+export declare const layer: (scheduler: FrameScheduler) => Layer.Layer<FrameSource, never, never>;
+export {};
+//# sourceMappingURL=FrameSource.d.ts.map

package/dist/runtime/FrameSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrameSource.d.ts","sourceRoot":"","sources":["../../src/runtime/FrameSource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAqB,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAY/F,8FAA8F;AAC9F,eAAO,MAAM,aAAa,cAAe,cAAc;IACrD;;;OAGG;IACH,SAAS,YAAY,MAAM,IAAI;CAM/B,CAAC;;IAVD;;;OAGG;yBACkB,MAAM,IAAI;;AAQjC,qBAAa,WAAY,SAAQ,gBAEhC;CAAG;AAEJ,qDAAqD;AACrD,eAAO,MAAM,KAAK,cAAe,cAAc,2CACO,CAAC"}

package/dist/runtime/ResourceRegistry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * App-level owner of shared GPU resources (ADR-005). Every scene runtime built with the
+ * same Layer shares one kernel resource store; the store is disposed when the Layer's
+ * scope closes.
+ *
+ * @module
+ */
+import { Context, Layer } from 'effect';
+import { type ResourceStore } from '../kernel/index.ts';
+declare const ResourceRegistry_base: Context.ServiceClass<ResourceRegistry, "effect-three/ResourceRegistry", {
+    readonly store: ResourceStore;
+}>;
+export declare class ResourceRegistry extends ResourceRegistry_base {
+}
+/** Provides one shared resource store for the lifetime of the Layer. */
+export declare const layer: Layer.Layer<ResourceRegistry, never, never>;
+export {};
+//# sourceMappingURL=ResourceRegistry.d.ts.map

package/dist/runtime/ResourceRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceRegistry.d.ts","sourceRoot":"","sources":["../../src/runtime/ResourceRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;;oBAIzD,aAAa;;AAFjC,qBAAa,gBAAiB,SAAQ,qBAGF;CAAG;AAQvC,wEAAwE;AACxE,eAAO,MAAM,KAAK,6CAA0E,CAAC"}

package/dist/runtime/SceneRuntime.d.ts

@@ -0,0 +1,68 @@
+/**
+ * A running scene: a kernel scene graph, a renderer and a frame subscription, all owned
+ * by the caller's `Scope`. Closing the scope stops the frame loop, then releases the
+ * event queue, the renderer and every resource the scene acquired, in that order.
+ *
+ * @module
+ */
+import { Effect, Scope, Stream } from 'effect';
+import { type Behaviour, type Op, type OverlayPlacement, type LabelEngine, type PhysicsEngine, type RendererFactory, type SceneDescription, type SceneEvent, type SceneGraph, type Viewport } from '../kernel/index.ts';
+import { InvalidScene, RendererUnavailable } from './errors.ts';
+import { FrameSource } from './FrameSource.ts';
+import { ResourceRegistry } from './ResourceRegistry.ts';
+export type SceneRuntimeOptions = {
+    readonly scene: SceneDescription;
+    readonly renderer: RendererFactory;
+    readonly viewport: Viewport;
+    /** Events kept when the consumer falls behind; older events are dropped. Default 64. */
+    readonly eventCapacity?: number;
+    /** Behaviours nodes may name, beside the built-in ones. */
+    readonly behaviours?: Readonly<Record<string, Behaviour>>;
+    /** The physics engine for meshes with a `body`; without one, bodies stay put. */
+    readonly physics?: PhysicsEngine | undefined;
+    /** Draws `label` nodes (distance-field text); without one, labels are empty. */
+    readonly labels?: LabelEngine | undefined;
+    /** Receives where the overlays are after each drawn frame, to move their HTML there. */
+    readonly placeOverlays?: (placements: ReadonlyArray<OverlayPlacement>) => void;
+};
+/**
+ * Starts a scene in the current scope. Fails with `InvalidScene` if the initial
+ * description is rejected and `RendererUnavailable` if the renderer can't be created.
+ * A failed or interrupted start releases everything it acquired before returning.
+ */
+export declare const make: (options: SceneRuntimeOptions) => Effect.Effect<{
+    /** The hosted scene graph, for inspection. */
+    graph: SceneGraph;
+    /** The operations that built the initial scene. */
+    startupOps: readonly Op[];
+    /**
+     * Applies a new description and returns the operations it took. Structurally equal
+     * descriptions return no operations and cost no host changes.
+     */
+    update: (scene: SceneDescription) => Effect.Effect<readonly Op[], InvalidScene, never>;
+    /** Resizes the camera aspect and the renderer's drawing surface. */
+    resize: (viewport: Viewport) => Effect.Effect<void, never, never>;
+    /** Freezes (`false`) or resumes (`true`) behaviours; frozen, transitions land at once. */
+    setAnimating: (animating: boolean) => Effect.Effect<void, never, never>;
+    /**
+     * Draws one frame now, whatever the frame mode: React Three Fiber's `advance`, for
+     * `frames: 'never'` scenes and frame-exact capture.
+     */
+    advance: Effect.Effect<void, never, never>;
+    /**
+     * Draws one frame now, synchronously, for a host's own frame source to call directly:
+     * an immersive (WebXR) session's animation loop.
+     */
+    drawNow: () => void;
+    /** Routes pointer input. Synchronous, so DOM listeners can call it directly. */
+    pointer: (input: import("../index.ts").PointerInput) => ReadonlyArray<SceneEvent>;
+    /** Routes XR input: aims, selects, sticks, buttons and surfaces. Synchronous, as `pointer`. */
+    xrInput: (input: import("../index.ts").XrInput) => ReadonlyArray<SceneEvent>;
+    /** Scene events, newest kept when the consumer falls behind. */
+    events: Stream.Stream<SceneEvent, never, never>;
+    /** Removes and returns every pending event without waiting. */
+    drainEvents: Effect.Effect<SceneEvent[], never, never>;
+}, InvalidScene | RendererUnavailable, FrameSource | ResourceRegistry | Scope.Scope>;
+/** The handle `make` returns. */
+export type SceneHandle = Effect.Success<ReturnType<typeof make>>;
+//# sourceMappingURL=SceneRuntime.d.ts.map

package/dist/runtime/SceneRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneRuntime.d.ts","sourceRoot":"","sources":["../../src/runtime/SceneRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAS,MAAM,EAAsC,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE1F,OAAO,EAGL,KAAK,SAAS,EAGd,KAAK,EAAE,EACP,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,aAAa,EAElB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEf,KAAK,UAAU,EAEf,KAAK,QAAQ,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,wFAAwF;IACxF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1D,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,wFAAwF;IACxF,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;CAChF,CAAC;AA2KF;;;;GAIG;AACH,eAAO,MAAM,IAAI,YAAa,mBAAmB;IArD7C,8CAA8C;;IAE9C,mDAAmD;;IAEnD;;;OAGG;oBACa,gBAAgB;IAEhC,oEAAoE;uBACjD,QAAQ;IAC3B,0FAA0F;8BAChE,OAAO;IAEjC;;;OAGG;;IAEH;;;OAGG;;IAEH,gFAAgF;;IAEhF,+FAA+F;;IAE/F,gEAAgE;;IAEhE,+DAA+D;;oFAyBlE,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC"}