@woosh/meep-engine 3.32.0 → 3.34.0

package/editor/prototypeEditorShell.js

@@ -1,186 +1,190 @@
-import './style/editor.scss';
-
-import Vector2 from "../src/core/geom/Vector2.js";
-import { GameAssetType } from "../src/engine/asset/GameAssetType.js";
-import { ArrayBufferLoader } from "../src/engine/asset/loaders/ArrayBufferLoader.js";
-import {
-    GLTFSceneBundleAssetLoader
-} from "../src/engine/asset/loaders/GLTFSceneBundleAssetLoader.js";
-import {
-    USDSceneBundleAssetLoader
-} from "../src/engine/asset/loaders/USDSceneBundleAssetLoader.js";
-import { ImageBitmapAssetLoader } from "../src/engine/asset/loaders/image/ImageBitmapAssetLoader.js";
-import { ImageRGBADataLoader } from "../src/engine/asset/loaders/image/ImageRGBADataLoader.js";
-import { load_model_scene_bundle } from "../src/engine/asset/load_model_scene_bundle.js";
-import { ParentEntitySystem } from "../src/engine/ecs/parent/ParentEntitySystem.js";
-import { obtainTerrain } from "../src/engine/ecs/terrain/util/obtainTerrain.js";
-import { populateEngineSerializationRegistry } from "../src/engine/ecs/storage/populateEngineSerializationRegistry.js";
-import { TransformAttachmentSystem } from "../src/engine/ecs/transform-attachment/TransformAttachmentSystem.js";
-import { EngineHarness } from "../src/engine/EngineHarness.js";
-import TopDownCameraController from "../src/engine/graphics/ecs/camera/topdown/TopDownCameraController.js";
-import { DebugDrawSystem } from "../src/engine/graphics3/DebugDrawSystem.js";
-import {
-    HighlightOutlineSystem
-} from "../src/engine/graphics3/HighlightOutlineSystem.js";
-import { MeshSystem } from "../src/engine/graphics3/MeshSystem.js";
-import {
-    ShadedGeometryHighlightSystem
-} from "../src/engine/graphics/ecs/highlight/system/ShadedGeometryHighlightSystem.js";
-import {
-    SGMeshHighlightSystem
-} from "../src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshHighlightSystem.js";
-import {
-    ShadedGeometrySystem
-} from "../src/engine/graphics3/ShadedGeometrySystem.js";
-import { ParticleEmitterSystem } from "../src/engine/graphics3/ParticleEmitterSystem.js";
-import { enableEditor } from "./enableEditor.js";
-
-/**
- * Point the camera at the middle of the terrain, standing off by its own extent.
- *
- * The harness anchors terrain at the world origin and aims the camera at the origin too,
- * so the default view sits on the terrain's corner with three quadrants of empty space —
- * and every orbit pivots on that corner. The editor camera inherits this state when it
- * takes over the scene's active camera.
- *
- * Standing off by the terrain's extent frames most of it while keeping the far corners
- * inside the camera's clip range; the rest is a wheel away.
- *
- * @param {Engine} engine
- * @param {Terrain} terrain
- */
-function frameTerrain(engine, terrain) {
-    const world_x = terrain.size.x * terrain.gridScale;
-    const world_y = terrain.size.y * terrain.gridScale;
-
-    engine.entityManager.dataset.traverseComponents(TopDownCameraController, controller => {
-        controller.target.set(world_x / 2, 0, world_y / 2);
-        controller.distance = Math.max(world_x, world_y);
-    });
-}
-
-/**
- * The model loaders — the same split the game's graphics profile makes, and for the same reason: a
- * model is the one asset whose loaded form *is* the renderer's own representation.
- *
- * @param {EngineConfiguration} config
- */
-function addModelLoaders(config) {
-    const loader = new GLTFSceneBundleAssetLoader();
-
-    config.addLoader(GameAssetType.ModelGLTF, loader);
-    config.addLoader(GameAssetType.ModelGLTF_JSON, loader);
-
-    // `.usd`, `.usda` and `.usdz` all arrive under the one type — see `GameAssetType.ModelUSD`
-    config.addLoader(GameAssetType.ModelUSD, new USDSceneBundleAssetLoader());
-
-    // `load_gltf` asks the asset manager for each of a model's images rather than fetching them
-    // itself (D34), so a shell without this loader loads geometry and no textures
-    config.addLoader(GameAssetType.ImageBitmap, new ImageBitmapAssetLoader());
-}
-
-/**
- * The systems that talk to the renderer.
- *
- * @param {Engine} engine
- * @returns {Promise}
- */
-async function addGraphicsSystems(engine) {
-    const em = engine.entityManager;
-
-    const meshes = new MeshSystem(
-        engine.graphics,
-        EngineHarness.shadeScene(engine),
-        url => load_model_scene_bundle(engine.assetManager, url)
-    );
-
-    await em.addSystem(meshes);
-
-    // a model with neither skin nor clip becomes entities, and its primitives are drawn by the
-    // system that owns primitives (D47)
-    await em.addSystem(new ShadedGeometrySystem(engine.graphics, EngineHarness.shadeScene(engine)));
-
-    /*
-     One outline pass and both of its sources, because the editor offers a `Highlight` editor and
-     either kind of thing can be carrying the component: a model placed from the mesh library is an
-     `SGMesh`, and anything built in place is a `ShadedGeometry`. The pass is registered once and
-     draws for both — a pass per kind would read the whole visibility buffer once per kind, and the
-     last would paint over the rest.
-    */
-    const outline = new HighlightOutlineSystem(engine.graphics);
-
-    await em.addSystem(outline);
-    await em.addSystem(new SGMeshHighlightSystem(outline, meshes));
-    await em.addSystem(new ShadedGeometryHighlightSystem(outline));
-
-    await em.addSystem(new ParticleEmitterSystem(engine.graphics, engine.assetManager));
-
-    // the editor's selection box is the debug-draw pass's first consumer (V5)
-    await em.addSystem(new DebugDrawSystem(engine.graphics));
-}
-
-/**
- * Standalone editor shell harness: engine + terrain + lights + camera, the systems the
- * editor tooling relies on, a seeded mesh library, and the editor enabled from the start.
- *
- * @returns {Promise<{engine: Engine, editor: Editor, editorControl: object, terrain: Terrain}>}
- */
-async function main() {
-    const harness = new EngineHarness();
-
-    const engine = await harness.initialize({
-        configuration(config) {
-            addModelLoaders(config);
-
-            config.addLoader(GameAssetType.ArrayBuffer, new ArrayBufferLoader());
-            config.addLoader(GameAssetType.Image, new ImageRGBADataLoader());
-        }
-    });
-
-    populateEngineSerializationRegistry(engine.binarySerializationRegistry);
-
-    const em = engine.entityManager;
-
-    await addGraphicsSystems(engine);
-
-    await em.addSystem(new TransformAttachmentSystem(engine));
-    await em.addSystem(new ParentEntitySystem());
-
-    await EngineHarness.buildBasics({
-        engine,
-        terrainSize: new Vector2(32, 32),
-        enableWater: false,
-        cameraController: false,
-        pitch: 0.9
-    });
-
-    // the default terrain has a 1x1 height sampler; height painting needs real resolution
-    const terrain = obtainTerrain(engine.entityManager.dataset);
-    terrain.samplerHeight.resize(256, 256);
-    terrain.updateHeights();
-
-    frameTerrain(engine, terrain);
-
-    const editorControl = enableEditor(engine);
-
-    const editor = editorControl.editor;
-
-    // console access for debugging, mirrors the window.engine convention
-    window.editor = editor;
-
-    editor.meshLibrary.add('data/models/samples/susanne.glb');
-    editor.meshLibrary.add('data/models/samples/teapot.gltf');
-    editor.meshLibrary.add('data/models/samples/textured_unit_cube.gltf');
-
-    editorControl.enable();
-
-    return { engine, editor, editorControl, terrain };
-}
-
-/**
- * The shell, booting. Exported as the promise it is so that a probe driving this page has something
- * to await — the module boots when it is loaded either way, which is what makes it an entry.
- *
- * @type {Promise<{engine: Engine, editor: Editor, editorControl: object, terrain: Terrain}>}
- */
-export const editor_shell = main();
+import './style/editor.scss';
+
+import Vector2 from "../src/core/geom/Vector2.js";
+import { GameAssetType } from "../src/engine/asset/GameAssetType.js";
+import { ArrayBufferLoader } from "../src/engine/asset/loaders/ArrayBufferLoader.js";
+import {
+    GLTFSceneBundleAssetLoader
+} from "../src/engine/asset/loaders/GLTFSceneBundleAssetLoader.js";
+import {
+    USDSceneBundleAssetLoader
+} from "../src/engine/asset/loaders/USDSceneBundleAssetLoader.js";
+import { ImageBitmapAssetLoader } from "../src/engine/asset/loaders/image/ImageBitmapAssetLoader.js";
+import { ImageRGBADataLoader } from "../src/engine/asset/loaders/image/ImageRGBADataLoader.js";
+import { load_model_scene_bundle } from "../src/engine/asset/load_model_scene_bundle.js";
+import { ParentEntitySystem } from "../src/engine/ecs/parent/ParentEntitySystem.js";
+import { obtainTerrain } from "../src/engine/ecs/terrain/util/obtainTerrain.js";
+import { populateEngineSerializationRegistry } from "../src/engine/ecs/storage/populateEngineSerializationRegistry.js";
+import { TransformAttachmentSystem } from "../src/engine/ecs/transform-attachment/TransformAttachmentSystem.js";
+import { EngineHarness } from "../src/engine/EngineHarness.js";
+import TopDownCameraController from "../src/engine/graphics/ecs/camera/topdown/TopDownCameraController.js";
+import { DebugDrawSystem } from "../src/engine/graphics3/DebugDrawSystem.js";
+import {
+    HighlightOutlineSystem
+} from "../src/engine/graphics3/HighlightOutlineSystem.js";
+import { MeshSystem } from "../src/engine/graphics3/MeshSystem.js";
+import {
+    ShadedGeometryHighlightSystem
+} from "../src/engine/graphics/ecs/highlight/system/ShadedGeometryHighlightSystem.js";
+import {
+    SGMeshHighlightSystem
+} from "../src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshHighlightSystem.js";
+import {
+    ShadedGeometrySystem
+} from "../src/engine/graphics3/ShadedGeometrySystem.js";
+import { GPUParticleEmitterSystem } from "../src/engine/graphics3/GPUParticleEmitterSystem.js";
+import { enableEditor } from "./enableEditor.js";
+
+/**
+ * Point the camera at the middle of the terrain, standing off by its own extent.
+ *
+ * The harness anchors terrain at the world origin and aims the camera at the origin too,
+ * so the default view sits on the terrain's corner with three quadrants of empty space —
+ * and every orbit pivots on that corner. The editor camera inherits this state when it
+ * takes over the scene's active camera.
+ *
+ * Standing off by the terrain's extent frames most of it while keeping the far corners
+ * inside the camera's clip range; the rest is a wheel away.
+ *
+ * @param {Engine} engine
+ * @param {Terrain} terrain
+ */
+function frameTerrain(engine, terrain) {
+    const world_x = terrain.size.x * terrain.gridScale;
+    const world_y = terrain.size.y * terrain.gridScale;
+
+    engine.entityManager.dataset.traverseComponents(TopDownCameraController, controller => {
+        controller.target.set(world_x / 2, 0, world_y / 2);
+        controller.distance = Math.max(world_x, world_y);
+    });
+}
+
+/**
+ * The model loaders — the same split the game's graphics profile makes, and for the same reason: a
+ * model is the one asset whose loaded form *is* the renderer's own representation.
+ *
+ * @param {EngineConfiguration} config
+ */
+function addModelLoaders(config) {
+    const loader = new GLTFSceneBundleAssetLoader();
+
+    config.addLoader(GameAssetType.ModelGLTF, loader);
+    config.addLoader(GameAssetType.ModelGLTF_JSON, loader);
+
+    // `.usd`, `.usda` and `.usdz` all arrive under the one type — see `GameAssetType.ModelUSD`
+    config.addLoader(GameAssetType.ModelUSD, new USDSceneBundleAssetLoader());
+
+    // `load_gltf` asks the asset manager for each of a model's images rather than fetching them
+    // itself (D34), so a shell without this loader loads geometry and no textures
+    config.addLoader(GameAssetType.ImageBitmap, new ImageBitmapAssetLoader());
+}
+
+/**
+ * The systems that talk to the renderer.
+ *
+ * @param {Engine} engine
+ * @returns {Promise}
+ */
+async function addGraphicsSystems(engine) {
+    const em = engine.entityManager;
+
+    const meshes = new MeshSystem(
+        engine.graphics,
+        EngineHarness.shadeScene(engine),
+        url => load_model_scene_bundle(engine.assetManager, url)
+    );
+
+    await em.addSystem(meshes);
+
+    // a model with neither skin nor clip becomes entities, and its primitives are drawn by the
+    // system that owns primitives (D47)
+    await em.addSystem(new ShadedGeometrySystem(engine.graphics, EngineHarness.shadeScene(engine)));
+
+    /*
+     One outline pass and both of its sources, because the editor offers a `Highlight` editor and
+     either kind of thing can be carrying the component: a model placed from the mesh library is an
+     `SGMesh`, and anything built in place is a `ShadedGeometry`. The pass is registered once and
+     draws for both — a pass per kind would read the whole visibility buffer once per kind, and the
+     last would paint over the rest.
+    */
+    const outline = new HighlightOutlineSystem(engine.graphics);
+
+    await em.addSystem(outline);
+    await em.addSystem(new SGMeshHighlightSystem(outline, meshes));
+    await em.addSystem(new ShadedGeometryHighlightSystem(outline));
+
+    await em.addSystem(new GPUParticleEmitterSystem(
+        engine.graphics,
+        EngineHarness.shadeScene(engine),
+        engine.assetManager
+    ));
+
+    // the editor's selection box is the debug-draw pass's first consumer (V5)
+    await em.addSystem(new DebugDrawSystem(engine.graphics));
+}
+
+/**
+ * Standalone editor shell harness: engine + terrain + lights + camera, the systems the
+ * editor tooling relies on, a seeded mesh library, and the editor enabled from the start.
+ *
+ * @returns {Promise<{engine: Engine, editor: Editor, editorControl: object, terrain: Terrain}>}
+ */
+async function main() {
+    const harness = new EngineHarness();
+
+    const engine = await harness.initialize({
+        configuration(config) {
+            addModelLoaders(config);
+
+            config.addLoader(GameAssetType.ArrayBuffer, new ArrayBufferLoader());
+            config.addLoader(GameAssetType.Image, new ImageRGBADataLoader());
+        }
+    });
+
+    populateEngineSerializationRegistry(engine.binarySerializationRegistry);
+
+    const em = engine.entityManager;
+
+    await addGraphicsSystems(engine);
+
+    await em.addSystem(new TransformAttachmentSystem(engine));
+    await em.addSystem(new ParentEntitySystem());
+
+    await EngineHarness.buildBasics({
+        engine,
+        terrainSize: new Vector2(32, 32),
+        enableWater: false,
+        cameraController: false,
+        pitch: 0.9
+    });
+
+    // the default terrain has a 1x1 height sampler; height painting needs real resolution
+    const terrain = obtainTerrain(engine.entityManager.dataset);
+    terrain.samplerHeight.resize(256, 256);
+    terrain.updateHeights();
+
+    frameTerrain(engine, terrain);
+
+    const editorControl = enableEditor(engine);
+
+    const editor = editorControl.editor;
+
+    // console access for debugging, mirrors the window.engine convention
+    window.editor = editor;
+
+    editor.meshLibrary.add('data/models/samples/susanne.glb');
+    editor.meshLibrary.add('data/models/samples/teapot.gltf');
+    editor.meshLibrary.add('data/models/samples/textured_unit_cube.gltf');
+
+    editorControl.enable();
+
+    return { engine, editor, editorControl, terrain };
+}
+
+/**
+ * The shell, booting. Exported as the promise it is so that a probe driving this page has something
+ * to await — the module boots when it is loaded either way, which is what makes it an entry.
+ *
+ * @type {Promise<{engine: Engine, editor: Editor, editorControl: object, terrain: Terrain}>}
+ */
+export const editor_shell = main();

