ris-framework 0.2.0-dev.13 → 0.2.0-dev.16

package/CHANGELOG.md

@@ -2,8 +2,45 @@
 
 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/).
+An unreleased version is dated `{{YYYY-MM-DD}}`; the publish pipeline fills in the date when it is merged to `main`.
 
-## [0.2.0] - Unreleased
+## [0.3.0] - {{YYYY-MM-DD}}
+
+Compared with 0.2.0.
+
+### Breaking changes
+
+- Renderable meshes take their transform from `mesh.transform` (a `TransformNode`); `mesh.position`, `rotation`, `scale` and `modelMatrix` are removed.
+- Cameras have a `transform`; the `eye`, `target` and `up` properties are replaced by `setEye`/`setTarget`/`setUp` and their getters.
+- `PointLight.position` is replaced by `setPosition`/`getPosition`, and `DirectionalLight.direction` by `setDirection`/`getDirection`.
+- `ICameraMaterial` is removed; use `IMaterial.camera`.
+- `IRenderer.preferredColorSpace` is renamed to `IRenderer.colorSpace`, and the `textureColorSpace` default is now `LINEAR`.
+- `PrimitiveStateDescriptor` class is replaced by the `IPrimitiveStateDescriptor` interface; all fields are optional and default to back-face culled, counter-clockwise triangles.
+- `UnlitMaterialDescriptor` class is replaced by the `IUnlitMaterialDescriptor` interface (all fields optional).
+
+### Added
+
+- `TransformNode` (with a `Node` parent/child hierarchy), `ISceneObject` and `scene.nodes`; meshes, cameras and lights are scene objects, and parented ones work in world space.
+- The `ILight` interface shared by all lights.
+- `IMaterial.camera`: materials bind the camera buffers they use.
+- `IRenderer.colorSpace` can be switched at runtime.
+- `ITextureDescriptor.preferredColorSpace` to choose the color space per texture.
+
+### Changed
+
+- `textureFactory.create` without a format follows the renderer's color space.
+- Basis KTX2 textures can be transcoded to PVRTC1 RGB.
+- Requires `ris-ktx2` ^0.2.0 (stable).
+
+### Fixed
+
+- `ColorSpace` was not exported from the package entry.
+- An explicit `textureFormat` was ignored when loading KTX2 textures.
+- `content.loadTexture2DAsync` ignored the descriptor's label and usage.
+- ASTC textures were uploaded with the wrong size.
+- `OrbitCamera` zoom now checks the real eye-to-target distance against the near and far planes.
+
+## [0.2.0] - 2026-11-01
 
 Compared with `main` (0.1.0).
 
@@ -16,6 +53,7 @@ Compared with `main` (0.1.0).
 - 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.
+- `TextureDescriptor` class is replaced by the `ITextureDescriptor` interface; all fields are optional and factories fill in defaults.
 
 ### Added
 
@@ -26,11 +64,14 @@ Compared with `main` (0.1.0).
 - 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.
+- `ColorSpace` enum, the `textureColorSpace` configuration option (default `SRGB`) and `IRenderer.preferredColorSpace`.
+- `TextureUtilities.convertToSrgbVariant`, `convertToLinearVariant` and `isSrgbFormat`.
 - Examples: `unlit_mesh`, `blinn_phong_mesh` and `sprite_batch`.
 
 ### Changed
 
 - `content.loadShaderModule` accepts optional replacement values.
+- Textures without a format, and KTX2 textures, follow the configured color space.
 
 ### Fixed
 
@@ -40,7 +81,7 @@ Compared with `main` (0.1.0).
 - A leftover `debugger` statement in WebGL device initialization.
 - Swapped BC/S3TC compression flags could select BC7 on GPUs without BPTC support.
 
-## [0.1.0]
+## [0.1.0] - 2026-10-08
 
 - 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

