@woosh/meep-engine 2.50.1 → 2.50.2

package/README.md

@@ -0,0 +1,39 @@
+# Meep Engine
+
+## Template Project
+
+Minimal project with no bells or whistles, just enough to run the engine and get you starter. If you're starting from scratch this is likely the best option.
+
+[GitLab Repository](http://gitlab.company-named.com/travnik/dream-engine-template)
+
+## Samples
+To help get you started, various samples are provided under `/samples` folder. Feel free to use them as a point of reference.
+
+## Documentation
+
+[Engine Documentation](http://meep-engine.company-named.com:8080/docs/api/)
+
+## Features, for more information, please refer to the documentation
+* Automatic instancing. This will minimize the number of draw calls and improve performance.
+* Decals. Decals in meep are done on the GPU, and as a result you can have a lot of them in your scene. The most I tested in a single scene is 1,000,000 which works quite well. Decals are useful for bullet holes, blood splatter and various scene decorations such as signs and scuff marks.
+* Deferred lights. Meep implements clustered lighting technique which allows you to have a pretty much an unlimited number of point lights in your scene. All the other light types are supported as well, but only point lights are clustered for now. Point lights are useful for various effects, like muzzle flashes, grenade explosions, torches, etc.
+* Particle engine. Meep's particle engine ("Particular") is optimized for game development needs, this means supporting complex effects and being able to spawn/destroy many particle systems every frame. There are a lot of particle engines out there, but they tend to have costly spawning routines, take up a lot of draw calls and not manage memory well, which leads to pretty poor performance in games. My particle engine supports full particle lighting as well, and soft particles. On top of that - all particles are automatically atlassed in the background and are compiled with just 4 shaders. This means that no matter how many particle effects you have - there will be no shader switching and no texture switching, and there will be no delays associated with shader compilation. Particles are culled, so particle systems that are off-screen are not rendered and simulation for them can be paused to save CPU resources (this is automatic behavior)
+* Sound engine. Meep has a custom sound engine which is culled and has custom attenuation, this allows scenes to have 1000s of positional audio sources without any extra cost in terms of performance
+* Asset streaming. Meep in general is a web-first engine, all assets are streamed, meaning that the engine is up and running even before any models/texture are loaded, and you're free to decide when to let the player see your level, wait until everything is loaded or drop them in as soon as you can. There is a pre-loader module in case you want to load some assets in bulk before starting the game.
+* Terrain engine. The terrain engine is chunk-based, which means that terrain is split into rectangular pieces internally, and they are built on-the-fly inside a web-worker based on camera position. Terrain is automatically culled based on camera position, so you're only drawing the chunks that are in view. Terrain supports layers just like Unity, but unlike Unity - Meep supports up to 256 layers of terrain instead of 4.
+* AI tools, including
+  * full-fledged Behavior trees
+  * Blackboard (took for recording information useful for AI to read/write relevant world state, very commonly used with Behavior Trees)
+  * monte-carlo tree search (same as Google's AlphaGo, useful for decision-making)
+  * state optimization (useful for decision-making)
+  * grid-based path finding (optimized for 10,000s of queries per second)
+  * resource allocation solver (useful for planning, given certain resources such as bullets/grenades/money/health - plan what actions to take to optimize your chances of winning)
+  * and a number of other useful tools to complement AI development.
+* Inverse kinematics. Meep has 2 very useful IK solvers to fix foot position for characters on uneven terrain or stairs, aligning both the position and orientation of character feet. This works for hands as well if you want and is not limited to bipeds, the system works just as well for, say, spiders.
+* Extremely compact serialization system. You can save/load your scenes from files. This serialization system supports format changes, so as you develop your game - old saves will be supported and the system will automatically upgrade them to the most recent version, so the player doesn't have to lose any data.
+* Achievements. Achievements work with Blackboard components and are very easy to define. There is an abstraction system that helps connect your achievements to various platforms such as Steam or XBox (you'd have to implement that binding yourself though), by default it comes with a browser backend, storing data in IndexedDB. I also have bindings for Steam and NewGrounds that I can share.
+* UI system. You're free to use it or not, the engine works just fine without it. The system is written for speed, and it offers a few commonly used tools, such as popup windows, notifications and pages. The UI system is optimized for speed, so it generates no garbage, but again - if you want to use, say React - you can ignore this system or integrate it with the system.
+* Trails. Meep implements a fairly complex trail system, where a trail can be attached to an entity, and it will create a trail behind.
+
+---
+Copyright © 2023 Company Named Limited, All Rights Reserved

package/editor/Editor.js

@@ -696,7 +696,11 @@ Editor.prototype.attach = async function (engine) {
 
     this.processEngine.startup();
 
-    this.selectionVistualizer.startup();
+    try {
+        this.selectionVistualizer.startup();
+    } catch (e) {
+        console.error("Failed to start selection visualizer:", e);
+    }
 
     //attach view
     engine.viewStack.push(this.view, "Editor");

package/editor/SelectionVisualizer.js

@@ -2,6 +2,7 @@ import { BoxHelper, Group } from 'three';
 import Mesh from "../src/engine/graphics/ecs/mesh/Mesh.js";
 import { SignalBinding } from "../src/core/events/signal/SignalBinding.js";
 import { MeshEvents } from "../src/engine/graphics/ecs/mesh/MeshEvents.js";
+import { assert } from "../src/core/assert.js";
 
 
 /**
@@ -11,6 +12,9 @@ import { MeshEvents } from "../src/engine/graphics/ecs/mesh/MeshEvents.js";
  * @constructor
  */
 function SelectionContainer(entity, entityManager) {
+    assert.defined(entityManager, 'entityManager');
+    assert.isNonNegativeInteger(entity, 'entity');
+
     this.entity = entity;
     this.entityManager = entityManager;
 
@@ -25,7 +29,7 @@ function SelectionContainer(entity, entityManager) {
     const self = this;
 
     function updateMesh() {
-        const mesh = entityManager.getComponent(entity, Mesh);
+        const mesh = entityManager.dataset.getComponent(entity, Mesh);
 
         if (mesh !== null && mesh !== undefined && mesh.hasMesh()) {
             boxHelper.setFromObject(mesh.mesh);
@@ -59,13 +63,15 @@ SelectionContainer.prototype.link = function () {
     this.isLinked = true;
     this.handlers.animationLoop();
 
-    this.entityManager.addEntityEventListener(this.entity, MeshEvents.DataSet, this.handlers.updateMesh);
+    const ecd = this.entityManager.dataset;
+    ecd.addEntityEventListener(this.entity, MeshEvents.DataSet, this.handlers.updateMesh);
 };
 
 SelectionContainer.prototype.unlink = function () {
     this.isLinked = false;
 
-    this.entityManager.removeEntityEventListener(this.entity, MeshEvents.DataSet, this.handlers.updateMesh);
+    const ecd = this.entityManager.dataset;
+    ecd.removeEntityEventListener(this.entity, MeshEvents.DataSet, this.handlers.updateMesh);
 };
 
 /**

package/editor/tools/paint/TerrainTexturePaintTool.js

@@ -72,7 +72,12 @@ export class TerrainTexturePaintTool extends TerrainPaintTool {
             return;
         }
 
-        const url = convertSampler2D2DataURL(layer.diffuse);
+        let url = layer.textureDiffuseURL;
+
+        if (url === null) {
+            // no URL, try to sample texture directly
+            url = convertSampler2D2DataURL(layer.diffuse);
+        }
 
         this.icon.set(url);
     }

package/editor/view/EditorView.js

@@ -34,6 +34,8 @@ import { MeshEvents } from "../../src/engine/graphics/ecs/mesh/MeshEvents.js";
 import { obtainTerrain } from "../../src/engine/ecs/terrain/util/obtainTerrain.js";
 import { SurfacePoint3 } from "../../src/core/geom/3d/SurfacePoint3.js";
 import { make_ray_from_viewport_position } from "../../src/engine/graphics/make_ray_from_viewport_position.js";
+import { makeEntityDecorators } from "./makeEntityDecorators.js";
+
 
 class ViewManager extends View {
     constructor() {
@@ -306,8 +308,10 @@ class EditorView extends View {
          */
         this.gameView = null;
 
+        const decorators = makeEntityDecorators();
+
 
-        const entityListView = new EntityListView(editor);
+        const entityListView = new EntityListView({ editor, decorators });
         this.entityListView = entityListView;
 
         //entity editor

package/editor/view/ecs/EntityList.js

@@ -11,13 +11,12 @@ import ButtonView from '../../../src/view/elements/button/ButtonView.js';
 import ObservedValue from '../../../src/core/model/ObservedValue.js';
 import Signal from '../../../src/core/events/signal/Signal.js';
 import List from '../../../src/core/collection/list/List.js';
-import Tag from '../../../src/engine/ecs/components/Tag.js';
 
 import SelectionAddAction from '../../actions/concrete/SelectionAddAction.js';
 import SelectionRemoveAction from '../../actions/concrete/SelectionRemoveAction.js';
 import EmptyView from "../../../src/view/elements/EmptyView.js";
 
-class EntityView extends View {
+class EntityView extends EmptyView {
     /**
      *
      * @param entity
@@ -25,14 +24,12 @@ class EntityView extends View {
      * @constructor
      */
     constructor(entity, entityDataset) {
-        super(entity, entityDataset);
-
-        const dRoot = dom('div');
-
-        dRoot.addClass('entity-view');
+        super({
+            classList: [
+                'entity-view'
+            ]
+        });
 
-        this.el = dRoot.el;
-        const self = this;
 
         this.model = entity;
 
@@ -58,38 +55,28 @@ class EntityView extends View {
         signals.selected = new Signal();
 
         dCheckBox.on('click', function () {
-            signals.selected.dispatch();
+            signals.selected.send0();
         });
 
-        //add tag text
-        const tag = entityDataset.getComponent(entity, Tag);
-        if (tag !== undefined) {
-            const vTags = new EmptyView({ classList: ['tag-container'] });
-
-            this.addChild(vTags);
-
-            tag.traverse(n => {
-
-                const lTag = new LabelView(n, {
-                    classList: ['tag']
-                });
-
-                vTags.addChild(lTag);
-            });
-        }
         this.el.appendChild(dCheckBox.el);
     }
 }
 
 
 class EntityListView extends View {
-    constructor(editor) {
-        super(editor);
-
-        const dRoot = dom('div');
-        dRoot.addClass('entity-list-view');
+    /**
+     *
+     * @param {Editor} editor
+     * @param { (function(entity:number, ecd:EntityComponentDataset, view:View):void)[]} decorators
+     */
+    constructor({
+                    editor,
+                    decorators = []
+                }) {
+        super();
 
-        this.el = dRoot.el;
+        this.el = document.createElement('div');
+        this.addClass('entity-list-view');
 
         if (this.on === undefined) {
             this.on = {};
@@ -107,9 +94,19 @@ class EntityListView extends View {
             const entityDataset = entityManager.dataset;
 
             const entityView = new EntityView(entity, entityDataset);
+
+            const decorator_count = decorators.length;
+
+            for (let i = 0; i < decorator_count; i++) {
+                const decorator = decorators[i];
+
+                decorator(entity, entityDataset, entityView);
+            }
+
             if (editor.selection.contains(entity)) {
                 entityView.isSelected.set(true);
             }
+
             entityView.on.selected.add(function () {
                 const actions = self.editor.actions;
                 actions.mark();
@@ -141,15 +138,23 @@ class EntityListView extends View {
         const actionAdd = {
             name: "Add",
             action: function () {
-                engine.entityManager.createEntity();
+                const dataset = editor.engine.entityManager.dataset;
+
+                if (dataset !== null) {
+                    dataset.createEntity();
+                }
             }
         };
 
+        const vToolBar = new EmptyView();
+
         const vAddButton = new ButtonView(actionAdd);
         vAddButton.size.set(100, 20);
 
+        vToolBar.addChild(vAddButton);
+
         this.addChildAt(list, 0, 0, 0, 0);
-        this.addChildAt(vAddButton, 0, 1, 0, 0);
+        this.addChildAt(vToolBar, 0, 1, 0, 0);
 
 
         function addOne(entity) {
@@ -199,15 +204,21 @@ class EntityListView extends View {
             }
         };
 
+        const layout = () => {
+            const size = this.size;
+
+            list.size.set(size.x, size.y - 20);
+            vToolBar.size.set(size.x, 20);
+            vToolBar.position.set(0, list.size.y + list.position.y);
+        }
 
         const handlers = this.handlers;
 
         //listen for selection
         this.bindSignal(editor.selection.on.added, handlers.selectOne);
         this.bindSignal(editor.selection.on.removed, handlers.deselectOne);
-        this.size.onChanged.add(function (x, y) {
-            list.size.set(x, y);
-        });
+        this.size.onChanged.add(layout);
+        this.on.linked.add(layout);
     }
 
     layout() {

package/editor/view/makeEntityDecorators.js

@@ -0,0 +1,125 @@
+import { Tag } from "../../src/engine/ecs/components/Tag.js";
+import EmptyView from "../../src/view/elements/EmptyView.js";
+import LabelView from "../../src/view/common/LabelView.js";
+import Mesh from "../../src/engine/graphics/ecs/mesh/Mesh.js";
+import { ParticleEmitter } from "../../src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.js";
+import { Light } from "../../src/engine/graphics/ecs/light/Light.js";
+import { Camera } from "../../src/engine/graphics/ecs/camera/Camera.js";
+import ImageView from "../../src/view/elements/image/ImageView.js";
+import { EventType } from "../../src/engine/ecs/EntityManager.js";
+
+/**
+ *
+ * @return {(function(entity:number, ecd:EntityComponentDataset, view:View):void)[]}
+ */
+export function makeEntityDecorators() {
+
+    /**
+     *
+     * @param {number} entity
+     * @param {EntityComponentDataset} ecd
+     * @param {View} view
+     */
+    function decorate_tags(entity, ecd, view) {
+        const tag = ecd.getComponent(entity, Tag);
+
+        if (tag === undefined) {
+            return;
+        }
+
+        const vTags = new EmptyView({ classList: ['tag-container'] });
+
+        view.addChild(vTags);
+
+        tag.traverse(n => {
+
+            const lTag = new LabelView(n, {
+                classList: ['tag']
+            });
+
+            vTags.addChild(lTag);
+        });
+    }
+
+    const component_icons = new Map([
+        [Mesh, "data/textures/icons/editor/cube-shaded-v1.png"],
+        [ParticleEmitter, "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"],
+    ]);
+
+    /**
+     *
+     * @param {number} entity
+     * @param {EntityComponentDataset} ecd
+     * @param {View} view
+     */
+    function decorate_component_icons(entity, ecd, view) {
+
+        const vIconContainer = new EmptyView({
+            css: {
+                pointerEvents: "none",
+                display: "flex",
+                flexDirection: "row",
+                justifyContent: "flex-end",
+                filter: "drop-shadow(0 0 2px rgba(0,0,0,0.6))"
+            }
+        });
+
+        /**
+         *
+         * @type {Map<any, View>}
+         */
+        const icons = new Map();
+
+        function update() {
+
+            for (const [Klass, icon_url] of component_icons) {
+
+                const has_icon = icons.has(Klass);
+                const has_component = ecd.hasComponent(entity, Klass);
+
+                if (!has_icon && has_component) {
+
+                    const icon = new ImageView(icon_url);
+
+                    icon.size.set(18, 18);
+
+                    vIconContainer.addChild(icon);
+
+                    icons.set(Klass, icon);
+
+                } else if (has_icon && !has_component) {
+                    vIconContainer.removeChild(icons.get(Klass));
+
+                    icons.delete(Klass);
+                }
+
+            }
+        }
+
+        function subscribe() {
+            ecd.addEntityEventListener(entity, EventType.ComponentAdded, update);
+            ecd.addEntityEventListener(entity, EventType.ComponentRemoved, update);
+        }
+
+        function unsubscribe() {
+            ecd.removeEntityEventListener(entity, EventType.ComponentAdded, update);
+            ecd.removeEntityEventListener(entity, EventType.ComponentRemoved, update);
+        }
+
+        view.on.linked.add(subscribe);
+        view.on.linked.add(update);
+        view.on.unlinked.add(unsubscribe);
+
+        view.addChild(vIconContainer);
+
+
+    }
+
+    return [
+        // decorate_tags,
+        decorate_component_icons
+    ];
+}

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.50.1",
+  "version": "2.50.2",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {
@@ -14,7 +14,8 @@
       "require": "./build/meep.cjs"
     },
     "./src/*": "./src/*",
-    "./editor/*": "./editor/*"
+    "./editor/*": "./editor/*",
+    "./*.md": "./*"
   },
   "scripts": {
     "build-module": "rollup -c rollup.config.js",
@@ -71,5 +72,8 @@
     "entity",
     "component",
     "system"
-  ]
+  ],
+  "engines": {
+    "node": ">=14"
+  }
 }

package/samples/generation/README.md

@@ -0,0 +1,6 @@
+# Procedural Level Generation samples
+
+It is our hope is that you will find the code in these samples useful as a guide.
+
+Please note that these samples currently rely on assets from an unpublished game codenamed "mir".
+These assets are not distributed with the engine.

package/{src/generation/example → samples/generation}/SampleGenerator0.js

@@ -1,58 +1,72 @@
-import { GridTaskGroup } from "../GridTaskGroup.js";
-import { GridCellPlacementRule } from "../placement/GridCellPlacementRule.js";
-import { CellMatcherGridPattern } from "../rules/cell/CellMatcherGridPattern.js";
-import { CellMatcherLayerBitMaskTest } from "../rules/CellMatcherLayerBitMaskTest.js";
-import { GridTags } from "../GridTags.js";
-import { CellMatcherNot } from "../rules/logic/CellMatcherNot.js";
-import { GridCellActionPlaceMarker } from "../markers/GridCellActionPlaceMarker.js";
-import { GridTaskCellularAutomata } from "../grid/generation/discrete/GridTaskCellularAutomata.js";
-import { GridTaskActionRuleSet } from "../grid/generation/discrete/GridTaskCellActionRuleSet.js";
-import { GridActionRuleSet } from "../markers/GridActionRuleSet.js";
-import { GridTaskBuildSourceDistanceMap } from "../grid/generation/discrete/layer/GridTaskBuildSourceDistanceMap.js";
-import { CellMatcherAnd } from "../rules/logic/CellMatcherAnd.js";
-import { GridCellActionPlaceTags } from "../placement/action/GridCellActionPlaceTags.js";
-import { CellMatcherContainsMarkerWithinRadius } from "../rules/cell/CellMatcherContainsMarkerWithinRadius.js";
+import { GridTaskGroup } from "../../src/generation/GridTaskGroup.js";
+import { GridCellPlacementRule } from "../../src/generation/placement/GridCellPlacementRule.js";
+import { CellMatcherGridPattern } from "../../src/generation/rules/cell/CellMatcherGridPattern.js";
+import { CellMatcherLayerBitMaskTest } from "../../src/generation/rules/CellMatcherLayerBitMaskTest.js";
+import { GridTags } from "../../src/generation/GridTags.js";
+import { CellMatcherNot } from "../../src/generation/rules/logic/CellMatcherNot.js";
+import { GridCellActionPlaceMarker } from "../../src/generation/markers/GridCellActionPlaceMarker.js";
+import { GridTaskCellularAutomata } from "../../src/generation/grid/generation/discrete/GridTaskCellularAutomata.js";
+import { GridTaskActionRuleSet } from "../../src/generation/grid/generation/discrete/GridTaskCellActionRuleSet.js";
+import { GridActionRuleSet } from "../../src/generation/markers/GridActionRuleSet.js";
+import {
+    GridTaskBuildSourceDistanceMap
+} from "../../src/generation/grid/generation/discrete/layer/GridTaskBuildSourceDistanceMap.js";
+import { CellMatcherAnd } from "../../src/generation/rules/logic/CellMatcherAnd.js";
+import { GridCellActionPlaceTags } from "../../src/generation/placement/action/GridCellActionPlaceTags.js";
+import {
+    CellMatcherContainsMarkerWithinRadius
+} from "../../src/generation/rules/cell/CellMatcherContainsMarkerWithinRadius.js";
 import { mir_matcher_attack_corridor } from "./rules/mir_matcher_attack_corridor.js";
 import { mir_generator_place_bases } from "./generators/mir_generator_place_bases.js";
 import { matcher_tag_traversable_unoccupied } from "./rules/matcher_tag_traversable_unoccupied.js";
 import { mir_generator_place_starting_point } from "./generators/mir_generator_place_starting_point.js";
-import { GridTaskConnectRooms } from "../grid/generation/discrete/GridTaskConnectRooms.js";
+import { GridTaskConnectRooms } from "../../src/generation/grid/generation/discrete/GridTaskConnectRooms.js";
 import { matcher_tag_traversable } from "./rules/matcher_tag_traversable.js";
-import { GridTaskGenerateRoads } from "../grid/generation/road/GridTaskGenerateRoads.js";
+import { GridTaskGenerateRoads } from "../../src/generation/grid/generation/road/GridTaskGenerateRoads.js";
 import { mir_generator_place_road_decorators } from "./generators/mir_generator_place_road_decorators.js";
-import { MarkerNodeMatcherByType } from "../markers/matcher/MarkerNodeMatcherByType.js";
-import { GridTaskDensityMarkerDistribution } from "../grid/generation/GridTaskDensityMarkerDistribution.js";
-import { CellFilterSimplexNoise } from "../filtering/numeric/complex/CellFilterSimplexNoise.js";
-import { NumericInterval } from "../../core/math/interval/NumericInterval.js";
-import { CellFilterMultiply } from "../filtering/numeric/math/algebra/CellFilterMultiply.js";
-import { CellFilterCellMatcher } from "../filtering/CellFilterCellMatcher.js";
-import { CellFilterLiteralFloat } from "../filtering/numeric/CellFilterLiteralFloat.js";
+import { MarkerNodeMatcherByType } from "../../src/generation/markers/matcher/MarkerNodeMatcherByType.js";
+import {
+    GridTaskDensityMarkerDistribution
+} from "../../src/generation/grid/generation/GridTaskDensityMarkerDistribution.js";
+import { CellFilterSimplexNoise } from "../../src/generation/filtering/numeric/complex/CellFilterSimplexNoise.js";
+import { NumericInterval } from "../../src/core/math/interval/NumericInterval.js";
+import { CellFilterMultiply } from "../../src/generation/filtering/numeric/math/algebra/CellFilterMultiply.js";
+import { CellFilterCellMatcher } from "../../src/generation/filtering/CellFilterCellMatcher.js";
+import { CellFilterLiteralFloat } from "../../src/generation/filtering/numeric/CellFilterLiteralFloat.js";
 import { MirGridLayers } from "./grid/MirGridLayers.js";
-import { CellFilterLerp } from "../filtering/numeric/math/CellFilterLerp.js";
-import { GridCellActionWriteFilterToLayer } from "../placement/action/GridCellActionWriteFilterToLayer.js";
-import { CellMatcherAny } from "../rules/CellMatcherAny.js";
-import { CellFilterGaussianBlur } from "../filtering/numeric/complex/CellFilterGaussianBlur.js";
-import { GridCellActionSequence } from "../placement/action/util/GridCellActionSequence.js";
-import { CellFilterStep } from "../filtering/numeric/math/CellFilterStep.js";
-import { CellFilterSampleLayerLinear } from "../filtering/numeric/sampling/CellFilterSampleLayerLinear.js";
-import { CellFilterAngleToNormal } from "../filtering/numeric/complex/CellFilterAngleToNormal.js";
-import Vector3 from "../../core/geom/Vector3.js";
-import { CellFilterOneMinus } from "../filtering/numeric/math/CellFilterOneMinus.js";
-import { CellFilterSmoothStep } from "../filtering/numeric/math/CellFilterSmoothStep.js";
+import { CellFilterLerp } from "../../src/generation/filtering/numeric/math/CellFilterLerp.js";
+import {
+    GridCellActionWriteFilterToLayer
+} from "../../src/generation/placement/action/GridCellActionWriteFilterToLayer.js";
+import { CellMatcherAny } from "../../src/generation/rules/CellMatcherAny.js";
+import { CellFilterGaussianBlur } from "../../src/generation/filtering/numeric/complex/CellFilterGaussianBlur.js";
+import { GridCellActionSequence } from "../../src/generation/placement/action/util/GridCellActionSequence.js";
+import { CellFilterStep } from "../../src/generation/filtering/numeric/math/CellFilterStep.js";
+import {
+    CellFilterSampleLayerLinear
+} from "../../src/generation/filtering/numeric/sampling/CellFilterSampleLayerLinear.js";
+import { CellFilterAngleToNormal } from "../../src/generation/filtering/numeric/complex/CellFilterAngleToNormal.js";
+import Vector3 from "../../src/core/geom/Vector3js";
+import { CellFilterOneMinus } from "../../src/generation/filtering/numeric/math/CellFilterOneMinus.js";
+import { CellFilterSmoothStep } from "../../src/generation/filtering/numeric/math/CellFilterSmoothStep.js";
 import { SampleNoise20_0 } from "./filters/SampleNoise20_0.js";
 import { SampleGroundMoistureFilter } from "./filters/SampleGroundMoistureFilter.js";
-import { GridTaskSequence } from "../grid/generation/GridTaskSequence.js";
-import { CellFilterSubtract } from "../filtering/numeric/math/algebra/CellFilterSubtract.js";
-import { CellFilterCache } from "../filtering/numeric/CellFilterCache.js";
-import { CellFilterInverseLerp } from "../filtering/numeric/math/CellFilterInverseLerp.js";
-import { CellFilterClamp } from "../filtering/numeric/math/CellFilterClamp.js";
-import { MarkerNodeTransformerYRotateByFilter } from "../markers/transform/MarkerNodeTransformerYRotateByFilter.js";
-import { GridPatternMatcherCell } from "../rules/cell/GridPatternMatcherCell.js";
-import { MarkerNodeTransformerRecordProperty } from "../markers/transform/MarkerNodeTransformerRecordProperty.js";
-import { CellFilterAdd } from "../filtering/numeric/math/algebra/CellFilterAdd.js";
-import { CellFilterDivide } from "../filtering/numeric/math/algebra/CellFilterDivide.js";
-import { CellFilterCubicFunction } from "../filtering/numeric/math/poly/CellFilterCubicFunction.js";
-import { CellFilterMax2 } from "../filtering/numeric/math/CellFilterMax2.js";
+import { GridTaskSequence } from "../../src/generation/grid/generation/GridTaskSequence.js";
+import { CellFilterSubtract } from "../../src/generation/filtering/numeric/math/algebra/CellFilterSubtract.js";
+import { CellFilterCache } from "../../src/generation/filtering/numeric/CellFilterCache.js";
+import { CellFilterInverseLerp } from "../../src/generation/filtering/numeric/math/CellFilterInverseLerp.js";
+import { CellFilterClamp } from "../../src/generation/filtering/numeric/math/CellFilterClamp.js";
+import {
+    MarkerNodeTransformerYRotateByFilter
+} from "../../src/generation/markers/transform/MarkerNodeTransformerYRotateByFilter.js";
+import { GridPatternMatcherCell } from "../../src/generation/rules/cell/GridPatternMatcherCell.js";
+import {
+    MarkerNodeTransformerRecordProperty
+} from "../../src/generation/markers/transform/MarkerNodeTransformerRecordProperty.js";
+import { CellFilterAdd } from "../../src/generation/filtering/numeric/math/algebra/CellFilterAdd.js";
+import { CellFilterDivide } from "../../src/generation/filtering/numeric/math/algebra/CellFilterDivide.js";
+import { CellFilterCubicFunction } from "../../src/generation/filtering/numeric/math/poly/CellFilterCubicFunction.js";
+import { CellFilterMax2 } from "../../src/generation/filtering/numeric/math/CellFilterMax2.js";
 import { matcher_not_play_area } from "./rules/matcher_not_play_area.js";
 
 export const SampleGenerator0 = new GridTaskGroup();

package/{src/generation/example → samples/generation}/filters/SampleGroundMoistureFilter.js

@@ -1,16 +1,18 @@
-import { CellFilterMultiply } from "../../filtering/numeric/math/algebra/CellFilterMultiply.js";
-import { CellFilterSimplexNoise } from "../../filtering/numeric/complex/CellFilterSimplexNoise.js";
-import { CellFilterLiteralFloat } from "../../filtering/numeric/CellFilterLiteralFloat.js";
-import { CellFilterGaussianBlur } from "../../filtering/numeric/complex/CellFilterGaussianBlur.js";
-import { CellFilterStep } from "../../filtering/numeric/math/CellFilterStep.js";
-import { CellFilterSampleLayerLinear } from "../../filtering/numeric/sampling/CellFilterSampleLayerLinear.js";
+import { CellFilterMultiply } from "../../../src/generation/filtering/numeric/math/algebra/CellFilterMultiply.js";
+import { CellFilterSimplexNoise } from "../../../src/generation/filtering/numeric/complex/CellFilterSimplexNoise.js";
+import { CellFilterLiteralFloat } from "../../../src/generation/filtering/numeric/CellFilterLiteralFloat.js";
+import { CellFilterGaussianBlur } from "../../../src/generation/filtering/numeric/complex/CellFilterGaussianBlur.js";
+import { CellFilterStep } from "../../../src/generation/filtering/numeric/math/CellFilterStep.js";
+import {
+    CellFilterSampleLayerLinear
+} from "../../../src/generation/filtering/numeric/sampling/CellFilterSampleLayerLinear.js";
 import { MirGridLayers } from "../grid/MirGridLayers.js";
-import { CellFilterMax2 } from "../../filtering/numeric/math/CellFilterMax2.js";
-import { CellFilterSmoothStep } from "../../filtering/numeric/math/CellFilterSmoothStep.js";
-import { MohGridLayers } from "../../../../../../generator/MohGridLayers.js";
-import { CellFilterDilate } from "../../filtering/numeric/complex/CellFilterDilate.js";
-import { CellFilterCache } from "../../filtering/numeric/CellFilterCache.js";
-import { DEG_TO_RAD } from "../../../core/math/DEG_TO_RAD.js";
+import { CellFilterMax2 } from "../../../src/generation/filtering/numeric/math/CellFilterMax2.js";
+import { CellFilterSmoothStep } from "../../../src/generation/filtering/numeric/math/CellFilterSmoothStep.js";
+import { MohGridLayers } from "../../../../../generator/MohGridLayers.js";
+import { CellFilterDilate } from "../../../src/generation/filtering/numeric/complex/CellFilterDilate.js";
+import { CellFilterCache } from "../../../src/generation/filtering/numeric/CellFilterCache.js";
+import { DEG_TO_RAD } from "../../../src/core/math/DEG_TO_RAD.js";
 
 const fReadHeight = CellFilterSampleLayerLinear.from(MirGridLayers.Heights);
 

package/samples/generation/filters/SampleNoise20_0.js

@@ -0,0 +1,3 @@
+import { CellFilterSimplexNoise } from "../../../src/generation/filtering/numeric/complex/CellFilterSimplexNoise.js";
+
+export const SampleNoise20_0 = CellFilterSimplexNoise.from(20, 20);