@nexart/codemode-sdk 1.1.0 → 1.4.0

package/README.md

@@ -1,6 +1,6 @@
 # NexArt Code Mode Runtime SDK
 
-**Version: 1.0.2 (Protocol v1.0.0)**
+**Version: 1.4.0 (Protocol v1.2.0)**
 
 ╔══════════════════════════════════════════════════════════════════════════════╗
 ║  @nexart/codemode-sdk — Canonical Code Mode Authority                        ║
@@ -10,32 +10,32 @@
 ║                                                                              ║
 ║  Protocol: nexart                                                            ║
 ║  Engine: codemode                                                            ║
-║  SDK Version: 1.0.2                                                          ║
-║  Protocol Version: 1.0.0                                                     ║
-║  Phase: 1                                                                    ║
+║  SDK Version: 1.4.0                                                          ║
+║  Protocol Version: 1.2.0                                                     ║
+║  Phase: 3                                                                    ║
 ║  Enforcement: HARD                                                           ║
 ╚══════════════════════════════════════════════════════════════════════════════╝
 
 ---
 
-## PROTOCOL LOCK — v1.0.0
+## PROTOCOL LOCK — v1.x
 
 | Property | Value |
 |----------|-------|
 | Protocol Name | NexArt Code Mode |
-| Version | v1.0.0 |
-| Status | **HARD LOCKED** |
-| Phase | 1 |
-| Lock Date | December 2024 |
+| Version | v1.2.0 |
+| Status | **STABLE** |
+| Phase | 3 |
+| Lock Date | January 2026 |
 
-**This protocol surface is frozen. Any breaking change requires v2.0.0.**
+**Core protocol surface is frozen. Any breaking change requires v2.0.0.**
 
 The following are locked and will not change in v1.x:
 
 - Execution model (Static and Loop modes)
 - VAR[0..9] specification (0-10 read-only variables, missing indices return 0)
 - Determinism guarantee (seed + VAR → identical output)
-- Time semantics (t, frameCount, time, tGlobal)
+- Time semantics (t, frameCount, time, tGlobal, totalFrames)
 - Random and noise behavior (seeded Mulberry32, Perlin)
 - Forbidden patterns list (13 patterns)
 - Canvas pre-initialization (no createCanvas)
@@ -54,27 +54,42 @@ The answer is: "Whatever @nexart/codemode-sdk does — that is the protocol."
 
 ---
 
-## What's New in v1.0.2
+## What's New in v1.4.0 (Protocol v1.2.0)
 
-- **VAR input is now optional (0-10 elements)**
-  - Omit `vars` or pass `[]` for empty (defaults to all zeros)
-  - Input length must be 0-10 (throws if > 10)
-  - Values must be finite numbers in [0, 100] (throws if out of range)
-  - Runtime VAR is ALWAYS 10 elements (padded with zeros for consistency)
-- **Backwards compatible**: existing code passing 10 elements works unchanged
+**Phase 3 — Pixel & Graphics**
 
-## v1.0.1
+- **Vertex Functions**: `curveVertex(x, y)`, `bezierVertex(cx1, cy1, cx2, cy2, x, y)` for smooth curves
+- **Pixel System**: `loadPixels()`, `updatePixels()`, `pixels[]`, `get(x, y)`, `set(x, y, color)`
+- **Graphics System**: `createGraphics(w, h)`, `image(pg, x, y, w, h)` for offscreen rendering
+- **totalFrames**: Now injected into Loop Mode runtime
 
-- Protocol Lock section formalized with HARD LOCKED status
-- VAR specification clarified with enforcement tables
+## v1.3.0 (Protocol v1.1.0)
 
