@opsydyn/effect-three 0.3.0 → 0.6.4

package/dist/kernel/sceneChanges.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Scene diffs for review (roadmap, "Beyond parity" 4): what changed between two
+ * descriptions, in the kernel's own terms (the operations `diff` would apply, plus the
+ * scene-wide settings the graph applies beside them), as typed changes and as lines a
+ * person reads in review. `formatChanges` writes one line per change:
+ *
+ * ```text
+ * + Mesh crate in table
+ * - Light sun
+ * ~ crate: position, rotation
+ * > crate to shelf
+ * = order of the root: table, crate
+ * ⋯ scene: camera, environment
+ * ```
+ *
+ * Changes inside the HUD and render textures are listed after them, each line prefixed
+ * with where it is (`hud`, `texture screen`).
+ *
+ * @module
+ */
+import type { SceneDescription, SceneNode } from './description.ts';
+import { type Field } from './diff.ts';
+import { type DescriptionError, type ParentKey } from './sceneIndex.ts';
+/** A scene-wide part of a description, which changes as a whole. */
+export type SceneSetting = 'camera' | 'views' | 'render' | 'resources' | 'gestures' | 'overlays' | 'environment' | 'sky' | 'contactShadows' | 'physics' | 'xr' | 'measure';
+/** Where a change is: the scene, its HUD, or one of its render textures. */
+export type ChangePlace = 'scene' | 'hud' | {
+    readonly texture: string;
+};
+export type SceneChange = {
+    readonly place: ChangePlace;
+} & ({
+    readonly _tag: 'Added';
+    readonly key: string;
+    readonly kind: SceneNode['_tag'];
+    readonly parent: ParentKey;
+} | {
+    readonly _tag: 'Removed';
+    readonly key: string;
+} | {
+    readonly _tag: 'Replaced';
+    readonly key: string;
+    readonly kind: SceneNode['_tag'];
+} | {
+    readonly _tag: 'Changed';
+    readonly key: string;
+    readonly fields: ReadonlyArray<Field>;
+} | {
+    readonly _tag: 'Moved';
+    readonly key: string;
+    readonly parent: ParentKey;
+} | {
+    readonly _tag: 'Reordered';
+    readonly parent: ParentKey;
+    readonly keys: ReadonlyArray<string>;
+} | {
+    readonly _tag: 'Settings';
+    readonly settings: ReadonlyArray<SceneSetting>;
+} | {
+    readonly _tag: 'HudAdded';
+} | {
+    readonly _tag: 'HudRemoved';
+} | {
+    readonly _tag: 'TextureAdded';
+    readonly id: string;
+} | {
+    readonly _tag: 'TextureRemoved';
+    readonly id: string;
+});
+export type SceneChanges = {
+    readonly _tag: 'Changes';
+    readonly changes: ReadonlyArray<SceneChange>;
+}
+/** The second description is not a valid scene: why, as `reconcile` would say. */
+ | {
+    readonly _tag: 'Invalid';
+    readonly error: DescriptionError;
+};
+/**
+ * What changed from `before` to `after`: the scene's settings and nodes, then its HUD's
+ * and its render textures'. Invalid when `after` is not a valid scene; a `before` that
+ * is not is compared as though it were empty.
+ */
+export declare const sceneChanges: (before: SceneDescription, after: SceneDescription) => SceneChanges;
+/** The changes as lines for review, one per change; `No changes.` when there are none. */
+export declare const formatChanges: (changes: ReadonlyArray<SceneChange>) => string;
+//# sourceMappingURL=sceneChanges.d.ts.map

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

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

package/dist/kernel/sceneGraph.d.ts

@@ -7,7 +7,7 @@
  * @module
  */
 import { type BufferGeometry, Mesh, type Object3D, OrthographicCamera, PerspectiveCamera, Scene } from 'three';
-import { type BodyCollision, type BodyContactForce } from './bodies.ts';
+import { type BodyCollision, type BodyContactForce, type PhysicsReached } from './bodies.ts';
 import type { RenderSettings, SceneDescription, ContactShadows, Environment, Gestures, Overlay, Xr, XrSpace, Vec3 } from './description.ts';
 import { type Op } from './diff.ts';
 import type { LabelEngine, LabelLayout } from './labels.ts';
@@ -20,6 +20,10 @@ import { type DescriptionError } from './sceneIndex.ts';
 /** The mesh type the kernel hosts. */
 export type HostMesh = Mesh<BufferGeometry, HostMaterial>;
 /** A render texture as hosted: its id, size and the nested graph that draws it. */
