@nexart/codemode-sdk 1.5.0 → 1.6.0

package/dist/noise-sketches/index.js

@@ -0,0 +1,28 @@
+/**
+ * Noise Sketches Index
+ *
+ * Exports all available noise sketch generators for the Code Mode runtime.
+ */
+import FRACTAL_NOISE_SKETCH from './fractalNoise';
+const NOISE_SKETCHES = {
+    fractalNoise: FRACTAL_NOISE_SKETCH,
+};
+/**
+ * Get a noise sketch by name
+ */
+export function getNoiseSketch(name) {
+    return NOISE_SKETCHES[name];
+}
+/**
+ * Check if a sketch name is valid
+ */
+export function isValidNoiseSketch(name) {
+    return name in NOISE_SKETCHES;
+}
+/**
+ * Get list of all available noise sketch names
+ */
+export function getAvailableNoiseSketchNames() {
+    return Object.keys(NOISE_SKETCHES);
+}
+export { FRACTAL_NOISE_SKETCH };

package/dist/p5-runtime.d.ts

@@ -49,7 +49,8 @@ export interface P5Runtime {
 export interface P5RuntimeConfig {
     seed?: number;
 }
-export declare function createP5Runtime(canvas: HTMLCanvasElement, width: number, height: number, config?: P5RuntimeConfig): P5Runtime;
+type RuntimeCanvas = HTMLCanvasElement;
+export declare function createP5Runtime(canvas: RuntimeCanvas, width: number, height: number, config?: P5RuntimeConfig): P5Runtime;
 export declare function injectTimeVariables(p: P5Runtime, time: TimeVariables): void;
 /**
  * VAR Protocol Constants (Phase 1 — Protocol v1.0.0)
@@ -70,4 +71,5 @@ export declare const VAR_MAX = 100;
  */
 export declare function createProtocolVAR(vars?: number[]): readonly number[];
 export declare function injectProtocolVariables(p: P5Runtime, vars?: number[]): void;
+export {};
 //# sourceMappingURL=p5-runtime.d.ts.map

package/dist/p5-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"p5-runtime.d.ts","sourceRoot":"","sources":["../p5-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAClD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,qBAAqB,EAAG,MAAe,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,eAAe,GACvB,SAAS,CAq8BX;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAM3E;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAmCpE;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAE3E"}
+{"version":3,"file":"p5-runtime.d.ts","sourceRoot":"","sources":["../p5-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAClD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,qBAAqB,EAAG,MAAe,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,KAAK,aAAa,GAAG,iBAAiB,CAAC;AAEvC,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,eAAe,GACvB,SAAS,CAs8BX;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAM3E;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAmCpE;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAE3E"}

package/dist/p5-runtime.js

@@ -93,6 +93,8 @@ function createSeededNoise(seed = 0) {
 }
 export function createP5Runtime(canvas, width, height, config) {
     const ctx = canvas.getContext('2d', { willReadFrequently: true });
+    if (!ctx)
+        throw new Error('Failed to get 2D context');
     let currentFill = 'rgba(255, 255, 255, 1)';
     let currentStroke = 'rgba(0, 0, 0, 1)';
     let strokeEnabled = true;

package/dist/sound-bridge.d.ts

@@ -0,0 +1,89 @@
+/**
+ * SoundArt → Code Mode Bridge
+ *
+ * This module injects sound-derived parameters into the Code Mode runtime
+ * as read-only `S.*` globals. It is the integration layer between sound
+ * analysis and generative art rendering.
+ *
+ * Usage in Code Mode sketches:
+ *   S.volume     // 0-100: Overall loudness
+ *   S.bass       // 0-100: Bass frequency energy
+ *   S.treble     // 0-100: Treble frequency energy
+ *   S.aggression // 0-100: Intensity/harshness
+ *   S.t          // 0-1: Normalized time position
+ *   etc.
+ */
+import type { SoundSnapshot } from '../../shared/soundSnapshot';
+/**
+ * The injected sound globals interface
+ * This is what sketches see as `S`
+ */
+export interface SoundGlobals extends Readonly<SoundSnapshot> {
+}
+/**
+ * Create a frozen, read-only sound globals object from a snapshot
+ */
+export declare function createSoundGlobals(snapshot: SoundSnapshot): SoundGlobals;
+/**
+ * Create empty/default sound globals for testing or fallback
+ */
+export declare function createEmptySoundGlobals(): SoundGlobals;
+/**
+ * Inject sound globals into the p5 runtime context
+ *
+ * This adds the `S` global object to the runtime so sketches can access
+ * sound-derived parameters like S.volume, S.bass, etc.
+ *
+ * @param runtime - The p5 runtime object
+ * @param snapshot - The sound snapshot to inject
+ * @returns The runtime with S globals added
+ */
+export declare function injectSoundGlobals<T extends Record<string, any>>(runtime: T, snapshot: SoundSnapshot): T & {
+    S: SoundGlobals;
+};
+/**
+ * Helper function to map S.* values to useful ranges
+ *
+ * Usage in sketches:
+ *   const density = mapSound(S.volume, 100, 2000) // Map 0-100 to 100-2000
+ */
+export declare function createSoundHelpers(): {
+    /**
+     * Map a sound value (0-100) to a custom range
+     */
+    mapSound: (value: number, outMin: number, outMax: number) => number;
+    /**
+     * Map a sound value (0-100) with easing
+     */
+    mapSoundEased: (value: number, outMin: number, outMax: number, easing?: number) => number;
+    /**
+     * Get a value that oscillates based on sound
+     */
+    soundOscillate: (base: number, amplitude: number, soundValue: number) => number;
+};
+/**
+ * Convert SoundSnapshot hue (0-100) to degrees (0-360)
+ */
+export declare function hueToDegrees(hue: number): number;
+/**
+ * Generate a color palette from sound parameters
+ *
+ * @param snapshot - The sound snapshot
+ * @param paletteSize - Number of colors to generate
+ * @returns Array of HSL color strings
+ */
+export declare function generateSoundPalette(snapshot: SoundSnapshot, paletteSize?: number): string[];
+/**
+ * Infer a genre profile from sound parameters
+ * This helps sketches adapt their visual style to the audio content
+ */
+export type EnergyLevel = 'low' | 'mid' | 'high';
+export type StructureType = 'chaotic' | 'organic' | 'geometric';
+export type ClarityLevel = 'muddy' | 'clear' | 'sharp';
+export interface GenreProfile {
+    energy: EnergyLevel;
+    structure: StructureType;
+    clarity: ClarityLevel;
+}
+export declare function inferGenreProfile(snapshot: SoundSnapshot): GenreProfile;
+//# sourceMappingURL=sound-bridge.d.ts.map

package/dist/sound-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound-bridge.d.ts","sourceRoot":"","sources":["../sound-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ,CAAC,aAAa,CAAC;CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,CAExE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,YAAY,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9D,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,aAAa,GACtB,CAAC,GAAG;IAAE,CAAC,EAAE,YAAY,CAAA;CAAE,CAuBzB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB;IAE9B;;OAEG;sBACe,MAAM,UAAU,MAAM,UAAU,MAAM,KAAG,MAAM;IAIjE;;OAEG;2BACoB,MAAM,UAAU,MAAM,UAAU,MAAM,WAAU,MAAM,KAAO,MAAM;IAK1F;;OAEG;2BACoB,MAAM,aAAa,MAAM,cAAc,MAAM,KAAG,MAAM;EAIhF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,WAAW,GAAE,MAAU,GACtB,MAAM,EAAE,CAeV;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AACjD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,CAiBvE"}

package/dist/sound-bridge.js

@@ -0,0 +1,128 @@
+/**
+ * SoundArt → Code Mode Bridge
+ *
+ * This module injects sound-derived parameters into the Code Mode runtime
+ * as read-only `S.*` globals. It is the integration layer between sound
+ * analysis and generative art rendering.
+ *
+ * Usage in Code Mode sketches:
+ *   S.volume     // 0-100: Overall loudness
+ *   S.bass       // 0-100: Bass frequency energy
+ *   S.treble     // 0-100: Treble frequency energy
+ *   S.aggression // 0-100: Intensity/harshness
+ *   S.t          // 0-1: Normalized time position
+ *   etc.
+ */
+import { createEmptySoundSnapshot, freezeSoundSnapshot } from '../../shared/soundSnapshot';
+/**
+ * Create a frozen, read-only sound globals object from a snapshot
+ */
+export function createSoundGlobals(snapshot) {
+    return freezeSoundSnapshot(snapshot);
+}
+/**
+ * Create empty/default sound globals for testing or fallback
+ */
+export function createEmptySoundGlobals() {
+    return freezeSoundSnapshot(createEmptySoundSnapshot());
+}
+/**
+ * Inject sound globals into the p5 runtime context
+ *
+ * This adds the `S` global object to the runtime so sketches can access
+ * sound-derived parameters like S.volume, S.bass, etc.
+ *
+ * @param runtime - The p5 runtime object
+ * @param snapshot - The sound snapshot to inject
+ * @returns The runtime with S globals added
+ */
+export function injectSoundGlobals(runtime, snapshot) {
+    const globals = createSoundGlobals(snapshot);
+    // Create a proxy to make S immutable and prevent modification
+    const immutableS = new Proxy(globals, {
+        set() {
+            console.warn('[SoundBridge] S.* globals are read-only');
+            return false;
+        },
+        deleteProperty() {
+            console.warn('[SoundBridge] Cannot delete S.* properties');
+            return false;
+        },
+        defineProperty() {
+            console.warn('[SoundBridge] Cannot define new S.* properties');
+            return false;
+        }
+    });
+    return {
+        ...runtime,
+        S: immutableS
+    };
+}
+/**
+ * Helper function to map S.* values to useful ranges
+ *
+ * Usage in sketches:
+ *   const density = mapSound(S.volume, 100, 2000) // Map 0-100 to 100-2000
+ */
+export function createSoundHelpers() {
+    return {
+        /**
+         * Map a sound value (0-100) to a custom range
+         */
+        mapSound: (value, outMin, outMax) => {
+            return outMin + (value / 100) * (outMax - outMin);
+        },
+        /**
+         * Map a sound value (0-100) with easing
+         */
+        mapSoundEased: (value, outMin, outMax, easing = 2) => {
+            const t = Math.pow(value / 100, easing);
+            return outMin + t * (outMax - outMin);
+        },
+        /**
+         * Get a value that oscillates based on sound
+         */
+        soundOscillate: (base, amplitude, soundValue) => {
+            return base + Math.sin(soundValue * Math.PI / 50) * amplitude;
+        }
+    };
+}
+/**
+ * Convert SoundSnapshot hue (0-100) to degrees (0-360)
+ */
+export function hueToDegrees(hue) {
+    return (hue / 100) * 360;
+}
+/**
+ * Generate a color palette from sound parameters
+ *
+ * @param snapshot - The sound snapshot
+ * @param paletteSize - Number of colors to generate
+ * @returns Array of HSL color strings
+ */
+export function generateSoundPalette(snapshot, paletteSize = 6) {
+    const mainHue = hueToDegrees(snapshot.hue);
+    const hueShift = 20 + (snapshot.harmonicity / 100) * 40; // 20-60 degrees
+    const sat = 60 + (snapshot.treble / 100) * 30; // 60-90%
+    const light = 70 + (snapshot.bass / 100) * 25; // 70-95%
+    const palette = [];
+    for (let i = 0; i < paletteSize; i++) {
+        const hue = (mainHue + i * hueShift) % 360;
+        const satVar = sat - (i % 2) * 10;
+        const lightVar = light - (i % 3) * 5;
+        palette.push(`hsl(${hue}, ${satVar}%, ${lightVar}%)`);
+    }
+    return palette;
+}
+export function inferGenreProfile(snapshot) {
+    // Energy based on volume and aggression
+    const energy = (snapshot.volume > 60 || snapshot.aggression > 60) ? 'high' :
+        (snapshot.volume > 30) ? 'mid' : 'low';
+    // Structure based on rhythmicity and aggression
+    const structure = (snapshot.rhythmicity > 50 && snapshot.dynamicRange < 25) ? 'geometric' :
+        (snapshot.aggression > 60 && snapshot.dynamicRange > 50) ? 'chaotic' : 'organic';
+    // Clarity based on brightness
+    const clarity = (snapshot.brightness > 60) ? 'sharp' :
+        (snapshot.brightness > 40) ? 'clear' : 'muddy';
+    return { energy, structure, clarity };
+}

package/dist/soundart-engine.d.ts

@@ -0,0 +1,87 @@
+/**
+ * SoundArt → Code Mode Engine
+ *
+ * This is the orchestrator that runs SoundArt styles through the Code Mode engine.
+ * It replaces the old Canvas2D-based SoundArt renderer with a Code Mode pipeline.
+ *
+ * Architecture:
+ *   1. Sound analysis produces SoundFeatures (unchanged)
+ *   2. SoundFeatures → SoundSnapshot conversion
+ *   3. SoundSnapshot injected as S.* globals into Code Mode
+ *   4. SoundArt sketch executed via Code Mode runtime
+ *   5. Result: PNG or MP4 output
+ */
+import type { SoundSnapshot, SoundFeatures } from '../../shared/soundSnapshot';
+import { type SoundArtSketchName } from './soundart-sketches';
+export interface TweakParams {
+    volumeRangeFactor?: number;
+    centroidBrightnessFactor?: number;
+    aggressionPaletteFactor?: number;
+    rhythmPatternFactor?: number;
+    harmonySmoothnessFactor?: number;
+    attackSharpnessFactor?: number;
+    dynamicRangeVariationFactor?: number;
+    bassThicknessFactor?: number;
+    trebleSharpnessFactor?: number;
+}
+export interface SoundArtEngineConfig {
+    width: number;
+    height: number;
+    seed?: number;
+    backgroundMode?: 'rgb' | 'black' | 'white';
+    tweakParams?: TweakParams;
+}
+export interface SoundArtRenderOptions {
+    style: SoundArtSketchName;
+    sound: SoundFeatures;
+    canvas: HTMLCanvasElement;
+    config: SoundArtEngineConfig;
+    onProgress?: (progress: number) => void;
+}
+export interface SoundArtRenderResult {
+    style: SoundArtSketchName;
+    mode: 'soundart';
+    snapshot: SoundSnapshot;
+    metadata: SoundArtMetadata;
+}
+export interface SoundArtMetadata {
+    mode: 'SoundArt';
+    style: SoundArtSketchName;
+    timestamp: string;
+    soundFeatures: {
+        duration: number;
+        amplitude: number;
+        frequency: number;
+        bass: number;
+        treble: number;
+        aggression: number;
+    };
+    effects: {
+        timeFilter: boolean;
+        backgroundMode: string;
+    };
+    generationParams: {
+        seed: number;
+        canvasSize: {
+            width: number;
+            height: number;
+        };
+    };
+}
+/**
+ * Render a SoundArt style using Code Mode
+ *
+ * This is the main entry point for the new SoundArt → Code Mode pipeline.
+ */
+export declare function renderSoundArtViaCodeMode(options: SoundArtRenderOptions): Promise<SoundArtRenderResult>;
+/**
+ * Check if a SoundArt style can be rendered via Code Mode
+ */
+export declare function canRenderViaCodeMode(style: SoundArtSketchName): boolean;
+/**
+ * Get the list of SoundArt styles available via Code Mode
+ */
+export declare function getCodeModeAvailableStyles(): SoundArtSketchName[];
+export type { SoundSnapshot, SoundFeatures } from '../../shared/soundSnapshot';
+export type { SoundArtSketchName } from './soundart-sketches';
+//# sourceMappingURL=soundart-engine.d.ts.map

package/dist/soundart-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soundart-engine.d.ts","sourceRoot":"","sources":["../soundart-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAI/E,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3C,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE;QACP,UAAU,EAAE,OAAO,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,gBAAgB,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC;CACH;AAqCD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAoG/B;AA4BD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAEvE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,kBAAkB,EAAE,CAGjE;AAGD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/soundart-engine.js

@@ -0,0 +1,173 @@
+/**
+ * SoundArt → Code Mode Engine
+ *
+ * This is the orchestrator that runs SoundArt styles through the Code Mode engine.
+ * It replaces the old Canvas2D-based SoundArt renderer with a Code Mode pipeline.
+ *
+ * Architecture:
+ *   1. Sound analysis produces SoundFeatures (unchanged)
+ *   2. SoundFeatures → SoundSnapshot conversion
+ *   3. SoundSnapshot injected as S.* globals into Code Mode
+ *   4. SoundArt sketch executed via Code Mode runtime
+ *   5. Result: PNG or MP4 output
+ */
+import { createSoundSnapshot } from '../../shared/soundSnapshot';
+import { createP5Runtime } from './p5-runtime';
+import { injectSoundGlobals, generateSoundPalette, inferGenreProfile } from './sound-bridge';
+import { getSoundArtSketch } from './soundart-sketches';
+/**
+ * Apply tweak multipliers to a SoundSnapshot
+ */
+function applyTweaksToSnapshot(snapshot, tweaks) {
+    if (!tweaks)
+        return snapshot;
+    const clamp = (v, min, max) => Math.max(min, Math.min(max, v));
+    const tweaked = {
+        ...snapshot,
+        volume: snapshot.volume * (tweaks.volumeRangeFactor ?? 1),
+        brightness: snapshot.brightness * (tweaks.centroidBrightnessFactor ?? 1),
+        aggression: snapshot.aggression * (tweaks.aggressionPaletteFactor ?? 1),
+        rhythmicity: snapshot.rhythmicity * (tweaks.rhythmPatternFactor ?? 1),
+        harmonicity: snapshot.harmonicity * (tweaks.harmonySmoothnessFactor ?? 1),
+        attack: snapshot.attack * (tweaks.attackSharpnessFactor ?? 1),
+        dynamicRange: snapshot.dynamicRange * (tweaks.dynamicRangeVariationFactor ?? 1),
+        bass: snapshot.bass * (tweaks.bassThicknessFactor ?? 1),
+        treble: snapshot.treble * (tweaks.trebleSharpnessFactor ?? 1),
+    };
+    // Clamp all numeric values to reasonable range
+    tweaked.volume = clamp(tweaked.volume, 0, 250);
+    tweaked.brightness = clamp(tweaked.brightness, 0, 250);
+    tweaked.aggression = clamp(tweaked.aggression, 0, 250);
+    tweaked.rhythmicity = clamp(tweaked.rhythmicity, 0, 250);
+    tweaked.harmonicity = clamp(tweaked.harmonicity, 0, 250);
+    tweaked.attack = clamp(tweaked.attack, 0, 250);
+    tweaked.dynamicRange = clamp(tweaked.dynamicRange, 0, 250);
+    tweaked.bass = clamp(tweaked.bass, 0, 250);
+    tweaked.treble = clamp(tweaked.treble, 0, 250);
+    return tweaked;
+}
+/**
+ * Render a SoundArt style using Code Mode
+ *
+ * This is the main entry point for the new SoundArt → Code Mode pipeline.
+ */
+export async function renderSoundArtViaCodeMode(options) {
+    const { style, sound, canvas, config, onProgress } = options;
+    onProgress?.(0.1);
+    // 1. Get the sketch code
+    const sketchCode = getSoundArtSketch(style);
+    if (!sketchCode) {
+        throw new Error(`SoundArt style "${style}" has not been converted to Code Mode yet`);
+    }
+    onProgress?.(0.2);
+    // 2. Create SoundSnapshot from SoundFeatures
+    const baseSnapshot = createSoundSnapshot(sound, sound.frames);
+    // 3. Apply tweak multipliers to the snapshot
+    const snapshot = applyTweaksToSnapshot(baseSnapshot, config.tweakParams);
+    onProgress?.(0.3);
+    // 3. Create the p5 runtime with seeded randomness
+    // Derive deterministic seed from sound features if not provided
+    const deriveSeedFromSound = (sound) => {
+        // Create a stable hash from sound parameters
+        const hashInput = (sound.rms * 1000) +
+            (sound.centroid * 100) +
+            (sound.durationSec * 10000) +
+            ((sound.bands?.bass ?? 0) * 500) +
+            ((sound.bands?.treble ?? 0) * 700);
+        // Simple hash to integer
+        return Math.abs(Math.floor(hashInput * 2147483647) % 2147483647) || 123456;
+    };
+    const runtimeConfig = {
+        seed: config.seed ?? deriveSeedFromSound(sound),
+    };
+    canvas.width = config.width;
+    canvas.height = config.height;
+    const baseRuntime = createP5Runtime(canvas, config.width, config.height, runtimeConfig);
+    // 4. Inject sound globals (S.*)
+    const runtime = injectSoundGlobals(baseRuntime, snapshot);
+    onProgress?.(0.4);
+    // 5. Add helper globals
+    const globals = {
+        ...runtime,
+        width: config.width,
+        height: config.height,
+        backgroundMode: config.backgroundMode ?? 'rgb',
+        palette: generateSoundPalette(snapshot),
+        genre: inferGenreProfile(snapshot),
+    };
+    onProgress?.(0.5);
+    // 6. Execute the sketch
+    try {
+        executeSketch(sketchCode, globals);
+        onProgress?.(0.9);
+    }
+    catch (error) {
+        console.error(`[SoundArtEngine] Error executing style "${style}":`, error);
+        throw new Error(`Style "${style}" execution failed: ${error}`);
+    }
+    onProgress?.(1.0);
+    // 7. Build metadata
+    const metadata = {
+        mode: 'SoundArt',
+        style,
+        timestamp: new Date().toISOString(),
+        soundFeatures: {
+            duration: sound.durationSec,
+            amplitude: sound.rms,
+            frequency: sound.centroid,
+            bass: sound.bands?.bass ?? 0,
+            treble: sound.bands?.treble ?? 0,
+            aggression: snapshot.aggression,
+        },
+        effects: {
+            timeFilter: false,
+            backgroundMode: config.backgroundMode ?? 'rgb',
+        },
+        generationParams: {
+            seed: runtimeConfig.seed,
+            canvasSize: { width: config.width, height: config.height },
+        },
+    };
+    return {
+        style,
+        mode: 'soundart',
+        snapshot,
+        metadata,
+    };
+}
+/**
+ * Execute a sketch string in the context of the runtime globals
+ */
+function executeSketch(code, globals) {
+    // Build the function context with all globals
+    const globalNames = Object.keys(globals);
+    const globalValues = Object.values(globals);
+    // Wrap the sketch code to call setup() and optionally draw()
+    const wrappedCode = `
+    ${code}
+    
+    // Execute setup
+    if (typeof setup === 'function') {
+      setup();
+    }
+    
+    // For static mode, we don't call draw()
+    // Loop mode would call draw() in a frame loop
+  `;
+    // Create and execute the function
+    const sketchFunction = new Function(...globalNames, wrappedCode);
+    sketchFunction(...globalValues);
+}
+/**
+ * Check if a SoundArt style can be rendered via Code Mode
+ */
+export function canRenderViaCodeMode(style) {
+    return getSoundArtSketch(style) !== undefined;
+}
+/**
+ * Get the list of SoundArt styles available via Code Mode
+ */
+export function getCodeModeAvailableStyles() {
+    const { getAvailableSoundArtSketches } = require('./soundart-sketches');
+    return getAvailableSoundArtSketches();
+}

package/dist/soundart-sketches/chladniBloom.d.ts

@@ -0,0 +1,3 @@
+export declare const CHLADNI_BLOOM_SKETCH = "\nfunction setup() {\n  const bgMode = typeof backgroundMode !== 'undefined' ? backgroundMode : 'rgb';\n  if (bgMode === 'white') background(245, 245, 245);\n  else if (bgMode === 'black') background(10, 10, 10);\n  else {\n    const r = Math.floor((S.brightness / 100) * 255);\n    const g = Math.floor((S.rhythmicity / 100) * 255);\n    const b = Math.floor((S.harmonicity / 100) * 255);\n    background(r, g, b);\n  }\n\n  translate(width / 2, height / 2);\n  \n  const layers = Math.floor(map(S.volume + S.rhythmicity, 0, 200, 20, 90));\n  const minStrokeW = map(S.volume, 0, 100, 1.0, 3.0);\n  const maxStrokeW = map(S.treble, 0, 100, 2.0, 5.0);\n\n  noFill();\n\n  for (let i = 0; i < layers; i++) {\n    const freq1 = Math.floor(map(S.aggression + random() * 50, 0, 150, 3, 20));\n    const freq2 = Math.floor(map(S.treble + random() * 50, 0, 150, 2, 8));\n    const amp = map(S.dynamicRange + random() * 30, 0, 130, 60, 400);\n    const rotation = map(S.harmonicity + random() * 50, 0, 150, 0, PI * 4);\n    const radiusOffset = map(S.bass, 0, 100, 40, 80);\n    const strokeW = map(S.treble + S.volume * 0.5, 0, 100, minStrokeW, maxStrokeW);\n    \n    const hBase = (330 + random() * 100) % 360;\n    const finalH = (hBase + (random() * 40 - 60) + map(S.hue, 0, 100, -10, 10) + 360) % 360;\n    const finalC = constrain(85 + map(S.brightness, 0, 100, -20, 20), 0, 100);\n    const finalL = constrain(90 + map(S.brightness, 0, 100, -15, 15), 0, 100);\n    const finalA = constrain(0.5 + map(S.attack, 0, 100, 0, 0.5), 0.3, 1);\n\n    push();\n    rotate(rotation);\n    strokeWeight(strokeW);\n    stroke('hsla(' + finalH + ',' + finalC + '%,' + finalL + '%,' + finalA + ')');\n    \n    const angleStep = map(S.treble, 0, 100, 0.07, 0.03);\n    beginShape();\n    for (let aa = 0; aa < PI * 2; aa += angleStep) {\n      const rad = radiusOffset * i + amp * sin(freq1 * aa) * cos(freq2 * aa * map(S.rhythmicity, 0, 100, 0.3, 2));\n      const x = rad * cos(aa);\n      const y = rad * sin(aa);\n      vertex(x, y);\n    }\n    endShape(CLOSE);\n    pop();\n  }\n}\n";
+export default CHLADNI_BLOOM_SKETCH;
+//# sourceMappingURL=chladniBloom.d.ts.map

package/dist/soundart-sketches/chladniBloom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chladniBloom.d.ts","sourceRoot":"","sources":["../../soundart-sketches/chladniBloom.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,+hEAmDhC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/soundart-sketches/chladniBloom.js

@@ -0,0 +1,53 @@
+export const CHLADNI_BLOOM_SKETCH = `
+function setup() {
+  const bgMode = typeof backgroundMode !== 'undefined' ? backgroundMode : 'rgb';
+  if (bgMode === 'white') background(245, 245, 245);
+  else if (bgMode === 'black') background(10, 10, 10);
+  else {
+    const r = Math.floor((S.brightness / 100) * 255);
+    const g = Math.floor((S.rhythmicity / 100) * 255);
+    const b = Math.floor((S.harmonicity / 100) * 255);
+    background(r, g, b);
+  }
+
+  translate(width / 2, height / 2);
+  
+  const layers = Math.floor(map(S.volume + S.rhythmicity, 0, 200, 20, 90));
+  const minStrokeW = map(S.volume, 0, 100, 1.0, 3.0);
+  const maxStrokeW = map(S.treble, 0, 100, 2.0, 5.0);
+
+  noFill();
+
+  for (let i = 0; i < layers; i++) {
+    const freq1 = Math.floor(map(S.aggression + random() * 50, 0, 150, 3, 20));
+    const freq2 = Math.floor(map(S.treble + random() * 50, 0, 150, 2, 8));
+    const amp = map(S.dynamicRange + random() * 30, 0, 130, 60, 400);
+    const rotation = map(S.harmonicity + random() * 50, 0, 150, 0, PI * 4);
+    const radiusOffset = map(S.bass, 0, 100, 40, 80);
+    const strokeW = map(S.treble + S.volume * 0.5, 0, 100, minStrokeW, maxStrokeW);
+    
+    const hBase = (330 + random() * 100) % 360;
+    const finalH = (hBase + (random() * 40 - 60) + map(S.hue, 0, 100, -10, 10) + 360) % 360;
+    const finalC = constrain(85 + map(S.brightness, 0, 100, -20, 20), 0, 100);
+    const finalL = constrain(90 + map(S.brightness, 0, 100, -15, 15), 0, 100);
+    const finalA = constrain(0.5 + map(S.attack, 0, 100, 0, 0.5), 0.3, 1);
+
+    push();
+    rotate(rotation);
+    strokeWeight(strokeW);
+    stroke('hsla(' + finalH + ',' + finalC + '%,' + finalL + '%,' + finalA + ')');
+    
+    const angleStep = map(S.treble, 0, 100, 0.07, 0.03);
+    beginShape();
+    for (let aa = 0; aa < PI * 2; aa += angleStep) {
+      const rad = radiusOffset * i + amp * sin(freq1 * aa) * cos(freq2 * aa * map(S.rhythmicity, 0, 100, 0.3, 2));
+      const x = rad * cos(aa);
+      const y = rad * sin(aa);
+      vertex(x, y);
+    }
+    endShape(CLOSE);
+    pop();
+  }
+}
+`;
+export default CHLADNI_BLOOM_SKETCH;

package/dist/soundart-sketches/dualVortex.d.ts

@@ -0,0 +1,3 @@
+export declare const DUAL_VORTEX_SKETCH = "\nfunction setup() {\n  const bgMode = typeof backgroundMode !== 'undefined' ? backgroundMode : 'rgb';\n  if (bgMode === 'white') background(245, 245, 245);\n  else if (bgMode === 'black') background(10, 10, 10);\n  else {\n    const r = Math.floor((S.brightness / 100) * 255);\n    const g = Math.floor((S.rhythmicity / 100) * 255);\n    const b = Math.floor((S.harmonicity / 100) * 255);\n    background(r, g, b);\n  }\n\n  const presence = 1.0 - S.silence / 100;\n  const sizeFactor = (S.length * 0.7 + S.volume * 0.6);\n  const layers = Math.floor(map(S.length, 0, 100, 60, 180));\n  const baseR = map(sizeFactor, 0, 100, Math.min(width, height) * 0.15, Math.min(width, height) * 0.55);\n  const steps = Math.floor(map(S.attack, 0, 100, 180, 480));\n  const twist = map(S.harmonicity, 0, 100, 0.5, 3.5);\n  const bulge = map(S.aggression, 0, 100, 0.05, 0.55);\n  const waveF = map(S.rhythmicity, 0, 100, 0.8, 5.0);\n  const CY = height * 0.5 + map(S.bass, 0, 100, -height * 0.1, height * 0.1);\n  const wBase = map(S.volume, 0, 100, 1.5, 6.0);\n  const alphaLo = map(S.dynamicRange, 0, 100, 80, 180) * presence;\n  const alphaHi = map(S.dynamicRange, 0, 100, 180, 255) * presence;\n\n  const mainHue = (S.brightness * 3.6) % 360;\n  \n  noFill();\n\n  for (let pass = 0; pass < 2; pass++) {\n    const isSecond = pass === 0;\n    const alphaScale = isSecond ? 0.7 : 1.0;\n    const weightScale = isSecond ? 0.85 : 1.1;\n    \n    for (let i = 0; i < layers; i++) {\n      const t = i / (layers - 1);\n      const h = (mainHue + i * 22.5) % 360;\n      const sat = map(S.treble, 0, 100, 60, 90);\n      const bri = map(S.bass, 0, 100, 70, 95);\n      \n      const r0 = baseR * (0.6 + (isSecond ? 0.8 : 0.7) * sin(PI * 2 * t + 0.42));\n      const rot = t * (twist + 0.6) + sin(i * 0.05) * map(S.attack, 0, 100, 0.02, 0.12);\n      \n      const hueShift = (i / layers) * 120;\n      const finalH = (h + hueShift) % 360;\n      const a = lerp(alphaHi, alphaLo, pow(t, 0.9)) * alphaScale / 255;\n      \n      push();\n      translate(width * 0.5, CY);\n      rotate(rot);\n      \n      strokeWeight(max(0.6, wBase * weightScale));\n      stroke('hsla(' + finalH + ',' + sat + '%,' + bri + '%,' + constrain(a, 0, 1) + ')');\n      \n      beginShape();\n      for (let k = 0; k <= steps; k++) {\n        const ang = map(k, 0, steps, 0, PI * 2);\n        const baseRR = r0 * (1.0 + bulge * sin(ang * waveF + t * PI * 3));\n        vertex(baseRR * cos(ang), baseRR * sin(ang));\n      }\n      endShape(CLOSE);\n      pop();\n    }\n  }\n}\n";
+export default DUAL_VORTEX_SKETCH;
+//# sourceMappingURL=dualVortex.d.ts.map

package/dist/soundart-sketches/dualVortex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dualVortex.d.ts","sourceRoot":"","sources":["../../soundart-sketches/dualVortex.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,m/EAiE9B,CAAC;AAEF,eAAe,kBAAkB,CAAC"}