@twick/core 0.11.0

package/lib/scenes/GeneratorScene.js

@@ -0,0 +1,273 @@
+import { decorate, threadable } from '../decorators';
+import { EventDispatcher, ValueDispatcher } from '../events';
+import { DependencyContext } from '../signals';
+import { isPromisable, isPromise, threads } from '../threading';
+import { endPlayback, endScene, startPlayback, startScene } from '../utils';
+import { LifecycleEvents } from './LifecycleEvents';
+import { SceneState } from './SceneState';
+import { Shaders } from './Shaders';
+import { Slides } from './Slides';
+import { Variables } from './Variables';
+/**
+ * The default implementation of the {@link Scene} interface.
+ *
+ * Uses generators to control the animation.
+ */
+export class GeneratorScene {
+    get firstFrame() {
+        return this.cache.current.firstFrame;
+    }
+    get lastFrame() {
+        return this.firstFrame + this.cache.current.duration;
+    }
+    get onCacheChanged() {
+        return this.cache.subscribable;
+    }
+    get onReloaded() {
+        return this.reloaded.subscribable;
+    }
+    get onRecalculated() {
+        return this.recalculated.subscribable;
+    }
+    get onThreadChanged() {
+        return this.thread.subscribable;
+    }
+    get onRenderLifecycle() {
+        return this.renderLifecycle.subscribable;
+    }
+    get onReset() {
+        return this.afterReset.subscribable;
+    }
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    get LifecycleEvents() {
+        this.logger.warn('LifecycleEvents is deprecated. Use lifecycleEvents instead.');
+        return this.lifecycleEvents;
+    }
+    get previous() {
+        return this.previousScene;
+    }
+    getMediaAssets() {
+        return [];
+    }
+    stopAllMedia() { }
+    constructor(description) {
+        this.cache = new ValueDispatcher({
+            firstFrame: 0,
+            transitionDuration: 0,
+            duration: 0,
+            lastFrame: 0,
+        });
+        this.reloaded = new EventDispatcher();
+        this.recalculated = new EventDispatcher();
+        this.thread = new ValueDispatcher(null);
+        this.renderLifecycle = new EventDispatcher();
+        this.afterReset = new EventDispatcher();
+        this.lifecycleEvents = new LifecycleEvents(this);
+        this.previousScene = null;
+        this.runner = null;
+        this.state = SceneState.Initial;
+        this.cached = false;
+        // TODO(refactor): seems to be unused
+        this.counters = {};
+        this.name = description.name;
+        this.size = description.size;
+        this.resolutionScale = description.resolutionScale;
+        this.logger = description.logger;
+        this.playback = description.playback;
+        this.runnerFactory = description.config;
+        this.creationStack = description.stack;
+        this.experimentalFeatures = description.experimentalFeatures ?? false;
+        decorate(this.runnerFactory, threadable(this.name));
+        this.variables = new Variables(this);
+        this.shaders = new Shaders(this, description.sharedWebGLContext);
+        this.slides = new Slides(this);
+        this.previousOnTop = false;
+    }
+    /**
+     * Update the view.
+     *
+     * Invoked after each step of the main generator.
+     * Can be used for calculating layout.
+     *
+     * Can modify the state of the view.
+     */
+    update() {
+        // do nothing
+    }
+    async render(context) {
+        let iterations = 0;
+        do {
+            iterations++;
+            await DependencyContext.consumePromises();
+            context.save();
+            context.clearRect(0, 0, context.canvas.width, context.canvas.height);
+            await this.draw(context);
+            context.restore();
+        } while (DependencyContext.hasPromises() && iterations < 10);
+        if (iterations > 1) {
+            this.logger.debug(`render iterations: ${iterations}`);
+        }
+    }
+    reload({ config, size, stack, resolutionScale, } = {}) {
+        if (config) {
+            this.runnerFactory = config;
+        }
+        if (size) {
+            this.size = size;
+        }
+        if (resolutionScale) {
+            this.resolutionScale = resolutionScale;
+        }
+        if (stack) {
+            this.creationStack = stack;
+        }
+        this.cached = false;
+        this.reloaded.dispatch();
+    }
+    async recalculate(setFrame) {
+        const cached = this.cache.current;
+        cached.firstFrame = this.playback.frame;
+        cached.lastFrame = cached.firstFrame + cached.duration;
+        if (this.isCached()) {
+            setFrame(cached.lastFrame);
+            this.cache.current = { ...cached };
+            return;
+        }
+        cached.transitionDuration = -1;
+        await this.reset();
+        while (!this.canTransitionOut()) {
+            if (cached.transitionDuration < 0 &&
+                this.state === SceneState.AfterTransitionIn) {
+                cached.transitionDuration = this.playback.frame - cached.firstFrame;
+            }
+            setFrame(this.playback.frame + 1);
+            await this.next();
+        }
+        if (cached.transitionDuration === -1) {
+            cached.transitionDuration = 0;
+        }
+        cached.lastFrame = this.playback.frame;
+        cached.duration = cached.lastFrame - cached.firstFrame;
+        // Prevent the page from becoming unresponsive.
+        await new Promise(resolve => setTimeout(resolve, 0));
+        this.cached = true;
+        this.cache.current = { ...cached };
+        this.recalculated.dispatch();
+    }
+    async next() {
+        if (!this.runner) {
+            return;
+        }
+        let result = this.execute(() => this.runner.next());
+        this.update();
+        while (result.value) {
+            if (isPromisable(result.value)) {
+                const value = await result.value.toPromise();
+                result = this.execute(() => this.runner.next(value));
+            }
+            else if (isPromise(result.value)) {
+                const value = await result.value;
+                result = this.execute(() => this.runner.next(value));
+            }
+            else {
+                this.logger.warn({
+                    message: 'Invalid value yielded by the scene.',
+                    object: result.value,
+                });
+                result = this.execute(() => this.runner.next(result.value));
+            }
+            this.update();
+        }
+        if (DependencyContext.hasPromises()) {
+            const promises = await DependencyContext.consumePromises();
+            this.logger.warn({
+                message: 'Tried to access an asynchronous property before the node was ready. ' +
+                    'Make sure to yield the node before accessing the property.',
+                stack: promises[0].stack,
+                inspect: promises[0].owner?.key ?? undefined,
+            });
+        }
+        if (result.done) {
+            this.state = SceneState.Finished;
+        }
+    }
+    async reset(previousScene = null) {
+        this.counters = {};
+        this.previousScene = previousScene;
+        this.previousOnTop = false;
+        this.runner = threads(() => this.runnerFactory(this.getView()), thread => {
+            this.thread.current = thread;
+        });
+        this.state = SceneState.AfterTransitionIn;
+        this.afterReset.dispatch();
+        await this.next();
+    }
+    getSize() {
+        return this.size;
+    }
+    getRealSize() {
+        return this.size.mul(this.resolutionScale);
+    }
+    isAfterTransitionIn() {
+        return this.state === SceneState.AfterTransitionIn;
+    }
+    canTransitionOut() {
+        return (this.state === SceneState.CanTransitionOut ||
+            this.state === SceneState.Finished);
+    }
+    isFinished() {
+        return this.state === SceneState.Finished;
+    }
+    enterInitial() {
+        if (this.state === SceneState.AfterTransitionIn) {
+            this.state = SceneState.Initial;
+        }
+        else {
+            this.logger.warn(`Scene ${this.name} entered initial in an unexpected state: ${this.state}`);
+        }
+    }
+    enterAfterTransitionIn() {
+        if (this.state === SceneState.Initial) {
+            this.state = SceneState.AfterTransitionIn;
+        }
+        else {
+            this.logger.warn(`Scene ${this.name} transitioned in an unexpected state: ${this.state}`);
+        }
+    }
+    enterCanTransitionOut() {
+        if (this.state === SceneState.AfterTransitionIn ||
+            this.state === SceneState.Initial // only on recalculate
+        ) {
+            this.state = SceneState.CanTransitionOut;
+        }
+        else {
+            this.logger.warn(`Scene ${this.name} was marked as finished in an unexpected state: ${this.state}`);
+        }
+    }
+    isCached() {
+        return this.cached;
+    }
+    /**
+     * Invoke the given callback in the context of this scene.
+     *
+     * @remarks
+     * This method makes sure that the context of this scene is globally available
+     * during the execution of the callback.
+     *
+     * @param callback - The callback to invoke.
+     */
+    execute(callback) {
+        let result;
+        startScene(this);
+        startPlayback(this.playback);
+        try {
+            result = callback();
+        }
+        finally {
+            endPlayback(this.playback);
+            endScene(this);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR2VuZXJhdG9yU2NlbmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2NlbmVzL0dlbmVyYXRvclNjZW5lLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBQyxRQUFRLEVBQUUsVUFBVSxFQUFDLE1BQU0sZUFBZSxDQUFDO0FBQ25ELE9BQU8sRUFBQyxlQUFlLEVBQUUsZUFBZSxFQUFDLE1BQU0sV0FBVyxDQUFDO0FBRTNELE9BQU8sRUFBQyxpQkFBaUIsRUFBQyxNQUFNLFlBQVksQ0FBQztBQUU3QyxPQUFPLEVBQUMsWUFBWSxFQUFFLFNBQVMsRUFBRSxPQUFPLEVBQUMsTUFBTSxjQUFjLENBQUM7QUFFOUQsT0FBTyxFQUFDLFdBQVcsRUFBRSxRQUFRLEVBQUUsYUFBYSxFQUFFLFVBQVUsRUFBQyxNQUFNLFVBQVUsQ0FBQztBQUMxRSxPQUFPLEVBQUMsZUFBZSxFQUFDLE1BQU0sbUJBQW1CLENBQUM7QUFRbEQsT0FBTyxFQUFDLFVBQVUsRUFBQyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEVBQUMsT0FBTyxFQUFDLE1BQU0sV0FBVyxDQUFDO0FBQ2xDLE9BQU8sRUFBQyxNQUFNLEVBQUMsTUFBTSxVQUFVLENBQUM7QUFFaEMsT0FBTyxFQUFDLFNBQVMsRUFBQyxNQUFNLGFBQWEsQ0FBQztBQU10Qzs7OztHQUlHO0FBQ0gsTUFBTSxPQUFnQixjQUFjO0lBWWxDLElBQVcsVUFBVTtRQUNuQixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQztJQUN2QyxDQUFDO0lBRUQsSUFBVyxTQUFTO1FBQ2xCLE9BQU8sSUFBSSxDQUFDLFVBQVUsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUM7SUFDdkQsQ0FBQztJQUVELElBQVcsY0FBYztRQUN2QixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsWUFBWSxDQUFDO0lBQ2pDLENBQUM7SUFRRCxJQUFXLFVB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

package/lib/scenes/Inspectable.d.ts

@@ -0,0 +1,71 @@
+import type { Vector2 } from '../types/Vector';
+/**
+ * Represents an element to inspect.
+ *
+ * @remarks
+ * The type is not important because the UI does not interact with it.
+ * It serves as a key that will be passed back to an Inspectable scene to
+ * receive more information about said element.
+ */
+export type InspectedElement = unknown;
+/**
+ * Represents attributes of an inspected element.
+ */
+export type InspectedAttributes = {
+    stack?: string;
+    [K: string]: any;
+};
+/**
+ * Scenes can implement this interface to make their components
+ * inspectable through the UI.
+ */
+export interface Inspectable {
+    /**
+     * Get a possible element to inspect at a given position.
+     *
+     * @param x - The x coordinate.
+     * @param y - The y coordinate.
+     */
+    inspectPosition(x: number, y: number): InspectedElement | null;
+    /**
+     * Check if the inspected element is still valid.
+     *
+     * @remarks
+     * If a scene destroys and recreates its components upon every reset, the
+     * reference may no longer be valid. Even though the component is still
+     * present. This method should check that and return a new reference.
+     *
+     * @param element - The element to validate.
+     */
+    validateInspection(element: InspectedElement | null): InspectedElement | null;
+    /**
+     * Return the attributes of the inspected element.
+     *
+     * @remarks
+     * This information will be displayed in the "Properties" panel.
+     *
+     * @param element - The element to inspect.
+     */
+    inspectAttributes(element: InspectedElement): InspectedAttributes | null;
+    /**
+     * Draw an overlay for the inspected element.
+     *
+     * @remarks
+     * This method can be used to overlay additional information about an
+     * element on top of the animation.
+     *
+     * @param element - The element for which to draw an overlay.
+     * @param matrix - A local-to-screen matrix.
+     * @param context - The context to draw with.
+     */
+    drawOverlay(element: InspectedElement, matrix: DOMMatrix, context: CanvasRenderingContext2D): void;
+    /**
+     * Transform the absolute mouse coordinates into the scene's coordinate system.
+     *
+     * @param x - The x coordinate.
+     * @param y - The y coordinate.
+     */
+    transformMousePosition(x: number, y: number): Vector2 | null;
+}
+export declare function isInspectable(value: any): value is Inspectable;
+//# sourceMappingURL=Inspectable.d.ts.map

package/lib/scenes/Inspectable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Inspectable.d.ts","sourceRoot":"","sources":["../../src/scenes/Inspectable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAE/D;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAE9E;;;;;;;OAOG;IACH,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,IAAI,CAAC;IAEzE;;;;;;;;;;OAUG;IACH,WAAW,CACT,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAAC;IAER;;;;;OAKG;IACH,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CAC9D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,WAAW,CAE9D"}

package/lib/scenes/Inspectable.js

@@ -0,0 +1,4 @@
+export function isInspectable(value) {
+    return value && typeof value === 'object' && 'validateInspection' in value;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSW5zcGVjdGFibGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2NlbmVzL0luc3BlY3RhYmxlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQWlGQSxNQUFNLFVBQVUsYUFBYSxDQUFDLEtBQVU7SUFDdEMsT0FBTyxLQUFLLElBQUksT0FBTyxLQUFLLEtBQUssUUFBUSxJQUFJLG9CQUFvQixJQUFJLEtBQUssQ0FBQztBQUM3RSxDQUFDIn0=

package/lib/scenes/LifecycleEvents.d.ts

@@ -0,0 +1,18 @@
+import { EventDispatcher } from '../events';
+import type { Scene } from './Scene';
+/**
+ * Lifecycle events for {@link Scene} that are cleared on every reset.
+ */
+export declare class LifecycleEvents {
+    private readonly scene;
+    get onBeforeRender(): import("../events").Subscribable<CanvasRenderingContext2D, import("../events").EventHandler<CanvasRenderingContext2D>>;
+    protected readonly beforeRender: EventDispatcher<CanvasRenderingContext2D>;
+    get onBeginRender(): import("../events").Subscribable<CanvasRenderingContext2D, import("../events").EventHandler<CanvasRenderingContext2D>>;
+    protected readonly beginRender: EventDispatcher<CanvasRenderingContext2D>;
+    get onFinishRender(): import("../events").Subscribable<CanvasRenderingContext2D, import("../events").EventHandler<CanvasRenderingContext2D>>;
+    protected readonly finishRender: EventDispatcher<CanvasRenderingContext2D>;
+    get onAfterRender(): import("../events").Subscribable<CanvasRenderingContext2D, import("../events").EventHandler<CanvasRenderingContext2D>>;
+    protected readonly afterRender: EventDispatcher<CanvasRenderingContext2D>;
+    constructor(scene: Scene);
+}
+//# sourceMappingURL=LifecycleEvents.d.ts.map

package/lib/scenes/LifecycleEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleEvents.d.ts","sourceRoot":"","sources":["../../src/scenes/LifecycleEvents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,SAAS,CAAC;AAGnC;;GAEG;AACH,qBAAa,eAAe;IAyBP,OAAO,CAAC,QAAQ,CAAC,KAAK;IAxBzC,IAAW,cAAc,2HAExB;IACD,SAAS,CAAC,QAAQ,CAAC,YAAY,4CACmB;IAElD,IAAW,aAAa,2HAEvB;IACD,SAAS,CAAC,QAAQ,CAAC,WAAW,4CACoB;IAElD,IAAW,cAAc,2HAExB;IACD,SAAS,CAAC,QAAQ,CAAC,YAAY,4CACmB;IAElD,IAAW,aAAa,2HAEvB;IACD,SAAS,CAAC,QAAQ,CAAC,WAAW,4CACoB;gBAEd,KAAK,EAAE,KAAK;CAoBjD"}

package/lib/scenes/LifecycleEvents.js

@@ -0,0 +1,45 @@
+import { EventDispatcher } from '../events';
+import { SceneRenderEvent } from './Scene';
+/**
+ * Lifecycle events for {@link Scene} that are cleared on every reset.
+ */
+export class LifecycleEvents {
+    get onBeforeRender() {
+        return this.beforeRender.subscribable;
+    }
+    get onBeginRender() {
+        return this.beginRender.subscribable;
+    }
+    get onFinishRender() {
+        return this.finishRender.subscribable;
+    }
+    get onAfterRender() {
+        return this.afterRender.subscribable;
+    }
+    constructor(scene) {
+        this.scene = scene;
+        this.beforeRender = new EventDispatcher();
+        this.beginRender = new EventDispatcher();
+        this.finishRender = new EventDispatcher();
+        this.afterRender = new EventDispatcher();
+        this.scene.onRenderLifecycle.subscribe(([event, ctx]) => {
+            switch (event) {
+                case SceneRenderEvent.BeforeRender:
+                    return this.beforeRender.dispatch(ctx);
+                case SceneRenderEvent.BeginRender:
+                    return this.beginRender.dispatch(ctx);
+                case SceneRenderEvent.FinishRender:
+                    return this.finishRender.dispatch(ctx);
+                case SceneRenderEvent.AfterRender:
+                    return this.afterRender.dispatch(ctx);
+            }
+        });
+        this.scene.onReset.subscribe(() => {
+            this.beforeRender.clear();
+            this.beginRender.clear();
+            this.finishRender.clear();
+            this.afterRender.clear();
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiTGlmZWN5Y2xlRXZlbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NjZW5lcy9MaWZlY3ljbGVFdmVudHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFDLGVBQWUsRUFBQyxNQUFNLFdBQVcsQ0FBQztBQUUxQyxPQUFPLEVBQUMsZ0JBQWdCLEVBQUMsTUFBTSxTQUFTLENBQUM7QUFFekM7O0dBRUc7QUFDSCxNQUFNLE9BQU8sZUFBZTtJQUMxQixJQUFXLGNBQWM7UUFDdkIsT0FBTyxJQUFJLENBQUMsWUFBWSxDQUFDLFlBQVksQ0FBQztJQUN4QyxDQUFDO0lBSUQsSUFBVyxhQUFhO1FBQ3RCLE9BQU8sSUFBSSxDQUFDLFdBQVcsQ0FBQyxZQUFZLENBQUM7SUFDdkMsQ0FBQztJQUlELElBQVcsY0FBYztRQUN2QixPQUFPLElBQUksQ0FBQyxZQUFZLENBQUMsWUFBWSxDQUFDO0lBQ3hDLENBQUM7SUFJRCxJQUFXLGFBQWE7UUFDdEIsT0FBTyxJQUFJLENBQUMsV0FBVyxDQUFDLFlBQVksQ0FBQztJQUN2QyxDQUFDO0lBSUQsWUFBb0MsS0FBWTtRQUFaLFVBQUssR0FBTCxLQUFLLENBQU87UUFyQjdCLGlCQUFZLEdBQzdCLElBQUksZUFBZSxFQUE0QixDQUFDO1FBSy9CLGdCQUFXLEdBQzVCLElBQUksZUFBZSxFQUE0QixDQUFDO1FBSy9CLGlCQUFZLEdBQzdCLElBQUksZUFBZSxFQUE0QixDQUFDO1FBSy9CLGdCQUFXLEdBQzVCLElBQUksZUFBZSxFQUE0QixDQUFDO1FBR2hELElBQUksQ0FBQyxLQUFLLENBQUMsaUJBQWlCLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQyxLQUFLLEVBQUUsR0FBRyxDQUFDLEVBQUUsRUFBRTtZQUN0RCxRQUFRLEtBQUssRUFBRSxDQUFDO2dCQUNkLEtBQUssZ0JBQWdCLENBQUMsWUFBWTtvQkFDaEMsT0FBTyxJQUFJLENBQUMsWUFBWSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsQ0FBQztnQkFDekMsS0FBSyxnQkFBZ0IsQ0FBQyxXQUFXO29CQUMvQixPQUFPLElBQUksQ0FBQyxXQUFXLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDO2dCQUN4QyxLQUFLLGdCQUFnQixDQUFDLFlBQVk7b0JBQ2hDLE9BQU8sSUFBSSxDQUFDLFlBQVksQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLENBQUM7Z0JBQ3pDLEtBQUssZ0JBQWdCLENBQUMsV0FBVztvQkFDL0IsT0FBTyxJQUFJLENBQUMsV0FBVyxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsQ0FBQztZQUMxQyxDQUFDO1FBQ0gsQ0FBQyxDQUFDLENBQUM7UUFDSCxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsR0FBRyxFQUFFO1lBQ2hDLElBQUksQ0FBQyxZQUFZLENBQUMsS0FBSyxFQUFFLENBQUM7WUFDMUIsSUFBSSxDQUFDLFdBQVcsQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUN6QixJQUFJLENBQUMsWUFBWSxDQUFDLEtBQUssRUFBRSxDQUFDO1lBQzFCLElBQUksQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDM0IsQ0FBQyxDQUFDLENBQUM7SUFDTCxDQUFDO0NBQ0YifQ==

package/lib/scenes/Random.d.ts

@@ -0,0 +1,66 @@
+/**
+ * // TODO(refactor): maybe we can delete this
+ *
+ * A random number generator based on
+ * {@link https://gist.github.com/tommyettinger/46a874533244883189143505d203312c | Mulberry32}.
+ */
+export declare class Random {
+    private state;
+    /**
+     * Previously generated Gaussian random number.
+     *
+     * @remarks
+     * This is an optimization.
+     * Since {@link gauss} generates a pair of independent Gaussian random
+     * numbers, it returns one immediately and stores the other for the next call
+     * to {@link gauss}.
+     */
+    private nextGauss;
+    constructor(state: number);
+    /**
+     * @internal
+     */
+    static createSeed(): number;
+    /**
+     * Get the next random float in the given range.
+     *
+     * @param from - The start of the range.
+     * @param to - The end of the range.
+     */
+    nextFloat(from?: number, to?: number): number;
+    /**
+     * Get the next random integer in the given range.
+     *
+     * @param from - The start of the range.
+     * @param to - The end of the range. Exclusive.
+     */
+    nextInt(from?: number, to?: number): number;
+    /**
+     * Get a random float from a gaussian distribution.
+     * @param mean - The mean of the distribution.
+     * @param stdev - The standard deviation of the distribution.
+     */
+    gauss(mean?: number, stdev?: number): number;
+    /**
+     * Get an array filled with random floats in the given range.
+     *
+     * @param size - The size of the array.
+     * @param from - The start of the range.
+     * @param to - The end of the range.
+     */
+    floatArray(size: number, from?: number, to?: number): number[];
+    /**
+     Get an array filled with random integers in the given range.
+     *
+     * @param size - The size of the array.
+     * @param from - The start of the range.
+     * @param to - The end of the range. Exclusive.
+     */
+    intArray(size: number, from?: number, to?: number): number[];
+    /**
+     * Create a new independent generator.
+     */
+    spawn(): Random;
+    private next;
+}
+//# sourceMappingURL=Random.d.ts.map

package/lib/scenes/Random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Random.d.ts","sourceRoot":"","sources":["../../src/scenes/Random.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,qBAAa,MAAM;IAYE,OAAO,CAAC,KAAK;IAXhC;;;;;;;;OAQG;IACH,OAAO,CAAC,SAAS,CAAuB;gBAEb,KAAK,EAAE,MAAM;IAExC;;OAEG;WACW,UAAU;IAIxB;;;;;OAKG;IACI,SAAS,CAAC,IAAI,SAAI,EAAE,EAAE,SAAI;IAIjC;;;;;OAKG;IACI,OAAO,CAAC,IAAI,SAAI,EAAE,EAAE,SAAa;IASxC;;;;OAIG;IACI,KAAK,CAAC,IAAI,SAAI,EAAE,KAAK,SAAI,GAAG,MAAM;IAYzC;;;;;;OAMG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAI,EAAE,EAAE,SAAI,GAAG,MAAM,EAAE;IAI3D;;;;;;OAMG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAI,EAAE,EAAE,SAAa,GAAG,MAAM,EAAE;IAIlE;;OAEG;IACI,KAAK;IAIZ,OAAO,CAAC,IAAI;CAOb"}

package/lib/scenes/Random.js

@@ -0,0 +1,101 @@
+import { map } from '../tweening';
+import { range } from '../utils';
+/**
+ * // TODO(refactor): maybe we can delete this
+ *
+ * A random number generator based on
+ * {@link https://gist.github.com/tommyettinger/46a874533244883189143505d203312c | Mulberry32}.
+ */
+export class Random {
+    constructor(state) {
+        this.state = state;
+        /**
+         * Previously generated Gaussian random number.
+         *
+         * @remarks
+         * This is an optimization.
+         * Since {@link gauss} generates a pair of independent Gaussian random
+         * numbers, it returns one immediately and stores the other for the next call
+         * to {@link gauss}.
+         */
+        this.nextGauss = null;
+    }
+    /**
+     * @internal
+     */
+    static createSeed() {
+        return Math.floor(Math.random() * 4294967296);
+    }
+    /**
+     * Get the next random float in the given range.
+     *
+     * @param from - The start of the range.
+     * @param to - The end of the range.
+     */
+    nextFloat(from = 0, to = 1) {
+        return map(from, to, this.next());
+    }
+    /**
+     * Get the next random integer in the given range.
+     *
+     * @param from - The start of the range.
+     * @param to - The end of the range. Exclusive.
+     */
+    nextInt(from = 0, to = 4294967296) {
+        let value = Math.floor(map(from, to, this.next()));
+        if (value === to) {
+            value = from;
+        }
+        return value;
+    }
+    /**
+     * Get a random float from a gaussian distribution.
+     * @param mean - The mean of the distribution.
+     * @param stdev - The standard deviation of the distribution.
+     */
+    gauss(mean = 0, stdev = 1) {
+        let z = this.nextGauss;
+        this.nextGauss = null;
+        if (z === null) {
+            const x2pi = this.next() * 2 * Math.PI;
+            const g2rad = Math.sqrt(-2 * Math.log(1 - this.next()));
+            z = Math.cos(x2pi) * g2rad;
+            this.nextGauss = Math.sin(x2pi) * g2rad;
+        }
+        return mean + z * stdev;
+    }
+    /**
+     * Get an array filled with random floats in the given range.
+     *
+     * @param size - The size of the array.
+     * @param from - The start of the range.
+     * @param to - The end of the range.
+     */
+    floatArray(size, from = 0, to = 1) {
+        return range(size).map(() => this.nextFloat(from, to));
+    }
+    /**
+     Get an array filled with random integers in the given range.
+     *
+     * @param size - The size of the array.
+     * @param from - The start of the range.
+     * @param to - The end of the range. Exclusive.
+     */
+    intArray(size, from = 0, to = 4294967296) {
+        return range(size).map(() => this.nextInt(from, to));
+    }
+    /**
+     * Create a new independent generator.
+     */
+    spawn() {
+        return new Random(this.nextInt());
+    }
+    next() {
+        this.state |= 0;
+        this.state = (this.state + 0x6d2b79f5) | 0;
+        let t = Math.imul(this.state ^ (this.state >>> 15), 1 | this.state);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUmFuZG9tLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NjZW5lcy9SYW5kb20udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFDLEdBQUcsRUFBQyxNQUFNLGFBQWEsQ0FBQztBQUNoQyxPQUFPLEVBQUMsS0FBSyxFQUFDLE1BQU0sVUFBVSxDQUFDO0FBRS9COzs7OztHQUtHO0FBQ0gsTUFBTSxPQUFPLE1BQU07SUFZakIsWUFBMkIsS0FBYTtRQUFiLFVBQUssR0FBTCxLQUFLLENBQVE7UUFYeEM7Ozs7Ozs7O1dBUUc7UUFDSyxjQUFTLEdBQWtCLElBQUksQ0FBQztJQUVHLENBQUM7SUFFNUM7O09BRUc7SUFDSSxNQUFNLENBQUMsVUFBVTtRQUN0QixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxHQUFHLFVBQVUsQ0FBQyxDQUFDO0lBQ2hELENBQUM7SUFFRDs7Ozs7T0FLRztJQUNJLFNBQVMsQ0FBQyxJQUFJLEdBQUcsQ0FBQyxFQUFFLEVBQUUsR0FBRyxDQUFDO1FBQy9CLE9BQU8sR0FBRyxDQUFDLElBQUksRUFBRSxFQUFFLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDLENBQUM7SUFDcEMsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ0ksT0FBTyxDQUFDLElBQUksR0FBRyxDQUFDLEVBQUUsRUFBRSxHQUFHLFVBQVU7UUFDdEMsSUFBSSxLQUFLLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsSUFBSSxFQUFFLEVBQUUsRUFBRSxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQyxDQUFDO1FBQ25ELElBQUksS0FBSyxLQUFLLEVBQUUsRUFBRSxDQUFDO1lBQ2pCLEtBQUssR0FBRyxJQUFJLENBQUM7UUFDZixDQUFDO1FBRUQsT0FBTyxLQUFLLENBQUM7SUFDZixDQUFDO0lBRUQ7Ozs7T0FJRztJQUNJLEtBQUssQ0FBQyxJQUFJLEdBQUcsQ0FBQyxFQUFFLEtBQUssR0FBRyxDQUFDO1FBQzlCLElBQUksQ0FBQyxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUM7UUFDdkIsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUM7UUFDdEIsSUFBSSxDQUFDLEtBQUssSUFBSSxFQUFFLENBQUM7WUFDZixNQUFNLElBQUksR0FBRyxJQUFJLENBQUMsSUFBSSxFQUFFLEdBQUcsQ0FBQyxHQUFHLElBQUksQ0FBQyxFQUFFLENBQUM7WUFDdkMsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQyxDQUFDO1lBQ3hELENBQUMsR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxHQUFHLEtBQUssQ0FBQztZQUMzQixJQUFJLENBQUMsU0FBUyxHQUFHLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLEdBQUcsS0FBSyxDQUFDO1FBQzFDLENBQUM7UUFDRCxPQUFPLElBQUksR0FBRyxDQUFDLEdBQUcsS0FBSyxDQUFDO0lBQzFCLENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSSxVQUFVLENBQUMsSUFBWSxFQUFFLElBQUksR0FBRyxDQUFDLEVBQUUsRUFBRSxHQUFHLENBQUM7UUFDOUMsT0FBTyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUM7SUFDekQsQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNJLFFBQVEsQ0FBQyxJQUFZLEVBQUUsSUFBSSxHQUFHLENBQUMsRUFBRSxFQUFFLEdBQUcsVUFBVTtRQUNyRCxPQUFPLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQyxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQztJQUN2RCxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLO1FBQ1YsT0FBTyxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUMsQ0FBQztJQUNwQyxDQUFDO0lBRU8sSUFBSTtRQUNWLElBQUksQ0FBQyxLQUFLLElBQUksQ0FBQyxDQUFDO1FBQ2hCLElBQUksQ0FBQyxLQUFLLEdBQUcsQ0FBQyxJQUFJLENBQUMsS0FBSyxHQUFHLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUMzQyxJQUFJLENBQUMsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxLQUFLLEdBQUcsQ0FBQyxJQUFJLENBQUMsS0FBSyxLQUFLLEVBQUUsQ0FBQyxFQUFFLENBQUMsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDcEUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLEVBQUUsR0FBRyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUMvQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEtBQUssRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsR0FBRyxVQUFVLENBQUM7SUFDL0MsQ0FBQztDQUNGIn0=