ris-framework 0.1.0 → 0.2.0-dev.12

package/dist/api/loaders/obj/ObjParser.d.ts

@@ -0,0 +1,44 @@
+import { ObjMaterialDefinition, type ObjLoadResult, type ObjLoadOptions, type ObjModel } from "./ObjTypes.js";
+/**
+ * Parses .obj models (and their .mtl materials) from text or a URL into plain data.
+ * Engine-independent; uses only `fetch` and `URL`, and creates no GPU resources.
+ * `framework.objLoader` (or the static `ObjLoader.parseAsync`) builds on it.
+ */
+export declare class ObjParser {
+    /**
+     * Parses .mtl text.
+     * @param text The .mtl contents.
+     * @returns The material definitions, in file order.
+     */
+    parseMtl(text: string): ObjMaterialDefinition[];
+    /**
+     * Parses .obj text.
+     * @param text The .obj contents.
+     * @param materials Material definitions to use for `usemtl`, e.g. from {@link parseMtl}. Default none.
+     * @returns The geometry, materials and raw data.
+     */
+    fromText(text: string, materials?: ObjMaterialDefinition[]): ObjLoadResult;
+    /**
+     * Loads an .obj file and the .mtl files it references with `mtllib`.
+     * A missing or failing .mtl is skipped (logged as a warning); the model still loads with white vertex colours.
+     * @param filePath The .obj URL.
+     * @param options Optional: how to resolve `mtllib` names, or skip materials.
+     * @returns The geometry, materials and raw data.
+     */
+    loadAsync(filePath: string, options?: ObjLoadOptions): Promise<ObjLoadResult>;
+    /**
+     * Loads an .obj file (and its .mtl files) into an {@link ObjModel}: the geometry plus one sub mesh per `usemtl`
+     * range with its resolved material definition.
+     * @param filePath The .obj URL.
+     * @param options Optional: how to resolve `mtllib` names, or skip materials.
+     * @returns The model.
+     */
+    parseAsync(filePath: string, options?: ObjLoadOptions): Promise<ObjModel>;
+    /**
+     * Turns a load result into an {@link ObjModel}.
+     * @param result The load result.
+     * @returns The model.
+     */
+    static toModel(result: ObjLoadResult): ObjModel;
+}
+//# sourceMappingURL=ObjParser.d.ts.map

package/dist/api/loaders/obj/ObjParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjParser.d.ts","sourceRoot":"","sources":["../../../../src/api/loaders/obj/ObjParser.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,qBAAqB,EAErB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,QAAQ,EAEhB,MAAM,eAAe,CAAC;AAiBvB;;;;GAIG;AACH,qBAAa,SAAS;IAElB;;;;OAIG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAqEtD;;;;;OAKG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,qBAAqB,EAAO,GAAG,aAAa;IAiHrF;;;;;;OAMG;IACU,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAyC1F;;;;;;OAMG;IACU,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItF;;;;OAIG;WACW,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ;CAYzD"}

package/dist/api/loaders/obj/ObjTypes.d.ts

