@lightningjs/renderer 0.0.1

package/dist/src/core/textures/NoiseTexture.js

@@ -0,0 +1,63 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Texture } from './Texture.js';
+/**
+ * Texture consisting of a random grid of greyscale pixels
+ *
+ * @remarks
+ * The width and height of the NoiseTexture are defined by it's
+ * {@link NoiseTextureProps.width} and {@link NoiseTextureProps.height}
+ * properties. The {@link NoiseTextureProps.cacheId} prop can be varied in order
+ * to bypass cache and get newly randomized texture data.
+ */
+export class NoiseTexture extends Texture {
+    props;
+    constructor(txManager, props) {
+        super(txManager);
+        this.props = NoiseTexture.resolveDefaults(props);
+    }
+    async getTextureData() {
+        const { width, height } = this.props;
+        const size = width * height * 4;
+        const pixelData8 = new Uint8ClampedArray(size);
+        for (let i = 0; i < size; i += 4) {
+            const v = Math.floor(Math.random() * 256);
+            pixelData8[i] = v;
+            pixelData8[i + 1] = v;
+            pixelData8[i + 2] = v;
+            pixelData8[i + 3] = 255;
+        }
+        return await createImageBitmap(new ImageData(pixelData8, width, height), {
+            premultiplyAlpha: 'none',
+        });
+    }
+    static makeCacheKey(props) {
+        const resolvedProps = NoiseTexture.resolveDefaults(props);
+        return `NoiseTexture,${resolvedProps.width},${resolvedProps.height},${resolvedProps.cacheId}`;
+    }
+    static resolveDefaults(props) {
+        return {
+            width: props.width ?? 128,
+            height: props.height ?? 128,
+            cacheId: props.cacheId ?? 0,
+        };
+    }
+    static z$__type__Props;
+}
+//# sourceMappingURL=NoiseTexture.js.map

package/dist/src/core/textures/NoiseTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoiseTexture.js","sourceRoot":"","sources":["../../../../src/core/textures/NoiseTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,OAAO,EAAoB,MAAM,cAAc,CAAC;AA0BzD;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAa,SAAQ,OAAO;IACvC,KAAK,CAA8B;IAEnC,YAAY,SAA6B,EAAE,KAAwB;QACjE,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAEQ,KAAK,CAAC,cAAc;QAC3B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACrC,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE;YAChC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;YAC1C,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAClB,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACtB,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACtB,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;SACzB;QACD,OAAO,MAAM,iBAAiB,CAAC,IAAI,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE;YACvE,gBAAgB,EAAE,MAAM;SACzB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAU,YAAY,CAAC,KAAwB;QACnD,MAAM,aAAa,GAAG,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC1D,OAAO,gBAAgB,aAAa,CAAC,KAAK,IAAI,aAAa,CAAC,MAAM,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;IAChG,CAAC;IAED,MAAM,CAAU,eAAe,CAC7B,KAAwB;QAExB,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,GAAG;YACzB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG;YAC3B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,CAAC;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,eAAe,CAAoB;CAC3C"}

package/dist/src/core/textures/SubTexture.d.ts

