@vived/core 1.0.1 → 1.2.0

package/dist/tsconfig.esm.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/index.ts","../src/appobject/appobject.test.ts","../src/appobject/appobject.ts","../src/appobject/appobjectcomponent.test.ts","../src/appobject/appobjectcomponent.ts","../src/appobject/appobjectcontroller.ts","../src/appobject/appobjectentity.test.ts","../src/appobject/appobjectentity.ts","../src/appobject/appobjectentityrepo.test.ts","../src/appobject/appobjectentityrepo.ts","../src/appobject/appobjectpm.test.ts","../src/appobject/appobjectpm.ts","../src/appobject/appobjectrepo.test.ts","../src/appobject/appobjectrepo.ts","../src/appobject/appobjectuc.ts","../src/appobject/appobjectview.ts","../src/appobject/getsingletoncomponent.test.ts","../src/appobject/getsingletoncomponent.ts","../src/appobject/index.ts","../src/appobject/printappobjectdetails.ts","../src/entities/memoizedangle.test.ts","../src/entities/memoizedangle.ts","../src/entities/memoizedboolean.test.ts","../src/entities/memoizedboolean.ts","../src/entities/memoizedcolor.test.ts","../src/entities/memoizedcolor.ts","../src/entities/memoizednumber.test.ts","../src/entities/memoizednumber.ts","../src/entities/memoizedquaternion.test.ts","../src/entities/memoizedquaternion.ts","../src/entities/memoizedstring.test.ts","../src/entities/memoizedstring.ts","../src/entities/memoizedvector2.test.ts","../src/entities/memoizedvector2.ts","../src/entities/memoizedvector3.test.ts","../src/entities/memoizedvector3.ts","../src/entities/observableentity.test.ts","../src/entities/observableentity.ts","../src/entities/observerlist.test.ts","../src/entities/observerlist.ts","../src/entities/index.ts","../src/types/appboundary.ts","../src/types/easefn.ts","../src/types/pmadapter.ts","../src/types/singletonpmadapter.ts","../src/types/index.ts","../src/valueobjects/angle.test.ts","../src/valueobjects/angle.ts","../src/valueobjects/color.test.ts","../src/valueobjects/color.ts","../src/valueobjects/linesegment2d.test.ts","../src/valueobjects/linesegment2d.ts","../src/valueobjects/matrix.test.ts","../src/valueobjects/matrix.ts","../src/valueobjects/parametricline.test.ts","../src/valueobjects/parametricline.ts","../src/valueobjects/parametricplane.test.ts","../src/valueobjects/parametricplane.ts","../src/valueobjects/quaternion.test.ts","../src/valueobjects/quaternion.ts","../src/valueobjects/rectangle.test.ts","../src/valueobjects/rectangle.ts","../src/valueobjects/vector2.test.ts","../src/valueobjects/vector2.ts","../src/valueobjects/vector3.test.ts","../src/valueobjects/vector3.ts","../src/valueobjects/index.ts"],"version":"5.8.2"}
+{"root":["../src/index.ts","../src/appobject/appobject.test.ts","../src/appobject/appobject.ts","../src/appobject/appobjectcomponent.test.ts","../src/appobject/appobjectcomponent.ts","../src/appobject/appobjectcontroller.ts","../src/appobject/appobjectentity.test.ts","../src/appobject/appobjectentity.ts","../src/appobject/appobjectentityrepo.test.ts","../src/appobject/appobjectentityrepo.ts","../src/appobject/appobjectpm.test.ts","../src/appobject/appobjectpm.ts","../src/appobject/appobjectrepo.test.ts","../src/appobject/appobjectrepo.ts","../src/appobject/appobjectuc.ts","../src/appobject/appobjectview.ts","../src/appobject/getsingletoncomponent.test.ts","../src/appobject/getsingletoncomponent.ts","../src/appobject/index.ts","../src/appobject/printappobjectdetails.ts","../src/entities/memoizedangle.test.ts","../src/entities/memoizedangle.ts","../src/entities/memoizedboolean.test.ts","../src/entities/memoizedboolean.ts","../src/entities/memoizedcolor.test.ts","../src/entities/memoizedcolor.ts","../src/entities/memoizednumber.test.ts","../src/entities/memoizednumber.ts","../src/entities/memoizedquaternion.test.ts","../src/entities/memoizedquaternion.ts","../src/entities/memoizedstring.test.ts","../src/entities/memoizedstring.ts","../src/entities/memoizedvector2.test.ts","../src/entities/memoizedvector2.ts","../src/entities/memoizedvector3.test.ts","../src/entities/memoizedvector3.ts","../src/entities/observableentity.test.ts","../src/entities/observableentity.ts","../src/entities/observerlist.test.ts","../src/entities/observerlist.ts","../src/entities/rangednumber.test.ts","../src/entities/rangednumber.ts","../src/entities/index.ts","../src/types/appboundary.ts","../src/types/easefn.ts","../src/types/pmadapter.ts","../src/types/singletonpmadapter.ts","../src/types/index.ts","../src/utilities/lengthconverters.test.ts","../src/utilities/lengthconverters.ts","../src/utilities/lerpnumber.test.ts","../src/utilities/lerpnumber.ts","../src/utilities/degreestoradians.test.ts","../src/utilities/degreestoradians.ts","../src/utilities/easefunctions.test.ts","../src/utilities/easefunctions.ts","../src/utilities/generateuniqueid.ts","../src/utilities/index.ts","../src/utilities/interpolatenumber.test.ts","../src/utilities/interpolatenumber.ts","../src/valueobjects/angle.test.ts","../src/valueobjects/angle.ts","../src/valueobjects/color.test.ts","../src/valueobjects/color.ts","../src/valueobjects/linesegment2d.test.ts","../src/valueobjects/linesegment2d.ts","../src/valueobjects/matrix.test.ts","../src/valueobjects/matrix.ts","../src/valueobjects/parametricline.test.ts","../src/valueobjects/parametricline.ts","../src/valueobjects/parametricplane.test.ts","../src/valueobjects/parametricplane.ts","../src/valueobjects/quaternion.test.ts","../src/valueobjects/quaternion.ts","../src/valueobjects/rectangle.test.ts","../src/valueobjects/rectangle.ts","../src/valueobjects/vector2.test.ts","../src/valueobjects/vector2.ts","../src/valueobjects/vector3.test.ts","../src/valueobjects/vector3.ts","../src/valueobjects/index.ts"],"version":"5.8.2"}