@@ -0,0 +1,119 @@
+/** An RGB colour as read from an .mtl file, each channel usually in 0..1. */
+export type ObjColor = [r: number, g: number, b: number];
+/**
+ * A material definition read from an .mtl file (`newmtl` block).
+ * This is plain data, not a GPU material; map it onto a framework material yourself.
+ */
+export declare class ObjMaterialDefinition {
+    name: string;
+    /**
+     * The constructor.
+     * @param name The material name from `newmtl`.
+     */
+    constructor(name: string);
+    /** Ambient colour (`Ka`). */
+    ambientColor?: ObjColor;
+    /** Diffuse colour (`Kd`). */
+    diffuseColor?: ObjColor;
+    /** Specular colour (`Ks`). */
+    specularColor?: ObjColor;
+    /** Emissive colour (`Ke`). */
+    emissiveColor?: ObjColor;
+    /** Specular exponent (`Ns`). */
+    specularExponent?: number;
+    /** Opacity, from `d`, or `1 - Tr` when only `Tr` is given. */
+    opacity?: number;
+    /** Optical density / index of refraction (`Ni`). */
+    opticalDensity?: number;
+    /** Illumination model (`illum`). */
+    illuminationModel?: number;
+    /**
+     * Texture maps by statement name, e.g. `map_Kd`, `map_Ks`, `map_Bump`, `bump`, `disp`, `decal`, `refl`.
+     * The value is the file name (last token); map options such as `-bm 1` are kept in {@link mapOptions}.
+     */
+    maps: Record<string, string>;
+    /** Options written before the file name of a map statement, e.g. `{ map_Bump: "-bm 0.5" }`. */
+    mapOptions: Record<string, string>;
+}
+/** A run of triangles in the geometry's index buffer drawn with one material (`usemtl`). */
+export interface ObjMaterialRange {
+    /** The material name from `usemtl`, or undefined for faces before any `usemtl`. */
+    readonly materialName?: string;
+    /** First index in `geometry.indices`. */
+    readonly indexStart: number;
+    /** Number of indices (3 per triangle). */
+    readonly indexCount: number;
+}
+/** The OBJ data exactly as listed in the file, before expansion. */
+export interface ObjRawData {
+    /** `v` values, 3 per position. */
+    readonly positions: number[];
+    /** `vt` values, 2 per texture coordinate (a third `w` value is dropped). */
+    readonly textureCoords: number[];
+    /** `vn` values, 3 per normal. */
+    readonly normals: number[];
+    /**
+     * Triangulated face corners as zero-based `position, texcoord, normal` triplets.
+     * A missing texcoord or normal is -1.
+     */
+    readonly faceIndices: number[];
+}
+/**
+ * Renderable geometry as plain data: one vertex per unique position/texcoord/normal/material corner.
+ * Has no dependency on any engine; convert it to engine geometry yourself.
+ */
+export interface ObjGeometryDefinition {
+    /** Positions, 3 per vertex. */
+    readonly positions: number[];
+    /** Texture coordinates, 2 per vertex (0,0 when the corner has none). */
+    readonly textureCoords: number[];
+    /** Normals, 3 per vertex (0,0,0 when the corner has none). */
+    readonly normals: number[];
+    /** RGBA colours, 4 per vertex: the material's `Kd` with alpha from `d`, white without a material. */
+    readonly colors: number[];
+    /** Triangle indices, 3 per triangle. */
+    readonly indices: number[];
+    /** Number of vertices (`positions.length / 3`). */
+    readonly vertexCount: number;
+    /** Index ranges per `usemtl`, in file order. */
+    readonly materialRanges: ObjMaterialRange[];
+}
+/** The result of loading an OBJ file. */
+export interface ObjLoadResult {
+    /** The renderable geometry as plain data. */
+    readonly geometry: ObjGeometryDefinition;
+    /** Material definitions from the referenced .mtl files. Empty when there is no `mtllib` or it could not be loaded. */
+    readonly materials: ObjMaterialDefinition[];
+    /** Library file names from `mtllib`, in order. */
+    readonly materialLibraries: string[];
+    /** The raw OBJ lists. */
+    readonly raw: ObjRawData;
+}
+/** Options for {@link ObjParser.loadAsync} and `ObjLoader.loadAsync`. */
+export interface ObjLoadOptions {
+    /**
+     * Maps an `mtllib` name to the URL to fetch.
+     * By default, the name is resolved relative to the OBJ URL, which fails for `data:` or `blob:` URLs
+     * (for example a bundler-inlined asset); use this to point at the real file.
+     */
+    resolveMaterialUrl?: (libraryName: string) => string;
+    /** Skip fetching .mtl files. */
+    ignoreMaterials?: boolean;
+}
+/** One `usemtl` range of an {@link ObjModel}: its index range and resolved material definition. */
+export interface ObjSubMesh {
+    /** The material name from `usemtl`, or undefined for faces before any `usemtl`. */
+    readonly materialName?: string;
+    /** The material definition from the .mtl files, or undefined when there is none. */
+    readonly material?: ObjMaterialDefinition;
+    /** First index in `geometry.indices`. */
+    readonly indexStart: number;
+    /** Number of indices. */
+    readonly indexCount: number;
+}
+/** A parsed OBJ model (C# `ObjModel`): geometry, sub meshes and material definitions. No GPU resources. */
+export interface ObjModel extends ObjLoadResult {
+    /** One entry per `usemtl` range, in file order. */
+    readonly subMeshes: ObjSubMesh[];
+}
+//# sourceMappingURL=ObjTypes.d.ts.map

