@vived/app 2.4.0 → 2.7.0

package/lib/Entities/ParametricPlane.d.ts

@@ -0,0 +1,20 @@
+import { ParametricLine } from "./ParametricLine";
+import { Vector3 } from "./Vector3";
+export interface PlaneParameters {
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+}
+export declare class ParametricPlane {
+    static FromPointNormal(point: Vector3, normal: Vector3): ParametricPlane;
+    static FromThreePoints(A: Vector3, B: Vector3, C: Vector3): ParametricPlane;
+    static XY(): ParametricPlane;
+    static ZX(): ParametricPlane;
+    static YZ(): ParametricPlane;
+    private point;
+    private normal;
+    getParameters(): PlaneParameters;
+    intersectLine(line: ParametricLine): Vector3 | undefined;
+    constructor(point: Vector3, normal: Vector3);
+}

package/lib/Entities/ParametricPlane.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParametricPlane = void 0;
+const Vector3_1 = require("./Vector3");
+class ParametricPlane {
+    constructor(point, normal) {
+        this.point = point.copy();
+        this.normal = normal.copy();
+    }
+    static FromPointNormal(point, normal) {
+        return new ParametricPlane(point, normal);
+    }
+    static FromThreePoints(A, B, C) {
+        const point = A;
+        const AB = B.subtract(A);
+        const AC = C.subtract(A);
+        const normal = AB.cross(AC);
+        return new ParametricPlane(point, normal);
+    }
+    static XY() {
+        const p = Vector3_1.Vector3.Zero();
+        const n = new Vector3_1.Vector3(0, 0, 1);
+        return new ParametricPlane(p, n);
+    }
+    static ZX() {
+        const p = Vector3_1.Vector3.Zero();
+        const n = new Vector3_1.Vector3(0, 1, 0);
+        return new ParametricPlane(p, n);
+    }
+    static YZ() {
+        const p = Vector3_1.Vector3.Zero();
+        const n = new Vector3_1.Vector3(1, 0, 0);
+        return new ParametricPlane(p, n);
+    }
+    getParameters() {
+        const a = this.normal.x;
+        const b = this.normal.y;
+        const c = this.normal.z;
+        let d = this.point.dot(this.normal);
+        if (d !== 0) {
+            d *= -1;
+        }
+        return {
+            a,
+            b,
+            c,
+            d,
+        };
+    }
+    intersectLine(line) {
+        const { x0, y0, z0, a, b, c } = line.getParameters();
+        const { a: A, b: B, c: C, d: D } = this.getParameters();
+        const tNumerator = -(A * x0 + B * y0 + C * z0 + D);
+        const tDenominator = A * a + B * b + C * c;
+        if (tDenominator === 0) {
+            return undefined;
+        }
+        const t = tNumerator / tDenominator;
+        const intersect = line.getPointAtDistance(t);
+        return intersect;
+    }
+}
+exports.ParametricPlane = ParametricPlane;

package/lib/Entities/StateMachine.d.ts

@@ -0,0 +1,25 @@
+export interface SerializedStates {
+    version: number;
+    systems: SystemState[];
+}
+export interface SystemState {
+    name: string;
+    seriliziationVersion: number;
+    state: object;
+}
+export interface SerializedSystem {
+    name: string;
+    seriliziationVersion: number;
+    getSystemState(): object;
+    applySystemState(state: object, version: number, transitionDuration: number): void;
+    applyDefaultState(transitionDuration: number): void;
+}
+export interface StateMachine {
+    transitionEaseFunction: (normalizedTime: number) => number;
+    getSerializedStates(): SerializedStates;
+    setSerializedStates(state: SerializedStates, transitionTime: number): void;
+    applySerializedStatesString: (state: string, duration?: number) => void;
+    setDefaultState(transitionTime: number): void;
+    registerSerializedSystem(serializedSystem: SerializedSystem): void;
+}
+export declare function makeStateMachine(): StateMachine;

