@codexo/exojs 0.8.2 → 0.8.4

package/CHANGELOG.md

@@ -4,6 +4,130 @@ All notable changes to ExoJS are documented in this file.
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.4] - 2026-05-14
+
+### Site / Guide
+
+- **Full English Guide complete through Parts 3–8.** Drawing (5 chapters),
+  Input (4), Audio (4), Effects (3), Advanced (5), and Recipes (8) are now
+  written, editorially consistent, and source-verified against the engine
+  API as shipped in v0.8.3.
+
+- **v0.8.3 feature chapters integrated.** Audio-reactive visualization (5.5),
+  Custom mesh shaders (6.4), and Render pipeline debugging (7.6) reflect the
+  `BeatDetector` visual getters, `AudioAnalyser` mel/log spectrum API,
+  `MeshShader` dual GLSL + WGSL class shape, and `RenderPassInspectorLayer`.
+
+- **Full-guide editorial and source/API verification pass.** All 38 drafted
+  chapters verified for internal consistency, correct API surface references,
+  and accurate example cross-links. Terminology, heading conventions, and
+  cross-part forward/backward references aligned in a single pass.
+
+- **39 English Guide routes verified across dark/light and desktop/mobile
+  screenshot matrix.** 156/156 captures successful (39 routes × 2 themes ×
+  2 viewports).
+
+### Release Tooling
+
+- **`scripts/release.mjs` replaced by `scripts/release.ts`.** Script is now
+  type-checked as part of the TypeScript codebase.
+
+- **`scripts/generate-release-notes.ts`.** New standalone tool that extracts
+  a version section from `CHANGELOG.md`, resolves the previous semver tag from
+  git history or the changelog, fills the `.github/templates/release-notes.md`
+  template, and writes the result to a specified output path. Exposed as
+  `npm run release:notes`.
+
+- **GitHub Releases now receive populated changelog-driven markdown bodies.**
+  The CI release workflow calls `release:notes` and passes the rendered file
+  to `gh release create --notes-file`.
+
+- **Historical tag support.** `release:notes` can generate notes for any past
+  tag (e.g., `v0.8.2`, `v0.8.3`) — useful for backfilling GitHub Release pages.
+
+- **Windows-safe `npm pack --dry-run` in `verify:package`.** The `--cache`
+  flag now points to a project-local `.npm-cache` directory, avoiding the
+  cross-user npm cache permission error that affected `verify:release` on
+  Windows CI.
+
+### Verification
+
+- Engine: typecheck clean, lint:strict 0/0, 1338/1338 tests, `verify:release` green.
+- Site: 494-page build clean, `check-ts` 0 errors / 0 warnings.
+- Screenshot smoke: 36/36. Guide visual matrix: 156/156 captures.
+
+## [0.8.3] - 2026-05-10
+
+### Engine — Rendering
+
+- **`MeshShader` class with dual GLSL + WGSL support.** The 0.8.2
+  `MeshShaderConfig` plain interface is replaced by a `MeshShader` class
+  accepting `glsl: { vertex, fragment }` and/or `wgsl` source. The WebGPU
+  mesh renderer now has a parallel render path for custom-shader meshes
+  inside the same render pass, switching pipeline + bind groups between
+  batched default draws and per-shader custom draws. New methods
+  `getDeclaredUniforms()` and `detectUniformDrift()` parse uniform
+  declarations from both languages for CI-style drift checking. **Breaking
+  change against the 0.8.2 plain-interface shape; clean break, no
+  backwards-compat shim — the 0.8.x series is pre-1.0.**
+
+- **`DataTexture` for CPU-uploaded GPU textures.** New primitive whose
+  pixels live in a CPU-side typed array. Mutate the `buffer` directly and
+  call `commit()` to upload the whole array, or `commitRect(x, y, w, h)`
+  for partial uploads (cheaper for ring-buffer patterns like
+  spectrograms). Formats: `r8` / `r32f` / `rgba8` / `rgba32f`; TypeScript
+  narrows the buffer typed-array kind from the format. Bring-your-own
+  buffer via `options.data` (`Uint8Array | Float32Array | ArrayBuffer`)
+  for SharedArrayBuffer / Worker / pool scenarios. Extends `Texture` so
+  it's accepted everywhere a `Texture` is.
+
+### Engine — Audio
+
+- **`BeatDetector` visual getters for per-frame polling.** New derived
+  getters `pulse`, `barPulse`, `justBeat`, `secondsSinceLastBeat` and
+  method `subdivisionPhase(division)`. All pure derivations from existing
+  state — no new event-handling glue required for typical "pulse on the
+  beat" / "trigger on every 16th note" visuals. Mutable fields
+  `pulseHalfLife` (default 0.15s), `barPulseHalfLife` (0.3s), and
+  `justBeatWindow` (0.03s) tune the envelopes.
+
+- **`AudioAnalyser` mel and log spectrum mapping.** New methods
+  `getSpectrumMel` / `getSpectrumMelFloat` / `getSpectrumLog` /
+  `getSpectrumLogFloat` produce perceptually-weighted or octave-uniform
+  band sequences from the linear FFT bins. Filterbanks are built from
+  the previously-orphaned `dsp/mel.ts` utilities and cached per
+  `(bands, fMin, fMax)` combination — rebuild only on parameter change.
+  Default 32 bands, 20 Hz to 20 kHz (clamped to nyquist).
+
+- **`source` as constructor option for `AudioAnalyser` and `BeatDetector`.**
+  Additive ergonomic for one-shot construction:
+  `new AudioAnalyser({ source: music, fftSize: 1024 })`. The setter
+  remains usable for runtime source switches.
+
+### Engine — Debug
+
+- **`RenderPassInspectorLayer`.** New debug layer (in the
+  `@codexo/exojs/debug` subpath) that lists every `RenderNode` with an
+  active filter chain each frame, showing total pass count, per-drawable
+  filter sequence, bounding-box dimensions, and mask/cache flags. For
+  deep per-pass inspection (intermediate render-target contents, shader
+  source, uniform values), use Spector.js or Chrome DevTools' WebGPU
+  panel — the engine now emits debug-group labels around filter and
+  mesh-custom-shader passes (`WebGpuShaderFilter pass`,
+  `MeshShader (custom)`, `WebGpuMaskCompositor pass`) so external capture
+  tools display meaningful pass names.
+
+### Site / Docs
+
+- New guide chapter stubs: `6.4 Custom mesh shaders`,
+  `5.5 Audio-reactive visualization`, `7.6 Render pipeline debugging`.
+- API doc auto-regenerated for `MeshShader` and `DataTexture`.
+
+### Verification
+
+- Engine: 103/103 suites, 1338/1338 tests, lint:strict 0/0, typecheck clean.
+- Site: build green (494 pages), check-ts 0/0.
+
 ## [0.8.2] - 2026-05-09
 
 ### Engine

