@viji-dev/core 0.7.4 → 0.7.5

package/dist/assets/{viji.worker-Dq2EQ0Wd.js → viji.worker-CXp6CGrq.js}

@@ -7351,6 +7351,15 @@ class C1 {
   currentSourceMap = null;
   /** Lifecycle marker; flipped by the runtime after first successful render. */
   hasProducedFirstFrame = !1;
+  /**
+   * Monotonic envelope sequence number. Used to give every outbound envelope
+   * a unique `id` even when two fires share the same `signatureHash` and
+   * `firstSeenAt` (which they do under cumulative semantics — `firstSeenAt`
+   * is constant across windows for a recurring signature, so the sequence
+   * counter is what disambiguates the leading-edge of burst N from the
+   * trailing rollup of burst N-1).
+   */
+  envelopeSeq = 0;
   constructor(e, n = {}) {
     this.config = { ...R1, ...n }, this.post = e, this.errorChannel = new Ti(
       this.config.errorCoalescingWindowMs,
@@ -7536,7 +7545,7 @@ class C1 {
   postEnvelope(e, n) {
     this.post({
       type: e,
-      id: `${e}_${n.signatureHash}_${n.firstSeenAt}`,
+      id: `${e}_${n.signatureHash}_${++this.envelopeSeq}`,
       timestamp: Date.now(),
       data: n
     });
@@ -7552,30 +7561,38 @@ class Ti {
   setWindowMs(e) {
     this.windowMs = e;
   }
+  /**
+   * `true` iff this signature has been observed at least once in the current
+   * session. Used by the console rate-cap to charge the per-second budget
+   * only for genuinely new signatures (a known signature in a fresh burst
+   * is not a new signature).
+   */
   hasPending(e) {
     return this.pending.has(e);
   }
   emit(e, n) {
     const s = Date.now(), i = this.pending.get(e);
     if (i) {
-      i.payload.count++, i.payload.lastSeenAt = s;
+      if (i.payload.count++, i.payload.lastSeenAt = s, i.timer !== null) return;
+      this.emitFn(i.payload), i.lastEmittedCount = i.payload.count, i.timer = setTimeout(() => this.flush(e), this.windowMs);
       return;
     }
     n.count = 1, n.firstSeenAt = s, n.lastSeenAt = s, this.emitFn(n);
     const o = setTimeout(() => this.flush(e), this.windowMs);
-    this.pending.set(e, { payload: n, timer: o });
+    this.pending.set(e, { payload: n, timer: o, lastEmittedCount: 1 });
   }
   flush(e) {
     const n = this.pending.get(e);
-    n && (this.pending.delete(e), clearTimeout(n.timer), n.payload.count > 1 && this.emitFn(n.payload));
+    !n || n.timer === null || (clearTimeout(n.timer), n.timer = null, n.payload.count > n.lastEmittedCount && (this.emitFn(n.payload), n.lastEmittedCount = n.payload.count));
   }
   flushAndClear() {
-    for (const [e] of this.pending)
-      this.flush(e);
+    for (const e of this.pending.values())
+      e.timer !== null && (clearTimeout(e.timer), e.timer = null, e.payload.count > e.lastEmittedCount && this.emitFn(e.payload));
+    this.pending.clear();
   }
   destroy() {
     for (const e of this.pending.values())
-      clearTimeout(e.timer);
+      e.timer !== null && clearTimeout(e.timer);
     this.pending.clear();
   }
 }
@@ -25076,4 +25093,4 @@ throw new Error("Scene code must define a render function");`, o = Object.getPro
   }
 }
 self.setSceneCode = Md;
-//# sourceMappingURL=viji.worker-Dq2EQ0Wd.js.map
+//# sourceMappingURL=viji.worker-CXp6CGrq.js.map

package/dist/docs-api.js

@@ -1,7 +1,7 @@
 export const docsApi = {
   "version": "1.1.0",
   "coreVersion": "0.7.4",
-  "generatedAt": "2026-05-21T11:34:26.940Z",
+  "generatedAt": "2026-05-22T14:07:51.895Z",
   "navigation": [
     {
       "id": "getting-started",

package/dist/{essentia-wasm.web-BgpNs-yB.js → essentia-wasm.web-Bh9tTilM.js}

@@ -1,4 +1,4 @@
-import { g as kn } from "./index-DmQ5U_50.js";
+import { g as kn } from "./index-B1JJ8Mko.js";
 function jn(Oe, ot) {
   for (var ve = 0; ve < ot.length; ve++) {
     const Z = ot[ve];
@@ -3374,4 +3374,4 @@ const xn = /* @__PURE__ */ kn(yi), Ln = /* @__PURE__ */ jn({
 export {
   Ln as e
 };
-//# sourceMappingURL=essentia-wasm.web-BgpNs-yB.js.map
+//# sourceMappingURL=essentia-wasm.web-Bh9tTilM.js.map

package/dist/{index-DmQ5U_50.js → index-B1JJ8Mko.js}

@@ -536,7 +536,7 @@ class DB {
       }
   }
 }
-const oB = "" + new URL("assets/viji.worker-Dq2EQ0Wd.js", import.meta.url).href, hB = new URL("assets/wasm/vision_wasm_internal.js", import.meta.url).href, RB = new URL("assets/wasm/vision_wasm_internal.wasm", import.meta.url).href, wB = new URL("assets/wasm/vision_wasm_nosimd_internal.js", import.meta.url).href, sB = new URL("assets/wasm/vision_wasm_nosimd_internal.wasm", import.meta.url).href;
+const oB = "" + new URL("assets/viji.worker-CXp6CGrq.js", import.meta.url).href, hB = new URL("assets/wasm/vision_wasm_internal.js", import.meta.url).href, RB = new URL("assets/wasm/vision_wasm_internal.wasm", import.meta.url).href, wB = new URL("assets/wasm/vision_wasm_nosimd_internal.js", import.meta.url).href, sB = new URL("assets/wasm/vision_wasm_nosimd_internal.wasm", import.meta.url).href;
 class FB {
   constructor(A, B, I) {
     this.iframeManager = A, this.sceneCode = B, this.init = I;
@@ -1520,7 +1520,7 @@ class YB {
     if (!this.isInitialized)
       return this.initPromise ? this.initPromise : (this.initPromise = (async () => {
         try {
-          const A = await import("./essentia.js-core.es-CC_3Ap1i.js"), B = await import("./essentia-wasm.web-BgpNs-yB.js").then((g) => g.e), I = A.Essentia || A.default?.Essentia || A.default;
+          const A = await import("./essentia.js-core.es-CC_3Ap1i.js"), B = await import("./essentia-wasm.web-Bh9tTilM.js").then((g) => g.e), I = A.Essentia || A.default?.Essentia || A.default;
           let Q = B.default || B.EssentiaWASM || B.default?.EssentiaWASM;
           if (!Q)
             throw new Error("WASM module not found - check essentia-wasm.web.js export");
@@ -8406,4 +8406,4 @@ export {
   S as b,
   vB as g
 };
-//# sourceMappingURL=index-DmQ5U_50.js.map
+//# sourceMappingURL=index-B1JJ8Mko.js.map

package/dist/index.d.ts

@@ -1721,6 +1721,10 @@ export declare type Resolution = {
  * inspection, a per-argument byte cap (`consoleArgMaxBytes`), and an argument
  * count cap (`consoleMaxArgsPerCall`). High-cardinality logs are rate-limited
  * by `consoleMaxUniqueSignaturesPerSecond`.
+ *
+ * Coalescing semantics match `SceneRuntimeError`: `count` and `firstSeenAt`
+ * are cumulative for the scene session (monotonically non-decreasing across
+ * coalescing windows), reset only when the worker terminates.
  */
 export declare interface SceneConsoleMessage {
     /** Console method invoked. */
@@ -1729,9 +1733,19 @@ export declare interface SceneConsoleMessage {
     args: string[];
     /** Stable hash of `level` and the stringified arguments, used for coalescing. */
     signatureHash: string;
-    /** Number of occurrences of this signature accumulated in the current window. */
+    /**
+     * Cumulative number of occurrences of this signature since it was first
+     * seen in this scene session. Monotonically non-decreasing across
+     * coalescing windows; each fire carries the up-to-date total. Consumers
+     * that maintain a per-signature view should REPLACE their stored count
+     * with this value on each fire, not add to it.
+     */
     count: number;
-    /** Millisecond timestamp of the first occurrence of this signature in the current window. */
+    /**
+     * Millisecond timestamp of the FIRST occurrence of this signature in this
+     * scene session. Set once and unchanged for every subsequent fire of the
+     * same signature.
+     */
     firstSeenAt: number;
     /** Millisecond timestamp of the most recent occurrence. */
     lastSeenAt: number;
@@ -1759,9 +1773,15 @@ export declare type SceneErrorCode = 'SCENE_CODE_ERROR' | 'RENDER_ERROR' | 'UNCA
 /**
  * Structured scene runtime error envelope surfaced via `VijiCore.onSceneRuntimeError`.
  *
- * Identical signatures are coalesced inside the worker: the first occurrence in
- * a window fires with `count: 1`, subsequent occurrences increment `count`, and
- * a trailing rollup fires at window close if more than one occurrence was seen.
+ * Identical signatures are coalesced inside the worker. The first ever
+ * occurrence of a signature in this scene session fires immediately with
+ * `count: 1`; further occurrences within the coalescing window are absorbed
+ * silently and emitted as a single trailing rollup with the up-to-date
+ * cumulative count at window close. Subsequent bursts of the same signature
+ * refire a leading edge with the up-to-date cumulative count and re-arm the
+ * rollup timer. `count` and `firstSeenAt` are cumulative for the scene
+ * session — they persist across coalescing windows and are reset only when
+ * the worker terminates (scene teardown).
  *
  * The host-side `console.error('Scene error:', data)` tee continues to fire
  * alongside the listener (never silenced based on listener presence).
@@ -1785,9 +1805,20 @@ export declare interface SceneRuntimeError {
     code: SceneErrorCode;
     /** Stable hash of `message` and the first artist stack frame, used for coalescing. */
     signatureHash: string;
-    /** Number of occurrences of this signature accumulated in the current window. */
+    /**
+     * Cumulative number of occurrences of this signature since it was first
+     * seen in this scene session. Monotonically non-decreasing across
+     * coalescing windows; each fire carries the up-to-date total. Consumers
+     * that maintain a per-signature view should REPLACE their stored count
+     * with this value on each fire, not add to it.
+     */
     count: number;
-    /** Millisecond timestamp of the first occurrence of this signature in the current window. */
+    /**
+     * Millisecond timestamp of the FIRST occurrence of this signature in this
+     * scene session. Set once and unchanged for every subsequent fire of the
+     * same signature — `Date.now() - firstSeenAt` is the lifetime of the
+     * signature in this session, useful for chronicity reasoning.
+     */
     firstSeenAt: number;
     /** Millisecond timestamp of the most recent occurrence. */
     lastSeenAt: number;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as a, V as i, a as s, b as e } from "./index-DmQ5U_50.js";
+import { A as a, V as i, a as s, b as e } from "./index-B1JJ8Mko.js";
 export {
   a as AudioSystem,
   i as VERSION,

package/package.json

@@ -1,100 +1,100 @@
-{
-  "name": "@viji-dev/core",
-  "version": "0.7.4",
-  "description": "Universal execution engine for Viji Creative scenes",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./artist-global": {
-      "types": "./dist/artist-global.d.ts"
-    },
-    "./artist-dts": {
-      "import": "./dist/artist-dts.js",
-      "types": "./dist/artist-dts.d.ts"
-    },
-    "./artist-jsdoc": {
-      "types": "./dist/artist-jsdoc.d.ts"
-    },
-    "./artist-js-ambient": {
-      "types": "./dist/artist-js-ambient.d.ts"
-    },
-    "./artist-dts-p5": {
-      "import": "./dist/artist-dts-p5.js",
-      "types": "./dist/artist-dts-p5.d.ts"
-    },
-    "./artist-global-p5": {
-      "types": "./dist/artist-global-p5.d.ts"
-    },
-    "./shader-uniforms": {
-      "import": "./dist/shader-uniforms.js",
-      "types": "./dist/shader-uniforms.d.ts"
-    },
-    "./docs-api": {
-      "import": "./dist/docs-api.js",
-      "types": "./dist/docs-api.d.ts"
-    }
-  },
-  "files": [
-    "dist/*.js",
-    "dist/*.d.ts",
-    "dist/assets",
-    "!dist/**/*.map",
-    "README.md"
-  ],
-  "scripts": {
-    "prebuild": "node scripts/prebuild-clean.mjs",
-    "build": "vite build && node scripts/copy-tasks-assets.mjs && node scripts/build-artist-types.mjs && node scripts/build-docs-api.mjs",
-    "build:docs": "node scripts/build-docs-api.mjs",
-    "lint:ai-prompts-drift": "node scripts/lint-ai-prompts-drift.mjs",
-    "dev": "vite build --watch",
-    "integration": "vite --config integration-example/vite.config.ts",
-    "test": "vitest",
-    "test:coverage": "vitest --coverage",
-    "type-check": "tsc --noEmit",
-    "lint": "eslint src --ext .ts"
-  },
-  "keywords": [
-    "viji",
-    "creative",
-    "webgl",
-    "audio-reactive",
-    "canvas",
-    "webworker"
-  ],
-  "author": "Viji Team",
-  "license": "SEE LICENSE IN LICENSE",
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/p5": "^1.7.6",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "@vitest/coverage-v8": "^1.0.0",
-    "dts-bundle-generator": "^9.5.1",
-    "eslint": "^8.0.0",
-    "github-slugger": "^2.0.0",
-    "happy-dom": "^18.0.1",
-    "mdast-util-to-string": "^4.0.0",
-    "remark-parse": "^11.0.0",
-    "typescript": "^5.0.0",
-    "unified": "^11.0.5",
-    "vite": "^5.0.0",
-    "vite-plugin-dts": "^3.0.0",
-    "vitest": "^1.0.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@mediapipe/tasks-vision": "^0.10.20",
-    "@noble/curves": "^2.2.0",
-    "essentia.js": "^0.1.3",
-    "fft.js": "^4.0.4",
-    "sucrase": "^3.35.1"
-  }
-}
+{
+  "name": "@viji-dev/core",
+  "version": "0.7.5",
+  "description": "Universal execution engine for Viji Creative scenes",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./artist-global": {
+      "types": "./dist/artist-global.d.ts"
+    },
+    "./artist-dts": {
+      "import": "./dist/artist-dts.js",
+      "types": "./dist/artist-dts.d.ts"
+    },
+    "./artist-jsdoc": {
+      "types": "./dist/artist-jsdoc.d.ts"
+    },
+    "./artist-js-ambient": {
+      "types": "./dist/artist-js-ambient.d.ts"
+    },
+    "./artist-dts-p5": {
+      "import": "./dist/artist-dts-p5.js",
+      "types": "./dist/artist-dts-p5.d.ts"
+    },
+    "./artist-global-p5": {
+      "types": "./dist/artist-global-p5.d.ts"
+    },
+    "./shader-uniforms": {
+      "import": "./dist/shader-uniforms.js",
+      "types": "./dist/shader-uniforms.d.ts"
+    },
+    "./docs-api": {
+      "import": "./dist/docs-api.js",
+      "types": "./dist/docs-api.d.ts"
+    }
+  },
+  "files": [
+    "dist/*.js",
+    "dist/*.d.ts",
+    "dist/assets",
+    "!dist/**/*.map",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/prebuild-clean.mjs",
+    "build": "vite build && node scripts/copy-tasks-assets.mjs && node scripts/build-artist-types.mjs && node scripts/build-docs-api.mjs",
+    "build:docs": "node scripts/build-docs-api.mjs",
+    "lint:ai-prompts-drift": "node scripts/lint-ai-prompts-drift.mjs",
+    "dev": "vite build --watch",
+    "integration": "vite --config integration-example/vite.config.ts",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "viji",
+    "creative",
+    "webgl",
+    "audio-reactive",
+    "canvas",
+    "webworker"
+  ],
+  "author": "Viji Team",
+  "license": "SEE LICENSE IN LICENSE",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/p5": "^1.7.6",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "dts-bundle-generator": "^9.5.1",
+    "eslint": "^8.0.0",
+    "github-slugger": "^2.0.0",
+    "happy-dom": "^18.0.1",
+    "mdast-util-to-string": "^4.0.0",
+    "remark-parse": "^11.0.0",
+    "typescript": "^5.0.0",
+    "unified": "^11.0.5",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^3.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@mediapipe/tasks-vision": "^0.10.20",
+    "@noble/curves": "^2.2.0",
+    "essentia.js": "^0.1.3",
+    "fft.js": "^4.0.4",
+    "sucrase": "^3.35.1"
+  }
+}