@@ -36,7 +36,7 @@ framework.renderer.clearColor = Color.cornerFlowerBlue();
 | `canvas` | created and appended | The canvas to render into. |
 | `backBufferSize` | `800 × 600` | Back buffer size. |
 | `textureFiltering` | `BILINEAR` | Default sampler preset. |
-| `textureColorSpace` | `SRGB` | Default texture colour space. |
+| `textureColorSpace` | `LINEAR` | Default texture colour space; switch at runtime with `framework.renderer.colorSpace`. |
 | `useKtx2` | `false` | Creates `framework.ktx2Factory`. |
 | `alpha` | `false` | Whether the back buffer has an alpha channel. |
 | `powerPreference` | `DEFAULT` | GPU preference on multi-GPU systems. |
@@ -53,13 +53,15 @@ const scene = new Scene(framework);
 // Passing the scene makes this the scene's camera.
 const camera = framework.cameraFactory.createPerspectiveCamera({
     aspectRatio: canvas.width / canvas.height,
-    eye: [0, 0, 3],
+    position: [0, 0, 3], // world position; aims at `target` (default origin). Later: camera.setEye(...), setTarget(...), setUp(...)
 }, scene);
 
 scene.activeAmbientLight.color = new Color(0.4, 0.4, 0.4);
 // Lights take an optional scene; passing it adds them.
 new DirectionalLight({ color: new Color(1, 1, 1), intensity: 0.8, direction: [-0.4, -0.6, 1] }, scene);
