@aura3d/ecs 1.3.2 → 1.3.3

package/dist/SystemScheduler.js

@@ -62,10 +62,11 @@ function sortSystems(systems) {
         throw new ValidationError("ECS_SYSTEM_CYCLE", "ECS system dependency cycle rejected.");
     return result;
     function addEdge(from, to) {
-        if (!byName.has(from))
-            throw new ValidationError("MISSING_ECS_SYSTEM_DEPENDENCY", `Missing ECS system dependency: ${from}`);
-        if (!byName.has(to))
-            throw new ValidationError("MISSING_ECS_SYSTEM_DEPENDENCY", `Missing ECS system dependency: ${to}`);
+        // `before`/`after` are soft ordering constraints: if the referenced
+        // system is not registered (or runs in a different phase), the edge is
+        // simply skipped instead of failing the whole schedule.
+        if (!byName.has(from) || !byName.has(to))
+            return;
         const edges = graph.get(from);
         if (!edges.has(to)) {
             edges.add(to);

package/dist/SystemScheduler.js.map

@@ -1 +1 @@
-{"version":3,"file":"SystemScheduler.js","sourceRoot":"","sources":["../../../../packages/ecs/src/SystemScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAqD,MAAM,aAAa,CAAC;AAChF,OAAO,EAAc,MAAM,YAAY,CAAC;AAExC,MAAM,UAAU,GAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAE9D,MAAM,OAAO,eAAe;IACT,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,GAAG,CAAC,MAAc,EAAE,KAAa;QAC/B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,0BAA0B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1H,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAc,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAAa;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAc,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,KAAmB;QACvB,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC;QAClI,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,KAAY,EAAE,OAAsB;QACzC,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;CACF;AAED,SAAS,WAAW,CAAC,OAAiB;IACpC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAClC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE;YAAE,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9E,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,KAAK,GAAG,OAAO;SAClB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACnD,IAAI,CAAC,cAAc,CAAC,CAAC;IACxB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAY,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACrD,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5D,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAW,CAAC,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,uCAAuC,CAAC,CAAC;IAC7H,OAAO,MAAM,CAAC;IAEd,SAAS,OAAO,CAAC,IAAY,EAAE,EAAU;QACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,+BAA+B,EAAE,kCAAkC,IAAI,EAAE,CAAC,CAAC;QAC5H,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,+BAA+B,EAAE,kCAAkC,EAAE,EAAE,CAAC,CAAC;QACxH,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAgB,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACd,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,SAAS,cAAc,CAAC,CAAS,EAAE,CAAS;QAC1C,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9G,CAAC;AACH,CAAC"}
+{"version":3,"file":"SystemScheduler.js","sourceRoot":"","sources":["../../../../packages/ecs/src/SystemScheduler.ts"],"names":[],"mappings":"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"}

package/dist/components/CameraComponent.d.ts

@@ -0,0 +1,30 @@
+export type CameraKind = "perspective" | "orthographic";
+/**
+ * Camera parameters + computed matrices for an ECS entity.
+ *
+ * {@link CameraSystem} computes `projectionMatrix`, `viewMatrix`, and
+ * `viewProjectionMatrix` each frame from the entity's
+ * {@link WorldTransformComponent}.
+ */
+export declare class CameraComponent {
+    kind: CameraKind;
+    fovYRadians: number;
+    aspect: number;
+    near: number;
+    far: number;
+    left: number;
+    right: number;
+    bottom: number;
+    top: number;
+    zoom: number;
+    projectionMatrix: Float32Array<ArrayBuffer>;
+    viewMatrix: Float32Array<ArrayBuffer>;
+    viewProjectionMatrix: Float32Array<ArrayBuffer>;
+    viewport: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+//# sourceMappingURL=CameraComponent.d.ts.map

package/dist/components/CameraComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraComponent.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/CameraComponent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,cAAc,CAAC;AAExD;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,IAAI,EAAE,UAAU,CAAiB;IAGjC,WAAW,SAAe;IAC1B,MAAM,SAAK;IACX,IAAI,SAAO;IACX,GAAG,SAAQ;IAGX,IAAI,SAAM;IACV,KAAK,SAAK;IACV,MAAM,SAAM;IACZ,GAAG,SAAK;IACR,IAAI,SAAK;IAGT,gBAAgB,4BAAwB;IACxC,UAAU,4BAAwB;IAClC,oBAAoB,4BAAwB;IAE5C,QAAQ;;;;;MAAuC;CAChD"}

package/dist/components/CameraComponent.js

@@ -0,0 +1,27 @@
+/**
+ * Camera parameters + computed matrices for an ECS entity.
+ *
+ * {@link CameraSystem} computes `projectionMatrix`, `viewMatrix`, and
+ * `viewProjectionMatrix` each frame from the entity's
+ * {@link WorldTransformComponent}.
+ */
+export class CameraComponent {
+    kind = "perspective";
+    // Perspective
+    fovYRadians = Math.PI / 3;
+    aspect = 1;
+    near = 0.1;
+    far = 1000;
+    // Orthographic
+    left = -1;
+    right = 1;
+    bottom = -1;
+    top = 1;
+    zoom = 1;
+    // Computed each frame by CameraSystem
+    projectionMatrix = new Float32Array(16);
+    viewMatrix = new Float32Array(16);
+    viewProjectionMatrix = new Float32Array(16);
+    viewport = { x: 0, y: 0, width: 1, height: 1 };
+}
+//# sourceMappingURL=CameraComponent.js.map

package/dist/components/CameraComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraComponent.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/CameraComponent.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAC1B,IAAI,GAAe,aAAa,CAAC;IAEjC,cAAc;IACd,WAAW,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1B,MAAM,GAAG,CAAC,CAAC;IACX,IAAI,GAAG,GAAG,CAAC;IACX,GAAG,GAAG,IAAI,CAAC;IAEX,eAAe;IACf,IAAI,GAAG,CAAC,CAAC,CAAC;IACV,KAAK,GAAG,CAAC,CAAC;IACV,MAAM,GAAG,CAAC,CAAC,CAAC;IACZ,GAAG,GAAG,CAAC,CAAC;IACR,IAAI,GAAG,CAAC,CAAC;IAET,sCAAsC;IACtC,gBAAgB,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;IACxC,UAAU,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;IAClC,oBAAoB,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;IAE5C,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;CAChD"}

package/dist/components/HierarchyComponent.d.ts

@@ -8,6 +8,16 @@ export interface SerializedHierarchyComponent {
     readonly depth: number;
 }
 export declare class HierarchyComponent {
+    /**
+     * Parent entity, or `null` for root entities.
+     *
+     * Must be set via `HierarchySystem.setParent` (or `addChild`), which
+     * maintains {@link depth}, sibling links, and the parent's child list.
+     * Setting this field directly (including via the constructor argument)
+     * leaves `depth` stale at 0 — `TransformSystem` recomputes depth
+     * defensively for its parents-before-children ordering, but child/sibling
+     * bookkeeping will remain out of sync until `setParent` is used.
+     */
     parent: Entity | null;
     previousSibling: Entity | null;
     nextSibling: Entity | null;

package/dist/components/HierarchyComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HierarchyComponent.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/HierarchyComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAyB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAkB;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IACtC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAClC,KAAK,SAAK;IACV,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,MAAM,GAAE,MAAM,GAAG,IAAW;IAIxC,IAAI,QAAQ,IAAI,SAAS,MAAM,EAAE,CAEhC;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,SAAS,IAAI,OAAO;IAIpB,WAAW,IAAI,OAAO;IAItB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAItC,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrD,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAKxC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIvC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOpC,cAAc,IAAI,IAAI;IAItB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO9C,MAAM,IAAI,4BAA4B;IAUtC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAkBrC;CACH"}
+{"version":3,"file":"HierarchyComponent.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/HierarchyComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAyB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAkB;IAC7B;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IACtC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAClC,KAAK,SAAK;IACV,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,MAAM,GAAE,MAAM,GAAG,IAAW;IAIxC,IAAI,QAAQ,IAAI,SAAS,MAAM,EAAE,CAEhC;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,SAAS,IAAI,OAAO;IAIpB,WAAW,IAAI,OAAO;IAItB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAItC,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrD,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAKxC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIvC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOpC,cAAc,IAAI,IAAI;IAItB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO9C,MAAM,IAAI,4BAA4B;IAUtC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAkBrC;CACH"}

package/dist/components/HierarchyComponent.js

@@ -2,6 +2,16 @@ import { ValidationError } from "@aura3d/core";
 import {} from "../Component.js";
 import { entityKey, sameEntity } from "../Entity.js";
 export class HierarchyComponent {
+    /**
+     * Parent entity, or `null` for root entities.
+     *
+     * Must be set via `HierarchySystem.setParent` (or `addChild`), which
+     * maintains {@link depth}, sibling links, and the parent's child list.
+     * Setting this field directly (including via the constructor argument)
+     * leaves `depth` stale at 0 — `TransformSystem` recomputes depth
+     * defensively for its parents-before-children ordering, but child/sibling
+     * bookkeeping will remain out of sync until `setParent` is used.
+     */
     parent;
     previousSibling = null;
     nextSibling = null;

package/dist/components/HierarchyComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"HierarchyComponent.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/HierarchyComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAwB,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAe,MAAM,cAAc,CAAC;AAUlE,MAAM,OAAO,kBAAkB;IAC7B,MAAM,CAAgB;IACtB,eAAe,GAAkB,IAAI,CAAC;IACtC,WAAW,GAAkB,IAAI,CAAC;IAClC,KAAK,GAAG,CAAC,CAAC;IACO,aAAa,GAAa,EAAE,CAAC;IAE9C,YAAY,SAAwB,IAAI;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACvC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;IACnE,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,aAAa,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,YAAY,CAAC,QAAiC;QAC5C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;IAED,eAAe,CAAC,MAAe;QAC7B,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,UAAU,CAAC,MAAqB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;IAED,YAAY,CAAC,KAAa;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAChF,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,KAAa;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAClF,IAAI,OAAO,GAAG,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,qBAAqB,EAAE,0BAA0B,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChH,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM;QACJ,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;YAC/C,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YAC3D,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI;YAC1E,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;YAC9D,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,MAAM,GAAoB;QACxC,OAAO,EAAE,CAAC;QACV,SAAS,CAAC,SAAiB;YACzB,OAAQ,SAAgC,CAAC,MAAM,EAAE,CAAC;QACpD,CAAC;QACD,WAAW,CAAC,IAAa;YACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,eAAe,CAAC,iCAAiC,EAAE,kDAAkD,CAAC,CAAC;YACnH,CAAC;YACD,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACrF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClC,IAAI,QAAQ,CAAC,KAAK,CAAC;oBAAE,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAClD,CAAC;YACD,SAAS,CAAC,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC;YACzF,SAAS,CAAC,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7E,SAAS,CAAC,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1H,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;;AAGJ,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACrG,CAAC"}
+{"version":3,"file":"HierarchyComponent.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/HierarchyComponent.ts"],"names":[],"mappings":"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"}

package/dist/components/LightComponent.d.ts

@@ -0,0 +1,18 @@
+export type LightKind = "directional" | "point" | "spot" | "ambient";
+/**
+ * Light parameters for an ECS entity.
+ *
+ * The ECS render bridge collects lights each frame and passes them to the
+ * renderer as part of the {@link RenderSource} lighting state.
+ */
+export declare class LightComponent {
+    kind: LightKind;
+    color: [number, number, number];
+    intensity: number;
+    range: number;
+    angle: number;
+    penumbra: number;
+    castsShadow: boolean;
+    layerMask: number;
+}
+//# sourceMappingURL=LightComponent.d.ts.map

package/dist/components/LightComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightComponent.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/LightComponent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAErE;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,IAAI,EAAE,SAAS,CAAiB;IAChC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAa;IAC5C,SAAS,SAAK;IACd,KAAK,SAAM;IACX,KAAK,SAAe;IACpB,QAAQ,SAAK;IACb,WAAW,UAAS;IACpB,SAAS,SAAK;CACf"}

package/dist/components/LightComponent.js

@@ -0,0 +1,17 @@
+/**
+ * Light parameters for an ECS entity.
+ *
+ * The ECS render bridge collects lights each frame and passes them to the
+ * renderer as part of the {@link RenderSource} lighting state.
+ */
+export class LightComponent {
+    kind = "directional";
+    color = [1, 1, 1];
+    intensity = 1;
+    range = 10;
+    angle = Math.PI / 4; // spot only
+    penumbra = 0; // spot only
+    castsShadow = false;
+    layerMask = 1;
+}
+//# sourceMappingURL=LightComponent.js.map

package/dist/components/LightComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightComponent.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/LightComponent.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACzB,IAAI,GAAc,aAAa,CAAC;IAChC,KAAK,GAA6B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,SAAS,GAAG,CAAC,CAAC;IACd,KAAK,GAAG,EAAE,CAAC;IACX,KAAK,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY;IACjC,QAAQ,GAAG,CAAC,CAAC,CAAC,YAAY;IAC1B,WAAW,GAAG,KAAK,CAAC;IACpB,SAAS,GAAG,CAAC,CAAC;CACf"}

package/dist/components/MeshComponent.d.ts

@@ -0,0 +1,19 @@
+import type { SkinningPaletteBinding } from "@aura3d/rendering";
+/**
+ * Renderable geometry + material binding for an ECS entity.
+ *
+ * References resources by name/handle; the ECS render bridge resolves them
+ * through the {@link ECSRenderLibraries} map at collection time.
+ */
+export declare class MeshComponent {
+    geometry: string;
+    material: string;
+    castShadow: boolean;
+    receiveShadow: boolean;
+    skinning?: SkinningPaletteBinding;
+    morphWeights?: readonly number[];
+    instanceTransforms?: Float32Array;
+    instanceColors?: Float32Array;
+    constructor(geometry: string, material: string);
+}
+//# sourceMappingURL=MeshComponent.d.ts.map

package/dist/components/MeshComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeshComponent.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/MeshComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,UAAQ;IAClB,aAAa,UAAQ;IACrB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,kBAAkB,CAAC,EAAE,YAAY,CAAC;IAClC,cAAc,CAAC,EAAE,YAAY,CAAC;gBAElB,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAI/C"}

package/dist/components/MeshComponent.js

@@ -0,0 +1,21 @@
+/**
+ * Renderable geometry + material binding for an ECS entity.
+ *
+ * References resources by name/handle; the ECS render bridge resolves them
+ * through the {@link ECSRenderLibraries} map at collection time.
+ */
+export class MeshComponent {
+    geometry;
+    material;
+    castShadow = true;
+    receiveShadow = true;
+    skinning;
+    morphWeights;
+    instanceTransforms;
+    instanceColors;
+    constructor(geometry, material) {
+        this.geometry = geometry;
+        this.material = material;
+    }
+}
+//# sourceMappingURL=MeshComponent.js.map

package/dist/components/MeshComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeshComponent.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/MeshComponent.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACxB,QAAQ,CAAS;IACjB,QAAQ,CAAS;IACjB,UAAU,GAAG,IAAI,CAAC;IAClB,aAAa,GAAG,IAAI,CAAC;IACrB,QAAQ,CAA0B;IAClC,YAAY,CAAqB;IACjC,kBAAkB,CAAgB;IAClC,cAAc,CAAgB;IAE9B,YAAY,QAAgB,EAAE,QAAgB;QAC5C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/dist/components/WorldTransformComponent.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Computed world-space transform for an ECS entity.
+ *
+ * Written by {@link TransformSystem} each frame from the entity's
+ * {@link TransformComponent} and {@link HierarchyComponent} parent chain.
+ * The renderer bridge reads this directly — it never touches local transforms.
+ */
+export declare class WorldTransformComponent {
+    worldMatrix: Float32Array<ArrayBuffer>;
+    normalMatrix: Float32Array<ArrayBuffer>;
+}
+//# sourceMappingURL=WorldTransformComponent.d.ts.map

package/dist/components/WorldTransformComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorldTransformComponent.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/WorldTransformComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,uBAAuB;IAClC,WAAW,4BAKR;IAEH,YAAY,4BAKT;CACJ"}

package/dist/components/WorldTransformComponent.js

@@ -0,0 +1,22 @@
+/**
+ * Computed world-space transform for an ECS entity.
+ *
+ * Written by {@link TransformSystem} each frame from the entity's
+ * {@link TransformComponent} and {@link HierarchyComponent} parent chain.
+ * The renderer bridge reads this directly — it never touches local transforms.
+ */
+export class WorldTransformComponent {
+    worldMatrix = new Float32Array([
+        1, 0, 0, 0,
+        0, 1, 0, 0,
+        0, 0, 1, 0,
+        0, 0, 0, 1
+    ]);
+    normalMatrix = new Float32Array([
+        1, 0, 0, 0,
+        0, 1, 0, 0,
+        0, 0, 1, 0,
+        0, 0, 0, 1
+    ]);
+}
+//# sourceMappingURL=WorldTransformComponent.js.map

package/dist/components/WorldTransformComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorldTransformComponent.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/components/WorldTransformComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IAClC,WAAW,GAAG,IAAI,YAAY,CAAC;QAC7B,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,YAAY,GAAG,IAAI,YAAY,CAAC;QAC9B,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;KACX,CAAC,CAAC;CACJ"}

package/dist/index.d.ts

@@ -14,6 +14,10 @@ export * from "./World.js";
 export * from "./ECSSerializer.js";
 export * from "./ECSProfiler.js";
 export * from "./components/TransformComponent.js";
+export * from "./components/WorldTransformComponent.js";
+export * from "./components/CameraComponent.js";
+export * from "./components/LightComponent.js";
+export * from "./components/MeshComponent.js";
 export * from "./components/NameComponent.js";
 export * from "./components/TagComponent.js";
 export * from "./components/ActiveComponent.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/ecs/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -14,6 +14,10 @@ export * from "./World.js";
 export * from "./ECSSerializer.js";
 export * from "./ECSProfiler.js";
 export * from "./components/TransformComponent.js";
+export * from "./components/WorldTransformComponent.js";
+export * from "./components/CameraComponent.js";
+export * from "./components/LightComponent.js";
+export * from "./components/MeshComponent.js";
 export * from "./components/NameComponent.js";
 export * from "./components/TagComponent.js";
 export * from "./components/ActiveComponent.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/ecs/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/ecs/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC"}

package/dist/systems/CameraSystem.d.ts

@@ -0,0 +1,17 @@
+import { type System, type SystemContext } from "../System.js";
+import { type World } from "../World.js";
+/**
+ * Computes camera projection and view matrices for entities that have
+ * both {@link CameraComponent} and {@link WorldTransformComponent}.
+ *
+ * Runs after {@link TransformSystem} so the camera entity's world matrix
+ * is already computed.
+ */
+export declare class CameraSystem implements System {
+    readonly name = "CameraSystem";
+    readonly phase = "update";
+    readonly priority = -70;
+    readonly after: string[];
+    update(world: World, _context: SystemContext): void;
+}
+//# sourceMappingURL=CameraSystem.d.ts.map

package/dist/systems/CameraSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraSystem.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/systems/CameraSystem.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAIzC;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,MAAM;IACzC,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,KAAK,YAAY;IAC1B,QAAQ,CAAC,QAAQ,OAAO;IAGxB,QAAQ,CAAC,KAAK,WAAuB;IAErC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;CA4BpD"}

package/dist/systems/CameraSystem.js

@@ -0,0 +1,38 @@
+import { Matrix4 } from "@aura3d/math";
+import {} from "../System.js";
+import {} from "../World.js";
+import { CameraComponent } from "../components/CameraComponent.js";
+import { WorldTransformComponent } from "../components/WorldTransformComponent.js";
+/**
+ * Computes camera projection and view matrices for entities that have
+ * both {@link CameraComponent} and {@link WorldTransformComponent}.
+ *
+ * Runs after {@link TransformSystem} so the camera entity's world matrix
+ * is already computed.
+ */
+export class CameraSystem {
+    name = "CameraSystem";
+    phase = "update";
+    priority = -70;
+    // Soft ordering constraint: the scheduler skips this edge when
+    // TransformSystem is not registered, so CameraSystem can run standalone.
+    after = ["TransformSystem"];
+    update(world, _context) {
+        for (const entity of world
+            .query({ include: [CameraComponent, WorldTransformComponent] })
+            .toArray()) {
+            const cam = world.get(entity, CameraComponent);
+            const wt = world.get(entity, WorldTransformComponent);
+            const projection = cam.kind === "perspective"
+                ? Matrix4.perspective(cam.fovYRadians, cam.aspect, cam.near, cam.far)
+                : Matrix4.orthographic(cam.left / cam.zoom, cam.right / cam.zoom, cam.bottom / cam.zoom, cam.top / cam.zoom, cam.near, cam.far);
+            // viewMatrix = inverse(worldMatrix)
+            const worldMat = new Matrix4(wt.worldMatrix);
+            const view = worldMat.inverse();
+            cam.projectionMatrix.set(projection.elements);
+            cam.viewMatrix.set(view.elements);
+            cam.viewProjectionMatrix.set(projection.multiply(view).elements);
+        }
+    }
+}
+//# sourceMappingURL=CameraSystem.js.map

package/dist/systems/CameraSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraSystem.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/systems/CameraSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAmC,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAc,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,cAAc,CAAC;IACtB,KAAK,GAAG,QAAQ,CAAC;IACjB,QAAQ,GAAG,CAAC,EAAE,CAAC;IACxB,+DAA+D;IAC/D,yEAAyE;IAChE,KAAK,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAErC,MAAM,CAAC,KAAY,EAAE,QAAuB;QAC1C,KAAK,MAAM,MAAM,IAAI,KAAK;aACvB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,eAAe,EAAE,uBAAuB,CAAC,EAAE,CAAC;aAC9D,OAAO,EAAE,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAE,CAAC;YAChD,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAE,CAAC;YAEvD,MAAM,UAAU,GACd,GAAG,CAAC,IAAI,KAAK,aAAa;gBACxB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;gBACrE,CAAC,CAAC,OAAO,CAAC,YAAY,CAClB,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,EACnB,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,EACpB,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,EACrB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,EAClB,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,GAAG,CACR,CAAC;YAER,oCAAoC;YACpC,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,EAAE,CAAC,WAA6C,CAAC,CAAC;YAC/E,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;YAE/B,GAAG,CAAC,gBAAiC,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC/D,GAAG,CAAC,UAA2B,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnD,GAAG,CAAC,oBAAqC,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;CACF"}

package/dist/systems/TransformSystem.d.ts

@@ -0,0 +1,16 @@
+import { type System, type SystemContext } from "../System.js";
+import { type World } from "../World.js";
+/**
+ * Computes {@link WorldTransformComponent} for every entity that has both
+ * {@link TransformComponent} and {@link HierarchyComponent}.
+ *
+ * Entities are processed in depth order (parents before children) so the
+ * world matrix cascade is correct in a single pass.
+ */
+export declare class TransformSystem implements System {
+    readonly name = "TransformSystem";
+    readonly phase = "update";
+    readonly priority = -80;
+    update(world: World, _context: SystemContext): void;
+}
+//# sourceMappingURL=TransformSystem.d.ts.map

package/dist/systems/TransformSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformSystem.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/systems/TransformSystem.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAQzC;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,MAAM;IAC5C,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,KAAK,YAAY;IAC1B,QAAQ,CAAC,QAAQ,OAAO;IAExB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;CAmCpD"}

package/dist/systems/TransformSystem.js

@@ -0,0 +1,99 @@
+import { Matrix4, Quaternion, Vector3 } from "@aura3d/math";
+import {} from "../Entity.js";
+import {} from "../System.js";
+import {} from "../World.js";
+import { HierarchyComponent } from "../components/HierarchyComponent.js";
+import { TransformComponent } from "../components/TransformComponent.js";
+import { WorldTransformComponent } from "../components/WorldTransformComponent.js";
+/** Safety cap for defensive parent-chain walks (guards against cycles created by direct `parent` mutation). */
+const MAX_HIERARCHY_DEPTH = 4096;
+/**
+ * Computes {@link WorldTransformComponent} for every entity that has both
+ * {@link TransformComponent} and {@link HierarchyComponent}.
+ *
+ * Entities are processed in depth order (parents before children) so the
+ * world matrix cascade is correct in a single pass.
+ */
+export class TransformSystem {
+    name = "TransformSystem";
+    phase = "update";
+    priority = -80;
+    update(world, _context) {
+        const entities = world
+            .query({ include: [TransformComponent, HierarchyComponent] })
+            .toArray()
+            .sort((a, b) => effectiveDepth(world, a) - effectiveDepth(world, b));
+        for (const entity of entities) {
+            const transform = world.get(entity, TransformComponent);
+            const hierarchy = world.get(entity, HierarchyComponent);
+            const local = Matrix4.compose(new Vector3(...transform.position), new Quaternion(...transform.rotation), new Vector3(...transform.scale));
+            let worldMat;
+            if (hierarchy.parent) {
+                const parentWtc = world.get(hierarchy.parent, WorldTransformComponent);
+                worldMat = parentWtc
+                    ? new Matrix4(parentWtc.worldMatrix).multiply(local)
+                    : local;
+            }
+            else {
+                worldMat = local;
+            }
+            let wtc = world.get(entity, WorldTransformComponent);
+            if (!wtc) {
+                wtc = new WorldTransformComponent();
+                world.add(entity, WorldTransformComponent, wtc);
+            }
+            wtc.worldMatrix.set(worldMat.elements);
+            wtc.normalMatrix.set(computeNormalMatrix(worldMat));
+        }
+    }
+}
+/**
+ * Returns the depth used for parents-before-children ordering.
+ *
+ * {@link HierarchyComponent.depth} is maintained by `HierarchySystem.setParent`.
+ * If `parent` was set directly (constructor argument or field mutation) the
+ * stored depth is stale at 0, so recompute it defensively by walking the
+ * parent chain.
+ */
+function effectiveDepth(world, entity) {
+    const hierarchy = world.get(entity, HierarchyComponent);
+    if (!hierarchy)
+        return 0;
+    if (hierarchy.depth > 0 || hierarchy.parent === null)
+        return hierarchy.depth;
+    let depth = 0;
+    let current = hierarchy.parent;
+    while (current && depth < MAX_HIERARCHY_DEPTH) {
+        depth += 1;
+        const parentHierarchy = world.entities.isAlive(current)
+            ? world.get(current, HierarchyComponent)
+            : undefined;
+        current = parentHierarchy?.parent ?? null;
+    }
+    return depth;
+}
+function computeNormalMatrix(worldMat) {
+    // Normal matrix = inverse-TRANSPOSE of the world matrix, matching the
+    // renderer's reference `normalMatrixFromModel` (Renderer.ts):
+    // transpose(invert(model)), then extract the upper-left 3x3 into a 4x4
+    // with identity in the 4th row/col (column-major layout).
+    // Avoid crashing on singular matrices (zero scale) by falling back to identity.
+    try {
+        const m = worldMat.inverse().transpose().elements;
+        return new Float32Array([
+            m[0], m[1], m[2], 0,
+            m[4], m[5], m[6], 0,
+            m[8], m[9], m[10], 0,
+            0, 0, 0, 1,
+        ]);
+    }
+    catch {
+        return new Float32Array([
+            1, 0, 0, 0,
+            0, 1, 0, 0,
+            0, 0, 1, 0,
+            0, 0, 0, 1,
+        ]);
+    }
+}
+//# sourceMappingURL=TransformSystem.js.map

package/dist/systems/TransformSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformSystem.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/systems/TransformSystem.ts"],"names":[],"mappings":"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"}

package/dist/systems/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./ActiveSystem.js";
 export * from "./HierarchySystem.js";
+export * from "./TransformSystem.js";
+export * from "./CameraSystem.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/systems/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/systems/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/ecs/src/systems/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/systems/index.js

@@ -1,3 +1,5 @@
 export * from "./ActiveSystem.js";
 export * from "./HierarchySystem.js";
+export * from "./TransformSystem.js";
+export * from "./CameraSystem.js";
 //# sourceMappingURL=index.js.map

package/dist/systems/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/systems/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/ecs/src/systems/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/ecs",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,7 +12,7 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@aura3d/math": "1.3.2",
-    "@aura3d/core": "1.3.2"
+    "@aura3d/core": "1.3.3",
+    "@aura3d/math": "1.3.3"
   }
 }

package/src/SystemScheduler.ts

@@ -64,8 +64,10 @@ function sortSystems(systems: System[]): System[] {
   return result;
 
   function addEdge(from: string, to: string): void {
-    if (!byName.has(from)) throw new ValidationError("MISSING_ECS_SYSTEM_DEPENDENCY", `Missing ECS system dependency: ${from}`);
-    if (!byName.has(to)) throw new ValidationError("MISSING_ECS_SYSTEM_DEPENDENCY", `Missing ECS system dependency: ${to}`);
+    // `before`/`after` are soft ordering constraints: if the referenced
+    // system is not registered (or runs in a different phase), the edge is
+    // simply skipped instead of failing the whole schedule.
+    if (!byName.has(from) || !byName.has(to)) return;
     const edges = graph.get(from) as Set<string>;
     if (!edges.has(to)) {
       edges.add(to);

package/src/components/CameraComponent.ts

@@ -0,0 +1,32 @@
+export type CameraKind = "perspective" | "orthographic";
+
+/**
+ * Camera parameters + computed matrices for an ECS entity.
+ *
+ * {@link CameraSystem} computes `projectionMatrix`, `viewMatrix`, and
+ * `viewProjectionMatrix` each frame from the entity's
+ * {@link WorldTransformComponent}.
+ */
+export class CameraComponent {
+  kind: CameraKind = "perspective";
+
+  // Perspective
+  fovYRadians = Math.PI / 3;
+  aspect = 1;
+  near = 0.1;
+  far = 1000;
+
+  // Orthographic
+  left = -1;
+  right = 1;
+  bottom = -1;
+  top = 1;
+  zoom = 1;
+
+  // Computed each frame by CameraSystem
+  projectionMatrix = new Float32Array(16);
+  viewMatrix = new Float32Array(16);
+  viewProjectionMatrix = new Float32Array(16);
+
+  viewport = { x: 0, y: 0, width: 1, height: 1 };
+}

package/src/components/HierarchyComponent.ts

@@ -11,6 +11,16 @@ export interface SerializedHierarchyComponent {
 }
 
 export class HierarchyComponent {
+  /**
+   * Parent entity, or `null` for root entities.
+   *
+   * Must be set via `HierarchySystem.setParent` (or `addChild`), which
+   * maintains {@link depth}, sibling links, and the parent's child list.
+   * Setting this field directly (including via the constructor argument)
+   * leaves `depth` stale at 0 — `TransformSystem` recomputes depth
+   * defensively for its parents-before-children ordering, but child/sibling
+   * bookkeeping will remain out of sync until `setParent` is used.
+   */
   parent: Entity | null;
   previousSibling: Entity | null = null;
   nextSibling: Entity | null = null;

package/src/components/LightComponent.ts

@@ -0,0 +1,18 @@
+export type LightKind = "directional" | "point" | "spot" | "ambient";
+
+/**
+ * Light parameters for an ECS entity.
+ *
+ * The ECS render bridge collects lights each frame and passes them to the
+ * renderer as part of the {@link RenderSource} lighting state.
+ */
+export class LightComponent {
+  kind: LightKind = "directional";
+  color: [number, number, number] = [1, 1, 1];
+  intensity = 1;
+  range = 10;
+  angle = Math.PI / 4; // spot only
+  penumbra = 0; // spot only
+  castsShadow = false;
+  layerMask = 1;
+}

package/src/components/MeshComponent.ts

@@ -0,0 +1,23 @@
+import type { SkinningPaletteBinding } from "@aura3d/rendering";
+
+/**
+ * Renderable geometry + material binding for an ECS entity.
+ *
+ * References resources by name/handle; the ECS render bridge resolves them
+ * through the {@link ECSRenderLibraries} map at collection time.
+ */
+export class MeshComponent {
+  geometry: string;
+  material: string;
+  castShadow = true;
+  receiveShadow = true;
+  skinning?: SkinningPaletteBinding;
+  morphWeights?: readonly number[];
+  instanceTransforms?: Float32Array;
+  instanceColors?: Float32Array;
+
+  constructor(geometry: string, material: string) {
+    this.geometry = geometry;
+    this.material = material;
+  }
+}

package/src/components/WorldTransformComponent.ts

@@ -0,0 +1,22 @@
+/**
+ * Computed world-space transform for an ECS entity.
+ *
+ * Written by {@link TransformSystem} each frame from the entity's
+ * {@link TransformComponent} and {@link HierarchyComponent} parent chain.
+ * The renderer bridge reads this directly — it never touches local transforms.
+ */
+export class WorldTransformComponent {
+  worldMatrix = new Float32Array([
+    1, 0, 0, 0,
+    0, 1, 0, 0,
+    0, 0, 1, 0,
+    0, 0, 0, 1
+  ]);
+
+  normalMatrix = new Float32Array([
+    1, 0, 0, 0,
+    0, 1, 0, 0,
+    0, 0, 1, 0,
+    0, 0, 0, 1
+  ]);
+}

package/src/index.ts

@@ -14,6 +14,10 @@ export * from "./World.js";
 export * from "./ECSSerializer.js";
 export * from "./ECSProfiler.js";
 export * from "./components/TransformComponent.js";
+export * from "./components/WorldTransformComponent.js";
+export * from "./components/CameraComponent.js";
+export * from "./components/LightComponent.js";
+export * from "./components/MeshComponent.js";
 export * from "./components/NameComponent.js";
 export * from "./components/TagComponent.js";
 export * from "./components/ActiveComponent.js";

package/src/systems/CameraSystem.ts

@@ -0,0 +1,50 @@
+import { Matrix4 } from "@aura3d/math";
+import { type System, type SystemContext } from "../System.js";
+import { type World } from "../World.js";
+import { CameraComponent } from "../components/CameraComponent.js";
+import { WorldTransformComponent } from "../components/WorldTransformComponent.js";
+
+/**
+ * Computes camera projection and view matrices for entities that have
+ * both {@link CameraComponent} and {@link WorldTransformComponent}.
+ *
+ * Runs after {@link TransformSystem} so the camera entity's world matrix
+ * is already computed.
+ */
+export class CameraSystem implements System {
+  readonly name = "CameraSystem";
+  readonly phase = "update";
+  readonly priority = -70;
+  // Soft ordering constraint: the scheduler skips this edge when
+  // TransformSystem is not registered, so CameraSystem can run standalone.
+  readonly after = ["TransformSystem"];
+
+  update(world: World, _context: SystemContext): void {
+    for (const entity of world
+      .query({ include: [CameraComponent, WorldTransformComponent] })
+      .toArray()) {
+      const cam = world.get(entity, CameraComponent)!;
+      const wt = world.get(entity, WorldTransformComponent)!;
+
+      const projection =
+        cam.kind === "perspective"
+          ? Matrix4.perspective(cam.fovYRadians, cam.aspect, cam.near, cam.far)
+          : Matrix4.orthographic(
+              cam.left / cam.zoom,
+              cam.right / cam.zoom,
+              cam.bottom / cam.zoom,
+              cam.top / cam.zoom,
+              cam.near,
+              cam.far
+            );
+
+      // viewMatrix = inverse(worldMatrix)
+      const worldMat = new Matrix4(wt.worldMatrix as unknown as Matrix4["elements"]);
+      const view = worldMat.inverse();
+
+      (cam.projectionMatrix as Float32Array).set(projection.elements);
+      (cam.viewMatrix as Float32Array).set(view.elements);
+      (cam.viewProjectionMatrix as Float32Array).set(projection.multiply(view).elements);
+    }
+  }
+}

package/src/systems/TransformSystem.ts

@@ -0,0 +1,108 @@
+import { Matrix4, Quaternion, Vector3 } from "@aura3d/math";
+import { type Entity } from "../Entity.js";
+import { type System, type SystemContext } from "../System.js";
+import { type World } from "../World.js";
+import { HierarchyComponent } from "../components/HierarchyComponent.js";
+import { TransformComponent } from "../components/TransformComponent.js";
+import { WorldTransformComponent } from "../components/WorldTransformComponent.js";
+
+/** Safety cap for defensive parent-chain walks (guards against cycles created by direct `parent` mutation). */
+const MAX_HIERARCHY_DEPTH = 4096;
+
+/**
+ * Computes {@link WorldTransformComponent} for every entity that has both
+ * {@link TransformComponent} and {@link HierarchyComponent}.
+ *
+ * Entities are processed in depth order (parents before children) so the
+ * world matrix cascade is correct in a single pass.
+ */
+export class TransformSystem implements System {
+  readonly name = "TransformSystem";
+  readonly phase = "update";
+  readonly priority = -80;
+
+  update(world: World, _context: SystemContext): void {
+    const entities = world
+      .query({ include: [TransformComponent, HierarchyComponent] })
+      .toArray()
+      .sort((a, b) => effectiveDepth(world, a) - effectiveDepth(world, b));
+
+    for (const entity of entities) {
+      const transform = world.get(entity, TransformComponent)!;
+      const hierarchy = world.get(entity, HierarchyComponent)!;
+
+      const local = Matrix4.compose(
+        new Vector3(...transform.position),
+        new Quaternion(...transform.rotation),
+        new Vector3(...transform.scale)
+      );
+
+      let worldMat: Matrix4;
+      if (hierarchy.parent) {
+        const parentWtc = world.get(hierarchy.parent, WorldTransformComponent);
+        worldMat = parentWtc
+          ? new Matrix4(parentWtc.worldMatrix as unknown as Matrix4["elements"]).multiply(local)
+          : local;
+      } else {
+        worldMat = local;
+      }
+
+      let wtc = world.get(entity, WorldTransformComponent);
+      if (!wtc) {
+        wtc = new WorldTransformComponent();
+        world.add(entity, WorldTransformComponent, wtc);
+      }
+      (wtc.worldMatrix as Float32Array).set(worldMat.elements);
+      (wtc.normalMatrix as Float32Array).set(computeNormalMatrix(worldMat));
+    }
+  }
+}
+
+/**
+ * Returns the depth used for parents-before-children ordering.
+ *
+ * {@link HierarchyComponent.depth} is maintained by `HierarchySystem.setParent`.
+ * If `parent` was set directly (constructor argument or field mutation) the
+ * stored depth is stale at 0, so recompute it defensively by walking the
+ * parent chain.
+ */
+function effectiveDepth(world: World, entity: Entity): number {
+  const hierarchy = world.get(entity, HierarchyComponent);
+  if (!hierarchy) return 0;
+  if (hierarchy.depth > 0 || hierarchy.parent === null) return hierarchy.depth;
+
+  let depth = 0;
+  let current: Entity | null = hierarchy.parent;
+  while (current && depth < MAX_HIERARCHY_DEPTH) {
+    depth += 1;
+    const parentHierarchy: HierarchyComponent | undefined = world.entities.isAlive(current)
+      ? world.get(current, HierarchyComponent)
+      : undefined;
+    current = parentHierarchy?.parent ?? null;
+  }
+  return depth;
+}
+
+function computeNormalMatrix(worldMat: Matrix4): Float32Array {
+  // Normal matrix = inverse-TRANSPOSE of the world matrix, matching the
+  // renderer's reference `normalMatrixFromModel` (Renderer.ts):
+  // transpose(invert(model)), then extract the upper-left 3x3 into a 4x4
+  // with identity in the 4th row/col (column-major layout).
+  // Avoid crashing on singular matrices (zero scale) by falling back to identity.
+  try {
+    const m = worldMat.inverse().transpose().elements;
+    return new Float32Array([
+      m[0], m[1], m[2], 0,
+      m[4], m[5], m[6], 0,
+      m[8], m[9], m[10], 0,
+      0, 0, 0, 1,
+    ]);
+  } catch {
+    return new Float32Array([
+      1, 0, 0, 0,
+      0, 1, 0, 0,
+      0, 0, 1, 0,
+      0, 0, 0, 1,
+    ]);
+  }
+}

package/src/systems/index.ts

@@ -1,2 +1,4 @@
 export * from "./ActiveSystem.js";
 export * from "./HierarchySystem.js";
+export * from "./TransformSystem.js";
+export * from "./CameraSystem.js";