@aethervtt/shard-audio-editor 0.0.0-stage → 0.2.1

package/dist/waveform.js

@@ -0,0 +1,154 @@
+import { ShardError } from "@aethervtt/shard-core";
+async function browserDecode(bytes) {
+  if (typeof OfflineAudioContext === "undefined")
+    throw new ShardError(
+      "audio-editor/unsupported-capability",
+      "Waveform decoding is unavailable",
+      {
+        hint: "Supply a waveform decoder in this host."
+      }
+    );
+  const context = new OfflineAudioContext(1, 1, 48e3);
+  const buffer = await context.decodeAudioData(Uint8Array.from(bytes).buffer);
+  return {
+    channels: Array.from({ length: buffer.numberOfChannels }, (_, i) => buffer.getChannelData(i)),
+    sampleRate: buffer.sampleRate
+  };
+}
+function createAudioWaveformCache(assets, options = {}) {
+  const maxBytes = options.maxBytes ?? 32 * 1024 * 1024;
+  if (!Number.isSafeInteger(maxBytes) || maxBytes < 0)
+    throw new ShardError("audio-editor/invalid-document", "Waveform cache size must be nonnegative");
+  const entries = /* @__PURE__ */ new Map();
+  const controller = new AbortController();
+  let size = 0;
+  let generation = 0;
+  let scope = assets.scope;
+  let disposed = false;
+  const clear = () => {
+    entries.clear();
+    size = 0;
+    generation++;
+  };
+  const unsubscribe = assets.subscribe?.(() => clear());
+  const assertLive = (signal) => {
+    if (disposed || signal?.aborted)
+      throw new ShardError("audio-editor/disposed", "Waveform request was cancelled", {
+        hint: "Request a waveform from an active editor session."
+      });
+  };
+  return {
+    get bytes() {
+      return size;
+    },
+    get count() {
+      return entries.size;
+    },
+    clear,
+    async get(id, bins, signal, channel = 0) {
+      assertLive(signal);
+      if (!Number.isSafeInteger(bins) || bins < 1 || bins > 65536 || !Number.isSafeInteger(channel) || channel < 0)
+        throw new ShardError(
+          "audio-editor/invalid-document",
+          "Invalid waveform resolution or channel"
+        );
+      if (scope !== assets.scope) {
+        scope = assets.scope;
+        clear();
+      }
+      const request = generation;
+      const combined = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;
+      const metadata = await assets.get(id, combined);
+      assertLive(combined);
+      if (scope !== assets.scope || request !== generation)
+        throw new ShardError(
+          "audio-editor/asset-unavailable",
+          "Asset scope or revision changed during lookup",
+          { path: id }
+        );
+      const key = JSON.stringify([scope, id, metadata.revision, channel, bins]);
+      const cached = entries.get(key);
+      if (cached) {
+        entries.delete(key);
+        entries.set(key, cached);
+        return cached.waveform;
+      }
+      const content = await assets.resolve(id, combined);
+      try {
+        assertLive(combined);
+        if (!content.bytes)
+          throw new ShardError(
+            "audio-editor/unsupported-capability",
+            "Waveforms require authorized encoded bytes",
+            {
+              path: id,
+              hint: "Have the host asset resolver provide bytes for waveform requests."
+            }
+          );
+        const decoded = await (options.decode ?? browserDecode)(content.bytes, combined);
+        assertLive(combined);
+        if (scope !== assets.scope || request !== generation)
+          throw new ShardError(
+            "audio-editor/asset-unavailable",
+            "Asset scope or revision changed during decoding",
+            { path: id }
+          );
+        const samples = decoded.channels[channel];
+        if (!samples || !Number.isFinite(decoded.sampleRate) || decoded.sampleRate <= 0)
+          throw new ShardError(
+            "audio-editor/asset-unavailable",
+            "Requested waveform channel is unavailable",
+            { path: id }
+          );
+        const peaks = new Float32Array(bins * 2);
+        for (let bin = 0; bin < bins; bin++) {
+          const start = Math.floor(bin * samples.length / bins);
+          const end = Math.min(
+            samples.length,
+            Math.max(start + 1, Math.floor((bin + 1) * samples.length / bins))
+          );
+          let min = 0;
+          let max = 0;
+          for (let index = start; index < end; index++) {
+            const value = samples[index];
+            if (Number.isFinite(value)) {
+              min = Math.min(min, value);
+              max = Math.max(max, value);
+            }
+          }
+          peaks[bin * 2] = min;
+          peaks[bin * 2 + 1] = max;
+        }
+        const waveform = {
+          peaks,
+          duration: samples.length / decoded.sampleRate,
+          sampleRate: decoded.sampleRate
+        };
+        if (peaks.byteLength <= maxBytes) {
+          while (size + peaks.byteLength > maxBytes) {
+            const oldest = entries.keys().next().value;
+            if (oldest === void 0) break;
+            size -= entries.get(oldest).waveform.peaks.byteLength;
+            entries.delete(oldest);
+          }
+          size -= entries.get(key)?.waveform.peaks.byteLength ?? 0;
+          entries.set(key, { id, waveform });
+          size += peaks.byteLength;
+        }
+        return waveform;
+      } finally {
+        content.release?.();
+      }
+    },
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      controller.abort();
+      unsubscribe?.();
+      clear();
+    }
+  };
+}
+export {
+  createAudioWaveformCache
+};

package/package.json

@@ -1,6 +1,85 @@
 {
   "name": "@aethervtt/shard-audio-editor",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./model": {
+      "types": "./dist/model.d.ts",
+      "default": "./dist/model.js"
+    },
+    "./dom": {
+      "types": "./dist/dom.d.ts",
+      "default": "./dist/dom.js"
+    },
+    "./panels/event": {
+      "types": "./dist/panels/event.d.ts",
+      "default": "./dist/panels/event.js"
+    },
+    "./panels/mixer": {
+      "types": "./dist/panels/mixer.d.ts",
+      "default": "./dist/panels/mixer.js"
+    },
+    "./panels/music": {
+      "types": "./dist/panels/music.d.ts",
+      "default": "./dist/panels/music.js"
+    },
+    "./panels/parameters": {
+      "types": "./dist/panels/parameters.d.ts",
+      "default": "./dist/panels/parameters.js"
+    },
+    "./panels/library": {
+      "types": "./dist/panels/library.d.ts",
+      "default": "./dist/panels/library.js"
+    },
+    "./panels/diagnostics": {
+      "types": "./dist/panels/diagnostics.d.ts",
+      "default": "./dist/panels/diagnostics.js"
+    },
+    "./preview": {
+      "types": "./dist/preview.d.ts",
+      "default": "./dist/preview.js"
+    },
+    "./project": {
+      "types": "./dist/project.d.ts",
+      "default": "./dist/project.js"
+    },
+    "./preview-render": {
+      "types": "./dist/preview-render.d.ts",
+      "default": "./dist/preview-render.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@aethervtt/shard-assets": "0.2.1",
+    "@aethervtt/shard-audio": "0.2.1",
+    "@aethervtt/shard-core": "0.2.1",
+    "@aethervtt/shard-platform": "0.2.1",
+    "@aethervtt/shard-platform-web": "0.2.1",
+    "@aethervtt/shard-project": "0.2.1",
+    "@aethervtt/shard-runtime": "0.2.1",
+    "@aethervtt/shard-transform": "0.2.1",
+    "@aethervtt/shard-audio-preview": "0.2.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aethervtt/shard.git",
+    "directory": "packages/audio-editor"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "shard": {
+    "buildSha": "772eb0d2b8a5fc499105708f4ae92c58788cc9ea"
+  }
+}