@vived/core 1.0.0

package/dist/ValueObjects/Vector3.test.js

@@ -0,0 +1,186 @@
+import { Vector3 } from ".";
+import { Angle } from "./Angle";
+import { Matrix } from "./Matrix";
+import { Quaternion } from "./Quaternion";
+describe("Vector 3 Value object - Creation", () => {
+    it("Creates a zero vector", () => {
+        const v = Vector3.Zero();
+        expect(v).toEqual(new Vector3(0, 0, 0));
+    });
+    it("Creates a one vector", () => {
+        const v = Vector3.One();
+        expect(v).toEqual(new Vector3(1, 1, 1));
+    });
+    it("Creates a vector from an array", () => {
+        const v = Vector3.FromArray([2, 5, 7]);
+        expect(v).toEqual(new Vector3(2, 5, 7));
+    });
+    it("Creates a unit right vector", () => {
+        const v = Vector3.Right();
+        expect(v).toEqual(new Vector3(1, 0, 0));
+    });
+    it("Creates a right vector with length", () => {
+        const v = Vector3.Right(3);
+        expect(v).toEqual(new Vector3(3, 0, 0));
+    });
+    it("Creates a unit left vector", () => {
+        const v = Vector3.Left();
+        expect(v).toEqual(new Vector3(-1, 0, 0));
+    });
+    it("Creates a left vector with length", () => {
+        const v = Vector3.Left(3);
+        expect(v).toEqual(new Vector3(-3, 0, 0));
+    });
+    it("Creates a unit up vector", () => {
+        const v = Vector3.Up();
+        expect(v).toEqual(new Vector3(0, 1, 0));
+    });
+    it("Creates a up vector with length", () => {
+        const v = Vector3.Up(3);
+        expect(v).toEqual(new Vector3(0, 3, 0));
+    });
+    it("Creates a unit down vector", () => {
+        const v = Vector3.Down();
+        expect(v).toEqual(new Vector3(0, -1, 0));
+    });
+    it("Creates a down vector with length", () => {
+        const v = Vector3.Down(3);
+        expect(v).toEqual(new Vector3(0, -3, 0));
+    });
+    it("Creates a unit forward vector", () => {
+        const v = Vector3.Forward();
+        expect(v).toEqual(new Vector3(0, 0, 1));
+    });
+    it("Creates a forward vector with length", () => {
+        const v = Vector3.Forward(3);
+        expect(v).toEqual(new Vector3(0, 0, 3));
+    });
+    it("Creates a unit backward vector", () => {
+        const v = Vector3.Backward();
+        expect(v).toEqual(new Vector3(0, 0, -1));
+    });
+    it("Creates a backward vector with length", () => {
+        const v = Vector3.Backward(3);
+        expect(v).toEqual(new Vector3(0, 0, -3));
+    });
+});
+describe("Vector 3 Value object - Static actions", () => {
+    it("Adds two vectors", () => {
+        const v1 = new Vector3(1, 2, 3);
+        const v2 = new Vector3(4, 5, 6);
+        const v3 = Vector3.Add(v1, v2);
+        expect(v3).toEqual(new Vector3(5, 7, 9));
+    });
+    test("Subtracts two vectors", () => {
+        const v1 = new Vector3(1, 2, 3);
+        const v2 = new Vector3(6, 5, 4);
+        const v3 = Vector3.Subtract(v1, v2);
+        expect(v3).toEqual(new Vector3(-5, -3, -1));
+    });
+    test("Checks if two vectors are equal", () => {
+        const v1 = new Vector3(1, 2, 3);
+        const v2 = new Vector3(4, 5, 6);
+        const v3 = new Vector3(1, 2, 3);
+        expect(Vector3.Equal(v1, v2)).toEqual(false);
+        expect(Vector3.Equal(v1, v3)).toEqual(true);
+    });
+    it("Checks if Vectors are close without a tolerance", () => {
+        const v1 = new Vector3(1, 2, 3);
+        const v2 = new Vector3(1.1, 2.2, 3.3);
+        const v3 = new Vector3(1.001, 2.001, 3.001);
+        expect(Vector3.Close(v1, v2)).toEqual(false);
+        expect(Vector3.Close(v1, v3)).toEqual(true);
+    });
+    it("Checks if Vectors are close with a tolerance", () => {
+        const v1 = new Vector3(1, 2, 3);
+        const v2 = new Vector3(1.1, 2.2, 3.3);
+        expect(Vector3.Close(v1, v2, 0.3)).toEqual(false);
+        expect(Vector3.Close(v1, v2, 0.4)).toEqual(true);
+    });
+    it("Computes the cross product", () => {
+        // From https://www.symbolab.com/solver/vector-cross-product-calculator
+        const v1 = new Vector3(1, 2, 3);
+        const v2 = new Vector3(4, 5, -6);
+        const cross = Vector3.Cross(v1, v2);
+        expect(cross).toEqual(new Vector3(-27, 18, -3));
+    });
+    test("Cross product", () => {
+        // From https://www.symbolab.com/solver/vector-cross-product-calculator
+        const v1 = new Vector3(1, 2, 3);
+        const v2 = new Vector3(4, 5, -6);
+        const cross = Vector3.Cross(v2, v1);
+        expect(cross).toEqual(new Vector3(27, -18, 3));
+    });
+    test("Dot product", () => {
+        // From https://www.calculatorsoup.com/calculators/algebra/dot-product-calculator.php
+        const v1 = new Vector3(1, 5, 3);
+        const v2 = new Vector3(2, 3, 6);
+        const dot = Vector3.Dot(v1, v2);
+        expect(dot).toEqual(35);
+    });
+    test("New vector of length", () => {
+        const v1 = new Vector3(1, -5, 3);
+        const v2 = Vector3.NewVectorOfLength(v1, 10);
+        expect(v2.x).toBeCloseTo(1.69);
+        expect(v2.y).toBeCloseTo(-8.45);
+        expect(v2.z).toBeCloseTo(5.07);
+    });
+});
+describe("Vector 3 Value object - parameters", () => {
+    it("Gets the vector components", () => {
+        const v = new Vector3(2, 5, 7);
+        expect(v.x).toEqual(2);
+        expect(v.y).toEqual(5);
+        expect(v.z).toEqual(7);
+    });
+    it("Gets the magnitue", () => {
+        // https://www.omnicalculator.com/math/unit-vector
+        const v1 = new Vector3(1, -5, 3);
+        expect(v1.magnitude).toBeCloseTo(5.916);
+    });
+    it("Gets the unit vector", () => {
+        // https://www.omnicalculator.com/math/unit-vector
+        const v1 = new Vector3(1, -5, 3);
+        expect(v1.unit.x).toBeCloseTo(0.169);
+        expect(v1.unit.y).toBeCloseTo(-0.845);
+        expect(v1.unit.z).toBeCloseTo(0.507);
+    });
+    it("Gets the vector as an array", () => {
+        const v1 = new Vector3(1, -5, 3);
+        expect(v1.array).toEqual([1, -5, 3]);
+    });
+    it("Lerps", () => {
+        const start = new Vector3(10, 20, 30);
+        const end = new Vector3(20, 30, 40);
+        const lerped = Vector3.Lerp(start, end, 0.5);
+        expect(lerped).toEqual(new Vector3(15, 25, 35));
+    });
+    it("Transforms a Vector with a matrix", () => {
+        const pos = new Vector3(5, 0, 0);
+        const rot = Quaternion.FromAngleAxis(Vector3.Up(), Angle.FromDegrees(-90));
+        const scale = new Vector3(2, 2, 2);
+        const matrix = Matrix.Compose(scale, rot, pos);
+        const transformed = Vector3.Transform(new Vector3(2, 1, -1), matrix);
+        const expected = new Vector3(7, 2, 4);
+        expect(Vector3.Close(transformed, expected)).toEqual(true);
+    });
+    it("Gets the Data Transfer Object", () => {
+        const vec = new Vector3(1, 2, 3);
+        expect(vec.dto).toEqual({
+            x: 1,
+            y: 2,
+            z: 3,
+        });
+    });
+    it("Makes a vector from a DTO", () => {
+        const vec = Vector3.FromDTO({
+            x: 1,
+            y: 2,
+            z: 3,
+        });
+        expect(vec.x).toEqual(1);
+        expect(vec.y).toEqual(2);
+        expect(vec.z).toEqual(3);
+    });
+});
+//# sourceMappingURL=Vector3.test.js.map