@@ -0,0 +1,57 @@
+import type { TextureDesc } from '../../main-api/RendererMain.js';
+import type { CoreTextureManager } from '../CoreTextureManager.js';
+import { Texture } from './Texture.js';
+/**
+ * Properties of the {@link SubTexture}
+ */
+export interface SubTextureProps {
+    /**
+     * The texture that this sub-texture is a sub-region of.
+     */
+    texture: TextureDesc;
+    /**
+     * The x pixel position of the top-left of the sub-texture within the parent
+     * texture.
+     *
+     * @default 0
+     */
+    x?: number;
+    /**
+     * The y pixel position of the top-left sub-texture within the parent
+     * texture.
+     *
+     * @default 0
+     **/
+    y?: number;
+    /**
+     * The width of the sub-texture in pixels.
+     *
+     * @default 0
+     */
+    width?: number;
+    /**
+     * The height of the sub-texture in pixels
+     **/
+    height?: number;
+}
+/**
+ * A Texture that is a sub-region of another Texture.
+ *
+ * @remarks
+ * The parent texture can be a Sprite Sheet/Texture Atlas and set using the
+ * {@link SubTextureProps.texture} prop. The sub-region relative to the parent
+ * texture is defined with the {@link SubTextureProps.x},
+ * {@link SubTextureProps.y}, {@link SubTextureProps.width}, and
+ * {@link SubTextureProps.height} pixel values.
+ */
+export declare class SubTexture extends Texture {
+    props: Required<SubTextureProps>;
+    parentTexture: Texture;
+    constructor(txManager: CoreTextureManager, props: SubTextureProps);
+    private onParentTxLoaded;
+    private onParentTxFailed;
+    getTextureData(): Promise<SubTextureProps>;
+    static makeCacheKey(props: SubTextureProps): string | false;
+    static resolveDefaults(props: SubTextureProps): Required<SubTextureProps>;
+    static z$__type__Props: SubTextureProps;
+}

package/dist/src/core/textures/SubTexture.js

