minimojs 1.0.0-alpha.2 → 1.0.0-alpha.3

package/dist/minimo.d.ts

@@ -72,6 +72,14 @@ export declare class Sprite {
      * Used for both canvas rendering (font size) and AABB collision detection.
      */
     size: number;
+    /**
+     * CSS text color used when rendering this sprite.
+     *
+     * This mainly affects monochrome glyphs and symbol-style sprites.
+     * Full-color emoji may ignore this and render with their native colors,
+     * depending on browser behavior.
+     */
+    color: string;
     /**
      * Visual rotation of the sprite in degrees.
      * `0` = upright. Positive values rotate clockwise.
@@ -193,7 +201,7 @@ export interface PointerInfo {
  * ## Quick Start
  *
  * ```ts
- * import { Game, Sprite } from "minimojs";
+ * import { Game, Sprite } from "https://cdn.jsdelivr.net/npm/minimojs@<version>/dist/minimo.js";
  *
  * const game = new Game(800, 600);
  *
@@ -976,6 +984,22 @@ export declare class Game {
      * ```
      */
     drawText(text: string, x: number, y: number, fontSize: number, color?: string, centered?: boolean): void;
+    /**
+     * Clears the internal sprite glyph cache.
+     *
+     * MinimoJS prerenders sprite glyphs into offscreen canvases for more stable
+     * emoji rendering and better performance. In long-running sessions, you can
+     * call this to release cached glyph variants and force them to be rebuilt on
+     * the next render.
+     *
+     * This does not change any sprite state. It only clears cached render data.
+     *
+     * @example
+     * ```ts
+     * game.clearSpriteCache();
+     * ```
+     */
+    clearSpriteCache(): void;
     /**
      * Returns a pseudo-random floating-point number in the range `[0, 1)`.
      * Delegates to `Math.random()`.

package/dist/minimo.js

@@ -87,6 +87,14 @@ export class Sprite {
          * Used for both canvas rendering (font size) and AABB collision detection.
          */
         this.size = 32;
+        /**
+         * CSS text color used when rendering this sprite.
+         *
+         * This mainly affects monochrome glyphs and symbol-style sprites.
+         * Full-color emoji may ignore this and render with their native colors,
+         * depending on browser behavior.
+         */
+        this.color = "#000000";
         /**
          * Visual rotation of the sprite in degrees.
          * `0` = upright. Positive values rotate clockwise.
@@ -171,7 +179,7 @@ export class Sprite {
  * ## Quick Start
  *
  * ```ts
- * import { Game, Sprite } from "minimojs";
+ * import { Game, Sprite } from "https://cdn.jsdelivr.net/npm/minimojs@<version>/dist/minimo.js";
  *
  * const game = new Game(800, 600);
  *
@@ -1169,6 +1177,24 @@ export class Game {
     // -------------------------------------------------------------------------
     // Misc
     // -------------------------------------------------------------------------
+    /**
+     * Clears the internal sprite glyph cache.
+     *
+     * MinimoJS prerenders sprite glyphs into offscreen canvases for more stable
+     * emoji rendering and better performance. In long-running sessions, you can
+     * call this to release cached glyph variants and force them to be rebuilt on
+     * the next render.
+     *
+     * This does not change any sprite state. It only clears cached render data.
+     *
+     * @example
+     * ```ts
+     * game.clearSpriteCache();
+     * ```
+     */
+    clearSpriteCache() {
+        this._spriteGlyphCache.clear();
+    }
     /**
      * Returns a pseudo-random floating-point number in the range `[0, 1)`.
      * Delegates to `Math.random()`.
@@ -1535,7 +1561,8 @@ export class Game {
     /** @internal */
     _getSpriteGlyphCanvas(sprite) {
         const size = Math.max(1, Math.round(sprite.size));
-        const cacheKey = `${sprite.sprite}::${size}`;
+        const color = sprite.color;
+        const cacheKey = `${sprite.sprite}::${size}::${color}`;
         const cached = this._spriteGlyphCache.get(cacheKey);
         if (cached)
             return cached;
@@ -1552,7 +1579,7 @@ export class Game {
         glyphCtx.shadowBlur = 0;
         glyphCtx.shadowOffsetX = 0;
         glyphCtx.shadowOffsetY = 0;
-        glyphCtx.fillStyle = "#ffffff";
+        glyphCtx.fillStyle = color;
         glyphCtx.font = `${size}px "Apple Color Emoji", "Segoe UI Emoji", "Noto Color Emoji", sans-serif`;
         glyphCtx.textAlign = "center";
         glyphCtx.textBaseline = "middle";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimojs",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.3",
   "description": "MinimoJS v1 — ultra-minimal, flat, deterministic 2D web game engine. Emoji-only sprites, rAF loop, TypeScript-first, LLM-friendly.",
   "type": "module",
   "main": "dist/minimo.js",