-new PointLight({ color: new Color(1, 0.5, 0.2), intensity: 1.2, linear: 0.35, quadratic: 0.44 }, scene);
+const lamp = new PointLight({ color: new Color(1, 0.5, 0.2), intensity: 1.2, linear: 0.35, quadratic: 0.44 }, scene);
+// Lights implement ILight and are scene objects: position and direction live in light.transform.
+lamp.setPosition([0, 2, 0]);
 
 framework.addOnUpdateListener(time => {
     camera.update(time);
@@ -74,9 +76,9 @@ framework.addOnRenderListener(() => scene.render());
 
 - `IMesh` / `Mesh` hold geometry and the vertex and index buffers.
 - `IRenderableMesh` / `RenderableMesh` add a material, an index range and sub meshes (`mesh.addSubMesh(material, start, count)` or `meshFactory.createWithSubMeshes`). The root mesh owns the transform and one model buffer, which all its sub meshes share.
-- Transforms: `mesh.position`, `mesh.rotation` (Euler radians, applied Y, then X, then Z) and `mesh.scale`. `mesh.modelMatrix` is recomputed only when one of them changes.
+- Transforms: `mesh.transform` is a `TransformNode` with `position`, `rotation` (Euler radians, applied Y, then X, then Z) and `scale`. `transform.modelMatrix` is recomputed only when one of them changes, and parenting one transform to another (`parent.addChild(child)`) makes it relative to the parent. Meshes, cameras and lights are all scene objects (`ISceneObject`) with a `transform`.
 - `SceneMesh`: `scene.add(mesh)` wraps a renderable mesh in a `SceneMesh`, which owns its materials. `sceneMesh.dispose()` and `scene.dispose()` dispose the mesh and each material once.
-- Materials come from `framework.materialFactory`. They include unlit, `ForwardBlinnPhongMaterial` and `SpriteMaterial`.
+- Materials come from `framework.materialFactory`. They include unlit (`createUnlitMaterial(descriptor?: IUnlitMaterialDescriptor)`), `ForwardBlinnPhongMaterial` and `SpriteMaterial`.
 
 ## Loading OBJ/MTL
 
@@ -103,8 +105,14 @@ const geometry = await framework.content.loadMeshAsync("/assets/cube.obj", Geome
 ```ts
 const png = await framework.content.loadTexture2DAsync("/assets/test.png");
 const ktx = await framework.content.loadTexture2DAsync("/assets/kodim23.ktx2");
+
+// Optional descriptor: every field is optional, missing ones get defaults.
+const desc: ITextureDescriptor = { generateMipmaps: true, textureFormat: TextureFormat.RGBA_8_UNORM };
+const cat = await framework.content.loadTexture2DAsync("/assets/cat.jpg", desc);
 ```
 
+Textures without a format use `RGBA_8_UNORM` when the colour space is `LINEAR` (the default) and `RGBA_8_UNORM_SRGB` when it is `SRGB`.
+
 Paths ending in `.ktx2` are loaded through `ris-ktx2`.
 
 - **Basis Universal files** are transcoded to the best format the GPU supports, in this order: BC7, ASTC 4×4, BC3, ETC2, PVRTC, and RGBA8 as a last resort.

package/dist/api/IFramework.d.ts

@@ -23,7 +23,7 @@ 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";
+import type { ColorSpace } from "./rendering/enums.js";
 /**
  * The configuration for the framework.
  * @public
@@ -35,8 +35,8 @@ export declare class IFrameworkConfiguration {
     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 texture color space to use by default. By default, it is {@link ColorSpace.LINEAR}. */
+    textureColorSpace?: ColorSpace;
     /**
     * The HTMLCanvasElement to use for rendering.
     * If null, a new canvas will be created and added to the document body.

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":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AACrG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAC,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAGrD;;;IAGI;AACJ,qBAAa,uBAAuB;IAEhC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,wEAAwE;IACxE,cAAc,CAAC,EAAE,IAAI,CAAC;IAEtB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,6BAA6B,CAAC;IAEjD,8FAA8F;IAC7F,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAE/B;;;MAGE;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,0GAA0G;IAC1G,eAAgB,CAAC,EAAE,mBAAmB,CAAC;IAEvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAW,SAAQ,WAAW;IAE3C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IAEzC;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,EAAE,sBAAsB,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE3C,2BAA2B;IAC3B,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IAEzC,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAEnC,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,0BAA0B;IAC1B,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IAEvC,2BAA2B;IAC3B,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IAEzC;;;OAGG;IACH,wBAAwB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAElD;;;OAGG;IACH,2BAA2B,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAErD,+CAA+C;IAC/C,wBAAwB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAElD,+CAA+C;IAC/C,2BAA2B,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;IAE/D;;OAEG;IACH,sBAAsB,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;IAElE;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAEhD,iCAAiC;IACjC,UAAU,IAAI,IAAI,CAAC;IAEnB;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAEpC"}

package/dist/api/_export.d.ts

@@ -24,6 +24,9 @@ export * from "./material/_export.js";
 export * from "./lights/_export.js";
 export * from "./scene/Scene.js";
 export * from "./scene/SceneMesh.js";
+export * from "./scene/ISceneObject.js";
+export * from "./scene/node/Node.js";
+export * from "./scene/node/TransformNode.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,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"}
+{"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,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,65 @@
+import { mat4, vec3 } from "gl-matrix";
+import { TransformNode } from "../scene/node/TransformNode.js";
+/**
+ * Helpers shared by the cameras for deriving the view from a transform.
+ * Cameras look down their local -Z axis with +Y up.
+ * @internal
+ */
+export declare class CameraTransformUtilities {
+    /**
+     * Writes the view matrix `inverse(T * R)` from a world matrix, ignoring scale.
+     * @param out The view matrix.
+     * @param world The camera's world matrix (`transform.modelMatrix`).
+     */
+    static viewFromWorld(out: mat4, world: mat4): mat4;
+    /**
+     * Writes the Euler rotation (the transform's Y-X-Z order) that makes a camera at `position` look at `target`
+     * with `up` as the up hint (a non-vertical up rolls the camera). When `up` is parallel to the view direction,
+     * the world axis least aligned with the view direction is used instead. Leaves `out` unchanged when the points are equal.
+     * @param out The rotation.
+     * @param position The camera position.
+     * @param target The point to look at.
+     * @param up The up hint. By default, world +Y.
+     */
+    static lookAtRotation(out: vec3, position: vec3, target: vec3, up?: vec3): vec3;
+    /**
+     * Writes the camera's forward direction (unit length) from a world matrix.
+     * @param out The direction.
+     * @param world The camera's world matrix.
+     */
+    static forwardFromWorld(out: vec3, world: mat4): vec3;
+    /**
+     * Rotates a camera transform to look at a world-space point with a world-space up hint.
+     * When the transform has a `TransformNode` parent, the target and up are converted into the parent's space.
+     * @param transform The camera transform.
+     * @param target The world point.
+     * @param up The world up hint.
+     */
+    static aimTransform(transform: TransformNode, target: vec3, up: vec3): void;
+    /**
+     * Writes a world position into `transform.position`, converting into the parent's space when it has a `TransformNode` parent.
+     */
+    static setWorldPosition(transform: TransformNode, world: vec3): void;
+}
+/**
+ * The eye / target / up state of a camera, wrapping its transform (the single source of truth).
+ * @internal
+ */
+export declare class CameraAim {
+    private readonly _transform;
+    private readonly _target;
+    private _hasTarget;
+    private readonly _up;
+    constructor(_transform: () => TransformNode);
+    setEye(eye: vec3): void;
+    getEye(out?: vec3): vec3;
+    setTarget(target: vec3): void;
+    getTarget(out?: vec3): vec3;
+    setUp(up: vec3): void;
+    getUp(out?: vec3): vec3;
+    /** One-shot look-at with the current up; forgets the stored target. */
+    lookAt(target: vec3): void;
+    /** Re-aims at the stored target. */
+    aim(): void;
+}
+//# sourceMappingURL=CameraTransformUtilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CameraTransformUtilities.d.ts","sourceRoot":"","sources":["../../../src/api/camera/CameraTransformUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,IAAI,EAAE,IAAI,EAAC,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAC,aAAa,EAAC,MAAM,gCAAgC,CAAC;AAY7D;;;;GAIG;AACH,qBAAa,wBAAwB;IAEjC;;;;OAIG;WACW,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI;IAazD;;;;;;;;OAQG;WACW,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAE,IAAgB,GAAG,IAAI;IA8BjG;;;;OAIG;WACW,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI;IAK5D;;;;;;OAMG;WACW,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,IAAI;IAalF;;OAEG;WACW,gBAAgB,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI;CAS9E;AAED;;;GAGG;AACH,qBAAa,SAAS;IAKC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;gBAEZ,UAAU,EAAE,MAAM,aAAa;IAG5D,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAOvB,MAAM,CAAC,GAAG,GAAE,IAAoB,GAAG,IAAI;IAKvC,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAM7B,SAAS,CAAC,GAAG,GAAE,IAAoB,GAAG,IAAI;IAS1C,KAAK,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI;IAOrB,KAAK,CAAC,GAAG,GAAE,IAAoB,GAAG,IAAI;IAI7C,uEAAuE;IAChE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAKjC,oCAAoC;IAC7B,GAAG,IAAI,IAAI;CAGrB"}

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

@@ -1,9 +1,10 @@
 import type { IDisposable } from "../core/IDisposable.js";
-import { mat4 } from "gl-matrix";
+import { mat4, vec3 } from "gl-matrix";
 import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
 import { GameTime } from "../time/GameTime.js";
+import type { ISceneObject } from "../scene/ISceneObject.js";
 /** The camera interface. */
-export interface ICamera extends IDisposable {
+export interface ICamera extends ISceneObject, IDisposable {
     /**
      * The projection matrix.
      */
@@ -38,6 +39,39 @@ export interface ICamera extends IDisposable {
      * This needs to be called when camera properties are changed.
      */
     updateBuffers(): void;
+    /**
+     * Moves the camera: writes `transform.position` from a world position (converted into the parent's space
+     * when the transform has a `TransformNode` parent). Re-aims at the target when one was set with {@link setTarget},
+     * keeping the old eye/target behaviour; otherwise the rotation is kept.
+     * @param eye The world position.
+     */
+    setEye(eye: vec3): void;
+    /**
+     * The world position of the camera (the transform's world translation).
+     * @param out Optional vector to write into.
+     */
+    getEye(out?: vec3): vec3;
+    /**
+     * Stores the target and rotates the transform to look at it with the current up ({@link getUp}).
+     * @param target The world point to look at.
+     */
+    setTarget(target: vec3): void;
+    /**
+     * The last target set with {@link setTarget}, or the eye plus the view direction when none is set.
+     * @param out Optional vector to write into.
+     */
+    getTarget(out?: vec3): vec3;
+    /**
+     * Sets the up vector used when aiming (world space, by default (0, 1, 0)); a non-vertical up rolls the camera.
+     * Re-aims when a target is set. An up parallel to the view direction falls back to the world axis least aligned with it.
+     * @param up The up vector.
+     */
+    setUp(up: vec3): void;
+    /**
+     * The up vector used when aiming.
+     * @param out Optional vector to write into.
+     */
+    getUp(out?: vec3): vec3;
     /**
      * Update the camera.
      * @param time - The game time object.

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,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"}
+{"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,EAAE,IAAI,EAAC,MAAM,WAAW,CAAA;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAE3D,4BAA4B;AAC5B,MAAM,WAAW,OAAQ,SAAQ,YAAY,EAAE,WAAW;IAEtD;;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;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAE5B;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAExB;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CAEhC"}

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

@@ -6,6 +6,7 @@ import type { ICamera } from "./ICamera.js";
 import { GameTime } from "../time/GameTime.js";
 import { MouseButton } from "../input/mouse/MouseButton.js";
 import { InputDeviceType } from "../input/InputDeviceType.js";
+import type { TransformNode } from "../scene/node/TransformNode.js";
 /**
  * Camerae that support orbit movement.
  */
@@ -22,6 +23,7 @@ export declare class OrbitCamera implements ICamera {
     private readonly _coreCamera;
     private readonly _inputManager;
     /** The rotation around the vertical axis. */
+    private readonly _target;
     private _yaw;
     /** The tilt of the camera.*/
     private _pitch;
@@ -41,7 +43,6 @@ export declare class OrbitCamera implements ICamera {
     /** The speed of pinch.*/
     pinchSpeed: number;
     /** The up vector. */
-    up: vec3;
     /** The clamp values of pitch axis */
     pitchClamp: vec2;
     /** @inheritDoc */
@@ -64,23 +65,30 @@ export declare class OrbitCamera implements ICamera {
     get direction(): vec3;
     /** Orbit controls can be used if this button is pressed. */
     orbitButton: MouseButton;
+    /** The orbit camera's transform: the core camera's transform. Its position is the eye; the rotation is set each update to look at {@link target}. */
+    get transform(): TransformNode;
     /**
-     * The eye position of the camera.
+     * Sets the point the camera orbits around and looks at (the core camera's target). By default, the origin.
+     * @param target The world point.
      */
-    get eye(): vec3;
-    /**
-     * The eye position of the camera.
-     */
-    set eye(value: vec3);
-    /**
-     * The eye position of the camera.
-     */
-    get target(): vec3;
+    setTarget(target: vec3): void;
+    /** @inheritDoc */
+    getTarget(out?: vec3): vec3;
     /**
-     * The eye position of the camera.
+     * Moves the camera to a world position and re-derives the orbit (pitch, yaw, distance) around the target.
+     * @param eye The world position.
      */
-    set target(value: vec3);
-    /** Gets the core camera.*/
+    setEye(eye: vec3): void;
+    /** @inheritDoc */
+    getEye(out?: vec3): vec3;
+    /** Sets the up vector the core camera aims with (the orbit angles stay around world +Y, so this rolls the view). */
+    setUp(up: vec3): void;
+    /** @inheritDoc */
+    getUp(out?: vec3): vec3;
+    /** The eye: `transform.position` (world space). */
+    private get _eye();
+    /** Re-derives pitch and yaw from the eye and target, and aims the core camera at the target. */
+    private _syncFromTransform;
     get coreCamera(): ICamera | undefined;
     /**
      * Find a target from yaw and pitch.

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

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

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

@@ -3,16 +3,16 @@ import type { IFramework } from "../IFramework.js";
 import { vec3, mat4 } from "gl-matrix";
 import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
 import { GameTime } from "../time/GameTime.js";
+import { TransformNode } from "../scene/node/TransformNode.js";
 /**
  * The Orthographic Camera.
  */
 export declare class OrthographicCamera implements IOrthographicCamera {
-    static UP_VECTOR: vec3;
     private readonly _framework;
     /** @ts-ignore */
     private readonly _zSpaceLength;
-    private _eye;
-    private _target;
+    private readonly _lastWorld;
+    private readonly _direction;
     private _left;
     private _right;
     private _top;
@@ -23,9 +23,33 @@ export declare class OrthographicCamera implements IOrthographicCamera {
     protected _projectionMatrix: mat4;
     protected _viewMatrix: mat4;
     protected _projectionViewMatrix: mat4;
-    readonly position: vec3;
-    readonly target: vec3;
-    readonly direction: vec3;
+    /**
+     * The camera transform: the single source of the view. The camera looks down its local -Z axis;
+     * the view matrix is `inverse(T * R)` of `transform.modelMatrix` (scale is ignored).
+     * By default, at (0, 0, 1) looking down -Z at the origin.
+     */
+    transform: TransformNode;
+    /** The unit direction the camera looks in, from the transform. */
+    get direction(): vec3;
+    private readonly _aim;
+    /**
+     * Rotates the transform once so the camera looks at a world point, using the current up ({@link getUp}).
+     * Forgets the target stored by {@link setTarget}, so a later {@link setEye} does not re-aim.
+     * @param target The point to look at.
+     */
+    lookAt(target: vec3): void;
+    /** @inheritDoc */
+    setEye(eye: vec3): void;
+    /** @inheritDoc */
+    getEye(out?: vec3): vec3;
+    /** @inheritDoc */
+    setTarget(target: vec3): void;
+    /** @inheritDoc */
+    getTarget(out?: vec3): vec3;
+    /** @inheritDoc */
+    setUp(up: vec3): void;
+    /** @inheritDoc */
+    getUp(out?: vec3): vec3;
     private _projectionBuffer;
     private _viewBuffer;
     private _projectionViewBuffer;
@@ -68,10 +92,6 @@ export declare class OrthographicCamera implements IOrthographicCamera {
     /** @inheritDoc */
     set farPlane(value: number);
     /** @inheritDoc */
-    get eye(): vec3;
-    /** @inheritDoc */
-    set eye(value: vec3);
-    /** @inheritDoc */
     get projectionMatrix(): mat4;
     /** @inheritDoc */
     get projectionViewMatrix(): mat4;
@@ -85,8 +105,10 @@ export declare class OrthographicCamera implements IOrthographicCamera {
     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). */
+    /** Writes the transform's world position into the std140 position data. */
     private _updatePositionData;
+    /** True when the transform's world matrix changed since the view was last built. */
+    private _transformChanged;
     /**
      * 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

@@ -4,6 +4,7 @@ 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";
+import { TransformNode } from "../scene/node/TransformNode.js";
 /**
  * The descriptor for a perspective camera. Every field is optional.
  */
@@ -16,11 +17,13 @@ export interface PerspectiveCameraDescriptor {
     near?: number;
     /** The far plane. By default, 100. */
     far?: number;
-    /** The eye position. Copied. By default, (0, 0, 3). */
+    /** The world position (see {@link ICamera.setEye}). By default, (0, 0, -3). */
+    position?: vec3;
+    /** Alias of {@link position}; `position` wins when both are given. */
     eye?: vec3;
-    /** The point the camera looks at. Copied. By default, the origin. */
+    /** The point the camera looks at (see {@link ICamera.setTarget}). By default, the origin. */
     target?: vec3;
-    /** The up vector. Copied. By default, (0, 1, 0). */
+    /** The up vector used to aim (see {@link ICamera.setUp}). By default, (0, 1, 0). */
     up?: vec3;
 }
 /**
@@ -28,7 +31,8 @@ export interface PerspectiveCameraDescriptor {
  */
 export declare class PerspectiveCamera implements ICamera {
     protected readonly _framework: IFramework;
-    private readonly _tempVec3;
+    private readonly _lastWorld;
+    private readonly _positionData;
     private _projectionMatrix;
     private _viewMatrix;
     private _projectionViewMatrix;
@@ -78,19 +82,32 @@ export declare class PerspectiveCamera implements ICamera {
     /** @inheritDoc */
     get positionBuffer(): IUniformBuffer;
     /**
-     * The eye position of the camera.
+     * The camera transform: the single source of the view. The camera looks down its local -Z axis;
+     * the view matrix is `inverse(T * R)` of `transform.modelMatrix` (scale is ignored).
+     * By default, at (0, 0, -3) looking at the origin.
      */
-    eye: vec3;
-    /**
-     * The target position of the camera.
-     */
-    target: vec3;
+    transform: TransformNode;
+    /** The unit direction the camera looks in, from the transform. */
+    get direction(): vec3;
+    private readonly _aim;
     /**
-     * The up vector of the camera.
+     * Rotates the transform once so the camera looks at a world point, using the current up ({@link getUp}).
+     * Forgets the target stored by {@link setTarget}, so a later {@link setEye} does not re-aim.
+     * @param target The point to look at.
      */
-    up: vec3;
-    /** The direction of a camera. */
-    get direction(): vec3;
+    lookAt(target: vec3): void;
+    /** @inheritDoc */
+    setEye(eye: vec3): void;
+    /** @inheritDoc */
+    getEye(out?: vec3): vec3;
+    /** @inheritDoc */
+    setTarget(target: vec3): void;
+    /** @inheritDoc */
+    getTarget(out?: vec3): vec3;
+    /** @inheritDoc */
+    setUp(up: vec3): void;
+    /** @inheritDoc */
+    getUp(out?: vec3): vec3;
     /**
      * The field of view of the camera.
      */
@@ -113,10 +130,7 @@ 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).
-     */
+    /** The world position, std140 `vec3` (padded to 16 bytes). This is what {@link positionBuffer} holds. */
     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":"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"}
+{"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, type IMesh, type IRenderableMesh, type GeometryFormat, type ICamera } from "../index.js";
+import { type IShaderModule, type IContentManager, type IShaderModuleLoader, type ITexture2D, type IFramework, type ITextureDescriptor, ContentConfig, type IMesh, type IRenderableMesh, type GeometryFormat, type ICamera } from "../index.js";
 import type { IKtx2Texture } from "ris-ktx2";
 /**
  * The content manager.
@@ -27,7 +27,7 @@ export declare class ContentManager implements IContentManager {
         [id: string]: number;
     }): IShaderModule;
     /** @inheritDoc */
-    loadTexture2DAsync(path: string, textureDescriptor?: TextureDescriptor, contentConfig?: ContentConfig): Promise<ITexture2D>;
+    loadTexture2DAsync(path: string, textureDescriptor?: ITextureDescriptor, contentConfig?: ContentConfig): Promise<ITexture2D>;
     /** @inheritDoc */
     loadTexture2DFromPixels(width: number, height: number, pixels: ArrayBuffer): ITexture2D;
     /** @inheritDoc */

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,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"}
+{"version":3,"file":"ContentManager.d.ts","sourceRoot":"","sources":["../../../src/api/content/ContentManager.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,kBAAkB,EAEvB,aAAa,EAEb,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,KAAK,OAAO,EAEf,MAAM,aAAa,CAAC;AAKrB,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,kBAAkB,EACtC,aAAa,CAAC,EAAE,aAAa,GAC1D,OAAO,CAAC,UAAU,CAAC;IAsCtB,kBAAkB;IACX,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU;IAM9F,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"}