like2d 1.0.0

package/README.md

@@ -0,0 +1,66 @@
+# LÏKE2D Framework Library
+
+You've reached the more detailed docs for this framework.
+For now, the source code is the best API docs we have. 
+
+## Features of LIKE
+
+**Stateless Canvas API**
+
+JS canvas has state to keep track of like color and line width.
+LIKE abstracts that away so it's easy to reason about.
+
+**Fire-and-forget asset loading**
+
+Loading sound and images in Vanilla JS is clunky and can interrupt your game loop.
+LIKE has synchronous asset handles and abstracts away the clunkiness.
+
+**Zero boilerplate, physical game input**
+
+LIKE does the input boilerplate for you.
+ - Keeping track of what's held/pressed.
+ - Controller mapping by physical location. Not every A is in the same spot.
+ - Mapping inputs into actions for easy remapping.
+
+**Declarative event system**
+
+Don't bother juggling stateful listeners.
+LIKE keeps event handling simple by running it all through a single callback.
+
+**Build it how you want it**
+
+It's not an engine, it's a framework.
+For new developers, this means making simple games easily: no engine, no problem!
+For others, get to work faster making your own specialized tooling, engine, and more,
+all without banging your head on browser APIs.
+
+## Getting started
+
+TODO: fill this in.
+
+Then run:
+```bash
+pnpm install
+pnpm run dev
+```
+
+## For LOVE developers
+
+LIKE is not compatible with LOVE.
+
+To summarize the differences:
+ - We don't keep track of color etc. as state (via setColor, etc.), so it gets passed in each draw call.
+ - We use objects for optional arguments, and avoid function overloading.
+ - We make use of tuples for passing around colors, coordinates, and rects.
+ - In LOVE, Callbacks such as `love.keypressed` needed to be wrapped in order to make Scenes. This pattern is part of LIKE.
+ - 2d Canvas so, no shaders.
+ - No built-in physics.
+
+## Full Disclosure about AI
+
+Yes, this framework was created with the help of heavily supervised AI.
+
+Virtually every design decision was made by me, and I have micro-managed the code output.
+
+Over time, I will rewrite parts of it by hand as desired. Possibly the whole thing.
+

package/dist/audio.d.ts

@@ -0,0 +1,52 @@
+export interface SourceOptions {
+    volume?: number;
+    pitch?: number;
+    looping?: boolean;
+}
+export declare class Source {
+    private audio;
+    private _volume;
+    private _pitch;
+    private _looping;
+    private path;
+    private isLoaded;
+    private loadPromise;
+    private globalVolume;
+    constructor(path: string, options?: SourceOptions);
+    _setGlobalVolume(vol: number): void;
+    ready(): Promise<void>;
+    private updatePlaybackRate;
+    play(): boolean;
+    stop(): void;
+    pause(): void;
+    resume(): boolean;
+    seek(position: number): void;
+    tell(): number;
+    getDuration(): number;
+    isPlaying(): boolean;
+    isPaused(): boolean;
+    isStopped(): boolean;
+    isReady(): boolean;
+    setVolume(volume: number): void;
+    getVolume(): number;
+    setPitch(pitch: number): void;
+    getPitch(): number;
+    setLooping(looping: boolean): void;
+    isLooping(): boolean;
+    clone(): Source;
+}
+export declare class Audio {
+    private sources;
+    private globalVolume;
+    newSource(path: string, options?: SourceOptions): Source;
+    play(source: Source): boolean;
+    stop(source?: Source): void;
+    pause(source?: Source): void;
+    resume(source?: Source): void;
+    setVolume(volume: number): void;
+    getVolume(): number;
+    getActiveSourceCount(): number;
+    getActiveSources(): Source[];
+}
+export declare const audio: Audio;
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,YAAY,CAAa;gBAErB,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB;IA6BrD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,OAAO,CAAC,kBAAkB;IAI1B,IAAI,IAAI,OAAO;IAoBf,IAAI,IAAI,IAAI;IAKZ,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,OAAO;IAOjB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI5B,IAAI,IAAI,MAAM;IAId,WAAW,IAAI,MAAM;IAIrB,SAAS,IAAI,OAAO;IAIpB,QAAQ,IAAI,OAAO;IAInB,SAAS,IAAI,OAAO;IAIpB,OAAO,IAAI,OAAO;IAIlB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,SAAS,IAAI,MAAM;IAInB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B,QAAQ,IAAI,MAAM;IAIlB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKlC,SAAS,IAAI,OAAO;IAIpB,KAAK,IAAI,MAAM;CAShB;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAAa;IAEjC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAOxD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI7B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ3B,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAY5B,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAY7B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B,SAAS,IAAI,MAAM;IAInB,oBAAoB,IAAI,MAAM;IAU9B,gBAAgB,IAAI,MAAM,EAAE;CAS7B;AAED,eAAO,MAAM,KAAK,OAAc,CAAC"}

package/dist/audio.js