package/dist/types/Entities/RangedNumber.d.ts

@@ -0,0 +1,17 @@
+export interface RangedNumberProperties {
+    min: number;
+    max: number;
+    initialValue: number;
+}
+export declare class RangedNumber {
+    readonly maxValue: number;
+    readonly minValue: number;
+    private _val;
+    get val(): number;
+    set val(x: number);
+    setValQuietly(val: number): void;
+    private clamp;
+    private onChangeCallback;
+    constructor(props: RangedNumberProperties, onChangeCallback: () => void);
+}
+//# sourceMappingURL=RangedNumber.d.ts.map

package/dist/types/Entities/RangedNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RangedNumber.d.ts","sourceRoot":"","sources":["../../../src/Entities/RangedNumber.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,OAAO,CAAC,IAAI,CAAS;IACrB,IAAI,GAAG,IAAI,MAAM,CAEhB;IACD,IAAI,GAAG,CAAC,CAAC,EAAE,MAAM,EAMhB;IAEM,aAAa,CAAC,GAAG,EAAE,MAAM;IAIhC,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,gBAAgB,CAAa;gBAEzB,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,IAAI;CAOxE"}

package/dist/types/Entities/RangedNumber.test.d.ts

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

package/dist/types/Entities/RangedNumber.test.d.ts.map

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

package/dist/types/Entities/index.d.ts

@@ -1,5 +1,3 @@
-export * from "./ObservableEntity";
-export * from "./ObserverList";
 export * from "./MemoizedAngle";
 export * from "./MemoizedBoolean";
 export * from "./MemoizedColor";
@@ -8,4 +6,7 @@ export * from "./MemoizedQuaternion";
 export * from "./MemoizedString";
 export * from "./MemoizedVector2";
 export * from "./MemoizedVector3";
+export * from "./ObservableEntity";
+export * from "./ObserverList";
+export * from "./RangedNumber";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/Entities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/types/Utilities/LengthConverters.d.ts

@@ -0,0 +1,5 @@
+export declare function inchesToMeters(inches: number): number;
+export declare function metersToInches(meters: number): number;
+export declare function feetToMeters(feet: number): number;
+export declare function metersToFeet(meters: number): number;
+//# sourceMappingURL=LengthConverters.d.ts.map

package/dist/types/Utilities/LengthConverters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LengthConverters.d.ts","sourceRoot":"","sources":["../../../src/Utilities/LengthConverters.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/types/Utilities/LengthConverters.test.d.ts

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

