@argila/matter 0.0.0-alpha-20250607064138

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Eduardo Lopes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/Matter.d.ts

@@ -0,0 +1,17 @@
+import { System } from "@argila/core";
+import * as MatterJS from "matter-js";
+interface MatterConfig {
+    engine: MatterJS.Engine;
+    entities?: Set<string>;
+}
+export default class Matter extends System {
+    static id: string;
+    static list: Map<string, MatterConfig>;
+    static loopType: "single" | "entity";
+    static create(world: string): MatterJS.Engine;
+    static add(world: string, entity: string, options?: MatterJS.Composites): MatterJS.Body[];
+    static tick(dt: number): void;
+    static clear(): void;
+}
+export {};
+//# sourceMappingURL=Matter.d.ts.map

package/dist/Matter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Matter.d.ts","sourceRoot":"","sources":["../src/Matter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,MAAM,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AAEtC,UAAU,YAAY;IACpB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxB;AAED,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,MAAM;IACxC,OAAc,EAAE,SAAmB;IAEnC,OAAc,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAa;IAC1D,OAAc,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAY;WAEzC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM;WAWtC,GAAG,CACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,QAAQ,CAAC,UAAU,GAC5B,QAAQ,CAAC,IAAI,EAAE;WA0CJ,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;WAQtB,KAAK,IAAI,IAAI;CAQ5B"}

package/dist/Matter.js

@@ -0,0 +1,61 @@
+"use strict";
+import { Entity, Shape, System } from "@argila/core";
+import * as MatterJS from "matter-js";
+export default class Matter extends System {
+  static id = "matter-render";
+  static list = /* @__PURE__ */ new Map();
+  static loopType = "single";
+  static create(world) {
+    const engine = MatterJS.Engine.create();
+    Matter.list.set(world, { engine, entities: /* @__PURE__ */ new Set() });
+    engine.gravity.x = 0;
+    engine.gravity.y = 1;
+    return engine;
+  }
+  static add(world, entity, options) {
+    const config = Matter.list.get(world);
+    const e = Entity.get(entity);
+    const bodies = [];
+    if (!config) {
+      return bodies;
+    }
+    if (e) {
+      config?.entities?.add(e.id);
+      const shapes = Shape.get(e.id);
+      shapes?.forEach((shape) => {
+        let body = null;
+        if (Shape.isCircle(shape)) {
+          body = MatterJS.Bodies.circle(0, 0, shape.radius, options);
+        }
+        if (Shape.isRectangle(shape)) {
+          body = MatterJS.Bodies.rectangle(
+            0,
+            0,
+            shape.width,
+            shape.height,
+            options
+          );
+        }
+        if (body) {
+          body.label = e.id;
+          MatterJS.World.addBody(config.engine.world, body);
+          bodies.push(body);
+        }
+      });
+    }
+    return bodies;
+  }
+  static tick(dt) {
+    const delta = Math.min(dt * 1e3, 1e3 / 60);
+    this.list.forEach((config) => {
+      MatterJS.Engine.update(config.engine, delta);
+    });
+  }
+  static clear() {
+    Matter.list.forEach((item) => {
+      MatterJS.World.clear(item.engine.world, false);
+      MatterJS.Engine.clear(item.engine);
+    });
+    Matter.list.clear();
+  }
+}

package/dist/Matter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Matter.test.d.ts.map

package/dist/Matter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Matter.test.d.ts","sourceRoot":"","sources":["../src/Matter.test.ts"],"names":[],"mappings":""}

package/dist/Matter.test.js

@@ -0,0 +1,32 @@
+"use strict";
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import Matter from "./Matter";
+import * as MatterJS from "matter-js";
+describe("Matter", () => {
+  beforeEach(() => {
+    Matter.clear();
+  });
+  it("should create a new Matter engine", () => {
+    const engine = Matter.create("world1");
+    expect(engine).toBeDefined();
+    expect(Matter.list.has("world1")).toBe(true);
+  });
+  it("should update the Matter engine", () => {
+    const engine = Matter.create("world1");
+    vi.spyOn(MatterJS.Engine, "update").mockImplementation(vi.fn());
+    Matter.tick(0.016);
+    expect(MatterJS.Engine.update).toHaveBeenCalledWith(
+      engine,
+      expect.any(Number)
+    );
+  });
+  it("should clear all Matter engines and worlds", () => {
+    const engine = Matter.create("world1");
+    vi.spyOn(MatterJS.World, "clear").mockImplementation(vi.fn());
+    vi.spyOn(MatterJS.Engine, "clear").mockImplementation(vi.fn());
+    Matter.clear();
+    expect(MatterJS.World.clear).toHaveBeenCalledWith(engine.world, false);
+    expect(MatterJS.Engine.clear).toHaveBeenCalledWith(engine);
+    expect(Matter.list.size).toBe(0);
+  });
+});

