ris-framework 0.1.0 → 0.2.0-dev.12

package/CHANGELOG.md

@@ -1,6 +1,47 @@
 # Changelog
 
-## 0.1.0
+All notable changes to this project are documented in this file.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [0.2.0] - Unreleased
+
+Compared with `main` (0.1.0).
+
+### Breaking changes
+
+- `FrameworkConfiguration` is no longer exported; pass an `IFrameworkConfiguration` object to `new Framework(...)`.
+- `tsyringe` and `reflect-metadata` are removed; services use plain constructor wiring.
+- `cameraFactory.createPerspectiveCamera` takes a descriptor object, and every `ICamera` now requires a `positionBuffer`.
+- Meshes are split into `IMesh`/`Mesh` (geometry and buffers) and `IRenderableMesh`/`RenderableMesh` (material, index range, sub meshes, transform).
+- Materials take a `modelBuffer` owned by the mesh instead of `modelMatrix`, and `renderMesh` takes an `IRenderableMesh`.
+- Render pipelines throw when no model buffer is passed.
+- Requires `ris-ktx2` 0.2.
+
+### Added
+
+- WebGPU backend (preview): set `renderingBackend` and call `framework.initializeAsync()`. Only unlit materials are supported so far; WebGL stays the default and is used as a fallback.
+- `Scene` with `add`/`remove` for meshes, lights and the camera, plus `SceneMesh` for owning a mesh and its materials.
+- Lights: `AmbientLight`, `DirectionalLight` and `PointLight`.
+- `ForwardBlinnPhongMaterial`, `SpriteMaterial`, and the `ICameraMaterial`/`ILightsMaterial` interfaces.
+- Mesh transforms (`position`, `rotation`, `scale`) and sub meshes (`addSubMesh`, `meshFactory.createWithSubMeshes`).
+- OBJ/MTL loading through `framework.objLoader`, `ObjParser`, and `content.loadMeshAsync`, `loadUnlitMeshAsync` and `loadBlinnPhongMeshAsync`.
+- `geometryBuilder.create(descriptor)` and the exported `BaseGeometry`.
+- sRGB compressed texture formats (BC1, BC3, BC7, ETC2), with KTX2 loading choosing sRGB automatically.
+- Examples: `unlit_mesh`, `unlit_mesh_webgpu`, `blinn_phong_mesh` and `sprite_batch`.
+
+### Changed
+
+- `content.loadShaderModule` accepts optional replacement values.
+
+### Fixed
+
+- Sprites rendered white because of a stray value in the sprite shader.
+- The orthographic camera's default eye was on the wrong side (z = -1).
+- A second `Framework` instance reused the default texture and anisotropic-filtering extension from the first.
+- A leftover `debugger` statement in WebGL device initialization.
+- Swapped BC/S3TC compression flags could select BC7 on GPUs without BPTC support.
+
+## [0.1.0]
 
 - Initial release setup. `development` publishes a prerelease on the npm `next` tag. `main` publishes this version on `latest`.
 - The package entry is compiled JavaScript and declarations in `dist`. Consumers import `Framework`, `FrameworkConfiguration`, `TextureSamplerFilteringPreset`, and the types formerly published as `ris-framework-api` from `ris-framework` without compiling this repository. Built-in shaders and the browser KTX2 loader are included in that JavaScript.

package/README.md

@@ -18,7 +18,7 @@ Open `index.html`. The module script is `src/main.ts`. That file builds the page
 | `shaders/glsl` | Vertex and fragment shaders used by the built-in shader modules. |
 | `tests` | Vitest tests for the types under `src/api`. |
 
-Runtime dependencies are `ris-ktx2`, `gl-matrix`, `tsyringe`, and `reflect-metadata`. The KTX2 types (`IKtx2Texture`, `VkFormat`, `KtxTranscodeFormat`, and the rest) are imported from `ris-ktx2`. The library build includes the browser portion of `ris-ktx2`, with its Node loader replaced by a stub, so the published entry does not import Node built-ins. TypeScript, Vite, and Vitest are dev dependencies. Notices for the bundled KTX loader are in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). The package license is Apache License 2.0. Copyright 2026 Luka Erkapic. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
+Runtime dependencies are `ris-ktx2` and `gl-matrix`. The KTX2 types (`IKtx2Texture`, `VkFormat`, `KtxTranscodeFormat`, and the rest) are imported from `ris-ktx2`. The library build includes the browser portion of `ris-ktx2`, with its Node loader replaced by a stub, so the published entry does not import Node built-ins. TypeScript, Vite, and Vitest are dev dependencies. Notices for the bundled KTX loader are in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). The package license is Apache License 2.0. Copyright 2026 Luka Erkapic. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
 
 ## Prerequisites
 