package/dist/esm/audio/AudioAnalyser.d.ts

@@ -12,6 +12,21 @@ export interface AudioAnalyserOptions {
     minDecibels?: number;
     /** Maximum dBFS rendered by the byte-domain spectrum getters. Default -30. */
     maxDecibels?: number;
+    /**
+     * Optional initial source. Equivalent to `analyser.source = value` after
+     * construction; provided for ergonomic one-shot construction. The setter
+     * remains usable for runtime source switches.
+     */
+    source?: AudioAnalyserSource;
+}
+/** Mapping options for {@link AudioAnalyser.getSpectrumMel} and {@link AudioAnalyser.getSpectrumLog}. */
+export interface SpectrumMappingOptions {
+    /** Number of output bands. Default 32. */
+    bands?: number;
+    /** Lower frequency bound in Hz. Default 20. */
+    fMin?: number;
+    /** Upper frequency bound in Hz. Default 20000 (clamped to nyquist at runtime). */
+    fMax?: number;
 }
 /**
  * Lightweight visualisation analyser backed by a Web Audio AnalyserNode.
@@ -32,6 +47,8 @@ export declare class AudioAnalyser {
     private _floatSpectrum;
     private _byteWaveform;
     private _floatWaveform;
+    private _melCache;
+    private _logCache;
     /**
      * Create an `AudioAnalyser` with the given options. The underlying
      * `AnalyserNode` is created immediately if the `AudioContext` is already
@@ -75,12 +92,31 @@ export declare class AudioAnalyser {
     };
     /** Return overall RMS energy across all bins, normalised 0..1. */
     getRms(): number;
+    /**
+     * Mel-scaled spectrum, byte domain (0..255). Output length = `bands`.
+     * Each output bin is a triangular-weighted sum of the linear FFT bins
+     * underneath it, mel-spaced from `fMin` to `fMax`.
+     */
+    getSpectrumMel(into?: Uint8Array<ArrayBuffer>, options?: SpectrumMappingOptions): Uint8Array<ArrayBuffer>;
+    /** Mel-scaled spectrum, float domain (dBFS values). Output length = `bands`. */
+    getSpectrumMelFloat(into?: Float32Array<ArrayBuffer>, options?: SpectrumMappingOptions): Float32Array<ArrayBuffer>;
+    /**
+     * Log-scaled spectrum, byte domain (0..255). Output length = `bands`.
+     * Bins are spaced so each output covers an equal fraction of the
+     * `log2(fMax / fMin)` octave range — useful when you want a
+     * frequency-axis visualization where each octave gets the same width.
+     */
+    getSpectrumLog(into?: Uint8Array<ArrayBuffer>, options?: SpectrumMappingOptions): Uint8Array<ArrayBuffer>;
+    /** Log-scaled spectrum, float domain (dBFS values). Output length = `bands`. */
+    getSpectrumLogFloat(into?: Float32Array<ArrayBuffer>, options?: SpectrumMappingOptions): Float32Array<ArrayBuffer>;
     /**
      * Disconnect the analyser tap, release the internal `AnalyserNode`, and
      * cancel any pending setup callbacks. Call when the analyser is no longer
      * needed to avoid memory leaks.
      */
     destroy(): void;
+    private _getMelFilterbank;
+    private _getLogRanges;
     private _setupAnalyser;
     private _connectSource;
     private _resolveToAudioNode;

package/dist/esm/audio/AudioAnalyser.js

@@ -1,4 +1,5 @@
 import { isAudioContextReady, getAudioContext, onAudioContextReady } from './audio-context.js';