package/dist/api/loaders/obj/ObjTypes.d.ts.map

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

package/dist/api/loaders/obj/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./ObjTypes.js";
+export * from "./ObjParser.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/loaders/obj/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/loaders/obj/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/api/material/ForwardBlinnPhongMaterial.d.ts

@@ -0,0 +1,138 @@
+import type { IRenderableMesh } from "../meshes/IRenderableMesh.js";
+import type { ITexture2D } from "../rendering/texture/ITexture2D.js";
+import type { ISampler } from "../rendering/sampler/ISampler.js";
+import { GeometryFormat } from "../geometry/GeometryFormat.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
+import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
+import type { IFramework } from "../IFramework.js";
+import { Color } from "../data/Color.js";
+import type { IPrimitiveState } from "../rendering/primitive/IPrimitiveState.js";
+import type { ICamera } from "../camera/ICamera.js";
+import type { AmbientLight } from "../lights/AmbientLight.js";
+import type { DirectionalLight } from "../lights/DirectionalLight.js";
+import type { PointLight } from "../lights/PointLight.js";
+import type { ICameraMaterial } from "./ICameraMaterial.js";
+import type { ILightsMaterial } from "./ILightsMaterial.js";
+/**
+ * The additional material config options.
+ * @public
+ **/
+export declare class ForwardBlinnPhongMaterialDescriptor {
+    /** The primitive state. */
+    primitiveState?: IPrimitiveState;
+    /** The projection view buffer. */
+    projectionViewBuffer: IUniformBuffer;
+    /** The camera position buffer. */
+    cameraPositionBuffer: IUniformBuffer;
+}
+/**
+ * The Blinn-Phong material with forward calculated lighting.
+ * @public
+ */
+export declare class ForwardBlinnPhongMaterial implements ICameraMaterial, ILightsMaterial {
+    /** The directional light slots of the material's lights buffer and shader. */
+    static readonly MAX_DIRECTIONAL_LIGHTS = 3;
+    /** The point light slots of the material's lights buffer and shader. */
+    static readonly MAX_POINT_LIGHTS = 5;
+    private readonly _framework;
+    private readonly _lightsBuffer;
+    private _diffuseColorCache;
+    private _ambientColorCache;
+    private _specularColorCache;
+    private _shininessCache;
+    private _materialData;
+    /** Created when the model buffer is assigned (the pipeline requires one). */
+    private _pipeline?;
+    private readonly _primitiveState?;
+    /** Texture and sampler set before the pipeline exists; applied when it is created. */
+    private _pendingTexture?;
+    private _pendingSampler?;
+    private _samplerSet;
+    private _projectionViewBuffer;
+    private _camera?;
+    private _cameraPositionBuffer;
+    private _materialBuffer;
+    private _modelBuffer?;
+    /**
+     * The constructor.
+     * @param framework The framework.
+     * @param descriptor The material descriptor. Its projection view and camera position buffers are shared and are not disposed by this material.
+     * @throws Error when `descriptor`, `descriptor.projectionViewBuffer` or `descriptor.cameraPositionBuffer` is missing.
+     */
+    constructor(framework: IFramework, descriptor: ForwardBlinnPhongMaterialDescriptor);
+    /** Creates the pipeline with the current bindings. */
+    private _createPipeline;
+    /**
+     * The ambient color of this material.
+     * Alpha is ignored. By default, it is (0.1,0.1,0.1).
+     */
+    ambientColor: Color;
+    /**
+     * The diffuse color of this material.
+     * Alpha is ignored. By default, it is (0.8,0.8,0.8).
+     */
+    diffuseColor: Color;
+    /**
+     * The specular color of this material (MTL `Ks`).
+     * Alpha is ignored. By default, it is (0.5,0.5,0.5).
+     */
+    specularColor: Color;
+    /**
+     * The specular exponent (MTL `Ns`). Higher values give smaller, sharper highlights. By default, it is 32.
+     */
+    shininess: number;
+    /**
+     * The camera. Setting it binds the camera's projection view and position buffers to the pipeline
+     * (used by the scene when its camera changes). Setting undefined keeps the last bound buffers.
+     * Undefined until set: the constructor only takes the buffers.
+     */
+    get camera(): ICamera | undefined;
+    /** @inheritDoc */
+    set camera(camera: ICamera | undefined);
+    /** @inheritDoc Defaults to a black ambient light; a `Scene` assigns its active ambient light. */
+    get ambientLight(): AmbientLight;
+    set ambientLight(value: AmbientLight);
+    /** @inheritDoc Only the first 3 are used. A `Scene` assigns its own list. */
+    get directionalLights(): DirectionalLight[];
+    set directionalLights(value: DirectionalLight[]);
+    /** @inheritDoc Only the first 5 are used. A `Scene` assigns its own list. */
+    get pointLights(): PointLight[];
+    set pointLights(value: PointLight[]);
+    /**
+     * The texture to inspect.
+     */
+    get diffuseTexture(): ITexture2D;
+    /**
+     * The texture to inspect.
+     */
+    set diffuseTexture(value: ITexture2D);
+    /**
+     * The texture sampler.
+     */
+    get diffuseTextureSampler(): ISampler | undefined;
+    /**
+     * The texture sampler.
+     */
+    set diffuseTextureSampler(value: ISampler | undefined);
+    /**
+     * The model buffer (std140 `mat4`). Owned by the mesh, which assigns it before drawing; never disposed by this material.
+     * Undefined until assigned: rendering without one throws.
+     */
+    get modelBuffer(): IUniformBuffer | undefined;
+    /** Binds the model buffer to the pipeline. */
+    set modelBuffer(value: IUniformBuffer | undefined);
+    /**
+     * The geometry format.
+     */
+    readonly geometryFormat = GeometryFormat.POS3_COLOR4_TEXTURECOORDS2_NORMAL3;
+    /** @inheritDoc */
+    beforeRender(): void;
+    /** @inheritDoc */
+    renderMesh(mesh: IRenderableMesh): void;
+    /** @inheritDoc */
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer, indicesCount?: number, indicesOffset?: number): void;
+    /** @inheritDoc */
+    dispose(): void;
+}
+//# sourceMappingURL=ForwardBlinnPhongMaterial.d.ts.map