package/dist/types/Utilities/LengthConverters.test.d.ts.map

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

package/dist/types/Utilities/LerpNumber.d.ts

@@ -0,0 +1,57 @@
+import { EaseFn } from "../Types";
+/**
+ * Configuration object for performing a linear interpolation (lerp) operation.
+ * @interface LerpNumberDTO
+ */
+export interface LerpNumberDTO {
+    /** Starting value of the lerp */
+    start: number;
+    /** Target/ending value of the lerp */
+    end: number;
+    /** Callback function that receives the interpolated value on each update */
+    update: (value: number) => void;
+    /** Duration of the lerp in milliseconds. Defaults to LerpNumber.defaultDurationMS */
+    durationMS?: number;
+    /** Easing function to modify the interpolation curve. Defaults to LerpNumber.defaultEase */
+    ease?: EaseFn;
+    /** Optional callback function called when lerp completes naturally */
+    onComplete?: () => void;
+    /** Optional callback function called when lerp is cancelled */
+    onCancel?: () => void;
+}
+/**
+ * Utility class for smoothly interpolating between two numbers over time.
+ * Uses requestAnimationFrame for smooth animation and supports custom easing functions.
+ *
+ * @example
+ * const lerper = new LerpNumber();
+ * // Animate from 0 to 100 over 2 seconds
+ * await lerper.lerp({
+ *   start: 0,
+ *   end: 100,
+ *   durationMS: 2000,
+ *   update: (value) => console.log(value)
+ * });
+ */
+export declare class LerpNumber {
+    defaultDurationMS: number;
+    defaultEase: EaseFn;
+    get isLerping(): boolean;
+    private _isLerping;
+    /**
+     * Cancels the current lerp operation if one is in progress.
+     * Triggers the onCancel callback if provided in the original lerp configuration.
+     */
+    cancel(): void;
+    private _cancelLerp;
+    /**
+     * Initiates a lerp (linear interpolation) operation.
+     * If a lerp is already in progress, it will be cancelled before starting the new one.
+     *
+     * @param data - Configuration object for the lerp operation
+     * @returns Promise that resolves when the lerp completes or is cancelled
+     * @throws Never throws, but may reject if the update function throws
+     */
+    lerp: (data: LerpNumberDTO) => Promise<void>;
+}
+//# sourceMappingURL=LerpNumber.d.ts.map

package/dist/types/Utilities/LerpNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LerpNumber.d.ts","sourceRoot":"","sources":["../../../src/Utilities/LerpNumber.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAU;IACd,iBAAiB,SAAQ;IACzB,WAAW,EAAE,MAAM,CAAc;IAExC,IAAW,SAAS,YAEnB;IACD,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;IACI,MAAM;IAMb,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;;OAOG;IACH,IAAI,GAAI,MAAM,aAAa,KAAG,OAAO,CAAC,IAAI,CAAC,CAwCzC;CACH"}

package/dist/types/Utilities/LerpNumber.test.d.ts

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

package/dist/types/Utilities/LerpNumber.test.d.ts.map

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

package/dist/types/Utilities/degreesToRadians.d.ts

@@ -0,0 +1,2 @@
+export declare function degreesToRadians(deg: number): number;
+//# sourceMappingURL=degreesToRadians.d.ts.map

package/dist/types/Utilities/degreesToRadians.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"degreesToRadians.d.ts","sourceRoot":"","sources":["../../../src/Utilities/degreesToRadians.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAE,MAAM,CAEnD"}

package/dist/types/Utilities/degreesToRadians.test.d.ts

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

package/dist/types/Utilities/degreesToRadians.test.d.ts.map

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

package/dist/types/Utilities/easeFunctions.d.ts

@@ -0,0 +1,24 @@
+import { EaseFn } from "../Types";
+export declare const easeLinear: EaseFn;
+export declare const quadIn: EaseFn;
+export declare const quadOut: EaseFn;
+export declare const quadInOut: EaseFn;
+export declare const cubicIn: EaseFn;
+export declare const cubicOut: EaseFn;
+export declare const cubicInOut: EaseFn;
+export declare const expoIn: EaseFn;
+export declare const expoOut: EaseFn;
+export declare const expoInOut: EaseFn;
+export declare const sinIn: EaseFn;
+export declare const sinOut: EaseFn;
+export declare const sinInOut: EaseFn;
+export declare const quartIn: EaseFn;
+export declare const quartOut: EaseFn;
+export declare const quartInOut: EaseFn;
+export declare const quintIn: EaseFn;
+export declare const quintOut: EaseFn;
+export declare const quintInOut: EaseFn;
+export declare const circIn: EaseFn;
+export declare const circOut: EaseFn;
+export declare const circInOut: EaseFn;
+//# sourceMappingURL=easeFunctions.d.ts.map