+/** The HUD as hosted: its nested graph, drawn over the scene by the frame loop. */
+export type HostedHud = {
+    readonly graph: SceneGraph;
+};
 export type HostedTexture = {
     readonly id: string;
     readonly graph: SceneGraph;
@@ -76,6 +80,8 @@ export type SceneGraph = {
     readonly turned: (view: string | undefined) => Vec3 | undefined;
     /** Render textures, each a nested graph to draw into its texture (by the frame loop). */
     readonly renderTextures: () => ReadonlyArray<HostedTexture>;
+    /** The HUD, a nested graph drawn over the scene (by the frame loop), if there is one. */
+    readonly hud: () => HostedHud | undefined;
     /** Whether the scene claims the pointer's gestures from the page. */
     readonly gestures: () => Gestures;
     /** Points to show HTML at; the frame loop places them after drawing. */
@@ -88,6 +94,8 @@ export type SceneGraph = {
     readonly collisions: () => ReadonlyArray<BodyCollision>;
     /** Contact forces over their bodies' thresholds since the last call. */
     readonly contactForces: () => ReadonlyArray<BodyContactForce>;
+    /** Steps a world on `physics({ until })` has reached since the last call. */
+    readonly physicsReached: () => ReadonlyArray<PhysicsReached>;
     /** How the scene is presented immersively, for the host; `null` if it never is. */
     readonly xr: () => Xr | null;
     /** Keys of the nodes whose bounds the frame loop reports. */

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

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

package/dist/kernel/sceneIndex.d.ts

@@ -56,6 +56,11 @@ export type DescriptionError = {
     readonly _tag: 'UnknownMeasuredNode';
     readonly key: string;
 }
+/** Two assets the scene asks for share an id. */
+ | {
+    readonly _tag: 'DuplicateAssetId';
+    readonly id: string;
+}
 /** Two joints share a key. */
  | {
     readonly _tag: 'DuplicateJointKey';

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

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

package/dist/kernel/seeded.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A small seeded random generator (mulberry32): the same numbers for the same seed on
+ * every page load, so randomly scattered scene parts are reproducible.
+ *
+ * @module
+ */
+/** A generator of numbers in [0, 1) from `seed`, as `Math.random` would give them. */
+export declare const seededRandom: (seed: number) => (() => number);
+//# sourceMappingURL=seeded.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seeded.d.ts","sourceRoot":"","sources":["../../src/kernel/seeded.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sFAAsF;AACtF,eAAO,MAAM,YAAY,SAAU,MAAM,KAAG,CAAC,MAAM,MAAM,CASxD,CAAC"}

package/dist/kernel/shots.d.ts

@@ -0,0 +1,26 @@
+import type { Camera, Environment, SceneNode, Sky } from './description.ts';
+import { type Box } from './orbit.ts';
+/** Where the camera looks from, round the subject. */
+export type ShotAngle = 'front' | 'back' | 'left' | 'right' | 'top' | 'three-quarter' | 'low';
+export declare const shotAngles: ReadonlyArray<ShotAngle>;
+/**
+ * The camera looking at `subject` from `angle`, as close as it can be with the box
+ * still inside the frame (`margin` 1.3 leaves room round it). `area` is the canvas's
+ * size, or its shape: only the ratio matters to a perspective camera.
+ */
+export declare const shotCamera: <C extends Camera>(camera: C, subject: Box, angle: ShotAngle, area?: {
+    readonly width: number;
+    readonly height: number;
+}, margin?: number) => C;
+/** A lighting mood, from the even light of a studio to a clear night. */
+export type Mood = 'studio' | 'daylight' | 'sunset' | 'night';
+export declare const moods: ReadonlyArray<Mood>;
+/** What a mood stages: lights (keyed under the prefix), image-based light and a sky. */
+export type Staging = {
+    readonly lights: ReadonlyArray<SceneNode>;
+    readonly environment: Environment | null;
+    readonly sky: Sky | null;
+};
+/** The staging for `mood`, its lights keyed `${prefix}:…`. */
+export declare const moodStaging: (mood: Mood, prefix?: string) => Staging;
+//# sourceMappingURL=shots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shots.d.ts","sourceRoot":"","sources":["../../src/kernel/shots.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,EAAQ,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,KAAK,GAAG,EAAa,MAAM,YAAY,CAAC;AAEjD,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,eAAe,GAAG,KAAK,CAAC;AAE9F,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,SAAS,CAQ/C,CAAC;AAgBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,UACjC,CAAC,WACA,GAAG,SACL,SAAS,SACV;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,sBAExD,CAWF,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9D,eAAO,MAAM,KAAK,EAAE,aAAa,CAAC,IAAI,CAA6C,CAAC;AAEpF,wFAAwF;AACxF,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,WAAW,SAAU,IAAI,sBAAoB,OAiFzD,CAAC"}

package/dist/kernel/tape.d.ts

@@ -0,0 +1,38 @@
+import type { Rgb, SceneNode, Vec3 } from './description.ts';
+export type Tape = {
+    /** The first end, once placed. */
+    readonly from: Vec3 | null;
+    /** The second end, once placed: the tape is then measured. */
+    readonly to: Vec3 | null;
+    /** Where the pointer is on the scene while the second end is being placed. */
+    readonly pointer: Vec3 | null;
+    /** Rounds each end to this step on every axis, or not when `null`. */
+    readonly snap: number | null;
+};
+/** An empty tape, snapping to `snap` when given. */
+export declare const tape: (options?: {
+    readonly snap?: number | null;
+}) => Tape;
+/** A click at `point`: the first end, the second, or (when both are placed) a new tape. */
+export declare const placeTapeEnd: (state: Tape, point: Vec3) => Tape;
+/** The pointer over the scene at `point` (or off it, `null`), for the preview. */
+export declare const pointTape: (state: Tape, point: Vec3 | null) => Tape;
+/** An empty tape, keeping its snap. */
+export declare const clearTape: (state: Tape) => Tape;
+/** The tape's length: between its ends, or to the pointer while the second is placed. */
+export declare const tapeLength: (state: Tape) => number | undefined;
+/** The middle of the tape, for a label there. */
+export declare const tapeMiddle: (state: Tape) => Vec3 | undefined;
+export type TapeLook = {
+    readonly color: Rgb;
+    /** The line's width in pixels. */
+    readonly width: number;
+    /** The end balls' radius in scene units. */
+    readonly endRadius: number;
+};
+/**
+ * The tape under `key`: a ball at each placed end and a line between them, dashed while
+ * it runs to the pointer. Nothing in it is picked, so clicks reach the scene beneath.
+ */
+export declare const tapeNodes: (key: string, state: Tape, look?: Partial<TapeLook>) => SceneNode;
+//# sourceMappingURL=tape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tape.d.ts","sourceRoot":"","sources":["../../src/kernel/tape.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,MAAM,IAAI,GAAG;IACjB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,IAAI,aAAa;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,KAAQ,IAKrE,CAAC;AAYH,2FAA2F;AAC3F,eAAO,MAAM,YAAY,UAAW,IAAI,SAAS,IAAI,KAAG,IAIvD,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,SAAS,UAAW,IAAI,SAAS,IAAI,GAAG,IAAI,KAAG,IAGjD,CAAC;AAEZ,uCAAuC;AACvC,eAAO,MAAM,SAAS,UAAW,IAAI,KAAG,IAA2C,CAAC;AAOpF,yFAAyF;AACzF,eAAO,MAAM,UAAU,UAAW,IAAI,KAAG,MAAM,GAAG,SAGjD,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,UAAU,UAAW,IAAI,KAAG,IAAI,GAAG,SAI/C,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;IACpB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAS,MAAM,SAAS,IAAI,SAAQ,OAAO,CAAC,QAAQ,CAAC,KAAQ,SAyBlF,CAAC"}

package/dist/kernel/timeline.d.ts

@@ -0,0 +1,60 @@
+/**
+ * A timeline of physics steps, as data (ADR-014): inputs stamped with the step they apply
+ * at, and how far a world on `physics({ until })` may go. Peers (or a replay) that give
+ * the same inputs at the same steps to the same world get the same world, however their
+ * frames fell, because every change lands while the world waits at its step.
+ *
+ * The Model keeps a `Timeline`, `schedule`s inputs as they are agreed (a lockstep turn's,
+ * a recording's), moves the `frontier` as far as is known, `reach`es each step the world
+ * reports (`PhysicsReached`), and applies what `due` hands back. Its scene's physics is
+ * `physics({ until: Timeline.until(timeline) })`: the next step with inputs, or the
+ * frontier. Use it as a namespace: `Timeline.make()`.
+ *
+ * @module
+ */
+/** An input, and the step it applies at. */
+export type Scheduled<I> = {
+    readonly step: number;
+    readonly input: I;
+};
+export type Timeline<I> = {
+    /** Every input, in the order they apply: by step, then as scheduled. */
+    readonly inputs: ReadonlyArray<Scheduled<I>>;
+    /** How many of `inputs` have been handed out by `due`. */
+    readonly applied: number;
+    /** The step the world last said it reached; `null` before it says any. */
+    readonly reached: number | null;
+    /** How far the world may go before more inputs could arrive. */
+    readonly frontier: number;
+};
+/** An empty timeline, the world allowed as far as `frontier`. */
+export declare const make: <I>(frontier?: number) => Timeline<I>;
+/**
+ * `input` at `step`, after any already there. The step must be one the world has not
+ * passed: not before `until`. A lockstep session stamps a turn's inputs with that turn's
+ * step, which is the frontier until the turn applies.
+ */
+export declare const schedule: <I>(timeline: Timeline<I>, step: number, input: I) => Timeline<I>;
+/** The world may now go as far as `frontier` (a timeline's frontier never goes back). */
+export declare const extend: <I>(timeline: Timeline<I>, frontier: number) => Timeline<I>;
+/** The world said it reached `step`. */
+export declare const reach: <I>(timeline: Timeline<I>, step: number) => Timeline<I>;
+/**
+ * The inputs for the step the world is at, to apply now, and the timeline without them.
+ * Applied while the world waits there, they land at that step.
+ */
+export declare const due: <I>(timeline: Timeline<I>) => {
+    readonly timeline: Timeline<I>;
+    readonly inputs: ReadonlyArray<I>;
+};
+/**
+ * Where the world should stop next: at the next step with inputs not yet applied, or at
+ * the frontier. Give it as `physics({ until })`.
+ */
+export declare const until: <I>(timeline: Timeline<I>) => number;
+/**
+ * The same inputs from the start, for a new world (a newcomer to a session, a replay):
+ * nothing applied or reached yet, the frontier where it was.
+ */
+export declare const restart: <I>(timeline: Timeline<I>) => Timeline<I>;
+//# sourceMappingURL=timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/kernel/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,4CAA4C;AAC5C,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IACxB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,IAAI,GAAI,CAAC,wBAAiB,QAAQ,CAAC,CAAC,CAK/C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,YAAY,QAAQ,CAAC,CAAC,CAAC,QAAQ,MAAM,SAAS,CAAC,KAAG,QAAQ,CAAC,CAAC,CAOrF,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,MAAM,GAAI,CAAC,YAAY,QAAQ,CAAC,CAAC,CAAC,YAAY,MAAM,KAAG,QAAQ,CAAC,CAAC,CACR,CAAC;AAEvE,wCAAwC;AACxC,eAAO,MAAM,KAAK,GAAI,CAAC,YAAY,QAAQ,CAAC,CAAC,CAAC,QAAQ,MAAM,KAAG,QAAQ,CAAC,CAAC,CACF,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,GAAG,GAAI,CAAC,YACT,QAAQ,CAAC,CAAC,CAAC,KACpB;IAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;CAUrE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAG,MACiC,CAAC;AAEnF;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAG,QAAQ,CAAC,CAAC,CAI3D,CAAC"}

package/dist/kernel/trail.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Trails, as Drei's `Trail` (`bf6f4ad`, `src/core/Trail.tsx`): a ribbon behind a moving
+ * node through the places it has been. Drei records the target once a frame into
+ * `length × 10` points, shifting in `decay` new ones each time it moves at least
+ * `stride`, every `interval` frames, and draws them with `meshline`. Here the same rules
+ * run on a clock of 60 steps a second of scene time rather than per frame, so a trail is
+ * as long at 30 frames a second as at 120; and the ribbon is a plain mesh turned to face
+ * the camera each frame, with vertex colours, so either renderer draws it. Its width is
+ * Drei's: a tenth of `width`, in scene units, `taper` and `fade` narrowing and fading it
+ * towards the tail (Drei takes an `attenuation` function).
+ *
+ * @module
+ */
+import { Mesh, Vector3 } from 'three';
+import type { Trail } from './description.ts';
+export type TrailRibbon = {
+    /** The ribbon, in the space the positions are in; never picked. */
+    readonly object: Mesh;
+    /** Records the node at `position` for every step up to scene time `now`. */
+    readonly record: (position: Vector3, now: number) => void;
+    /** Turns the ribbon to face a camera at `eye`. */
+    readonly face: (eye: Vector3) => void;
+    /** Whether every recorded point is where the node is: the trail has caught up. */
+    readonly settled: () => boolean;
+    /** Applies a new look; a new length starts the trail again at `position`. */
+    readonly restyle: (trail: Trail, position: Vector3, now: number) => void;
+    readonly dispose: () => void;
+};
+/** A ribbon of `trail.length × 10` points, all at `start`. Allocation-free once made. */
+export declare const createTrailRibbon: (first: Trail, start: Vector3, now: number) => TrailRibbon;
+//# sourceMappingURL=trail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trail.d.ts","sourceRoot":"","sources":["../../src/kernel/trail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAKL,IAAI,EAEJ,OAAO,EACR,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAK9C,MAAM,MAAM,WAAW,GAAG;IACxB,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAUF,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,UAAW,KAAK,SAAS,OAAO,OAAO,MAAM,KAAG,WAsH7E,CAAC"}

package/dist/kernel/viewportGizmo.d.ts

@@ -0,0 +1,25 @@
+import type { Camera, SceneNode } from './description.ts';
+/** An axis end: a positive or negative world axis. */
+export type ViewAxis = 'x' | 'y' | 'z' | '-x' | '-y' | '-z';
+export type ViewportGizmoOptions = {
+    /** Pixels from the middle to a head: Drei's `scale` of 40. */
+    readonly size: number;
+    /** The head under the pointer, drawn larger, as Drei's. */
+    readonly hovered: ViewAxis | null;
+    /** Leaves out the negative heads (Drei's `hideNegativeAxes`). */
+    readonly hideNegativeAxes: boolean;
+};
+/**
+ * The gizmo for `camera`, keyed under `key` (`${key}:x`, `${key}:-y` and so on), for a
+ * scene's `hud`: Drei's defaults, 40 pixels to a head, every head shown.
+ */
+export declare const viewportGizmoNodes: (key: string, camera: Camera, options?: Partial<ViewportGizmoOptions>) => SceneNode;
+/** The head a hit `key` (or any part of one) is on, if it is one of this gizmo's. */
+export declare const viewportAxisOf: (key: string, hit: string) => ViewAxis | undefined;
+/**
+ * `camera` looking from `axis` at what it looks at, as far away as it was: Drei's
+ * `tweenCamera` to that head, where it ends. Looking straight up or down, it stays a
+ * hair off the pole toward +z, as `OrbitControls` keeps its camera off them.
+ */
+export declare const cameraAlong: <C extends Camera>(camera: C, axis: ViewAxis) => C;
+//# sourceMappingURL=viewportGizmo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewportGizmo.d.ts","sourceRoot":"","sources":["../../src/kernel/viewportGizmo.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAQ,MAAM,kBAAkB,CAAC;AAEhE,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5D,MAAM,MAAM,oBAAoB,GAAG;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC,CAAC;AAwHF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QACxB,MAAM,UACH,MAAM,YACL,OAAO,CAAC,oBAAoB,CAAC,KACrC,SAeF,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,cAAc,QAAS,MAAM,OAAO,MAAM,KAAG,QAAQ,GAAG,SAIpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,UAAU,CAAC,QAAQ,QAAQ,KAAG,CAOzE,CAAC"}

package/dist/runtime/Inspector.d.ts

@@ -0,0 +1,20 @@
+/**
+ * An inspector generated from schemas (roadmap, "Beyond parity" 4): the fields of any
+ * value with a schema (a scene node, a material, a Model's own records) as an inspector
+ * shows them, and edits that are checked by the same schema, so an inspector can never
+ * put a value the schema rejects into a Model.
+ *
+ * `fields(schema, value)` lists them (numbers, text, switches, choices, colours, vectors,
+ * and read-only kinds and lists); `edit(schema, value, path, next)` puts `next` at
+ * `path` and decodes the result, failing with the schema's own account of what is
+ * wrong. Colours are fields typed `SceneSchema.Rgb`; vectors, `SceneSchema.Vec3`.
+ *
+ * @module
+ */
+import { Result, Schema } from 'effect';
+import { type FieldPath, type InspectedField } from '../kernel/inspect.ts';
+/** The fields of `value`, as `schema` describes it, in the schema's order. */
+export declare const fields: (schema: Schema.Top, value: unknown) => ReadonlyArray<InspectedField>;
+/** `value` with `next` at `path`, if `schema` accepts the result; why not, if it does not. */
+export declare const edit: <A>(schema: Schema.Decoder<A>, value: A, path: FieldPath, next: unknown) => Result.Result<A, string>;
+//# sourceMappingURL=Inspector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Inspector.d.ts","sourceRoot":"","sources":["../../src/runtime/Inspector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,cAAc,EAGpB,MAAM,sBAAsB,CAAC;AAQ9B,8EAA8E;AAC9E,eAAO,MAAM,MAAM,WAAY,MAAM,CAAC,GAAG,SAAS,OAAO,KAAG,aAAa,CAAC,cAAc,CACtC,CAAC;AAEnD,8FAA8F;AAC9F,eAAO,MAAM,IAAI,GAAI,CAAC,UACZ,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAClB,CAAC,QACF,SAAS,QACT,OAAO,KACZ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAGvB,CAAC"}