@nexart/codemode-sdk 1.5.1 → 1.7.0

package/dist/sdk/codemode/noise-sketches/fractalNoise.js

@@ -0,0 +1,121 @@
+/**
+ * Fractal Noise - Code Mode Sketch
+ *
+ * This sketch implements Perlin FBM and Cellular noise rendering
+ * through the Code Mode p5-runtime. Uses N.* globals for all parameters.
+ *
+ * Original: client/src/components/noise-canvas-simple.tsx
+ */
+export const FRACTAL_NOISE_SKETCH = `
+// Fractal Noise - Code Mode Sketch
+// Uses N.* noise globals and standard p5-like functions
+
+function setup() {
+  // Set seeded random for reproducibility
+  randomSeed(N.seed);
+  noiseSeed(N.seed);
+  
+  // Set background color
+  background(N.bgR, N.bgG, N.bgB);
+  
+  // Noise rendering parameters
+  const adjustedScale = N.scale * (1 / N.zoom) * 0.05;
+  const cellSize = 4; // Fixed for quality
+  
+  // Generate cellular points if needed
+  const numPoints = Math.floor(20 + N.cellDensity * 180);
+  const cellPoints = [];
+  for (let i = 0; i < numPoints; i++) {
+    cellPoints.push([random(0, width), random(0, height)]);
+  }
+  
+  // Helper: Perlin FBM (Fractional Brownian Motion)
+  function perlinFBM(x, y, scale) {
+    let value = 0;
+    let amplitude = 1;
+    let frequency = 1;
+    let maxValue = 0;
+    
+    const oct = Math.min(N.octaves, 6); // Cap for performance
+    
+    for (let i = 0; i < oct; i++) {
+      value += noise(x * scale * frequency, y * scale * frequency) * amplitude;
+      maxValue += amplitude;
+      amplitude *= N.persistence;
+      frequency *= N.lacunarity;
+    }
+    
+    return value / maxValue;
+  }
+  
+  // Helper: Cellular noise (Worley)
+  function cellularNoise(x, y, points) {
+    let sampleX = x;
+    let sampleY = y;
+    
+    // Warp distortion if using warp mode
+    if (N.isWarp && N.cellDistortion > 0) {
+      const distortionAmount = N.cellDistortion * 100;
+      sampleX += noise(x * 0.01, y * 0.01) * distortionAmount;
+      sampleY += noise(y * 0.01, x * 0.01) * distortionAmount;
+    }
+    
+    // Find distances to closest points
+    let minDist = 999999;
+    let secondMinDist = 999999;
+    
+    for (let i = 0; i < points.length; i++) {
+      const px = points[i][0];
+      const py = points[i][1];
+      const dx = sampleX - px;
+      const dy = sampleY - py;
+      const dist = Math.sqrt(dx * dx + dy * dy);
+      
+      if (dist < minDist) {
+        secondMinDist = minDist;
+        minDist = dist;
+      } else if (dist < secondMinDist) {
+        secondMinDist = dist;
+      }
+    }
+    
+    // Normalize distance
+    return Math.min(1.0, (secondMinDist - minDist) / 50);
+  }
+  
+  // Render the noise grid
+  noStroke();
+  
+  for (let y = 0; y < height; y += cellSize) {
+    for (let x = 0; x < width; x += cellSize) {
+      // Calculate Perlin value
+      const perlinValue = perlinFBM(x, y, adjustedScale);
+      
+      // Calculate final value based on blend mode
+      let finalValue = perlinValue;
+      
+      if (!N.isPerlinOnly) {
+        const cellValue = cellularNoise(x, y, cellPoints);
+        
+        if (N.isBlend) {
+          finalValue = perlinValue * cellValue;
+        } else if (N.isWarp) {
+          finalValue = (perlinValue + cellValue) / 2;
+        } else if (N.isInterleave) {
+          finalValue = (Math.floor(x / 20) + Math.floor(y / 20)) % 2 === 0
+            ? perlinValue
+            : cellValue;
+        }
+      }
+      
+      // Set opacity based on noise value
+      const alpha = map(finalValue, 0, 1, 0, 255);
+      
+      // Fill with noise color and calculated alpha
+      fill(N.noiseR, N.noiseG, N.noiseB, alpha);
+      rect(x, y, cellSize, cellSize);
+    }
+  }
+}
+`;
+export default FRACTAL_NOISE_SKETCH;