package/dist/ValueObjects/Vector3.test.js.map

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

package/dist/ValueObjects/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./Angle";
+export * from "./Color";
+export * from "./LineSegment2D";
+export * from "./Matrix";
+export * from "./ParametricLine";
+export * from "./ParametricPlane";
+export * from "./Quaternion";
+export * from "./Rectangle";
+export * from "./Vector2";
+export * from "./Vector3";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ValueObjects/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/ValueObjects/index.js

@@ -0,0 +1,11 @@
+export * from "./Angle";
+export * from "./Color";
+export * from "./LineSegment2D";
+export * from "./Matrix";
+export * from "./ParametricLine";
+export * from "./ParametricPlane";
+export * from "./Quaternion";
+export * from "./Rectangle";
+export * from "./Vector2";
+export * from "./Vector3";
+//# sourceMappingURL=index.js.map

package/dist/ValueObjects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ValueObjects/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./AppObject";
+export * from "./Entities";
+export * from "./Types";
+export * from "./ValueObjects";
+//# 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,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./AppObject";
+export * from "./Entities";
+export * from "./Types";
+export * from "./ValueObjects";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC"}

package/jestconfig.json

@@ -0,0 +1,10 @@
+{
+  "transform": {
+    "^.+\\.(t|j)sx?$": "ts-jest"
+  },
+  "testRegex": "(/__tests__/.*|(\\.|/)(test|spec))\\.(jsx?|tsx?)$",
+  "moduleFileExtensions": ["ts", "tsx", "js", "jsx", "json", "node"],
+  "testPathIgnorePatterns": ["/node_modules/", "/dist/"],
+  "modulePathIgnorePatterns": ["/dist/"],
+  "watchPathIgnorePatterns": ["/dist/"]
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@vived/core",
+  "version": "1.0.0",
+  "description": "Core Components for VIVED Apps and Hosts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "test": "jest --watch --config jestconfig.json",
+    "testOnce": "jest --config jestconfig.json",
+    "build": "tsc",
+    "format": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
+    "lint": "tslint -p tsconfig.json",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run testOnce && npm run lint",
+    "preversion": "npm run lint",
+    "version": "npm run format && git add -A src",
+    "postversion": "git push && git push --tags"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://bitbucket.org/cyberscience3d/npm_vived_core.git"
+  },
+  "author": "Amos Patrick",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://bitbucket.org/cyberscience3d/npm_vived_core/issues"
+  },
+  "homepage": "https://bitbucket.org/cyberscience3d/npm_vived_core#readme",
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "jest": "^29.7.0",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.2.6",
+    "tslint": "^6.1.3",
+    "tslint-config-prettier": "^1.18.0",
+    "typescript": "^5.8.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/AppObject/AppObject.test.ts

