zx-kit 0.22.0 → 0.24.0

package/dist/tilescroll.d.ts

@@ -0,0 +1,27 @@
+import type { TileMap } from './tilemap.js';
+/**
+ * Returns the map's full size in pixels — handy for `worldW`/`worldH` when
+ * constructing a {@link "camera" | Camera}.
+ *
+ * @example
+ * const { width, height } = tileMapWorldSize(map)
+ */
+export declare function tileMapWorldSize(map: TileMap): {
+    width: number;
+    height: number;
+};
+/**
+ * Renders `map` with the viewport's top-left at world pixel `(camX, camY)`.
+ * The camera position is rounded to whole pixels for crisp output, then the
+ * visible tile range (plus one overscan row/column) is drawn at
+ * `tileX * CELL - camX`, giving smooth scrolling at any pixel offset.
+ *
+ * @param viewW - Visible width in pixels (default `256`). Must be positive.
+ * @param viewH - Visible height in pixels (default `192`). Must be positive.
+ *
+ * @example
+ * drawTileMapAt(ctx, map, cam.x, cam.y)            // standard 256×192
+ * drawTileMapAt(ctx, map, cam.x, cam.y, 256, 176)  // shorter play area
+ */
+export declare function drawTileMapAt(ctx: CanvasRenderingContext2D, map: TileMap, camX: number, camY: number, viewW?: number, viewH?: number): void;
+//# sourceMappingURL=tilescroll.d.ts.map

package/dist/tilescroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tilescroll.d.ts","sourceRoot":"","sources":["../src/tilescroll.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAEhF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,SAAM,EACX,KAAK,SAAM,GACV,IAAI,CAuBN"}

package/dist/tilescroll.js

@@ -0,0 +1,74 @@
+/**
+ * @module tilescroll
+ *
+ * **Pixel-smooth tile-map scrolling.** The built-in {@link "tilemap" |
+ * TileMap.render} takes a viewport in *whole tiles*, so a camera can only move
+ * in 8-pixel steps — fine for grid games, visibly steppy for a platformer where
+ * the player moves sub-pixel-smooth while jumping.
+ *
+ * {@link drawTileMapAt} renders the map at an arbitrary pixel camera position by
+ * drawing one extra row/column and offsetting every tile by `camX % CELL` /
+ * `camY % CELL`. Off-screen and empty cells are skipped; the leading/trailing
+ * partial tiles are drawn and naturally clipped by the canvas bounds.
+ *
+ * @example
+ * ```ts
+ * const cam = createCamera({ viewW: 256, viewH: 192, ...tileMapWorldSize(map) })
+ * // game loop:
+ * setCameraTarget(cam, player.x, player.y)
+ * tickCamera(cam, dt)
+ * drawTileMapAt(ctx, map, cam.x, cam.y)        // smooth background
+ * // …draw entities at (e.x - cam.x, e.y - cam.y)…
+ * ```
+ */
+import { CELL } from './palette.js';
+import { drawSprite } from './renderer.js';
+/**
+ * Returns the map's full size in pixels — handy for `worldW`/`worldH` when
+ * constructing a {@link "camera" | Camera}.
+ *
+ * @example
+ * const { width, height } = tileMapWorldSize(map)
+ */
+export function tileMapWorldSize(map) {
+    return { width: map.cols * CELL, height: map.rows * CELL };
+}
+/**
+ * Renders `map` with the viewport's top-left at world pixel `(camX, camY)`.
+ * The camera position is rounded to whole pixels for crisp output, then the
+ * visible tile range (plus one overscan row/column) is drawn at
+ * `tileX * CELL - camX`, giving smooth scrolling at any pixel offset.
+ *
+ * @param viewW - Visible width in pixels (default `256`). Must be positive.
+ * @param viewH - Visible height in pixels (default `192`). Must be positive.
+ *
+ * @example
+ * drawTileMapAt(ctx, map, cam.x, cam.y)            // standard 256×192
+ * drawTileMapAt(ctx, map, cam.x, cam.y, 256, 176)  // shorter play area
+ */
+export function drawTileMapAt(ctx, map, camX, camY, viewW = 256, viewH = 192) {
+    if (viewW <= 0 || viewH <= 0) {
+        throw new Error(`drawTileMapAt: viewW and viewH must be positive, got ${viewW}×${viewH}`);
+    }
+    const ox = Math.round(camX);
+    const oy = Math.round(camY);
+    const startCol = Math.floor(ox / CELL);
+    const startRow = Math.floor(oy / CELL);
+    const cols = Math.ceil(viewW / CELL) + 1;
+    const rows = Math.ceil(viewH / CELL) + 1;
+    for (let ry = 0; ry < rows; ry++) {
+        const ty = startRow + ry;
+        if (ty < 0 || ty >= map.rows)
+            continue;
+        for (let rx = 0; rx < cols; rx++) {
+            const tx = startCol + rx;
+            if (tx < 0 || tx >= map.cols)
+                continue;
+            const tile = map.getTile(tx, ty);
+            if (tile === null)
+                continue;
+            drawSprite(ctx, tile.sprite, tx * CELL - ox, ty * CELL - oy, tile.ink, tile.paper);
+        }
+    }
+}
+//# sourceMappingURL=tilescroll.js.map

package/dist/tilescroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tilescroll.js","sourceRoot":"","sources":["../src/tilescroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG1C;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,EAAE,CAAA;AAC5D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,GAA6B,EAC7B,GAAY,EACZ,IAAY,EACZ,IAAY,EACZ,KAAK,GAAG,GAAG,EACX,KAAK,GAAG,GAAG;IAEX,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,wDAAwD,KAAK,IAAI,KAAK,EAAE,CAAC,CAAA;IAC3F,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;IAExC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,QAAQ,GAAG,EAAE,CAAA;QACxB,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,IAAI;YAAE,SAAQ;QACtC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC;YACjC,MAAM,EAAE,GAAG,QAAQ,GAAG,EAAE,CAAA;YACxB,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,IAAI;gBAAE,SAAQ;YACtC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;YAChC,IAAI,IAAI,KAAK,IAAI;gBAAE,SAAQ;YAC3B,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,GAAG,EAAE,EAAE,EAAE,GAAG,IAAI,GAAG,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QACpF,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zx-kit",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/zrebec/zx-kit.git"