package/dist/Render.d.ts

@@ -0,0 +1,19 @@
+import { System } from "@argila/core";
+interface RenderConfig {
+    canvasID: string;
+}
+export default class Render implements System {
+    static id: string;
+    static loopType: "single" | "entity";
+    static list: Map<string, RenderConfig>;
+    static create(entity: string, canvasID: string): void;
+    static tick(): void;
+    static has(entity: string): boolean;
+    static set(entity: string, canvasID?: string): void;
+    static setCanvas(entity: string, canvasID?: string): void;
+    static get(config: string): RenderConfig | undefined;
+    static destroy(config: string): void;
+    static clear(): void;
+}
+export {};
+//# sourceMappingURL=Render.d.ts.map

package/dist/Render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Render.d.ts","sourceRoot":"","sources":["../src/Render.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EAGP,MAAM,cAAc,CAAC;AAItB,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,OAAO,MAAO,YAAW,MAAM;IAC3C,MAAM,CAAC,EAAE,SAAY;IACrB,OAAc,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAY;IAEvD,OAAc,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAa;WAE5C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;WAM9C,IAAI,IAAI,IAAI;WAoDZ,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;WAQ5B,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;WAY5C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;WAYlD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;WAI7C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;WAI7B,KAAK,IAAI,IAAI;CAM5B"}

package/dist/Render.js

@@ -0,0 +1,99 @@
+"use strict";
+import {
+  Canvas,
+  Shape,
+  Render as ArgilaRender,
+  Entity
+} from "@argila/core";
+import * as MatterJS from "matter-js";
+import Matter from "./Matter";
+export default class Render {
+  static id = "render";
+  static loopType = "single";
+  static list = /* @__PURE__ */ new Map();
+  static create(entity, canvasID) {
+    Render.list.set(entity, {
+      canvasID
+    });
+  }
+  static tick() {
+    Matter.list.forEach((config) => {
+      const bodies = MatterJS.Composite.allBodies(config.engine.world);
+      const ctx = Canvas.get("main")?.ctx;
+      if (ctx) {
+        ctx.save();
+        bodies.forEach((body) => {
+          const entity = Entity.get(body.label);
+          if (!entity)
+            return;
+          const shapes = Shape.get(entity.id);
+          if (!shapes)
+            return;
+          shapes.forEach((shape) => {
+            if (body.circleRadius && shape && Shape.isCircle(shape)) {
+              ArgilaRender.drawCircle(
+                ctx,
+                shape,
+                body.position.x,
+                body.position.y
+              );
+            } else if (shape && (Shape.isRectangle(shape) || Shape.isPolygon(shape))) {
+              ctx.beginPath();
+              const vertices = body.vertices;
+              ctx.moveTo(vertices[0].x, vertices[0].y);
+              for (let j = 1; j < vertices.length; j += 1) {
+                ctx.lineTo(vertices[j].x, vertices[j].y);
+              }
+              ctx.lineTo(vertices[0].x, vertices[0].y);
+              ctx.closePath();
+            }
+            ctx.fillStyle = shape?.fillColor ?? "#000";
+            ctx.fill();
+            ctx.lineWidth = shape?.strokeWidth ?? 1;
+            if (shape?.strokeColor) {
+              ctx.strokeStyle = shape?.strokeColor;
+              ctx.stroke();
+            }
+          });
+        });
+        ctx.restore();
+      }
+    });
+  }
+  static has(entity) {
+    if (!this.list) {
+      return false;
+    }
+    return this.list.has(entity);
+  }
+  static set(entity, canvasID) {
+    const config = Render.list.get(entity);
+    if (!config) {
+      return;
+    }
+    if (canvasID) {
+      config.canvasID = canvasID;
+    }
+  }
+  static setCanvas(entity, canvasID) {
+    const config = Render.list.get(entity);
+    if (!config) {
+      return;
+    }
+    if (canvasID) {
+      config.canvasID = canvasID;
+    }
+  }
+  static get(config) {
+    return Render.list.get(config);
+  }
+  static destroy(config) {
+    Render.list.delete(config);
+  }
+  static clear() {
+    Render.list.clear();
+    Render.list.forEach((_, key) => {
+      Render.destroy(key);
+    });
+  }
+}

