@oliversalzburg/js-utils 0.6.0 → 0.7.0

package/lib/graphics/canvas-sandbox.d.ts

@@ -1,255 +0,0 @@
-import { Random } from "../data/random.js";
-import { Shake } from "../device/shake.js";
-import { Canvas } from "./canvas.js";
-import { RenderLoop } from "./render-loop.js";
-/**
- * Provides the input as-is.
- *
- * This method exists only to make use of the template string tag in code,
- * which allows us to use in-IDE support for CSS, even if there is no build
- * process to interpret the tag.
- * {@link https://lit.dev/docs/components/styles/ | Lit styles}.
- * @param input - The CSS code.
- * @returns The CSS code as-is.
- */
-export declare const css: (input: TemplateStringsArray) => string;
-/**
- * The CSS we inject into the document, if requested.
- */
-export declare const CANVAS_SANDBOX_DEFAULT_CSS: string;
-/**
- * The options your application has to accept so it can interact with the {@linkcode CanvasSandbox}.
- */
-export interface CanvasSandboxExpectedOptions {
-    /**
-     * Should your application run in dark mode?
-     * You can ignore this setting and produce any colored output you want,
-     * but the setting will be toggeled by the sandbox according to the user's
-     * browser/OS preference.
-     */
-    darkMode: boolean;
-    /**
-     * The seed for the PRNG.
-     */
-    seed: number;
-    /**
-     * The part of the canvas that the targetted render kernel will handle.
-     * This is ignored, unless you use multi-process rendering.
-     */
-    viewport: {
-        /**
-         * Start of the viewport in fractional world-space.
-         */
-        x: number;
-        /**
-         * Start of the viewport in fractional world-space.
-         */
-        y: number;
-        /**
-         * Width of the viewport in fractional world-space.
-         */
-        w: number;
-        /**
-         * Height of the viewport in fractional world-space.
-         */
-        h: number;
-    };
-}
-/**
- * Describes an application running inside the {@linkcode CanvasSandbox}.
- * @typeParam TApplicationOptions - The type of the options object
- * with which the application is constructed.
- */
-export interface CanvasSandboxApplication<TCanvas extends Canvas, TApplicationOptions extends CanvasSandboxExpectedOptions> {
-    /**
-     * The options with which the application was constructed.
-     */
-    options: TApplicationOptions;
-    /**
-     * The PRNG used in this application.
-     */
-    random: Random;
-    /**
-     * Is the application currently paused?
-     * Should be get/set, but can also be ignored, if the feature isn't used.
-     */
-    paused: boolean;
-    /**
-     * Request the application to draw a new frame.
-     * @param delta - How many milliseconds passed since the last frame draw.
-     * @param timestamp - The current timestamp.
-     */
-    onDraw(delta: number, timestamp: number): void;
-    /**
-     * Reconfigure the application with the given options and restart it.
-     * @param canvas - The canvas to use.
-     * @param options - The new options to use.
-     */
-    reconfigure(canvas: TCanvas, options?: Partial<TApplicationOptions>): void;
-    /**
-     * Start the application.
-     */
-    start(options?: Partial<TApplicationOptions>): void;
-    /**
-     * Pause rendering.
-     * @param paused - Should rendering be paused (`true`) or unpaused (`false`)?
-     */
-    pause(paused: boolean): void;
-}
-/**
- * Options for a {@linkcode CanvasSandbox}.
- */
-export interface CanvasSandboxOptions {
-    /**
-     * Should the sandbox render developer information?
-     * @defaultValue false
-     */
-    devMode: boolean;
-    /**
-     * Should the sandbox default CSS be injected into the body?
-     * @defaultValue true
-     */
-    injectDefaultCss: boolean;
-}
-/**
- * The {@linkcode CanvasSandbox} provides a scaffold to quickly perform experiments
- * with a {@linkcode !HTMLCanvasElement} in a document. Common functionality for such
- * experiments is implemented in the sandbox already.
- * @example
- * ### `main.ts`
- * ```ts
- * import { Random, seedFromString } from "@oliversalzburg/js-utils/lib/random.js";
- * import { Canvas } from "@oliversalzburg/js-utils/lib/graphics/canvas.js";
- * import { getDocumentElementTypeByIdStrict } from "@oliversalzburg/js-utils/lib/dom/core.js";
- * import { CanvasSandbox } from "@oliversalzburg/js-utils/lib/graphics/canvas-sandbox.js";
- *
- * interface ApplicationOptions {
- *   seed: string;
- *   somethingElse: number;
- * }
- *
- * class Application {
- *   canvas: Canvas;
- *   options: ApplicationOptions;
- *   random: Random;
- *
- *   constructor(canvas:Canvas, options: ApplicationOptions) {
- *     this.canvas = canvas;
- *     this.options = options;
- *     this.random = new Random(seedFromString(options.seed));
- *   }
- *
- *   reconfigure(canvas:Canvas, options: Partial<ApplicationOptions> = {}) {
- *     this.canvas = canvas;
- *     this.options = { ...this.options, ...options };
- *     this.random = new Random(seedFromString(options.seed));
- *   }
- *
- *   onDraw(delta:number, timestamp:number) {
- *     // draw something on `this.canvas`
- *   }
- *
- *   start() {}
- * }
- *
- * const canvasNode = getDocumentElementTypeByIdStrict(document, "main", HTMLCanvasElement);
- * const canvasSandbox = new CanvasSandbox(
- *   window,
- *   canvasNode,
- *   Application,
- *   {seed: "foo", somethingElse: 12345}
- * );
- *
- * // By running the sandbox, your `start()` and `onDraw()` methods will automatically be invoked
- * // by the sandbox. You shouldn't invoke those methods directly from your own code.
- * canvasSandbox.run();
- * ```
- * ### `index.html`
- * ```html
- * <!doctype html>
- * <html>
- *   <head>
- *     <meta charset="UTF-8" />
- *   </head>
- *
- *   <body>
- *     <canvas id="main" class="darkMode" width="512" height="512"></canvas>
- *   </body>
- *   <script src="main.ts" type="module"></script>
- * </html>
- * ```
- * @typeParam TApplicationOptions - The type of the options
- * the application in the sandbox will be constructed with.
- */
-export declare class CanvasSandbox<TCanvas extends Canvas, TApplicationOptions extends CanvasSandboxExpectedOptions> {
-    #private;
-    /**
-     * The window the sandbox is running in.
-     */
-    readonly window: Window;
-    /**
-     * The document the sandbox is interacting with.
-     */
-    readonly document: Document;
-    /**
-     * The application running inside the sandbox.
-     */
-    readonly application: CanvasSandboxApplication<TCanvas, TApplicationOptions>;
-    /**
-     * The canvas node that we're drawing into.
-     */
-    readonly canvasNode: HTMLCanvasElement;
-    /**
-     * Our convenience canvas wrapper, which we provide to the application
-     * to render to.
-     */
-    readonly canvas: TCanvas;
-    /**
-     * The render loop we use to control frame rendering.
-     */
-    readonly renderLoop: RenderLoop;
-    /**
-     * Our handler for device shaking.
-     */
-    readonly shakeHandler: Shake;
-    /**
-     * The options for this sandbox.
-     */
-    readonly sandboxOptions: Partial<CanvasSandboxOptions>;
-    /**
-     * Construct a new {@linkcode CanvasSandbox}.
-     * @param window - The window we're running inside.
-     * @param canvasNode - The canvas node we're drawing to.
-     * @param CanvasImpl - The canvas implementation you want to use in this sandbox.
-     * see {@linkcode Canvas2D} and {@linkcode Canvas3D}.
-     * @param Application - The application that is going to run in the sandbox.
-     * @param options - The options that the application should be constructed with.
-     * @param sandboxOptions - The options for the sandbox itself.
-     */
-    constructor(window: Window, canvasNode: HTMLCanvasElement, CanvasImpl: new (canvasNode: HTMLCanvasElement) => TCanvas, Application: new (
-    /**
-     * The canvas that the application will receive.
-     */
-    canvas: TCanvas, 
-    /**
-     * The options that will be passed to the application.
-     */
-    options: TApplicationOptions) => CanvasSandboxApplication<TCanvas, TApplicationOptions>, options: TApplicationOptions, sandboxOptions?: Partial<CanvasSandboxOptions>);
-    /**
-     * Injects our default CSS into the document, if it hasn't already been injected.
-     * @see {@linkcode CANVAS_SANDBOX_DEFAULT_CSS}
-     */
-    injectDefaultCss(): void;
-    /**
-     * Run the sandbox.
-     */
-    run(): void;
-    /**
-     * Switch the sandbox to dark mode.
-     */
-    toDarkMode(): void;
-    /**
-     * Switch the sandbox to light mode.
-     */
-    toLightMode(): void;
-}