package/editor/templates/entity_templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity_templates.d.ts","sourceRoot":"","sources":["../../../editor/templates/entity_templates.js"],"names":[],"mappings":"AAkBA;;;;;;;GAOG;AACH,8DAJW,MAAM,cACN,EAAE,GACA,QAAQ,MAAM,CAAC,CA4B3B;AAED;;;;GAIG;AACH,+BAFU,cAAc;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,oBAAoB,QAAQ,MAAM,CAAC,CAAA;CAAC,CAAC,CA6G/E"}
+{"version":3,"file":"entity_templates.d.ts","sourceRoot":"","sources":["../../../editor/templates/entity_templates.js"],"names":[],"mappings":"AAeA;;;;;;;GAOG;AACH,8DAJW,MAAM,cACN,EAAE,GACA,QAAQ,MAAM,CAAC,CA4B3B;AAED;;;;GAIG;AACH,+BAFU,cAAc;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,oBAAoB,QAAQ,MAAM,CAAC,CAAA;CAAC,CAAC,CA+F/E"}

package/editor/templates/entity_templates.js

@@ -6,15 +6,12 @@ import { Camera } from "../../src/engine/graphics/ecs/camera/Camera.js";
 import { Light } from "../../src/engine/graphics/ecs/light/Light.js";
 import { SGMesh } from "../../src/engine/graphics/ecs/mesh-v2/aggregate/SGMesh.js";
 import CheckersTextureURI from "../../src/engine/graphics/texture/CheckersTextureURI.js";