package/dist/api/material/ForwardBlinnPhongMaterial.d.ts.map

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

package/dist/api/material/ICameraMaterial.d.ts

@@ -0,0 +1,18 @@
+import type { IMaterial } from "./IMaterial.js";
+import type { ICamera } from "../camera/ICamera.js";
+/**
+ * A material that renders with a camera (unlit, Blinn-Phong, inspect mips).
+ * A `Scene` assigns its camera to these materials in `scene.update()`.
+ * @public
+ */
+export interface ICameraMaterial extends IMaterial {
+    /** The camera. Setting it binds the camera's buffers. */
+    camera?: ICamera;
+}
+/**
+ * Whether a material is an {@link ICameraMaterial}.
+ * @param material The material.
+ * @public
+ */
+export declare function isCameraMaterial(material: IMaterial | undefined): material is ICameraMaterial;
+//# sourceMappingURL=ICameraMaterial.d.ts.map

package/dist/api/material/ICameraMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICameraMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/ICameraMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAE9C,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,IAAI,eAAe,CAE7F"}

package/dist/api/material/ILightsMaterial.d.ts

@@ -0,0 +1,26 @@
+import type { IMaterial } from "./IMaterial.js";
+import type { AmbientLight } from "../lights/AmbientLight.js";
+import type { DirectionalLight } from "../lights/DirectionalLight.js";
+import type { PointLight } from "../lights/PointLight.js";
+/**
+ * A material lit by an ambient light, directional lights and point lights (Blinn-Phong).
+ * The material owns its lights buffer and uploads it only when the lights changed.
+ * A `Scene` hands each lights material its active ambient light and its own light lists (the same arrays, not copies)
+ * in `scene.update()`, so lights added to the scene reach every lit material.
+ * @public
+ */
+export interface ILightsMaterial extends IMaterial {
+    /** The ambient light. */
+    ambientLight: AmbientLight;
+    /** The directional lights. The list is used by reference and may be edited; extra lights beyond the slots are ignored. */
+    directionalLights: DirectionalLight[];
+    /** The point lights. The list is used by reference and may be edited; extra lights beyond the slots are ignored. */
+    pointLights: PointLight[];
+}
+/**
+ * Whether a material is an {@link ILightsMaterial}.
+ * @param material The material.
+ * @public
+ */
+export declare function isLightsMaterial(material: IMaterial | undefined): material is ILightsMaterial;
+//# sourceMappingURL=ILightsMaterial.d.ts.map