-## v1.0.0 (Protocol Lock)
+**Phase 2 — Expressive Extensions**
+
+- **Math Helpers**: `fract(n)`, `sign(n)`
+- **Vector Helpers**: `vec`, `vecAdd`, `vecSub`, `vecMult`, `vecMag`, `vecNorm`, `vecDist`
+- **Shape Helpers**: `polygon()`, `star()`
+- **Blend Modes**: `blendMode(NORMAL|ADD|MULTIPLY|SCREEN)`
+- **Noise Extensions**: `fbm()`, `ridgedNoise()`, `curlNoise()`
+- **Easing Functions**: `easeIn`, `easeOut`, `easeInOut`, `easeCubic`, `easeExpo`
+
+## v1.2.0
+
+- Added `bezier()`, `curve()`, `strokeCap()`, `strokeJoin()`, `shearX()`, `shearY()`
+- Added text system: `text()`, `textSize()`, `textFont()`, `textAlign()`, `textWidth()`
+- Added `sq()`, `int()`, `TAU`, arc mode constants
+
+## v1.1.1
+
+- **Critical Fix**: `random()` now uses seeded Mulberry32 PRNG (was using Math.random)
+- All randomness is now deterministic
+
+## v1.0.x (Protocol Lock)
 
 - **Protocol Lock**: Phase 1 execution surface is now LOCKED
 - **Canonical Entry Point**: `executeCodeMode()` is the official execution API
-- **Protocol Metadata**: All executions include protocol headers for verification
 - **VAR[0..9] Protocol Variables**: First-class protocol inputs (read-only, 0-100)
-- **Full CSS Color Support**: hex, rgb(), rgba(), hsl(), hsla()
 - **Determinism Guarantee**: Same code + seed + vars = identical output
 
 ---
@@ -88,7 +103,7 @@ This SDK provides the **canonical runtime** for executing p5.js-style generative
 - **Deterministic**: Seed-controlled randomness, no external state
 - **Protocol-Compliant**: All outputs include verification metadata
 
-The SDK enforces the **NexArt Code Mode Protocol v1.0.0** for reproducible, mint-safe generative art.
+The SDK enforces the **NexArt Code Mode Protocol v1.2.0** for reproducible, mint-safe generative art.
 
 ---
 