-import { ParticleEmitter } from "../../src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.js";
-import { ParticleLayer } from "../../src/engine/graphics/particles/particular/engine/emitter/ParticleLayer.js";
-import { ParticleParameters } from "../../src/engine/graphics/particles/particular/engine/emitter/ParticleParameters.js";
-import { ParameterLookupTable } from "../../src/engine/graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
-import { ParameterTrack } from "../../src/engine/graphics/particles/particular/engine/parameter/ParameterTrack.js";
+import { ParticleEffect } from "../../src/engine/graphics/ecs/particles/ParticleEffect.js";
 import ComponentAddAction from "../actions/concrete/ComponentAddAction.js";
 import EntityCreateAction from "../actions/concrete/EntityCreateAction.js";
 import SelectionAddAction from "../actions/concrete/SelectionAddAction.js";
 import SelectionClearAction from "../actions/concrete/SelectionClearAction.js";
+import { make_starter_particle_effect } from "../particles/effect/make_starter_particle_effect.js";
 
 /**
  * Create an entity from a list of components as one undoable group, select it.
@@ -110,32 +107,18 @@ export const ENTITY_TEMPLATES = [
         }
     },
     {
-        name: 'Particle Emitter',
+        name: 'Particle Effect',
         build(editor) {
-            const emitter = new ParticleEmitter();
+            // the particle editor's own starting point, compiled: a plume that burns as soon as it is
+            // placed. Untextured, so the template names no image the host may not ship
+            const starter = make_starter_particle_effect();
 
-            const layer = new ParticleLayer();
-            layer.imageURL = 'data/textures/particle/UETools/x64/Circle_04.png';
-            layer.emissionRate = 20;
+            const effect = ParticleEffect.from(starter.emitterConfig(starter.compile()));
 
-            // editable parameter tracks: constant size, warm fade-out
-            const scale_lut = new ParameterLookupTable(1);
-            scale_lut.write([1, 1], [0, 1]);
-            layer.parameterTracks.add(new ParameterTrack(ParticleParameters.Scale, scale_lut));
-
-            const color_lut = new ParameterLookupTable(4);
-            color_lut.write([
-                1, 0.85, 0.4, 1,
-                1, 0.25, 0.05, 0
-            ], [0, 1]);
-            layer.parameterTracks.add(new ParameterTrack(ParticleParameters.Color, color_lut));
-
-            emitter.layers.add(layer);
-
-            return spawnEntityFromTemplate(editor, 'Particle Emitter', [
+            return spawnEntityFromTemplate(editor, 'Particle Effect', [
                 new Transform64(),
-                new Name('Particle Emitter'),
-                emitter
+                new Name('Particle Effect'),
+                effect
             ]);
         }
     },

package/editor/view/makeEntityDecorators.js

@@ -3,7 +3,7 @@ import { EventType } from "../../src/engine/ecs/EventType.js";
 import { Camera } from "../../src/engine/graphics/ecs/camera/Camera.js";
 import { Light } from "../../src/engine/graphics/ecs/light/Light.js";
 import { SGMesh } from "../../src/engine/graphics/ecs/mesh-v2/aggregate/SGMesh.js";
-import { ParticleEmitter } from "../../src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.js";
+import { ParticleEffect } from "../../src/engine/graphics/ecs/particles/ParticleEffect.js";
 import LabelView from "../../src/view/common/LabelView.js";
 import EmptyView from "../../src/view/elements/EmptyView.js";
 import ImageView from "../../src/view/elements/image/ImageView.js";
@@ -43,7 +43,7 @@ export function makeEntityDecorators() {
 
     const component_icons = new Map([
         [SGMesh, "data/textures/icons/editor/cube-shaded-v1.png"],
-        [ParticleEmitter, "data/textures/icons/editor/particles.png"],
+        [ParticleEffect, "data/textures/icons/editor/particles.png"],
         [Light, "data/textures/icons/editor/light.png"],
         [Camera, "data/textures/icons/editor/camera.png"],
         [Tag, "data/textures/icons/editor/tag-v0.png"],

package/package.json

@@ -6,7 +6,7 @@
   "description": "Advanced 3D game engine",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "3.32.0",
+  "version": "3.34.0",
   "exports": {
     "./build/*": "./build/*",
     "./src/*": "./src/*",

package/src/core/collection/table/RowFirstTable.d.ts

@@ -70,7 +70,14 @@ export class RowFirstTable {
      */
     trim(): void;
     /**
+     * Fit capacity to `row_count` rows: grow if they do not fit, shrink if the table is much larger than they need.
      *
+     * A shrink lands on the capacity a grow would pick, and only happens once {@link ALLOCATION_SHRINK_FACTOR} of the
+     * capacity would still exceed that, so the next row added or removed cannot undo either direction. Shrinking to
+     * exactly `row_count` whenever `capacity * ALLOCATION_SHRINK_FACTOR > row_count` overlapped the minimum grow step,
+     * and reallocated the whole table on every append below ~30 rows.
+     *
+     * NOTE: any reallocation replaces {@link data} and {@link dataView}
      * @param {number} row_count
      */
     resize(row_count: number): void;