package/dist/api/material/ILightsMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILightsMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/ILightsMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAE9C,yBAAyB;IACzB,YAAY,EAAE,YAAY,CAAC;IAE3B,0HAA0H;IAC1H,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAEtC,oHAAoH;IACpH,WAAW,EAAE,UAAU,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,IAAI,eAAe,CAE7F"}

package/dist/api/material/IMaterial.d.ts

@@ -1,35 +1,38 @@
-import { mat4 } from "gl-matrix";
 import type { IDisposable } from "../core/IDisposable.js";
 import { GeometryFormat } from "../geometry/GeometryFormat.js";
-import type { IMesh } from "../meshes/IMesh.js";
+import type { IRenderableMesh } from "../meshes/IRenderableMesh.js";
 import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
 import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
 /**
  * The material interface.
+ * @public
  */
 export interface IMaterial extends IDisposable {
     /**
-     * The model matrix.
-     */
-    modelMatrix: mat4;
-    /**
-     * The geometry format required by the material.
+     * The model buffer (std140 `mat4`) for materials that use one (unlit, Blinn-Phong, inspect mips).
+     * A mesh owns it and assigns it before drawing, like the scene assigns its camera; materials never dispose it.
+     * Materials without the property (e.g. the sprite material) are left alone.
      */
+    modelBuffer?: IUniformBuffer;
+    /** The geometry format required by the material.*/
     readonly geometryFormat: GeometryFormat;
     /**
      * Called before rendering.
      */
     beforeRender(): void;
     /**
-     * Renders the material.
+     * Renders the mesh with this material, honouring the mesh's index range.
      * @param mesh - The mesh.
      */
-    renderMesh(mesh: IMesh): void;
+    renderMesh(mesh: IRenderableMesh): void;
     /**
      * Renders the material.
      * @param vertexBuffer - The vertex buffer.
      * @param indexBuffer - The index buffer.
+     * @param indicesCount - The number of indices to draw. -1 or undefined draws all.
+     * @param indicesOffset - The first index to draw. Defaults to 0.
      */
-    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer): void;
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer, indicesCount?: number, indicesOffset?: number): void;
 }
 //# sourceMappingURL=IMaterial.d.ts.map

package/dist/api/material/IMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/IMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,WAAW;IAE1C;;OAEG;IACH,WAAW,EAAE,IAAI,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IAE9B;;;;OAIG;IACH,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;CAExE"}
+{"version":3,"file":"IMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/IMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,WAAW;IAE1C;;;;OAIG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAE7B,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAExC;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAEvH"}

package/dist/api/material/IMaterialFactory.d.ts

@@ -1,5 +1,7 @@
 import { InspectTextureMipsMaterial } from "./InspectTextureMipsMaterial.js";
+import type { SpriteMaterial, SpriteMaterialDescriptor } from "./SpriteMaterial.js";
 import { UnlitMaterial, UnlitMaterialDescriptor } from "./UnlitMaterial.js";
+import type { ForwardBlinnPhongMaterial, ForwardBlinnPhongMaterialDescriptor } from "./ForwardBlinnPhongMaterial.js";
 /**
  * The material factory.
  */
@@ -11,9 +13,22 @@ export interface IMaterialFactory {
     createInspectTextureMipsMaterial(): InspectTextureMipsMaterial;
     /**
      * Creates an unlit material.
-     * @param config The optional additional configuration options for material, such as rendering options.
+     * @param descriptor The optional additional configuration options for material, such as rendering options.
      * @returns The Unlit Material.
      */
-    createUnlitMaterial(config?: UnlitMaterialDescriptor): UnlitMaterial;
+    createUnlitMaterial(descriptor?: UnlitMaterialDescriptor): UnlitMaterial;
+    /**
+     * Creates a sprite material.
+     * @param descriptor The sprite material descriptor with projection view buffer, texture and sampler.
+     * @returns The Sprite Material.
+     */
+    createSpriteMaterial(descriptor: SpriteMaterialDescriptor): SpriteMaterial;
+    /**
+     * Creates a Blinn-Phong material with forward calculated lighting.
+     * @param descriptor The configuration: the required projection view and camera position buffers, plus optional lights buffer and primitive state.
+     * @throws Error when a required buffer is missing.
+     * @returns The Forward Blinn-Phong Material.
+     */
+    createForwardBlinnPhongMaterial(descriptor: ForwardBlinnPhongMaterialDescriptor): ForwardBlinnPhongMaterial;
 }
 //# sourceMappingURL=IMaterialFactory.d.ts.map