package/lib/Entities/StateMachine.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeStateMachine = void 0;
+function makeStateMachine() {
+    return new StateMachineImp();
+}
+exports.makeStateMachine = makeStateMachine;
+class StateMachineImp {
+    constructor() {
+        this.serializedSystems = new Map();
+        this.serilizationVersion = 2;
+        this.transitionEaseFunction = (normalizedTime) => {
+            return normalizedTime; // default to a linear function
+        };
+        this.applySerializedStatesString = (state, duration = 0) => {
+            if (state === "") {
+                this.setDefaultState(duration);
+            }
+            else {
+                try {
+                    const stateObj = JSON.parse(state);
+                    this.setSerializedStates(stateObj, duration);
+                }
+                catch (e) {
+                    this.setDefaultState(duration);
+                    console.warn("[StateMachine] Failed to deserialize state string: " + e);
+                }
+            }
+        };
+        this.registerSerializedSystem = (serializedSystem) => {
+            if (this.serializedSystems.has(serializedSystem.name)) {
+                throw new Error(`[StateMachine] Duplicate stateable systems encountered: ${serializedSystem.name}`);
+            }
+            this.serializedSystems.set(serializedSystem.name, serializedSystem);
+        };
+        this.getSerializedStates = () => {
+            const systems = Array.from(this.serializedSystems.values());
+            const serializedStates = systems.map((system) => {
+                const state = system.getSystemState();
+                return {
+                    seriliziationVersion: system.seriliziationVersion,
+                    name: system.name,
+                    state,
+                };
+            });
+            return {
+                version: this.serilizationVersion,
+                systems: serializedStates,
+            };
+        };
+        this.setSerializedStates = (state, duration) => {
+            if (state.version === 2) {
+                const appliedToSystems = [];
+                state.systems.forEach((systemState) => {
+                    const seriliazableSystem = this.serializedSystems.get(systemState.name);
+                    if (seriliazableSystem) {
+                        seriliazableSystem.applySystemState(systemState.state, systemState.seriliziationVersion, duration);
+                    }
+                    else {
+                        console.warn("Unable to find seriarializedSystem " + systemState.name);
+                    }
+                    appliedToSystems.push(systemState.name);
+                });
+                this.serializedSystems.forEach((system) => {
+                    if (!appliedToSystems.includes(system.name)) {
+                        system.applyDefaultState(duration);
+                    }
+                });
+            }
+            // Here is where we will add support for future versions
+            else {
+                throw new Error(`[StateMachine] Unsupported sereialized state encountered: ${state.version}`);
+            }
+        };
+        this.setDefaultState = (duration) => {
+            this.serializedSystems.forEach((system) => {
+                system.applyDefaultState(duration);
+            });
+        };
+    }
+}

package/lib/Entities/UndoRedo.d.ts

@@ -0,0 +1,22 @@
+export declare type OnUndoRedoChange = () => void;
+export interface UndoRedoer {
+    undoAction: (action: UndoRedoAction) => void;
+    redoAction: (action: UndoRedoAction) => void;
+}
+export declare type DoUndoRedoAction = (action: UndoRedoAction) => void;
+export interface UndoRedo {
+    hasUndo: boolean;
+    hasRedo: boolean;
+    submitAction: (action: UndoRedoAction) => void;
+    doUndo: () => void;
+    doRedo: () => void;
+    clearStack: () => void;
+    registerUndoRedoer: (undoRedoer: UndoRedoer) => void;
+    addObserver: (observer: OnUndoRedoChange) => void;
+    removeObserver: (observer: OnUndoRedoChange) => void;
+}
+export declare function makeUndoRedo(): UndoRedo;
+export declare type UndoRedoAction = {
+    type: string;
+    payload: object;
+};

package/lib/Entities/UndoRedo.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeUndoRedo = void 0;
+const _1 = require(".");
+function makeUndoRedo() {
+    return new UndoRedoImp();
+}
+exports.makeUndoRedo = makeUndoRedo;
+class UndoRedoImp {
+    constructor() {
+        this.observers = new _1.ObserverList();
+        this.undoRedoers = [];
+        this.undoStack = [];
+        this.redoStack = [];
+        this.doUndo = () => {
+            const action = this.undoStack.pop();
+            if (!action) {
+                console.warn("[UndoRedo] nothing to undo");
+                return;
+            }
+            this.redoStack.push(action);
+            this.undoRedoers.forEach(undoers => undoers.undoAction(action));
+            this.observers.notify();
+        };
+        this.doRedo = () => {
+            const action = this.redoStack.pop();
+            if (!action) {
+                console.warn("[UndoRedo] nothing to redo");
+                return;
+            }
+            this.undoStack.push(action);
+            this.undoRedoers.forEach(redoers => redoers.redoAction(action));
+            this.observers.notify();
+        };
+        this.submitAction = (action) => {
+            this.undoStack.push(action);
+            this.redoStack = [];
+            this.observers.notify();
+        };
+        this.clearStack = () => {
+            this.redoStack = [];
+            this.undoStack = [];
+            this.observers.notify();
+        };
+        this.registerUndoRedoer = (undoredoer) => {
+            this.undoRedoers.push(undoredoer);
+        };
+        this.addObserver = (observer) => {
+            this.observers.add(observer);
+        };
+        this.removeObserver = (observer) => {
+            this.observers.remove(observer);
+        };
+    }
+    get hasUndo() {
+        return this.undoStack.length > 0;
+    }
+    get hasRedo() {
+        return this.redoStack.length > 0;
+    }
+}