@@ -0,0 +1,82 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Texture } from './Texture.js';
+/**
+ * A Texture that is a sub-region of another Texture.
+ *
+ * @remarks
+ * The parent texture can be a Sprite Sheet/Texture Atlas and set using the
+ * {@link SubTextureProps.texture} prop. The sub-region relative to the parent
+ * texture is defined with the {@link SubTextureProps.x},
+ * {@link SubTextureProps.y}, {@link SubTextureProps.width}, and
+ * {@link SubTextureProps.height} pixel values.
+ */
+export class SubTexture extends Texture {
+    props;
+    parentTexture;
+    constructor(txManager, props) {
+        super(txManager);
+        this.parentTexture = this.txManager.loadTexture(props.texture.txType, props.texture.props, props.texture.options);
+        this.props = SubTexture.resolveDefaults(props || {});
+        // If parent texture is already loaded / failed, trigger loaded event manually
+        // so that users get a consistent event experience.
+        // We do this in a microtask to allow listeners to be attached in the same
+        // synchronous task after calling loadTexture()
+        queueMicrotask(() => {
+            const parentTx = this.parentTexture;
+            if (parentTx.state === 'loaded') {
+                this.onParentTxLoaded(parentTx, parentTx.dimensions);
+            }
+            else if (parentTx.state === 'failed') {
+                this.onParentTxFailed(parentTx, parentTx.error);
+            }
+            parentTx.on('loaded', this.onParentTxLoaded);
+            parentTx.on('failed', this.onParentTxFailed);
+        });
+    }
+    onParentTxLoaded = () => {
+        // We ignore the parent's passed dimensions, and simply use the SubTexture's
+        // configured dimensions (because that's all that matters here)
+        this.setState('loaded', {
+            width: this.props.width,
+            height: this.props.height,
+        });
+    };
+    onParentTxFailed = (target, error) => {
+        this.setState('failed', error);
+    };
+    async getTextureData() {
+        return this.props;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static makeCacheKey(props) {
+        return false;
+    }
+    static resolveDefaults(props) {
+        return {
+            texture: props.texture,
+            x: props.x || 0,
+            y: props.y || 0,
+            width: props.width || 0,
+            height: props.height || 0,
+        };
+    }
+    static z$__type__Props;
+}
+//# sourceMappingURL=SubTexture.js.map

package/dist/src/core/textures/SubTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubTexture.js","sourceRoot":"","sources":["../../../../src/core/textures/SubTexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAwCvC;;;;;;;;;GASG;AACH,MAAM,OAAO,UAAW,SAAQ,OAAO;IACrC,KAAK,CAA4B;IACjC,aAAa,CAAU;IAEvB,YAAY,SAA6B,EAAE,KAAsB;QAC/D,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAC7C,KAAK,CAAC,OAAO,CAAC,MAAM,EACpB,KAAK,CAAC,OAAO,CAAC,KAAK,EACnB,KAAK,CAAC,OAAO,CAAC,OAAO,CACtB,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAErD,8EAA8E;QAC9E,mDAAmD;QACnD,0EAA0E;QAC1E,+CAA+C;QAC/C,cAAc,CAAC,GAAG,EAAE;YAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC;YACpC,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE;gBAC/B,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAW,CAAC,CAAC;aACvD;iBAAM,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE;gBACtC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAM,CAAC,CAAC;aAClD;YACD,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC7C,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,gBAAgB,GAA8B,GAAG,EAAE;QACzD,4EAA4E;QAC5E,+DAA+D;QAC/D,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE;YACtB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;YACvB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC;IAEM,gBAAgB,GAA8B,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACtE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC;IAEO,KAAK,CAAC,cAAc;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,6DAA6D;IAC7D,MAAM,CAAU,YAAY,CAAC,KAAsB;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAU,eAAe,CAC7B,KAAsB;QAEtB,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC;YACf,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC;YACf,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;YACvB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,eAAe,CAAkB;CACzC"}

package/dist/src/core/textures/Texture.d.ts

@@ -0,0 +1,92 @@
+import type { CoreTextureManager } from '../CoreTextureManager.js';
+import type { SubTextureProps } from './SubTexture.js';
+import type { Dimensions, TextureFailedEventHandler, TextureLoadedEventHandler, TextureLoadingEventHandler } from '../../common/CommonTypes.js';
+import { EventEmitter } from '../../common/EventEmitter.js';
+/**
+ * Texture sources that are used to populate a CoreContextTexture
+ */
+export type TextureData = ImageBitmap | SubTextureProps | null;
+export type TextureState = 'loading' | 'loaded' | 'failed';
+export interface TextureStateEventMap {
+    loading: TextureLoadingEventHandler;
+    loaded: TextureLoadedEventHandler;
+    failed: TextureFailedEventHandler;
+}
+/**
+ * Like the built-in Parameters<> type but skips the first parameter (which is
+ * `target` currently)
+ */
+type ParametersSkipTarget<T extends (...args: any) => any> = T extends (target: any, ...args: infer P) => any ? P : never;
+/**
+ * Represents a source of texture data for a CoreContextTexture.
+ *
+ * @remarks
+ * Texture sources are used to populate a CoreContextTexture when that texture
+ * is loaded. Texture data retrieved by the CoreContextTexture by the
+ * `getTextureData` method. It's the responsibility of the concerete `Texture`
+ * subclass to implement this method appropriately.
+ */
+export declare abstract class Texture extends EventEmitter {
+    protected txManager: CoreTextureManager;
+    /**
+     * The dimensions of the texture
+     *
+     * @remarks
+     * Until the texture data is loaded for the first time the value will be
+     * `null`.
+     */
+    readonly dimensions: Readonly<Dimensions> | null;
+    readonly error: Error | null;
+    readonly state: TextureState;
+    constructor(txManager: CoreTextureManager);
+    /**
+     * Set the state of the texture
+     *
+     * @remark
+     * Intended for internal-use only but declared public so that it can be set
+     * by it's associated {@link CoreContextTexture}
+     *
+     * @param state
+     * @param args
+     */
+    setState<State extends TextureState>(state: State, ...args: ParametersSkipTarget<TextureStateEventMap[State]>): void;
+    /**
+     * Get the texture data for this texture.
+     *
+     * @remarks
+     * This method is called by the CoreContextTexture when the texture is loaded.
+     * The texture data is then used to populate the CoreContextTexture.
+     *
+     * @returns
+     * The texture data for this texture.
+     */
+    abstract getTextureData(): Promise<TextureData>;
+    /**
+     * Make a cache key for this texture.
+     *
+     * @remarks
+     * Each concrete `Texture` subclass must implement this method to provide an
+     * appropriate cache key for the texture type including the texture's
+     * properties that uniquely identify a copy of the texture. If the texture
+     * type does not support caching, then this method should return `false`.
+     *
+     * @param props
+     * @returns
+     * A cache key for this texture or `false` if the texture type does not
+     * support caching.
+     */
+    static makeCacheKey(props: unknown): string | false;
+    /**
+     * Resolve the default values for the texture's properties.
+     *
+     * @remarks
+     * Each concrete `Texture` subclass must implement this method to provide
+     * default values for the texture's optional properties.
+     *
+     * @param props
+     * @returns
+     * The default values for the texture's properties.
+     */
+    static resolveDefaults(props: unknown): Record<string, unknown>;
+}
+export {};

package/dist/src/core/textures/Texture.js

@@ -0,0 +1,105 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { EventEmitter } from '../../common/EventEmitter.js';
+/**
+ * Represents a source of texture data for a CoreContextTexture.
+ *
+ * @remarks
+ * Texture sources are used to populate a CoreContextTexture when that texture
+ * is loaded. Texture data retrieved by the CoreContextTexture by the
+ * `getTextureData` method. It's the responsibility of the concerete `Texture`
+ * subclass to implement this method appropriately.
+ */
+export class Texture extends EventEmitter {
+    txManager;
+    /**
+     * The dimensions of the texture
+     *
+     * @remarks
+     * Until the texture data is loaded for the first time the value will be
+     * `null`.
+     */
+    dimensions = null;
+    error = null;
+    state = 'loading';
+    constructor(txManager) {
+        super();
+        this.txManager = txManager;
+    }
+    /**
+     * Set the state of the texture
+     *
+     * @remark
+     * Intended for internal-use only but declared public so that it can be set
+     * by it's associated {@link CoreContextTexture}
+     *
+     * @param state
+     * @param args
+     */
+    setState(state, ...args) {
+        if (this.state !== state) {
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
+            this.state = state;
+            if (state === 'loaded') {
+                const loadedArgs = args;
+                this.dimensions = loadedArgs[0];
+            }
+            else if (state === 'failed') {
+                const failedArgs = args;
+                this.error = failedArgs[0];
+            }
+            this.emit(state, ...args);
+        }
+    }
+    /**
+     * Make a cache key for this texture.
+     *
+     * @remarks
+     * Each concrete `Texture` subclass must implement this method to provide an
+     * appropriate cache key for the texture type including the texture's
+     * properties that uniquely identify a copy of the texture. If the texture
+     * type does not support caching, then this method should return `false`.
+     *
+     * @param props
+     * @returns
+     * A cache key for this texture or `false` if the texture type does not
+     * support caching.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static makeCacheKey(props) {
+        return false;
+    }
+    /**
+     * Resolve the default values for the texture's properties.
+     *
+     * @remarks
+     * Each concrete `Texture` subclass must implement this method to provide
+     * default values for the texture's optional properties.
+     *
+     * @param props
+     * @returns
+     * The default values for the texture's properties.
+     */
+    static resolveDefaults(
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    props) {
+        return {};
+    }
+}
+//# sourceMappingURL=Texture.js.map

package/dist/src/core/textures/Texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Texture.js","sourceRoot":"","sources":["../../../../src/core/textures/Texture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAUH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AA2B5D;;;;;;;;GAQG;AACH,MAAM,OAAgB,OAAQ,SAAQ,YAAY;IAc1B;IAbtB;;;;;;OAMG;IACM,UAAU,GAAgC,IAAI,CAAC;IAE/C,KAAK,GAAiB,IAAI,CAAC;IAE3B,KAAK,GAAiB,SAAS,CAAC;IAEzC,YAAsB,SAA6B;QACjD,KAAK,EAAE,CAAC;QADY,cAAS,GAAT,SAAS,CAAoB;IAEnD,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CACN,KAAY,EACZ,GAAG,IAAuD;QAE1D,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE;YACxB,4EAA4E;YAC3E,IAAI,CAAC,KAAsB,GAAG,KAAK,CAAC;YACrC,IAAI,KAAK,KAAK,QAAQ,EAAE;gBACtB,MAAM,UAAU,GAAG,IAElB,CAAC;gBACD,IAAI,CAAC,UAAyB,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;aACjD;iBAAM,IAAI,KAAK,KAAK,QAAQ,EAAE;gBAC7B,MAAM,UAAU,GAAG,IAElB,CAAC;gBACD,IAAI,CAAC,KAAe,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;aACvC;YACD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;SAC3B;IACH,CAAC;IAcD;;;;;;;;;;;;;OAaG;IACH,6DAA6D;IAC7D,MAAM,CAAC,YAAY,CAAC,KAAc;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,eAAe;IACpB,6DAA6D;IAC7D,KAAc;QAEd,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/src/core/utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Core Utility Functions
+ *
+ * @module
+ */
+export declare const EPSILON = 0.000001;
+export declare let ARRAY_TYPE: Float32ArrayConstructor | ArrayConstructor;
+export declare const RANDOM: () => number;
+export declare const ANGLE_ORDER = "zyx";
+export declare const setMatrixArrayType: (type: Float32ArrayConstructor | ArrayConstructor) => void;
+export declare const toRadian: (a: number) => number;
+export declare const equals: (a: number, b: number) => boolean;
+export declare const rand: (min: number, max: number) => number;
+export declare const isPowerOfTwo: (value: number) => boolean | 0;
+export declare const getTimingFunction: (str: string) => (time: number) => number | undefined;

package/dist/src/core/utils.js

@@ -0,0 +1,183 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Core Utility Functions
+ *
+ * @module
+ */
+export const EPSILON = 0.000001;
+export let ARRAY_TYPE = typeof Float32Array !== 'undefined' ? Float32Array : Array;
+export const RANDOM = Math.random;
+export const ANGLE_ORDER = 'zyx';
+const degree = Math.PI / 180;
+export const setMatrixArrayType = (type) => {
+    ARRAY_TYPE = type;
+};
+export const toRadian = (a) => {
+    return a * degree;
+};
+export const equals = (a, b) => {
+    return Math.abs(a - b) <= EPSILON * Math.max(1.0, Math.abs(a), Math.abs(b));
+};
+export const rand = (min, max) => {
+    return Math.floor(Math.random() * (max - min + 1) + min);
+};
+export const isPowerOfTwo = (value) => {
+    return value && !(value & (value - 1));
+};
+const getTimingBezier = (a, b, c, d) => {
+    const xc = 3.0 * a;
+    const xb = 3.0 * (c - a) - xc;
+    const xa = 1.0 - xc - xb;
+    const yc = 3.0 * b;
+    const yb = 3.0 * (d - b) - yc;
+    const ya = 1.0 - yc - yb;
+    return function (time) {
+        if (time >= 1.0) {
+            return 1;
+        }
+        if (time <= 0) {
+            return 0;
+        }
+        let t = 0.5, cbx, cbxd, dx;
+        for (let it = 0; it < 20; it++) {
+            cbx = t * (t * (t * xa + xb) + xc);
+            dx = time - cbx;
+            if (dx > -1e-8 && dx < 1e-8) {
+                return t * (t * (t * ya + yb) + yc);
+            }
+            // Cubic bezier derivative.
+            cbxd = t * (t * (3 * xa) + 2 * xb) + xc;
+            if (cbxd > 1e-10 && cbxd < 1e-10) {
+                // Problematic. Fall back to binary search method.
+                break;
+            }
+            t += dx / cbxd;
+        }
+        // Fallback: binary search method. This is more reliable when there are near-0 slopes.
+        let minT = 0;
+        let maxT = 1;
+        for (let it = 0; it < 20; it++) {
+            t = 0.5 * (minT + maxT);
+            cbx = t * (t * (t * xa + xb) + xc);
+            dx = time - cbx;
+            if (dx > -1e-8 && dx < 1e-8) {
+                // Solution found!
+                return t * (t * (t * ya + yb) + yc);
+            }
+            if (dx < 0) {
+                maxT = t;
+            }
+            else {
+                minT = t;
+            }
+        }
+    };
+};
+export const getTimingFunction = (str) => {
+    switch (str) {
+        case 'linear':
+            return function (time) {
+                return time;
+            };
+        case 'ease':
+            return getTimingBezier(0.25, 0.1, 0.25, 1.0);
+        case 'ease-in':
+            return getTimingBezier(0.42, 0, 1.0, 1.0);
+        case 'ease-out':
+            return getTimingBezier(0, 0, 0.58, 1.0);
+        case 'ease-in-out':
+            return getTimingBezier(0.42, 0, 0.58, 1.0);
+        case 'ease-in-sine':
+            return getTimingBezier(0.12, 0, 0.39, 0);
+        case 'ease-out-sine':
+            return getTimingBezier(0.12, 0, 0.39, 0);
+        case 'ease-in-out-sine':
+            return getTimingBezier(0.37, 0, 0.63, 1);
+        case 'ease-in-cubic':
+            return getTimingBezier(0.32, 0, 0.67, 0);
+        case 'ease-out-cubic':
+            return getTimingBezier(0.33, 1, 0.68, 1);
+        case 'ease-in-out-cubic':
+            return getTimingBezier(0.65, 0, 0.35, 1);
+        case 'ease-in-circ':
+            return getTimingBezier(0.55, 0, 1, 0.45);
+        case 'ease-out-circ':
+            return getTimingBezier(0, 0.55, 0.45, 1);
+        case 'ease-in-out-circ':
+            return getTimingBezier(0.85, 0, 0.15, 1);
+        case 'ease-in-back':
+            return getTimingBezier(0.36, 0, 0.66, -0.56);
+        case 'ease-out-back':
+            return getTimingBezier(0.34, 1.56, 0.64, 1);
+        case 'ease-in-out-back':
+            return getTimingBezier(0.68, -0.6, 0.32, 1.6);
+        case 'step-start':
+            return function () {
+                return 1;
+            };
+        case 'step-end':
+            return function (time) {
+                return time === 1 ? 1 : 0;
+            };
+        default:
+            // eslint-disable-next-line no-case-declarations
+            const s = 'cubic-bezier(';
+            if (str && str.indexOf(s) === 0) {
+                const parts = str
+                    .substr(s.length, str.length - s.length - 1)
+                    .split(',');
+                if (parts.length !== 4) {
+                    console.warn('Unknown timing function: ' + str);
+                    // Fallback: use linear.
+                    return function (time) {
+                        return time;
+                    };
+                }
+                const a = parseFloat(parts[0] || '0.42');
+                const b = parseFloat(parts[1] || '0');
+                const c = parseFloat(parts[2] || '1');
+                const d = parseFloat(parts[3] || '1');
+                if (isNaN(a) || isNaN(b) || isNaN(c) || isNaN(d)) {
+                    console.warn(' Unknown timing function: ' + str);
+                    // Fallback: use linear.
+                    return function (time) {
+                        return time;
+                    };
+                }
+                return getTimingBezier(a, b, c, d);
+            }
+            else {
+                console.warn('Unknown timing function: ' + str);
+                // Fallback: use linear.
+                return function (time) {
+                    return time;
+                };
+            }
+    }
+};
+if (!Math.hypot)
+    Math.hypot = (...args) => {
+        let y = 0, i = args.length;
+        while (i--) {
+            y += args[i] * args[i];
+        }
+        return Math.sqrt(y);
+    };
+//# sourceMappingURL=utils.js.map

package/dist/src/core/utils.js.map

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