@dice-o-rolla/dice-assets 0.2.0

package/dist/web-audio-player.js

@@ -0,0 +1,110 @@
+export class WebAudioSpritePlayer {
+    registry;
+    #context;
+    #fetch;
+    #random;
+    #buffers = new Map();
+    #loading = new Map();
+    #voices = new Map();
+    constructor(registry, options) {
+        this.registry = registry;
+        this.#context = options.context;
+        this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.#random = options.random ?? Math.random;
+    }
+    async preloadBank(bankId) {
+        const bank = this.#requireBank(bankId);
+        await this.#loadSprite(this.#requireSprite(bank.spriteId));
+    }
+    async playImpact(options) {
+        await Promise.all([
+            this.playBank(options.dieMaterialBankId, options.force),
+            ...(options.surfaceMaterialBankId === undefined
+                ? []
+                : [this.playBank(options.surfaceMaterialBankId, options.force)]),
+        ]);
+    }
+    async playBank(bankId, force) {
+        const bank = this.#requireBank(bankId);
+        const maxVoices = bank.maxVoices ?? 6;
+        if ((this.#voices.get(bankId) ?? 0) >= maxVoices)
+            return false;
+        const sprite = this.#requireSprite(bank.spriteId);
+        const clipId = chooseClip(bank, sprite, this.#random());
+        const clip = sprite.clips[clipId];
+        if (clip === undefined)
+            return false;
+        const buffer = await this.#loadSprite(sprite);
+        const source = this.#context.createBufferSource();
+        const gain = this.#context.createGain();
+        source.buffer = buffer;
+        source.playbackRate.value = centsToRate(randomSigned(this.#random) * (bank.pitchVariationCents ?? 24));
+        gain.gain.value = resolveImpactGain(bank, clip, force, randomSigned(this.#random));
+        source.connect(gain);
+        gain.connect(this.#context.destination);
+        this.#voices.set(bankId, (this.#voices.get(bankId) ?? 0) + 1);
+        source.addEventListener('ended', () => {
+            this.#voices.set(bankId, Math.max(0, (this.#voices.get(bankId) ?? 1) - 1));
+        }, { once: true });
+        source.start(0, clip.offsetSeconds, clip.durationSeconds);
+        return true;
+    }
+    async #loadSprite(sprite) {
+        const cached = this.#buffers.get(sprite.id);
+        if (cached !== undefined)
+            return cached;
+        const pending = this.#loading.get(sprite.id);
+        if (pending !== undefined)
+            return pending;
+        const promise = this.#fetch(sprite.audio.uri)
+            .then((response) => response.arrayBuffer())
+            .then((data) => this.#context.decodeAudioData(data))
+            .then((buffer) => {
+            this.#buffers.set(sprite.id, buffer);
+            this.#loading.delete(sprite.id);
+            return buffer;
+        }, (error) => {
+            this.#loading.delete(sprite.id);
+            throw error;
+        });
+        this.#loading.set(sprite.id, promise);
+        return promise;
+    }
+    #requireBank(id) {
+        const bank = this.registry.audioBanks.get(id);
+        if (bank === undefined)
+            throw new Error(`Unknown audio bank: ${id}`);
+        return bank;
+    }
+    #requireSprite(id) {
+        const sprite = this.registry.audio.get(id);
+        if (sprite === undefined)
+            throw new Error(`Unknown audio sprite: ${id}`);
+        return sprite;
+    }
+}
+export function resolveImpactGain(bank, clip, force, signedVariation = 0) {
+    const forceSpan = bank.forceRange[1] - bank.forceRange[0];
+    const normalized = Math.min(1, Math.max(0, (force - bank.forceRange[0]) / forceSpan));
+    const shaped = Math.sqrt(normalized);
+    const base = bank.gainRange[0] + shaped * (bank.gainRange[1] - bank.gainRange[0]);
+    const variation = 1 + signedVariation * (bank.gainVariation ?? 0.04);
+    return Math.max(0, base * (clip.gain ?? 1) * variation);
+}
+function chooseClip(bank, sprite, random) {
+    const weighted = bank.clipIds.map((id) => ({ id, weight: sprite.clips[id]?.weight ?? 1 }));
+    const total = weighted.reduce((sum, entry) => sum + entry.weight, 0);
+    let cursor = random * total;
+    for (const entry of weighted) {
+        cursor -= entry.weight;
+        if (cursor <= 0)
+            return entry.id;
+    }
+    return bank.clipIds.at(-1) ?? '';
+}
+function centsToRate(cents) {
+    return 2 ** (cents / 1_200);
+}
+function randomSigned(random) {
+    return random() * 2 - 1;
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@dice-o-rolla/dice-assets",
+  "version": "0.2.0",
+  "description": "Optional Web Audio and KTX2/PBR asset system for Dice O Rolla.",
+  "keywords": [
+    "assets",
+    "dice",
+    "skins",
+    "sounds",
+    "typescript"
+  ],
+  "homepage": "https://github.com/creepiest-space/dice-o-rolla#readme",
+  "bugs": {
+    "url": "https://github.com/creepiest-space/dice-o-rolla/issues"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/creepiest-space/dice-o-rolla.git",
+    "directory": "packages/dice-assets"
+  },
+  "files": [
+    "dist",
+    "assets/runtime",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./catalog.json": "./assets/runtime/catalog.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@dice-o-rolla/dice-renderer-three": "0.2.0",
+    "@types/three": "^0.185.0",
+    "three": "^0.185.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}