package/lib/Entities/Vector2.d.ts

@@ -0,0 +1,21 @@
+export declare class Vector2 {
+    static Zero(): Vector2;
+    static One(): Vector2;
+    x: number;
+    y: number;
+    get magnitued(): number;
+    get unit(): Vector2;
+    get theta(): number;
+    setLength: (length: number) => void;
+    add: (vector2: Vector2) => Vector2;
+    subtract: (vector2: Vector2) => Vector2;
+    equal: (a: Vector2) => boolean;
+    close: (vec: Vector2) => boolean;
+    copy: () => Vector2;
+    asArray: () => [number, number];
+    rotate: (theta: number) => Vector2;
+    dot: (vec: Vector2) => number;
+    angleTo: (vec: Vector2) => number;
+    cross: (vec: Vector2) => number;
+    constructor(x: number, y: number);
+}

package/lib/Entities/Vector2.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Vector2 = void 0;
+class Vector2 {
+    constructor(x, y) {
+        this.setLength = (length) => {
+            const unit = this.unit;
+            this.x = length * unit.x;
+            this.y = length * unit.y;
+        };
+        this.add = (vector2) => {
+            return new Vector2(this.x + vector2.x, this.y + vector2.y);
+        };
+        this.subtract = (vector2) => {
+            return new Vector2(this.x - vector2.x, this.y - vector2.y);
+        };
+        this.equal = (a) => {
+            if (a.x === this.x && a.y === this.y)
+                return true;
+            else
+                return false;
+        };
+        this.close = (vec) => {
+            const diff = this.subtract(vec);
+            const diffMag = diff.magnitued;
+            if (diffMag < 0.01)
+                return true;
+            else
+                return false;
+        };
+        this.copy = () => {
+            return new Vector2(this.x, this.y);
+        };
+        this.asArray = () => {
+            return [this.x, this.y];
+        };
+        this.rotate = (theta) => {
+            const thetaRadians = theta * Math.PI / 180;
+            const x = this.x * Math.cos(thetaRadians) - this.y * Math.sin(thetaRadians);
+            const y = this.x * Math.sin(thetaRadians) + this.y * Math.cos(thetaRadians);
+            return new Vector2(x, y);
+        };
+        this.dot = (vec) => {
+            return this.x * vec.x + this.y * vec.y;
+        };
+        this.angleTo = (vec) => {
+            const dot = this.dot(vec);
+            const magnitues = vec.magnitued * this.magnitued;
+            const angRadians = Math.acos(dot / magnitues);
+            return angRadians * 180 / Math.PI;
+        };
+        this.cross = (vec) => {
+            return (this.x * vec.y) - (this.y * vec.x);
+        };
+        this.x = x;
+        this.y = y;
+    }
+    static Zero() {
+        return new Vector2(0, 0);
+    }
+    static One() {
+        return new Vector2(1, 1);
+    }
+    get magnitued() {
+        const xSqr = this.x * this.x;
+        const ySqr = this.y * this.y;
+        const magnitude = Math.sqrt(xSqr + ySqr);
+        return magnitude;
+    }
+    get unit() {
+        const mag = this.magnitued;
+        if (mag === 0) {
+            return Vector2.Zero();
+        }
+        const unitX = this.x / mag;
+        const unitY = this.y / mag;
+        return new Vector2(unitX, unitY);
+    }
+    get theta() {
+        return (Math.atan2(this.y, this.x) * 180) / Math.PI;
+    }
+}
+exports.Vector2 = Vector2;

package/lib/Entities/Vector3.d.ts

@@ -0,0 +1,19 @@
+export declare class Vector3 {
+    static Zero(): Vector3;
+    static One(): Vector3;
+    x: number;
+    y: number;
+    z: number;
+    get magnitued(): number;
+    get unit(): Vector3;
+    setLength: (length: number) => void;
+    add: (a: Vector3) => Vector3;
+    subtract: (vector2: Vector3) => Vector3;
+    copy: () => Vector3;
+    equals: (vec: Vector3) => boolean;
+    close: (vec: Vector3) => boolean;
+    cross: (vec: Vector3) => Vector3;
+    dot: (vec: Vector3) => number;
+    asArray: () => [number, number, number];
+    constructor(x: number, y: number, z: number);
+}

