@opsydyn/effect-three-foldkit 0.4.0 → 0.6.4

package/dist/mount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAyBhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAyPpD;;;GAGG;AACH,eAAO,MAAM,cAAc,gBAAiB,WAAW;;;;;EAInD,CAAC;AAEL,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AA0BhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA+QpD;;;GAGG;AACH,eAAO,MAAM,cAAc,gBAAiB,WAAW;;;;;EAInD,CAAC;AAEL,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/view.d.ts

@@ -33,6 +33,9 @@ export type GestureEndDetail = typeof SceneSchema.GestureEndDetail.Type;
 export type CollisionDetail = typeof SceneSchema.CollisionDetail.Type;
 /** Detail of contact force events: the two bodies, and how hard they pushed. */
 export type ContactForceDetail = typeof SceneSchema.ContactForceDetail.Type;
+export type PhysicsReachedDetail = typeof SceneSchema.PhysicsReachedDetail.Type;
+export type AssetLoadedDetail = typeof SceneSchema.AssetLoadedDetail.Type;
+export type AssetFailedDetail = typeof SceneSchema.AssetFailedDetail.Type;
 /** Detail of measured events: a node's world bounding box. */
 export type MeasuredDetail = typeof SceneSchema.MeasuredDetail.Type;
 /** Detail of auto-rotated events: where a camera turning by itself got to. */