package/dist/Render.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Render.test.d.ts.map

package/dist/Render.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Render.test.d.ts","sourceRoot":"","sources":["../src/Render.test.ts"],"names":[],"mappings":""}

package/dist/Render.test.js

@@ -0,0 +1,29 @@
+"use strict";
+import { describe, it, expect, beforeEach } from "vitest";
+import Render from "./Render";
+describe("Render", () => {
+  beforeEach(() => {
+    Render.clear();
+  });
+  it("should create a new render config", () => {
+    Render.create("entity1", "canvas1");
+    expect(Render.has("entity1")).toBe(true);
+  });
+  it("should set a canvas ID", () => {
+    Render.create("entity1", "canvas1");
+    Render.set("entity1", "canvas2");
+    expect(Render.get("entity1")?.canvasID).toBe("canvas2");
+  });
+  it("should delete a render config", () => {
+    Render.create("entity1", "canvas1");
+    Render.destroy("entity1");
+    expect(Render.has("entity1")).toBe(false);
+  });
+  it("should clear all render configs", () => {
+    Render.create("entity1", "canvas1");
+    Render.create("entity2", "canvas2");
+    Render.clear();
+    expect(Render.has("entity1")).toBe(false);
+    expect(Render.has("entity2")).toBe(false);
+  });
+});

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import Matter from "./Matter";
+import Render from "./Render";
+export { Matter, Render };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,OAAO,EACN,MAAM,EACN,MAAM,EACN,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+import Matter from "./Matter";
+import Render from "./Render";
+export {
+  Matter,
+  Render
+};

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@argila/matter",
+  "version": "0.0.0-alpha-20250607064138",
+  "description": "Matterjs implementation to be used with argila",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/*",
+        "./dist/index.d.ts"
+      ]
+    }
+  },
+  "module": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "type": "module",
+  "lint-staged": {
+    "*.{ts}": [
+      "npx rome check"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EduardoLopes/argila.git"
+  },
+  "keywords": [
+    "game",
+    "engine"
+  ],
+  "author": "Eduardo <EduardoLopesDS@gmail.com> (http://eduardolopes.dev.br)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/EduardoLopes/argila/issues"
+  },
+  "homepage": "https://github.com/EduardoLopes/argila#readme",
+  "devDependencies": {
+    "@types/matter-js": "^0.19.6",
+    "@types/uuid": "^9.0.8",
+    "@vitest/ui": "^1.5.2",
+    "del-cli": "^5.1.0",
+    "esbuild": "^0.20.2",
+    "glob": "^10.3.12",
+    "lint-staged": "^15.2.2",
+    "matter-js": "^0.19.0",
+    "nodemon": "^3.1.0",
+    "rome": "^12.1.3",
+    "type-fest": "^4.17.0",
+    "typedoc": "^0.25.13",
+    "typedoc-plugin-missing-exports": "^2.2.0",
+    "typescript": "^5.4.5",
+    "vitest": "^1.5.2",
+    "@argila/core": "^0.0.0-alpha-20250607064138"
+  },
+  "peerDependencies": {
+    "@argila/core": "0.0.0-alpha-20250607064138",
+    "matter-js": "^0.18.0"
+  },
+  "dependencies": {
+    "uuid": "^9.0.1"
+  },
+  "directories": {
+    "doc": "docs",
+    "test": "tests"
+  },
+  "scripts": {
+    "dev": "concurrently \"tsc -w\" \"nodemon esbuild.config.js\"",
+    "build": "node esbuild.config.js && tsc",
+    "watch:types": "tsc -w",
+    "clean": "rm -rf dist",
+    "test": "vitest --coverage",
+    "test:watch": "vitest",
+    "docs:build": "typedoc src/index.ts --excludeInternal",
+    "docs:serve": "python3 -m http.server -d ./docs"
+  }
+}