like2d 2.11.0 → 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, LikeCanvasElement } from './events';
 import type { Like } from './like';
+/** @private */
 export type EngineDispatcher = Dispatcher<EventType>;
+/** @private */
 export type EngineProps<T extends keyof EventMap> = {
     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,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC9F,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;IAqD1C,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 { Graphics } 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", {
@@ -75,7 +68,7 @@ export class Engine {
         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,7 +4,8 @@
  */
 import type { Vector2 } from './math/vector2';
 import type { LikeButton } from './input';
-export type MouseButton = 'left' | 'middle' | 'right';
+import { MouseButton } from './input/mouse';
+/** @private */
 export type LikeCanvasEventMap = HTMLElementEventMap & {
     'like:mousemoved': CustomEvent<{
         pos: Vector2;
@@ -22,12 +23,18 @@ export type LikeCanvasEventMap = HTMLElementEventMap & {
         dt: number;
     }>;
 };
-export type LikeCanvasEvent = LikeCanvasEventMap;
+/** @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. */
@@ -62,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":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IACrD,iBAAiB,EAAE,WAAW,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,CAAC,CAAC;IAC/D,yBAAyB,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAC,CAAC,CAAC;IACpE,mBAAmB,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAC,CAAC,CAAC;IAClD,cAAc,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IAChC,eAAe,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IACjC,aAAa,EAAE,WAAW,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,kBAAkB,CAAA;AAGhD,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAE1D,gBAAgB,CAAC,CAAC,SAAS,MAAM,kBAAkB,EACjD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,GAAG,EACrE,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,CAAC;CACT;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,+DAA+D;IAC/D,IAAI,EAAE,EAAE,CAAC;IAET,yEAAyE;IACzE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAErB,8DAA8D;IAC9D,IAAI,EAAE,EAAE,CAAC;IAET,sFAAsF;IACtF,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAExB,oFAAoF;IACpF,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEhD,6BAA6B;IAC7B,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEjD,iEAAiE;IACjE,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;IAElC,8DAA8D;IAC9D,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;IAEjC,iEAAiE;IACjE,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAE3C,qFAAqF;IACrF,YAAY,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAElD,6BAA6B;IAC7B,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAEnD,8GAA8G;IAC9G,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAEhE,+GAA+G;IAC/G,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAEjE;;OAEG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAElC,4CAA4C;IAC5C,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAErC,qEAAqE;IACrE,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC,8BAA8B;IAC9B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,cAAc,GAAG,eAAe,CAAC;AAC7E,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,aAAa,CAAC;AAC7D,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;AAEjH;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,EACxD,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KACd,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;KACrB,CAAC,IAAI,SAAS,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CACpE,CAAC,SAAS,CAAC,CAAC"}
+{"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, 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;

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,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,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;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"}
+{"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 */

package/dist/graphics/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,28 +53,42 @@ 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 class Graphics {
     private ctx;
@@ -86,13 +101,11 @@ export declare class Graphics {
     setContext(ctx: CanvasRenderingContext2D): void;
     /**
      * Clears the canvas with a solid color.
-     * @param this.ctx Canvas context.
      * @param color Fill color.
      */
     clear(color?: Color): void;
     /**
      * Draws a rectangle.
-     * @param this.ctx Canvas context.
      * @param mode Fill or line.
      * @param color Fill or stroke color.
      * @param rect Rectangle [x, y, w, h].
@@ -101,7 +114,7 @@ export declare class Graphics {
     rectangle(mode: DrawMode, color: Color, rect: Rectangle, props?: ShapeProps): void;
     /**
      * Draws a circle or ellipse.
-     * @param this.ctx Canvas context.
+     
      * @param mode Fill or line.
      * @param color Fill or stroke color.
      * @param position Center position.
@@ -114,7 +127,7 @@ export declare class Graphics {
     }): void;
     /**
      * Draws connected line segments.
-     * @param this.ctx Canvas context.
+     
      * @param color Stroke color.
      * @param points Array of [x, y] positions.
      * @param props Optional stroke properties.
@@ -130,7 +143,7 @@ export declare class Graphics {
      * to the left and right of its position. If you align right, your position
      * becomes the upper-right corner of the text.
      *
-     * @param this.ctx Canvas context.
+     
      * @param color Fill color.
      * @param text Text string.
      * @param position Top-left position.
@@ -143,7 +156,7 @@ export declare class Graphics {
      * @remarks named "draw" because it draws anything _drawable_
      * in the long run.
      *
-     * @param this.ctx Canvas context.
+     
      * @param handle Image handle from newImage.
      * @param position Draw position.
      * @param props Optional rotation, scale, origin, or quad.
@@ -152,20 +165,20 @@ export declare class Graphics {
     /**
      * Loads an image from a path.
      * Unlike built-in loading, this pretends to be synchronous.
-     * @param this.ctx Canvas context.
+     
      * @param path Image file path.
      * @returns ImageHandle for use with draw.
      */
     newImage(path: string): ImageHandle;
     /**
      * Sets the clipping region.
-     * @param this.ctx Canvas context.
+     
      * @param rect Clipping rectangle, or full canvas if omitted.
      */
     clip(rect?: Rectangle): void;
     /**
      * Draws a polygon.
-     * @param this.ctx Canvas context.
+     
      * @param mode Fill or line.
      * @param color Fill or stroke color.
      * @param points Array of [x, y] vertices.
@@ -174,36 +187,36 @@ export declare class Graphics {
     polygon(mode: DrawMode, color: Color, points: Vector2[], props?: ShapeProps): void;
     /**
      * Draws individual pixels.
-     * @param this.ctx Canvas context.
+     
      * @param color Fill color.
      * @param pts Array of [x, y] positions.
      */
     points(color: Color, pts: Vector2[]): void;
     /**
      * Saves canvas state.
-     * @param this.ctx Canvas context.
+     
      */
     push(): void;
     /**
      * Restores canvas state.
-     * @param this.ctx Canvas context.
+     
      */
     pop(): void;
     /**
      * Applies a translation.
-     * @param this.ctx Canvas context.
+     
      * @param offset [x, y] offset.
      */
     translate(offset: Vector2): void;
     /**
      * Applies a rotation.
-     * @param this.ctx Canvas context.
+     
      * @param angle Rotation in radians.
      */
     rotate(angle: number): void;
     /**
      * Applies a scale.
-     * @param this.ctx Canvas context.
+     
      * @param factor Scale factor (number or [x, y]).
      */
     scale(factor: number | Vector2): void;

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

@@ -1 +1 @@
-{"version":3,"file":"graphics.d.ts","sourceRoot":"","sources":["../../src/graphics/graphics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC;AAE/D,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG;IACnC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,EAAE,MAAM;IAiBxB,OAAO,IAAI,OAAO;IAIlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,UAAU,IAAI,gBAAgB,GAAG,IAAI;CAGtC;AAgDD;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,wBAAwB;IAEjD;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,wBAAwB;IAIxC;;;;OAIG;IACH,KAAK,CAAC,KAAK,GAAE,KAAoB,GAAG,IAAI;IAKxC;;;;;;;OAOG;IACH,SAAS,CACP,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,SAAS,EACf,KAAK,CAAC,EAAE,UAAU,GACjB,IAAI;IAYP;;;;;;;;OAQG;IACH,MAAM,CACJ,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,GAAG,OAAO,EACvB,KAAK,CAAC,EAAE,UAAU,GAAG;QACnB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GACA,IAAI;IA4BP;;;;;;OAMG;IACH,IAAI,CACF,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,OAAO,EAAE,EACjB,KAAK,CAAC,EAAE,UAAU,GACjB,IAAI;IAWP;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CACH,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,UAAU,GACjB,IAAI;IAoBP;;;;;;;;;;OAUG;IACH,IAAI,CACF,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,SAAS,GAChB,IAAI;IAuBP;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAInC;;;;OAIG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI;IAW5B;;;;;;;OAOG;IACH,OAAO,CACL,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,OAAO,EAAE,EACjB,KAAK,CAAC,EAAE,UAAU,GACjB,IAAI;IAkBP;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI;IAK1C;;;OAGG;IACH,IAAI,IAAI,IAAI;IAIZ;;;OAGG;IACH,GAAG,IAAI,IAAI;IAIX;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAKhC;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3B;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;CAItC"}
+{"version":3,"file":"graphics.d.ts","sourceRoot":"","sources":["../../src/graphics/graphics.ts"],"names":[],"mappings":"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"}

package/dist/graphics/graphics.js

@@ -27,59 +27,7 @@
  * - Angles in radians, 0 is right, positive is clockwise
  */
 import { Vec2 } from "../math/vector2";
-export class ImageHandle {
-    constructor(path) {
-        Object.defineProperty(this, "path", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "element", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
-        Object.defineProperty(this, "loadPromise", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "isLoaded", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-        this.path = path;
-        this.loadPromise = new Promise((resolve, reject) => {
-            const img = new Image();
-            img.onload = () => {
-                this.element = img;
-                this.isLoaded = true;
-                resolve();
-            };
-            img.onerror = () => {
-                reject(new Error(`Failed to load image: ${path}`));
-            };
-            img.src = path;
-        });
-    }
-    isReady() {
-        return this.isLoaded;
-    }
-    ready() {
-        return this.loadPromise;
-    }
-    get size() {
-        return [this.element?.width ?? 0, this.element?.height ?? 0];
-    }
-    getElement() {
-        return this.element;
-    }
-}
+import { ImageHandle } from "./image";
 function parseColor(color) {
     if (typeof color === "string")
         return color;
@@ -117,16 +65,41 @@ function getFontHeight(ctx) {
     return match ? parseInt(match[1]) : 16;
 }
 /**
- * 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 class Graphics {
     constructor(ctx) {
@@ -147,7 +120,6 @@ export class Graphics {
     }
     /**
      * Clears the canvas with a solid color.
-     * @param this.ctx Canvas context.
      * @param color Fill color.
      */
     clear(color = [0, 0, 0, 1]) {
@@ -156,7 +128,6 @@ export class Graphics {
     }
     /**
      * Draws a rectangle.
-     * @param this.ctx Canvas context.
      * @param mode Fill or line.
      * @param color Fill or stroke color.
      * @param rect Rectangle [x, y, w, h].
@@ -176,7 +147,7 @@ export class Graphics {
     }
     /**
      * Draws a circle or ellipse.
-     * @param this.ctx Canvas context.
+     
      * @param mode Fill or line.
      * @param color Fill or stroke color.
      * @param position Center position.
@@ -212,7 +183,7 @@ export class Graphics {
     }
     /**
      * Draws connected line segments.
-     * @param this.ctx Canvas context.
+     
      * @param color Stroke color.
      * @param points Array of [x, y] positions.
      * @param props Optional stroke properties.
@@ -238,7 +209,7 @@ export class Graphics {
      * to the left and right of its position. If you align right, your position
      * becomes the upper-right corner of the text.
      *
-     * @param this.ctx Canvas context.
+     
      * @param color Fill color.
      * @param text Text string.
      * @param position Top-left position.
@@ -270,7 +241,7 @@ export class Graphics {
      * @remarks named "draw" because it draws anything _drawable_
      * in the long run.
      *
-     * @param this.ctx Canvas context.
+     
      * @param handle Image handle from newImage.
      * @param position Draw position.
      * @param props Optional rotation, scale, origin, or quad.
@@ -301,7 +272,7 @@ export class Graphics {
     /**
      * Loads an image from a path.
      * Unlike built-in loading, this pretends to be synchronous.
-     * @param this.ctx Canvas context.
+     
      * @param path Image file path.
      * @returns ImageHandle for use with draw.
      */
@@ -310,7 +281,7 @@ export class Graphics {
     }
     /**
      * Sets the clipping region.
-     * @param this.ctx Canvas context.
+     
      * @param rect Clipping rectangle, or full canvas if omitted.
      */
     clip(rect) {
@@ -326,7 +297,7 @@ export class Graphics {
     }
     /**
      * Draws a polygon.
-     * @param this.ctx Canvas context.
+     
      * @param mode Fill or line.
      * @param color Fill or stroke color.
      * @param points Array of [x, y] vertices.
@@ -353,7 +324,7 @@ export class Graphics {
     }
     /**
      * Draws individual pixels.
-     * @param this.ctx Canvas context.
+     
      * @param color Fill color.
      * @param pts Array of [x, y] positions.
      */
@@ -363,21 +334,21 @@ export class Graphics {
     }
     /**
      * Saves canvas state.
-     * @param this.ctx Canvas context.
+     
      */
     push() {
         this.ctx.save();
     }
     /**
      * Restores canvas state.
-     * @param this.ctx Canvas context.
+     
      */
     pop() {
         this.ctx.restore();
     }
     /**
      * Applies a translation.
-     * @param this.ctx Canvas context.
+     
      * @param offset [x, y] offset.
      */
     translate(offset) {
@@ -386,7 +357,7 @@ export class Graphics {
     }
     /**
      * Applies a rotation.
-     * @param this.ctx Canvas context.
+     
      * @param angle Rotation in radians.
      */
     rotate(angle) {
@@ -394,7 +365,7 @@ export class Graphics {
     }
     /**
      * Applies a scale.
-     * @param this.ctx Canvas context.
+     
      * @param factor Scale factor (number or [x, y]).
      */
     scale(factor) {

package/dist/graphics/image.d.ts

@@ -0,0 +1,22 @@
+import { Vector2 } from "../math";
+/**
+ * An image that can be drawn using {@link Graphics.draw}
+ *
+ * Unlike raw HTMLImageElement, there is no need to wait for it to load.
+ * If the image isn't loaded, it simply won't draw it at all.
+ *
+ * If you're planning on loading many large images, simply preload
+ * these image handles beforehand so that they're ready.
+ */
+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;
+}
+//# sourceMappingURL=image.d.ts.map