@opsydyn/effect-three 0.0.0-stage → 0.1.0

package/dist/kernel/build.d.ts

@@ -0,0 +1,564 @@
+/**
+ * Constructors that fill in defaults and return fully specified descriptions.
+ *
+ * @module
+ */
+import type { AmbientLightNode, Animation, BasicMaterial, Body, Behave, BorrowedNode, Axis, BoxGeometry, Camera, ContactShadows, Environment, Gestures, GridNode, Sky, Xr, LabelAlign, LabelAnchorX, LabelAnchorY, LabelColorRange, LabelNode, MaterialSide, ShaderGridNode, TextAlign, TextBevel, TextGeometry, Overlay, Physics, BodyRef, Joint, JointKind, JointLimits, JointMotor, InteractionGroups, ColliderDescription, CapsuleGeometry, CircleGeometry, ConeGeometry, CylinderGeometry, DirectionalLightNode, HemisphereLightNode, Instance, InstancesNode, LambertMaterial, Easing, GeometryRef, GroupNode, MaterialRef, MeshNode, NormalMaterial, ShadowMaterial, OrthographicCamera, PhongMaterial, PhysicalMaterial, PerspectiveCamera, PlaneGeometry, PointLightNode, PostEffect, RenderSettings, RenderTexture, RingGeometry, ResourceDefinitions, Rgb, Rotation, SceneDescription, SceneNode, SphereGeometry, SpotLightNode, TorusGeometry, StandardMaterial, Transition, Vec3, View, ViewRect, XrAnchor, XrGlide, XrSpace, Handedness, HandJoint } from './description.ts';
+/** Model-owned Euler angles in radians. */
+export declare const fixed: (euler: Vec3) => Rotation;
+/** A spin behaviour: `phase + radiansPerSecond * elapsedSeconds` about `axis`. */
+export declare const spin: (options: {
+    readonly axis: Axis;
+    readonly radiansPerSecond: number;
+    readonly phase?: number;
+}) => Rotation;
+/** Box geometry. Each dimension defaults to 1. */
+export declare const box: (size?: {
+    readonly width?: number;
+    readonly height?: number;
+    readonly depth?: number;
+}) => BoxGeometry;
+/** Sphere geometry. Defaults (as three.js): radius 1, 32 × 16 segments. */
+export declare const sphere: (options?: {
+    readonly radius?: number;
+    readonly widthSegments?: number;
+    readonly heightSegments?: number;
+}) => SphereGeometry;
+/** Plane geometry in the XY plane, facing +Z. Each dimension defaults to 1. */
+export declare const plane: (size?: {
+    readonly width?: number;
+    readonly height?: number;
+}) => PlaneGeometry;
+/** Cylinder geometry along Y. Defaults (as three.js): radius 1 top and bottom, height 1, 32 segments. */
+export declare const cylinder: (options?: {
+    readonly radiusTop?: number;
+    readonly radiusBottom?: number;
+    readonly height?: number;
+    readonly radialSegments?: number;
+}) => CylinderGeometry;
+/** Torus geometry. Defaults (as three.js): radius 1, tube 0.4, 12 × 48 segments. */
+export declare const torus: (options?: {
+    readonly radius?: number;
+    readonly tube?: number;
+    readonly radialSegments?: number;
+    readonly tubularSegments?: number;
+}) => TorusGeometry;
+/** Cone geometry along Y. Defaults (as three.js): radius 1, height 1, 32 segments. */
+export declare const cone: (options?: {
+    readonly radius?: number;
+    readonly height?: number;
+    readonly radialSegments?: number;
+}) => ConeGeometry;
+/** Capsule geometry along Y. Defaults (as three.js): radius 1, height 1, 4 cap and 8 radial segments. */
+export declare const capsule: (options?: {
+    readonly radius?: number;
+    readonly height?: number;
+    readonly capSegments?: number;
+    readonly radialSegments?: number;
+}) => CapsuleGeometry;
+/** Ring geometry facing +Z. Defaults (as three.js): radii 0.5 and 1, 32 segments. */
+export declare const ring: (options?: {
+    readonly innerRadius?: number;
+    readonly outerRadius?: number;
+    readonly thetaSegments?: number;
+}) => RingGeometry;
+/** Circle geometry facing +Z. Defaults (as three.js): radius 1, 32 segments. */
+export declare const circle: (options?: {
+    readonly radius?: number;
+    readonly segments?: number;
+}) => CircleGeometry;
+/**
+ * Text from the typeface font lent under `font`. Defaults as Drei's `Text3D`: size 1,
+ * depth 0.2, 8 curve segments, no bevel (a bevel given defaults to thickness 0.1, size
+ * 0.01, offset 0, 4 segments), not centred. Depth 0 draws flat text. Letter spacing (in
+ * ems), line height (a multiple of the font's) and alignment default to the font's own
+ * layout, left aligned; unlike Drei, where three ignores them, they apply.
+ */
+export declare const text: (options: {
+    readonly text: string;
+    readonly font: string;
+    readonly size?: number;
+    readonly depth?: number;
+    readonly curveSegments?: number;
+    readonly bevel?: Partial<TextBevel>;
+    readonly center?: boolean;
+    readonly letterSpacing?: number;
+    readonly lineHeight?: number;
+    readonly align?: TextAlign;
+}) => TextGeometry;
+/** Position and scale changes apply immediately. The default. */
+export declare const instant: () => Transition;
+/** Position and scale changes ease to their new values over `seconds` of scene time. */
+export declare const ease: (options: {
+    readonly seconds: number;
+    readonly easing?: Easing;
+}) => Transition;
+/**
+ * Unlit material. Defaults (as three.js): white, opaque, front faces.
+ */
+export declare const basic: (options?: Partial<Omit<BasicMaterial, '_tag'>>) => BasicMaterial;
+/**
+ * Matte material. Defaults (as three.js): white, no emission, smooth shading.
+ */
+export declare const lambert: (options?: Partial<Omit<LambertMaterial, '_tag'>>) => LambertMaterial;
+/**
+ * Shiny material. Defaults (as three.js): white, specular `0x111111`, shininess 30.
+ */
+export declare const phong: (options?: Partial<Omit<PhongMaterial, '_tag'>>) => PhongMaterial;
+/**
+ * Physically based material. Defaults (as three.js): white, roughness 1, metalness 0.
+ */
+export declare const standard: (options?: Partial<Omit<StandardMaterial, '_tag'>>) => StandardMaterial;
+/**
+ * Physically based material with clearcoat and transmission. Defaults (as three.js):
+ * the standard defaults, no clearcoat or transmission, index of refraction 1.5.
+ */
+export declare const physical: (options?: Partial<Omit<PhysicalMaterial, '_tag'>>) => PhysicalMaterial;
+/**
+ * Normal-coloured material, for debugging geometry. Defaults as three.js.
+ */
+export declare const normalMaterial: (options?: Partial<Omit<NormalMaterial, '_tag'>>) => NormalMaterial;
+/**
+ * A shadow catcher: shows only the shadows cast onto it (three.js's `ShadowMaterial`).
+ * Defaults as three.js: black, opacity 1. Needs `render.shadows` and `receiveShadow`.
+ */
+export declare const shadowMaterial: (options?: {
+    readonly color?: Rgb;
+    readonly opacity?: number;
+}) => ShadowMaterial;
+/**
+ * A grid of lines on the XZ plane (three.js's `GridHelper`). Defaults as three.js: 10
+ * across, 10 divisions, lines 0x888888 and centre lines 0x444444, at the origin.
+ */
+export declare const grid: (options: {
+    readonly key: string;
+    readonly position?: Vec3;
+    readonly size?: number;
+    readonly divisions?: number;
+    readonly color?: Rgb;
+    readonly centerColor?: Rgb;
+}) => GridNode;
+/**
+ * Drei's `Grid`, with its defaults: a 1 × 1 plane (pass `size`, or `infinite`), cells 0.5
+ * apart in black at thickness 0.5, sections 1 apart in `#2080ff` at thickness 1, fading
+ * over 100 units from the camera at strength 1, drawn on the back side.
+ */
+export declare const shaderGrid: (options: {
+    readonly key: string;
+    readonly position?: Vec3;
+    readonly rotation?: Vec3;
+    readonly size?: readonly [width: number, height: number];
+    readonly cellSize?: number;
+    readonly cellThickness?: number;
+    readonly cellColor?: Rgb;
+    readonly sectionSize?: number;
+    readonly sectionThickness?: number;
+    readonly sectionColor?: Rgb;
+    readonly infinite?: boolean;
+    readonly followCamera?: boolean;
+    readonly fadeDistance?: number;
+    readonly fadeStrength?: number;
+    readonly fadeFrom?: number;
+    readonly side?: MaterialSide;
+}) => ShaderGridNode;
+/** A reference to a shared geometry defined in the scene's resources. */
+export declare const sharedGeometry: (id: string) => GeometryRef;
+/** A geometry lent under `id` (`store.lendGeometry`): empty until it is lent. */
+export declare const lentGeometry: (id: string) => GeometryRef;
+/** A reference to a shared material defined in the scene's resources. */
+export declare const sharedMaterial: (id: string) => MaterialRef;
+/** Key and optional transform shared by `group` and `mesh`. */
+export type TransformOptions = {
+    readonly key: string;
+    readonly position?: Vec3;
+    readonly rotation?: Rotation;
+    readonly scale?: Vec3;
+    /** How position and scale changes are shown. Defaults to `instant()`. */
+    readonly transition?: Transition /** A registered behaviour to apply on top of the transform. */;
+    readonly behaviour?: Behave | null;
+};
+/** A group of child nodes. */
+export declare const group: (options: TransformOptions & {
+    readonly interactive?: boolean;
+    readonly children?: ReadonlyArray<SceneNode>;
+    readonly body?: Body | null;
+    readonly follow?: XrSpace | null;
+}) => GroupNode;
+/** The head (the viewer), for content that stays in view. */
+export declare const headSpace: () => XrSpace;
+/** A tracked hand's joint (`index-finger-tip`, say). */
+export declare const jointSpace: (hand: Handedness, joint: HandJoint) => XrSpace;
+/** A controller's grip (where it is held) or its pointing ray. */
+export declare const controllerSpace: (hand: Handedness, space?: 'grip' | 'ray') => XrSpace;
+/** An anchor the scene placed with `xr({ anchors })`. */
+export declare const anchorSpace: (id: string) => XrSpace;
+/** A detected plane, by the id an `XrPlanes` event gave it. */
+export declare const planeSpace: (id: string) => XrSpace;
+/** A mesh the session detected (`xr({ meshes: true })`), by its id from `XrMeshes`. */
+export declare const meshSpace: (id: string) => XrSpace;
+/** The id a detected mesh's geometry is lent under, for `xrMesh` and the adapter. */
+export declare const xrMeshGeometryId: (id: string) => string;
+/**
+ * A detected mesh's geometry (`xr({ meshes: true })`), in its own space: put it in a
+ * group following `meshSpace(id)`. Empty until the session has detected it.
+ */
+export declare const xrMesh: (id: string) => GeometryRef;
+/** An anchor at a place in the scene (Euler rotation, unturned by default). */
+export declare const xrAnchor: (options: {
+    readonly id: string;
+    readonly position: Vec3;
+    readonly rotation?: Vec3;
+}) => XrAnchor;
+/** A mesh. Not interactive unless `interactive` is true. */
+export declare const mesh: (options: TransformOptions & {
+    readonly geometry: GeometryRef;
+    readonly material: MaterialRef;
+    readonly interactive?: boolean;
+    readonly castShadow?: boolean;
+    readonly receiveShadow?: boolean;
+    readonly body?: Body | null;
+}) => MeshNode;
+/**
+ * A rigid body for a mesh. Defaults as react-three-rapier's `RigidBody` and Rapier: dynamic,
+ * a cuboid collider from the bounding box, density 1, friction 0.5, restitution 0, no
+ * damping, gravity scale 1, no CCD, not a sensor, at rest, no impulse.
+ */
+export declare const body: (options?: Partial<Body>) => Body;
+/**
+ * Collision groups, as react-three-rapier's `interactionGroups(memberships, filters)`:
+ * in `memberships` (0 to 15), interacting with `filters` (every group when omitted).
+ */
+export declare const interactionGroups: (memberships: number | ReadonlyArray<number>, filters?: number | ReadonlyArray<number>) => InteractionGroups;
+/** A box collider, `halfExtents` from its middle, as react-three-rapier's `CuboidCollider`. */
+export declare const cuboidCollider: (options: {
+    readonly halfExtents: Vec3;
+    readonly position?: Vec3;
+    readonly rotation?: Vec3;
+    readonly name?: string | null;
+}) => ColliderDescription;
+/** A ball collider, as `BallCollider`. */
+export declare const ballCollider: (options: {
+    readonly radius: number;
+    readonly position?: Vec3;
+    readonly name?: string | null;
+}) => ColliderDescription;
+type Upright = {
+    readonly halfHeight: number;
+    readonly radius: number;
+    readonly position?: Vec3;
+    readonly rotation?: Vec3;
+    /** The name collisions report this collider by. */
+    readonly name?: string | null;
+};
+/** A capsule collider along y: `halfHeight` of cylinder, capped by `radius`. */
+export declare const capsuleCollider: (options: Upright) => ColliderDescription;
+/** A cylinder collider along y. */
+export declare const cylinderCollider: (options: Upright) => ColliderDescription;
+/** A cone collider along y, its point up. */
+export declare const coneCollider: (options: Upright) => ColliderDescription;
+/** A motor turning (or sliding) at `velocity`, with `factor` how hard it holds the speed. */
+export declare const velocityMotor: (velocity: number, factor?: number) => JointMotor;
+/** A motor holding `position`, as a spring of `stiffness` damped by `damping`. */
+export declare const positionMotor: (position: number, stiffness: number, damping: number) => JointMotor;
+/**
+ * A physics world. Defaults as react-three-rapier's `Physics`: Earth gravity
+ * `[0, -9.81, 0]`, running, fixed steps of 1/60 s, interpolated; no joints.
+ */
+export declare const physics: (options?: Partial<Physics>) => Physics;
+/** A node's body (`instance` omitted), or one instance's of an instances node. */
+export declare const bodyRef: (key: string, instance?: string | null) => BodyRef;
+/**
+ * A joint between two bodies, named by node key or `bodyRef`. Anchors default to each
+ * body's origin; the bodies still collide with each other unless `contacts` is false.
+ */
+export declare const joint: (options: {
+    readonly key: string;
+    readonly a: string | BodyRef;
+    readonly b: string | BodyRef;
+    readonly anchorA?: Vec3;
+    readonly anchorB?: Vec3;
+    readonly kind: JointKind;
+    readonly contacts?: boolean;
+}) => Joint;
+/** Holds two bodies still relative to each other. Frames default to unturned. */
+export declare const fixedJoint: (options?: {
+    readonly frameA?: Vec3;
+    readonly frameB?: Vec3;
+}) => JointKind;
+/** A ball and socket at the anchors. */
+export declare const sphericalJoint: () => JointKind;
+/** A hinge about `axis` (each body's own), limited to `limits` radians and driven by `motor` if given. */
+export declare const revoluteJoint: (options: {
+    readonly axis: Vec3;
+    readonly limits?: JointLimits | null;
+    readonly motor?: JointMotor | null;
+}) => JointKind;
+/** A slider along `axis`, limited to `limits` and driven by `motor` if given. */
+export declare const prismaticJoint: (options: {
+    readonly axis: Vec3;
+    readonly limits?: JointLimits | null;
+    readonly motor?: JointMotor | null;
+}) => JointKind;
+/** Keeps the anchors at most `length` apart. */
+export declare const ropeJoint: (length: number) => JointKind;
+/** Pulls the anchors towards `restLength` apart. */
+export declare const springJoint: (options: {
+    readonly restLength: number;
+    readonly stiffness: number;
+    readonly damping: number;
+}) => JointKind;
+/**
+ * Gliding with the thumbsticks while presenting. Defaults as pmndrs/xr's
+ * `useXRControllerLocomotion`: 2 m/s, a snap turn of 45° (smooth turns at 2 rad/s).
+ */
+export declare const glide: (options?: Partial<XrGlide>) => XrGlide;
+/**
+ * Immersive presentation for a scene. Defaults: the player at the scene's origin facing
+ * −z, `local-floor` (as pmndrs/xr), the device's framebuffer scale, inputs drawn (rays
+ * and hand joints, where pmndrs/xr draws controller and hand models), no AR hit tests.
+ */
+export declare const xr: (options?: Partial<Xr>) => Xr;
+/** One instance. Defaults: at the origin, unrotated, unit scale, white. */
+export declare const instance: (options: {
+    readonly key: string;
+    readonly position?: Vec3;
+    readonly rotation?: Vec3;
+    readonly scale?: Vec3;
+    readonly color?: Rgb;
+}) => Instance;
+/** Many instances of one geometry and material, drawn together. Not interactive by default. */
+export declare const instances: (options: TransformOptions & {
+    readonly geometry: GeometryRef;
+    readonly material: MaterialRef;
+    readonly instances: ReadonlyArray<Instance>;
+    readonly interactive?: boolean;
+    readonly castShadow?: boolean;
+    readonly receiveShadow?: boolean;
+    readonly body?: Body | null;
+}) => InstancesNode;
+/** Applies a registered behaviour by name. Parameters default to the behaviour's own. */
+export declare const behave: (name: string, params?: Readonly<Record<string, number>>) => Behave;
+/** Plays an animation clip by name. Defaults: normal speed, looping. */
+export declare const play: (clip: string, options?: {
+    readonly speed?: number;
+    readonly loop?: boolean;
+}) => Animation;
+/** An object lent to the resource store under `id`. Not interactive by default. */
+export declare const borrowed: (options: TransformOptions & {
+    readonly id: string;
+    readonly interactive?: boolean;
+    readonly animation?: Animation | null;
+    readonly body?: Body | null;
+}) => BorrowedNode;
+export declare const label: (options: TransformOptions & {
+    readonly text: string;
+    readonly font?: string | null;
+    readonly fontSize?: number;
+    readonly color?: Rgb;
+    readonly fillOpacity?: number;
+    readonly anchorX?: LabelAnchorX;
+    readonly anchorY?: LabelAnchorY;
+    readonly maxWidth?: number | null;
+    readonly lineHeight?: number | null;
+    readonly letterSpacing?: number;
+    readonly textAlign?: LabelAlign;
+    readonly outlineWidth?: number;
+    readonly outlineColor?: Rgb;
+    readonly outlineOpacity?: number;
+    readonly outlineBlur?: number;
+    readonly colorRanges?: ReadonlyArray<LabelColorRange>;
+    readonly curveRadius?: number;
+    readonly material?: MaterialRef | null;
+    readonly interactive?: boolean;
+}) => LabelNode;
+/** A run of a label's characters in `color`, from character index `start`. */
+export declare const colorRange: (start: number, color: Rgb) => LabelColorRange;
+/** Ambient light. Defaults: white, intensity 1. */
+export declare const ambientLight: (options: {
+    readonly key: string;
+    readonly color?: Rgb;
+    readonly intensity?: number;
+}) => AmbientLightNode;
+/**
+ * Directional light. Defaults: white, intensity 1, shining from `[0, 1, 0]`; no shadow,
+ * or a 512² shadow map covering ±5 world units (three.js's defaults) when casting.
+ */
+export declare const directionalLight: (options: {
+    readonly key: string;
+    readonly color?: Rgb;
+    readonly intensity?: number;
+    readonly position?: Vec3;
+    readonly castShadow?: boolean;
+    readonly shadowMapSize?: number;
+    readonly shadowBias?: number;
+    readonly shadowArea?: number;
+}) => DirectionalLightNode;
+/** Point light. Defaults (as three.js): white, intensity 1, at the origin, no cut-off, decay 2. */
+export declare const pointLight: (options: {
+    readonly key: string;
+    readonly color?: Rgb;
+    readonly intensity?: number;
+    readonly position?: Vec3;
+    readonly distance?: number;
+    readonly decay?: number;
+    readonly castShadow?: boolean;
+    readonly shadowMapSize?: number;
+    readonly shadowBias?: number;
+}) => PointLightNode;
+/**
+ * Spot light. Defaults (as three.js): white, intensity 1, at `[0, 1, 0]` aimed at the
+ * origin, no cut-off, a π/3 half-angle, a hard edge and decay 2.
+ */
+export declare const spotLight: (options: {
+    readonly key: string;
+    readonly color?: Rgb;
+    readonly intensity?: number;
+    readonly position?: Vec3;
+    readonly target?: Vec3;
+    readonly distance?: number;
+    readonly angle?: number;
+    readonly penumbra?: number;
+    readonly decay?: number;
+    readonly castShadow?: boolean;
+    readonly shadowMapSize?: number;
+    readonly shadowBias?: number;
+}) => SpotLightNode;
+/** Hemisphere light. Defaults (as three.js): white sky and ground, intensity 1, from `[0, 1, 0]`. */
+export declare const hemisphereLight: (options: {
+    readonly key: string;
+    readonly color?: Rgb;
+    readonly groundColor?: Rgb;
+    readonly intensity?: number;
+    readonly position?: Vec3;
+}) => HemisphereLightNode;
+/**
+ * Perspective camera. Defaults: fov 50, near 0.1, far 100, at `[0, 0, 5]` looking at the
+ * origin, no damping, not turning.
+ */
+export declare const perspectiveCamera: (options?: Partial<Omit<PerspectiveCamera, '_tag'>>) => PerspectiveCamera;
+/**
+ * Orthographic camera. Defaults (as React Three Fiber): zoom 1 (one CSS pixel per world
+ * unit, so set it), near 0.1, far 1000, at `[0, 0, 5]` looking at the origin.
+ */
+export declare const orthographicCamera: (options?: Partial<Omit<OrthographicCamera, '_tag'>>) => OrthographicCamera;
+/**
+ * Bloom: bright areas glow. Defaults: strength 1 (as three.js), radius 0.4 and threshold
+ * 0.85, so only the brightest areas bloom (three.js leaves these two unset).
+ */
+export declare const bloom: (options?: {
+    readonly strength?: number;
+    readonly radius?: number;
+    readonly threshold?: number;
+}) => PostEffect;
+/** Vignette: darker edges. Defaults (as three.js's `VignetteShader`): offset 1, darkness 1. */
+export declare const vignette: (options?: {
+    readonly offset?: number;
+    readonly darkness?: number;
+}) => PostEffect;
+/** Film grain. Defaults (as three.js's `FilmPass`): intensity 0.5, in colour. */
+export declare const film: (options?: {
+    readonly intensity?: number;
+    readonly grayscale?: boolean;
+}) => PostEffect;
+/**
+ * Render settings. Defaults: frames on demand, full resolution, shadows off, no tone
+ * mapping, exposure 1, sRGB output. Two deliberate differences from React Three Fiber:
+ *
+ * - Frames default to `demand`, not `always`. Every visual change passes through the
+ *   kernel, which knows when a frame is needed, so nothing has to call `invalidate` and
+ *   idle scenes stop drawing.
+ * - Tone mapping defaults to `none`, not ACES, so a validated palette renders as given.
+ */
+export declare const renderSettings: (options?: Partial<RenderSettings>) => RenderSettings;
+/** A view of the scene through `camera` into `rect` of the canvas (default: all of it). */
+export declare const view: (options: {
+    readonly key: string;
+    readonly camera: Camera;
+    readonly rect?: Partial<ViewRect>;
+}) => View;
+/**
+ * A scene rendered into a texture, lent under `id` for materials' `map`. Defaults:
+ * 512 × 512, the default camera, transparent.
+ */
+export declare const renderTexture: (options: {
+    readonly id: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly camera?: Camera;
+    readonly background?: Rgb | null;
+    readonly children?: ReadonlyArray<SceneNode>;
+}) => RenderTexture;
+/** A scene description. */
+/**
+ * Image-based lighting (Drei's `Environment`). Defaults as Drei: lighting only, no blur,
+ * intensities 1. Without `map`, three.js's `RoomEnvironment`; with it, the equirectangular
+ * texture lent under that id.
+ */
+export declare const environment: (options?: {
+    readonly map?: string;
+    readonly background?: boolean | 'only';
+    readonly backgroundBlurriness?: number;
+    readonly backgroundIntensity?: number;
+    readonly environmentIntensity?: number;
+}) => Environment;
+/**
+ * Where Drei puts the sun from an inclination and azimuth, both 0 to 1
+ * (`calcPosFromAngles` in `src/core/Sky.tsx`).
+ */
+export declare const sunPositionFromAngles: (inclination: number, azimuth: number) => Vec3;
+/**
+ * A daylight sky. Defaults as Drei's `Sky`: the sun from inclination 0.6 and azimuth 0.1,
+ * turbidity 10, rayleigh 0.5, mie coefficient 0.005 and directional G 0.8, distance 1000,
+ * and no clouds. The sky is high dynamic range: use tone mapping (`aces`, as three.js's
+ * example and React Three Fiber's default), or it washes out to white.
+ */
+export declare const sky: (options?: Partial<Sky>) => Sky;
+/**
+ * Soft ground shadows (Drei's `ContactShadows`). Defaults as Drei: a 10 × 10 plane at the
+ * origin (Drei's `scale` 10), shadows from 0 to 10 units above, blur 1 with the smooth
+ * pass, opacity 1, black, 512 texels.
+ */
+export declare const contactShadows: (options?: {
+    readonly position?: Vec3;
+    readonly size?: number | readonly [number, number];
+    readonly near?: number;
+    readonly far?: number;
+    readonly blur?: number;
+    readonly smooth?: boolean;
+    readonly opacity?: number;
+    readonly color?: Rgb;
+    readonly resolution?: number;
+}) => ContactShadows;
+/**
+ * A point to show HTML at (Drei's `Html`). Defaults: world space at the origin, not
+ * centred, constant size, never occluded, Drei's z-index range, the main camera.
+ */
+export declare const overlay: (options: {
+    readonly key: string;
+    readonly node?: string;
+    readonly position?: Vec3;
+    readonly center?: boolean;
+    readonly distanceFactor?: number;
+    readonly occlude?: boolean;
+    readonly zIndexRange?: readonly [number, number];
+    readonly view?: string;
+}) => Overlay;
+export declare const scene: (options: {
+    readonly camera?: Camera;
+    readonly gestures?: Gestures;
+    readonly views?: ReadonlyArray<View>;
+    readonly renderTextures?: ReadonlyArray<RenderTexture>;
+    readonly overlays?: ReadonlyArray<Overlay>;
+    /** Optional staging: leave out or pass `null` for none, so a Model can switch it off. */
+    readonly environment?: Environment | null;
+    readonly sky?: Sky | null;
+    readonly contactShadows?: ContactShadows | null;
+    readonly physics?: Physics | null;
+    readonly xr?: Xr | null;
+    readonly measure?: ReadonlyArray<string>;
+    readonly render?: RenderSettings;
+    readonly resources?: Partial<ResourceDefinitions>;
+    readonly children?: ReadonlyArray<SceneNode>;
+}) => SceneDescription;
+export {};
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/kernel/build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,MAAM,EACN,cAAc,EACd,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,GAAG,EACH,EAAE,EACF,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,SAAS,EACT,SAAS,EACT,YAAY,EACZ,OAAO,EACP,OAAO,EACP,OAAO,EACP,KAAK,EACL,SAAS,EACT,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EAEnB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,eAAe,EACf,MAAM,EACN,WAAW,EACX,SAAS,EACT,WAAW,EACX,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,UAAU,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,GAAG,EACH,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,OAAO,EACP,UAAU,EACV,SAAS,EACV,MAAM,kBAAkB,CAAC;AAQ1B,2CAA2C;AAC3C,eAAO,MAAM,KAAK,UAAW,IAAI,KAAG,QAAsC,CAAC;AAE3E,kFAAkF;AAClF,eAAO,MAAM,IAAI,YAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,KAAG,QAKF,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,GAAG,UACR;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KACnF,WAKD,CAAC;AAEH,2EAA2E;AAC3E,eAAO,MAAM,MAAM,aACR;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,KACA,cAKD,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,KAAK,UACV;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAC1D,aAAsF,CAAC;AAE1F,yGAAyG;AACzG,eAAO,MAAM,QAAQ,aACV;IACP,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,KACA,gBAMD,CAAC;AAEH,oFAAoF;AACpF,eAAO,MAAM,KAAK,aACP;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC,KACA,aAMD,CAAC;AAEH,sFAAsF;AACtF,eAAO,MAAM,IAAI,aACN;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,KACA,YAKD,CAAC;AAEH,yGAAyG;AACzG,eAAO,MAAM,OAAO,aACT;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,KACA,eAMD,CAAC;AAEH,qFAAqF;AACrF,eAAO,MAAM,IAAI,aACN;IACP,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC,KACA,YAKD,CAAC;AAEH,gFAAgF;AAChF,eAAO,MAAM,MAAM,aACR;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAChE,cAID,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,YAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B,KAAG,YAoBF,CAAC;AAEH,iEAAiE;AACjE,eAAO,MAAM,OAAO,QAAO,UAA+B,CAAC;AAE3D,wFAAwF;AACxF,eAAO,MAAM,IAAI,YAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,KAAG,UAIF,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK,aAAa,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,KAAQ,aAQzE,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO,aAAa,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,KAAQ,eAU7E,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK,aAAa,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,KAAQ,aAYzE,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ,aACV,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,KAC/C,gBAaD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,QAAQ,aACV,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,KAC/C,gBAiBD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,aAChB,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,KAC7C,cAOD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,aAChB;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3D,cAID,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,IAAI,YAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC;CAC5B,KAAG,QAQF,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU,YAAa;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;CAC9B,KAAG,cAkBF,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,cAAc,OAAQ,MAAM,KAAG,WAA+C,CAAC;AAC5F,iFAAiF;AACjF,eAAO,MAAM,YAAY,OAAQ,MAAM,KAAG,WAA6C,CAAC;AAExF,yEAAyE;AACzE,eAAO,MAAM,cAAc,OAAQ,MAAM,KAAG,WAA+C,CAAC;AAE5F,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,+DAA+D,CAAC;IACjG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AAEF,8BAA8B;AAC9B,eAAO,MAAM,KAAK,YACP,gBAAgB,GAAG;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC,KACA,SAYD,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,SAAS,QAAO,OAA6B,CAAC;AAE3D,wDAAwD;AACxD,eAAO,MAAM,UAAU,SAAU,UAAU,SAAS,SAAS,KAAG,OAI9D,CAAC;AAEH,kEAAkE;AAClE,eAAO,MAAM,eAAe,SAAU,UAAU,UAAS,MAAM,GAAG,KAAK,KAAY,OAIjF,CAAC;AAEH,yDAAyD;AACzD,eAAO,MAAM,WAAW,OAAQ,MAAM,KAAG,OAAmC,CAAC;AAE7E,+DAA+D;AAC/D,eAAO,MAAM,UAAU,OAAQ,MAAM,KAAG,OAAkC,CAAC;AAC3E,uFAAuF;AACvF,eAAO,MAAM,SAAS,OAAQ,MAAM,KAAG,OAAiC,CAAC;AAEzE,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,OAAQ,MAAM,KAAG,MAAyB,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,MAAM,OAAQ,MAAM,KAAG,WAAiD,CAAC;AAEtF,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,YAAa;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;CAC1B,KAAG,QAIF,CAAC;AAEH,4DAA4D;AAC5D,eAAO,MAAM,IAAI,YACN,gBAAgB,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B,KACA,QAcD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,IAAI,aAAa,OAAO,CAAC,IAAI,CAAC,KAAQ,IAkBjD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,gBACf,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,YACjC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,KACvC,iBAGD,CAAC;AAYH,+FAA+F;AAC/F,eAAO,MAAM,cAAc,YAAa;IACtC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,KAAG,mBAC2E,CAAC;AAEhF,0CAA0C;AAC1C,eAAO,MAAM,YAAY,YAAa;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,KAAG,mBAAwF,CAAC;AAE7F,KAAK,OAAO,GAAG;IACb,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,eAAe,YAAa,OAAO,KAAG,mBAIhD,CAAC;AAEJ,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,YAAa,OAAO,KAAG,mBAIjD,CAAC;AAEJ,6CAA6C;AAC7C,eAAO,MAAM,YAAY,YAAa,OAAO,KAAG,mBACmD,CAAC;AAEpG,6FAA6F;AAC7F,eAAO,MAAM,aAAa,aAAc,MAAM,sBAAe,UAK3D,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,aAAa,aACd,MAAM,aACL,MAAM,WACR,MAAM,KACd,UAKD,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,OAAO,aAAa,OAAO,CAAC,OAAO,CAAC,KAAQ,OAOvD,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,OAAO,QAAS,MAAM,aAAY,MAAM,GAAG,IAAI,KAAU,OAGpE,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,KAAK,YAAa;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B,KAAG,KAQF,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,UAAU,aACZ;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAA;CAAE,KAC1D,SAID,CAAC;AAEH,wCAAwC;AACxC,eAAO,MAAM,cAAc,QAAO,SAAoC,CAAC;AAEvE,0GAA0G;AAC1G,eAAO,MAAM,aAAa,YAAa;IACrC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CACpC,KAAG,SAKF,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,cAAc,YAAa;IACtC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CACpC,KAAG,SAKF,CAAC;AAEH,gDAAgD;AAChD,eAAO,MAAM,SAAS,WAAY,MAAM,KAAG,SAAuC,CAAC;AAEnF,oDAAoD;AACpD,eAAO,MAAM,WAAW,YAAa;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,KAAG,SAA6C,CAAC;AAIlD;;;GAGG;AACH,eAAO,MAAM,KAAK,aAAa,OAAO,CAAC,OAAO,CAAC,KAAQ,OAKrD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,EAAE,aAAa,OAAO,CAAC,EAAE,CAAC,KAAQ,EAY7C,CAAC;AAEH,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,YAAa;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;CACtB,KAAG,QAMF,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,SAAS,YACX,gBAAgB,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B,KACA,aAeD,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,MAAM,SAAU,MAAM,WAAU,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAQ,MAGnF,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,IAAI,SACT,MAAM,YACH;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,KAC5D,SAA8E,CAAC;AAElF,mFAAmF;AACnF,eAAO,MAAM,QAAQ,YACV,gBAAgB,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B,KACA,YAYD,CAAC;AASH,eAAO,MAAM,KAAK,YACP,gBAAgB,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC,KACA,SA2BD,CAAC;AAEH,8EAA8E;AAC9E,eAAO,MAAM,UAAU,UAAW,MAAM,SAAS,GAAG,KAAG,eAAqC,CAAC;AAE7F,mDAAmD;AACnD,eAAO,MAAM,YAAY,YAAa;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,KAAG,gBAKF,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,YAAa;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAG,oBAUF,CAAC;AAEH,mGAAmG;AACnG,eAAO,MAAM,UAAU,YAAa;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAG,cAWF,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAG,aAcF,CAAC;AAEH,qGAAqG;AACrG,eAAO,MAAM,eAAe,YAAa;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;CAC1B,KAAG,mBAOF,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aACnB,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,KAChD,iBASD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,aACpB,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,KACjD,kBASD,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,KAAK,aACP;IACP,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,KACA,UAKD,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,QAAQ,aACV;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAChE,UAID,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,IAAI,aACN;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,KACrE,UAID,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,aAAa,OAAO,CAAC,cAAc,CAAC,KAAQ,cAQrE,CAAC;AAOH,2FAA2F;AAC3F,eAAO,MAAM,IAAI,YAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACnC,KAAG,IASF,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,aAAa,YAAa;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CAC9C,KAAG,aAOF,CAAC;AAEH,2BAA2B;AAC3B;;;;GAIG;AACH,eAAO,MAAM,WAAW,aACb;IACP,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC,KACA,WAMD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,gBAAiB,MAAM,WAAW,MAAM,KAAG,IAI5E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,GAAG,aAAa,OAAO,CAAC,GAAG,CAAC,KAAQ,GAQ/C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,aAChB;IACP,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KACA,cAaF,CAAC;AAQF;;;GAGG;AACH,eAAO,MAAM,OAAO,YAAa;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,KAAG,OASF,CAAC;AAEH,eAAO,MAAM,KAAK,YAAa;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,yFAAyF;IACzF,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CAC9C,KAAG,gBAkBF,CAAC"}

