@woosh/meep-engine 3.11.2 → 3.12.0

package/src/engine/graphics3/MeshSystem3.d.ts

@@ -1,106 +1,10 @@
 /**
- * Puts entities into Shade's scene and keeps them where the ECS says they are.
+ * @deprecated Renamed to {@link MeshSystem}. The trailing `3` marked the 2.x → 3.x renderer transition;
+ * the 2.x name it disambiguated against is gone, so the suffix no longer distinguishes anything.
  *
- * **It owns the scene and tells the facade to draw it**, rather than the facade handing a graph out
- * for anyone to write into — that coupling is what §2.1 retires along with `GraphicsEngine.scene`.
- *
- * Placement is a `Transform` copied into `Node3D.transform_local`, through
- * {@link t64_copy_from_transform} because the node's transform is a `Transform64` since S2 and the
- * two types stay deliberately distinct. `transform_global` is **derived** — `updateMatrices`
- * recomputes it from the local transform and the parent chain — so writing it directly would be
- * undone by the next refresh, and the entity is placed through the local one.
- *
- * What makes this affordable is S1: the scene database takes row-level updates, so moving one
- * entity writes one row. Nothing here rebuilds anything.
- *
- * **It also hands each instance to the GPU's animation manager** ({@link update}), because it is
- * what builds instances and therefore the only thing that knows when one exists. Driving those
- * clips is not its business — that is the animation systems' — but a clip nothing has registered
- * cannot be driven by anyone.
+ * Kept as a re-export rather than removed: this is a library, and an import path is as much a
+ * published interface as a class name.
  */
-export class MeshSystem3 extends System<any> {
-    /**
-     * @param {GraphicsEngine3} graphics
-     * @param {Scene} scene
-     * @param {function(string): Promise<SceneBundle>} load
-     */
-    constructor(graphics: GraphicsEngine3, scene: Scene, load: (arg0: string) => Promise<SceneBundle>);
-    dependencies: (typeof Transform | typeof SGMesh)[];
-    /**
-     * @returns {Scene}
-     */
-    get scene(): Scene;
-    /**
-     * Visit every node of an entity's model that carries geometry.
-     *
-     * The nodes are what the scene database keys on, so anything that has to say something about a
-     * particular entity's meshes — which rows they occupy, which of them the visibility buffer will
-     * name — starts here. A grouping node is skipped, because it has no geometry and therefore no
-     * row of its own.
-     *
-     * @param {number} entity
-     * @param {function(SGMesh): void} visitor
-     * @returns {boolean} `false` when the entity has nothing in the scene — never seen, or still
-     * loading, and neither is an error
-     */
-    traverse_meshes(entity: number, visitor: (arg0: SGMesh) => void): boolean;
-    /**
-     * The private copy of the model an entity is showing — its clips among other things, which is
-     * where their names and their durations come from.
-     *
-     * Handed out rather than copied because an animation driver has to know *which* instance it is
-     * bound to: a model swap builds a new one, and a driver still holding the old one would be
-     * driving nodes that left the scene. The object's identity is the only signal that says so.
-     *
-     * @param {number} entity
-     * @returns {SceneBundleInstance|null} `null` for an entity this system has never seen, or one
-     * whose model has not finished loading
-     */
-    instance_of(entity: number): SceneBundleInstance | null;
-    /**
-     * What the GPU's animation manager gave back for that instance — the skin and clip ids, in the
-     * instance's own order.
-     *
-     * Same reasoning as {@link instance_of} and a stronger version of it: these ids belong to one
-     * renderer, and a restart voids every one of them. The object is replaced when that happens, so
-     * a driver that compares it against what it bound against notices in the same frame.
-     *
-     * @param {number} entity
-     * @returns {InstanceAnimationRegistration|null} `null` while there is nothing registered — no
-     * model yet, no device yet, or a renderer restart that has not been drained
-     */
-    animation_of(entity: number): InstanceAnimationRegistration | null;
-    /**
-     * Where an entity's model is, in world space.
-     *
-     * This is what makes picking possible without a second copy of the geometry: Shade already keeps
-     * a world bounding box per mesh, refreshed as part of the `updateMatrices` that places it, so the
-     * answer is a walk over what the entity has in the scene and nothing is recomputed.
-     *
-     * @param {ArrayLike<number>|number[]|Float32Array} target aabb3, order `x0,y0,z0,x1,y1,z1`
-     * @param {number} entity
-     * @returns {boolean} `false` when the entity has nothing in the scene — it may be an entity this
-     * system has never seen, or one whose model is still loading, and neither is an error
-     */
-    compute_world_bounds(target: ArrayLike<number> | number[] | Float32Array, entity: number): boolean;
-    startup(entityManager: any): Promise<void>;
-    shutdown(entityManager: any): Promise<void>;
-    /**
-     * @param {SGMesh} model
-     * @param {Transform} transform
-     * @param {number} entity
-     */
-    link(model: SGMesh, transform: Transform, entity: number): void;
-    /**
-     * @param {SGMesh} model
-     * @param {Transform} transform
-     * @param {number} entity
-     */
-    unlink(model: SGMesh, transform: Transform, entity: number): void;
-    #private;
-}
-import { System } from "../ecs/System.js";
-import { Transform } from "../ecs/transform/Transform.js";
-import { SGMesh } from "../graphics/ecs/mesh-v2/aggregate/SGMesh.js";
-import { Scene } from "../../shade/renderer/scene/Scene.js";
+export const MeshSystem3: typeof MeshSystem;
+import { MeshSystem } from "./MeshSystem.js";
 //# sourceMappingURL=MeshSystem3.d.ts.map

package/src/engine/graphics3/MeshSystem3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MeshSystem3.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/MeshSystem3.js"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAmFI;;;;OAIG;IACH,8CAHW,KAAK,eACI,MAAM,KAAG,oBAAoB,EAchD;IADG,mDAAuC;IAG3C;;OAEG;IACH,mBAEC;IAED;;;;;;;;;;;;OAYG;IACH,wBALW,MAAM,kBACG,MAAM,KAAG,IAAI,GACpB,OAAO,CAqBnB;IAoCD;;;;;;;;;;;OAWG;IACH,oBAJW,MAAM,GACJ,sBAAoB,IAAI,CAWpC;IAED;;;;;;;;;;;OAWG;IACH,qBAJW,MAAM,GACJ,gCAA8B,IAAI,CAW9C;IAED;;;;;;;;;;;OAWG;IACH,6BALW,UAAU,MAAM,CAAC,GAAC,MAAM,EAAE,GAAC,YAAY,UACvC,MAAM,GACJ,OAAO,CAuCnB;IAED,2CAIC;IAED,4CASC;IA4GD;;;;OAIG;IACH,YAJW,MAAM,aACN,SAAS,UACT,MAAM,QA2BhB;IAED;;;;OAIG;IACH,cAJW,MAAM,aACN,SAAS,UACT,MAAM,QAIhB;;CAgLJ;uBA5nBsB,kBAAkB;0BACf,+BAA+B;uBAIlC,6CAA6C;sBAX9C,qCAAqC"}
+{"version":3,"file":"MeshSystem3.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/MeshSystem3.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,4CAAsC;2BATX,iBAAiB"}