@viji-dev/core 0.7.4 → 0.7.6

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

@@ -1,4 +1,4 @@
-import { g as kn } from "./index-DmQ5U_50.js";
+import { g as kn } from "./index-DkwlRK6X.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-B9C3y5iZ.js.map

package/dist/{index-DmQ5U_50.js → index-DkwlRK6X.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-D4GXsHWY.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-B9C3y5iZ.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-DkwlRK6X.js.map

package/dist/index.d.ts

@@ -1442,7 +1442,13 @@ declare interface NumberConfig {
     min?: number;
     /** Inclusive maximum value. Default: `100`. */
     max?: number;
-    /** Increment between values. Default: `1`. */
+    /**
+     * Increment between values. When omitted, auto-derives from `min`/`max` as
+     * the largest power of 10 giving ~100 positions across the range (e.g.,
+     * range `0..1` → `0.01`, range `0..100` → `1`, range `0.1..5` → `0.01`).
+     * Specify explicitly for integer counts (`step: 1`) or fine precision
+     * (`step: 0.001`).
+     */
     step?: number;
     /** Display name shown next to the input in the parameter UI. Required. */
     label: string;
@@ -1521,6 +1527,13 @@ declare type ParameterCategory = 'audio' | 'video' | 'interaction' | 'general';
 export declare interface ParameterConfig {
     min?: number;
     max?: number;
+    /**
+     * Increment between values. When omitted, auto-derives from `min`/`max` as
+     * the largest power of 10 giving ~100 positions across the range (e.g.,
+     * range `0..1` → `0.01`, range `0..100` → `1`, range `0.1..5` → `0.01`).
+     * Specify explicitly for integer counts (`step: 1`) or fine precision
+     * (`step: 0.001`).
+     */
     step?: number;
     options?: string[] | number[];
     maxLength?: number;
@@ -1721,6 +1734,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 +1746,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 +1786,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 +1818,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;
@@ -2170,7 +2214,13 @@ declare interface SliderConfig {
     min?: number;
     /** Inclusive maximum value of the slider. Default: `100`. */
     max?: number;
-    /** Increment between values. Default: `1`. */
+    /**
+     * Increment between values. When omitted, auto-derives from `min`/`max` as
+     * the largest power of 10 giving ~100 positions across the range (e.g.,
+     * range `0..1` → `0.01`, range `0..100` → `1`, range `0.1..5` → `0.01`,
+     * range `0..1000` → `10`). Specify explicitly for integer counts
+     * (`step: 1` on a range of `3..30`) or fine precision (`step: 0.001`).
+     */
     step?: number;
     /** Display name shown next to the control in the parameter UI. Required. */
     label: string;

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-DkwlRK6X.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.6",
+  "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"
+  }
+}