package/dist/kernel/cameraMotion.d.ts

@@ -0,0 +1,39 @@
+/**
+ * How the rendered camera reaches its description: at once, or damped round its target;
+ * and how it turns round its target by itself (`autoRotate`).
+ *
+ * Behavioural reference: three.js `examples/jsm/controls/OrbitControls.js` at 0.186.1,
+ * `update` with `enableDamping`: each update closes `dampingFactor` of the remaining
+ * rotation and pan. Here the remaining way to the described pose closes by that fraction
+ * every sixtieth of a second of scene time, so the motion is the same at any frame rate,
+ * and the camera travels round the target (azimuth the short way) rather than through it.
+ * `autoRotate` is `update` with `autoRotate`: `rotateLeft` by `2π / 60 * autoRotateSpeed`
+ * a second, only while no gesture is in progress (`state === NONE`).
+ *
+ * @module
+ */
+import { OrthographicCamera, type PerspectiveCamera } from 'three';
+import type { Camera, Vec3 } from './description.ts';
+export type CameraMotion = {
+    /**
+     * Aims at a described pose at scene time `now`. It is shown at once when `jump` is
+     * true, the camera has no damping, or nothing was shown before; otherwise `step`
+     * travels there. A new position, `lookAt` or zoom ends any turning (`autoRotate`).
+     */
+    readonly aim: (camera: PerspectiveCamera | OrthographicCamera, description: Camera, now: number, jump: boolean) => void;
+    /**
+     * Turns (`autoRotate`) and travels toward the aim up to scene time `now`. Returns
+     * whether it is still moving.
+     */
+    readonly step: (camera: PerspectiveCamera | OrthographicCamera, now: number) => boolean;
+    /** Lands on the aim at once. */
+    readonly settle: (camera: PerspectiveCamera | OrthographicCamera) => void;
+    readonly moving: () => boolean;
+    /** Stops turning while `held` (a gesture is pressed), as `OrbitControls` turns only idle. */
+    readonly hold: (held: boolean) => void;
+    /** Where turning has taken the camera, when it has turned since its description. */
+    readonly turned: () => Vec3 | undefined;
+};
+/** Creates the motion of one camera. Allocation-free once created. */
+export declare const createCameraMotion: () => CameraMotion;
+//# sourceMappingURL=cameraMotion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cameraMotion.d.ts","sourceRoot":"","sources":["../../src/kernel/cameraMotion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAsB,MAAM,OAAO,CAAC;AAEvF,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAwDrD,MAAM,MAAM,YAAY,GAAG;IACzB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,CACZ,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,EAC9C,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,KACV,IAAI,CAAC;IACV;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACxF,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,KAAK,IAAI,CAAC;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAC/B,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,SAAS,CAAC;CACzC,CAAC;AAKF,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,QAAO,YAmGrC,CAAC"}

package/dist/kernel/clock.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Scene time. Behaviours read elapsed seconds from here; pausing animation (for example
+ * under `prefers-reduced-motion`) freezes scene time while frames keep rendering, and
+ * resuming continues from the frozen value rather than jumping ahead.
+ *
+ * @module
+ */
+export type SceneClock = {
+    /** Scene seconds elapsed while animating. */
+    readonly elapsedSeconds: () => number;
+    /** Freezes (`false`) or resumes (`true`) scene time. Idempotent. */
+    readonly setAnimating: (animating: boolean) => void;
+    readonly animating: () => boolean;
+};
+/** Creates a scene clock over a monotonic source of seconds. */
+export declare const createSceneClock: (nowSeconds: () => number) => SceneClock;
+//# sourceMappingURL=clock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/kernel/clock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,cAAc,EAAE,MAAM,MAAM,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;CACnC,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,eAAgB,MAAM,MAAM,KAAG,UAiB3D,CAAC"}