@@ -178,6 +185,7 @@ export class RowFirstTable {
      * @returns {boolean}
      */
     equals(other: RowFirstTable): boolean;
+    #private;
 }
 export type RowFirstTableSpec = import("./RowFirstTableSpec.js").RowFirstTableSpec;
 import Signal from "../../events/signal/Signal.js";

package/src/core/collection/table/RowFirstTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RowFirstTable.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/table/RowFirstTable.js"],"names":[],"mappings":"AAmCA;;;;;;;;GAQG;AACH;IAOI;;;;;OAKG;IACH,kBAJW,iBAAiB,iBACjB,OAAO,EA+CjB;IAxDD;;;OAGG;IACH,QAFU,MAAM,CAEL;IAkBP;;;OAGG;IACH,MAFU,iBAAiB,CAEX;IAEhB;;;OAGG;IACH,MAFU,WAAW,CAE4D;IAEjF;;;OAGG;IACH,UAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,UAFU,QAAQ,CAEqB;IAEvC;;;OAGG;IACH,IAFU;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAOxB;IAIL;;;;;;OAMG;IACH,0DAMC;IAED;;;OAGG;IACH,QAFa,MAAM,CA4ClB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAgDhB;IAED;;OAEG;IACH,aAEC;IAED;;;OAGG;IACH,kBAFW,MAAM,QAsBhB;IAED;;;;;OAKG;IACH,0BAJW,MAAM,gBACN,MAAM,SACN,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,yBAJW,MAAM,gBACN,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;OAIG;IACH,kBAHW,MAAM,aACN,MAAM,QAyBhB;IAED;;;;;;OAMG;IACH,kBAHW,MAAM,aACN,MAAM,QAwBhB;IAED;;;;;OAKG;IACH,kBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,eAHW,MAAO,MAAM,CAAC,GACZ,MAAM,CAYlB;IAED;;;;OAIG;IACH,eAHW,MAAM,iBACN,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAO,MAAM,CAAC,QAAM,QAIvD;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,QAwBhB;IAGD;;;;;OAKG;IACH,eAJW,MAAM,WACN,MAAM,EAAE,GACN,MAAM,EAAE,CAUpB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,EAAE,QAUlB;IAED;;;;;;OAMG;IACH,gBAFW,MAAM,QAgBhB;IAED;;OAEG;IACH,qBA4BC;IAED;;OAEG;IACH,cAIC;IAED;;;;OAIG;IACH,cAFa,MAAM,EAAE,EAAE,CAetB;IAED;;;OAGG;IACH,uBAIC;IAED;;;;OAIG;IACH,YAFW,aAAa,QAqBvB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAwCnB;CACJ;gCAhnBY,OAAO,wBAAwB,EAAE,iBAAiB;mBAN5C,+BAA+B"}
+{"version":3,"file":"RowFirstTable.d.ts","sourceRoot":"","sources":["../../../../../src/core/collection/table/RowFirstTable.js"],"names":[],"mappings":"AAiDA;;;;;;;;GAQG;AACH;IAOI;;;;;OAKG;IACH,kBAJW,iBAAiB,iBACjB,OAAO,EA+CjB;IAxDD;;;OAGG;IACH,QAFU,MAAM,CAEL;IAkBP;;;OAGG;IACH,MAFU,iBAAiB,CAEX;IAEhB;;;OAGG;IACH,MAFU,WAAW,CAE4D;IAEjF;;;OAGG;IACH,UAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,UAFU,QAAQ,CAEqB;IAEvC;;;OAGG;IACH,IAFU;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAOxB;IAIL;;;;;;OAMG;IACH,0DAMC;IAED;;;OAGG;IACH,QAFa,MAAM,CA4ClB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAgDhB;IAED;;OAEG;IACH,aAEC;IAaD;;;;;;;;;;OAUG;IACH,kBAFW,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,0BAJW,MAAM,gBACN,MAAM,SACN,MAAM,QAmBhB;IAED;;;;;OAKG;IACH,yBAJW,MAAM,gBACN,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;OAIG;IACH,kBAHW,MAAM,aACN,MAAM,QAyBhB;IAED;;;;;;OAMG;IACH,kBAHW,MAAM,aACN,MAAM,QAwBhB;IAED;;;;;OAKG;IACH,kBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,eAHW,MAAO,MAAM,CAAC,GACZ,MAAM,CAYlB;IAED;;;;OAIG;IACH,eAHW,MAAM,iBACN,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAO,MAAM,CAAC,QAAM,QAIvD;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,QAwBhB;IAGD;;;;;OAKG;IACH,eAJW,MAAM,WACN,MAAM,EAAE,GACN,MAAM,EAAE,CAUpB;IAED;;;;OAIG;IACH,gBAHW,MAAM,UACN,MAAM,EAAE,QAUlB;IAED;;;;;;OAMG;IACH,gBAFW,MAAM,QAgBhB;IAED;;OAEG;IACH,qBA4BC;IAED;;OAEG;IACH,cAIC;IAED;;;;OAIG;IACH,cAFa,MAAM,EAAE,EAAE,CAetB;IAED;;;OAGG;IACH,uBAIC;IAED;;;;OAIG;IACH,YAFW,aAAa,QAqBvB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAwCnB;;CACJ;gCA7oBY,OAAO,wBAAwB,EAAE,iBAAiB;mBAN5C,+BAA+B"}