+import { buildMelFilterbank } from './dsp/mel.js';
 
 /**
  * Lightweight visualisation analyser backed by a Web Audio AnalyserNode.
@@ -20,6 +21,10 @@ class AudioAnalyser {
     _floatSpectrum;
     _byteWaveform;
     _floatWaveform;
+    // Cached mel/log filterbanks. Key: `${bands}|${fMin}|${fMax}|${fftSize}`.
+    // Filterbank construction is non-trivial; caching avoids per-frame allocation.
+    _melCache = new Map();
+    _logCache = new Map();
     /**
      * Create an `AudioAnalyser` with the given options. The underlying
      * `AnalyserNode` is created immediately if the `AudioContext` is already
@@ -31,6 +36,7 @@ class AudioAnalyser {
             smoothingTimeConstant: options?.smoothingTimeConstant ?? 0.8,
             minDecibels: options?.minDecibels ?? -100,
             maxDecibels: options?.maxDecibels ?? -30,
+            source: options?.source ?? null,
         };
         const binCount = this._options.fftSize >> 1;
         this._byteSpectrum = new Uint8Array(binCount);
@@ -43,6 +49,9 @@ class AudioAnalyser {
         else {
             onAudioContextReady.once(this._setupAnalyser, this);
         }
+        if (options?.source !== undefined && options.source !== null) {
+            this.source = options.source;
+        }
     }
     // -----------------------------------------------------------------------
     // Source setter
@@ -198,6 +207,81 @@ class AudioAnalyser {
         return this.getBandEnergy(0, nyquist);
     }
     // -----------------------------------------------------------------------
+    // Spectrum mapping (mel / log scaling)
+    //
+    // The raw FFT bins from AnalyserNode are linearly distributed across
+    // 0..nyquist, which gives bass a few bins and treble hundreds. For
+    // visualisations you typically want perceptually-weighted spacing.
+    //
+    // Both `getSpectrumMel` and `getSpectrumLog` operate on the byte-domain
+    // spectrum (0..255) and produce byte output by default. The float
+    // variants operate on dBFS values and produce float output.
+    //
+    // Filterbanks are cached on the analyser; they only rebuild when fftSize
+    // or the (bands, fMin, fMax) parameters change.
+    // -----------------------------------------------------------------------
+    /**
+     * Mel-scaled spectrum, byte domain (0..255). Output length = `bands`.
+     * Each output bin is a triangular-weighted sum of the linear FFT bins
+     * underneath it, mel-spaced from `fMin` to `fMax`.
+     */
+    getSpectrumMel(into, options) {
+        const bandCount = options?.bands ?? 32;
+        const out = into ?? new Uint8Array(bandCount);
+        const filterbank = this._getMelFilterbank(bandCount, options?.fMin ?? 20, options?.fMax ?? 20000);
+        if (!this._analyser || filterbank === null) {
+            out.fill(0);
+            return out;
+        }
+        this._analyser.getByteFrequencyData(this._byteSpectrum);
+        applyFilterbank(this._byteSpectrum, filterbank, out);
+        return out;
+    }
+    /** Mel-scaled spectrum, float domain (dBFS values). Output length = `bands`. */
+    getSpectrumMelFloat(into, options) {
+        const bandCount = options?.bands ?? 32;
+        const out = into ?? new Float32Array(bandCount);
+        const filterbank = this._getMelFilterbank(bandCount, options?.fMin ?? 20, options?.fMax ?? 20000);
+        if (!this._analyser || filterbank === null) {
+            out.fill(0);
+            return out;
+        }
+        this._analyser.getFloatFrequencyData(this._floatSpectrum);
+        applyFilterbank(this._floatSpectrum, filterbank, out);
+        return out;
+    }
+    /**
+     * Log-scaled spectrum, byte domain (0..255). Output length = `bands`.
+     * Bins are spaced so each output covers an equal fraction of the
+     * `log2(fMax / fMin)` octave range — useful when you want a
+     * frequency-axis visualization where each octave gets the same width.
+     */
+    getSpectrumLog(into, options) {
+        const bandCount = options?.bands ?? 32;
+        const out = into ?? new Uint8Array(bandCount);
+        const ranges = this._getLogRanges(bandCount, options?.fMin ?? 20, options?.fMax ?? 20000);
+        if (!this._analyser || ranges === null) {
+            out.fill(0);
+            return out;
+        }
+        this._analyser.getByteFrequencyData(this._byteSpectrum);
+        applyLogRanges(this._byteSpectrum, ranges, out);
+        return out;
+    }
+    /** Log-scaled spectrum, float domain (dBFS values). Output length = `bands`. */
+    getSpectrumLogFloat(into, options) {
+        const bandCount = options?.bands ?? 32;
+        const out = into ?? new Float32Array(bandCount);
+        const ranges = this._getLogRanges(bandCount, options?.fMin ?? 20, options?.fMax ?? 20000);
+        if (!this._analyser || ranges === null) {
+            out.fill(0);
+            return out;
+        }
+        this._analyser.getFloatFrequencyData(this._floatSpectrum);
+        applyLogRanges(this._floatSpectrum, ranges, out);
+        return out;
+    }
+    // -----------------------------------------------------------------------
     // Lifecycle
     // -----------------------------------------------------------------------
     /**
@@ -215,6 +299,34 @@ class AudioAnalyser {
     // -----------------------------------------------------------------------
     // Private helpers
     // -----------------------------------------------------------------------
+    _getMelFilterbank(bands, fMin, fMax) {
+        if (!this._analyser)
+            return null;
+        const ctx = getAudioContext();
+        const fftSize = this._options.fftSize;
+        const clampedFmax = Math.min(fMax, ctx.sampleRate / 2);
+        const key = `${bands}|${fMin}|${clampedFmax}|${fftSize}`;
+        let cached = this._melCache.get(key);
+        if (cached === undefined) {
+            cached = buildMelFilterbank(bands, fMin, clampedFmax, fftSize, ctx.sampleRate);
+            this._melCache.set(key, cached);
+        }
+        return cached;
+    }
+    _getLogRanges(bands, fMin, fMax) {
+        if (!this._analyser)
+            return null;
+        const ctx = getAudioContext();
+        const fftSize = this._options.fftSize;
+        const clampedFmax = Math.min(fMax, ctx.sampleRate / 2);
+        const key = `${bands}|${fMin}|${clampedFmax}|${fftSize}`;
+        let cached = this._logCache.get(key);
+        if (cached === undefined) {
+            cached = buildLogRanges(bands, fMin, clampedFmax, fftSize, ctx.sampleRate);
+            this._logCache.set(key, cached);
+        }
+        return cached;
+    }
     _setupAnalyser(audioContext) {
         const node = audioContext.createAnalyser();
         node.fftSize = this._options.fftSize;
@@ -305,6 +417,42 @@ class AudioAnalyser {
         }
     }
 }
+function buildLogRanges(bandCount, fMin, fMax, fftSize, sampleRate) {
+    const binCount = fftSize >> 1;
+    const nyquist = sampleRate / 2;
+    const logMin = Math.log(fMin);
+    const logMax = Math.log(fMax);
+    const ranges = [];
+    for (let b = 0; b < bandCount; b++) {
+        const lowHz = Math.exp(logMin + ((logMax - logMin) * b) / bandCount);
+        const highHz = Math.exp(logMin + ((logMax - logMin) * (b + 1)) / bandCount);
+        const startBin = Math.max(0, Math.min(binCount - 1, Math.floor((lowHz / nyquist) * binCount)));
+        const endBin = Math.max(startBin, Math.min(binCount - 1, Math.ceil((highHz / nyquist) * binCount) - 1));
+        ranges.push({ startBin, endBin });
+    }
+    return ranges;
+}
+function applyFilterbank(spectrum, bands, out) {
+    for (let b = 0; b < bands.length; b++) {
+        const { startBin, weights } = bands[b];
+        let sum = 0;
+        for (let i = 0; i < weights.length; i++) {
+            sum += spectrum[startBin + i] * weights[i];
+        }
+        out[b] = sum;
+    }
+}
+function applyLogRanges(spectrum, ranges, out) {
+    for (let b = 0; b < ranges.length; b++) {
+        const { startBin, endBin } = ranges[b];
+        let sum = 0;
+        const count = endBin - startBin + 1;
+        for (let i = startBin; i <= endBin; i++) {
+            sum += spectrum[i];
+        }
+        out[b] = sum / count;
+    }
+}
 
 export { AudioAnalyser };
 //# sourceMappingURL=AudioAnalyser.js.map

package/dist/esm/audio/AudioAnalyser.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudioAnalyser.js","sources":["../../../../src/audio/AudioAnalyser.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"AudioAnalyser.js","sources":["../../../../src/audio/AudioAnalyser.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAsCA;;;;;;;;AAQG;MACU,aAAa,CAAA;IAChB,SAAS,GAAwB,IAAI;AAC5B,IAAA,QAAQ;IACjB,OAAO,GAAwB,IAAI;IACnC,UAAU,GAAqB,IAAI;IACnC,aAAa,GAAsC,IAAI;;AAGvD,IAAA,aAAa;AACb,IAAA,cAAc;AACd,IAAA,aAAa;AACb,IAAA,cAAc;;;AAId,IAAA,SAAS,GAAG,IAAI,GAAG,EAAqB;AACxC,IAAA,SAAS,GAAG,IAAI,GAAG,EAA0B;AAErD;;;;AAIG;AACH,IAAA,WAAA,CAAmB,OAA8B,EAAA;QAC/C,IAAI,CAAC,QAAQ,GAAG;AACd,YAAA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI;AACjC,YAAA,qBAAqB,EAAE,OAAO,EAAE,qBAAqB,IAAI,GAAG;AAC5D,YAAA,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI;AACzC,YAAA,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,GAAG;AACxC,YAAA,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI;SAChC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC;QAC7C,IAAI,CAAC,cAAc,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC;QAChD,IAAI,CAAC,aAAa,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC;QAC7C,IAAI,CAAC,cAAc,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC;QAEhD,IAAI,mBAAmB,EAAE,EAAE;AACzB,YAAA,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;QACxC;aAAO;YACL,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC;QACrD;AAEA,QAAA,IAAI,OAAO,EAAE,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE;AAC5D,YAAA,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;QAC9B;IACF;;;;AAMA;;;;AAIG;AACH,IAAA,IAAW,MAAM,GAAA;QACf,OAAO,IAAI,CAAC,OAAO;IACrB;IAEA,IAAW,MAAM,CAAC,KAA0B,EAAA;AAC1C,QAAA,IAAI,KAAK,KAAK,IAAI,CAAC,OAAO;YAAE;;QAG5B,IAAI,CAAC,cAAc,EAAE;AAErB,QAAA,IAAI,CAAC,OAAO,GAAG,KAAK;QAEpB,IAAI,KAAK,KAAK,IAAI;YAAE;;QAGpB,IAAI,mBAAmB,EAAE,EAAE;YACzB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC;QAC/C;aAAO;AACL,YAAA,mBAAmB,CAAC,IAAI,CAAC,CAAC,GAAiB,KAAI;AAC7C,gBAAA,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE;AAC1B,oBAAA,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC;gBACjC;YACF,CAAC,EAAE,IAAI,CAAC;QACV;IACF;;;;AAMA,IAAA,IAAW,OAAO,GAAA;AAChB,QAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO;IAC9B;;AAGA,IAAA,IAAW,iBAAiB,GAAA;AAC1B,QAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC;IACnC;AAEA,IAAA,IAAW,qBAAqB,GAAA;QAC9B,OAAO,IAAI,CAAC,SAAS,EAAE,qBAAqB,IAAI,IAAI,CAAC,QAAQ,CAAC,qBAAqB;IACrF;IAEA,IAAW,qBAAqB,CAAC,CAAS,EAAA;AACxC,QAAA,IAAI,CAAC,QAAQ,CAAC,qBAAqB,GAAG,CAAC;QACvC,IAAI,IAAI,CAAC,SAAS;AAAE,YAAA,IAAI,CAAC,SAAS,CAAC,qBAAqB,GAAG,CAAC;IAC9D;AAEA,IAAA,IAAW,WAAW,GAAA;QACpB,OAAO,IAAI,CAAC,SAAS,EAAE,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW;IACjE;IAEA,IAAW,WAAW,CAAC,CAAS,EAAA;AAC9B,QAAA,IAAI,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC;QAC7B,IAAI,IAAI,CAAC,SAAS;AAAE,YAAA,IAAI,CAAC,SAAS,CAAC,WAAW,GAAG,CAAC;IACpD;AAEA,IAAA,IAAW,WAAW,GAAA;QACpB,OAAO,IAAI,CAAC,SAAS,EAAE,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW;IACjE;IAEA,IAAW,WAAW,CAAC,CAAS,EAAA;AAC9B,QAAA,IAAI,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC;QAC7B,IAAI,IAAI,CAAC,SAAS;AAAE,YAAA,IAAI,CAAC,SAAS,CAAC,WAAW,GAAG,CAAC;IACpD;;;;;AAOO,IAAA,WAAW,CAAC,IAA8B,EAAA;AAC/C,QAAA,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,aAAa;AACtC,QAAA,IAAI,IAAI,CAAC,SAAS,EAAE;AAClB,YAAA,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,GAAG,CAAC;QAC1C;aAAO;AACL,YAAA,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACb;AACA,QAAA,OAAO,GAAG;IACZ;;AAGO,IAAA,gBAAgB,CAAC,IAAgC,EAAA;AACtD,QAAA,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,cAAc;AACvC,QAAA,IAAI,IAAI,CAAC,SAAS,EAAE;AAClB,YAAA,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,GAAG,CAAC;QAC3C;aAAO;AACL,YAAA,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACb;AACA,QAAA,OAAO,GAAG;IACZ;;AAGO,IAAA,WAAW,CAAC,IAA8B,EAAA;AAC/C,QAAA,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,aAAa;AACtC,QAAA,IAAI,IAAI,CAAC,SAAS,EAAE;AAClB,YAAA,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,GAAG,CAAC;QAC3C;aAAO;AACL,YAAA,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACb;AACA,QAAA,OAAO,GAAG;IACZ;;AAGO,IAAA,gBAAgB,CAAC,IAAgC,EAAA;AACtD,QAAA,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,cAAc;AACvC,QAAA,IAAI,IAAI,CAAC,SAAS,EAAE;AAClB,YAAA,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,GAAG,CAAC;QAC5C;aAAO;AACL,YAAA,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACb;AACA,QAAA,OAAO,GAAG;IACZ;;;;AAMA;;;AAGG;IACI,aAAa,CAAC,MAAc,EAAE,IAAY,EAAA;QAC/C,IAAI,CAAC,IAAI,CAAC,SAAS;AAAE,YAAA,OAAO,CAAC;AAC7B,QAAA,MAAM,GAAG,GAAG,eAAe,EAAE;AAC7B,QAAA,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,GAAG,CAAC;AAClC,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB;AACvC,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC;AAC9F,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC;QAE1F,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC;AAEnC,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE;QACnC,IAAI,GAAG,GAAG,CAAC;AACX,QAAA,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;AACzB,QAAA,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;AAC7B,YAAA,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC;QACpB;AACA,QAAA,OAAO,GAAG,IAAI,KAAK,GAAG,GAAG,CAAC;IAC5B;;IAGO,aAAa,GAAA;QAClB,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC;YAC/B,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC;SACtC;IACH;;IAGO,MAAM,GAAA;QACX,IAAI,CAAC,IAAI,CAAC,SAAS;AAAE,YAAA,OAAO,CAAC;AAC7B,QAAA,MAAM,GAAG,GAAG,eAAe,EAAE;AAC7B,QAAA,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,GAAG,CAAC;QAClC,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC;IACvC;;;;;;;;;;;;;;;AAiBA;;;;AAIG;IACI,cAAc,CAAC,IAA8B,EAAE,OAAgC,EAAA;AACpF,QAAA,MAAM,SAAS,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,UAAU,CAAC,SAAS,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC;QAEjG,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE;AAC1C,YAAA,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACX,YAAA,OAAO,GAAG;QACZ;QAEA,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC;QACvD,eAAe,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,GAAG,CAAC;AAEpD,QAAA,OAAO,GAAG;IACZ;;IAGO,mBAAmB,CAAC,IAAgC,EAAE,OAAgC,EAAA;AAC3F,QAAA,MAAM,SAAS,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,YAAY,CAAC,SAAS,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC;QAEjG,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE;AAC1C,YAAA,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACX,YAAA,OAAO,GAAG;QACZ;QAEA,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC;QACzD,eAAe,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,EAAE,GAAG,CAAC;AAErD,QAAA,OAAO,GAAG;IACZ;AAEA;;;;;AAKG;IACI,cAAc,CAAC,IAA8B,EAAE,OAAgC,EAAA;AACpF,QAAA,MAAM,SAAS,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,UAAU,CAAC,SAAS,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC;QAEzF,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE;AACtC,YAAA,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACX,YAAA,OAAO,GAAG;QACZ;QAEA,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC;QACvD,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC;AAE/C,QAAA,OAAO,GAAG;IACZ;;IAGO,mBAAmB,CAAC,IAAgC,EAAE,OAAgC,EAAA;AAC3F,QAAA,MAAM,SAAS,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,YAAY,CAAC,SAAS,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC;QAEzF,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE;AACtC,YAAA,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACX,YAAA,OAAO,GAAG;QACZ;QAEA,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC;QACzD,cAAc,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,CAAC;AAEhD,QAAA,OAAO,GAAG;IACZ;;;;AAMA;;;;AAIG;IACI,OAAO,GAAA;AACZ,QAAA,mBAAmB,CAAC,cAAc,CAAC,IAAI,CAAC;QACxC,IAAI,CAAC,cAAc,EAAE;AACrB,QAAA,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE;AAC5B,QAAA,IAAI,CAAC,SAAS,GAAG,IAAI;AACrB,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI;IACrB;;;;AAMQ,IAAA,iBAAiB,CAAC,KAAa,EAAE,IAAY,EAAE,IAAY,EAAA;QACjE,IAAI,CAAC,IAAI,CAAC,SAAS;AAAE,YAAA,OAAO,IAAI;AAChC,QAAA,MAAM,GAAG,GAAG,eAAe,EAAE;AAC7B,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO;AACrC,QAAA,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,CAAA,EAAG,KAAK,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,EAAI,WAAW,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE;QAExD,IAAI,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;AACpC,QAAA,IAAI,MAAM,KAAK,SAAS,EAAE;AACxB,YAAA,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC;YAC9E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC;QACjC;AACA,QAAA,OAAO,MAAM;IACf;AAEQ,IAAA,aAAa,CAAC,KAAa,EAAE,IAAY,EAAE,IAAY,EAAA;QAC7D,IAAI,CAAC,IAAI,CAAC,SAAS;AAAE,YAAA,OAAO,IAAI;AAChC,QAAA,MAAM,GAAG,GAAG,eAAe,EAAE;AAC7B,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO;AACrC,QAAA,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,CAAA,EAAG,KAAK,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,EAAI,WAAW,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE;QAExD,IAAI,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;AACpC,QAAA,IAAI,MAAM,KAAK,SAAS,EAAE;AACxB,YAAA,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC;YAC1E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC;QACjC;AACA,QAAA,OAAO,MAAM;IACf;AAEQ,IAAA,cAAc,CAAC,YAA0B,EAAA;AAC/C,QAAA,MAAM,IAAI,GAAG,YAAY,CAAC,cAAc,EAAE;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO;QACpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW;QAC5C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW;QAC5C,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,QAAQ,CAAC,qBAAqB;AAChE,QAAA,IAAI,CAAC,SAAS,GAAG,IAAI;;AAGrB,QAAA,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE;YACzB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC;QACjD;IACF;IAEQ,cAAc,CAAC,MAA2B,EAAE,YAA0B,EAAA;QAC5E,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE;QAErB,MAAM,GAAG,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,YAAY,CAAC;QAC1D,IAAI,CAAC,GAAG,EAAE;;AAER,YAAA,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC;YACnC;QACF;AAEA,QAAA,IAAI,CAAC,UAAU,GAAG,GAAG;AACrB,QAAA,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;IAC7B;IAEQ,mBAAmB,CAAC,MAA2B,EAAE,YAA0B,EAAA;QACjF,IAAI,MAAM,KAAK,IAAI;AAAE,YAAA,OAAO,IAAI;;QAGhC,MAAM,QAAQ,GAAG,MAAyC;AAC1D,QAAA,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,UAAU,EAAE;AAC5C,YAAA,IAAI,IAAI,CAAC,aAAa,EAAE;AACtB,gBAAA,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE;AAC/B,gBAAA,IAAI,CAAC,aAAa,GAAG,IAAI;YAC3B;YACA,MAAM,MAAM,GAAG,YAAY,CAAC,uBAAuB,CAAC,MAAqB,CAAC;AAC1E,YAAA,IAAI,CAAC,aAAa,GAAG,MAAM;AAC3B,YAAA,OAAO,MAAM;QACf;;QAGA,MAAM,KAAK,GAAG,MAA6D;AAC3E,QAAA,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,UAAU,EAAE;AAC9C,YAAA,OAAO,KAAK,CAAC,cAAc,EAAE;QAC/B;;QAGA,MAAM,OAAO,GAAG,MAAuD;AACvE,QAAA,IAAI,gBAAgB,IAAI,OAAO,EAAE;AAC/B,YAAA,OAAO,OAAO,CAAC,cAAc,IAAI,IAAI;QACvC;;QAGA,MAAM,MAAM,GAAG,MAA4D;AAC3E,QAAA,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE;AACnF,YAAA,OAAO,MAA8B;QACvC;AAEA,QAAA,OAAO,IAAI;IACb;AAEQ,IAAA,sBAAsB,CAAC,MAA2B,EAAA;;QAExD,MAAM,KAAK,GAAG,MAAgE;AAC9E,QAAA,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,UAAU,EAAE;AACzC,YAAA,KAAK,CAAC,SAAS,CAAC,MAAK;AACnB,gBAAA,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,IAAI,mBAAmB,EAAE,EAAE;oBACtE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;gBAChD;AACF,YAAA,CAAC,CAAC;YACF;QACF;;AAGA,QAAA,mBAAmB,CAAC,IAAI,CAAC,MAAK;AAC5B,YAAA,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,IAAI,mBAAmB,EAAE,EAAE;gBACtE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;YAChD;QACF,CAAC,EAAE,IAAI,CAAC;IACV;IAEQ,cAAc,GAAA;QACpB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,SAAS,EAAE;AACrC,YAAA,IAAI;gBACF,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;YAC5C;AAAE,YAAA,MAAM;;YAER;QACF;AACA,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI;;AAGtB,QAAA,IAAI,IAAI,CAAC,aAAa,EAAE;AACtB,YAAA,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE;AAC/B,YAAA,IAAI,CAAC,aAAa,GAAG,IAAI;QAC3B;IACF;AACD;AAaD,SAAS,cAAc,CAAC,SAAiB,EAAE,IAAY,EAAE,IAAY,EAAE,OAAe,EAAE,UAAkB,EAAA;AACxG,IAAA,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC;AAC7B,IAAA,MAAM,OAAO,GAAG,UAAU,GAAG,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IAC7B,MAAM,MAAM,GAAmB,EAAE;AAEjC,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,SAAS,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;AAC3E,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC;AAC9F,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACvG,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnC;AAEA,IAAA,OAAO,MAAM;AACf;AAEA,SAAS,eAAe,CAAC,QAAmC,EAAE,KAAgB,EAAE,GAA8B,EAAA;AAC5G,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACrC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;QACtC,IAAI,GAAG,GAAG,CAAC;AACX,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;AACvC,YAAA,GAAG,IAAI,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;QAC5C;AACA,QAAA,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG;IACd;AACF;AAEA,SAAS,cAAc,CAAC,QAAmC,EAAE,MAAsB,EAAE,GAA8B,EAAA;AACjH,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACtC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;QACtC,IAAI,GAAG,GAAG,CAAC;AACX,QAAA,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC;AACnC,QAAA,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE;AACvC,YAAA,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC;QACpB;AACA,QAAA,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK;IACtB;AACF;;;;"}

package/dist/esm/audio/BeatDetector.d.ts

@@ -23,6 +23,27 @@ export interface BeatDetectorOptions {
      * switches active time signature via hysteresis. Set false to lock to 4/4.
      */
     enableTimeSignatureDetection?: boolean;