package/dist/types/Utilities/easeFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easeFunctions.d.ts","sourceRoot":"","sources":["../../../src/Utilities/easeFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,MAKpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MASvB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAKtB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAWxB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,MAKpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MAOvB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,MAKnB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,MAKpB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAKtB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAKtB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MASxB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAKtB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MASxB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,MAKpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,MAKrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MASvB,CAAC"}

package/dist/types/Utilities/easeFunctions.test.d.ts

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

package/dist/types/Utilities/easeFunctions.test.d.ts.map

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

package/dist/types/Utilities/generateUniqueID.d.ts

@@ -0,0 +1,2 @@
+export declare function generateUniqueID(): string;
+//# sourceMappingURL=generateUniqueID.d.ts.map

package/dist/types/Utilities/generateUniqueID.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateUniqueID.d.ts","sourceRoot":"","sources":["../../../src/Utilities/generateUniqueID.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/types/Utilities/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./degreesToRadians";
+export * from "./LengthConverters";
+export * from "./generateUniqueID";
+export * from "./easeFunctions";
+export * from "./interpolateNumber";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/Utilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/types/Utilities/interpolateNumber.d.ts

@@ -0,0 +1,2 @@
+export declare function interpolateNumber(start: number, end: number, percent: number, clamp?: boolean): number;
+//# sourceMappingURL=interpolateNumber.d.ts.map

package/dist/types/Utilities/interpolateNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolateNumber.d.ts","sourceRoot":"","sources":["../../../src/Utilities/interpolateNumber.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,OAAe,GACrB,MAAM,CAeR"}

package/dist/types/Utilities/interpolateNumber.test.d.ts

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

package/dist/types/Utilities/interpolateNumber.test.d.ts.map

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

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./AppObject";
 export * from "./Entities";
 export * from "./Types";
+export * from "./Utilities";
 export * from "./ValueObjects";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@vived/core",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Core Components for VIVED Apps and Hosts",
   "main": "dist/cjs/index.js",
-  "module": "dist/esm/index.js", 
+  "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
   "exports": {
     "import": "./dist/esm/index.js",
@@ -33,6 +33,7 @@
   "homepage": "https://bitbucket.org/cyberscience3d/npm_vived_core#readme",
   "devDependencies": {
     "@types/jest": "^29.5.14",
+    "@types/uuid": "^10.0.0",
     "jest": "^29.7.0",
     "prettier": "^3.5.3",
     "ts-jest": "^29.2.6",
@@ -42,5 +43,8 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "uuid": "^11.1.0"
   }
 }

package/src/Entities/RangedNumber.test.ts

