@debuffjp/assets 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @debuffjp/assets
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Runtime loader for the manifest that `debuff` generates from your project's `assets/` folder. No dependencies.
+
+```ts
+import { Assets } from "@debuffjp/assets";
+import { Sprite } from "@debuffjp/core";
+
+const assets = new Assets(await (await fetch("assets/manifest.json")).json());
+await assets.load("default", ({ loaded, total }) => showProgress(loaded / total));
+
+const hero = new Sprite({ frames: assets.frames("hero") }); // hero@16x24.png, sliced on its grid
+draw.sprite(assets.frame("coin"), x, y); // any image, atlased or not
+```
+
+## Conventions (from the asset compiler)
+
+| File | Asset id | Group |
+| --- | --- | --- |
+| `assets/logo.png` | `logo` | `default` |
+| `assets/level1/map.json` | `level1/map` | `level1` |
+| `assets/hero@16x24.png` | `hero` (grid 16×24) | `default` |
+
+## API
+
+- `load(groups?, onProgress?)`: preload one or more groups
+- `fetch(id)`: lazy-load a single asset; concurrent calls share one request
+- `frame(id)`: `{ image, x, y, w, h }` for `draw.sprite`; works for atlased and standalone images
+- `frames(id)`: sprite-sheet frames from the `name@WxH` grid
+- `image(id)` (standalone images only), `json(id)`, `audio(id)`, `text(id)`, `entry(id)`, `has(id)`
+
+## Atlases
+
+The CLI packs PNGs into atlases per preload group, in dev and in builds, so a level loads one texture instead of dozens. It's lossless, with padding that prevents edge bleeding. Images over half the atlas size stay standalone. Configure or disable it in `debuff.config.ts`:
+
+```ts
+export default defineConfig({ assets: { atlas: { maxSize: 2048, padding: 2, exclude: ["ui/"] } } }); // or atlas: false
+```
+- Errors are `AssetError` with the asset `id` and a suggested fix

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+/** Runtime asset manifest and loader. The build-time compiler (see `@debuffjp/cli`)
+ *  produces the manifest; at runtime this only fetches and caches. */
+export type AssetType = "image" | "json" | "audio" | "text";
+export interface AssetEntry {
+    type: AssetType;
+    /** URL relative to the manifest's base. */
+    src: string;
+    /** Preload group; defaults to "default". */
+    group?: string;
+    /** Optional sprite-sheet grid for images. */
+    grid?: {
+        frameWidth: number;
+        frameHeight: number;
+    };
+    /** Region of `src` holding this image when it was packed into an atlas. */
+    rect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    bytes?: number;
+}
+export interface AssetManifest {
+    version: 1;
+    assets: Record<string, AssetEntry>;
+}
+export interface LoadProgress {
+    loaded: number;
+    total: number;
+}
+/** An image region, structurally compatible with `@debuffjp/core`'s `Frame`. */
+export interface ImageFrame {
+    image: HTMLImageElement;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export declare class AssetError extends Error {
+    readonly id: string;
+    constructor(id: string, message: string);
+}
+type Loaded = HTMLImageElement | ArrayBuffer | string | unknown;
+export declare class Assets {
+    readonly manifest: AssetManifest;
+    private readonly base;
+    private readonly cache;
+    private readonly pending;
+    /** Loads by URL, so assets packed into one atlas share a single request and image. */
+    private readonly byUrl;
+    constructor(manifest: AssetManifest, base?: string);
+    /** Load every asset in the given groups (default: "default"). */
+    load(groups?: string | readonly string[], onProgress?: (p: LoadProgress) => void): Promise<void>;
+    has(id: string): boolean;
+    /**
+     * The whole image element. For images packed into an atlas this would be the atlas, so it throws;
+     * use `frame(id)` (works for both) with `draw.sprite`.
+     */
+    image(id: string): HTMLImageElement;
+    /** The image region for an asset: `{ image, x, y, w, h }`, ready for `draw.sprite`. Works whether or not it was atlased. */
+    frame(id: string): ImageFrame;
+    /**
+     * Frames of a sprite sheet declared with the `name@WxH.png` convention, row-major, ready for
+     * `new Sprite({ frames })`. Works whether or not the sheet was atlased.
+     */
+    frames(id: string): ImageFrame[];
+    json<T = unknown>(id: string): T;
+    /** Raw encoded audio; decode with `@debuffjp/audio`. */
+    audio(id: string): ArrayBuffer;
+    text(id: string): string;
+    /**
+     * The asset's URL without downloading it, for streaming: `audio.stream(assets.url("music/theme"))`.
+     * Keep long tracks in a group you never `load()` (e.g. `assets/music/`) so they aren't fetched twice.
+     */
+    url(id: string): string;
+    entry(id: string): AssetEntry;
+    /** Fetch a single asset (lazy loading). Concurrent calls share one request. */
+    fetch(id: string): Promise<Loaded>;
+    private get;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;sEACsE;AACtE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,2EAA2E;IAC3E,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qBAAa,UAAW,SAAQ,KAAK;IAEjC,QAAQ,CAAC,EAAE,EAAE,MAAM;IADrB,YACW,EAAE,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAIhB;CACF;AAED,KAAK,MAAM,GAAG,gBAAgB,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhE,qBAAa,MAAM;IAOf,QAAQ,CAAC,QAAQ,EAAE,aAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,sFAAsF;IACtF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAE5D,YACW,QAAQ,EAAE,aAAa,EACf,IAAI,SAAK,EACxB;IAEJ,iEAAiE;IAC3D,IAAI,CAAC,MAAM,GAAE,MAAM,GAAG,SAAS,MAAM,EAAc,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAahH;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvB;IAED;;;OAGG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAQlC;IAED,4HAA4H;IAC5H,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAI5B;IAED;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,EAAE,CAW/B;IAED,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,CAE/B;IAED,wDAAwD;IACxD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAE7B;IAED,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEvB;IAED;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEtB;IAED,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAI5B;IAED,+EAA+E;IAC/E,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBjC;IAED,OAAO,CAAC,GAAG;CAQZ"}

package/dist/index.js

@@ -0,0 +1,156 @@
+export class AssetError extends Error {
+    id;
+    constructor(id, message) {
+        super(message);
+        this.id = id;
+        this.name = "AssetError";
+    }
+}
+export class Assets {
+    manifest;
+    base;
+    cache = new Map();
+    pending = new Map();
+    /** Loads by URL, so assets packed into one atlas share a single request and image. */
+    byUrl = new Map();
+    constructor(manifest, base = "") {
+        this.manifest = manifest;
+        this.base = base;
+    }
+    /** Load every asset in the given groups (default: "default"). */
+    async load(groups = "default", onProgress) {
+        const wanted = new Set(typeof groups === "string" ? [groups] : groups);
+        const ids = Object.entries(this.manifest.assets)
+            .filter(([, e]) => wanted.has(e.group ?? "default"))
+            .map(([id]) => id);
+        let loaded = 0;
+        onProgress?.({ loaded, total: ids.length });
+        await Promise.all(ids.map(async (id) => {
+            await this.fetch(id);
+            onProgress?.({ loaded: ++loaded, total: ids.length });
+        }));
+    }
+    has(id) {
+        return this.cache.has(id);
+    }
+    /**
+     * The whole image element. For images packed into an atlas this would be the atlas, so it throws;
+     * use `frame(id)` (works for both) with `draw.sprite`.
+     */
+    image(id) {
+        if (this.entry(id).rect) {
+            throw new AssetError(id, `Asset "${id}" is packed into an atlas. Use assets.frame("${id}") (or frames() for sprite sheets) with draw.sprite.`);
+        }
+        return this.get(id, "image");
+    }
+    /** The image region for an asset: `{ image, x, y, w, h }`, ready for `draw.sprite`. Works whether or not it was atlased. */
+    frame(id) {
+        const image = this.get(id, "image");
+        const rect = this.entry(id).rect;
+        return rect ? { image, ...rect } : { image, x: 0, y: 0, w: image.naturalWidth || image.width, h: image.naturalHeight || image.height };
+    }
+    /**
+     * Frames of a sprite sheet declared with the `name@WxH.png` convention, row-major, ready for
+     * `new Sprite({ frames })`. Works whether or not the sheet was atlased.
+     */
+    frames(id) {
+        const whole = this.frame(id);
+        const grid = this.entry(id).grid;
+        if (!grid)
+            return [whole];
+        const out = [];
+        for (let y = 0; y + grid.frameHeight <= whole.h; y += grid.frameHeight) {
+            for (let x = 0; x + grid.frameWidth <= whole.w; x += grid.frameWidth) {
+                out.push({ image: whole.image, x: whole.x + x, y: whole.y + y, w: grid.frameWidth, h: grid.frameHeight });
+            }
+        }
+        return out;
+    }
+    json(id) {
+        return this.get(id, "json");
+    }
+    /** Raw encoded audio; decode with `@debuffjp/audio`. */
+    audio(id) {
+        return this.get(id, "audio");
+    }
+    text(id) {
+        return this.get(id, "text");
+    }
+    /**
+     * The asset's URL without downloading it, for streaming: `audio.stream(assets.url("music/theme"))`.
+     * Keep long tracks in a group you never `load()` (e.g. `assets/music/`) so they aren't fetched twice.
+     */
+    url(id) {
+        return this.base + this.entry(id).src;
+    }
+    entry(id) {
+        const e = this.manifest.assets[id];
+        if (!e)
+            throw new AssetError(id, `Unknown asset "${id}". ${suggest(id, Object.keys(this.manifest.assets))}`);
+        return e;
+    }
+    /** Fetch a single asset (lazy loading). Concurrent calls share one request. */
+    fetch(id) {
+        if (this.cache.has(id))
+            return Promise.resolve(this.cache.get(id));
+        const existing = this.pending.get(id);
+        if (existing)
+            return existing;
+        const entry = this.entry(id);
+        const url = this.base + entry.src;
+        let shared = this.byUrl.get(url);
+        if (!shared) {
+            shared = loadOne(entry.type, url);
+            this.byUrl.set(url, shared);
+            shared.catch(() => this.byUrl.delete(url));
+        }
+        const p = shared
+            .then((value) => {
+            this.cache.set(id, value);
+            this.pending.delete(id);
+            return value;
+        })
+            .catch((err) => {
+            this.pending.delete(id);
+            throw new AssetError(id, `Failed to load asset "${id}" from ${url}: ${err instanceof Error ? err.message : String(err)}`);
+        });
+        this.pending.set(id, p);
+        return p;
+    }
+    get(id, type) {
+        const entry = this.entry(id);
+        if (entry.type !== type)
+            throw new AssetError(id, `Asset "${id}" is ${entry.type}, not ${type}`);
+        if (!this.cache.has(id)) {
+            throw new AssetError(id, `Asset "${id}" not loaded yet. Load its group "${entry.group ?? "default"}" first.`);
+        }
+        return this.cache.get(id);
+    }
+}
+async function loadOne(type, url) {
+    if (type === "image") {
+        const img = new Image();
+        await new Promise((resolve, reject) => {
+            img.onload = () => resolve();
+            img.onerror = () => reject(new Error("image failed to load or decode"));
+            img.src = url;
+        });
+        // decode() avoids a hitch on first draw, but it can stall indefinitely in background tabs and
+        // throttled iframes. The load event already guarantees the image is usable, so it's only a hint.
+        img.decode().catch(() => { });
+        return img;
+    }
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`HTTP ${res.status}`);
+    if (type === "json")
+        return res.json();
+    if (type === "text")
+        return res.text();
+    return res.arrayBuffer();
+}
+function suggest(id, known) {
+    const close = known.filter((k) => k.includes(id) || id.includes(k)).slice(0, 3);
+    return close.length ? `Did you mean: ${close.join(", ")}?` : `${known.length} assets in manifest.`;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@debuffjp/assets",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Manifest-driven asset loader with preload groups for debuff",
+  "keywords": [
+    "game",
+    "gamedev",
+    "game-engine",
+    "2d",
+    "html5-game",
+    "browser-game",
+    "debuff",
+    "assets",
+    "loader",
+    "preload",
+    "sprite-sheet"
+  ],
+  "license": "MIT",
+  "homepage": "https://debuff.jp",
+  "bugs": "https://github.com/debuffjp/debuff/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/debuffjp/debuff.git",
+    "directory": "packages/assets"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  }
+}