@oliversalzburg/js-utils 0.0.28-dev.10 → 0.0.28-dev.11

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

@@ -0,0 +1,241 @@
+/// <reference types="@types/web" />
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { ConstructorOf } from "../core.js";
+import { Random } from "../random.js";
+import { CanvasSandboxApplication, CanvasSandboxExpectedOptions } from "./canvas-sandbox.js";
+import { Canvas } from "./canvas.js";
+import { Canvas2DHeadless } from "./canvas2d-headless.js";
+import { RenderLoop } from "./render-loop.js";
+/**
+ * Sent from the host when a worker should reconfigure itself.
+ */
+export interface CanvasWorkerMessageReconfigure<TApplicationOptions extends CanvasSandboxExpectedOptions> {
+    /**
+     * Type identifier of this message.
+     */
+    type: "reconfigure";
+    /**
+     * New ID for the worker.
+     */
+    id: string;
+    /**
+     * New canvas for the worker to use.
+     */
+    canvas: OffscreenCanvas;
+    /**
+     * New application options to use.
+     */
+    options: TApplicationOptions;
+}
+/**
+ * Sent from the host when a worker should start its rendering kernel.
+ */
+export interface CanvasWorkerMessageStart<TApplicationOptions extends CanvasSandboxExpectedOptions> {
+    /**
+     * Type identifier of this message.
+     */
+    type: "start";
+    /**
+     * New application options to use before starting.
+     */
+    options: TApplicationOptions;
+}
+/**
+ * Sent from a worker when it finished rendering the current scene.
+ */
+export interface CanvasWorkerSceneFinishMessage {
+    /**
+     * Type identifier of this message.
+     */
+    type: "sceneFinish";
+    /**
+     * Point in time when the scene finished rendering.
+     */
+    timestamp: number;
+}
+/**
+ * The messages that are passed between the canvas sandbox host and its workers.
+ */
+export type CanvasWorkerMessage<TApplicationOptions extends CanvasSandboxExpectedOptions> = CanvasWorkerMessageReconfigure<TApplicationOptions> | CanvasWorkerMessageStart<TApplicationOptions> | CanvasWorkerSceneFinishMessage;
+/**
+ * The canvas worker handles a web worker instance in the canvas sandbox host.
+ *
+ * It provides a thin abstraction over the web worker IPC messaging.
+ */
+export declare class CanvasWorker<TApplicationOptions extends CanvasSandboxExpectedOptions> extends EventTarget {
+    /**
+     * The ID of this worker.
+     */
+    id: string;
+    /**
+     * The canvas element that this worker should handle.
+     */
+    canvas: HTMLCanvasElement | undefined;
+    /**
+     * The offscreen canvas that we created for this worker.
+     */
+    canvasOffscreen: OffscreenCanvas | undefined;
+    /**
+     * The application options for the worker.
+     *
+     * These are usually very similar, if not identical, to the host application options.
+     * Workers just usually get a different viewport assigned to them, correlating with the
+     * canvas element in the DOM that they draw to.
+     */
+    readonly options: TApplicationOptions;
+    /**
+     * The web worker instance itself.
+     */
+    readonly workerInstance: Worker;
+    /**
+     * Constructs a new canvas worker.
+     * @param id - The ID of the worker.
+     * @param source - The code that the worker should run. It's common to use a hybrid code module
+     * for as the sandbox application. This means the code of the host and the workers is identical,
+     * they just construct different code path on load/init. In such case, the source can simply be
+     * `new URL(import.meta.url)`.
+     * @param canvas - The canvas element to draw to.
+     * @param options - The application options.
+     */
+    constructor(id: string, source: URL, canvas: HTMLCanvasElement, options: TApplicationOptions);
+    /**
+     * Posts a message to the worker.
+     *
+     * As messages to workers are _posted_ instead of _sent_, there is no delivery feedback.
+     * @param message - The message to post.
+     * @param transfer - The transferables to transfer to the worker with this message.
+     */
+    postMessage(message: CanvasWorkerMessage<TApplicationOptions>, transfer?: Array<Transferable>): void;
+}
+/**
+ * The canvas worker instance handles a web worker instance in worker instance itself, and
+ * handles a feedback channel to the host application.
+ *
+ * It provides a thin abstraction over the web worker IPC messaging.
+ *
+ * ```ts
+ * // Construct inside of worker from global scope and rendering kernel class.
+ * const worker = new CanvasWorkerInstance(self, RenderKernel);
+ * // Listen to custom events (messages) you send from the host.
+ * worker.addEventListener("fade", () => worker.renderKernel?.fadeOut());
+ * ```
+ */
+export declare class CanvasWorkerInstance<TCanvas extends Canvas2DHeadless, TApplicationOptions extends CanvasSandboxExpectedOptions, TKernel extends CanvasSandboxApplication<TCanvas, TApplicationOptions>> extends EventTarget {
+    #private;
+    /**
+     * The global scope of the worker.
+     */
+    readonly self: typeof globalThis;
+    /**
+     * The ID of the worker.
+     */
+    id: string;
+    /**
+     * The rendering kernel, which produces frames, and renders them to our
+     * offscreen canvas.
+     */
+    renderKernel: TKernel | undefined;
+    /**
+     * The canvas element we're presenting to.
+     */
+    canvas: TCanvas | undefined;
+    /**
+     * The offscreen canvas we're rendering to.
+     */
+    offscreenCanvas: OffscreenCanvas | undefined;
+    /**
+     * Our rendering context to draw to.
+     */
+    offscreenContext: OffscreenCanvasRenderingContext2D | undefined;
+    /**
+     * Manages frame rendering timing.
+     */
+    renderLoop: RenderLoop | undefined;
+    /**
+     * Constructs a new canvas worker instance.
+     *
+     * Note that many properties are only initialized after the host sent an
+     * initialization message.
+     * @param self - Our global worker scope.
+     * @param Kernel - The rendering kernel class to construct.
+     */
+    constructor(self: typeof globalThis, Kernel: ConstructorOf<TKernel>);
+    /**
+     * Render a frame.
+     * @param delta - How many milliseconds have passed since the last invocation?
+     */
+    render: (delta: number) => void;
+    /**
+     * Reconfigure the worker.
+     * @param id - New ID for this worker.
+     * @param canvas - New canvas to render to.
+     * @param options - New application options.
+     */
+    reconfigure(id: string, canvas: OffscreenCanvas, options: TApplicationOptions): void;
+    /**
+     * Start rendering.
+     * @param options - New application options.
+     */
+    start(options: TApplicationOptions): void;
+    /**
+     * Posts a message to the host.
+     * @param message - The message to post.
+     */
+    postMessage(message: CanvasWorkerMessage<TApplicationOptions>): void;
+}
+/**
+ * Base class for multi-process canvas sandbox applications.
+ *
+ * Helps in orchestrating the workers.
+ */
+export declare abstract class CanvasSandboxHostApplication<TCanvas extends Canvas, TApplicationOptions extends CanvasSandboxExpectedOptions> implements CanvasSandboxApplication<TCanvas, TApplicationOptions> {
+    /**
+     * Usually a hidden canvas that serves as a proxy for canvas sandbox events.
+     */
+    canvas: TCanvas;
+    /**
+     * Application options.
+     */
+    options: TApplicationOptions;
+    /**
+     * PRNG instance for the application.
+     */
+    random: Random;
+    /**
+     * Is the application running right now?
+     */
+    paused: boolean;
+    /**
+     * Web worker instances.
+     */
+    readonly workers: CanvasWorker<TApplicationOptions>[];
+    /**
+     * Construct a new host application.
+     * @param canvas - Usually a hidden canvas in the DOM to serve as an event proxy.
+     * @param options - Application options.
+     */
+    constructor(canvas: TCanvas, options: TApplicationOptions);
+    /**
+     * Reconfigure the application with the given options and restart it.
+     * @param canvas - The canvas to use.
+     * @param options - The new options to use.
+     */
+    abstract reconfigure(canvas: TCanvas, options?: Partial<TApplicationOptions>): void;
+    /**
+     * Request the application to draw a new frame.
+     * This call has no effect in a host application, as all rendering happens in the workers.
+     * @param _delta - How many milliseconds passed since the last frame draw.
+     * @param _timestamp - The current timestamp.
+     */
+    onDraw(_delta: number, _timestamp: number): void;
+    /**
+     * Start the application.
+     */
+    start(): void;
+    /**
+     * Posts a message to all workers.
+     * @param message - Message to post to all workers.
+     */
+    postMessageAll(message: CanvasWorkerMessage<TApplicationOptions>): void;
+}