@@ -0,0 +1,118 @@
+import { RangedNumber, RangedNumberProperties } from "./RangedNumber";
+
+it("Stores the initial value", () => {
+  const props: RangedNumberProperties = {
+    initialValue: 5,
+    max: 10,
+    min: 1,
+  };
+
+  const memoizedNumber = new RangedNumber(props, jest.fn());
+  expect(memoizedNumber.val).toEqual(5);
+});
+
+it("Clamps the initial value", () => {
+  const props: RangedNumberProperties = {
+    initialValue: 50,
+    max: 10,
+    min: 1,
+  };
+
+  const memoizedNumber = new RangedNumber(props, jest.fn());
+  expect(memoizedNumber.val).toEqual(10);
+});
+
+it("Clamps the value", () => {
+  const props: RangedNumberProperties = {
+    initialValue: 5,
+    max: 10,
+    min: 1,
+  };
+
+  const memoizedNumber = new RangedNumber(props, jest.fn());
+
+  expect(memoizedNumber.val).toEqual(5);
+
+  memoizedNumber.val = 11;
+  expect(memoizedNumber.val).toEqual(10);
+
+  memoizedNumber.val = 0;
+  expect(memoizedNumber.val).toEqual(1);
+});
+
+it("Triggers the callback when something changes", () => {
+  const cb = jest.fn();
+
+  const props: RangedNumberProperties = {
+    initialValue: 5,
+    max: 10,
+    min: 1,
+  };
+  const memoizedNumber = new RangedNumber(props, cb);
+
+  expect(cb).not.toBeCalled();
+
+  memoizedNumber.val = 6;
+
+  expect(cb).toBeCalled();
+});
+
+it("Only triggers the CB when something changes", () => {
+  const cb = jest.fn();
+  const props: RangedNumberProperties = {
+    initialValue: 5,
+    max: 10,
+    min: 1,
+  };
+  const memoizedNumber = new RangedNumber(props, cb);
+
+  memoizedNumber.val = 5;
+  memoizedNumber.val = 5;
+  memoizedNumber.val = 5;
+
+  expect(cb).not.toBeCalled();
+});
+
+it("Checks the clamped value before triggering", () => {
+  const cb = jest.fn();
+  const props: RangedNumberProperties = {
+    initialValue: 10,
+    max: 10,
+    min: 1,
+  };
+  const memoizedNumber = new RangedNumber(props, cb);
+
+  memoizedNumber.val = 11;
+  memoizedNumber.val = 12;
+  memoizedNumber.val = 13;
+
+  expect(cb).not.toBeCalled();
+});
+
+it("Does not notify if set quietly", () => {
+  const cb = jest.fn();
+  const props: RangedNumberProperties = {
+    initialValue: 5,
+    max: 10,
+    min: 1,
+  };
+  const memoizedNumber = new RangedNumber(props, cb);
+
+  memoizedNumber.setValQuietly(6);
+
+  expect(memoizedNumber.val).toEqual(6);
+  expect(cb).not.toBeCalled();
+});
+
+it("Setting quietly is clamped", () => {
+  const cb = jest.fn();
+  const props: RangedNumberProperties = {
+    initialValue: 5,
+    max: 10,
+    min: 1,
+  };
+  const memoizedNumber = new RangedNumber(props, cb);
+
+  memoizedNumber.setValQuietly(-1);
+  expect(memoizedNumber.val).toEqual(1);
+});

package/src/Entities/RangedNumber.ts

@@ -0,0 +1,45 @@
+export interface RangedNumberProperties {
+  min: number;
+  max: number;
+  initialValue: number;
+}
+
+export class RangedNumber {
+  public readonly maxValue: number;
+  public readonly minValue: number;
+  private _val: number;
+  get val(): number {
+    return this._val;
+  }
+  set val(x: number) {
+    const y = this.clamp(x);
+    if (this._val === y) return;
+
+    this._val = y;
+    this.onChangeCallback();
+  }
+
+  public setValQuietly(val: number) {
+    this._val = this.clamp(val);
+  }
+
+  private clamp(x: number): number {
+    let rVal = x;
+    if (x > this.maxValue) {
+      rVal = this.maxValue;
+    } else if (x < this.minValue) {
+      rVal = this.minValue;
+    }
+
+    return rVal;
+  }
+  private onChangeCallback: () => void;
+
+  constructor(props: RangedNumberProperties, onChangeCallback: () => void) {
+    this.maxValue = props.max;
+    this.minValue = props.min;
+
+    this._val = this.clamp(props.initialValue);
+    this.onChangeCallback = onChangeCallback;
+  }
+}

package/src/Entities/index.ts

@@ -1,5 +1,3 @@
-export * from "./ObservableEntity";
-export * from "./ObserverList";
 export * from "./MemoizedAngle";
 export * from "./MemoizedBoolean";
 export * from "./MemoizedColor";
@@ -8,3 +6,6 @@ export * from "./MemoizedQuaternion";
 export * from "./MemoizedString";
 export * from "./MemoizedVector2";
 export * from "./MemoizedVector3";
+export * from "./ObservableEntity";
+export * from "./ObserverList";
+export * from "./RangedNumber";

package/src/Utilities/LengthConverters.test.ts

@@ -0,0 +1,30 @@
+import {
+  feetToMeters,
+  inchesToMeters,
+  metersToFeet,
+  metersToInches,
+} from "./LengthConverters";
+
+test("Converting inches to meters", () => {
+  expect(inchesToMeters(0)).toEqual(0);
+  expect(inchesToMeters(12)).toEqual(0.30479983540808886);
+  expect(inchesToMeters(-12)).toEqual(-0.30479983540808886);
+});
+
+test("Converting meters to inches", () => {
+  expect(metersToInches(0)).toEqual(0);
+  expect(metersToInches(2)).toEqual(78.7402);
+  expect(metersToInches(-2)).toEqual(-78.7402);
+});
+
+test("Converting feet to meters", () => {
+  expect(feetToMeters(0)).toEqual(0);
+  expect(feetToMeters(5)).toEqual(1.5239999512320015);
+  expect(feetToMeters(-5)).toEqual(-1.5239999512320015);
+});
+
+test("Converting meters to feet", () => {
+  expect(metersToFeet(0)).toEqual(0);
+  expect(metersToFeet(2)).toEqual(6.56168);
+  expect(metersToFeet(-2)).toEqual(-6.56168);
+});

