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

package/dist/api/rendering/primitive/IPrimitiveStateDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPrimitiveStateDescriptor.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/primitive/IPrimitiveStateDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IAEtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACzB"}

package/dist/api/rendering/primitive/_export.d.ts

@@ -2,5 +2,5 @@ export * from "./CullMode.js";
 export * from "./FrontFace.js";
 export * from "./IPrimitiveState.js";
 export * from "./PrimitiveTopology.js";
-export * from "./PrimitiveStateDescriptor.js";
+export * from "./IPrimitiveStateDescriptor.js";
 //# sourceMappingURL=_export.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/primitive/_export.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA"}
+{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/primitive/_export.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,gCAAgC,CAAA"}

package/dist/api/rendering/render-pipelines/IMainRenderTargetRenderPipeline.d.ts

@@ -1,5 +1,6 @@
 import type { IRenderPipeline } from "./IRenderPipeline.js";
 import type { ITexture2D } from "../texture/ITexture2D.js";
+import type { ColorSpace } from "../enums.js";
 /**
  * Pipeline that is used in renderer as
  * a pass that renders from the main frame buffer to the screen.
@@ -10,6 +11,10 @@ export interface IMainRenderTargetRenderPipeline extends IRenderPipeline {
      * The pipeline will render this texture to the screen.
      */
     readonly mainRenderTarget: ITexture2D;
+    /**
+     *  Gets or sets the preferred color space. Only relevant for WebGL2 renderer.
+     */
+    colorSpace: ColorSpace;
     /**
      * Render to the screen.
      */

package/dist/api/rendering/render-pipelines/IMainRenderTargetRenderPipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IMainRenderTargetRenderPipeline.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/render-pipelines/IMainRenderTargetRenderPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,+BAAgC,SAAQ,eAAe;IAEpE;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAEtC;;OAEG;IACH,MAAM,IAAI,IAAI,CAAC;CAElB"}
+{"version":3,"file":"IMainRenderTargetRenderPipeline.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/render-pipelines/IMainRenderTargetRenderPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,+BAAgC,SAAQ,eAAe;IAEpE;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAEtC;;OAEG;IACH,UAAU,EAAE,UAAU,CAAC;IAEvB;;OAEG;IACH,MAAM,IAAI,IAAI,CAAC;CAElB"}

package/dist/api/rendering/texture/ITextureDescriptor.d.ts

@@ -1,6 +1,7 @@
 import type { TextureFormat } from "./TextureFormat.js";
 import type { TextureUsage } from "./TextureUsage.js";
 import type { vec2 } from "gl-matrix";
+import type { ColorSpace } from "../enums.js";
 /**
  * The texture descriptor. Every field is optional; factories fill in the defaults for missing fields.
  */
@@ -16,10 +17,13 @@ export interface ITextureDescriptor {
      */
     height?: number;
     /**
-     * The texture format.
+     * The texture format. When loading texture preferred format can be set.
+     * This overrides framework preferred color space when loading or ktx2 transcoding.
      * By default, it is UNDEFINED.
      */
     textureFormat?: TextureFormat;
+    /** The preferred color space. If not defined, it is specified by framework.  */
+    preferredColorSpace?: ColorSpace;
     /**
      * The texture usage.
      * By default, it is TEXTURE_BINDING | COPY_DST.

package/dist/api/rendering/texture/ITextureDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ITextureDescriptor.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/ITextureDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAE/B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB"}
+{"version":3,"file":"ITextureDescriptor.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/ITextureDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAE/B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,UAAU,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB"}

package/dist/api/rendering/texture/ITextureFactory.d.ts

@@ -26,7 +26,9 @@ export interface ITextureFactory {
      * @param channels - The number of channels.
      * @param label - The label.
      * @param usage - Texture usage. By default, it is COPY_DST | TEXTURE_BINDING.
-     * @param textureFormat - The texture format. By default, it is undefined. If so, the preferred texture format is used.
+     * @param textureFormat - The texture format. By default (or when UNDEFINED), the renderer's current
+     * {@link IRenderer.preferredTextureFormat} is used, so it follows {@link IRenderer.colorSpace}.
+     * Pass {@link TextureFormat.RGBA_8_UNORM} explicitly for raw data that must stay linear.
      * @param generateMipMaps - Indicates if texture should generate mipmap levels.
      * @returns The texture.
      */

package/dist/api/rendering/texture/ITextureFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ITextureFactory.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/ITextureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,eAAe;IAE5B;;;;;;;;OAQG;IACH,WAAW,CACP,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,YAAY,CAAC,EAAE,KAAK,EACpB,YAAY,CAAC,EAAE,YAAY,EAC3B,aAAa,CAAC,EAAE,aAAa,EAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAEhC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,gBAAgB,GAAG,eAAe,EACpD,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,YAAY,EACpB,aAAa,CAAC,EAAE,aAAa,EAC7B,eAAe,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAE9C;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,kBAAkB,GAAG,UAAU,CAAC;CACzF"}
+{"version":3,"file":"ITextureFactory.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/ITextureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,eAAe;IAE5B;;;;;;;;OAQG;IACH,WAAW,CACP,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,YAAY,CAAC,EAAE,KAAK,EACpB,YAAY,CAAC,EAAE,YAAY,EAC3B,aAAa,CAAC,EAAE,aAAa,EAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAEhC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,gBAAgB,GAAG,eAAe,EACpD,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,YAAY,EACpB,aAAa,CAAC,EAAE,aAAa,EAC7B,eAAe,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAE9C;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,kBAAkB,GAAG,UAAU,CAAC;CACzF"}

package/dist/api/rendering/texture/TextureUtilities.d.ts

@@ -74,5 +74,12 @@ export declare class TextureUtilities {
      * @return True if srgb texture format.
      */
     static isSrgbFormat(textureFormat: TextureFormat): boolean;
+    /**
+     * Returns the requested format if it is the file's format or its sRGB/linear variant.
+     * @param fileFormat The format the data is stored in.
+     * @param requested The explicitly requested format.
+     * @throws If the requested format cannot reinterpret the data.
+     */
+    static resolveExplicitFormat(fileFormat: TextureFormat, requested: TextureFormat): TextureFormat;
 }
 //# sourceMappingURL=TextureUtilities.d.ts.map

package/dist/api/rendering/texture/TextureUtilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextureUtilities.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/TextureUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAC,kBAAkB,EAAqB,QAAQ,EAAC,MAAM,UAAU,CAAC;AAGzE;;GAEG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAkD/C;IAEF,mDAAmD;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAqBlC;IACF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAgD7C;IAED,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAsD5C;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mCAAmC,CAazD;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,8BAA8B,CAmBpD;IAEF,wCAAwC;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAEpC;IAEF,yBAAyB;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAiE;IAErG;;;;OAIG;WACW,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAIvE;;;;;;OAMG;WACW,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9D;;;;;;;OAOG;WACW,WAAW,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAkB9F;;;;OAIG;WACW,8BAA8B,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa;IAQ/E;;;;OAIG;WACW,wCAAwC,CAAC,aAAa,EAAE,aAAa,GAAG,kBAAkB;IAQxG;;;;OAIG;WACW,mCAAmC,CAAC,eAAe,EAAE,kBAAkB,GAAG,QAAQ;IAQhG;;;;OAIG;WACW,oBAAoB,CAAC,aAAa,EAAE,aAAa,GAAI,aAAa;IAIhF;;;;OAIG;WACW,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAI,aAAa;IAIlF;;;;OAIG;WACW,YAAY,CAAC,aAAa,EAAE,aAAa,GAAI,OAAO;CAGrE"}
+{"version":3,"file":"TextureUtilities.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/TextureUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAC,kBAAkB,EAAqB,QAAQ,EAAC,MAAM,UAAU,CAAC;AAGzE;;GAEG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAkD/C;IAEF,mDAAmD;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAqBlC;IACF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAgD7C;IAED,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAsD5C;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mCAAmC,CAczD;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,8BAA8B,CAmBpD;IAEF,wCAAwC;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAEpC;IAEF,yBAAyB;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAiE;IAErG;;;;OAIG;WACW,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAIvE;;;;;;OAMG;WACW,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9D;;;;;;;OAOG;WACW,WAAW,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAkB9F;;;;OAIG;WACW,8BAA8B,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa;IAQ/E;;;;OAIG;WACW,wCAAwC,CAAC,aAAa,EAAE,aAAa,GAAG,kBAAkB;IAQxG;;;;OAIG;WACW,mCAAmC,CAAC,eAAe,EAAE,kBAAkB,GAAG,QAAQ;IAQhG;;;;OAIG;WACW,oBAAoB,CAAC,aAAa,EAAE,aAAa,GAAI,aAAa;IAIhF;;;;OAIG;WACW,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAI,aAAa;IAIlF;;;;OAIG;WACW,YAAY,CAAC,aAAa,EAAE,aAAa,GAAI,OAAO;IAIlE;;;;;OAKG;WACW,qBAAqB,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,GAAG,aAAa;CAQ1G"}

package/dist/api/scene/ISceneObject.d.ts

@@ -0,0 +1,12 @@
+import type { TransformNode } from "./node/TransformNode.js";
+/**
+ * An object that can be placed in a scene: it has a transform.
+ * @public
+ */
+export interface ISceneObject {
+    /**
+     * The transform node.
+     */
+    transform: TransformNode;
+}
+//# sourceMappingURL=ISceneObject.d.ts.map

package/dist/api/scene/ISceneObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISceneObject.d.ts","sourceRoot":"","sources":["../../../src/api/scene/ISceneObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,YAAY;IAEzB;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC;CAC5B"}

package/dist/api/scene/Scene.d.ts

@@ -7,8 +7,9 @@ import type { IRenderableMesh } from "../meshes/IRenderableMesh.js";
 import { SceneMesh } from "./SceneMesh.js";
 import type { GameTime } from "../time/GameTime.js";
 import type { ICamera } from "../camera/ICamera.js";
-/** Anything a scene can hold: a mesh, a light (ambient, directional, point) or a camera. */
-export type SceneItem = IRenderableMesh | SceneMesh | AmbientLight | DirectionalLight | PointLight | ICamera;
+import type { ISceneObject } from "./ISceneObject.js";
+/** Anything a scene can hold: a mesh, a scene object, a light (ambient, directional, point) or a camera. */
+export type SceneItem = IRenderableMesh | SceneMesh | ISceneObject | AmbientLight | DirectionalLight | PointLight | ICamera;
 /**
  * The scene. Lights and cameras given a scene in their constructor add themselves through {@link add};
  * meshes are added with `scene.add(mesh)` (wrapped in a {@link SceneMesh}, which owns the mesh's materials).
@@ -17,6 +18,7 @@ export type SceneItem = IRenderableMesh | SceneMesh | AmbientLight | Directional
  */
 export declare class Scene implements IDisposable {
     private readonly _sceneMeshes;
+    private readonly _nodes;
     private readonly _directionalLights;
     private readonly _pointLights;
     /** The directional light slots (matches the Blinn-Phong material). */
@@ -42,6 +44,8 @@ export declare class Scene implements IDisposable {
     constructor(framework: IFramework);
     /** The scene meshes, in the order they were added. */
     get sceneMeshes(): readonly SceneMesh[];
+    /** The scene objects (anything with a transform, including root meshes), in the order they were added. */
+    get nodes(): readonly ISceneObject[];
     /** The root meshes in this scene, in the order they were added. */
     get meshes(): readonly IRenderableMesh[];
     /** The directional lights in this scene. */
@@ -58,9 +62,13 @@ export declare class Scene implements IDisposable {
      * Adds a mesh, a light or a camera. Adding an item that is already in the scene does nothing.
      * - Renderable mesh or {@link SceneMesh}: drawn by {@link render}; its materials get the scene camera and lights.
      *   A mesh is wrapped in a `SceneMesh`, so {@link dispose} also disposes its materials.
-     * - Ambient light: added to {@link ambientLights} (use {@link activeAmbientLight} to make it the lit one).
+     *   The mesh is also added to {@link nodes}.
+     * - {@link ISceneObject} (anything with a `transform`): added to {@link nodes}; {@link update} updates its transform.
+     * - Lights are also added to {@link nodes} (they are scene objects).
+ * - Ambient light: added to {@link ambientLights} (use {@link activeAmbientLight} to make it the lit one).
      * - Directional / point light: added to {@link directionalLights} / {@link pointLights}.
-     * - Camera: becomes the scene {@link camera}.
+     * - Camera: becomes the scene {@link camera} and is added to {@link nodes} (cameras are scene objects).
+     *   Checked before the generic scene object case.
      * Constructors given a scene (lights, the perspective camera) call this themselves.
      * @param item The item to add.
      * @throws Error when all slots for a light kind are in use (3 directional, 5 point), or for an unsupported item.
@@ -70,7 +78,7 @@ export declare class Scene implements IDisposable {
      * Removes a mesh (or scene mesh), a light or a camera. The mesh and its materials are not disposed.
      * Removing the active camera clears {@link camera}.
      * @param item The item to remove.
-     * @returns True when the item was in the scene (for a camera: was the active camera).
+     * @returns True when the item was in the scene.
      * @throws Error when removing the active ambient light (set another {@link activeAmbientLight} first), or for an unsupported item.
      */
     remove(item: SceneItem): boolean;
@@ -91,10 +99,13 @@ export declare class Scene implements IDisposable {
     private static _removeFrom;
     /** Cameras have the camera buffers and updateBuffers(); meshes and lights do not. */
     private static _isCamera;
+    /** Scene objects have a TransformNode as transform. */
+    private static _isSceneObject;
+    private _addNode;
     /** Renderable meshes have render() and sub meshes. */
     private static _isMesh;
     /**
-     * Updates the scene: assigns {@link camera}, the active ambient light and the light lists to the mesh materials.
+     * Updates the scene: updates the transforms of {@link nodes}, assigns {@link camera}, the active ambient light and the light lists to the mesh materials.
      * Each lights material uploads its lights buffer when drawn, only if the lights changed.
      * @param _time The game time.
      * @public

package/dist/api/scene/Scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../../src/api/scene/Scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAC,UAAU,EAAC,MAAM,yBAAyB,CAAC;AACnD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAGzC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,sBAAsB,CAAC;AAElD,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,SAAS,GAAG,YAAY,GAAG,gBAAgB,GAAG,UAAU,GAAG,OAAO,CAAC;AAE7G;;;;;GAKG;AACH,qBAAa,KAAM,YAAW,WAAW;IAErC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA0B;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IAEjD,sEAAsE;IACtE,gBAAuB,sBAAsB,KAAK;IAElD,gEAAgE;IAChE,gBAAuB,gBAAgB,KAAK;IAC5C,OAAO,CAAC,mBAAmB,CAAe;IAC1C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAC,CAAU;IAEhC;;;;OAIG;IACH,IAAW,MAAM,IAAI,OAAO,GAAG,SAAS,CAEvC;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAQ3C;IAED,qDAAqD;IACrD,SAAgB,aAAa,EAAE,YAAY,EAAE,CAAM;IAEnD;;;OAGG;gBACgB,SAAS,EAAE,UAAU;IAMxC,sDAAsD;IACtD,IAAW,WAAW,IAAI,SAAS,SAAS,EAAE,CAE7C;IAED,mEAAmE;IACnE,IAAW,MAAM,IAAI,SAAS,eAAe,EAAE,CAE9C;IAED,4CAA4C;IAC5C,IAAW,iBAAiB,IAAI,SAAS,gBAAgB,EAAE,CAE1D;IAED,sCAAsC;IACtC,IAAW,WAAW,IAAI,SAAS,UAAU,EAAE,CAE9C;IAED;;OAEG;IACH,IAAW,kBAAkB,IAAI,YAAY,CAE5C;IAED,qFAAqF;IACrF,IAAW,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAGhD;IAED;;;;;;;;;;OAUG;IACI,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAmBjC;;;;;;OAMG;IACI,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IA+BvC;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,GAAG,IAAI;IAI3D;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,GAAG,OAAO;IAIjE,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,MAAM,CAAC,WAAW;IAS1B,qFAAqF;IACrF,OAAO,CAAC,MAAM,CAAC,SAAS;IAMxB,sDAAsD;IACtD,OAAO,CAAC,MAAM,CAAC,OAAO;IAKtB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAM7B,kFAAkF;IAClF,OAAO,CAAC,KAAK;IAmBb,OAAO,CAAC,MAAM,CAAC,aAAa;IAc5B;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd,+GAA+G;IACxG,OAAO,IAAI,IAAI;CAUzB"}
+{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../../src/api/scene/Scene.ts"],"names":[],"mappings":"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"}

package/dist/api/scene/node/Node.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A node in a hierarchy. A node has at most one parent; use {@link addChild} and {@link removeChild}
+ * to change the hierarchy (they keep `parent` and `children` in sync).
+ * @public
+ */
+export declare class Node {
+    private readonly _children;
+    private _parent?;
+    /** The child nodes of this node. */
+    get children(): readonly Node[];
+    /** The parent node of this node, if any. */
+    get parent(): Node | undefined;
+    /**
+     * Adds a child. It is removed from its previous parent first. Adding an existing child does nothing.
+     * @param child The child to add.
+     * @throws Error when adding the node to itself or to one of its descendants.
+     */
+    addChild(child: Node): void;
+    /**
+     * Removes a child.
+     * @param child The child to remove.
+     * @returns True when it was a child of this node.
+     */
+    removeChild(child: Node): boolean;
+}
+//# sourceMappingURL=Node.d.ts.map

package/dist/api/scene/node/Node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../../../src/api/scene/node/Node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,IAAI;IAEb,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,OAAO,CAAC,CAAO;IAEvB,oCAAoC;IACpC,IAAW,QAAQ,IAAI,SAAS,IAAI,EAAE,CAErC;IAED,4CAA4C;IAC5C,IAAW,MAAM,IAAI,IAAI,GAAG,SAAS,CAEpC;IAED;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAclC;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;CAS3C"}

package/dist/api/scene/node/TransformNode.d.ts

@@ -0,0 +1,46 @@
+import { mat4, vec3 } from "gl-matrix";
+import type { GameTime } from "../../time/GameTime.js";
+import { Node } from "./Node.js";
+/**
+ * The node responsible for transformations in the world.
+ *
+ * The matrices are computed lazily: reading {@link modelMatrix} recomputes them when position, rotation or scale
+ * changed (also through in-place edits), so {@link update} does not have to be called before the first render.
+ * When the parent is a `TransformNode`, {@link modelMatrix} is the world matrix `parent.modelMatrix * localMatrix`.
+ * @public
+ */
+export declare class TransformNode extends Node {
+    private readonly _rotationQuat;
+    private readonly _localMatrix;
+    private readonly _worldMatrix;
+    private readonly _lastPosition;
+    private readonly _lastRotation;
+    private readonly _lastScale;
+    /**
+     * The constructor.
+     */
+    constructor();
+    /** Position relative to the parent (the world, without one). Defaults to the origin. In-place edits are detected. */
+    position: vec3;
+    /**
+     * Euler rotation in radians, applied in Y, X, Z order (yaw, pitch, roll): `R = Ry * Rx * Rz`.
+     * Defaults to (0, 0, 0). In-place edits are detected.
+     */
+    rotation: vec3;
+    /** Scale. Defaults to (1, 1, 1). In-place edits are detected. */
+    scale: vec3;
+    /** The local matrix `T * R * S`, recomputed only when position, rotation or scale changed. */
+    get localMatrix(): mat4;
+    /**
+     * The model (world) matrix: {@link localMatrix}, or `parent.modelMatrix * localMatrix` when the parent is a
+     * `TransformNode`. Always the same matrix object for a node without a parent transform.
+     */
+    get modelMatrix(): mat4;
+    /**
+     * Updates the node and its transform children, recomputing the matrices if needed.
+     * Called by `Scene.update` for scene nodes; optional otherwise.
+     * @param gameTime The {@link GameTime}
+     */
+    update(gameTime: GameTime): void;
+}
+//# sourceMappingURL=TransformNode.d.ts.map

package/dist/api/scene/node/TransformNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformNode.d.ts","sourceRoot":"","sources":["../../../../src/api/scene/node/TransformNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAQ,IAAI,EAAC,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,IAAI;IAEnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAE9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAE5C;;OAEG;;IASH,qHAAqH;IAC9G,QAAQ,EAAE,IAAI,CAAC;IAEtB;;;OAGG;IACI,QAAQ,EAAE,IAAI,CAAC;IAEtB,iEAAiE;IAC1D,KAAK,EAAE,IAAI,CAAC;IAEnB,8FAA8F;IAC9F,IAAW,WAAW,IAAI,IAAI,CAc7B;IAED;;;OAGG;IACH,IAAW,WAAW,IAAI,IAAI,CAM7B;IAED;;;;OAIG;IACI,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAQ1C"}

package/dist/core/material/UnlitMaterialDescriptorUtilities.d.ts

@@ -0,0 +1,17 @@
+import type { IUnlitMaterialDescriptor } from "../../api/material/IUnlitMaterialDescriptor.js";
+/**
+ * An unlit material descriptor with every field present. `undefined` means "use the default":
+ * the pipeline's default primitive state, and no camera (a placeholder projection view buffer).
+ * @internal
+ */
+export type ResolvedUnlitMaterialDescriptor = {
+    [K in keyof Required<IUnlitMaterialDescriptor>]: IUnlitMaterialDescriptor[K];
+};
+/**
+ * Fills in the defaults for every missing field of an unlit material descriptor.
+ * @param desc The descriptor, possibly partial or missing.
+ * @returns A new descriptor with the defaults applied.
+ * @internal
+ */
+export declare function resolveUnlitMaterialDescriptor(desc?: IUnlitMaterialDescriptor): ResolvedUnlitMaterialDescriptor;
+//# sourceMappingURL=UnlitMaterialDescriptorUtilities.d.ts.map

package/dist/core/material/UnlitMaterialDescriptorUtilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnlitMaterialDescriptorUtilities.d.ts","sourceRoot":"","sources":["../../../src/core/material/UnlitMaterialDescriptorUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,gDAAgD,CAAC;AAE7F;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GAAG;KAAG,CAAC,IAAI,MAAM,QAAQ,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC;CAAE,CAAC;AAE/H;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,CAAC,EAAE,wBAAwB,GAAG,+BAA+B,CAK/G"}

package/dist/core/rendering/AGraphicsDevice.d.ts

@@ -1,7 +1,7 @@
 import { BlendStateDescriptor } from "./blending/blend-state-descriptor";
 import { TextureSamplerFilteringPreset } from "./enums";
 import { SamplerDescriptor } from "./sampler/sampler-descriptor";
-import { type IGPUInfo, type IGraphicsDeviceFeatures, type ISampler, type IBlendState, type IPrimitiveState, type IGraphicsDevice, SwapChainDescriptor, type RenderPassDescriptor, type ISwapChain, type IRenderPass, type PrimitiveStateDescriptor } from "../../api/index.js";
+import { type IGPUInfo, type IGraphicsDeviceFeatures, type ISampler, type IBlendState, type IPrimitiveState, type IGraphicsDevice, SwapChainDescriptor, type RenderPassDescriptor, type ISwapChain, type IRenderPass, type IPrimitiveStateDescriptor } from "../../api/index.js";
 import { PowerPreferenceType } from "../../api/rendering/PowerPreference.js";
 /**
  * The descriptor for the graphics device. This is used to configure the graphics device during initialization.
@@ -58,7 +58,7 @@ export declare abstract class AGraphicsDevice implements IGraphicsDevice {
     /** @inheritdoc */
     abstract createBlendState(descriptor: BlendStateDescriptor): IBlendState;
     /** @inheritdoc */
-    abstract createPrimitiveState(descriptor?: PrimitiveStateDescriptor): IPrimitiveState;
+    abstract createPrimitiveState(descriptor?: IPrimitiveStateDescriptor): IPrimitiveState;
     /** @inheritDoc */
     abstract setupDebugCallback(): void;
     /** @inheritDoc */

package/dist/core/rendering/AGraphicsDevice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AGraphicsDevice.d.ts","sourceRoot":"","sources":["../../../src/core/rendering/AGraphicsDevice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAC,6BAA6B,EAAC,MAAM,SAAS,CAAC;AACtD,OAAO,EAAC,iBAAiB,EAAC,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EACpE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,wBAAwB,EACnE,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,mBAAmB,EAAC,MAAM,wCAAwC,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IAEtC,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IAEf,0GAA0G;IAC1G,eAAe,EAAE,mBAAmB,CAAC;IAErC;;;;OAIG;IACH,sBAAsB,EAAE,6BAA6B,CAAC;CACzD;AAED;;GAEG;AACH,8BAAsB,eAAgB,YAAW,eAAe;IAE5D,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;IAC1D,SAAS,CAAC,sBAAsB,EAAE,QAAQ,CAAS;IACnD,SAAS,CAAC,kBAAkB,EAAE,WAAW,CAAS;IAClD,SAAS,CAAC,sBAAsB,EAAE,eAAe,CAAS;IAE1D;;;OAGG;IACH,SAAS,aAAa,UAAU,EAAE,yBAAyB;IAI3D,kBAAkB;IAClB,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAG,uBAAuB,CAAC;IAErD,kBAAkB;IAClB,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAEpC,kBAAkB;IAClB,IAAW,qBAAqB,IAAI,QAAQ,CAE3C;IAED,kBAAkB;IAClB,IAAW,iBAAiB,IAAI,WAAW,CAE1C;IAED,kBAAkB;IAClB,IAAW,qBAAqB,IAAI,eAAe,CAElD;IAED;;;OAGG;IACH,SAAS,CAAC,gCAAgC,IAAI,QAAQ;IAQtD,kBAAkB;IACX,UAAU,IAAI,IAAI;IAMzB,kBAAkB;aACF,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,GAAG,UAAU;IAEhH,kBAAkB;aACF,aAAa,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,QAAQ;IAEvE,kBAAkB;aACF,gBAAgB,CAAC,UAAU,EAAE,oBAAoB,GAAG,WAAW;IAE/E,kBAAkB;aACF,gBAAgB,CAAC,UAAU,EAAE,oBAAoB,GAAG,WAAW;IAE/E,kBAAkB;aACF,oBAAoB,CAAC,UAAU,CAAC,EAAE,wBAAwB,GAAI,eAAe;IAE7F,kBAAkB;aACF,kBAAkB,IAAI,IAAI;IAE1C,kBAAkB;aACF,QAAQ,IAAI,IAAI;IAEhC,kBAAkB;aACF,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAEvD,kBAAkB;aACF,aAAa,IAAI,IAAI;IAErC,kBAAkB;IACX,OAAO,IAAI,IAAI;CAIzB"}
+{"version":3,"file":"AGraphicsDevice.d.ts","sourceRoot":"","sources":["../../../src/core/rendering/AGraphicsDevice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAC,6BAA6B,EAAC,MAAM,SAAS,CAAC;AACtD,OAAO,EAAC,iBAAiB,EAAC,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EACpE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,yBAAyB,EACpE,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,mBAAmB,EAAC,MAAM,wCAAwC,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IAEtC,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IAEf,0GAA0G;IAC1G,eAAe,EAAE,mBAAmB,CAAC;IAErC;;;;OAIG;IACH,sBAAsB,EAAE,6BAA6B,CAAC;CACzD;AAED;;GAEG;AACH,8BAAsB,eAAgB,YAAW,eAAe;IAE5D,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;IAC1D,SAAS,CAAC,sBAAsB,EAAE,QAAQ,CAAS;IACnD,SAAS,CAAC,kBAAkB,EAAE,WAAW,CAAS;IAClD,SAAS,CAAC,sBAAsB,EAAE,eAAe,CAAS;IAE1D;;;OAGG;IACH,SAAS,aAAa,UAAU,EAAE,yBAAyB;IAI3D,kBAAkB;IAClB,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAG,uBAAuB,CAAC;IAErD,kBAAkB;IAClB,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAEpC,kBAAkB;IAClB,IAAW,qBAAqB,IAAI,QAAQ,CAE3C;IAED,kBAAkB;IAClB,IAAW,iBAAiB,IAAI,WAAW,CAE1C;IAED,kBAAkB;IAClB,IAAW,qBAAqB,IAAI,eAAe,CAElD;IAED;;;OAGG;IACH,SAAS,CAAC,gCAAgC,IAAI,QAAQ;IAQtD,kBAAkB;IACX,UAAU,IAAI,IAAI;IAMzB,kBAAkB;aACF,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,GAAG,UAAU;IAEhH,kBAAkB;aACF,aAAa,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,QAAQ;IAEvE,kBAAkB;aACF,gBAAgB,CAAC,UAAU,EAAE,oBAAoB,GAAG,WAAW;IAE/E,kBAAkB;aACF,gBAAgB,CAAC,UAAU,EAAE,oBAAoB,GAAG,WAAW;IAE/E,kBAAkB;aACF,oBAAoB,CAAC,UAAU,CAAC,EAAE,yBAAyB,GAAG,eAAe;IAE7F,kBAAkB;aACF,kBAAkB,IAAI,IAAI;IAE1C,kBAAkB;aACF,QAAQ,IAAI,IAAI;IAEhC,kBAAkB;aACF,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAEvD,kBAAkB;aACF,aAAa,IAAI,IAAI;IAErC,kBAAkB;IACX,OAAO,IAAI,IAAI;CAIzB"}

package/dist/core/rendering/ARenderer.d.ts

@@ -16,6 +16,7 @@ export declare abstract class ARenderer implements ITempRenderer {
     private _swapChainRequiresResize;
     private _mainRenderPassDirty;
     private _clearColor;
+    private _colorSpace;
     protected _mainRenderTargetRequiresResize: boolean;
     protected _swapChain: ISwapChain;
     protected _mainRenderTarget: ITexture2D;
@@ -32,9 +33,11 @@ export declare abstract class ARenderer implements ITempRenderer {
     set clearColor(color: Color);
     get limits(): RenderingLimits | null;
     /** @inheritdoc */
-    readonly preferredTextureFormat: TextureFormat;
+    get preferredTextureFormat(): TextureFormat;
     /** @inheritDoc */
-    readonly preferredColorSpace: ColorSpace;
+    get colorSpace(): ColorSpace;
+    /** @inheritDoc */
+    set colorSpace(colorSpace: ColorSpace);
     /** @inheritdoc */
     get preferredDepthStencilFormat(): TextureFormat;
     /** @inheritdoc */

package/dist/core/rendering/ARenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ARenderer.d.ts","sourceRoot":"","sources":["../../../src/core/rendering/ARenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,2CAA2C,CAAC;AAC7E,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EACH,KAAK,EACL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,+BAA+B,EAAE,KAAK,sBAAsB,EACjE,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EAEf,gBAAgB,EAKhB,aAAa,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,UAAU,EAAC,MAAM,8BAA8B,CAAC;AAExD,8BAAsB,SAAU,YAAW,aAAa;IAEpD,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAE1C;;OAEG;IACH,SAAS,CAAC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,EAAE,CAAM;IAEvE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,4BAA4B,CAAmD;IACvF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAgB;IACvD,OAAO,CAAC,wBAAwB,CAAkB;IAClD,OAAO,CAAC,oBAAoB,CAAQ;IACpC,OAAO,CAAC,WAAW,CAA4B;IAE/C,SAAS,CAAC,+BAA+B,EAAE,OAAO,CAAS;IAC3D,SAAS,CAAC,UAAU,EAAE,UAAU,CAAS;IACzC,SAAS,CAAC,iBAAiB,EAAE,UAAU,CAAS;IAChD,SAAS,CAAC,mBAAmB,EAAE,UAAU,CAAS;IAClD,SAAS,CAAC,oBAAoB,EAAE,WAAW,CAAS;IACpD,SAAS,CAAC,2BAA2B,CAAC,EAAE,WAAW,CAAC;IACpD,SAAS,CAAC,yBAAyB,CAAC,EAAE,+BAA+B,CAAC;IACtE,SAAS,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;IAEvD,kBAAkB;IAClB,IAAW,cAAc,IAAI,eAAe,CAE3C;IAED,kBAAkB;IAClB,IAAW,UAAU,IAAI,KAAK,CAE7B;IAED,kBAAkB;IAClB,IAAW,UAAU,CAAC,KAAK,EAAE,KAAK,EAGjC;IAED,IAAW,MAAM,IAAI,eAAe,GAAG,IAAI,CAE1C;IAED,kBAAkB;IAClB,SAAgB,sBAAsB,EAAE,aAAa,CAAC;IAEtD,kBAAkB;IAClB,SAAgB,mBAAmB,EAAE,UAAU,CAAC;IAEhD,kBAAkB;IAClB,IAAW,2BAA2B,IAAI,aAAa,CAEtD;IAED,kBAAkB;IAClB,IAAW,cAAc,IAAI,IAAI,CAEhC;IAED,kBAAkB;IAClB,IAAW,cAAc,CAAC,IAAI,EAAE,IAAI,EAYnC;IAED,kBAAkB;IACX,0BAA0B,EAAE,OAAO,CAAS;IAEnD;;;;OAIG;IACH,SAAS,aAAa,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,sBAAsB;IAWjF,OAAO,EAAE,gBAAgB,CAA2B;IAErD,kBAAkB;IACX,oBAAoB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI;IAIxE,kBAAkB;IACX,uBAAuB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI;IAM3E,gBAAgB,IAAI,IAAI;IAGxB,cAAc,IAAI,IAAI;IAItB;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,IAAI,eAAe;IAE1D,kBAAkB;IACX,UAAU,IAAI,IAAI;IAUzB,kBAAkB;IACX,eAAe,IAAI,IAAI;IAY9B,OAAO,CAAC,oBAAoB;IA6B5B,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,eAAe;IAwBvB,kBAAkB;IACX,eAAe,IAAI,IAAI;IAI9B,kBAAkB;IACX,aAAa,IAAI,IAAI;CAiB/B"}
+{"version":3,"file":"ARenderer.d.ts","sourceRoot":"","sources":["../../../src/core/rendering/ARenderer.ts"],"names":[],"mappings":"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"}

package/dist/core/rendering/primitive/PrimitiveStateDescriptorUtilities.d.ts

@@ -0,0 +1,15 @@
+import { type IPrimitiveStateDescriptor } from "../../../api/index.js";
+/**
+ * A primitive state descriptor with all defaults applied.
+ * @internal
+ */
+export type ResolvedPrimitiveStateDescriptor = Required<IPrimitiveStateDescriptor>;
+/**
+ * Fills in the defaults for every missing field of a primitive state descriptor:
+ * TRIANGLE_LIST topology, BACK culling and CCW front face.
+ * @param desc The descriptor, possibly partial or missing.
+ * @returns A new descriptor with the defaults applied.
+ * @internal
+ */
+export declare function resolvePrimitiveStateDescriptor(desc?: IPrimitiveStateDescriptor): ResolvedPrimitiveStateDescriptor;
+//# sourceMappingURL=PrimitiveStateDescriptorUtilities.d.ts.map

package/dist/core/rendering/primitive/PrimitiveStateDescriptorUtilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrimitiveStateDescriptorUtilities.d.ts","sourceRoot":"","sources":["../../../../src/core/rendering/primitive/PrimitiveStateDescriptorUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,yBAAyB,EAAoB,MAAM,uBAAuB,CAAC;AAE7G;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,gCAAgC,CAMlH"}

package/dist/core/rendering/texture/TextureDescriptorUtilities.d.ts

@@ -1,9 +1,9 @@
 import { type ITextureDescriptor } from "../../../api/index.js";
 /**
- * A texture descriptor with all defaults applied. Only `data` and `blockSize` stay optional.
+ * A texture descriptor with all defaults applied. Only `data`, `blockSize` and `preferredColorSpace` stay optional.
  * @internal
  */
-export type ResolvedTextureDescriptor = Required<Omit<ITextureDescriptor, "data" | "blockSize">> & Pick<ITextureDescriptor, "data" | "blockSize">;
+export type ResolvedTextureDescriptor = Required<Omit<ITextureDescriptor, "data" | "blockSize" | "preferredColorSpace">> & Pick<ITextureDescriptor, "data" | "blockSize" | "preferredColorSpace">;
 /**
  * Fills in the defaults for every missing field of a texture descriptor.
  * @param desc The descriptor, possibly partial or missing.

package/dist/core/rendering/texture/TextureDescriptorUtilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextureDescriptorUtilities.d.ts","sourceRoot":"","sources":["../../../../src/core/rendering/texture/TextureDescriptorUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,kBAAkB,EAA8B,MAAM,uBAAuB,CAAC;AAE3F;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GACjC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC;AAE9G;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,yBAAyB,CAW7F"}
+{"version":3,"file":"TextureDescriptorUtilities.d.ts","sourceRoot":"","sources":["../../../../src/core/rendering/texture/TextureDescriptorUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,kBAAkB,EAA8B,MAAM,uBAAuB,CAAC;AAE3F;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GACjC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,GAAG,qBAAqB,CAAC,CAAC,GAAG,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,GAAG,qBAAqB,CAAC,CAAC;AAE9J;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,yBAAyB,CAY7F"}