package/lib/graphics/canvas-sandbox.js

@@ -1,361 +0,0 @@
-import { Shake } from "../device/shake.js";
-import { getDocumentElementTypeById } from "../dom/core.js";
-import { redirectErrorsToConsole } from "../errors/console.js";
-import { RenderLoop } from "./render-loop.js";
-/**
- * Provides the input as-is.
- *
- * This method exists only to make use of the template string tag in code,
- * which allows us to use in-IDE support for CSS, even if there is no build
- * process to interpret the tag.
- * {@link https://lit.dev/docs/components/styles/ | Lit styles}.
- * @param input - The CSS code.
- * @returns The CSS code as-is.
- */
-export const css = (input) => input.join("");
-/**
- * The CSS we inject into the document, if requested.
- */
-export const CANVAS_SANDBOX_DEFAULT_CSS = /* PURE */ css `
-  html,
-  body {
-    height: 100%;
-    width: 100%;
-    padding: 0;
-    margin: 0;
-    background-color: #808080;
-  }
-
-  body {
-    display: block !important;
-    transition: background-color 1s ease-in-out;
-  }
-  body.darkMode {
-    background-color: #211f1f;
-
-    .credits a {
-      color: #a0a0a0;
-    }
-  }
-  body.lightMode {
-    background-color: #e6e6e6;
-
-    .credits a {
-      color: #606060;
-    }
-  }
-
-  #main {
-    display: flex;
-    position: absolute;
-    margin: auto;
-    top: 0;
-    left: 0;
-    right: 0;
-    bottom: 0;
-    justify-content: center;
-    align-items: center;
-    z-index: 1;
-
-    filter: drop-shadow(10px 10px 4px rgba(0, 0, 0, 0.5));
-    transition: all 1s;
-  }
-
-  .credits {
-    display: block;
-    font-family: sans-serif;
-    font-size: 10pt;
-    color: #808080;
-    position: absolute;
-    top: 80%;
-    text-align: center;
-    user-select: none;
-    width: 100%;
-  }
-`;
-/**
- * The {@linkcode CanvasSandbox} provides a scaffold to quickly perform experiments
- * with a {@linkcode !HTMLCanvasElement} in a document. Common functionality for such
- * experiments is implemented in the sandbox already.
- * @example
- * ### `main.ts`
- * ```ts
- * import { Random, seedFromString } from "@oliversalzburg/js-utils/lib/random.js";
- * import { Canvas } from "@oliversalzburg/js-utils/lib/graphics/canvas.js";
- * import { getDocumentElementTypeByIdStrict } from "@oliversalzburg/js-utils/lib/dom/core.js";
- * import { CanvasSandbox } from "@oliversalzburg/js-utils/lib/graphics/canvas-sandbox.js";
- *
- * interface ApplicationOptions {
- *   seed: string;
- *   somethingElse: number;
- * }
- *
- * class Application {
- *   canvas: Canvas;
- *   options: ApplicationOptions;
- *   random: Random;
- *
- *   constructor(canvas:Canvas, options: ApplicationOptions) {
- *     this.canvas = canvas;
- *     this.options = options;
- *     this.random = new Random(seedFromString(options.seed));
- *   }
- *
- *   reconfigure(canvas:Canvas, options: Partial<ApplicationOptions> = {}) {
- *     this.canvas = canvas;
- *     this.options = { ...this.options, ...options };
- *     this.random = new Random(seedFromString(options.seed));
- *   }
- *
- *   onDraw(delta:number, timestamp:number) {
- *     // draw something on `this.canvas`
- *   }
- *
- *   start() {}
- * }
- *
- * const canvasNode = getDocumentElementTypeByIdStrict(document, "main", HTMLCanvasElement);
- * const canvasSandbox = new CanvasSandbox(
- *   window,
- *   canvasNode,
- *   Application,
- *   {seed: "foo", somethingElse: 12345}
- * );
- *
- * // By running the sandbox, your `start()` and `onDraw()` methods will automatically be invoked
- * // by the sandbox. You shouldn't invoke those methods directly from your own code.
- * canvasSandbox.run();
- * ```
- * ### `index.html`
- * ```html
- * <!doctype html>
- * <html>
- *   <head>
- *     <meta charset="UTF-8" />
- *   </head>
- *
- *   <body>
- *     <canvas id="main" class="darkMode" width="512" height="512"></canvas>
- *   </body>
- *   <script src="main.ts" type="module"></script>
- * </html>
- * ```
- * @typeParam TApplicationOptions - The type of the options
- * the application in the sandbox will be constructed with.
- */
-export class CanvasSandbox {
-    /**
-     * The window the sandbox is running in.
-     */
-    window;
-    /**
-     * The document the sandbox is interacting with.
-     */
-    document;
-    /**
-     * The application running inside the sandbox.
-     */
-    application;
-    /**
-     * The canvas node that we're drawing into.
-     */
-    canvasNode;
-    /**
-     * Our convenience canvas wrapper, which we provide to the application
-     * to render to.
-     */
-    canvas;
-    /**
-     * The render loop we use to control frame rendering.
-     */
-    renderLoop;
-    /**
-     * Our handler for device shaking.
-     */
-    shakeHandler;
-    /**
-     * The options for this sandbox.
-     */
-    sandboxOptions;
-    /**
-     * The handle that keeps track of debouncing of `resize` events.
-     */
-    #resizeDebounce = null;
-    /**
-     * Construct a new {@linkcode CanvasSandbox}.
-     * @param window - The window we're running inside.
-     * @param canvasNode - The canvas node we're drawing to.
-     * @param CanvasImpl - The canvas implementation you want to use in this sandbox.
-     * see {@linkcode Canvas2D} and {@linkcode Canvas3D}.
-     * @param Application - The application that is going to run in the sandbox.
-     * @param options - The options that the application should be constructed with.
-     * @param sandboxOptions - The options for the sandbox itself.
-     */
-    constructor(window, canvasNode, CanvasImpl, Application, options, sandboxOptions) {
-        this.window = window;
-        this.document = window.document;
-        this.canvasNode = canvasNode;
-        this.canvas = new CanvasImpl(canvasNode);
-        this.sandboxOptions = sandboxOptions ?? {};
-        if (sandboxOptions?.injectDefaultCss ?? true) {
-            this.injectDefaultCss();
-        }
-        this.application = new Application(this.canvas, options);
-        const applicationOnDraw = this.application.onDraw.bind(this.application);
-        this.renderLoop = new RenderLoop(applicationOnDraw, this.canvas, {
-            drawFps: sandboxOptions?.devMode,
-        });
-        this.shakeHandler = new Shake();
-        this.#hookWindow();
-        this.#hookBody();
-        this.#hookCanvas();
-        const systemPrefersDarkMode = this.window.matchMedia("(prefers-color-scheme: dark)").matches;
-        if (systemPrefersDarkMode) {
-            this.toDarkMode();
-        }
-        else {
-            this.toLightMode();
-        }
-    }
-    /**
-     * Injects our default CSS into the document, if it hasn't already been injected.
-     * @see {@linkcode CANVAS_SANDBOX_DEFAULT_CSS}
-     */
-    injectDefaultCss() {
-        const existingStyle = getDocumentElementTypeById(this.document, "canvas-sandbox-styles", HTMLStyleElement);
-        if (existingStyle) {
-            return;
-        }
-        const styleNode = this.document.createElement("style");
-        styleNode.textContent = CANVAS_SANDBOX_DEFAULT_CSS;
-        this.document.head.appendChild(styleNode);
-    }
-    /**
-     * Run the sandbox.
-     */
-    run() {
-        if (this.sandboxOptions.devMode) {
-            // biome-ignore lint/suspicious/noConsole: This is a development mode option.
-            console.info("CanvasSandbox: Starting application with these options.", this.application.options);
-        }
-        this.application.start();
-        // In case the application doesn't maintain this state itself.
-        this.application.paused = false;
-        this.renderLoop.unblock();
-    }
-    /**
-     * Create event listeners on the document `body`.
-     */
-    #hookBody() {
-        this.document.body.addEventListener("click", async (event) => {
-            if (event.defaultPrevented) {
-                return;
-            }
-            if (!this.document.fullscreenEnabled) {
-                return;
-            }
-            // Make canvas fullscreen.
-            if (!this.document.fullscreenElement && event.target === this.document.body) {
-                if (this.sandboxOptions.devMode) {
-                    // biome-ignore lint/suspicious/noConsole: This is a development mode option.
-                    console.info("CanvasSandbox: Canvas is entering fullscreen mode...");
-                }
-                await this.canvasNode.requestFullscreen();
-            }
-        });
-        this.document.body.addEventListener("keyup", event => {
-            switch (event.key) {
-                case "Enter":
-                    this.#reconfigureApplication();
-                    break;
-                case " ":
-                    this.application.pause(!this.application.paused);
-                    break;
-            }
-        });
-    }
-    /**
-     * Reconfigures, and then restarts, the application.
-     * @param options - The new options for the application.
-     */
-    #reconfigureApplication(options = {}) {
-        this.application.reconfigure(this.canvas, options);
-        this.application.start();
-        // In case the application doesn't maintain this state itself.
-        this.application.paused = false;
-    }
-    /**
-     * Create event listeners on the canvas node in the document.
-     */
-    #hookCanvas() {
-        this.canvasNode.addEventListener("click", (event) => {
-            this.application.pause(!this.application.paused);
-            event.preventDefault();
-        });
-    }
-    /**
-     * Create event listeners on the window we're running in.
-     */
-    #hookWindow() {
-        this.shakeHandler
-            .start()
-            .then(() => {
-            this.shakeHandler.addEventListener("shake", () => {
-                if (this.sandboxOptions.devMode) {
-                    // biome-ignore lint/suspicious/noConsole: This is a development mode option.
-                    console.info("CanvasSandbox: Shake detected. Reconfiguring application...");
-                }
-                this.#reconfigureApplication();
-            });
-        })
-            .catch(redirectErrorsToConsole(console));
-        this.window
-            .matchMedia("(prefers-color-scheme: dark)")
-            .addEventListener("change", ({ matches }) => {
-            if (matches) {
-                this.toDarkMode();
-            }
-            else {
-                this.toLightMode();
-            }
-        });
-        this.window.addEventListener("resize", _event => {
-            if (this.#resizeDebounce !== null) {
-                return;
-            }
-            this.#resizeDebounce = this.window.setTimeout(() => {
-                this.#resizeDebounce = null;
-            }, 1000);
-            if (this.sandboxOptions.devMode) {
-                // biome-ignore lint/suspicious/noConsole: This is a development mode option.
-                console.info(`CanvasSandbox: Window resized (${this.window.innerWidth.toFixed(0)}x${this.window.innerHeight.toFixed(0)}x${this.window.devicePixelRatio.toFixed(3)}). Reconfiguring application...`);
-            }
-            this.application.reconfigure(this.canvas);
-            this.canvas.refreshCanvasNode();
-            this.application.start();
-            // In case the application doesn't maintain this state itself.
-            this.application.paused = false;
-        });
-    }
-    /**
-     * Switch the sandbox to dark mode.
-     */
-    toDarkMode() {
-        this.#reconfigureApplication({
-            darkMode: true,
-        });
-        document.body.classList.add("darkMode");
-        document.body.classList.remove("lightMode");
-    }
-    /**
-     * Switch the sandbox to light mode.
-     */
-    toLightMode() {
-        this.#reconfigureApplication({
-            darkMode: false,
-        });
-        document.body.classList.add("lightMode");
-        document.body.classList.remove("darkMode");
-    }
-}
-//# sourceMappingURL=canvas-sandbox.js.map