package/src/Utilities/LengthConverters.ts

@@ -0,0 +1,18 @@
+const inchesPerMeter = 39.3701;
+const feetPerMeter = 3.28084;
+
+export function inchesToMeters(inches: number): number {
+  return inches / inchesPerMeter;
+}
+
+export function metersToInches(meters: number): number {
+  return meters * inchesPerMeter;
+}
+
+export function feetToMeters(feet: number): number {
+  return feet / feetPerMeter;
+}
+
+export function metersToFeet(meters: number): number {
+  return meters * feetPerMeter;
+}

package/src/Utilities/LerpNumber.test.ts

@@ -0,0 +1,109 @@
+import { LerpNumber } from "./LerpNumber";
+
+describe("Lerp Number", () => {
+  let lerpNumber: LerpNumber;
+  let updateFn: jest.Mock;
+
+  beforeEach(() => {
+    lerpNumber = new LerpNumber();
+    updateFn = jest.fn();
+    jest.useFakeTimers();
+  });
+
+  afterEach(() => {
+    jest.useRealTimers();
+  });
+
+  it("should lerp from start to end value", async () => {
+    lerpNumber.defaultDurationMS = 1000;
+    const promise = lerpNumber.lerp({
+      start: 0,
+      end: 100,
+      update: updateFn,
+    });
+
+    // Test middle point (should have multiple updates by this point)
+    jest.advanceTimersByTime(500);
+    expect(updateFn).toHaveBeenCalledWith(expect.closeTo(50, 5)); // Allow some margin due to interval timing
+
+    // Complete animation
+    jest.advanceTimersByTime(500);
+    await promise;
+
+    expect(updateFn).toHaveBeenCalledWith(0); // Start value
+    expect(updateFn).toHaveBeenLastCalledWith(100); // End value
+  });
+
+  it("should cancel lerp when requested", async () => {
+    const onCancel = jest.fn();
+    const promise = lerpNumber.lerp({
+      start: 0,
+      end: 100,
+      update: updateFn,
+      onCancel,
+    });
+
+    expect(lerpNumber.isLerping).toBe(true);
+
+    lerpNumber.cancel();
+    jest.advanceTimersByTime(10); // Allow interval to execute
+    await promise;
+
+    expect(lerpNumber.isLerping).toBe(false);
+    expect(onCancel).toHaveBeenCalled();
+  });
+
+  it("should respect custom duration", async () => {
+    const promise = lerpNumber.lerp({
+      start: 0,
+      end: 100,
+      update: updateFn,
+      durationMS: 500,
+    });
+
+    jest.advanceTimersByTime(250); // Half way
+    expect(updateFn).toHaveBeenLastCalledWith(expect.any(Number));
+
+    jest.advanceTimersByTime(250); // Complete
+    await promise;
+
+    expect(updateFn).toHaveBeenLastCalledWith(100);
+  });
+
+  it("should call onComplete when finished", async () => {
+    const onComplete = jest.fn();
+    const promise = lerpNumber.lerp({
+      start: 0,
+      end: 100,
+      update: updateFn,
+      onComplete,
+    });
+
+    jest.advanceTimersByTime(1000);
+    await promise;
+
+    expect(onComplete).toHaveBeenCalled();
+  });
+
+  it("should cancel existing lerp when starting a new one", async () => {
+    const onCancel = jest.fn();
+    const firstPromise = lerpNumber.lerp({
+      start: 0,
+      end: 100,
+      update: updateFn,
+      onCancel,
+    });
+
+    const secondPromise = lerpNumber.lerp({
+      start: 200,
+      end: 300,
+      update: updateFn,
+    });
+
+    jest.advanceTimersByTime(1000);
+    await Promise.all([firstPromise, secondPromise]);
+
+    expect(onCancel).toHaveBeenCalled();
+    expect(updateFn).toHaveBeenLastCalledWith(300);
+  });
+});