package/graphics/canvas-sandbox-mp.js

@@ -0,0 +1,261 @@
+import { isNil, mustExist } from "../nil.js";
+import { Random } from "../random.js";
+import { Canvas2DHeadless } from "./canvas2d-headless.js";
+import { RenderLoop } from "./render-loop.js";
+/**
+ * The canvas worker handles a web worker instance in the canvas sandbox host.
+ *
+ * It provides a thin abstraction over the web worker IPC messaging.
+ */
+export class CanvasWorker extends EventTarget {
+    /**
+     * The ID of this worker.
+     */
+    id;
+    /**
+     * The canvas element that this worker should handle.
+     */
+    canvas;
+    /**
+     * The offscreen canvas that we created for this worker.
+     */
+    canvasOffscreen;
+    /**
+     * The application options for the worker.
+     *
+     * These are usually very similar, if not identical, to the host application options.
+     * Workers just usually get a different viewport assigned to them, correlating with the
+     * canvas element in the DOM that they draw to.
+     */
+    options;
+    /**
+     * The web worker instance itself.
+     */
+    workerInstance;
+    /**
+     * Constructs a new canvas worker.
+     * @param id - The ID of the worker.
+     * @param source - The code that the worker should run. It's common to use a hybrid code module
+     * for as the sandbox application. This means the code of the host and the workers is identical,
+     * they just construct different code path on load/init. In such case, the source can simply be
+     * `new URL(import.meta.url)`.
+     * @param canvas - The canvas element to draw to.
+     * @param options - The application options.
+     */
+    constructor(id, source, canvas, options) {
+        super();
+        this.id = id;
+        this.canvas = canvas;
+        this.options = options;
+        this.workerInstance = new Worker(source, {
+            type: "module",
+        });
+        this.workerInstance.onmessage = (message) => {
+            this.dispatchEvent(new CustomEvent(message.data.type));
+        };
+    }
+    /**
+     * Posts a message to the worker.
+     *
+     * As messages to workers are _posted_ instead of _sent_, there is no delivery feedback.
+     * @param message - The message to post.
+     * @param transfer - The transferables to transfer to the worker with this message.
+     */
+    postMessage(message, transfer) {
+        this.workerInstance.postMessage(message, transfer ?? []);
+    }
+}
+/**
+ * The canvas worker instance handles a web worker instance in worker instance itself, and
+ * handles a feedback channel to the host application.
+ *
+ * It provides a thin abstraction over the web worker IPC messaging.
+ *
+ * ```ts
+ * // Construct inside of worker from global scope and rendering kernel class.
+ * const worker = new CanvasWorkerInstance(self, RenderKernel);
+ * // Listen to custom events (messages) you send from the host.
+ * worker.addEventListener("fade", () => worker.renderKernel?.fadeOut());
+ * ```
+ */
+export class CanvasWorkerInstance extends EventTarget {
+    /**
+     * The global scope of the worker.
+     */
+    self;
+    /**
+     * The ID of the worker.
+     */
+    id;
+    /**
+     * The rendering kernel, which produces frames, and renders them to our
+     * offscreen canvas.
+     */
+    renderKernel;
+    /**
+     * The canvas element we're presenting to.
+     */
+    canvas;
+    /**
+     * The offscreen canvas we're rendering to.
+     */
+    offscreenCanvas;
+    /**
+     * Our rendering context to draw to.
+     */
+    offscreenContext;
+    /**
+     * Manages frame rendering timing.
+     */
+    renderLoop;
+    /**
+     * Constructor of our rendering kernel.
+     */
+    #Kernel;
+    /**
+     * Constructs a new canvas worker instance.
+     *
+     * Note that many properties are only initialized after the host sent an
+     * initialization message.
+     * @param self - Our global worker scope.
+     * @param Kernel - The rendering kernel class to construct.
+     */
+    constructor(self, Kernel) {
+        super();
+        this.self = self;
+        this.id = "<unassigned>";
+        this.#Kernel = Kernel;
+        self.onmessage = (message) => {
+            if (message.data.type === "start") {
+                const startMessage = message.data;
+                this.start(startMessage.options);
+            }
+            else if (message.data.type === "reconfigure") {
+                const reconfigureMessage = message.data;
+                this.reconfigure(reconfigureMessage.id, reconfigureMessage.canvas, reconfigureMessage.options);
+            }
+            else {
+                this.dispatchEvent(new CustomEvent(message.data.type));
+            }
+        };
+    }
+    /**
+     * Render a frame.
+     * @param delta - How many milliseconds have passed since the last invocation?
+     */
+    render = (delta) => {
+        this.renderKernel?.onDraw(delta, new Date().valueOf());
+    };
+    /**
+     * Reconfigure the worker.
+     * @param id - New ID for this worker.
+     * @param canvas - New canvas to render to.
+     * @param options - New application options.
+     */
+    reconfigure(id, canvas, options) {
+        this.renderLoop?.block();
+        this.id = id;
+        this.offscreenCanvas = canvas;
+        this.offscreenContext = mustExist(this.offscreenCanvas.getContext("2d"));
+        this.canvas = new Canvas2DHeadless(this.offscreenCanvas, this.offscreenContext);
+        this.renderLoop = new RenderLoop(this.render, this.canvas);
+        if (isNil(this.renderKernel)) {
+            this.renderKernel = new this.#Kernel(this, canvas, options);
+        }
+        else {
+            this.renderKernel.reconfigure(this.canvas, options);
+        }
+    }
+    /**
+     * Start rendering.
+     * @param options - New application options.
+     */
+    start(options) {
+        if (!this.renderKernel) {
+            return;
+        }
+        this.renderKernel.random = new Random(options.seed);
+        this.renderKernel.start(options);
+        this.renderLoop?.unblock();
+    }
+    /**
+     * Posts a message to the host.
+     * @param message - The message to post.
+     */
+    postMessage(message) {
+        this.self.postMessage(message);
+    }
+}
+/**
+ * Base class for multi-process canvas sandbox applications.
+ *
+ * Helps in orchestrating the workers.
+ */
+export class CanvasSandboxHostApplication {
+    /**
+     * Usually a hidden canvas that serves as a proxy for canvas sandbox events.
+     */
+    canvas;
+    /**
+     * Application options.
+     */
+    options;
+    /**
+     * PRNG instance for the application.
+     */
+    random;
+    /**
+     * Is the application running right now?
+     */
+    paused = false;
+    /**
+     * Web worker instances.
+     */
+    workers = new Array();
+    /**
+     * Construct a new host application.
+     * @param canvas - Usually a hidden canvas in the DOM to serve as an event proxy.
+     * @param options - Application options.
+     */
+    constructor(canvas, options) {
+        this.options = options;
+        this.canvas = canvas;
+        this.random = new Random(options.seed);
+        this.reconfigure(canvas, options);
+    }
+    /**
+     * Request the application to draw a new frame.
+     * This call has no effect in a host application, as all rendering happens in the workers.
+     * @param _delta - How many milliseconds passed since the last frame draw.
+     * @param _timestamp - The current timestamp.
+     */
+    onDraw(_delta, _timestamp) {
+        // Draws happen in workers.
+    }
+    /**
+     * Start the application.
+     */
+    start() {
+        this.paused = false;
+        for (const worker of this.workers) {
+            worker.postMessage({
+                type: "start",
+                options: {
+                    ...this.options,
+                    seed: this.random.seed,
+                    viewport: worker.options.viewport,
+                },
+            });
+        }
+    }
+    /**
+     * Posts a message to all workers.
+     * @param message - Message to post to all workers.
+     */
+    postMessageAll(message) {
+        for (const worker of this.workers) {
+            worker.postMessage(message);
+        }
+    }
+}
+//# sourceMappingURL=canvas-sandbox-mp.js.map

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

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