@@ -54,7 +54,7 @@ To work in this repository:
 npm ci
 ```
 
-Import `reflect-metadata` before constructing the framework. `src/main.ts` keeps that import first. `Framework` registers itself on a tsyringe child container, and tsyringe expects `reflect-metadata` to be loaded.
+`Framework` creates its services itself and passes dependencies through their constructors; no dependency-injection container or `reflect-metadata` import is needed.
 
 ## Create a framework instance
 
@@ -76,8 +76,6 @@ No config field is required. Each field has a default.
 Every field is optional on `IFrameworkConfiguration`. A new `FrameworkConfiguration` sets `useKtx2`, `textureFiltering`, `alpha`, and `powerPreference`. `canvas` and `backBufferSize` start unset.
 
 ```ts
-import "reflect-metadata";
-
 import { Framework, FrameworkConfiguration, TextureSamplerFilteringPreset } from "ris-framework";
 
 const config = new FrameworkConfiguration();
@@ -168,6 +166,31 @@ The first `begin` / `drawRect` / `end` runs inside `initialize()`, before the te
 
 Setting `framework.renderer.clearColor` after `initialize()` updates later frames. The first frame has already cleared with the default light pink.
 
+## Scene
+
+`new Scene(framework)` holds meshes, lights and the camera. `scene.add(item)` and `scene.remove(item)` accept a renderable mesh (wrapped in a `SceneMesh`, which owns and disposes its materials), an `AmbientLight`, `DirectionalLight`, `PointLight` or a camera; adding twice does nothing. Lights and the perspective camera given a scene in their constructor add themselves. Adding a camera makes it `scene.camera`; removing the active camera clears it. `scene.update(time)` hands the camera, the active ambient light and the scene's light lists (by reference) to the materials. `addLight`/`removeLight` remain as deprecated aliases.
+
+Meshes follow the C# framework: `IMesh`/`Mesh` hold geometry and buffers only; `IRenderableMesh`/`RenderableMesh` add an optional material, an index range (`indexStart`, `indexCount`, -1 for all), sub meshes that share the root's buffers, and the transform with one model buffer per root. OBJ files load through `framework.objLoader`:
+
+```ts
+const mesh = await framework.objLoader.loadAsync(url, {
+    projectionViewBuffer: camera.projectionViewBuffer,
+    cameraPositionBuffer: camera.positionBuffer,
+}); // one ForwardBlinnPhongMaterial per usemtl material
+// or: framework.objLoader.loadAsync(url, subMesh => myMaterial(subMesh.material))
+// or: await ObjLoader.parseAsync(url) for plain data without GPU resources
+scene.add(mesh);
+```
+
+## Examples
+
+Browser examples live in [`examples/`](examples/), one folder per example. See [`examples/README.md`](examples/README.md).
+
+```sh
+npm run dev:examples      # serve the examples index, e.g. /sprite_batch/
+npm run build:examples    # build every example into examples/dist/
+```
+
 ## What is still unfinished
 
 These throw, or they accept a call and do not do the work the name suggests:

package/dist/Framework.d.ts

@@ -1,29 +1,38 @@
-import { type ICameraFactory, type IContentManager, type IFramework, IFrameworkConfiguration, type IImageLoader, type IRenderer, type IRenderPipelineFactory, type IWindowManager } from "./api/index.js";
-import { GameTime, type IBufferFactory, type IGeometryBuilder, type IGraphicsDevice, type IImageProcessor, type IInputManager, type IMaterialFactory, type IMeshFactory, type ISpriteBatch, type ITextureFactory, type ITimeManager, RenderingBackend } from "./api/index.js";
+import { ObjLoader } from "./api/loaders/ObjLoader.js";
+import { type AmbientLightFactory, GameTime, type IBufferFactory, type ICameraFactory, type IContentManager, type IFramework, IFrameworkConfiguration, type IGeometryBuilder, type IGraphicsDevice, type IImageLoader, type IImageProcessor, type IInputManager, type IMaterialFactory, type IMeshFactory, type IRenderer, type IRenderPipelineFactory, type ISpriteBatch, type ITextureFactory, type ITimeManager, type IWindowManager, RenderingBackend } from "./api/index.js";
 import type { IKtx2Factory } from "ris-ktx2";