package/dist/sdk/codemode/noise-sketches/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Noise Sketches Index
+ *
+ * Exports all available noise sketch generators for the Code Mode runtime.
+ */
+import FRACTAL_NOISE_SKETCH from './fractalNoise';
+export type NoiseSketchName = 'fractalNoise';
+/**
+ * Get a noise sketch by name
+ */
+export declare function getNoiseSketch(name: NoiseSketchName): string;
+/**
+ * Check if a sketch name is valid
+ */
+export declare function isValidNoiseSketch(name: string): name is NoiseSketchName;
+/**
+ * Get list of all available noise sketch names
+ */
+export declare function getAvailableNoiseSketchNames(): NoiseSketchName[];
+export { FRACTAL_NOISE_SKETCH };
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/codemode/noise-sketches/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../noise-sketches/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,oBAAoB,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC;AAM7C;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,eAAe,CAExE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,eAAe,EAAE,CAEhE;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/sdk/codemode/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/sdk/codemode/p5-runtime.d.ts

@@ -0,0 +1,75 @@
+/**
+ * NexArt Code Mode Runtime SDK - p5-like Runtime
+ *
+ * ╔══════════════════════════════════════════════════════════════════════════╗
+ * ║  CODE MODE PROTOCOL v1.2.0 (Phase 3) — STABLE                             ║
+ * ║                                                                          ║
+ * ║  Status: HARD PROTOCOL ENFORCEMENT                                       ║
+ * ║  This is the stable, canonical execution surface.                        ║
+ * ║  SDKs, ByX, and external builders can depend on this API.                ║
+ * ║                                                                          ║
+ * ║  Phase 1 Surface:                                                        ║
+ * ║  - VAR[0..9]: 10 read-only protocol variables (0-100 range)              ║
+ * ║  - Drawing: line, rect, ellipse, circle, triangle, quad, arc, etc.       ║
+ * ║  - Style: fill, stroke, colorMode, strokeWeight                          ║
+ * ║  - Transform: push, pop, translate, rotate, scale                        ║
+ * ║  - Random: random(), randomSeed(), randomGaussian() (seeded)             ║
+ * ║  - Noise: noise(), noiseSeed(), noiseDetail() (seeded)                   ║
+ * ║  - Math: map, constrain, lerp, lerpColor, dist, mag, norm                ║
+ * ║  - Color: Full CSS format support, color extraction functions            ║
+ * ║  - Time: frameCount, t, time, tGlobal                                    ║
+ * ║                                                                          ║
+ * ║  Determinism Guarantees:                                                 ║
+ * ║  - Same code + same seed + same VARs = identical output                  ║
+ * ║  - No external state, no browser entropy, no time-based drift            ║
+ * ║  - Randomness ONLY from: random(), noise() (both seeded)                 ║
+ * ║                                                                          ║
+ * ║  ⚠️  Future changes require Phase 2+                                     ║
+ * ╚══════════════════════════════════════════════════════════════════════════╝
+ */
+import type { TimeVariables } from './types';
+/**
+ * Code Mode Protocol Version
+ * This constant defines the locked protocol version.
+ * Changes to the execution surface require a version bump.
+ */
+export declare const CODE_MODE_PROTOCOL_VERSION = "1.2.0";
+export declare const CODE_MODE_PROTOCOL_PHASE = 3;
+export declare const CODE_MODE_ENFORCEMENT: "HARD";
+export interface P5Runtime {
+    [key: string]: any;
+    width: number;
+    height: number;
+    frameCount: number;
+    PI: number;
+    TWO_PI: number;
+    HALF_PI: number;
+    QUARTER_PI: number;
+}
+export interface P5RuntimeConfig {
+    seed?: number;
+}
+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)
+ * SDK v1.0.2: VAR input is optional (0-10 elements), but runtime always has 10
+ */
+export declare const VAR_COUNT = 10;
+export declare const VAR_MIN = 0;
+export declare const VAR_MAX = 100;
+/**
+ * Create a protected, read-only VAR array for protocol execution.
+ *
+ * SDK v1.0.2 Rules (Protocol v1.0.0):
+ * - Input accepts 0-10 elements
+ * - Runtime VAR is ALWAYS 10 elements (padded with zeros)
+ * - Values are numeric, must be in 0-100 range (validated upstream)
+ * - Read-only: writes throw descriptive errors
+ * - Available in both setup() and draw()
+ */
+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/sdk/codemode/p5-runtime.d.ts.map

@@ -0,0 +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,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"}