package/src/core/collection/table/RowFirstTable.js

@@ -28,11 +28,25 @@ const ALLOCATION_GROW_FACTOR = 1.5;
 const ALLOCATION_GROW_MINIMUM_STEP = 32;
 
 /**
- * Must be less than 1 and greater than 0
+ * Must be less than 1 and greater than 0.
+ * A table shrinks once this fraction of its capacity would still exceed what a grow picks for the current row count,
+ * see {@link RowFirstTable#resize}
  * @type {number}
  */
 const ALLOCATION_SHRINK_FACTOR = 0.5;
 
+/**
+ * Capacity a grow picks for `row_count` rows, and the capacity a shrink lands on
+ * @param {number} row_count
+ * @returns {number}
+ */
+function capacity_for_row_count(row_count) {
+    return Math.max(
+        Math.ceil(row_count * ALLOCATION_GROW_FACTOR),
+        row_count + ALLOCATION_GROW_MINIMUM_STEP
+    );
+}
+
 /**
  * Compact binary table storage.
  * Very efficient in terms of memory usage and allocation.
@@ -225,26 +239,41 @@ export class RowFirstTable {
     }
 
     /**
+     * Grow capacity to fit `row_count` rows if it does not already, never shrinks.
+     * What every operation that adds rows uses, so an append cannot undo a {@link setCapacity} reservation.
+     * @param {number} row_count
+     */
+    #grow_to_fit(row_count) {
+        if (this.capacity < row_count) {
+            this.setCapacity(capacity_for_row_count(row_count));
+        }
+    }
+
+    /**
+     * Fit capacity to `row_count` rows: grow if they do not fit, shrink if the table is much larger than they need.
      *
+     * A shrink lands on the capacity a grow would pick, and only happens once {@link ALLOCATION_SHRINK_FACTOR} of the
+     * capacity would still exceed that, so the next row added or removed cannot undo either direction. Shrinking to
+     * exactly `row_count` whenever `capacity * ALLOCATION_SHRINK_FACTOR > row_count` overlapped the minimum grow step,
+     * and reallocated the whole table on every append below ~30 rows.
+     *
+     * NOTE: any reallocation replaces {@link data} and {@link dataView}
      * @param {number} row_count
      */
     resize(row_count) {
         assert.isNonNegativeInteger(row_count, 'row_count');
 
+        const fitted_capacity = capacity_for_row_count(row_count);
+
         if (this.capacity < row_count) {
 
             //grow
-            const new_size = Math.max(
-                Math.ceil(row_count * ALLOCATION_GROW_FACTOR),
-                row_count + ALLOCATION_GROW_MINIMUM_STEP
-            );
-
-            this.setCapacity(new_size);
+            this.setCapacity(fitted_capacity);
 
-        } else if (this.capacity * ALLOCATION_SHRINK_FACTOR > row_count) {
+        } else if (this.capacity * ALLOCATION_SHRINK_FACTOR > fitted_capacity) {
 
             //shrink
-            this.setCapacity(row_count);
+            this.setCapacity(fitted_capacity);
 
         }
 
@@ -343,7 +372,7 @@ export class RowFirstTable {
 
         const future_length = this.length + row_count;
 
-        this.resize(future_length);
+        this.#grow_to_fit(future_length);
 
         const data = this.data;
 
@@ -370,7 +399,7 @@ export class RowFirstTable {
     createEmptyRow() {
         const newRowCount = this.length + 1;
 
-        this.resize(newRowCount);
+        this.#grow_to_fit(newRowCount);
 
         const rowIndex = this.length;
 

package/src/{engine/graphics/particles/particular/engine → core/geom/3d/aabb}/MovingBoundingBox.d.ts

@@ -47,7 +47,7 @@ export class MovingBoundingBox {
      */
     move(x: number, y: number, z: number): void;
 }
-import { AABB3 } from "../../../../../core/geom/3d/aabb/AABB3.js";
-import { RowFirstTable } from "../../../../../core/collection/table/RowFirstTable.js";
-import Vector3 from "../../../../../core/geom/Vector3.js";
+import { AABB3 } from "./AABB3.js";
+import { RowFirstTable } from "../../../collection/table/RowFirstTable.js";
+import Vector3 from "../../Vector3.js";
 //# sourceMappingURL=MovingBoundingBox.d.ts.map

package/src/core/geom/3d/aabb/MovingBoundingBox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MovingBoundingBox.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/aabb/MovingBoundingBox.js"],"names":[],"mappings":"AAcA;;GAEG;AACH;IACI;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,cAFU,KAAK,CAE4B;IAE3C;;;OAGG;IACH,aAFU,KAAK,CAE2B;IAE1C;;;OAGG;IACH,kBAFU,aAAa,CAEoC;IAE3D;;;OAGG;IACH,UAFU,OAAO,CAEQ;IAEzB;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,kBAFW,MAAM,QAKhB;IAED,uBAwBC;IAED,2BAgCC;IAED;;;;;OAKG;IACH,QAJW,MAAM,KACN,MAAM,KACN,MAAM,QAyBhB;CACJ;sBAtJqB,YAAY;8BAFJ,4CAA4C;oBAGtD,kBAAkB"}

package/src/{engine/graphics/particles/particular/engine → core/geom/3d/aabb}/MovingBoundingBox.js

@@ -1,8 +1,8 @@
-import { BinaryDataType } from "../../../../../core/binary/type/BinaryDataType.js";
-import { RowFirstTable } from "../../../../../core/collection/table/RowFirstTable.js";
-import { RowFirstTableSpec } from "../../../../../core/collection/table/RowFirstTableSpec.js";
-import { AABB3 } from "../../../../../core/geom/3d/aabb/AABB3.js";
-import Vector3 from "../../../../../core/geom/Vector3.js";
+import { BinaryDataType } from "../../../binary/type/BinaryDataType.js";
+import { RowFirstTable } from "../../../collection/table/RowFirstTable.js";
+import { RowFirstTableSpec } from "../../../collection/table/RowFirstTableSpec.js";
+import { AABB3 } from "./AABB3.js";
+import Vector3 from "../../Vector3.js";
 
 const tempSequenceRecord = [];
 

package/src/core/math/lookup/RGBA_LUT_HEATMAP_IR.d.ts

@@ -0,0 +1,3 @@
+export const RGBA_LUT_HEATMAP_IR: ParameterLookupTable;
+import { ParameterLookupTable } from "./ParameterLookupTable.js";
+//# sourceMappingURL=RGBA_LUT_HEATMAP_IR.d.ts.map

package/src/core/math/lookup/RGBA_LUT_HEATMAP_IR.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RGBA_LUT_HEATMAP_IR.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/lookup/RGBA_LUT_HEATMAP_IR.js"],"names":[],"mappings":"AAEA,uDAA+D;qCAF1B,2BAA2B"}