package/graphics/canvas-sandbox.d.ts

@@ -38,6 +38,28 @@ export interface CanvasSandboxExpectedOptions {
      * 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}.
@@ -74,7 +96,7 @@ export interface CanvasSandboxApplication<TCanvas extends Canvas, TApplicationOp
     /**
      * Start the application.
      */
-    start(): void;
+    start(options?: Partial<TApplicationOptions>): void;
 }
 /**
  * Options for a {@linkcode CanvasSandbox}.

package/graphics/canvas-sandbox.js

@@ -1,7 +1,6 @@
 /* eslint-disable no-console */
 import { Shake } from "../device/shake.js";
 import { getDocumentElementTypeById } from "../dom/core.js";
-import { nextPalette } from "./core.js";
 import { RenderLoop } from "./render-loop.js";
 /**
  * Provides the input as-is.
@@ -60,6 +59,7 @@ export const CANVAS_SANDBOX_DEFAULT_CSS = /* PURE */ css `
     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;
@@ -271,7 +271,6 @@ export class CanvasSandbox {
             switch (event.keyCode) {
                 case 13:
                     // Enter
-                    nextPalette();
                     this.#reconfigureApplication();
                     this.application.reconfigure(this.canvas);
                     this.application.start();
@@ -306,8 +305,6 @@ export class CanvasSandbox {
                 await document.exitFullscreen();
                 return;
             }
-            // Run the next variation of the application.
-            nextPalette();
             this.#reconfigureApplication();
             event.preventDefault();
         });

package/graphics/canvas-sandbox.js.map

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

package/graphics/canvas3d.js

@@ -30,6 +30,7 @@ export class Canvas3D extends Canvas {
     constructor(canvas, options = {}) {
         super(canvas);
         this.options = options;
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
         this.#context = mustExist(this.canvasElement.getContext("webgl2", {
             alpha: false,
         }), "Unable to create rendering context for offscreen canvas.");
@@ -38,6 +39,7 @@ export class Canvas3D extends Canvas {
      * Recreate internal buffers in reaction to a change in our target {@linkcode !HTMLCanvasElement}.
      */
     refreshCanvasNode() {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
         this.#context = mustExist(this.canvasElement.getContext("webgl2", {
             alpha: false,
             desynchronized: true,

package/graphics/canvas3d.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvas3d.js","sourceRoot":"","sources":["../../source/graphics/canvas3d.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAUrC;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,MAAM;IAClC;;OAEG;IACH,QAAQ,CAAyB;IACjC;;;OAGG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACM,OAAO,CAAqC;IAErD;;;;OAIG;IACH,YAAY,MAAyB,EAAE,UAAoC,EAAE;QAC3E,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,IAAI,CAAC,QAAQ,GAAG,SAAS,CACvB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE;YACtC,KAAK,EAAE,KAAK;SACb,CAAC,EACF,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,QAAQ,GAAG,SAAS,CACvB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE;YACtC,KAAK,EAAE,KAAK;YACZ,cAAc,EAAE,IAAI;SACrB,CAAC,EACF,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,+BAA+B;IACjC,CAAC;IACD;;OAEG;IACH,MAAM;QACJ,+BAA+B;IACjC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,MAAc;QACtB,MAAM,IAAI,mBAAmB,EAAE,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,WAA0B,EAAE,UAAkB,EAAE,UAAkB;QAC9E,MAAM,IAAI,mBAAmB,EAAE,CAAC;IAClC,CAAC;CACF"}
+{"version":3,"file":"canvas3d.js","sourceRoot":"","sources":["../../source/graphics/canvas3d.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAUrC;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,MAAM;IAClC;;OAEG;IACH,QAAQ,CAAyB;IACjC;;;OAGG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACM,OAAO,CAAqC;IAErD;;;;OAIG;IACH,YAAY,MAAyB,EAAE,UAAoC,EAAE;QAC3E,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,4EAA4E;QAC5E,IAAI,CAAC,QAAQ,GAAG,SAAS,CACvB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE;YACtC,KAAK,EAAE,KAAK;SACb,CAAC,EACF,0DAA0D,CACjC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,4EAA4E;QAC5E,IAAI,CAAC,QAAQ,GAAG,SAAS,CACvB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE;YACtC,KAAK,EAAE,KAAK;YACZ,cAAc,EAAE,IAAI;SACrB,CAAC,EACF,0DAA0D,CACjC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,+BAA+B;IACjC,CAAC;IACD;;OAEG;IACH,MAAM;QACJ,+BAA+B;IACjC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,MAAc;QACtB,MAAM,IAAI,mBAAmB,EAAE,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,WAA0B,EAAE,UAAkB,EAAE,UAAkB;QAC9E,MAAM,IAAI,mBAAmB,EAAE,CAAC;IAClC,CAAC;CACF"}

package/graphics/core.d.ts

@@ -4,11 +4,6 @@
  * @group Graphics
  */
 export declare const GOLDEN_RATIO = 1.618033988749;
-/**
- * Color palettes that can be used to quickly colorize a drawing.
- * @group Graphics
- */
-export declare const PALETTES: number[][];
 /**
  * Constrains a color component value to single-byte range (`0`-`255`).
  * @param c - A color component value.
@@ -97,19 +92,6 @@ export declare const blendAdditive: (src: number, dst: number, alpha: number) =>
  * @group Graphics
  */
 export declare const blendSubtractive: (src: number, dst: number, alpha: number) => number;
-/**
- * Retrieves a random color from the current global palette.
- * Uses the global {@linkcode random} object.
- * @returns A random color.
- * @group Graphics
- */
-export declare const someColor: () => number;
-/**
- * Switches the global palette to the next available preset.
- * @returns The new new global palette.
- * @group Graphics
- */
-export declare const nextPalette: () => number[];
 /**
  * Converts a color value to grayscale.
  * @param color - The color to convert.