package/lib/graphics/canvas-sandbox.js.map

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

package/lib/graphics/canvas.d.ts

@@ -1,57 +0,0 @@
-/**
- * The base class for canvas helpers, which also defines a common interface.
- *
- * Derivates of the class might chose to leave implementations of individual methods
- * empty, if it fits their pattern better. For example, one canvas might wrap its
- * context and applications using that canvas will only interact with its interface.
- * Another canvas implementation might expose the context and all give the application
- * full control over the rendering cycle.
- */
-export declare abstract class Canvas {
-    /**
-     * The canvas element we're interacting with.
-     */
-    readonly canvasElement: HTMLCanvasElement | OffscreenCanvas;
-    /**
-     * Retrieves the width of the canvas.
-     * @returns The width of the canvas.
-     */
-    get width(): number;
-    /**
-     * Retrieves the height of the canvas.
-     * @returns The height of the canvas.
-     */
-    get height(): number;
-    /**
-     * Constructs a new canvas helper.
-     * @param canvas - The canvas node to wrap.
-     */
-    constructor(canvas: HTMLCanvasElement | OffscreenCanvas);
-    /**
-     * Rebuild rendering pipeline in reaction to a change in the canvas.
-     * Usually, when the canvas was resized.
-     */
-    abstract refreshCanvasNode(): void;
-    /**
-     * Handle any internal update calls that would be required to present a new frame.
-     * Not all implementations will need this.
-     */
-    abstract update(): void;
-    /**
-     * Present a new frame.
-     * Not all implementations will need this.
-     */
-    abstract render(): void;
-    /**
-     * Clear the canvas with the given color.
-     * @param color - The color to clear the canvas with.
-     */
-    abstract clearWith(color: number): void;
-    /**
-     * Draw FPS information onto the canvas.
-     * @param frameTimes - Durations of previous frame draws.
-     * @param frameTime - The duration of the previous frame draw.
-     * @param timeDelta - The time elapsed since the last frame.
-     */
-    abstract renderFpsInfo(frameTimes: Array<number>, frameTime: number, timeDelta: number): void;
-}