like2d 2.10.2 → 2.11.1

package/README.md

@@ -110,13 +110,15 @@ LIKE's API is not the same as LOVE, but similar in spirit. Notable differences:
 - Theres an actions system -- `input.setAction` / `actionpressed` and `actionreleased` callbacks.
 - Some things are missing either due to browser limitations or smaller scope.
 
-## Feedback welcome
+## Links
 
-[LIKE is on GitHub.](https://github.com/44100hertz/Like2D)
+[NPM](https://www.npmjs.com/package/like2d)
 
-[Check out the docs for our long-term vision.](https://github.com/44100hertz/Like2D/tree/master/docs)
+[JSR](https://jsr.io/@like2d/like)
 
-[Feature requests welcome. PRs discouraged for now.](https://github.com/44100hertz/Like2D/issues/)
+[GitHub](https://github.com/44100hertz/Like2D)
+
+[Full Documentation](https://44100hertz.github.io/Like2D/api/documents/README.html) 
 
 ## License
 

package/dist/audio/index.d.ts

@@ -1,2 +1,2 @@
-export type { AudioSource, Audio, AudioSourceOptions } from "./audio";
+export type { Audio, AudioSource, AudioSourceOptions } from "./audio";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAA"}

package/dist/engine.d.ts

@@ -1,19 +1,14 @@
-/**
- * @module engine
- * @description Core game engine - lifecycle management and event dispatch.
- */
-import type { EventType, EventMap, Dispatcher } from './events';
+import type { EventType, EventMap, Dispatcher, LikeCanvasElement } from './events';
 import type { Like } from './like';
+/** @private */
 export type EngineDispatcher = Dispatcher<EventType>;
+/** @private */
 export type EngineProps<T extends keyof EventMap> = {
-    canvas: HTMLCanvasElement;
+    canvas: LikeCanvasElement;
     abort: AbortSignal;
     dispatch: Dispatcher<T>;
 };
-/**
- * @private
- * Core game engine managing the event loop and subsystems.
- */
+/** @private */
 export declare class Engine {
     private container;
     /** The canvas on which we bind all events. Not always the same canvas

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAa,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAInC,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;AACrD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,QAAQ,IAAI;IAClD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACzB,CAAA;AAED;;;GAGG;AACH,qBAAa,MAAM;IAaL,OAAO,CAAC,SAAS;IAZ7B;4BACwB;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAAyB;IAEtC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;gBAEA,SAAS,EAAE,WAAW;IAuD1C,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAa,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAInC,eAAe;AACf,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;AACrD,eAAe;AACf,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,QAAQ,IAAI;IAClD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACzB,CAAA;AAED,eAAe;AACf,qBAAa,MAAM;IAaL,OAAO,CAAC,SAAS;IAZ7B;4BACwB;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAAyB;IAEtC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;gBAEA,SAAS,EAAE,WAAW;IAqD1C,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/dist/engine.js

@@ -1,20 +1,13 @@
-/**
- * @module engine
- * @description Core game engine - lifecycle management and event dispatch.
- */
 import { Audio } from './audio/audio';
 import { Input } from './input/input';
 import { Timer } from './timer/timer';
 import { Keyboard } from './input/keyboard';
 import { Mouse } from './input/mouse';
 import { Gamepad } from './input/gamepad';
-import { bindGraphics } from './graphics/index';
+import { Graphics } from './graphics/graphics';
 import { Canvas } from './graphics/canvas';
 import { sceneDispatch } from './scene';
-/**
- * @private
- * Core game engine managing the event loop and subsystems.
- */
+/** @private */
 export class Engine {
     constructor(container) {
         Object.defineProperty(this, "container", {
@@ -61,23 +54,21 @@ export class Engine {
         this.canvas = document.createElement('canvas');
         const canvas = new Canvas(this.canvas, this.dispatch.bind(this), this.abort.signal);
         this.canvas.addEventListener("like:updateRenderTarget", (event) => {
-            if (!(event instanceof CustomEvent))
-                return;
-            this.like.gfx = bindGraphics(event.detail.target.getContext('2d'));
+            this.like.gfx.setContext(event.detail.target.getContext("2d"));
         });
         this.container.appendChild(this.canvas);
-        let gfx = bindGraphics(this.canvas.getContext('2d'));
         const props = {
             canvas: this.canvas,
             dispatch: this.dispatch.bind(this),
             abort: this.abort.signal,
         };
+        const gfx = new Graphics(this.canvas.getContext('2d'));
         const audio = new Audio();
         const timer = new Timer(props);
         const keyboard = new Keyboard(props);
         const mouse = new Mouse(props);
         const gamepad = new Gamepad(props);
-        const input = new Input(props.dispatch, { keyboard, mouse, gamepad });
+        const input = new Input(props, { keyboard, mouse, gamepad });
         this.like = {
             audio,
             timer,

package/dist/events.d.ts

@@ -4,28 +4,37 @@
  */
 import type { Vector2 } from './math/vector2';
 import type { LikeButton } from './input';
-export type MouseButton = 'left' | 'middle' | 'right';
-declare global {
-    interface HTMLElementEventMap {
-        ['like:mousemoved']: CustomEvent<{
-            pos: Vector2;
-            delta: Vector2;
-        }>;
-        ['like:updateRenderTarget']: CustomEvent<{
-            target: HTMLCanvasElement;
-        }>;
-        ['like:resizeCanvas']: CustomEvent<{
-            size: Vector2;
-        }>;
-        ['like:preDraw']: CustomEvent<{}>;
-        ['like:postDraw']: CustomEvent<{}>;
-        ['like:update']: CustomEvent<{
-            dt: number;
-        }>;
-    }
+import { MouseButton } from './input/mouse';
+/** @private */
+export type LikeCanvasEventMap = HTMLElementEventMap & {
+    'like:mousemoved': CustomEvent<{
+        pos: Vector2;
+        delta: Vector2;
+    }>;
+    'like:updateRenderTarget': CustomEvent<{
+        target: HTMLCanvasElement;
+    }>;
+    'like:resizeCanvas': CustomEvent<{
+        size: Vector2;
+    }>;
+    'like:preDraw': CustomEvent<{}>;
+    'like:postDraw': CustomEvent<{}>;
+    'like:update': CustomEvent<{
+        dt: number;
+    }>;
+};
+/** @private Custom canvas type that uses our event map as the single source of truth */
+export interface LikeCanvasElement extends HTMLCanvasElement {
+    addEventListener<K extends keyof LikeCanvasEventMap>(type: K, listener: (this: LikeCanvasElement, ev: LikeCanvasEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
 }
 /**
- * The master type will all events on it.
+ * It's a list of every possible event in like2d!
+ *
+ * Not just that, but these events translate directly into `like` callbacks.
+ *
+ * For example: `keypressed: [scancode: string, keycode: string]` translates to
+ * setting `like.keypressed = (scancode, keycode) => { ... }`!
+ *
  */
 export type EventMap = {
     /** Game initialization. Called once before the first frame. */
@@ -60,20 +69,28 @@ export type EventMap = {
     gamepadconnected: [index: number];
     /** Fires when a gamepad is disconnected. */
     gamepaddisconnected: [index: number];
-    /** Mapped action triggered. See {@link Input} for action mapping. */
+    /** Mapped action triggered. See {@link input.Input} for action mapping. */
     actionpressed: [action: string];
     /** Mapped action released. */
     actionreleased: [action: string];
 };
+/** @private */
 export type EventType = keyof EventMap;
+/** @private */
 export type LikeMouseEvent = 'mousemoved' | 'mousepressed' | 'mousereleased';
+/** @private */
 export type LikeKeyboardEvent = 'keypressed' | 'keyreleased';
+/** @private */
 export type LikeGamepadEvent = 'gamepadpressed' | 'gamepadreleased' | 'gamepadconnected' | 'gamepaddisconnected';
+/** @private */
+export type LikeActionEvent = 'actionpressed' | 'actionreleased';
 /**
+ * @private
  * Generic dispatcher - each module defines its own event subset
  */
 export type Dispatcher<T extends EventType> = <K extends T>(type: K, args: EventMap[K]) => void;
 /**
+ * @private
  * Discriminated union of all event objects.
  */
 export type LikeEvent = {

package/dist/events.d.ts.map

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

package/dist/graphics/canvas.d.ts

@@ -1,10 +1,18 @@
-import { type Dispatcher } from "../events";
+import { type Dispatcher, type LikeCanvasElement } from "../events";
 import { Rectangle } from "../math/rect";
 import { type Vector2 } from "../math/vector2";
+/**
+ * A set of options passed into {@link Canvas.setMode}
+ */
 export type CanvasModeOptions = {
     fullscreen: boolean;
 };
 export type CanvasSize = Vector2 | 'native';
+/**
+ * A manager for the HTML canvas element, similar to `love.window`.
+ *
+ * Controls game size / scaling -- both native and pixelart mode via {@link Canvas.setMode}, as well as fullscreen functions.
+ */
 export declare class Canvas {
     /** The ultimately visible canvas in the browser */
     private displayCanvas;
@@ -18,7 +26,7 @@ export declare class Canvas {
     private resizeTimeoutId;
     constructor(
     /** The ultimately visible canvas in the browser */
-    displayCanvas: HTMLCanvasElement, dispatch: Dispatcher<'resize'>, abort: AbortSignal);
+    displayCanvas: LikeCanvasElement, dispatch: Dispatcher<'resize'>, abort: AbortSignal);
     /** Get a unified canvas info object. */
     getMode(): {
         size: Vector2;
@@ -59,7 +67,7 @@ export declare class Canvas {
     /** Called every frame by the engine after drawing */
     private postDraw;
     /** @returns if size was changed.  */
-    static setCanvasElemSize(canvas: HTMLCanvasElement, newSize: Vector2): boolean;
-    static getCanvasElemSize(canvas: HTMLCanvasElement): Vector2;
+    static setCanvasElemSize(canvas: LikeCanvasElement, newSize: Vector2): boolean;
+    static getCanvasElemSize(canvas: LikeCanvasElement): Vector2;
 }
 //# sourceMappingURL=canvas.d.ts.map

package/dist/graphics/canvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/graphics/canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAQ,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5C,qBAAa,MAAM;IAUX,mDAAmD;IACnD,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;IAZjB;;;MAGE;IACF,OAAO,CAAC,YAAY,CAAoB;IAExC,OAAO,CAAC,eAAe,CAAU;;IAG7B,mDAAmD;IAC3C,aAAa,EAAE,iBAAiB,EAChC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,EAC9B,KAAK,EAAE,WAAW;IAoE9B,wCAAwC;IACxC,OAAO,IAAI;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,iBAAiB,CAAA;KAAE;IAStD;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,GAAE,OAAO,CAAC,iBAAiB,CAAM;IA6BhE,8CAA8C;IAC9C,OAAO,IAAI,OAAO;IAIlB,OAAO,CAAC,cAAc;IAWtB,wCAAwC;IACxC,OAAO,IAAI,SAAS;IAIpB,uDAAuD;IACvD,OAAO,CAAC,mBAAmB;IAO3B,yBAAyB;IACzB,aAAa,IAAI,OAAO;IAIxB,sBAAsB;IACtB,aAAa,CAAC,UAAU,EAAE,OAAO;IAWjC;;;OAGG;IACH,OAAO,CAAC,OAAO;IAmBf,qDAAqD;IACrD,OAAO,CAAC,QAAQ;IA2BhB,qCAAqC;IACrC,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAO9E,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO;CAG/D"}
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/graphics/canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAQ,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,MAAM;IAUX,mDAAmD;IACnD,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;IAZjB;;;MAGE;IACF,OAAO,CAAC,YAAY,CAAoB;IAExC,OAAO,CAAC,eAAe,CAAU;;IAG7B,mDAAmD;IAC3C,aAAa,EAAE,iBAAiB,EAChC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,EAC9B,KAAK,EAAE,WAAW;IAoE9B,wCAAwC;IACxC,OAAO,IAAI;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,iBAAiB,CAAA;KAAE;IAStD;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,GAAE,OAAO,CAAC,iBAAiB,CAAM;IA6BhE,8CAA8C;IAC9C,OAAO,IAAI,OAAO;IAIlB,OAAO,CAAC,cAAc;IAWtB,wCAAwC;IACxC,OAAO,IAAI,SAAS;IAIpB,uDAAuD;IACvD,OAAO,CAAC,mBAAmB;IAO3B,yBAAyB;IACzB,aAAa,IAAI,OAAO;IAIxB,sBAAsB;IACtB,aAAa,CAAC,UAAU,EAAE,OAAO;IAWjC;;;OAGG;IACH,OAAO,CAAC,OAAO;IAmBf,qDAAqD;IACrD,OAAO,CAAC,QAAQ;IA2BhB,qCAAqC;IACzC,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAU1E,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO;CAG/D"}

package/dist/graphics/canvas.js

@@ -1,5 +1,10 @@
 import { Rect } from "../math/rect";
 import { Vec2 } from "../math/vector2";
+/**
+ * A manager for the HTML canvas element, similar to `love.window`.
+ *
+ * Controls game size / scaling -- both native and pixelart mode via {@link Canvas.setMode}, as well as fullscreen functions.
+ */
 export class Canvas {
     constructor(
     /** The ultimately visible canvas in the browser */
@@ -208,11 +213,14 @@ export class Canvas {
     }
     /** @returns if size was changed.  */
     static setCanvasElemSize(canvas, newSize) {
-        if (canvas.width != newSize[0] || canvas.height != newSize[1]) {
-            [canvas.width, canvas.height] = newSize;
-            return true;
-        }
-        return false;
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            return false;
+        if (canvas.width === newSize[0] && canvas.height === newSize[1])
+            return false;
+        canvas.width = newSize[0];
+        canvas.height = newSize[1];
+        return true;
     }
     static getCanvasElemSize(canvas) {
         return [canvas.width, canvas.height];

package/dist/graphics/{drawing.d.ts → graphics.d.ts}

@@ -28,6 +28,7 @@
  */
 import { type Vector2 } from "../math/vector2";
 import type { Rectangle } from "../math/rect";
+import { ImageHandle } from "./image";
 export type DrawMode = "fill" | "line";
 /**
  * - RGBA array with values 0-1: `[r, g, b, a]`
@@ -52,66 +53,86 @@ export type PrintProps = {
     width?: number;
     align?: CanvasTextAlign;
 };
-export declare class ImageHandle {
-    readonly path: string;
-    private element;
-    private loadPromise;
-    private isLoaded;
-    constructor(path: string);
-    isReady(): boolean;
-    ready(): Promise<void>;
-    get size(): Vector2;
-    getElement(): HTMLImageElement | null;
-}
 /**
- * All of these methods exist on `like.gfx`, but with `ctx`
- * bound to the first arg.
+ * LIKE's way of drawing to the screen.
+ *
+ * More specifically: a system for wrapping canvas draw calls conveniently.
  *
- * Acts as the core of the graphics system, but can be used separately.
+ *  - Reduces state in calls -- no `setColor`, etc. Everything is passed in.
+ *  - Abstracts away common drawing operations.
  *
+ * ### Examples
+ * Draw a spinning symbol in the center of the screen using transforms.
  * ```ts
- * import { draw } from "like/graphics"
- * draw.clear(my2dContext, "red");
- * ```
+ * function drawSpinningYinYang(like: Like) {
+ *   const color1 = "black";
+ *   const color2 = "white";
+ *   const size = 50;
+ *   const pos = Vec2.div(like.canvas.getSize(), 2); // calc center of screen
+ *   const speed = 0.5; // rotations per second
  *
+ *   like.gfx.push();
+ *   like.gfx.translate(pos);
+ *   like.gfx.rotate(like.timer.getTime() * Math.PI * 2.0 * speed);
+ *   like.gfx.scale(size);
+ *   like.gfx.circle("fill", color1, [0, 0], 2);
+ *   // use the arc parameter to fill in a semicircle. Note that it's clockwise from {x:1, y:0}.
+ *   like.gfx.circle("fill", color2, [0, 0], 2, { arc: [Math.PI/2, Math.PI*3/2] });
+ *   like.gfx.circle("fill", color2, [0, -1], 1);
+ *   like.gfx.circle("fill", color1, [0, 1], 1);
+ *   like.gfx.circle("fill", color2, [0, 1], 1/3);
+ *   like.gfx.circle("fill", color1, [0, -1], 1/3);
+ *   like.gfx.pop();
+ * }
+ *
+ * like.draw = (like: Like) => {
+ *   drawSpinningYinYang(like);
+ * }
+ * ```
  */
-export declare const draw: {
+export declare class Graphics {
+    private ctx;
+    constructor(ctx: CanvasRenderingContext2D);
+    /**
+     * Set the 2d drawing context for graphics.
+     *
+     * Be aware that that `like` can set this value at any time.
+     */
+    setContext(ctx: CanvasRenderingContext2D): void;
     /**
      * Clears the canvas with a solid color.
-     * @param ctx Canvas context.
      * @param color Fill color.
      */
-    clear(ctx: CanvasRenderingContext2D, color?: Color): void;
+    clear(color?: Color): void;
     /**
      * Draws a rectangle.
-     * @param ctx Canvas context.
      * @param mode Fill or line.
      * @param color Fill or stroke color.
      * @param rect Rectangle [x, y, w, h].
      * @param props Optional stroke properties.
      */
-    rectangle(ctx: CanvasRenderingContext2D, mode: DrawMode, color: Color, rect: Rectangle, props?: ShapeProps): void;
+    rectangle(mode: DrawMode, color: Color, rect: Rectangle, props?: ShapeProps): void;
     /**
      * Draws a circle or ellipse.
-     * @param ctx Canvas context.
+     
      * @param mode Fill or line.
      * @param color Fill or stroke color.
      * @param position Center position.
      * @param radii Radius (number) or [rx, ry] for ellipse.
      * @param props Optional arc, center, and stroke properties. Center is true by default.
      */
-    circle(ctx: CanvasRenderingContext2D, mode: DrawMode, color: Color, position: Vector2, radii: number | Vector2, props?: ShapeProps & {
+    circle(mode: DrawMode, color: Color, position: Vector2, radii: number | Vector2, props?: ShapeProps & {
         arc?: [number, number];
         center?: boolean;
     }): void;
     /**
      * Draws connected line segments.
-     * @param ctx Canvas context.
+     
      * @param color Stroke color.
      * @param points Array of [x, y] positions.
      * @param props Optional stroke properties.
      */
-    line(ctx: CanvasRenderingContext2D, color: Color, points: Vector2[], props?: ShapeProps): void;
+    line(color: Color, points: Vector2[], props?: ShapeProps): void;
     /**
      * Draws text at a position.
      *
@@ -122,82 +143,82 @@ export declare const draw: {
      * to the left and right of its position. If you align right, your position
      * becomes the upper-right corner of the text.
      *
-     * @param ctx Canvas context.
+     
      * @param color Fill color.
      * @param text Text string.
      * @param position Top-left position.
      * @param props {@link PrintProps} Optional font, text limit, or alignment.
      */
-    print(ctx: CanvasRenderingContext2D, color: Color, text: string, position: Vector2, props?: PrintProps): void;
+    print(color: Color, text: string, position: Vector2, props?: PrintProps): void;
     /**
      * Draws an image.
      *
      * @remarks named "draw" because it draws anything _drawable_
      * in the long run.
      *
-     * @param ctx Canvas context.
+     
      * @param handle Image handle from newImage.
      * @param position Draw position.
      * @param props Optional rotation, scale, origin, or quad.
      */
-    draw(ctx: CanvasRenderingContext2D, handle: ImageHandle, position: Vector2, props?: DrawProps): void;
+    draw(handle: ImageHandle, position: Vector2, props?: DrawProps): void;
     /**
      * Loads an image from a path.
      * Unlike built-in loading, this pretends to be synchronous.
-     * @param ctx Canvas context.
+     
      * @param path Image file path.
      * @returns ImageHandle for use with draw.
      */
-    newImage(_ctx: CanvasRenderingContext2D, path: string): ImageHandle;
+    newImage(path: string): ImageHandle;
     /**
      * Sets the clipping region.
-     * @param ctx Canvas context.
+     
      * @param rect Clipping rectangle, or full canvas if omitted.
      */
-    clip(ctx: CanvasRenderingContext2D, rect?: Rectangle): void;
+    clip(rect?: Rectangle): void;
     /**
      * Draws a polygon.
-     * @param ctx Canvas context.
+     
      * @param mode Fill or line.
      * @param color Fill or stroke color.
      * @param points Array of [x, y] vertices.
      * @param props Optional stroke properties.
      */
-    polygon(ctx: CanvasRenderingContext2D, mode: DrawMode, color: Color, points: Vector2[], props?: ShapeProps): void;
+    polygon(mode: DrawMode, color: Color, points: Vector2[], props?: ShapeProps): void;
     /**
      * Draws individual pixels.
-     * @param ctx Canvas context.
+     
      * @param color Fill color.
      * @param pts Array of [x, y] positions.
      */
-    points(ctx: CanvasRenderingContext2D, color: Color, pts: Vector2[]): void;
+    points(color: Color, pts: Vector2[]): void;
     /**
      * Saves canvas state.
-     * @param ctx Canvas context.
+     
      */
-    push(ctx: CanvasRenderingContext2D): void;
+    push(): void;
     /**
      * Restores canvas state.
-     * @param ctx Canvas context.
+     
      */
-    pop(ctx: CanvasRenderingContext2D): void;
+    pop(): void;
     /**
      * Applies a translation.
-     * @param ctx Canvas context.
+     
      * @param offset [x, y] offset.
      */
-    translate(ctx: CanvasRenderingContext2D, offset: Vector2): void;
+    translate(offset: Vector2): void;
     /**
      * Applies a rotation.
-     * @param ctx Canvas context.
+     
      * @param angle Rotation in radians.
      */
-    rotate(ctx: CanvasRenderingContext2D, angle: number): void;
+    rotate(angle: number): void;
     /**
      * Applies a scale.
-     * @param ctx Canvas context.
+     
      * @param factor Scale factor (number or [x, y]).
      */
-    scale(ctx: CanvasRenderingContext2D, factor: number | Vector2): void;
-};
-//# sourceMappingURL=drawing.d.ts.map
+    scale(factor: number | Vector2): void;
+}
+//# sourceMappingURL=graphics.d.ts.map

package/dist/graphics/graphics.d.ts.map

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