@@ -0,0 +1,158 @@
+import { AppObject, makeAppObject } from "./AppObject";
+import { AppObjectComponent } from "./AppObjectComponent";
+import { makeAppObjectRepo } from "./AppObjectRepo";
+
+export function makeTestRig() {
+  const repo = makeAppObjectRepo();
+  const appObj = makeAppObject("obj id", repo);
+  const observer = jest.fn();
+  appObj.addObserver(observer);
+
+  return { repo, appObj, observer };
+}
+
+describe("App Object", () => {
+  it("Adds itself to the repo", () => {
+    const { repo, appObj } = makeTestRig();
+
+    expect(repo.has(appObj.id)).toEqual(true);
+  });
+
+  it("Removes itself from the repo when disposed", () => {
+    const { repo, appObj } = makeTestRig();
+
+    appObj.dispose();
+    expect(repo.has(appObj.id)).toEqual(false);
+  });
+
+  it("Checks to see it has a component", () => {
+    const { appObj } = makeTestRig();
+
+    expect(appObj.hasComponent(MockComponent.type)).toEqual(false);
+
+    new MockComponent(appObj);
+
+    expect(appObj.hasComponent(MockComponent.type)).toEqual(true);
+  });
+
+  it("Notifies when an component is added", () => {
+    const { appObj, observer } = makeTestRig();
+
+    new MockComponent(appObj);
+
+    expect(observer).toBeCalled();
+  });
+
+  it("Gets a component", () => {
+    const { appObj } = makeTestRig();
+
+    expect(appObj.getComponent(MockComponent.type)).toEqual(undefined);
+
+    const mockComponent = new MockComponent(appObj);
+
+    expect(appObj.getComponent(MockComponent.type)).toEqual(mockComponent);
+  });
+
+  it("Warns if a component is replaced", () => {
+    const { appObj } = makeTestRig();
+
+    console.warn = jest.fn();
+
+    const mockComponent = new MockComponent(appObj);
+    appObj.addComponent(mockComponent);
+    appObj.addComponent(new MockComponent(appObj));
+
+    expect(console.warn).toBeCalled();
+  });
+
+  it("Returns the component list", () => {
+    const { appObj } = makeTestRig();
+
+    expect(appObj.allComponents()).toEqual([]);
+
+    const mockComponent = new MockComponent(appObj);
+    appObj.addComponent(mockComponent);
+
+    const anotherMockComponent = new AnotherMockComponent(appObj);
+    appObj.addComponent(anotherMockComponent)
+
+    expect(appObj.allComponents()).toEqual([mockComponent, anotherMockComponent]);
+  });
+
+  it("Removes a component", () => {
+    const { appObj } = makeTestRig();
+    const comp = new MockComponent(appObj);
+    appObj.addComponent(comp)
+
+    expect(appObj.hasComponent(MockComponent.type)).toEqual(true);
+
+    appObj.removeComponent(MockComponent.type);
+
+    expect(appObj.hasComponent(MockComponent.type)).toEqual(false);
+  });
+
+  it("Notifies when an component is removed", () => {
+    const { appObj, observer } = makeTestRig();
+    const comp = new MockComponent(appObj);
+    appObj.addComponent(comp)
+    observer.mockClear();
+
+    appObj.removeComponent(MockComponent.type);
+    appObj.removeComponent(MockComponent.type);
+    appObj.removeComponent(MockComponent.type);
+
+    expect(observer).toHaveBeenCalledTimes(1);
+  });
+
+  it("Disposes all components when the App Object is disposed", () => {
+    const { appObj } = makeTestRig();
+
+    const comp = new MockComponent(appObj);
+    appObj.addComponent(comp)
+
+    const spy = jest.spyOn(comp, "dispose");
+
+    appObj.dispose();
+
+    expect(spy).toBeCalled();
+  });
+
+  it("Clears the component list when disposed", () => {
+    const { appObj } = makeTestRig();
+
+    const comp = new MockComponent(appObj);
+    appObj.addComponent(comp)
+
+    expect(appObj.allComponents()).toHaveLength(1);
+
+    appObj.dispose();
+
+    expect(appObj.allComponents()).toHaveLength(0);
+  });
+
+  it("If an entity is replace, it disposes the original", () => {
+    const { appObj } = makeTestRig();
+
+    const comp = new MockComponent(appObj);
+    appObj.addComponent(comp)
+
+    const spy = jest.spyOn(comp, "dispose");
+    appObj.addComponent(new MockComponent(appObj))
+
+    expect(spy).toBeCalled();
+  });
+});
+
+class MockComponent extends AppObjectComponent {
+  static readonly type: string = "mockComponent";
+  constructor(appObject: AppObject) {
+    super(appObject, MockComponent.type)
+  }
+}
+
+class AnotherMockComponent extends AppObjectComponent {
+  static readonly type: string = "mockComponent2";
+  constructor(appObject: AppObject) {
+    super(appObject, AnotherMockComponent.type)
+  }
+}