@@ -0,0 +1,250 @@
+export class Source {
+    constructor(path, options = {}) {
+        Object.defineProperty(this, "audio", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_volume", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 1
+        });
+        Object.defineProperty(this, "_pitch", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 1
+        });
+        Object.defineProperty(this, "_looping", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "path", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "isLoaded", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "loadPromise", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "globalVolume", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 1
+        });
+        this.path = path;
+        this.audio = document.createElement('audio');
+        this.audio.src = path;
+        this._volume = options.volume ?? 1;
+        this._pitch = options.pitch ?? 1;
+        this._looping = options.looping ?? false;
+        this.audio.volume = this._volume;
+        this.audio.loop = this._looping;
+        this.updatePlaybackRate();
+        this.loadPromise = new Promise((resolve, reject) => {
+            this.audio.oncanplaythrough = () => {
+                this.isLoaded = true;
+                resolve();
+            };
+            this.audio.onerror = () => {
+                reject(new Error(`Failed to load audio: ${path}`));
+            };
+            if (this.audio.readyState >= 4) {
+                this.isLoaded = true;
+                resolve();
+            }
+        });
+    }
+    _setGlobalVolume(vol) {
+        this.globalVolume = vol;
+        this.audio.volume = this._volume * this.globalVolume;
+    }
+    ready() {
+        return this.loadPromise;
+    }
+    updatePlaybackRate() {
+        this.audio.playbackRate = this._pitch;
+    }
+    play() {
+        if (!this.isLoaded) {
+            // Silently return false - asset not loaded yet
+            return false;
+        }
+        // Only reset to beginning if stopped (not paused)
+        if (this.isStopped() || this.audio.ended) {
+            this.audio.currentTime = 0;
+        }
+        const playPromise = this.audio.play();
+        if (playPromise) {
+            playPromise.catch(err => {
+                console.warn(`Failed to play audio "${this.path}":`, err.message);
+            });
+        }
+        return true;
+    }
+    stop() {
+        this.audio.pause();
+        this.audio.currentTime = 0;
+    }
+    pause() {
+        this.audio.pause();
+    }
+    resume() {
+        if (this.audio.paused) {
+            return this.play();
+        }
+        return false;
+    }
+    seek(position) {
+        this.audio.currentTime = position;
+    }
+    tell() {
+        return this.audio.currentTime;
+    }
+    getDuration() {
+        return this.audio.duration || 0;
+    }
+    isPlaying() {
+        return !this.audio.paused && !this.audio.ended;
+    }
+    isPaused() {
+        return this.audio.paused && this.audio.currentTime > 0;
+    }
+    isStopped() {
+        return this.audio.paused && this.audio.currentTime === 0;
+    }
+    isReady() {
+        return this.isLoaded;
+    }
+    setVolume(volume) {
+        this._volume = Math.max(0, Math.min(1, volume));
+        this.audio.volume = this._volume * this.globalVolume;
+    }
+    getVolume() {
+        return this._volume;
+    }
+    setPitch(pitch) {
+        this._pitch = Math.max(0.125, Math.min(8, pitch));
+        this.updatePlaybackRate();
+    }
+    getPitch() {
+        return this._pitch;
+    }
+    setLooping(looping) {
+        this._looping = looping;
+        this.audio.loop = looping;
+    }
+    isLooping() {
+        return this._looping;
+    }
+    clone() {
+        const clone = new Source(this.path, {
+            volume: this._volume,
+            pitch: this._pitch,
+            looping: this._looping
+        });
+        clone._setGlobalVolume(this.globalVolume);
+        return clone;
+    }
+}
+export class Audio {
+    constructor() {
+        Object.defineProperty(this, "sources", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        Object.defineProperty(this, "globalVolume", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 1
+        });
+    }
+    newSource(path, options) {
+        const source = new Source(path, options);
+        source._setGlobalVolume(this.globalVolume);
+        this.sources.add(source);
+        return source;
+    }
+    play(source) {
+        return source.play();
+    }
+    stop(source) {
+        if (source) {
+            source.stop();
+        }
+        else {
+            this.sources.forEach(s => s.stop());
+        }
+    }
+    pause(source) {
+        if (source) {
+            source.pause();
+        }
+        else {
+            this.sources.forEach(s => {
+                if (s.isPlaying()) {
+                    s.pause();
+                }
+            });
+        }
+    }
+    resume(source) {
+        if (source) {
+            source.resume();
+        }
+        else {
+            this.sources.forEach(s => {
+                if (s.isPaused()) {
+                    s.resume();
+                }
+            });
+        }
+    }
+    setVolume(volume) {
+        this.globalVolume = Math.max(0, Math.min(1, volume));
+        this.sources.forEach(source => {
+            source._setGlobalVolume(this.globalVolume);
+        });
+    }
+    getVolume() {
+        return this.globalVolume;
+    }
+    getActiveSourceCount() {
+        let count = 0;
+        this.sources.forEach(source => {
+            if (source.isPlaying()) {
+                count++;
+            }
+        });
+        return count;
+    }
+    getActiveSources() {
+        const active = [];
+        this.sources.forEach(source => {
+            if (source.isPlaying()) {
+                active.push(source);
+            }
+        });
+        return active;
+    }
+}
+export const audio = new Audio();

package/dist/events.d.ts

@@ -0,0 +1,36 @@
+export type Event = {
+    type: 'keypressed';
+    scancode: string;
+    keycode: string;
+} | {
+    type: 'keyreleased';
+    scancode: string;
+    keycode: string;
+} | {
+    type: 'mousepressed';
+    x: number;
+    y: number;
+    button: number;
+} | {
+    type: 'mousereleased';
+    x: number;
+    y: number;
+    button: number;
+} | {
+    type: 'actionpressed';
+    action: string;
+} | {
+    type: 'actionreleased';
+    action: string;
+} | {
+    type: 'gamepadpressed';
+    gamepadIndex: number;
+    buttonIndex: number;
+    buttonName: string;
+} | {
+    type: 'gamepadreleased';
+    gamepadIndex: number;
+    buttonIndex: number;
+    buttonName: string;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzF;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/events.js

@@ -0,0 +1 @@
+export {};