@nexart/codemode-sdk 1.4.0 → 1.5.0

package/dist/p5-runtime.d.ts

@@ -1,11 +1,41 @@
 /**
  * NexArt Code Mode Runtime SDK - p5-like Runtime
- * Version: 1.4.0 (Protocol v1.2.0)
  *
- * Minimal p5.js-like runtime for deterministic generative art execution.
- * This is a headless runtime - no UI dependencies.
+ * ╔══════════════════════════════════════════════════════════════════════════╗
+ * ║  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;
@@ -16,6 +46,28 @@ export interface P5Runtime {
     HALF_PI: number;
     QUARTER_PI: number;
 }
-export declare function createP5Runtime(canvas: HTMLCanvasElement, width: number, height: number): P5Runtime;
+export interface P5RuntimeConfig {
+    seed?: number;
+}
+export declare function createP5Runtime(canvas: HTMLCanvasElement, 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;
 //# 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;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,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;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,SAAS,CAqVX;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,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,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"}