package/src/AppObject/AppObject.ts

@@ -0,0 +1,83 @@
+import { ObservableEntity } from "../Entities";
+import { AppObjectComponent } from "./AppObjectComponent";
+import { AppObjectRepo } from "./AppObjectRepo";
+
+export abstract class AppObject extends ObservableEntity {
+  abstract readonly id: string;
+  abstract readonly appObjectRepo: AppObjectRepo;
+
+  abstract hasComponent(type: string): boolean;
+  abstract addComponent(component: AppObjectComponent): void;
+  abstract getComponent<T extends AppObjectComponent>(type: string): T | undefined;
+  abstract removeComponent(type: string): void;
+  abstract allComponents(): AppObjectComponent[];
+
+  abstract dispose(): void;
+}
+
+export function makeAppObject(id: string, repo: AppObjectRepo): AppObject {
+  return new AppObjectImp(id, repo);
+}
+
+class AppObjectImp extends AppObject {
+  readonly id: string;
+  readonly appObjectRepo: AppObjectRepo;
+
+  private componentLookup = new Map<string, AppObjectComponent>();
+
+  hasComponent(type: string): boolean {
+    return this.componentLookup.has(type);
+  }
+
+  addComponent(component: AppObjectComponent): void {
+    const currentComponent = this.componentLookup.get(component.type);
+    if (currentComponent) {
+      console.warn(
+        `[AppObject] Component ${component.type} is being replaced on ${this.id}`
+      );
+      currentComponent.dispose();
+    }
+
+    this.componentLookup.set(component.type, component);
+    this.notify();
+  }
+
+  getComponent<T extends AppObjectComponent>(type: string): T | undefined {
+    if (this.componentLookup.has(type)) {
+      return this.componentLookup.get(type) as T;
+    } else {
+      return undefined;
+    }
+  }
+
+  removeComponent(type: string): void {
+    const component = this.componentLookup.get(type);
+
+    if (!component) return;
+
+    this.componentLookup.delete(type);
+    this.notify();
+  }
+
+  allComponents(): AppObjectComponent[] {
+    return Array.from(this.componentLookup.values());
+  }
+
+
+  dispose = (): void => {
+    const components = Array.from(this.componentLookup.values());
+    this.componentLookup.clear();
+    components.forEach(c => c.dispose());
+
+    if (this.appObjectRepo.has(this.id)) {
+      this.appObjectRepo.remove(this.id);
+    }
+  };
+
+  constructor(id: string, repo: AppObjectRepo) {
+    super();
+    this.id = id;
+    this.appObjectRepo = repo;
+    this.appObjectRepo.add(this);
+  }
+}