+    /**
+     * Optional initial source. Equivalent to constructing then assigning
+     * `detector.source = value`; provided for ergonomic one-shot construction.
+     * The setter remains usable for runtime source switches.
+     */
+    source?: BeatDetectorSource;
+    /**
+     * Half-life in seconds for the {@link BeatDetector.pulse} envelope.
+     * Default 0.15 — `pulse` halves every 150ms after each beat.
+     */
+    pulseHalfLife?: number;
+    /**
+     * Half-life in seconds for the {@link BeatDetector.barPulse} envelope.
+     * Default 0.3 — slower than beat pulse for downbeat-emphasized visuals.
+     */
+    barPulseHalfLife?: number;
+    /**
+     * Time window in seconds for {@link BeatDetector.justBeat}. Default 0.03
+     * — true for the visual frame(s) within 30ms of a beat onset.
+     */
+    justBeatWindow?: number;
 }
 export interface BeatInfo {
     /** audioContext.currentTime when the beat occurred. */
@@ -114,6 +135,15 @@ export declare class BeatDetector {
     private _timeSignature;
     private _nextDownbeatTime;
     private _lookahead;
+    /**
+     * Half-life in seconds for the {@link pulse} envelope. Mutable; default 0.15.
+     * Smaller values give a snappier pulse, larger values a longer afterglow.
+     */
+    pulseHalfLife: number;
+    /** Half-life for the {@link barPulse} envelope. Mutable; default 0.3. */
+    barPulseHalfLife: number;
+    /** Time window for {@link justBeat}. Mutable; default 0.03 (30ms). */
+    justBeatWindow: number;
     constructor(options?: BeatDetectorOptions);
     get source(): BeatDetectorSource;
     set source(value: BeatDetectorSource);
@@ -132,6 +162,38 @@ export declare class BeatDetector {
     get timeSignature(): TimeSignature;
     get nextDownbeatTime(): number;
     get lookahead(): readonly UpcomingBeat[];
+    /**
+     * Seconds elapsed since the most recent beat, derived from {@link beatPhase}
+     * and {@link tempo}. Returns 0 when the detector hasn't locked yet.
+     */
+    get secondsSinceLastBeat(): number;
+    /**
+     * 0..1 envelope, peaks at 1.0 the moment a beat fires and halves every
+     * {@link pulseHalfLife} seconds. Drives "pulse on the beat" visuals
+     * with a single multiplication: `sprite.scale = 1 + clock.pulse * 0.3`.
+     */
+    get pulse(): number;
+    /**
+     * Like {@link pulse} but resets on downbeats and decays per
+     * {@link barPulseHalfLife}. Useful for emphasizing the first beat of
+     * each bar (e.g. brighter flash on "1" vs "2,3,4").
+     */
+    get barPulse(): number;
+    /**
+     * True for the visual frame(s) within {@link justBeatWindow} seconds of
+     * a beat onset. Use for one-shot triggers (strobe flash, particle burst,
+     * sample retrigger). Default window 30ms covers a typical 60fps frame.
+     */
+    get justBeat(): boolean;
+    /**
+     * Phase 0..1 within a subdivision of the current beat. `division` is the
+     * number of subdivisions per beat: 2 for 8th notes, 4 for 16th notes,
+     * 3 for triplets. Use to drive sub-beat-resolution effects:
+     *
+     *   const sixteenth = clock.subdivisionPhase(4);
+     *   if (sixteenth < 0.05) flash();
+     */
+    subdivisionPhase(division: number): number;
     destroy(): void;
     private _setup;
     private _onWorkletMessage;

package/dist/esm/audio/BeatDetector.js

@@ -705,6 +705,15 @@ class BeatDetector {
     _timeSignature = { numerator: 4, denominator: 4 };
     _nextDownbeatTime = 0;
     _lookahead = Object.freeze([]);
+    /**
+     * Half-life in seconds for the {@link pulse} envelope. Mutable; default 0.15.
+     * Smaller values give a snappier pulse, larger values a longer afterglow.
+     */
+    pulseHalfLife;
+    /** Half-life for the {@link barPulse} envelope. Mutable; default 0.3. */
+    barPulseHalfLife;
+    /** Time window for {@link justBeat}. Mutable; default 0.03 (30ms). */
+    justBeatWindow;
     constructor(options) {
         this._options = {
             minBpm: options?.minBpm ?? 50,
@@ -715,13 +724,25 @@ class BeatDetector {
             settlingMs: options?.settlingMs ?? 1500,
             melBands: options?.melBands ?? 24,
             enableTimeSignatureDetection: options?.enableTimeSignatureDetection ?? true,
+            // Visual-state options aren't part of worklet config; cached in the public
+            // fields below but kept in the Required<> shape for type completeness.
+            source: options?.source ?? null,
+            pulseHalfLife: options?.pulseHalfLife ?? 0.15,
+            barPulseHalfLife: options?.barPulseHalfLife ?? 0.3,
+            justBeatWindow: options?.justBeatWindow ?? 0.03,
         };
+        this.pulseHalfLife = this._options.pulseHalfLife;
+        this.barPulseHalfLife = this._options.barPulseHalfLife;
+        this.justBeatWindow = this._options.justBeatWindow;
         if (isAudioContextReady()) {
             this._setup(getAudioContext());
         }
         else {
             onAudioContextReady.once(this._setup, this);
         }
+        if (options?.source !== undefined && options.source !== null) {
+            this.source = options.source;
+        }
     }
     // -----------------------------------------------------------------------
     // Source setter (polymorphic tap)
@@ -802,6 +823,62 @@ class BeatDetector {
         return this._lookahead;
     }
     // -----------------------------------------------------------------------
+    // Visual derived state — pure getters for per-frame polling
+    // -----------------------------------------------------------------------
+    /**
+     * Seconds elapsed since the most recent beat, derived from {@link beatPhase}
+     * and {@link tempo}. Returns 0 when the detector hasn't locked yet.
+     */
+    get secondsSinceLastBeat() {
+        if (this._tempo === 0)
+            return 0;
+        return this._beatPhase * (60 / this._tempo);
+    }
+    /**
+     * 0..1 envelope, peaks at 1.0 the moment a beat fires and halves every
+     * {@link pulseHalfLife} seconds. Drives "pulse on the beat" visuals
+     * with a single multiplication: `sprite.scale = 1 + clock.pulse * 0.3`.
+     */
+    get pulse() {
+        if (this._tempo === 0)
+            return 0;
+        return Math.pow(0.5, this.secondsSinceLastBeat / this.pulseHalfLife);
+    }
+    /**
+     * Like {@link pulse} but resets on downbeats and decays per
+     * {@link barPulseHalfLife}. Useful for emphasizing the first beat of
+     * each bar (e.g. brighter flash on "1" vs "2,3,4").
+     */
+    get barPulse() {
+        if (this._tempo === 0 || this._barLength === 0)
+            return 0;
+        const secondsPerBeat = 60 / this._tempo;
+        const lastDownbeat = this._nextDownbeatTime - this._barLength * secondsPerBeat;
+        const elapsed = Math.max(0, getAudioContext().currentTime - lastDownbeat);
+        return Math.pow(0.5, elapsed / this.barPulseHalfLife);
+    }
+    /**
+     * True for the visual frame(s) within {@link justBeatWindow} seconds of
+     * a beat onset. Use for one-shot triggers (strobe flash, particle burst,
+     * sample retrigger). Default window 30ms covers a typical 60fps frame.
+     */
+    get justBeat() {
+        return this._tempo > 0 && this.secondsSinceLastBeat < this.justBeatWindow;
+    }
+    /**
+     * Phase 0..1 within a subdivision of the current beat. `division` is the
+     * number of subdivisions per beat: 2 for 8th notes, 4 for 16th notes,
+     * 3 for triplets. Use to drive sub-beat-resolution effects:
+     *
+     *   const sixteenth = clock.subdivisionPhase(4);
+     *   if (sixteenth < 0.05) flash();
+     */
+    subdivisionPhase(division) {
+        if (!Number.isFinite(division) || division <= 0)
+            return 0;
+        return (this._beatPhase * division) % 1;
+    }
+    // -----------------------------------------------------------------------
     // Lifecycle
     // -----------------------------------------------------------------------
     destroy() {