package/dist/api/material/IMaterialFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IMaterialFactory.d.ts","sourceRoot":"","sources":["../../../src/api/material/IMaterialFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAC,aAAa,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE7B;;;OAGG;IACH,gCAAgC,IAAI,0BAA0B,CAAC;IAE/D;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAAC;CACxE"}
+{"version":3,"file":"IMaterialFactory.d.ts","sourceRoot":"","sources":["../../../src/api/material/IMaterialFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAC,cAAc,EAAE,wBAAwB,EAAC,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAC,aAAa,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAC,yBAAyB,EAAE,mCAAmC,EAAC,MAAM,gCAAgC,CAAC;AAEnH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE7B;;;OAGG;IACH,gCAAgC,IAAI,0BAA0B,CAAC;IAE/D;;;;OAIG;IACH,mBAAmB,CAAC,UAAU,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAAC;IAEzE;;;;OAIG;IACH,oBAAoB,CAAC,UAAU,EAAE,wBAAwB,GAAG,cAAc,CAAC;IAE3E;;;;;OAKG;IACH,+BAA+B,CAAC,UAAU,EAAE,mCAAmC,GAAG,yBAAyB,CAAC;CAC/G"}

package/dist/api/material/InspectTextureMipsMaterial.d.ts

@@ -1,8 +1,8 @@
-import type { IMesh } from "../meshes/IMesh.js";
+import type { IRenderableMesh } from "../meshes/IRenderableMesh.js";
 import type { ITexture2D } from "../rendering/texture/ITexture2D.js";
 import type { ISampler } from "../rendering/sampler/ISampler.js";
-import { mat4 } from "gl-matrix";
 import { GeometryFormat } from "../geometry/GeometryFormat.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
 import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
 import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
 import type { IFramework } from "../IFramework.js";
@@ -12,12 +12,18 @@ import type { IFramework } from "../IFramework.js";
 export declare class InspectTextureMipsMaterial {
     private readonly _framework;
     private _mipLevel;
-    private _pipeline;
+    /** Created when the model buffer is assigned (the pipeline requires one). */
+    private _pipeline?;
+    /** Texture and sampler set before the pipeline exists; applied when it is created. */
+    private _pendingTexture?;
+    private _pendingSampler?;
+    private _samplerSet;
     private _projectionViewBuffer;
     private _fragmentDataBuffer;
-    private _modelBuffer;
-    private _previousModelMatrix;
+    private _modelBuffer?;
     constructor(framework: IFramework);
+    /** Creates the pipeline with the current bindings. */
+    private _createPipeline;
     /**
      * The mip level to inspect.
      */
@@ -39,9 +45,12 @@ export declare class InspectTextureMipsMaterial {
      */
     set textureSampler(value: ISampler | undefined);
     /**
-     * The model matrix.
+     * The model buffer (std140 `mat4`). Owned by the mesh, which assigns it before drawing; never disposed by this material.
+     * Undefined until assigned: rendering without one throws.
      */
-    modelMatrix: mat4;
+    get modelBuffer(): IUniformBuffer | undefined;
+    /** Binds the model buffer to the pipeline. */
+    set modelBuffer(value: IUniformBuffer | undefined);
     /**
      * The geometry format.
      */
@@ -49,9 +58,9 @@ export declare class InspectTextureMipsMaterial {
     /** @inheritDoc */
     beforeRender(): void;
     /** @inheritDoc */
-    renderMesh(mesh: IMesh): void;
+    renderMesh(mesh: IRenderableMesh): void;
     /** @inheritDoc */
-    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer): void;
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer, indicesCount?: number, indicesOffset?: number): void;
     /** @inheritDoc */
     dispose(): void;
 }

package/dist/api/material/InspectTextureMipsMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InspectTextureMipsMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/InspectTextureMipsMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;GAEG;AACH,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,qBAAqB,CAAiB;IAC9C,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,oBAAoB,CAAiB;gBAE1B,SAAS,EAAE,UAAU;IAcxC;;OAEG;IACI,QAAQ,EAAE,MAAM,CAAK;IAE5B;;OAEG;IACH,IAAW,OAAO,IAAI,UAAU,CAE/B;IAED;;OAEG;IACH,IAAW,OAAO,CAAC,KAAK,EAAE,UAAU,EAEnC;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,QAAQ,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,IAAW,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAEpD;IAED;;OAEG;IACI,WAAW,EAAE,IAAI,CAAiB;IAEzC;;OAEG;IACH,SAAgB,cAAc,6CAA6C;IAE3E,kBAAkB;IACX,YAAY,IAAI,IAAI;IAY3B,kBAAkB;IACX,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAIpC,kBAAkB;IACX,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,GAAG,IAAI;IAI3E,kBAAkB;IACX,OAAO,IAAI,IAAI;CAMzB"}
+{"version":3,"file":"InspectTextureMipsMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/InspectTextureMipsMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;GAEG;AACH,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,SAAS,CAAO;IACxB,6EAA6E;IAC7E,OAAO,CAAC,SAAS,CAAC,CAAoC;IACtD,sFAAsF;IACtF,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,eAAe,CAAC,CAAW;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAAiB;IAC9C,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAiB;gBAEnB,SAAS,EAAE,UAAU;IAQxC,sDAAsD;IACtD,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACI,QAAQ,EAAE,MAAM,CAAK;IAE5B;;OAEG;IACH,IAAW,OAAO,IAAI,UAAU,CAE/B;IAED;;OAEG;IACH,IAAW,OAAO,CAAC,KAAK,EAAE,UAAU,EAKnC;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,QAAQ,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,IAAW,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAMpD;IAED;;;OAGG;IACH,IAAW,WAAW,IAAI,cAAc,GAAG,SAAS,CAEnD;IAED,8CAA8C;IAC9C,IAAW,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,EAavD;IAED;;OAEG;IACH,SAAgB,cAAc,6CAA6C;IAE3E,kBAAkB;IACX,YAAY,IAAI,IAAI;IAO3B,kBAAkB;IACX,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAI9C,kBAAkB;IACX,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAO1H,kBAAkB;IACX,OAAO,IAAI,IAAI;CAMzB"}

package/dist/api/material/MaterialFactory.d.ts

@@ -1,7 +1,9 @@
 import { InspectTextureMipsMaterial } from "./InspectTextureMipsMaterial.js";
 import type { IFramework } from "../IFramework.js";
 import type { IMaterialFactory } from "./IMaterialFactory.js";
+import { SpriteMaterial, type SpriteMaterialDescriptor } from "./SpriteMaterial.js";
 import { UnlitMaterial, UnlitMaterialDescriptor } from "./UnlitMaterial.js";
+import { ForwardBlinnPhongMaterial, type ForwardBlinnPhongMaterialDescriptor } from "./ForwardBlinnPhongMaterial.js";
 /**
  * The material factory.
  */
@@ -16,5 +18,9 @@ export declare class MaterialFactory implements IMaterialFactory {
     createInspectTextureMipsMaterial(): InspectTextureMipsMaterial;
     /** @inheritDoc */
     createUnlitMaterial(descriptor?: UnlitMaterialDescriptor): UnlitMaterial;
+    /** @inheritDoc */
+    createSpriteMaterial(descriptor: SpriteMaterialDescriptor): SpriteMaterial;
+    /** @inheritDoc */
+    createForwardBlinnPhongMaterial(descriptor: ForwardBlinnPhongMaterialDescriptor): ForwardBlinnPhongMaterial;
 }
 //# sourceMappingURL=MaterialFactory.d.ts.map

package/dist/api/material/MaterialFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MaterialFactory.d.ts","sourceRoot":"","sources":["../../../src/api/material/MaterialFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAC,aAAa,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAMjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ9C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAG1D,kBAAkB;IACX,gCAAgC,IAAI,0BAA0B;IAIrE,kBAAkB;IACX,mBAAmB,CAAC,UAAU,CAAC,EAAG,uBAAuB,GAAG,aAAa;CAGnF"}
+{"version":3,"file":"MaterialFactory.d.ts","sourceRoot":"","sources":["../../../src/api/material/MaterialFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAC,cAAc,EAAE,KAAK,wBAAwB,EAAC,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAC,aAAa,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAC,yBAAyB,EAAE,KAAK,mCAAmC,EAAC,MAAM,gCAAgC,CAAC;AAEnH;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAMjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ9C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAG1D,kBAAkB;IACX,gCAAgC,IAAI,0BAA0B;IAIrE,kBAAkB;IACX,mBAAmB,CAAC,UAAU,CAAC,EAAG,uBAAuB,GAAG,aAAa;IAIhF,kBAAkB;IACX,oBAAoB,CAAC,UAAU,EAAE,wBAAwB,GAAG,cAAc;IAIjF,kBAAkB;IACX,+BAA+B,CAAC,UAAU,EAAE,mCAAmC,GAAG,yBAAyB;CAGrH"}

package/dist/api/material/SpriteMaterial.d.ts

@@ -0,0 +1,51 @@
+import type { GeometryFormat } from "../geometry/GeometryFormat.js";
+import type { IRenderableMesh } from "../meshes/IRenderableMesh.js";
+import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
+import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+import type { ITexture2D } from "../rendering/texture/ITexture2D.js";
+import type { ISampler } from "../rendering/sampler/ISampler.js";
+import type { IFramework } from "../IFramework.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
+import type { IMaterial } from "./IMaterial.js";
+/** The sprite material descriptor. */
+export interface SpriteMaterialDescriptor {
+    /** The projection view buffer. Shared, it is not disposed by the material. */
+    projectionViewBuffer: IUniformBuffer;
+    /** The sprite texture. */
+    texture: ITexture2D;
+    /** The texture sampler. */
+    sampler: ISampler;
+}
+/**
+ * The sprite material.
+ */
+export declare class SpriteMaterial implements IMaterial {
+    private readonly _renderPipeline;
+    /**
+     * The constructor.
+     * @param framework - The framework.
+     * @param descriptor - The sprite material descriptor.
+     */
+    constructor(framework: IFramework, descriptor: SpriteMaterialDescriptor);
+    /** @inheritDoc */
+    get geometryFormat(): GeometryFormat;
+    /** The sprite texture. */
+    get texture(): ITexture2D;
+    /** The sprite texture. */
+    set texture(value: ITexture2D);
+    /** @inheritDoc */
+    beforeRender(): void;
+    /** @inheritDoc */
+    renderMesh(mesh: IRenderableMesh): void;
+    /**
+     * Renders the material.
+     * @param vertexBuffer - The vertex buffer.
+     * @param indexBuffer - The index buffer.
+     * @param indicesCount - The number of indices to draw. If -1 draws all indices.
+     * @param indicesOffset - Indices offset. Defaults to 0.
+     */
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer, indicesCount?: number, indicesOffset?: number): void;
+    /** @inheritDoc */
+    dispose(): void;
+}
+//# sourceMappingURL=SpriteMaterial.d.ts.map

package/dist/api/material/SpriteMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/SpriteMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,sCAAsC;AACtC,MAAM,WAAW,wBAAwB;IAErC,8EAA8E;IAC9E,oBAAoB,EAAE,cAAc,CAAC;IAErC,0BAA0B;IAC1B,OAAO,EAAE,UAAU,CAAC;IAEpB,2BAA2B;IAC3B,OAAO,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,cAAe,YAAW,SAAS;IAE5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IAExD;;;;OAIG;gBACgB,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,wBAAwB;IAM9E,kBAAkB;IAClB,IAAW,cAAc,IAAI,cAAc,CAE1C;IAED,0BAA0B;IAC1B,IAAW,OAAO,IAAI,UAAU,CAE/B;IAED,0BAA0B;IAC1B,IAAW,OAAO,CAAC,KAAK,EAAE,UAAU,EAEnC;IAED,kBAAkB;IACX,YAAY,IAAI,IAAI;IAI3B,kBAAkB;IACX,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAI9C;;;;;;OAMG;IACI,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAI1H,kBAAkB;IACX,OAAO,IAAI,IAAI;CAGzB"}