+/** The Ris framework */
 export declare class Framework implements IFramework {
     private readonly _onLoadContentListeners;
     private readonly _onInitializeListeners;
     private readonly _onUpdateListeners;
     private readonly _onRenderListeners;
-    private readonly _container;
-    private readonly _textureFactory;
-    private readonly _buffersFactory;
-    private readonly _contentManager;
+    private _configuration;
+    private _textureFactory;
+    private _buffersFactory;
+    private _contentManager;
+    private readonly _rendererConfiguration;
+    private _renderer;
     private readonly _geometryBuilder;
     private readonly _meshFactory;
+    private _disposed;
     /**
      * The constructor for the Framework class.
-     * @param options The optional framework configuration. When omitted, a default `FrameworkConfiguration` is used.
+     * @param configuration The optional framework configuration. When omitted, a default `FrameworkConfiguration` is used.
      */
-    constructor(options?: IFrameworkConfiguration);
+    constructor(configuration?: IFrameworkConfiguration);
     /** @inheritDoc */
     readonly imageLoader: IImageLoader;
     renderingBackend: RenderingBackend;
     /** @inheritDoc */
     readonly imageProcessor: IImageProcessor;
     /** @inheritDoc */
-    readonly renderer: IRenderer;
+    get renderer(): IRenderer;
+    /**
+     * Creates the backend-specific services: renderer, texture factory, pipeline factory, shader loader and buffers factory.
+     * @param backend WEB_GL or WEB_GPU.
+     */
+    private _setupBackendServices;
     /** @inheritDoc */
     readonly spriteBatch: ISpriteBatch;
     /** @inheritDoc */
@@ -68,14 +77,29 @@ export declare class Framework implements IFramework {
     /** @inheritdoc */
     get meshFactory(): IMeshFactory;
     /** @inheritDoc */
+    readonly objLoader: ObjLoader;
+    /** @inheritDoc */
     readonly materialFactory: IMaterialFactory;
     /** @inheritDoc */
+    readonly lightsFactory: AmbientLightFactory;
+    /** @inheritDoc */
     readonly timeManager: ITimeManager;
     /** @inheritDoc */
     readonly input: IInputManager;
     /** @inheritdoc */
     initialize(): void;
-    /** @inheritDoc */
+    /**
+     * Initializes the framework and starts the event loop. Required for WebGPU, which requests its adapter
+     * and device asynchronously; for WebGL it behaves like {@link initialize}.
+     * If the WebGPU device cannot be acquired, the framework falls back to WebGL with a warning.
+     */
+    initializeAsync(): Promise<void>;
+    private _initializeCore;
+    /**
+     * Stops the event loop and disposes the framework's services and GL resources,
+     * including per-framework caches such as the default texture and the shader modules.
+     * A new `Framework` afterwards creates fresh resources on its own context. Calling it twice does nothing.
+     */
     dispose(): void;
 }
 //# sourceMappingURL=Framework.d.ts.map

package/dist/Framework.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Framework.d.ts","sourceRoot":"","sources":["../src/Framework.ts"],"names":[],"mappings":"AAQA,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,UAAU,EAAE,uBAAuB,EACxC,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGH,QAAQ,EACR,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,EAElB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EAGjB,gBAAgB,EAEnB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAK3C,qBAAa,SAAU,YAAW,UAAU;IAExC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAsB;IAC9D,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAsB;IAC7D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwC;IAC3E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IAEzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C;;;OAGG;gBACS,OAAO,CAAC,EAAE,uBAAuB;IA0C7C,kBAAkB;IAClB,SAAgB,WAAW,EAAE,YAAY,CAAC;IAE1C,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,kBAAkB;IAClB,SAAgB,cAAc,EAAE,eAAe,CAAC;IAEhD,kBAAkB;IAClB,SAAgB,QAAQ,EAAG,SAAS,CAAC;IAErC,kBAAkB;IAClB,SAAgB,WAAW,EAAE,YAAY,CAAC;IAE1C,kBAAkB;IACX,aAAa,EAAE,cAAc,CAAC;IAErC,kBAAkB;IACX,WAAW,CAAC,EAAE,YAAY,CAAC;IAElC,kBAAkB;IACX,wBAAwB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAIxD,kBAAkB;IACX,2BAA2B,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAI3D,kBAAkB;IACX,wBAAwB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAIxD,kBAAkB;IACX,2BAA2B,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAI3D,kBAAkB;IACX,mBAAmB,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAIrE,kBAAkB;IACX,sBAAsB,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAIxE,kBAAkB;IACX,mBAAmB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAInD,kBAAkB;IACX,sBAAsB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAItD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAO9B,kBAAkB;IAClB,IAAW,cAAc,IAAI,eAAe,CAE3C;IAED,kBAAkB;IACX,qBAAqB,EAAE,sBAAsB,CAAC;IAErD,kBAAkB;IAClB,IAAI,eAAe,IAAI,gBAAgB,CAEtC;IAED,kBAAkB;IAClB,SAAgB,aAAa,EAAE,cAAc,CAAC;IAE9C,kBAAkB;IAClB,IAAW,cAAc,IAAI,eAAe,CAE3C;IAED,kBAAkB;IAClB,IAAW,aAAa,IAAI,cAAc,CAEzC;IAED,kBAAkB;IAClB,IAAW,OAAO,IAAI,eAAe,CAEpC;IAED,kBAAkB;IAClB,IAAW,WAAW,IAAI,YAAY,CAErC;IAED,kBAAkB;IAClB,SAAgB,eAAe,EAAE,gBAAgB,CAAC;IAElD,kBAAkB;IAClB,SAAgB,WAAW,EAAE,YAAY,CAAC;IAE1C,kBAAkB;IAClB,SAAgB,KAAK,EAAE,aAAa,CAAC;IAErC,kBAAkB;IACX,UAAU,IAAI,IAAI;IAgDzB,kBAAkB;IACX,OAAO;CAKjB"}
+{"version":3,"file":"Framework.d.ts","sourceRoot":"","sources":["../src/Framework.ts"],"names":[],"mappings":"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"}

package/dist/api/IFramework.d.ts

@@ -7,10 +7,12 @@ import type { IBufferFactory } from "./rendering/buffers/IBufferFactory.js";
 import type { IGeometryBuilder } from "./geometry/IGeometryBuilder.js";
 import type { ICameraFactory } from "./camera/ICameraFactory.js";
 import type { ITextureFactory } from "./rendering/texture/ITextureFactory.js";
+import type { ObjLoader } from "./loaders/ObjLoader.js";
 import type { IContentManager } from "./content/IContentManager.js";
 import type { IImageLoader } from "./loaders/IImageLoader.js";
 import type { IMeshFactory } from "./meshes/IMeshFactory.js";
 import type { IMaterialFactory } from "./material/IMaterialFactory.js";
+import type { AmbientLightFactory } from "./lights/LightFactory.js";
 import type { ITimeManager } from "./time/ITimeManager.js";
 import type { IInputManager } from "./input/IInputManager.js";
 import type { IWindowManager } from "./window/IWindowManager.js";
@@ -18,6 +20,39 @@ import { GameTime } from "./time/GameTime.js";
 import type { IImageProcessor } from "./image/IImageProcessor.js";
 import type { IKtx2Factory } from "ris-ktx2";
 import type { IDisposable } from "./core/IDisposable.js";
+import type { vec2 } from "gl-matrix";
+import type { TextureSamplerFilteringPreset } from "../core/rendering/enums.js";
+import type { PowerPreferenceType } from "./rendering/PowerPreference.js";
+import type { TextureColorSpace } from "./rendering/enums.js";
+/**
+ * The configuration for the framework.
+ * @public
+ **/
+export declare class IFrameworkConfiguration {
+    /** If true, creates and makes the KTX2 factory available. */
+    useKtx2?: boolean;
+    /** The size of back buffer. By default, if not specified (800, 600). */
+    backBufferSize?: vec2;
+    /** The texture filtering to configure */
+    textureFiltering?: TextureSamplerFilteringPreset;
+    /** The texture color space to use by default. By default, it is {@link TextureColorSpace.SRGB}. */
+    textureColorSpace?: TextureColorSpace;
+    /**
+    * The HTMLCanvasElement to use for rendering.
+    * If null, a new canvas will be created and added to the document body.
+    */
+    canvas?: HTMLCanvasElement;
+    /** Should back buffer use alpha. */
+    alpha?: boolean;
+    /** The preference when it comes to selecting GPU device. Only makes sense to set on multi-GPU devices. */
+    powerPreference?: PowerPreferenceType;
+    /**
+     * The rendering backend. Defaults to WebGL.
+     * WebGPU requires `Framework.initializeAsync()`; when `navigator.gpu` is missing or no device is available,
+     * the framework falls back to WebGL with a warning.
+     */
+    renderingBackend?: RenderingBackend;
+}
 /** The framework interface. */
 export interface IFramework extends IDisposable {
     /**
@@ -71,10 +106,18 @@ export interface IFramework extends IDisposable {
      * The mesh factory.
      */
     readonly meshFactory: IMeshFactory;
+    /**
+     * The OBJ loader: `objLoader.loadAsync(path, blinnPhongDescriptor | subMesh => material)`.
+     */
+    readonly objLoader: ObjLoader;
     /**
      * The material factory.
      */
     readonly materialFactory: IMaterialFactory;
+    /**
+     * The ambient light factory.
+     */
+    readonly lightsFactory: AmbientLightFactory;
     /**
      * The time manager.
      */
@@ -95,13 +138,9 @@ export interface IFramework extends IDisposable {
      * Content can be loaded here.
      */
     removeOnLoadContentListener(event: () => void): void;
-    /**
-     * Called when the framework is initialized.
-     */
+    /** Called when the framework is initialized.*/
     addOnInitializedListener(event: () => void): void;
-    /**
-     * Called when the framework is initialized.
-     */
+    /** Called when the framework is initialized.*/
     removeOnInitializedListener(event: () => void): void;
     /**
      * Called when framework is updated.
@@ -121,5 +160,10 @@ export interface IFramework extends IDisposable {
     removeOnRenderListener(event: () => void): void;
     /** Initializes the framework. */
     initialize(): void;
+    /**
+     * Initializes the framework asynchronously and starts the event loop.
+     * Required for the WebGPU backend; for WebGL it behaves like {@link initialize}.
+     */
+    initializeAsync(): Promise<void>;
 }
 //# sourceMappingURL=IFramework.d.ts.map

package/dist/api/IFramework.d.ts.map

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

package/dist/api/_export.d.ts

@@ -1,5 +1,4 @@
 export * from "./IFramework.js";
-export * from "./IFrameworkConfiguration.js";
 export * from "./rendering/texture/_export-texture.js";
 export * from "./rendering/buffers/_export-buffers.js";
 export * from "./data/_export.js";
@@ -22,6 +21,9 @@ export * from "./rendering/sampler/_export.js";
 export * from "./utilities/_export.js";
 export * from "./meshes/_export.js";
 export * from "./material/_export.js";
+export * from "./lights/_export.js";
+export * from "./scene/Scene.js";
+export * from "./scene/SceneMesh.js";
 export * from "./input/_export.js";
 export * from "./image/_export.js";
 //# sourceMappingURL=_export.d.ts.map

package/dist/api/_export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../src/api/_export.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0DAA0D,CAAC;AACzE,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC;AACpC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../src/api/_export.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,0DAA0D,CAAC;AACzE,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC;AACpC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/api/camera/CameraFactory.d.ts

@@ -1,9 +1,10 @@
 import { vec2 } from "gl-matrix";
 import type { ICameraFactory } from "./ICameraFactory.js";
+import type { Scene } from "../scene/Scene.js";
 import type { IFramework } from "../IFramework.js";
 import type { IOrthographicCamera } from "./IOrthographicCamera.js";
 import { OrbitCamera } from "./OrbitCamera.js";
-import { PerspectiveCamera } from "./PerspectiveCamera.js";
+import { PerspectiveCamera, type PerspectiveCameraDescriptor } from "./PerspectiveCamera.js";
 /** The Camera Factory */
 export declare class CameraFactory implements ICameraFactory {
     private readonly _framework;
@@ -20,6 +21,6 @@ export declare class CameraFactory implements ICameraFactory {
     /** @inheritDoc */
     createOrbitCamera(fov?: number, aspectRatio?: number, near?: number, far?: number): OrbitCamera;
     /** @inheritDoc */
-    createPerspectiveCamera(fov?: number, aspectRatio?: number, near?: number, far?: number): PerspectiveCamera;
+    createPerspectiveCamera(descriptor?: PerspectiveCameraDescriptor, scene?: Scene): PerspectiveCamera;
 }
 //# sourceMappingURL=CameraFactory.d.ts.map

package/dist/api/camera/CameraFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CameraFactory.d.ts","sourceRoot":"","sources":["../../../src/api/camera/CameraFactory.ts"],"names":[],"mappings":"AAAA,OAAQ,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AAGzD,yBAAyB;AACzB,qBAAa,aAAc,YAAW,cAAc;IAQ7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN9C,MAAM,CAAC,cAAc,OAAwB;IAE7C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAE1D,kBAAkB;IACX,+BAA+B,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,mBAAmB;IAa1E,kBAAkB;IACX,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB;IAMzI,kBAAkB;IACX,iBAAiB,CAAC,GAAG,SAAK,EAAE,WAAW,SAAI,EAAE,IAAI,SAAO,EAAE,GAAG,SAAM,GAAG,WAAW;IAKxF,kBAAkB;IACX,uBAAuB,CAAC,GAAG,SAAI,EAAE,WAAW,SAAI,EAAE,IAAI,SAAM,EAAE,GAAG,SAAM,GAAG,iBAAiB;CAOrG"}
+{"version":3,"file":"CameraFactory.d.ts","sourceRoot":"","sources":["../../../src/api/camera/CameraFactory.ts"],"names":[],"mappings":"AAAA,OAAQ,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAC,iBAAiB,EAAE,KAAK,2BAA2B,EAAC,MAAM,wBAAwB,CAAC;AAE3F,yBAAyB;AACzB,qBAAa,aAAc,YAAW,cAAc;IAQ7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN9C,MAAM,CAAC,cAAc,OAAwB;IAE7C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAE1D,kBAAkB;IACX,+BAA+B,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,mBAAmB;IAa1E,kBAAkB;IACX,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB;IAMzI,kBAAkB;IACX,iBAAiB,CAAC,GAAG,SAAK,EAAE,WAAW,SAAI,EAAE,IAAI,SAAO,EAAE,GAAG,SAAM,GAAG,WAAW;IAKxF,kBAAkB;IACX,uBAAuB,CAAC,UAAU,CAAC,EAAE,2BAA2B,EAAE,KAAK,CAAC,EAAG,KAAK,GAAG,iBAAiB;CAO9G"}

package/dist/api/camera/ICamera.d.ts

@@ -28,6 +28,11 @@ export interface ICamera extends IDisposable {
      * The view buffer.
      */
     readonly viewBuffer: IUniformBuffer;
+    /**
+     * The world-space eye position buffer, std140 `vec3` (`[x, y, z, 0]`).
+     * Used by lit materials for specular highlights.
+     */
+    readonly positionBuffer: IUniformBuffer;
     /**
      * Update the GPU buffers.
      * This needs to be called when camera properties are changed.

package/dist/api/camera/ICamera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ICamera.d.ts","sourceRoot":"","sources":["../../../src/api/camera/ICamera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAA;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAE7C,4BAA4B;AAC5B,MAAM,WAAW,OAAQ,SAAQ,WAAW;IAExC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,cAAc,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,cAAc,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IAEpC;;;OAGG;IACH,aAAa,IAAI,IAAI,CAAC;IAEtB;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CAEhC"}
+{"version":3,"file":"ICamera.d.ts","sourceRoot":"","sources":["../../../src/api/camera/ICamera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAA;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAE7C,4BAA4B;AAC5B,MAAM,WAAW,OAAQ,SAAQ,WAAW;IAExC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,cAAc,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,cAAc,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;;OAGG;IACH,aAAa,IAAI,IAAI,CAAC;IAEtB;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CAEhC"}

package/dist/api/camera/ICameraFactory.d.ts

@@ -1,20 +1,19 @@
 import type { IOrthographicCamera } from "./IOrthographicCamera.js";
 import { vec2 } from "gl-matrix";
 import { OrbitCamera } from "./OrbitCamera.js";
-import { PerspectiveCamera } from "./PerspectiveCamera.js";
+import { PerspectiveCamera, type PerspectiveCameraDescriptor } from "./PerspectiveCamera.js";
+import type { Scene } from "../scene/Scene.js";
 /**
  * The camera factory.
  */
 export interface ICameraFactory {
     /**
      * Creates a new perspective camera.
-     * @param fov The field of view. By default, 60 degrees.
-     * @param aspectRatio The aspect ratio. By default, 1.
-     * @param near The near plane. By default, 0.01.
-     * @param far The far plane. By default, 100.
+     * @param descriptor The optional descriptor; omitted fields use the defaults documented on {@link PerspectiveCameraDescriptor}.
+     * @param scene The optional scene; the camera becomes its `scene.camera`.
      * @return The perspective camera.
      */
-    createPerspectiveCamera(fov?: number, aspectRatio?: number, near?: number, far?: number): PerspectiveCamera;
+    createPerspectiveCamera(descriptor?: PerspectiveCameraDescriptor, scene?: Scene): PerspectiveCamera;
     /**
      * Creates a new orthographic camera which is suitable for 2D games, or for UI rendering.
      * Also, suitable when orthographic projection is required, such as shadow mapping.

package/dist/api/camera/ICameraFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ICameraFactory.d.ts","sourceRoot":"","sources":["../../../src/api/camera/ICameraFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,cAAc;IAE3B;;;;;;;OAOG;IACH,uBAAuB,CACnB,GAAG,CAAC,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAErC;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAEnI;;;;OAIG;IACH,+BAA+B,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,mBAAmB,CAAC;IAEpE;;;;;;;OAOG;IACH,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CAgBnG"}
+{"version":3,"file":"ICameraFactory.d.ts","sourceRoot":"","sources":["../../../src/api/camera/ICameraFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAC,iBAAiB,EAAE,KAAK,2BAA2B,EAAC,MAAM,wBAAwB,CAAC;AAC3F,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,cAAc;IAE3B;;;;;OAKG;IACH,uBAAuB,CAAC,UAAU,CAAC,EAAE,2BAA2B,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,iBAAiB,CAAC;IAEpG;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAEnI;;;;OAIG;IACH,+BAA+B,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,mBAAmB,CAAC;IAEpE;;;;;;;OAOG;IACH,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CAgBnG"}

package/dist/api/camera/OrthographicCamera.d.ts

@@ -29,6 +29,9 @@ export declare class OrthographicCamera implements IOrthographicCamera {
     private _projectionBuffer;
     private _viewBuffer;
     private _projectionViewBuffer;
+    private _positionBuffer;
+    /** std140 vec3 world-space eye, padded to 4 floats. */
+    private readonly _positionData;
     /**
      *
      * @param framework
@@ -80,6 +83,10 @@ export declare class OrthographicCamera implements IOrthographicCamera {
     get projectionViewBuffer(): IUniformBuffer;
     /** @inheritDoc */
     get viewBuffer(): IUniformBuffer;
+    /** @inheritDoc */
+    get positionBuffer(): IUniformBuffer;
+    /** Writes the world-space eye into the std140 position data (no z flip: the look-at uses the eye as is). */
+    private _updatePositionData;
     /**
      * Updates the camera matrices.
      */

package/dist/api/camera/OrthographicCamera.d.ts.map

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

package/dist/api/camera/PerspectiveCamera.d.ts

@@ -3,6 +3,26 @@ import { mat4, vec3 } from "gl-matrix";
 import type { IFramework } from "../IFramework.js";
 import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
 import { GameTime } from "../time/GameTime.js";
+import type { Scene } from "../scene/Scene.js";
+/**
+ * The descriptor for a perspective camera. Every field is optional.
+ */
+export interface PerspectiveCameraDescriptor {
+    /** The vertical field of view in degrees. By default, 60. */
+    fov?: number;
+    /** The aspect ratio (width / height). By default, 1. */
+    aspectRatio?: number;
+    /** The near plane. By default, 0.01. */
+    near?: number;
+    /** The far plane. By default, 100. */
+    far?: number;
+    /** The eye position. Copied. By default, (0, 0, 3). */
+    eye?: vec3;
+    /** The point the camera looks at. Copied. By default, the origin. */
+    target?: vec3;
+    /** The up vector. Copied. By default, (0, 1, 0). */
+    up?: vec3;
+}
 /**
  * The perspective camera.
  */
@@ -18,14 +38,13 @@ export declare class PerspectiveCamera implements ICamera {
     private _viewBuffer;
     private _projectionBuffer;
     /**
-     * The constructor.
+     * The constructor. Call `initialize()` before use (the camera factory does).
      * @param framework The framework.
-     * @param fov The field of view in radians.
-     * @param aspectRatio The aspect ratio.
-     * @param nearPlane The near plane.
-     * @param farPlane The far plane.
+     * @param descriptor The optional descriptor; omitted fields use the defaults documented on {@link PerspectiveCameraDescriptor}.
+     *                   `fov` is in degrees; {@link fieldOfView} holds it in radians. Vectors are copied.
+     * @param scene The optional scene; the camera assigns itself as `scene.camera`.
      */
-    constructor(framework: IFramework, fov: number, aspectRatio: number, nearPlane: number, farPlane: number);
+    constructor(framework: IFramework, descriptor?: PerspectiveCameraDescriptor, scene?: Scene);
     /**
      * The projection matrix.
      */
@@ -94,6 +113,11 @@ export declare class PerspectiveCamera implements ICamera {
      * Initialize the camera.
      */
     initialize(): void;
+    /**
+     * The eye in world space, as used by the view matrix: z is flipped for the right-handed look-at.
+     * This is what {@link positionBuffer} holds, std140 `vec3` (padded to 16 bytes).
+     */
+    private _worldEye;
     /**
      * Updates the camera matrices.
      */

package/dist/api/camera/PerspectiveCamera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PerspectiveCamera.d.ts","sourceRoot":"","sources":["../../../src/api/camera/PerspectiveCamera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAC,IAAI,EAAE,IAAI,EAAC,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAE7C;;GAEG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAE7C,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAE3C,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,qBAAqB,CAAiB;IAE9C,OAAO,CAAC,UAAU,CAAiB;IAEnC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,qBAAqB,CAAyB;IACtD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,iBAAiB,CAAyB;IAElD;;;;;;;OAOG;gBAEC,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM;IAUpB;;OAEG;IACH,IAAW,gBAAgB,IAAI,IAAI,CAElC;IAED;;OAEG;IACH,IAAW,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAEtC;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,IAAI,CAE5B;IAED;;OAEG;IACH,IAAW,UAAU,CAAC,KAAK,EAAE,IAAI,EAEhC;IAED;;OAEG;IACH,IAAW,oBAAoB,IAAI,IAAI,CAEtC;IAED;;OAEG;IACH,IAAW,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAE1C;IAED,kBAAkB;IAClB,IAAW,oBAAoB,IAAI,cAAc,CAEhD;IAED,kBAAkB;IAClB,IAAW,gBAAgB,IAAI,cAAc,CAE5C;IAED,kBAAkB;IAClB,IAAW,UAAU,IAAI,cAAc,CAEtC;IAED,kBAAkB;IAClB,IAAW,cAAc,IAAI,cAAc,CAE1C;IAED;;OAEG;IACI,GAAG,OAA0B;IAEpC;;OAEG;IACI,MAAM,OAAiB;IAE9B;;OAEG;IACI,EAAE,OAA0B;IAEnC,iCAAiC;IACjC,IAAW,SAAS,IAAI,IAAI,CAG3B;IAED;;OAEG;IACI,WAAW,SAA4B;IAE9C;;OAEG;IACI,WAAW,SAAK;IAEvB;;OAEG;IACI,SAAS,SAAQ;IAExB;;OAEG;IACI,QAAQ,SAAQ;IAEvB,kBAAkB;IAClB,SAAgB,UAAU,EAAE,OAAO,GAAG,SAAS,CAAa;IAE5D;;OAEG;IACI,UAAU,IAAI,IAAI;IAQzB;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,IAAI;IAajC,kBAAkB;IACX,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAMnC,kBAAkB;IACX,aAAa,IAAI,IAAI;IAO5B,kBAAkB;IACX,OAAO,IAAI,IAAI;CAMzB"}
+{"version":3,"file":"PerspectiveCamera.d.ts","sourceRoot":"","sources":["../../../src/api/camera/PerspectiveCamera.ts"],"names":[],"mappings":"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"}

package/dist/api/content/ContentManager.d.ts

@@ -1,4 +1,4 @@
-import { type IShaderModule, type IContentManager, type IShaderModuleLoader, type ITexture2D, type IFramework, TextureDescriptor, ContentConfig } from "../index.js";
+import { type IShaderModule, type IContentManager, type IShaderModuleLoader, type ITexture2D, type IFramework, TextureDescriptor, ContentConfig, type IMesh, type IRenderableMesh, type GeometryFormat, type ICamera } from "../index.js";
 import type { IKtx2Texture } from "ris-ktx2";
 /**
  * The content manager.
@@ -17,11 +17,24 @@ export declare class ContentManager implements IContentManager {
     constructor(_framework: IFramework, shaderModuleLoader: IShaderModuleLoader);
     /** @inheritDoc */
     loadKtx2Async(path: string, contentConfig?: ContentConfig): Promise<IKtx2Texture>;
+    /**
+     * Disposes the cached shader modules (their GL programs) and forgets cached KTX2 data.
+     * Called from `Framework.dispose()`.
+     */
+    dispose(): void;
     /** @inheritDoc */
-    loadShaderModule(shaderModuleId: string): IShaderModule;
+    loadShaderModule(shaderModuleId: string, keyValueDictionary?: {
+        [id: string]: number;
+    }): IShaderModule;
     /** @inheritDoc */
     loadTexture2DAsync(path: string, textureDescriptor?: TextureDescriptor, contentConfig?: ContentConfig): Promise<ITexture2D>;
     /** @inheritDoc */
     loadTexture2DFromPixels(width: number, height: number, pixels: ArrayBuffer): ITexture2D;
+    /** @inheritDoc */
+    loadMeshAsync(path: string, geometryFormat: GeometryFormat): Promise<IMesh>;
+    /** @inheritDoc */
+    loadUnlitMeshAsync(path: string, camera?: ICamera): Promise<IRenderableMesh>;
+    /** @inheritDoc */
+    loadBlinnPhongMeshAsync(path: string, camera: ICamera): Promise<IRenderableMesh>;
 }
 //# sourceMappingURL=ContentManager.d.ts.map

package/dist/api/content/ContentManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContentManager.d.ts","sourceRoot":"","sources":["../../../src/api/content/ContentManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,UAAU,EAAE,iBAAiB,EAAiB,aAAa,EACnE,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAG3C;;;GAGG;AACH,qBAAa,cAAe,YAAW,eAAe;IAU/B,OAAO,CAAC,QAAQ,CAAC,UAAU;aAA8B,kBAAkB,EAAE,mBAAmB;IARnH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqC;IAEvE;;;;OAIG;gBACiC,UAAU,EAAE,UAAU,EAAkB,kBAAkB,EAAE,mBAAmB;IAGnH,kBAAkB;IACL,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAc9F,kBAAkB;IACX,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa;IAI9D,kBAAkB;IACL,kBAAkB,CAAC,IAAI,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,aAAa,CAAC,EAAE,aAAa,GAC1B,OAAO,CAAC,UAAU,CAAC;IA4BtD,kBAAkB;IACX,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU;CAKjG"}
+{"version":3,"file":"ContentManager.d.ts","sourceRoot":"","sources":["../../../src/api/content/ContentManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,iBAAiB,EAEjB,aAAa,EAEb,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,KAAK,OAAO,EAEf,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAI3C;;;GAGG;AACH,qBAAa,cAAe,YAAW,eAAe;IAU/B,OAAO,CAAC,QAAQ,CAAC,UAAU;aAA8B,kBAAkB,EAAE,mBAAmB;IARnH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IAEzE;;;;OAIG;gBACiC,UAAU,EAAE,UAAU,EAAkB,kBAAkB,EAAE,mBAAmB;IAGnH,kBAAkB;IACL,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB9F;;;OAGG;IACI,OAAO,IAAI,IAAI;IAQtB,kBAAkB;IACX,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE;QAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,aAAa;IAI7G,kBAAkB;IACL,kBAAkB,CAAC,IAAI,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,aAAa,CAAC,EAAE,aAAa,GAC1D,OAAO,CAAC,UAAU,CAAC;IAmCtB,kBAAkB;IACX,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU;IAK9F,kBAAkB;IACL,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAMxF,kBAAkB;IACX,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IASnF,kBAAkB;IACX,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;CAS1F"}