minimojs 1.0.0-alpha.11 → 1.0.0-alpha.12

package/README.md

@@ -21,6 +21,7 @@ This README is intentionally high-level. It explains what the project is and how
 - Runtime update delta (`dt`) is seconds
 - Coordinate system is center-based world space
 - Positive Y goes downward
+- For new mobile-first games, prefer a portrait canvas of `720x1280`
 
 ## What It Intentionally Avoids
 
@@ -41,14 +42,14 @@ npm install minimojs
 ```ts
 import { Game, Sprite, type IScene } from "minimojs";
 
-const game = new Game(800, 600);
+const game = new Game(720, 1280);
 game.gravityY = 980;
 
 class DemoScene implements IScene {
   private player: Sprite | null = null;
 
   onCreate() {
-    this.player = game.add(new Sprite("🐢", 400, 300, 48));
+    this.player = game.add(new Sprite("🐢", 360, 640, 48));
     this.player.gravityScale = 1;
   }
 

package/dist/minimo.d.ts

@@ -576,7 +576,7 @@ export interface CollisionInfo {
  * Example custom font registration:
  *
  * ```ts
- * const game = new Game(800, 600);
+ * const game = new Game(720, 1280);
  * game.requireFont('"Bangers"', { weight: "400" });
  * game.start();
  * ```
@@ -588,7 +588,7 @@ export interface CollisionInfo {
  * ```ts
  * import { Game, Sprite } from "https://cdn.jsdelivr.net/npm/minimojs@<version>/dist/minimo.js";
  *
- * const game = new Game(800, 600);
+ * const game = new Game(720, 1280);
  *
  * const player = new Sprite("🐢", 400, 500, 48);
  * game.add(player);
@@ -935,15 +935,16 @@ export declare class Game {
      * The engine creates its own `<canvas>`, sets its dimensions, and appends it
      * to `document.body`. The canvas is automatically centered and responsively
      * scaled to use the maximum available viewport space while preserving aspect ratio.
+     * For new mobile-first Minimo Games, prefer a portrait canvas such as `720x1280`.
      *
-     * @param width - Canvas width in pixels. Default: `800`.
-     * @param height - Canvas height in pixels. Default: `600`.
+     * @param width - Canvas width in pixels. Default: `720`.
+     * @param height - Canvas height in pixels. Default: `1280`.
      *
      * @throws Error if a 2D context cannot be obtained.
      *
      * @example
      * ```ts
-     * const game = new Game(800, 600);
+     * const game = new Game(720, 1280);
      * game.physics = true;
      * ```
      */

package/dist/minimo.js

@@ -693,7 +693,7 @@ export class BackgroundLayer {
  * Example custom font registration:
  *
  * ```ts
- * const game = new Game(800, 600);
+ * const game = new Game(720, 1280);
  * game.requireFont('"Bangers"', { weight: "400" });
  * game.start();
  * ```
@@ -705,7 +705,7 @@ export class BackgroundLayer {
  * ```ts
  * import { Game, Sprite } from "https://cdn.jsdelivr.net/npm/minimojs@<version>/dist/minimo.js";
  *
- * const game = new Game(800, 600);
+ * const game = new Game(720, 1280);
  *
  * const player = new Sprite("🐢", 400, 500, 48);
  * game.add(player);
@@ -981,19 +981,20 @@ export class Game {
      * The engine creates its own `<canvas>`, sets its dimensions, and appends it
      * to `document.body`. The canvas is automatically centered and responsively
      * scaled to use the maximum available viewport space while preserving aspect ratio.
+     * For new mobile-first Minimo Games, prefer a portrait canvas such as `720x1280`.
      *
-     * @param width - Canvas width in pixels. Default: `800`.
-     * @param height - Canvas height in pixels. Default: `600`.
+     * @param width - Canvas width in pixels. Default: `720`.
+     * @param height - Canvas height in pixels. Default: `1280`.
      *
      * @throws Error if a 2D context cannot be obtained.
      *
      * @example
      * ```ts
-     * const game = new Game(800, 600);
+     * const game = new Game(720, 1280);
      * game.physics = true;
      * ```
      */
-    constructor(width = 800, height = 600) {
+    constructor(width = 720, height = 1280) {
         /** @internal */ this._requiredFonts = new Map();
         /** @internal */ this._hasAppliedGlobalFontRequirements = false;
         /** @internal */ this._isRegisteringPreloadAssets = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimojs",
-  "version": "1.0.0-alpha.11",
+  "version": "1.0.0-alpha.12",
   "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",