like2d 2.11.1 → 2.12.1

package/dist/input/gamepad-mapping.js

@@ -58,6 +58,7 @@ export const defaultMapping = (stickCount) => ({
     ]),
 });
 export const standardButtonMapping = () => Object.fromEntries(buttonMap.map(({ like, num }) => [num, like]));
+const numToName = standardButtonMapping();
 /** @private */
 export const allButtons = new Set(buttonMap.map(({ like }) => like));
 export const fullButtonName = new Map(buttonMap.map(({ like, name }) => [like, name]));
@@ -70,7 +71,7 @@ const mappingDb = new Map(Object.entries(mappingDbRaw[detectedOs]).map(([k, v])
     Number(k),
     {
         ...v,
-        mapping: Object.fromEntries(Object.entries(v.mapping).map(([k, v]) => [Number(k), v])),
+        mapping: Object.fromEntries(Object.entries(v.mapping).map(([k, v]) => [Number(k), numToName[Number(v)]])),
     },
 ]));
 export function getSdlMapping(gamepad) {

package/dist/input/gamepad.d.ts

@@ -12,7 +12,7 @@ export type GamepadTarget = number | "any";
  *
  * If you're planning on supporting gamepads, please include a
  * way to generate {@link GamepadMapping} and set it with {@link Gamepad.setMapping}.
- * Perhaps trigger it on {@link index.EventMap.gamepadconnected} events.
+ * Perhaps trigger it on {@link index.EventMap.gamepadconnected | gamepadconnected} events.
  *
  * If you don't want to make your own, take a look at {@link prefab-scenes.MapGamepad}
  *

package/dist/input/gamepad.js

@@ -7,7 +7,7 @@ import { defaultMapping, fullButtonName, getSdlMapping, mapStick, standardButton
  *
  * If you're planning on supporting gamepads, please include a
  * way to generate {@link GamepadMapping} and set it with {@link Gamepad.setMapping}.
- * Perhaps trigger it on {@link index.EventMap.gamepadconnected} events.
+ * Perhaps trigger it on {@link index.EventMap.gamepadconnected | gamepadconnected} events.
  *
  * If you don't want to make your own, take a look at {@link prefab-scenes.MapGamepad}
  *

package/dist/input/input.d.ts

@@ -81,7 +81,7 @@ export declare class Input {
     /**
      * This is the easiest way to set-and-forget input => action mapping.
      *
-     * Or, it's a helper to remove actions -- `setAction(action)`
+     * Or, it's a helper to remove actions -- `setAction(action, [])`
      * will simply clear the action away.
      *
      * For input strings:
@@ -109,7 +109,7 @@ export declare class Input {
      * @param action
      * @param inputs
      */
-    setAction(action: string, inputs?: (string | InputBinding)[]): void;
+    setAction(action: string, inputs: (string | InputBinding)[]): void;
     /**
      * Map a single input onto an action.
      */

package/dist/input/input.js

@@ -103,7 +103,7 @@ export class Input {
     /**
      * This is the easiest way to set-and-forget input => action mapping.
      *
-     * Or, it's a helper to remove actions -- `setAction(action)`
+     * Or, it's a helper to remove actions -- `setAction(action, [])`
      * will simply clear the action away.
      *
      * For input strings:
@@ -131,7 +131,7 @@ export class Input {
      * @param action
      * @param inputs
      */
-    setAction(action, inputs = []) {
+    setAction(action, inputs) {
         if (inputs.length) {
             this.actionTable[action] = inputs.map(parseInput);
         }

package/dist/input/mouse.d.ts

@@ -98,13 +98,13 @@ export declare class Mouse {
      * Avoid binding the `ESC` key in captured mode. This will exit the capture and
      * reset mode to default.
      *
-     * ### Note on `pos` vs `delta`
-     * Event {@link index.EventMap.mousemoved} passes both `pos` and `delta` args.
-     *
-     * Though the emulated cursor in locked mode
-     * (locked mode doesn't natively track absolute position)
-     * may be stuck on canvas edges, the `delta` field always
-     * represents mouse movement, even against edges.
+   * ### Note on `pos` vs `delta`
+   * Event {@link index.EventMap.mousemoved} passes both `pos` and `delta` args.
+   *
+   * Though the emulated cursor in locked mode
+   * (locked mode doesn't natively track absolute position)
+   * may be stuck on canvas edges, the `delta` field always
+   * represents mouse movement, even against edges.
      */
     setMode(mode: MouseSetMode): void;
     getMode(): MouseMode;

package/dist/input/mouse.js

@@ -200,13 +200,13 @@ export class Mouse {
      * Avoid binding the `ESC` key in captured mode. This will exit the capture and
      * reset mode to default.
      *
-     * ### Note on `pos` vs `delta`
-     * Event {@link index.EventMap.mousemoved} passes both `pos` and `delta` args.
-     *
-     * Though the emulated cursor in locked mode
-     * (locked mode doesn't natively track absolute position)
-     * may be stuck on canvas edges, the `delta` field always
-     * represents mouse movement, even against edges.
+   * ### Note on `pos` vs `delta`
+   * Event {@link index.EventMap.mousemoved} passes both `pos` and `delta` args.
+   *
+   * Though the emulated cursor in locked mode
+   * (locked mode doesn't natively track absolute position)
+   * may be stuck on canvas edges, the `delta` field always
+   * represents mouse movement, even against edges.
      */
     setMode(mode) {
         this.lockPointer(mode.lock);

package/dist/like.d.ts

@@ -17,12 +17,11 @@ export type Callbacks = {
     [K in EventType]?: Callback<K>;
 };
 /**
- * The main Like instance.
- * Use this object much how you would the `love` object in Love2D.
- * This is the interface returned by {@link createLike}.
+ * The main modules and builtins of `like`, aside from {@link EventMap | optional callbacks}.
+ * @interface
  */
-export type Like = Callbacks & {
-    /** Handle a pool of pseudo-synchronous audio sources with global volume control and more. */
+export type LikeBase = {
+    /** Handle a pool of audio sources with global volume control and more. */
     readonly audio: Audio;
     /** Misc. time functions, including sleeping the game. ZZZ */
     readonly timer: Timer;
@@ -53,21 +52,52 @@ export type Like = Callbacks & {
      */
     dispose(): void;
     /**
-     * A simple way to set the current scene, which acts like a pluggable
-     * set of callbacks.
+     * Push a scene to the scene stack.
+     *
+     * If the engine is running, this is the new running scene replacing the old one
+     * which can, in some cases, call out to the lower scene.
+     *
+     * @param overlay Set to true, and the current scene (before pushing) will stay loaded. Otherwise not.
+     */
+    pushScene(scene: Scene, overlay: boolean): void;
+    /**
+     * Pop the current scene off the stack.
+     *
+     * To clear the stack, just run:
+     * ```ts
+     * while (like.popScene());
+     * ```
+     */
+    popScene(): Scene | undefined;
+    /**
+     * Set the current scene at the top of the scene stack.
+     * If the stack is empty, push it onto the stack.
+     *
+     * Equivalent to `popScene` + `pushScene`.
+     *
+      * Use {@link index.Like | popScene} to clear away the current scene,
+     * and to possibly revert to callback mode.
+     */
+    setScene(scene: Scene): void;
+    /**
+     * Get the current scene, or a specific index.
+     *
+     * Uses `Array.at` under the hood, so -1 is the
+     * top scene, -2 is the parent scene, etc.
      */
-    setScene(scene?: Scene): void;
+    getScene(index?: number): Scene | undefined;
     /**
      * LIKE's runtime is built around calling handleEvent.
      *
      * This function recieves all events. If set to undefined,
-     * `like.callOwnHandlers(ev)` is the default behavior.
+      * {@link index.Like | Like.callOwnHandlers} is the default behavior.
      *
      * Otherwise, you can really customize LIKE by setting this
      * to a custom handler.
      *
      * For example, the scene architecture is built around
-     * setting this function.
+     * setting this function. Setting it to a custom
+     * function will disable the scene system.
      */
     handleEvent?: TopLevelEventHandler;
     /**
@@ -77,4 +107,12 @@ export type Like = Callbacks & {
      */
     callOwnHandlers(event: LikeEvent): void;
 };
+/**
+ * The main Like instance.
+ * Use this object much how you would the `love` object in Love2D.
+ * This is the interface returned by {@link createLike}.
+ *
+ * Check out all the {@link EventMap | callbacks}.
+ */
+export type Like = Callbacks & LikeBase;
 //# sourceMappingURL=like.d.ts.map

package/dist/math/rect.d.ts

@@ -41,6 +41,7 @@ import { type Vector2 } from '../math/vector2';
  *
  * */
 export type Rectangle = [number, number, number, number];
+/** The full library of {@link Rectangle} functions. */
 export declare const Rect: {
     fromPoints(a: Vector2, b: Vector2): Rectangle;
     fromCenter(center: Vector2, size: Vector2): Rectangle;

package/dist/math/rect.js

@@ -1,4 +1,5 @@
 import { Vec2 } from '../math/vector2';
+/** The full library of {@link Rectangle} functions. */
 export const Rect = {
     fromPoints(a, b) {
         const minX = Math.min(a[0], b[0]);

package/dist/math/vector2.d.ts

@@ -59,7 +59,7 @@ export type Pair<T> = [T, T];
  * #### Squaring each element of a Vector2
  * ```ts
  * const squareVec2 = Vec2.map(a: number => a**2);
- * squareVec2([6, 7]) // returns [36, 42]
+ * squareVec2([6, 7]) // returns [36, 49]
  * // one in one line...
  * Vec2.map(a: number => a**2)([6, 7]);
  * ```
@@ -76,6 +76,9 @@ export type Vector2 = Pair<number>;
 declare function map2x1<I, O>(op: (a: I) => O): (a: Pair<I>) => Pair<O>;
 /** @see {@link Vec2.map2} */
 declare function map2x2<I, O>(op: (a: I, b: I) => O): (a: Pair<I>, b: I | Pair<I>) => Pair<O>;
+/**
+ * The full library of {@link Vector2} functions.
+*/
 export declare const Vec2: {
     /**
      * Turn a unary function into a pair-wise unary function.

package/dist/math/vector2.js

@@ -15,6 +15,9 @@ function map2x2(op) {
         ? [op(a[0], b[0]), op(a[1], b[1])]
         : [op(a[0], b), op(a[1], b)];
 }
+/**
+ * The full library of {@link Vector2} functions.
+*/
 export const Vec2 = {
     /**
      * Turn a unary function into a pair-wise unary function.

package/dist/prefab-scenes/mapGamepad.d.ts

@@ -15,7 +15,7 @@ export type MapMode = {
  *
  * ```ts
  * like.gamepadconnected = (index) =>
- *   like.setScene(new MapGamepad({buttons: buttonSetGBA, sticks: 0}), index)
+ *   like.pushScene(new MapGamepad({buttons: buttonSetGBA, sticks: 0}), index)
  * ```
  *
  * Add this to your codebase and activating a gamepad causes a button mapping screen to pop up.
@@ -26,13 +26,12 @@ export type MapMode = {
 export declare class MapGamepad implements Scene {
     private mapMode;
     private targetPad;
-    private next?;
     private currentlyUnmapped;
     private mapping;
     private held?;
     private alreadyMapped;
     private frameWait;
-    constructor(mapMode: MapMode, targetPad: number, next?: Scene | undefined);
+    constructor(mapMode: MapMode, targetPad: number);
     load(like: Like): void;
     update(): void;
     draw(like: Like): void;

package/dist/prefab-scenes/mapGamepad.js

@@ -28,24 +28,24 @@ export const buttonSetPS1 = new Set(mapOrder.slice(0, 14));
 export const buttonSetAll = new Set(mapOrder);
 const drawCircButt = (pos, size) => (like, color) => like.gfx.circle("fill", color, pos, size);
 const drawDpadPart = (rot) => (like, color) => {
-    like.gfx.push();
-    like.gfx.translate([2.5, 6]);
-    like.gfx.rotate(rot);
-    like.gfx.rectangle("fill", color, [0.5, -0.5, 1.3, 1]);
-    like.gfx.pop();
+    like.gfx.withTransform(() => {
+        like.gfx.translate([2.5, 6]);
+        like.gfx.rotate(rot);
+        like.gfx.rectangle("fill", color, [0.5, -0.5, 1.3, 1]);
+    });
 };
 const drawShoulder = (y, width, flip) => (like, color) => {
     const r = 0.8;
     const rectPos = [5 - width, y];
     const circPos = [5 - width - r, y];
-    like.gfx.push();
-    if (flip) {
-        like.gfx.translate([16, 0]);
-        like.gfx.scale([-1, 1]);
-    }
-    like.gfx.circle("fill", color, circPos, r, { arc: [Math.PI, Math.PI * 3 / 2], center: false });
-    like.gfx.rectangle("fill", color, [...rectPos, width, r]);
-    like.gfx.pop();
+    like.gfx.withTransform(() => {
+        if (flip) {
+            like.gfx.translate([16, 0]);
+            like.gfx.scale([-1, 1]);
+        }
+        like.gfx.circle("fill", color, circPos, r, { arc: [Math.PI, Math.PI * 3 / 2], center: false });
+        like.gfx.rectangle("fill", color, [...rectPos, width, r]);
+    });
 };
 // Buttons assume a centered resolution of 16x9px. Transforms exist for a reason lol.
 //      LLLLL           .             RRRRR
@@ -80,7 +80,7 @@ const buttonProps = {
  *
  * ```ts
  * like.gamepadconnected = (index) =>
- *   like.setScene(new MapGamepad({buttons: buttonSetGBA, sticks: 0}), index)
+ *   like.pushScene(new MapGamepad({buttons: buttonSetGBA, sticks: 0}), index)
  * ```
  *
  * Add this to your codebase and activating a gamepad causes a button mapping screen to pop up.
@@ -89,7 +89,7 @@ const buttonProps = {
  * Note: many browsers do this on first button press, so always writing "P2: press any button" is a fine idea.
  */
 export class MapGamepad {
-    constructor(mapMode, targetPad, next) {
+    constructor(mapMode, targetPad) {
         Object.defineProperty(this, "mapMode", {
             enumerable: true,
             configurable: true,
@@ -102,12 +102,6 @@ export class MapGamepad {
             writable: true,
             value: targetPad
         });
-        Object.defineProperty(this, "next", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: next
-        });
         Object.defineProperty(this, "currentlyUnmapped", {
             enumerable: true,
             configurable: true,
@@ -189,7 +183,7 @@ export class MapGamepad {
         }
         else if (!active) {
             like.gamepad.setMapping(this.targetPad, this.mapping);
-            setTimeout(() => like.setScene(this.next), 100);
+            setTimeout(() => like.popScene(), 100);
         }
     }
     gamepadreleased(_like, source, _name, num) {
@@ -200,6 +194,6 @@ export class MapGamepad {
         }
     }
     mousepressed(like) {
-        like.setScene(this.next);
+        like.popScene();
     }
 }

package/dist/prefab-scenes/startScreen.d.ts

@@ -22,7 +22,7 @@ import { Like } from '..';
  * like.draw = function () { ... }
  *
  * // Set up the start screen
- * like.setScene(new StartScreen())
+ * like.pushScene(new StartScreen())
  * like.start();
  * ```
  *
@@ -48,10 +48,9 @@ import { Like } from '..';
  * ```
  */
 export declare class StartScreen implements Scene {
-    private next;
     private onDraw?;
     private logo;
-    constructor(next: Scene, onDraw?: ((like: Like) => void) | undefined);
+    constructor(onDraw?: ((like: Like) => void) | undefined);
     load(like: Like): void;
     draw(like: Like): void;
     mousepressed(like: Like): void;

package/dist/prefab-scenes/startScreen.js

@@ -1,5 +1,36 @@
 import { Vec2 } from '../math/vector2';
-const LOGO = 'data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPCEtLSBDcmVhdGVkIHdpdGggSW5rc2NhcGUgKGh0dHA6Ly93d3cuaW5rc2NhcGUub3JnLykgLS0+Cjxzdmcgd2lkdGg9IjMwMG1tIiBoZWlnaHQ9IjEwNW1tIiB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCAzMDAgMTA1IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgogPHJlY3QgeD0iMTAiIHk9IjExLjIzIiB3aWR0aD0iMjgwIiBoZWlnaHQ9IjgzLjU0NCIgZmlsbD0iI2U0ODA4MCIgc3Ryb2tlPSIjMDAwIiBzdHJva2UtbGluZWpvaW49InJvdW5kIiBzdHJva2Utd2lkdGg9IjIiLz4KIDxnIGZpbGw9Im5vbmUiIHN0cm9rZT0iIzAwMCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCI+CiAgPHJlY3QgeD0iOTcuNDg0IiB5PSIxMS4yMyIgd2lkdGg9IjUyLjUxNiIgaGVpZ2h0PSI0Ni4yMzciLz4KICA8cmVjdCB4PSIxNTAiIHk9IjExLjIzIiB3aWR0aD0iMzUuMDExIiBoZWlnaHQ9IjQ2LjIzNyIvPgogIDxyZWN0IHg9IjE4NS4wMSIgeT0iMTEuMjMiIHdpZHRoPSI1Mi41MTYiIGhlaWdodD0iNDYuMjM3Ii8+CiAgPHJlY3QgeD0iMjM3LjUzIiB5PSIxMS4yMyIgd2lkdGg9IjUyLjUxNiIgaGVpZ2h0PSI0Ni4yMzciLz4KIDwvZz4KIDxnPgogIDxyZWN0IHg9IjEzMi40OSIgeT0iMTEuMjMiIHdpZHRoPSIxNy41MDUiIGhlaWdodD0iMjcuNDYxIi8+CiAgPHJlY3QgeD0iMTUwIiB5PSIyOS4zMDIiIHdpZHRoPSI4Ljc1MjciIGhlaWdodD0iMTguNzc2Ii8+CiAgPHJlY3QgeD0iMTc2LjI2IiB5PSIyOS4zMDIiIHdpZHRoPSI4Ljc1MjciIGhlaWdodD0iMTguNzc2Ii8+CiA8L2c+CiA8cmVjdCB4PSIxNTAiIHk9IjExLjIzIiB3aWR0aD0iMTcuNTA1IiBoZWlnaHQ9IjguNjg0NSIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjMDAwIiBzdHJva2UtbGluZWpvaW49InJvdW5kIi8+CiA8cmVjdCB4PSIxNjcuNTEiIHk9IjExLjIzIiB3aWR0aD0iMTcuNTA1IiBoZWlnaHQ9IjguNjg0NSIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjMDAwIiBzdHJva2UtbGluZWpvaW49InJvdW5kIi8+CiA8Zz4KICA8cGF0aCBkPSJtMjM3LjUzIDM4LjY5MS0xNy41MDUtOS4zODgyIDE3LjUwNS0xOC4wNzN6Ii8+CiAgPHJlY3QgeD0iMjAyLjg4IiB5PSI0OC4wNzkiIHdpZHRoPSIxNi43NzIiIGhlaWdodD0iOS4zODgyIi8+CiAgPHJlY3QgeD0iMjcyLjU0IiB5PSIyMC4yNjYiIHdpZHRoPSIxNi43NzIiIGhlaWdodD0iOS4zODgyIi8+CiAgPHJlY3QgeD0iMjcyLjU0IiB5PSIzOC42OTEiIHdpZHRoPSIxNi43NzIiIGhlaWdodD0iOS4zODgyIi8+CiAgPHBhdGggZD0ibTIwMi41MiAyOS4zMDIgMC4zNjY4NS0xOC4wNzNoMTcuMTM5eiIvPgogPC9nPgogPHBhdGggZD0ibTY0LjA3OCAxLjAwNDItMzMuMzc1IDMzLjM3NS0wLjAxNzQzIDAuMDE3NGEyMy42MTIgMjMuNjEyIDAgMCAwIDAgMzMuMzkyIDIzLjYxMiAyMy42MTIgMCAwIDAgMzAuMDEyIDIuODAyMiAyMy42MTIgMjMuNjEyIDAgMCAxIDdlLTMgMC41NzAzNCAyMy42MTIgMjMuNjEyIDAgMCAxLTIzLjYxMiAyMy42MTJoNTMuOTdhMjMuNjEyIDIzLjYxMiAwIDAgMS0yMy42MTEtMjMuNjEyIDIzLjYxMiAyMy42MTIgMCAwIDEgN2UtMyAtMC41NzAzNCAyMy42MTIgMjMuNjEyIDAgMCAwIDMwLjAxMi0yLjgwMjkgMjMuNjEyIDIzLjYxMiAwIDAgMC02Ljg4ZS00IC0zMy4zOTJ6IiBmaWxsPSIjODBjM2U0IiBzdHJva2U9IiMwMDAiIHN0cm9rZS1saW5lam9pbj0icm91bmQiLz4KIDxnIGZpbGw9Im5vbmUiIHN0cm9rZT0iIzAwMCIgc3Ryb2tlLXdpZHRoPSIuNSI+CiAgPGNpcmNsZSB0cmFuc2Zvcm09InJvdGF0ZSgxMzUpIiBjeD0iLTIwLjk4OCIgY3k9Ii05My4yNDMiIHI9IjIzLjYxMiIvPgogIDxjaXJjbGUgdHJhbnNmb3JtPSJyb3RhdGUoMTM1KSIgY3g9IjIuNjIzOCIgY3k9Ii02OS42MzIiIHI9IjIzLjYxMiIvPgogIDxjaXJjbGUgY3g9IjkxLjA2MiIgY3k9IjcxLjE2MSIgcj0iMjMuNjEyIi8+CiAgPGNpcmNsZSBjeD0iMzcuMDkzIiBjeT0iNzEuMTYxIiByPSIyMy42MTIiLz4KIDwvZz4KPC9zdmc+Cg==';
+const LOGO = 'data:image/svg+xml;base64,' +
+    'PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPCEtLSBDcmVhdGVkIHdpdGgg' +
+    'SW5rc2NhcGUgKGh0dHA6Ly93d3cuaW5rc2NhcGUub3JnLykgLS0+Cjxzdmcgd2lkdGg9IjI1Nm1t' +
+    'IiBoZWlnaHQ9Ijg1bW0iIHZlcnNpb249IjEuMSIgdmlld0JveD0iMCAwIDI1NiA4NSIgeG1sbnM9' +
+    'Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KIDxyZWN0IHg9IjguNDk0OSIgeT0iMTQuODQx' +
+    'IiB3aWR0aD0iMjM5LjEzIiBoZWlnaHQ9IjYwLjMzNyIgcnk9IjE0LjM2OSIvPgogPHBhdGggZD0i' +
+    'bTQ5LjUxOSAyLjE5MzMtMjIuODQxIDIyLjg1NC0wLjAxMTkzIDAuMDExOTNhMTYuMTU5IDE2LjE2' +
+    'OCAwIDAgMCAwIDIyLjg2NiAxNi4xNTkgMTYuMTY4IDAgMCAwIDIwLjUzOSAxLjkxODkgMTYuMTU5' +
+    'IDE2LjE2OCAwIDAgMSAwLjAwNDggMC4zOTA1NSAxNi4xNTkgMTYuMTY4IDAgMCAxLTE2LjE1OSAx' +
+    'Ni4xNjloMzYuOTM1YTE2LjE1OSAxNi4xNjggMCAwIDEtMTYuMTU5LTE2LjE2OSAxNi4xNTkgMTYu' +
+    'MTY4IDAgMCAxIDAuMDA1NC0wLjM5MDU1IDE2LjE1OSAxNi4xNjggMCAwIDAgMjAuNTM5LTEuOTE5' +
+    'MyAxNi4xNTkgMTYuMTY4IDAgMCAwLTQuNzZlLTQgLTIyLjg2NnoiIGZpbGw9IiNiYTJiMmIiIHN0' +
+    'cm9rZT0iI2ZmY2Y0MiIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLXdpZHRoPSIuNSIv' +
+    'PgogPGcgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjZmZjZjQyIiBzdHJva2Utd2lkdGg9Ii41Ij4KICA8' +
+    'Y2lyY2xlIHRyYW5zZm9ybT0ibWF0cml4KC0uNzA2OSAuNzA3MzEgLS43MDY5IC0uNzA3MzEgMCAw' +
+    'KSIgY3g9Ii0xNy4zMTEiIGN5PSItNjguOTAzIiByPSIxNi4xNjQiLz4KICA8Y2lyY2xlIHRyYW5z' +
+    'Zm9ybT0ibWF0cml4KC0uNzA2OSAuNzA3MzEgLS43MDY5IC0uNzA3MzEgMCAwKSIgY3g9Ii0xLjE0' +
+    'NyIgY3k9Ii01Mi43MzkiIHI9IjE2LjE2NCIvPgogIDxlbGxpcHNlIGN4PSI2Ny45ODYiIGN5PSI1' +
+    'MC4yMzQiIHJ4PSIxNi4xNTkiIHJ5PSIxNi4xNjgiLz4KICA8ZWxsaXBzZSBjeD0iMzEuMDUxIiBj' +
+    'eT0iNTAuMjM0IiByeD0iMTYuMTU5IiByeT0iMTYuMTY4Ii8+CiA8L2c+CiA8ZyBmaWxsPSIjZmZj' +
+    'ZjQyIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iLjUiPgogIDxwYXRoIGQ9Im04OS45MjQg' +
+    'MjEuOTc5djM2LjM3NWgyOC4xMDN2LTE0Ljc3MWgtMTIuMDI5di0yMS42MDR6Ii8+CiAgPHBhdGgg' +
+    'ZD0ibTEyNy45NCAyNC42Nzh2Ny42NjVoNS4wNDUzdjExLjA0NmgtNS4wNDUzdjE0Ljk2NmgyNC43' +
+    'NDh2LTE0Ljk2NmgtNS4wNDh2LTExLjA0Nmg1LjA0OHYtNy42NjVoLTEyLjM3N3oiLz4KICA8cGF0' +
+    'aCBkPSJtMjA2Ljg5IDIyLjA4OHYzNi4zNzVoMzMuNzM5di0xMy4xNzloLTEwLjkwOHYtNS4wNjc4' +
+    'aDEwLjkwOHYtNy4xMDloLTEwLjkwOHYtNS4wNjloMTAuOTA4di01Ljk1MDR6Ii8+CiAgPHBhdGgg' +
+    'ZD0ibTE2Mi43NiAxOS43N3YzOC42OTNoMTIuMjgxdi01LjA2OWgxMS41MjN2NS4wNjloMTIuMjgx' +
+    'czEuMDQ4Mi0xNS4xMTUtMi4yMDEyLTE4Ljc2OGMtMy40NzA0LTMuOTAxOC02LjM3MjMtNC41MjA5' +
+    'LTYuMzcyMy00LjUyMDlsOC44ODQ4LTEzLjA4N2gtMTMuNjE1bC02LjQxMDggMTMuMDIyLTQuMzQy' +
+    'MyAwLjAzNjk4LThlLTMgLTE1LjM3N3oiLz4KICA8ZWxsaXBzZSBjeD0iMTMyLjk5IiBjeT0iMTYu' +
+    'MTIyIiByeD0iNi4wMjIxIiByeT0iNi4xMTgyIi8+CiAgPGVsbGlwc2UgY3g9IjE0Ny40OSIgY3k9' +
+    'IjE2LjEyMiIgcng9IjYuMDIyMSIgcnk9IjYuMTE4MiIvPgogPC9nPgo8L3N2Zz4K';
 /**
  * ## Why
  *
@@ -22,7 +53,7 @@ const LOGO = 'data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0i
  * like.draw = function () { ... }
  *
  * // Set up the start screen
- * like.setScene(new StartScreen())
+ * like.pushScene(new StartScreen())
  * like.start();
  * ```
  *
@@ -48,13 +79,7 @@ const LOGO = 'data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0i
  * ```
  */
 export class StartScreen {
-    constructor(next, onDraw) {
-        Object.defineProperty(this, "next", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: next
-        });
+    constructor(onDraw) {
         Object.defineProperty(this, "onDraw", {
             enumerable: true,
             configurable: true,
@@ -76,13 +101,17 @@ export class StartScreen {
             this.onDraw(like);
         }
         else if (this.logo.isReady()) {
-            like.gfx.clear([0.05, 0.05, 0.08, 1]);
+            like.gfx.clear([0.5, 0, 0.5, 1]);
             const winSize = like.canvas.getSize();
             const scale = (winSize[0] * 0.5) / this.logo.size[0];
-            like.gfx.draw(this.logo, Vec2.div(winSize, 2), { scale, origin: Vec2.div(this.logo.size, 2) });
+            like.gfx.draw(this.logo, Vec2.div(winSize, 2), {
+                scale,
+                origin: Vec2.div(this.logo.size, 2),
+            });
+            like.gfx.print([1, 1, 0, 0.5 + 0.5 * Math.sin(like.timer.getTime() * 3)], "▶️ click to start ◀️", Vec2.mul(winSize, [0.5, 0.8]), { align: "center", font: "25px sans" });
         }
     }
     mousepressed(like) {
-        like.setScene(this.next);
+        like.popScene();
     }
 }

package/dist/scene.d.ts

@@ -15,13 +15,21 @@ import type { Like } from './like';
  * your running scene and shows up as an additional first argument
  * to every callback.
  *
+ * ## The scene stack
+ *
+ * There is a stack of scenes for state management and/or overlays.
+ *
+ * Use {@link LikeBase.pushScene | pushScene} and {@link LikeBase.popScene | Like.popScene} to manage the stack.
+ *
+ * {@link LikeBase.setScene | setScene} Sets the top of the stack only, replacing the current scene if any.
+ *
  * ## Quick Start
  *
  * Have a scene handle all the callbacks, disabling global
  * callbacks.
  * ```typescript
  * // set up a scene
- * class MagicalGrowingRectangle extends Scene {
+ * class MagicalGrowingRectangle implements Scene {
  *   rectangleSize = 10;
  *   constructor() {}
  *
@@ -35,16 +43,16 @@ import type { Like } from './like';
  *   }
  * }
  *
- * like.setScene(new MagicalGrowingRectangle());
+ * like.pushScene(new MagicalGrowingRectangle(), false);
  * ```
  *
- * To get back to global callbacks, just use `like.handleEvent = undefined`
+ * To get back to global callbacks, just use {@link Like.popScene | like.popScene}
  *
  * ## Scene Lifecycle
  *
  * Works a lot like global callbacks.
  *
- * 1. `like.setScene(scene)` is called
+ * 1. `like.setScene(scene)` or `like.pushScene(scene)` is called
  * 2. Scene's `load` callback fires immediately
  * 3. `update` and `draw` begin on next frame
  * 4. Scene receives input events as they occur
@@ -57,9 +65,9 @@ import type { Like } from './like';
  *
  * ```typescript
  * class UI implements Scene {
- *   constructor(public game: Game) {}
+ *   constructor(public game: Scene) {}
  *
- *   handleEvent(like: Like, event: Like2DEvent) {
+ *   handleEvent(like: Like, event: LikeEvent) {
  *     // Block mouse events in order to create a top bar.
  *     const mouseY = like.mouse.getPosition()[1];
  *     if (!event.type.startsWith('mouse') || mouseY > 100) {
@@ -77,11 +85,45 @@ import type { Like } from './like';
  *   ...
  * }
  *
- * like.setScene(new UI(new Game()))
+ * like.pushScene(new UI(new Game()), false)
  * ```
  *
  * Composing scenes lets you filter events, layer game elements,
  * and more. Don't sleep on it.
+ *
+ * The main advance of composing scenes versus the stack-overlay
+ * technique is that the parent scene knows about its child.
+ * Because there's a **known interface**, the two scenes
+ * can communicate.
+ *
+ * This makes it perfect for reusable UI,
+ * level editors, debug viewers, and more.
+ *
+ * ## Overlay scenes
+ *
+ * You might assume that the purpose of a scene stack is
+ * visual: first push the BG, then the FG, etc.
+ *
+ * Actually, composing scenes (above) is a
+ * better pattern for that, since it's both explicit
+ * _and_ the parent can have a known interface on its child.
+ * Here, the **upper** scene only knows that the
+ * **lower** scene _is_ a scene.
+ *
+ * That's the tradeoff. Overlay scenes are good for things
+ * like pause screens or gamepad overlays. Anything where
+ * the upper doesn't care _what_ the lower is, and where
+ * the upper scene should be easily addable/removable.
+ *
+ * Using `like.getScene(-2)`, the overlay scene can see
+ * the lower scene and choose how to propagate events.
+ *
+ * The only technical difference between overlay and
+ * opaque is whether or not the scene we've pushed
+ * on top of stays loaded.
+ *
+ * @interface
+ *
  */
 export type Scene = {
     [K in keyof EventMap]?: (like: Like, ...args: EventMap[K]) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "like2d",
-  "version": "2.11.1",
+  "version": "2.12.1",
   "description": "A web-native game framework inspired by Love2D",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,6 +37,7 @@
   },
   "files": [
     "dist/**/*",
+    "!dist/**/*.ts.map",
     "assets/**/*",
     "README.md",
     "LICENSE"
@@ -62,7 +63,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/44100hertz/Like2D"
+    "url": "https://github.com/likeOrg/Like2D"
   },
   "devDependencies": {
     "typescript": "^5.9.3"

package/dist/__benchmarks__/vector2.bench.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=vector2.bench.d.ts.map

package/dist/__benchmarks__/vector2.bench.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vector2.bench.d.ts","sourceRoot":"","sources":["../../src/__benchmarks__/vector2.bench.ts"],"names":[],"mappings":""}