@@ -113,6 +116,12 @@ export type ViewConfig<Message> = {
      * set the threshold high.
      */
     readonly onContactForce?: (detail: ContactForceDetail) => Message;
+    /**
+     * A world on `physics({ until })` reached that step and waits there, with its run and a
+     * checksum of its bodies' poses (ADR-014): the moment to apply the inputs due at that
+     * step and move `until` on. It follows the collisions of the steps that led there.
+     */
+    readonly onPhysicsReached?: (detail: PhysicsReachedDetail) => Message;
     /**
      * A node listed in the scene's `measure` has a new world bounding box (Drei's `Bounds`
      * measuring, as a Message): fit the camera to it with `fitCamera`.
@@ -168,6 +177,13 @@ export type ViewConfig<Message> = {
     readonly onError?: (detail: {
         readonly error: SceneError;
     }) => Message;
+    /**
+     * An asset the scene asks for (`scene({ assets })`) has loaded and is lent under its id:
+     * at once, for one another scene loaded already. A model's parts and clips come with it.
+     */
+    readonly onAssetLoaded?: (detail: AssetLoadedDetail) => Message;
+    /** An asset the scene asks for could not be loaded, and why. */
+    readonly onAssetFailed?: (detail: AssetFailedDetail) => Message;
     /**
      * What each scene update did (operations by kind) and the GPU resources held afterwards.
      * Fires at startup and after every update that changed something, never for no-ops.

package/dist/view.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opsydyn/effect-three-foldkit",
-  "version": "0.4.0",
+  "version": "0.6.4",
   "description": "Thin Foldkit adapter for @opsydyn/effect-three.",
   "license": "MIT",
   "repository": {
@@ -44,17 +44,17 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.5",
-    "@effect/platform-browser": "4.0.0",
+    "@effect/platform-browser": "4.1.0",
     "@fontsource/inter": "5.3.0",
     "@microsoft/api-extractor": "7.59.4",
-    "@opsydyn/effect-three": "0.1.0",
-    "@opsydyn/effect-three-troika": "0.1.0",
+    "@opsydyn/effect-three": "0.6.3",
+    "@opsydyn/effect-three-troika": "0.6.3",
     "@opsydyn/oxlint-effect": "2.0.1",
     "@types/bun": "1.4.3",
     "@types/pngjs": "6.0.5",
     "@types/three": "0.186.0",
-    "effect": "4.0.0",
-    "foldkit": "0.167.0",
+    "effect": "4.1.0",
+    "foldkit": "0.170.0",
     "iwer": "2.5.0",
     "oxlint": "1.88.0",
     "oxlint-tsgolint": "7.0.2004",
@@ -66,9 +66,9 @@
     "typescript": "7.0.2"
   },
   "peerDependencies": {
-    "@opsydyn/effect-three": "0.4.0",
+    "@opsydyn/effect-three": "0.6.4",
     "effect": "^4.0.0",
-    "foldkit": "0.167.0",
+    "foldkit": ">=0.167.0 <0.171.0",
     "three": ">=0.186.0 <0.187.0"
   }
 }

package/src/assetRegistry.ts

@@ -0,0 +1,218 @@
+/**
+ * The assets scenes ask for with `scene({ assets })` (ADR-015), held for the environment:
+ * each loaded once however many scenes ask, lent to the store under its id, its load
+ * cancelled when no scene asks for it any more, and withdrawn and disposed when the last
+ * scene stops asking. Each scene hears whether what it asked for loaded or failed.
+ *
+ * An asset with coarser `levels` streams in: every level loads at once, each is lent as it
+ * arrives if it is finer than what is shown (replacing it), and once the finest is shown
+ * the coarser loads still under way are cancelled. Only the finest failing fails it.
+ *
+ * An id names one asset at a time: a scene asking for an id another scene holds as
+ * something else (another kind or URL) is told it failed, and gets it once the other lets
+ * go.
+ *
+ * @module
+ */
+import { type Asset, assetsEqual } from '@opsydyn/effect-three';
+
+/** An asset as loaded and lent: what a model offers, and how to withdraw and free it. */
+export type Lent = {
+  readonly parts: ReadonlyArray<string>;
+  readonly clips: ReadonlyArray<string>;
+  readonly release: () => void;
+};
+
+/** Loads one asset and lends it under its id; gives up (rejecting) when `signal` aborts. */
+export type AssetLoader = (asset: Asset, signal: AbortSignal) => Promise<Lent>;
+
+/**
+ * What a scene hears about an asset it asked for: a level of detail shown (0 for the
+ * coarsest of its levels, `levels.length` for its URL, the finest), or its finest failed.
+ */
+export type AssetNotice =
+  | ({
+      readonly _tag: 'Loaded';
+      readonly level: number;
+      readonly final: boolean;
+    } & Asset &
+      Pick<Lent, 'parts' | 'clips'>)
+  | ({ readonly _tag: 'Failed'; readonly reason: string } & Asset);
+
+/** Who asks: a mounted scene, by any object that stands for it. */
+type Holder = object;
+
+type Notify = (notice: AssetNotice) => void;
+
+type Entry = {
+  readonly asset: Asset;
+  readonly holders: Set<Holder>;
+  /** One a level, coarsest first: aborted once a finer level is shown, or the entry ends. */
+  readonly controllers: ReadonlyArray<AbortController>;
+  /** The finest level lent so far. */
+  shown: { readonly level: number; readonly lent: Lent } | undefined;
+  /** Why the finest level could not be loaded, once it could not. */
+  failure: string | undefined;
+};
+
+const sameAsset = (a: Asset, b: Asset): boolean =>
+  a.kind === b.kind &&
+  a.url === b.url &&
+  a.levels.length === b.levels.length &&
+  a.levels.every((level, i) => level === b.levels[i]);
+
+/** Every level's URL, coarsest first: the asset's own URL is the last, and finest. */
+const urlsOf = (asset: Asset): ReadonlyArray<string> => [...asset.levels, asset.url];
+
+const reasonOf = (asset: Asset, cause: unknown): string =>
+  cause instanceof Error && cause.message !== ''
+    ? `Could not load ${asset.url}: ${cause.message}`
+    : `Could not load ${asset.url}`;
+
+const taken = (asset: Asset, holding: Asset): AssetNotice => ({
+  _tag: 'Failed',
+  ...asset,
+  reason: `"${asset.id}" is already ${holding.url} for another scene`,
+});
+
+/** Creates the registry for one environment, loading with `load`. */
+export const makeAssetRegistry = (load: AssetLoader) => {
+  const entries = new Map<string, Entry>();
+  /** What each scene asks for now, and how to tell it. */
+  const asking = new Map<
+    Holder,
+    { readonly assets: ReadonlyArray<Asset>; readonly notify: Notify }
+  >();
+
+  const tellAll = (entry: Entry, notice: AssetNotice): void => {
+    for (const holder of entry.holders) asking.get(holder)?.notify(notice);
+  };
+
+  const loadedNotice = (entry: Entry, level: number, lent: Lent): AssetNotice => ({
+    _tag: 'Loaded',
+    ...entry.asset,
+    level,
+    final: level === entry.asset.levels.length,
+    parts: lent.parts,
+    clips: lent.clips,
+  });
+
+  /** What a scene that starts holding an entry hears at once: what is shown, and a failure. */
+  const noticesOf = (entry: Entry): ReadonlyArray<AssetNotice> => [
+    ...(entry.shown === undefined
+      ? []
+      : [loadedNotice(entry, entry.shown.level, entry.shown.lent)]),
+    ...(entry.failure === undefined
+      ? []
+      : [{ _tag: 'Failed' as const, ...entry.asset, reason: entry.failure }]),
+  ];
+
+  /** Starts loading every level of `asset`; what comes back too late is freed unseen. */
+  const start = (asset: Asset): Entry => {
+    const urls = urlsOf(asset);
+    const finest = urls.length - 1;
+    const entry: Entry = {
+      asset,
+      holders: new Set(),
+      controllers: urls.map(() => new AbortController()),
+      shown: undefined,
+      failure: undefined,
+    };
+    entries.set(asset.id, entry);
+    function current(level: number): boolean {
+      return entries.get(asset.id) === entry && entry.controllers[level]?.signal.aborted === false;
+    }
+    function loaded(level: number) {
+      return (lent: Lent): void => {
+        if (!current(level) || (entry.shown !== undefined && entry.shown.level >= level)) {
+          lent.release();
+          return;
+        }
+        // Lent first, then the coarser one freed: its withdrawal leaves the new loan.
+        const before = entry.shown;
+        entry.shown = { level, lent };
+        before?.lent.release();
+        if (level === finest)
+          for (const coarser of entry.controllers.slice(0, level)) coarser.abort();
+        tellAll(entry, loadedNotice(entry, level, lent));
+      };
+    }
+    function failed(level: number) {
+      return (cause: unknown): void => {
+        // A coarser level that fails is skipped; only the finest failing fails the asset.
+        if (!current(level) || level !== finest) return;
+        const reason = reasonOf({ ...asset, url: urls[level] ?? asset.url }, cause);
+        entry.failure = reason;
+        tellAll(entry, { _tag: 'Failed', ...asset, reason });
+      };
+    }
+    urls.forEach((url, level) => {
+      const signal = entry.controllers[level]?.signal ?? AbortSignal.abort();
+      load({ ...asset, url }, signal).then(loaded(level), failed(level));
+    });
+    return entry;
+  };
+
+  /** Ends an entry: its loads cancelled, and what it lent withdrawn and freed. */
+  const end = (entry: Entry): void => {
+    entries.delete(entry.asset.id);
+    for (const controller of entry.controllers) controller.abort();
+    entry.shown?.lent.release();
+  };
+
+  /** `holder` lets go of `id`; the last to let go ends it, and whoever waited on it asks again. */
+  const letGo = (holder: Holder, id: string): void => {
+    const entry = entries.get(id);
+    if (entry === undefined || !entry.holders.delete(holder) || entry.holders.size > 0) return;
+    end(entry);
+    for (const [waiting, { assets }] of asking) {
+      if (assets.some((asset) => asset.id === id)) hold(waiting, assets);
+    }
+  };
+
+  /** `holder` takes each of `assets` it does not hold yet. */
+  const hold = (holder: Holder, assets: ReadonlyArray<Asset>): void => {
+    for (const asset of assets) {
+      const entry = entries.get(asset.id) ?? start(asset);
+      if (!sameAsset(entry.asset, asset)) {
+        asking.get(holder)?.notify(taken(asset, entry.asset));
+        continue;
+      }
+      if (entry.holders.has(holder)) continue;
+      entry.holders.add(holder);
+      for (const notice of noticesOf(entry)) asking.get(holder)?.notify(notice);
+    }
+  };
+
+  /**
+   * What `holder` asks for now: loads what is new, lets go of what it no longer asks for
+   * (or asks for as something else), and tells it, through `notify`, when each asset it
+   * holds has loaded or failed (at once, for one loaded already).
+   */
+  const want = (holder: Holder, assets: ReadonlyArray<Asset>, notify: Notify): void => {
+    const before = asking.get(holder);
+    asking.set(holder, { assets, notify });
+    if (before !== undefined && assetsEqual(before.assets, assets)) return;
+    for (const old of before?.assets ?? []) {
+      const still = assets.find((asset) => asset.id === old.id);
+      if (still === undefined || !sameAsset(still, old)) letGo(holder, old.id);
+    }
+    hold(holder, assets);
+  };
+
+  /** `holder` (a scene going away) asks for nothing any more. */
+  const release = (holder: Holder): void => {
+    want(holder, [], () => undefined);
+    asking.delete(holder);
+  };
+
+  /** Ends every load and frees every asset (the environment going away). */
+  const dispose = (): void => {
+    asking.clear();
+    for (const entry of [...entries.values()]) end(entry);
+  };
+
+  return { want, release, dispose };
+};
+
+export type AssetRegistry = ReturnType<typeof makeAssetRegistry>;

package/src/assets.ts

@@ -1,16 +1,23 @@
 /**
- * Loading textures, glTF models and typeface fonts by URL, as Effects an application runs
- * from a Foldkit Command and settles into `AsyncData`. Each asset is lent to the shared
- * resource store under an id: materials use a texture with `map: id`, a `borrowed({ id })`
- * node shows a model, and `text({ font: id })` geometry draws with a font. The environment owns what it loads: loading an id again replaces and disposes
- * the earlier asset, and `unload` or the environment's `dispose` frees it.
+ * Loading textures, glTF models, HDR panoramas and typeface fonts by URL. Each asset is
+ * lent to the shared resource store under an id: materials use a texture with `map: id`,
+ * a `borrowed({ id })` node shows a model, `environment({ map: id })` a panorama, and
+ * `text({ font: id })` geometry draws with a font.
+ *
+ * Two ways in. A scene can ask for assets in its description (`scene({ assets })`), and
+ * the environment's registry loads, shares, cancels and frees them as scenes ask
+ * (`assetLoader` is what it loads with; ADR-015). Or an application loads one with an
+ * Effect from a Command and settles it into `AsyncData`; the environment owns what it
+ * loads that way, loading an id again replaces and disposes the earlier asset, and
+ * `unload` or the environment's `dispose` frees it. Use one way for any one id.
  *
  * @module
  */
-import type { ResourceStore } from '@opsydyn/effect-three';
+import type { Asset, AssetKind, ResourceStore } from '@opsydyn/effect-three';
 import { Data, Effect } from 'effect';
 import {
   EquirectangularReflectionMapping,
+  LoadingManager,
   type Object3D,
   SRGBColorSpace,
   type Texture,
@@ -20,6 +27,7 @@ import { type Font, FontLoader } from 'three/addons/loaders/FontLoader.js';
 import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
 import { HDRLoader } from 'three/addons/loaders/HDRLoader.js';
 
+import type { AssetLoader, Lent } from './assetRegistry.ts';
 import { disposeModel, namesIn } from './dom/models.ts';
 
 /** An asset could not be fetched or decoded. */
@@ -37,6 +45,78 @@ export type ModelInfo = {
   readonly clips: ReadonlyArray<string>;
 };
 
+type Gltf = { readonly scene: Object3D; readonly animations: Object3D['animations'] };
+
+const nothing: ReadonlyArray<string> = [];
+
+/** What lending an asset gives back: no parts or clips, and how to withdraw and free it. */
+const plain = (release: () => void): Lent => ({ parts: nothing, clips: nothing, release });
+
+/** Lends a colour texture (sRGB). */
+const lentTexture = (store: ResourceStore, id: string, texture: Texture): Lent => {
+  texture.colorSpace = SRGBColorSpace;
+  const withdraw = store.lendTexture(id, texture);
+  return plain(() => {
+    withdraw();
+    texture.dispose();
+  });
+};
+
+/** Lends a model's scene, keeping its clips with it so a borrowed node can play them. */
+const lentModel = (store: ResourceStore, id: string, gltf: Gltf): Lent => {
+  gltf.scene.animations = gltf.animations;
+  const withdraw = store.lend(id, gltf.scene);
+  return {
+    parts: namesIn(gltf.scene),
+    clips: gltf.animations.map((clip) => clip.name),
+    release: () => {
+      withdraw();
+      disposeModel(gltf.scene);
+    },
+  };
+};
+
+/** Lends an HDR panorama for `environment({ map })`: linear, mapped for reflection. */
+const lentEnvironment = (store: ResourceStore, id: string, texture: Texture): Lent => {
+  texture.mapping = EquirectangularReflectionMapping;
+  const withdraw = store.lendTexture(id, texture);
+  return plain(() => {
+    withdraw();
+    texture.dispose();
+  });
+};
+
+/** Lends a font; fonts hold no GPU resources, so withdrawing the loan frees them. */
+const lentFont = (store: ResourceStore, id: string, font: Font): Lent =>
+  plain(store.lendFont(id, font));
+
+type LoadAndLend = (store: ResourceStore, asset: Asset, manager: LoadingManager) => Promise<Lent>;
+
+/** How each kind of asset loads, with a loading manager of its own, and is lent. */
+const loadAndLend = {
+  model: async (store, { id, url }, manager) =>
+    lentModel(store, id, await new GLTFLoader(manager).loadAsync(url)),
+  texture: async (store, { id, url }, manager) =>
+    lentTexture(store, id, await new TextureLoader(manager).loadAsync(url)),
+  environment: async (store, { id, url }, manager) =>
+    lentEnvironment(store, id, await new HDRLoader(manager).loadAsync(url)),
+  font: async (store, { id, url }, manager) =>
+    lentFont(store, id, await new FontLoader(manager).loadAsync(url)),
+} satisfies Record<AssetKind, LoadAndLend>;
+
+/**
+ * What the environment's registry loads scenes' assets with: three's loaders, each load
+ * with a loading manager of its own, so aborting it cancels its requests (three's file
+ * and image-bitmap loaders honour the manager's abort).
+ */
+export const assetLoader =
+  (store: ResourceStore): AssetLoader =>
+  (asset, signal) => {
+    const manager = new LoadingManager();
+    signal.addEventListener('abort', () => manager.abort(), { once: true });
+    return loadAndLend[asset.kind](store, asset, manager);
+  };
+
 /** Creates the asset loader for a store. One per environment. */
 export const makeAssets = (store: ResourceStore) => {
   const releases = new Map<string, () => void>();
@@ -48,47 +128,24 @@ export const makeAssets = (store: ResourceStore) => {
   };
 
   const lendTexture = (id: string) => (texture: Texture) => {
-    texture.colorSpace = SRGBColorSpace;
-    const withdraw = store.lendTexture(id, texture);
-    own(id, () => {
-      withdraw();
-      texture.dispose();
-    });
+    own(id, lentTexture(store, id, texture).release);
     return id;
   };
 
-  const lendModel =
-    (id: string) =>
-    (gltf: { readonly scene: Object3D; readonly animations: Object3D['animations'] }) => {
-      // Keep the clips with the object, so a borrowed node can play them by name.
-      gltf.scene.animations = gltf.animations;
-      const withdraw = store.lend(id, gltf.scene);
-      own(id, () => {
-        withdraw();
-        disposeModel(gltf.scene);
-      });
-      const info: ModelInfo = {
-        id,
-        parts: namesIn(gltf.scene),
-        clips: gltf.animations.map((clip) => clip.name),
-      };
-      return info;
-    };
-
-  /** Lends an HDR panorama for `environment({ map })`: linear, mapped for reflection. */
+  const lendModel = (id: string) => (gltf: Gltf) => {
+    const lent = lentModel(store, id, gltf);
+    own(id, lent.release);
+    const info: ModelInfo = { id, parts: lent.parts, clips: lent.clips };
+    return info;
+  };
+
   const lendEnvironment = (id: string) => (texture: Texture) => {
-    texture.mapping = EquirectangularReflectionMapping;
-    const withdraw = store.lendTexture(id, texture);
-    own(id, () => {
-      withdraw();
-      texture.dispose();
-    });
+    own(id, lentEnvironment(store, id, texture).release);
     return id;
   };
 
   const lendFont = (id: string) => (font: Font) => {
-    // Fonts hold no GPU resources: withdrawing the loan frees them.
-    own(id, store.lendFont(id, font));
+    own(id, lentFont(store, id, font).release);
     return id;
   };
 

package/src/dom/canvas.ts

@@ -5,6 +5,7 @@
  */
 import type { Op, ResourceStore, SceneEvent } from '@opsydyn/effect-three';
 
+import type { AssetNotice } from '../assetRegistry.ts';
 import { domEventName, type SceneError } from '../element.ts';
 import type { Latch } from './latch.ts';
 import { summarise } from './reconciled.ts';
@@ -31,6 +32,17 @@ export const dispatchSceneError = (element: Element, error: SceneError): void =>
   element.dispatchEvent(new CustomEvent('scene-error', { detail: { error } }));
 };
 
+/**
+ * Dispatches what the environment says about an asset the scene asked for, as a
+ * `scene-asset-loaded` or `scene-asset-failed` event. Not held back while time travel is
+ * paused: whether an asset loaded is a fact about the page, not a frame.
+ */
+export const dispatchAssetNotice = (element: Element, notice: AssetNotice): void => {
+  const { _tag, ...detail } = notice;
+  const name = _tag === 'Loaded' ? 'scene-asset-loaded' : 'scene-asset-failed';
+  element.dispatchEvent(new CustomEvent(name, { detail }));
+};
+
 /** Thunk builders, so Effect code can run DOM work with `Effect.sync(thunk)`. */
 export const canvasIn = (host: Element) => () => appendCanvas(host);
 export const removal = (node: ChildNode) => () => node.remove();

package/src/dom/pointer.ts

@@ -3,7 +3,13 @@
  *
  * @module
  */
-import type { Gestures, Modifiers, PointerInput, SceneEvent } from '@opsydyn/effect-three';
+import type {
+  Gestures,
+  Modifiers,
+  PointerDevice,
+  PointerInput,
+  SceneEvent,
+} from '@opsydyn/effect-three';
 
 /** The part of `DOMRect` the conversion needs. */
 export type Rect = {
@@ -33,6 +39,12 @@ const modifiersOf = (event: MouseEvent): Modifiers => ({
   alt: event.altKey,
 });
 
+/** What pressed: a finger, a pen, or (for anything else, and plain mouse events) a mouse. */
+const deviceOf = (event: MouseEvent): PointerDevice =>
+  event instanceof PointerEvent && (event.pointerType === 'touch' || event.pointerType === 'pen')
+    ? event.pointerType
+    : 'mouse';
+
 /** The pointer's id, or 0 for mouse events that are not pointer events. */
 const pointerIdOf = (event: MouseEvent): number =>
   event instanceof PointerEvent ? event.pointerId : 0;
@@ -64,6 +76,7 @@ export const toPointerInput = (event: MouseEvent, rect: Rect): PointerInput | un
         button: event.button,
         pointer,
         modifiers: modifiersOf(event),
+        device: deviceOf(event),
       };
     case 'pointerup':
       return { _tag: 'PointerUp', x, y, button: event.button, pointer };

package/src/element.ts

@@ -63,6 +63,7 @@ export const sceneElement = CustomElement.define({
     'scene-auto-rotated': SceneSchema.AutoRotatedDetail,
     'scene-collision': SceneSchema.CollisionDetail,
     'scene-contact-force': SceneSchema.ContactForceDetail,
+    'scene-physics-reached': SceneSchema.PhysicsReachedDetail,
     'scene-measured': SceneSchema.MeasuredDetail,
     'scene-label-measured': SceneSchema.LabelMeasuredDetail,
     'scene-xr': XrSessionDetail,
@@ -74,6 +75,8 @@ export const sceneElement = CustomElement.define({
     'scene-xr-meshes': SceneSchema.XrMeshesDetail,
     'scene-performance': SceneSchema.PerformanceDetail,
     'scene-error': Schema.Struct({ error: SceneError }),
+    'scene-asset-loaded': SceneSchema.AssetLoadedDetail,
+    'scene-asset-failed': SceneSchema.AssetFailedDetail,
     'scene-reconciled': ReconciledDetail,
   },
 });
@@ -97,6 +100,7 @@ export const domEventName = {
   AutoRotated: 'scene-auto-rotated',
   Collision: 'scene-collision',
   ContactForce: 'scene-contact-force',
+  PhysicsReached: 'scene-physics-reached',
   Measured: 'scene-measured',
   LabelMeasured: 'scene-label-measured',
   XrStick: 'scene-xr-stick',

package/src/environment.ts

@@ -13,7 +13,8 @@ import {
   type ResourceStore,
 } from '@opsydyn/effect-three';
 
-import { makeAssets } from './assets.ts';
+import { makeAssetRegistry } from './assetRegistry.ts';
+import { assetLoader, makeAssets } from './assets.ts';
 import { animationFrameScheduler, type AnimationFrameHost } from './dom/animationFrames.ts';
 import { defaultPixelRatio, type PixelRatio } from './dom/viewport.ts';
 import { webglRendererFactory } from './dom/webgl.ts';
@@ -49,6 +50,7 @@ export type EnvironmentOptions = {
 export const makeEnvironment = (host: EnvironmentHost, options: EnvironmentOptions = {}) => {
   const store: ResourceStore = createResourceStore();
   const assets = makeAssets(store);
+  const assetRegistry = makeAssetRegistry(assetLoader(store));
   const xrHub = createXrHub(() => host.navigator?.xr);
   return {
     host,
@@ -63,12 +65,15 @@ export const makeEnvironment = (host: EnvironmentHost, options: EnvironmentOptio
     labels: options.labels,
     /** Loads textures and glTF models by URL and lends them to the store. */
     assets,
+    /** The assets scenes ask for in their descriptions: loaded, shared, cancelled, freed. */
+    assetRegistry,
     /** Enters and leaves immersive (WebXR) sessions, from Commands. */
     xr: makeXr(xrHub),
     /** The page's presentable scenes and its session; scene mounts register here. */
     xrHub,
     /** Disposes every loaded asset and every GPU resource still held. */
     dispose: () => {
+      assetRegistry.dispose();
       assets.dispose();
       store.dispose();
     },

package/src/index.ts

@@ -53,6 +53,8 @@ export * as TransformGizmo from './transformGizmo.ts';
 export * as ViewportGizmo from './viewportGizmo.ts';
 export { type OverlayView } from './overlayView.ts';
 export {
+  type AssetFailedDetail,
+  type AssetLoadedDetail,
   type AutoRotatedDetail,
   type ButtonDetail,
   type CollisionDetail,
@@ -66,6 +68,7 @@ export {
   type MeasuredDetail,
   type MissDetail,
   type PerformanceDetail,
+  type PhysicsReachedDetail,
   view,
   type ViewConfig,
   type WheelDetail,