package/lib/Entities/Vector3.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Vector3 = void 0;
+class Vector3 {
+    constructor(x, y, z) {
+        this.setLength = (length) => {
+            const unit = this.unit;
+            this.x = length * unit.x;
+            this.y = length * unit.y;
+            this.z = length * unit.z;
+        };
+        this.add = (a) => {
+            return new Vector3(this.x + a.x, this.y + a.y, this.z + a.z);
+        };
+        this.subtract = (vector2) => {
+            return new Vector3(this.x - vector2.x, this.y - vector2.y, this.z - vector2.z);
+        };
+        this.copy = () => {
+            return new Vector3(this.x, this.y, this.z);
+        };
+        this.equals = (vec) => {
+            if (vec.x === this.x && vec.y === this.y && vec.z === this.z)
+                return true;
+            else
+                return false;
+        };
+        this.close = (vec) => {
+            const diff = this.subtract(vec);
+            const diffMag = diff.magnitued;
+            if (diffMag < 0.01)
+                return true;
+            else
+                return false;
+        };
+        this.cross = (vec) => {
+            const x = this.y * vec.z - this.z * vec.y;
+            const y = this.z * vec.x - this.x * vec.z;
+            const z = this.x * vec.y - this.y * vec.x;
+            return new Vector3(x, y, z);
+        };
+        this.dot = (vec) => {
+            return this.x * vec.x + this.y * vec.y + this.z * vec.z;
+        };
+        this.asArray = () => {
+            return [this.x, this.y, this.z];
+        };
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+    static Zero() {
+        return new Vector3(0, 0, 0);
+    }
+    static One() {
+        return new Vector3(1, 1, 1);
+    }
+    get magnitued() {
+        const xSqr = this.x * this.x;
+        const ySqr = this.y * this.y;
+        const zSqr = this.z * this.z;
+        const magnitude = Math.sqrt(xSqr + ySqr + zSqr);
+        return magnitude;
+    }
+    get unit() {
+        const mag = this.magnitued;
+        if (mag === 0) {
+            return Vector3.Zero();
+        }
+        const unitX = this.x / mag;
+        const unitY = this.y / mag;
+        const unitZ = this.z / mag;
+        return new Vector3(unitX, unitY, unitZ);
+    }
+}
+exports.Vector3 = Vector3;

package/lib/Entities/index.d.ts

@@ -0,0 +1,19 @@
+export * from "./Babylon";
+export * from "./BaseApp";
+export * from "./Color";
+export * from "./DevicePreview";
+export * from "./KeyboardInput";
+export * from "./LineSegment2D";
+export * from "./MemoizedBoolean";
+export * from "./MemoizedNumber";
+export * from "./MemoizedString";
+export * from "./MemoizedVector2";
+export * from "./MemoizedVector3";
+export * from "./ObserverList";
+export * from "./OrbitCamera";
+export * from "./ParametricLine";
+export * from "./ParametricPlane";
+export * from "./StateMachine";
+export * from "./UndoRedo";
+export * from "./Vector2";
+export * from "./Vector3";

package/lib/Entities/index.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Babylon"), exports);
+__exportStar(require("./BaseApp"), exports);
+__exportStar(require("./Color"), exports);
+__exportStar(require("./DevicePreview"), exports);
+__exportStar(require("./KeyboardInput"), exports);
+__exportStar(require("./LineSegment2D"), exports);
+__exportStar(require("./MemoizedBoolean"), exports);
+__exportStar(require("./MemoizedNumber"), exports);
+__exportStar(require("./MemoizedString"), exports);
+__exportStar(require("./MemoizedVector2"), exports);
+__exportStar(require("./MemoizedVector3"), exports);
+__exportStar(require("./ObserverList"), exports);
+__exportStar(require("./OrbitCamera"), exports);
+__exportStar(require("./ParametricLine"), exports);
+__exportStar(require("./ParametricPlane"), exports);
+__exportStar(require("./StateMachine"), exports);
+__exportStar(require("./UndoRedo"), exports);
+__exportStar(require("./Vector2"), exports);
+__exportStar(require("./Vector3"), exports);

package/lib/Interface/Controllers/setState.d.ts

@@ -1,2 +1,2 @@
 import { BaseAppUC } from "../../Core";
-export declare function makeSetState(baseApp: BaseAppUC): (state: string, duration?: number | undefined) => void;
+export declare function makeSetState(baseApp: BaseAppUC): (state: string | null, duration?: number) => void;

package/lib/Interface/Controllers/setState.js

@@ -2,9 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeSetState = void 0;
 function makeSetState(baseApp) {
-    return function setState(state, duration) {
-        const stateObj = JSON.parse(state);
-        baseApp.setSerializedState(stateObj);
+    return function setState(state, duration = 0) {
+        if (state) {
+            try {
+                const stateObj = JSON.parse(state);
+                baseApp.setSerializedState(stateObj, duration);
+            }
+            catch (e) {
+                baseApp.setDefaultState(duration);
+                console.warn("[setState] Failed to deserialize state string: " + e);
+            }
+        }
+        else {
+            baseApp.setDefaultState(duration);
+        }
     };
 }
 exports.makeSetState = makeSetState;

package/lib/PresentationManagers/DevicePreviewPM.d.ts

@@ -0,0 +1,13 @@
+import { DevicePreview } from "../Entities";
+export interface DevicePreviewVM {
+    x: number;
+    y: number;
+    useDevicePreview: boolean;
+}
+export declare class DevicePreviewPM {
+    devicePreview: DevicePreview;
+    updateView: (vm: DevicePreviewVM) => void;
+    doUpdateView: () => void;
+    dispose(): void;
+    constructor(devicePreview: DevicePreview, updateView: (vm: DevicePreviewVM) => void);
+}

package/lib/PresentationManagers/DevicePreviewPM.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DevicePreviewPM = void 0;
+class DevicePreviewPM {
+    constructor(devicePreview, updateView) {
+        this.doUpdateView = () => {
+            const useDevicePreview = this.devicePreview.useDevicePreview;
+            const x = this.devicePreview.previewSize.x;
+            const y = this.devicePreview.previewSize.y;
+            this.updateView({
+                x,
+                y,
+                useDevicePreview,
+            });
+        };
+        this.devicePreview = devicePreview;
+        this.updateView = updateView;
+        this.doUpdateView();
+        this.devicePreview.addObserver(this.doUpdateView);
+    }
+    dispose() {
+        this.devicePreview.removeObserver(this.doUpdateView);
+    }
+}
+exports.DevicePreviewPM = DevicePreviewPM;

package/lib/PresentationManagers/HasRedoPM.d.ts

@@ -0,0 +1,9 @@
+import { UndoRedo } from "../Entities";
+export declare class HasRedoPM {
+    updateView: (hasRedo: boolean) => void;
+    private undoRedo;
+    private lastValue?;
+    private onChange;
+    dispose(): void;
+    constructor(undoRedo: UndoRedo, updateView: (hasRedo: boolean) => void);
+}

package/lib/PresentationManagers/HasRedoPM.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HasRedoPM = void 0;
+class HasRedoPM {
+    constructor(undoRedo, updateView) {
+        this.updateView = updateView;
+        this.onChange = () => {
+            const currentVal = this.undoRedo.hasRedo;
+            if (this.lastValue === currentVal)
+                return;
+            this.updateView(currentVal);
+            this.lastValue = currentVal;
+        };
+        this.undoRedo = undoRedo;
+        this.onChange();
+        this.undoRedo.addObserver(this.onChange);
+    }
+    dispose() {
+        this.undoRedo.removeObserver(this.onChange);
+    }
+}
+exports.HasRedoPM = HasRedoPM;

package/lib/PresentationManagers/HasUndoPM.d.ts

@@ -0,0 +1,9 @@
+import { UndoRedo } from "../Entities";
+export declare class HasUndoPM {
+    updateView: (hasUndo: boolean) => void;
+    private undoRedo;
+    private lastValue?;
+    private onChange;
+    dispose(): void;
+    constructor(undoRedo: UndoRedo, updateView: (hasUndo: boolean) => void);
+}

package/lib/PresentationManagers/HasUndoPM.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HasUndoPM = void 0;
+class HasUndoPM {
+    constructor(undoRedo, updateView) {
+        this.updateView = updateView;
+        this.onChange = () => {
+            const currentVal = this.undoRedo.hasUndo;
+            if (this.lastValue === currentVal)
+                return;
+            this.updateView(currentVal);
+            this.lastValue = currentVal;
+        };
+        this.undoRedo = undoRedo;
+        this.onChange();
+        this.undoRedo.addObserver(this.onChange);
+    }
+    dispose() {
+        this.undoRedo.removeObserver(this.onChange);
+    }
+}
+exports.HasUndoPM = HasUndoPM;

package/lib/PresentationManagers/IsAuthoringPM.d.ts

@@ -0,0 +1,9 @@
+import { BaseApp } from "../Entities";
+export declare class IsAuthoringPM {
+    private baseApp;
+    private updateView;
+    private lastSetState?;
+    private doUpdateView;
+    dispose(): void;
+    constructor(baseApp: BaseApp, updateView: (isAuthoring: boolean) => void);
+}