@@ -139,7 +154,7 @@ const result = await executeCodeMode({
 // Result includes protocol metadata
 console.log(result.metadata.protocol);        // 'nexart'
 console.log(result.metadata.engine);          // 'codemode'
-console.log(result.metadata.protocolVersion); // '1.0.0'
+console.log(result.metadata.protocolVersion); // '1.2.0'
 console.log(result.metadata.deterministic);   // true
 console.log(result.image);                    // PNG Blob
 ```
@@ -152,7 +167,7 @@ console.log(result.image);                    // PNG Blob
 | `width` | `number` | ✅ | Canvas width in pixels |
 | `height` | `number` | ✅ | Canvas height in pixels |
 | `seed` | `number` | ✅ | Seed for deterministic randomness |
-| `vars` | `number[]` | ❌ | VAR values (0-10 elements, 0-100 range), missing indices return 0 |
+| `vars` | `number[]` | ❌ | VAR[0..9] values (0-100), defaults to all zeros |
 | `mode` | `'static' \| 'loop'` | ✅ | Execution mode |
 | `totalFrames` | `number` | ⚠️ | Required for loop mode |
 
@@ -166,8 +181,8 @@ interface ExecuteCodeModeResult {
   metadata: {
     protocol: 'nexart';
     engine: 'codemode';
-    protocolVersion: '1.0.0';
-    phase: 1;
+    protocolVersion: '1.2.0';
+    phase: 3;
     deterministic: true;
     seed: number;
     vars: number[];
@@ -185,7 +200,7 @@ interface ExecuteCodeModeResult {
 
 Protocol variables are first-class inputs that control artwork parameters.
 
-**VAR Specification (SDK v1.0.2):**
+**VAR Specification:**
 
 | Property | Value | Enforcement |
 |----------|-------|-------------|
@@ -242,6 +257,7 @@ function setup() {
 | `t` | float | Normalized time [0.0, 1.0) |
 | `time` | float | Elapsed seconds |
 | `tGlobal` | float | Alias for `t` |
+| `totalFrames` | int | Total frames in loop (v1.4.0+) |
 
 ---
 
@@ -272,23 +288,38 @@ Additionally in Loop Mode:
 
 ## Supported Functions
 
-The SDK includes a minimal p5.js-like runtime with:
+The SDK includes a comprehensive p5.js-like runtime with 130+ functions:
 
 **Drawing:**
-`background`, `clear`, `fill`, `noFill`, `stroke`, `noStroke`, `strokeWeight`
+`background`, `clear`, `fill`, `noFill`, `stroke`, `noStroke`, `strokeWeight`, `strokeCap`, `strokeJoin`
 
 **Shapes:**
-`ellipse`, `circle`, `rect`, `square`, `line`, `point`, `triangle`, `quad`, `arc`
+`ellipse`, `circle`, `rect`, `square`, `line`, `point`, `triangle`, `quad`, `arc`, `bezier`, `curve`
 
-**Vertex:**
-`beginShape`, `vertex`, `endShape`
+**Vertex (v1.4.0):**
+`beginShape`, `vertex`, `curveVertex`, `bezierVertex`, `endShape`
+
+**Shape Helpers (v1.3.0):**
+`polygon`, `star`
 
 **Transform:**
-`push`, `pop`, `translate`, `rotate`, `scale`, `resetMatrix`
+`push`, `pop`, `translate`, `rotate`, `scale`, `resetMatrix`, `shearX`, `shearY`
 
 **Color:**
 `colorMode`, `color`, `lerpColor`, `red`, `green`, `blue`, `alpha`, `hue`, `saturation`, `brightness`
 
+**Text:**
+`text`, `textSize`, `textFont`, `textAlign`, `textWidth`
+
+**Blend Modes (v1.3.0):**
+`blendMode(NORMAL|ADD|MULTIPLY|SCREEN)`
+
+**Pixel System (v1.4.0):**
+`loadPixels`, `updatePixels`, `pixels[]`, `get`, `set`
+
+**Graphics (v1.4.0):**
+`createGraphics`, `image`
+
 **Color Formats:**
 All of the following are accepted by `fill()`, `stroke()`, `background()`:
 - Grayscale: `fill(128)`, `fill(128, 127)`
@@ -300,13 +331,22 @@ All of the following are accepted by `fill()`, `stroke()`, `background()`:
 `VAR` — Array of 10 values (VAR[0] through VAR[9])
 
 **Math:**
-`random`, `noise`, `map`, `constrain`, `lerp`, `dist`, `mag`, `norm`
+`random`, `noise`, `map`, `constrain`, `lerp`, `dist`, `mag`, `norm`, `sq`, `int`, `fract`, `sign`
+
+**Vectors (v1.3.0):**
+`vec`, `vecAdd`, `vecSub`, `vecMult`, `vecMag`, `vecNorm`, `vecDist`
+
+**Noise Extensions (v1.3.0):**
+`fbm`, `ridgedNoise`, `curlNoise`
+
+**Easing (v1.3.0):**
+`easeIn`, `easeOut`, `easeInOut`, `easeCubic`, `easeExpo`
 
 **Trig:**
 `sin`, `cos`, `tan`, `asin`, `acos`, `atan`, `atan2`, `radians`, `degrees`
 
 **Constants:**
-`PI`, `TWO_PI`, `HALF_PI`, `QUARTER_PI`, `width`, `height`, `frameCount`
+`PI`, `TWO_PI`, `TAU`, `HALF_PI`, `QUARTER_PI`, `width`, `height`, `frameCount`, `totalFrames`
 
 ---
 
@@ -347,13 +387,13 @@ const result = await executeCodeMode({
   width: 1950,
   height: 2400,
   seed: 12345,
-  vars: [50, 75, 25, 0, 0, 0, 0, 0, 0, 0],  // Exactly 10 values
+  vars: [50, 75, 25, 0, 0, 0, 0, 0, 0, 0],
   mode: 'static'
 });
 
 // Result includes full protocol metadata for verification
 const { image, metadata } = result;
-console.log(metadata.protocolVersion); // '1.0.0'
+console.log(metadata.protocolVersion); // '1.2.0'
 console.log(metadata.deterministic);   // true
 ```
 
@@ -391,7 +431,6 @@ Ensure your server has this endpoint available (NexArt provides this).
 @nexart/codemode-sdk/
 ├── index.ts         # Main export
 ├── engine.ts        # createEngine entry point
-├── execute.ts       # Canonical executeCodeMode API
 ├── types.ts         # TypeScript types
 ├── static-engine.ts # Static mode implementation
 ├── loop-engine.ts   # Loop mode implementation
@@ -401,22 +440,8 @@ Ensure your server has this endpoint available (NexArt provides this).
 
 ---
 
-## Changelog
-
-**1.0.2** — VAR is now optional (0-10 elements). Missing indices return 0. Out-of-range throws.
-
-**1.0.1** — Protocol Lock formalized. VAR specification clarified. CHANGELOG added.
-
-**1.0.0** — Protocol Lock. Phase 1 execution surface HARD LOCKED. executeCodeMode() canonical API.
-
-**0.1.1** — Fixed beginShape / vertex / endShape rendering bug.
-
-**0.1.0** — Initial release.
-
----
-
 ## License
 
 MIT License
 
-Copyright (c) 2024 NexArt
+Copyright (c) 2024-2026 NexArt

package/dist/engine.d.ts

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode Runtime SDK
- * Version: 0.1.0
+ * Version: 1.4.0 (Protocol v1.2.0)
  *
  * Main entry point for the Code Mode runtime engine.
  *

package/dist/engine.js

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode Runtime SDK
- * Version: 0.1.0
+ * Version: 1.4.0 (Protocol v1.2.0)
  *
  * Main entry point for the Code Mode runtime engine.
  *

package/dist/index.d.ts

@@ -1,9 +1,20 @@
 /**
  * NexArt Code Mode Runtime SDK
- * Version: 0.1.0
+ * Version: 1.4.0 (Protocol v1.2.0)
  *
- * A minimal, deterministic rendering engine for generative art.
- * Supports Static (PNG) and Loop (MP4) modes.
+ * ╔══════════════════════════════════════════════════════════════════════════╗
+ * ║  @nexart/codemode-sdk — Canonical Code Mode Authority                    ║
+ * ║                                                                          ║
+ * ║  This SDK defines the official Code Mode execution surface.              ║
+ * ║  All implementations (NexArt, ByX, external) MUST use this SDK.          ║
+ * ║                                                                          ║
+ * ║  Protocol: nexart                                                        ║
+ * ║  Engine: codemode                                                        ║
+ * ║  SDK Version: 1.4.0                                                      ║
+ * ║  Protocol Version: 1.2.0                                                 ║
+ * ║  Phase: 3                                                                ║
+ * ║  Enforcement: HARD                                                       ║
+ * ╚══════════════════════════════════════════════════════════════════════════╝
  *
  * @example
  * ```typescript
@@ -27,5 +38,5 @@
  */
 export { createEngine } from './engine';
 export type { Engine, EngineConfig, RunOptions, RenderResult, ProgressInfo, RenderMode, TimeVariables, } from './types';
-export { DEFAULT_CONFIG } from './types';
+export { DEFAULT_CONFIG, PROTOCOL_IDENTITY } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EACV,MAAM,EACN,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EACV,MAAM,EACN,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,9 +1,20 @@
 /**
  * NexArt Code Mode Runtime SDK
- * Version: 0.1.0
+ * Version: 1.4.0 (Protocol v1.2.0)
  *
- * A minimal, deterministic rendering engine for generative art.
- * Supports Static (PNG) and Loop (MP4) modes.
+ * ╔══════════════════════════════════════════════════════════════════════════╗
+ * ║  @nexart/codemode-sdk — Canonical Code Mode Authority                    ║
+ * ║                                                                          ║
+ * ║  This SDK defines the official Code Mode execution surface.              ║
+ * ║  All implementations (NexArt, ByX, external) MUST use this SDK.          ║
+ * ║                                                                          ║
+ * ║  Protocol: nexart                                                        ║
+ * ║  Engine: codemode                                                        ║
+ * ║  SDK Version: 1.4.0                                                      ║
+ * ║  Protocol Version: 1.2.0                                                 ║
+ * ║  Phase: 3                                                                ║
+ * ║  Enforcement: HARD                                                       ║
+ * ╚══════════════════════════════════════════════════════════════════════════╝
  *
  * @example
  * ```typescript
@@ -26,4 +37,4 @@
  * ```
  */
 export { createEngine } from './engine';
-export { DEFAULT_CONFIG } from './types';
+export { DEFAULT_CONFIG, PROTOCOL_IDENTITY } from './types';

package/dist/loop-engine.d.ts

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode Runtime SDK - Loop Engine
- * Version: 0.1.0
+ * Version: 1.4.0 (Protocol v1.2.0)
  *
  * Loop mode renderer: frame-authoritative, stateless execution.
  * - Executes setup() once

package/dist/loop-engine.js

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode Runtime SDK - Loop Engine
- * Version: 0.1.0
+ * Version: 1.4.0 (Protocol v1.2.0)
  *
  * Loop mode renderer: frame-authoritative, stateless execution.
  * - Executes setup() once

package/dist/p5-runtime.d.ts

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode Runtime SDK - p5-like Runtime
- * Version: 0.1.1
+ * 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.

package/dist/p5-runtime.js

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode Runtime SDK - p5-like Runtime
- * Version: 0.1.1
+ * 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.

package/dist/static-engine.d.ts

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode Runtime SDK - Static Engine
- * Version: 0.1.0
+ * Version: 1.4.0 (Protocol v1.2.0)
  *
  * Static mode renderer: executes setup() only, captures single PNG.
  * Does NOT execute draw() - per NexArt Execution Specification v1.

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

@@ -1 +1 @@
-{"version":3,"file":"static-engine.d.ts","sourceRoot":"","sources":["../static-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAC;AAItE,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CA+Ff"}
+{"version":3,"file":"static-engine.d.ts","sourceRoot":"","sources":["../static-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAC;AAItE,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAgGf"}

package/dist/static-engine.js

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode Runtime SDK - Static Engine
- * Version: 0.1.0
+ * Version: 1.4.0 (Protocol v1.2.0)
  *
  * Static mode renderer: executes setup() only, captures single PNG.
  * Does NOT execute draw() - per NexArt Execution Specification v1.
@@ -23,12 +23,13 @@ export async function runStaticMode(config, options) {
         canvas.height = height;
         // Create p5 runtime
         const p = createP5Runtime(canvas, width, height);
-        // Inject time variables (static = frame 0, t = 0)
+        // Inject time variables (static = frame 0, t = 0, totalFrames = 1)
         injectTimeVariables(p, {
             frameCount: 0,
             t: 0,
             time: 0,
             tGlobal: 0,
+            totalFrames: 1, // Static mode has 1 frame
         });
         onProgress?.({
             phase: 'setup',

package/dist/types.d.ts

@@ -1,9 +1,21 @@
 /**
  * NexArt Code Mode Runtime SDK - Types
- * Version: 0.1.0
+ * Version: 1.4.0 (Protocol v1.2.0)
  *
  * Type definitions for the Code Mode runtime engine.
+ * This is the canonical type surface for @nexart/codemode-sdk.
  */
+/**
+ * Protocol Constants
+ * These define the locked protocol identity.
+ */
+export declare const PROTOCOL_IDENTITY: {
+    readonly protocol: "nexart";
+    readonly engine: "codemode";
+    readonly protocolVersion: "1.2.0";
+    readonly phase: 3;
+    readonly deterministic: true;
+};
 export type RenderMode = 'static' | 'loop';
 export interface EngineConfig {
     mode: RenderMode;
@@ -20,6 +32,8 @@ export interface RenderResult {
 }
 export interface RunOptions {
     code: string;
+    seed?: number;
+    vars?: number[];
     onPreview?: (canvas: HTMLCanvasElement) => void;
     onProgress?: (progress: ProgressInfo) => void;
     onComplete: (result: RenderResult) => void;
@@ -42,7 +56,27 @@ export interface TimeVariables {
     t: number;
     time: number;
     tGlobal: number;
+    totalFrames: number;
 }
+/**
+ * Protocol Variables (VAR[0..9])
+ * First-class protocol inputs for deterministic rendering.
+ *
+ * Rules (SDK v1.4.0, Protocol v1.2.0):
+ * - Input array can have 0-10 elements (protocol error if > 10)
+ * - All values MUST be finite numbers (protocol error if not)
+ * - Values MUST be in range 0-100 (protocol error if out of range, NO clamping)
+ * - Runtime VAR is ALWAYS 10 elements (padded with zeros for consistency)
+ * - Read-only inside sketches (write attempts throw protocol error)
+ * - Default: all zeros if not provided
+ */
+export interface ProtocolVariables {
+    VAR: readonly [number, number, number, number, number, number, number, number, number, number];
+}
+/**
+ * Default protocol variables (all zeros)
+ */
+export declare const DEFAULT_VARS: ProtocolVariables;
 export declare const DEFAULT_CONFIG: {
     readonly width: 1950;
     readonly height: 2400;
@@ -51,4 +85,44 @@ export declare const DEFAULT_CONFIG: {
     readonly minDuration: 1;
     readonly maxDuration: 4;
 };
+/**
+ * Protocol Metadata
+ * Attached to every execution result for verification.
+ */
+export interface ProtocolMetadata {
+    protocol: 'nexart';
+    engine: 'codemode';
+    protocolVersion: '1.2.0';
+    phase: 3;
+    deterministic: true;
+    seed: number;
+    vars: number[];
+    width: number;
+    height: number;
+    mode: RenderMode;
+    totalFrames?: number;
+}
+/**
+ * Canonical Execution Input
+ * The single entry point for all Code Mode execution.
+ */
+export interface ExecuteCodeModeInput {
+    source: string;
+    width: number;
+    height: number;
+    seed: number;
+    vars?: number[];
+    mode: RenderMode;
+    totalFrames?: number;
+}
+/**
+ * Canonical Execution Result
+ * Every execution produces this structure.
+ */
+export interface ExecuteCodeModeResult {
+    image?: Blob;
+    video?: Blob;
+    frames?: ImageData[];
+    metadata: ProtocolMetadata;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAChD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9C,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,SAAS,EAAE,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,9 +1,27 @@
 /**
  * NexArt Code Mode Runtime SDK - Types
- * Version: 0.1.0
+ * Version: 1.4.0 (Protocol v1.2.0)
  *
  * Type definitions for the Code Mode runtime engine.
+ * This is the canonical type surface for @nexart/codemode-sdk.
  */
+/**
+ * Protocol Constants
+ * These define the locked protocol identity.
+ */
+export const PROTOCOL_IDENTITY = {
+    protocol: 'nexart',
+    engine: 'codemode',
+    protocolVersion: '1.2.0',
+    phase: 3,
+    deterministic: true,
+};
+/**
+ * Default protocol variables (all zeros)
+ */
+export const DEFAULT_VARS = {
+    VAR: Object.freeze([0, 0, 0, 0, 0, 0, 0, 0, 0, 0])
+};
 export const DEFAULT_CONFIG = {
     width: 1950,
     height: 2400,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nexart/codemode-sdk",
-  "version": "1.1.0",
-  "description": "NexArt Code Mode Runtime SDK - Deterministic generative art rendering engine",
+  "version": "1.4.0",
+  "description": "NexArt Code Mode Runtime SDK - Deterministic generative art rendering engine (Protocol v1.2.0)",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",