@nexart/codemode-sdk 1.1.1 → 1.4.0

package/dist/static-engine.d.ts

@@ -1,12 +1,9 @@
 /**
  * NexArt Code Mode Runtime SDK - Static Engine
- * Protocol: v1.0.0 (Phase 1) — HARD ENFORCEMENT
+ * 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.
- *
- * Determinism Guarantee:
- * Same code + same seed + same VARs = identical PNG output
  */
 import type { EngineConfig, RunOptions } from './types';
 export declare function runStaticMode(config: EngineConfig, options: RunOptions): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"static-engine.d.ts","sourceRoot":"","sources":["../static-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;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,CAkGf"}
+{"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,17 +1,14 @@
 /**
  * NexArt Code Mode Runtime SDK - Static Engine
- * Protocol: v1.0.0 (Phase 1) — HARD ENFORCEMENT
+ * 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.
- *
- * Determinism Guarantee:
- * Same code + same seed + same VARs = identical PNG output
  */
 import { DEFAULT_CONFIG } from './types';
-import { createP5Runtime, injectTimeVariables, injectProtocolVariables } from './p5-runtime';
+import { createP5Runtime, injectTimeVariables } from './p5-runtime';
 export async function runStaticMode(config, options) {
-    const { code, seed, vars, onPreview, onProgress, onComplete, onError } = options;
+    const { code, onPreview, onProgress, onComplete, onError } = options;
     const width = config.width ?? DEFAULT_CONFIG.width;
     const height = config.height ?? DEFAULT_CONFIG.height;
     try {
@@ -24,17 +21,16 @@ export async function runStaticMode(config, options) {
         const canvas = document.createElement('canvas');
         canvas.width = width;
         canvas.height = height;
-        // Create p5 runtime with optional seed for determinism
-        const p = createP5Runtime(canvas, width, height, { seed });
-        // Inject time variables (static = frame 0, t = 0)
+        // Create p5 runtime
+        const p = createP5Runtime(canvas, width, height);
+        // 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
         });
-        // Inject protocol variables (VAR[0..9])
-        injectProtocolVariables(p, vars);
         onProgress?.({
             phase: 'setup',
             percent: 10,
@@ -55,10 +51,10 @@ export async function runStaticMode(config, options) {
             percent: 30,
             message: 'Executing setup()...',
         });
-        // Create wrapped setup function with p5 context and VAR
-        const wrappedSetup = new Function('p', 'frameCount', 't', 'time', 'tGlobal', 'VAR', `with(p) { ${setupCode} }`);
+        // Create wrapped setup function with p5 context
+        const wrappedSetup = new Function('p', 'frameCount', 't', 'time', 'tGlobal', `with(p) { ${setupCode} }`);
         // Execute setup() only
-        wrappedSetup(p, 0, 0, 0, 0, p.VAR);
+        wrappedSetup(p, 0, 0, 0, 0);
         // Provide preview callback
         onPreview?.(canvas);
         onProgress?.({

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode Runtime SDK - Types
- * Version: 1.0.2 (Protocol v1.0.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.
@@ -12,8 +12,8 @@
 export declare const PROTOCOL_IDENTITY: {
     readonly protocol: "nexart";
     readonly engine: "codemode";
-    readonly protocolVersion: "1.0.0";
-    readonly phase: 1;
+    readonly protocolVersion: "1.2.0";
+    readonly phase: 3;
     readonly deterministic: true;
 };
 export type RenderMode = 'static' | 'loop';
@@ -56,13 +56,13 @@ export interface TimeVariables {
     t: number;
     time: number;
     tGlobal: number;
+    totalFrames: number;
 }
 /**
  * Protocol Variables (VAR[0..9])
  * First-class protocol inputs for deterministic rendering.
- * Used by SoundArt, Shapes, Noise, and ByX collections.
  *
- * Rules (SDK v1.0.2, Protocol v1.0.0):
+ * 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)
@@ -92,8 +92,8 @@ export declare const DEFAULT_CONFIG: {
 export interface ProtocolMetadata {
     protocol: 'nexart';
     engine: 'codemode';
-    protocolVersion: '1.0.0';
-    phase: 1;
+    protocolVersion: '1.2.0';
+    phase: 3;
     deterministic: true;
     seed: number;
     vars: number[];

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,6 +1,6 @@
 /**
  * NexArt Code Mode Runtime SDK - Types
- * Version: 1.0.2 (Protocol v1.0.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.
@@ -12,8 +12,8 @@
 export const PROTOCOL_IDENTITY = {
     protocol: 'nexart',
     engine: 'codemode',
-    protocolVersion: '1.0.0',
-    phase: 1,
+    protocolVersion: '1.2.0',
+    phase: 3,
     deterministic: true,
 };
 /**

package/package.json

@@ -1,42 +1,36 @@
 {
   "name": "@nexart/codemode-sdk",
-  "version": "1.1.1",
-  "description": "NexArt Code Mode SDK - Canonical execution engine for deterministic generative art",
+  "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",
   "type": "module",
-  "main": "./dist/core-index.js",
-  "types": "./dist/core-index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/core-index.d.ts",
-      "import": "./dist/core-index.js"
-    }
-  },
   "files": [
-    "dist",
-    "README.md",
-    "CHANGELOG.md",
-    "CODE_MODE_PROTOCOL.md"
+    "dist"
   ],
   "scripts": {
     "build": "tsc",
-    "test": "npx tsx smoke-test.ts",
-    "prepublishOnly": "npm run build && npm run test"
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
   },
   "keywords": [
-    "nexart",
     "generative-art",
-    "nft",
     "p5js",
+    "canvas",
+    "rendering",
     "deterministic",
-    "codemode"
+    "nft",
+    "creative-coding"
   ],
-  "author": "NexArt",
-  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/artnames/nexart-codemode-sdk.git"
   },
-  "devDependencies": {
-    "typescript": "^5.0.0"
+  "author": "NexArt",
+  "publishConfig": {
+    "access": "public"
   }
 }

package/CHANGELOG.md

@@ -1,109 +0,0 @@
-# Changelog
-
-All notable changes to @nexart/codemode-sdk will be documented in this file.
-
----
-
-## [1.1.1] — 2024-12-31
-
-### Critical Bug Fix: Seeded Random
-
-**BREAKING FIX**: The published npm package (v1.1.0 and earlier) had a critical bug where `random()` used `Math.random()` instead of the seeded Mulberry32 PRNG. This broke determinism guarantees.
-
-#### Fixed
-- `random()` now correctly uses seeded Mulberry32 PRNG
-- `randomSeed(seed)` now properly recreates the RNG with new seed
-- `randomGaussian()` now uses seeded Box-Muller transform
-- `noise()` now uses proper seeded Perlin noise with octaves
-- `noiseSeed(seed)` now properly recreates the noise generator
-- `lerpColor()` now properly interpolates colors (was returning c1)
-
-#### Changed
-- Rebuilt package with proper TypeScript compilation
-- Added standalone package.json and tsconfig.json for clean builds
-- New entry point: `core-index.ts` (excludes external dependencies)
-
-#### Verification
-```javascript
-// Same seed = same output (determinism restored)
-randomSeed(42);
-console.log(random()); // Always 0.8379...
-console.log(random()); // Always 0.9032...
-```
-
----
-
-## [1.1.0] — 2024-12-30
-
-### Minor Bump for npm Publishing (DEPRECATED)
-
-**WARNING**: This version had a critical bug. Use v1.1.1 or later.
-
-- Updated SDK version from 1.0.2 to 1.1.0
-- Protocol version remains v1.0.0 (unchanged)
-- No breaking changes from 1.0.2
-
----
-
-## [1.0.2] — 2024-12-30
-
-### Changed
-
-- **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, NO clamping)
-  - Runtime VAR is ALWAYS 10 elements (padded with zeros for consistency)
-- **VAR enforcement updated**
-  - Read-only via Proxy (throws on write attempts)
-  - Out-of-range values now throw (previously warned)
-- **Backwards compatible**: existing code passing 10 elements works unchanged
-
----
-
-## [1.0.1] — 2024-12-29
-
-### Documentation
-
-- Protocol Lock section formalized with HARD LOCKED status
-- VAR specification clarified with enforcement tables
-- CHANGELOG added to track version history
-- Smoke tests added for cross-SDK verification
-
----
-
-## [1.0.0] — 2024-12-29
-
-### Protocol Lock
-
-**NexArt Code Mode Protocol v1.0.0 is now HARD LOCKED.**
-
-This version establishes the canonical Code Mode execution surface for:
-- NexArt app
-- ByX curated collections
-- External builders and AI platforms
-
-### Frozen
-
-The following are locked and will not change in v1.x:
-
-- **Execution Model**: Static (setup-only) and Loop (frame-authoritative) modes
-- **VAR[0..9]**: Exactly 10 read-only protocol variables (0-100 recommended)
-- **Determinism**: Same code + same seed + same VARs = identical output
-- **Time Semantics**: t ∈ [0,1), frameCount, time, tGlobal
-- **Random**: Seeded Mulberry32 PRNG via random()
-- **Noise**: Seeded Perlin noise via noise()
-- **Forbidden Patterns**: 13 patterns rejected with [Code Mode Protocol Error]
-- **Canvas**: Pre-initialized, no createCanvas()
-
-### API
-
-- `executeCodeMode()` — Canonical entry point for all Code Mode execution
-- `validateCodeModeSource()` — Pre-flight validation without execution
-- `createEngine()` — Legacy API (still supported)
-
-### Notes
-
-- Any breaking change requires v2.0.0
-- VAR count is fixed at 10 and will not be extended
-- This version enables external builders to depend on stable protocol semantics

package/CODE_MODE_PROTOCOL.md

@@ -1,312 +0,0 @@
-# Code Mode Protocol v1.0.0 — Phase 1
-
-> **Status:** LOCKED  
-> **Enforcement:** HARD  
-> **Effective Date:** December 2024
-
-This document is **normative**. It defines the official Code Mode execution surface for NexArt Protocol. All implementations (NexArt app, ByX, external builders) MUST conform to this specification.
-
----
-
-## 1. Protocol Identity
-
-| Property | Value |
-|----------|-------|
-| Protocol | `nexart` |
-| Engine | `codemode` |
-| Version | `1.0.0` |
-| Phase | `1` |
-| Deterministic | `true` |
-
----
-
-## 2. Execution Modes
-
-### 2.1 Static Mode
-- Executes `setup()` once
-- `draw()` is **NOT** executed
-- Output: Single PNG image
-- Time variables: All `0`
-
-### 2.2 Loop Mode
-- Executes `setup()` once
-- Executes `draw()` for each frame
-- Canvas is cleared before each `draw()` call
-- Output: MP4 video (1-4 seconds, 30 FPS)
-- Requires `totalFrames` to be specified
-
----
-
-## 3. Protocol Variables (VAR[0..9])
-
-### 3.1 Definition
-- Input: 0-10 elements allowed (protocol error if > 10)
-- Runtime: ALWAYS 10 elements (padded with zeros)
-- Type: `readonly number[]`
-- Range: `0` to `100` (strict — protocol error if out of range)
-- Default: All zeros `[0, 0, 0, 0, 0, 0, 0, 0, 0, 0]`
-
-### 3.2 Access
-```javascript
-// ✅ Allowed - reading (missing indices return 0)
-let size = VAR[0];        // Returns provided value or 0
-let opacity = map(VAR[1], 0, 100, 0, 255);
-
-// ❌ Forbidden - writing (throws protocol error)
-VAR[0] = 50; // [Code Mode Protocol Error] VAR is read-only
-```
-
-### 3.3 Enforcement
-| Condition | Enforcement |
-|-----------|-------------|
-| Input length > 10 | HARD — throws protocol error |
-| Value outside 0-100 | HARD — throws protocol error |
-| Non-number value | HARD — throws protocol error |
-| Write attempt | HARD — throws protocol error |
-| Missing input | Runtime padded with zeros |
-
-- Input is normalized to 10 elements (padded with zeros)
-- VAR is wrapped in a write-blocking Proxy
-- Write attempts MUST throw an error
-- Write attempts MUST NOT modify values
-
----
-
-## 4. Supported Globals
-
-### 4.1 Canvas Environment
-| Global | Type | Description |
-|--------|------|-------------|
-| `width` | `number` | Canvas width (default: 1950) |
-| `height` | `number` | Canvas height (default: 2400) |
-
-### 4.2 Time Variables
-| Global | Type | Description |
-|--------|------|-------------|
-| `frameCount` | `number` | Current frame (0, 1, 2, ...) |
-| `t` | `number` | Normalized time [0.0, 1.0) |
-| `time` | `number` | Elapsed seconds |
-| `tGlobal` | `number` | Alias for `t` |
-
-### 4.3 Math Constants
-| Global | Value |
-|--------|-------|
-| `PI` | `3.141592653589793` |
-| `TWO_PI` | `6.283185307179586` |
-| `HALF_PI` | `1.5707963267948966` |
-| `QUARTER_PI` | `0.7853981633974483` |
-| `TAU` | `6.283185307179586` |
-
----
-
-## 5. Supported Functions (Phase 1)
-
-### 5.1 Drawing Primitives
-- `line(x1, y1, x2, y2)`
-- `rect(x, y, w, h, [r])`
-- `ellipse(x, y, w, h)`
-- `circle(x, y, d)`
-- `triangle(x1, y1, x2, y2, x3, y3)`
-- `quad(x1, y1, x2, y2, x3, y3, x4, y4)`
-- `arc(x, y, w, h, start, stop, [mode])`
-- `point(x, y)`
-- `beginShape()` / `vertex(x, y)` / `endShape([close])`
-- `bezier(x1, y1, cx1, cy1, cx2, cy2, x2, y2)`
-- `curve(x1, y1, x2, y2, x3, y3, x4, y4)`
-
-### 5.2 Style
-- `fill(...)` — Supports all CSS color formats
-- `noFill()`
-- `stroke(...)` — Supports all CSS color formats
-- `noStroke()`
-- `strokeWeight(w)`
-- `strokeCap(cap)`
-- `strokeJoin(join)`
-- `background(...)` — Supports all CSS color formats
-- `colorMode(mode, [max1], [max2], [max3], [maxA])`
-
-### 5.3 Color Functions
-- `color(...)` — Create color object
-- `lerpColor(c1, c2, amt)` — Interpolate colors
-- `red(c)` / `green(c)` / `blue(c)` / `alpha(c)` — Extract components
-- `hue(c)` / `saturation(c)` / `brightness(c)` — HSB extraction
-
-### 5.4 Transforms
-- `push()` / `pop()`
-- `translate(x, y)`
-- `rotate(angle)`
-- `scale(s)` / `scale(sx, sy)`
-- `resetMatrix()`
-- `shearX(angle)` / `shearY(angle)`
-
-### 5.5 Random (Seeded)
-- `random([min], [max])` — Seeded pseudo-random
-- `randomSeed(seed)` — Set random seed
-- `randomGaussian([mean], [sd])` — Seeded Gaussian
-
-### 5.6 Noise (Seeded)
-- `noise(x, [y], [z])` — Seeded Perlin noise
-- `noiseSeed(seed)` — Set noise seed
-- `noiseDetail(octaves, [falloff])` — Configure noise
-
-### 5.7 Math Utilities
-- `map(value, start1, stop1, start2, stop2)`
-- `constrain(value, min, max)`
-- `lerp(start, stop, amt)`
-- `dist(x1, y1, x2, y2)`
-- `mag(x, y)`
-- `norm(value, start, stop)`
-- `abs()` / `floor()` / `ceil()` / `round()` / `sqrt()` / `pow()` / `exp()` / `log()`
-- `sin()` / `cos()` / `tan()` / `asin()` / `acos()` / `atan()` / `atan2()`
-- `min()` / `max()`
-- `radians(degrees)` / `degrees(radians)`
-
-### 5.8 Text
-- `text(str, x, y)`
-- `textSize(size)`
-- `textFont(font)`
-- `textAlign(horizAlign, [vertAlign])`
-- `textWidth(str)`
-
-### 5.9 Image/Pixel
-- `loadPixels()` / `updatePixels()`
-- `get(x, y)` / `set(x, y, color)`
-- `pixels[]` — Pixel array
-- `createGraphics(w, h)` — Offscreen buffer
-
----
-
-## 6. Forbidden Patterns
-
-The following patterns are **explicitly forbidden** and MUST throw errors:
-
-| Pattern | Reason |
-|---------|--------|
-| `setTimeout()` | Async timing breaks determinism |
-| `setInterval()` | Async timing breaks determinism |
-| `requestAnimationFrame()` | Async timing breaks determinism |
-| `noLoop()` (in Loop Mode) | Incompatible with frame capture |
-| `createCanvas()` | Canvas is pre-initialized |
-| `fetch()` / `XMLHttpRequest` | External IO breaks determinism |
-| `import` / `require` | No external modules |
-| DOM manipulation | No direct DOM access |
-| `Date.now()` / `new Date()` | Time-based entropy breaks determinism |
-| `Math.random()` | Use `random()` instead (seeded) |
-
----
-
-## 7. Determinism Guarantees
-
-### 7.1 Invariant
-```
-Same code + Same seed + Same VARs = Identical output
-```
-
-### 7.2 Sources of Randomness
-- **Allowed:** `random()`, `noise()` — Both are seeded
-- **Forbidden:** `Math.random()`, `Date`, browser entropy
-
-### 7.3 Verification
-Any execution can be verified by re-running with the same inputs.
-
----
-
-## 8. Canonical Execution API
-
-### 8.1 Entry Point
-```typescript
-executeCodeMode({
-  source: string,
-  width: number,
-  height: number,
-  seed: number,
-  vars?: number[],
-  mode: 'static' | 'loop',
-  totalFrames?: number
-}) => Promise<ExecutionResult>
-```
-
-### 8.2 Result Structure
-```typescript
-interface ExecutionResult {
-  image?: Blob;           // Static mode: PNG
-  video?: Blob;           // Loop mode: MP4
-  frames?: ImageData[];   // Optional: raw frames
-  metadata: {
-    protocol: 'nexart';
-    engine: 'codemode';
-    protocolVersion: '1.0.0';
-    phase: 1;
-    deterministic: true;
-    seed: number;
-    vars: number[];
-    width: number;
-    height: number;
-    mode: 'static' | 'loop';
-    totalFrames?: number;
-  }
-}
-```
-
----
-
-## 9. Implementation Requirements
-
-### 9.1 SDK Authority
-- `@nexart/codemode-sdk` is the single source of truth
-- NexArt app, ByX, and external clients MUST delegate to this SDK
-- No other renderer may redefine Code Mode semantics
-
-### 9.2 Logging
-All executions MUST log:
-```
-[CodeMode] Rendered via @nexart/codemode-sdk (Protocol v1.0.0)
-```
-
-### 9.3 Error Handling
-- Missing `draw()` in Loop Mode → Error
-- Missing `totalFrames` in Loop Mode → Error
-- VAR mutation attempt → Warning + Error log (no crash)
-- Unsupported function → Clear error message
-
----
-
-## 10. Non-Goals (Phase 1)
-
-The following are **explicitly NOT part of Phase 1**:
-
-- ❌ Sliders or UI controls
-- ❌ Additional VAR slots beyond 10
-- ❌ New drawing primitives
-- ❌ WebGL or 3D rendering
-- ❌ Audio input/output
-- ❌ External asset loading
-- ❌ Performance optimizations
-
----
-
-## 11. Future Phases
-
-| Phase | Scope |
-|-------|-------|
-| Phase 2 | Additional primitives, shader support |
-| Phase 3 | External asset loading (controlled) |
-| Phase 4 | WebGL/3D support |
-
-Each phase requires a protocol version bump and formal specification.
-
----
-
-## 12. Changelog
-
-### v1.0.0 (December 2024)
-- Initial locked specification
-- VAR[0..9] read-only protocol variables
-- Full CSS color support
-- Seeded random/noise
-- Static + Loop modes
-- HARD enforcement enabled
-
----
-
-**End of Specification**

package/dist/core-index.d.ts

@@ -1,21 +0,0 @@
-/**
- * @nexart/codemode-sdk v1.1.0 — Core Exports
- *
- * Canonical execution engine for NexArt Code Mode.
- * This is the single source of truth for Code Mode semantics.
- *
- * Protocol: v1.0.0 (LOCKED)
- * Enforcement: HARD
- */
-export { executeCodeMode, validateCodeModeSource, } from './execute';
-export { type RenderMode, type TimeVariables, type ProtocolMetadata, type EngineConfig, type RenderResult, type RunOptions, type ProgressInfo, type Engine, type ExecuteCodeModeInput, type ExecuteCodeModeResult, PROTOCOL_IDENTITY, DEFAULT_VARS, DEFAULT_CONFIG, } from './types';
-export { createP5Runtime, injectTimeVariables, createProtocolVAR, VAR_COUNT, VAR_MIN, VAR_MAX, CODE_MODE_PROTOCOL_VERSION, CODE_MODE_PROTOCOL_PHASE, CODE_MODE_ENFORCEMENT, type P5Runtime, type P5RuntimeConfig, } from './p5-runtime';
-export { runStaticMode, } from './static-engine';
-export { runLoopMode, cancelLoopMode, } from './loop-engine';
-export { createEngine, } from './engine';
-/**
- * SDK Identity
- */
-export declare const SDK_VERSION = "1.1.1";
-export declare const SDK_NAME = "@nexart/codemode-sdk";
-//# sourceMappingURL=core-index.d.ts.map

package/dist/core-index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"core-index.d.ts","sourceRoot":"","sources":["../core-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,OAAO,EACP,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,GACb,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,QAAQ,yBAAyB,CAAC"}

package/dist/core-index.js

@@ -1,26 +0,0 @@
-/**
- * @nexart/codemode-sdk v1.1.0 — Core Exports
- *
- * Canonical execution engine for NexArt Code Mode.
- * This is the single source of truth for Code Mode semantics.
- *
- * Protocol: v1.0.0 (LOCKED)
- * Enforcement: HARD
- */
-// Core execution
-export { executeCodeMode, validateCodeModeSource, } from './execute';
-// Protocol types
-export { PROTOCOL_IDENTITY, DEFAULT_VARS, DEFAULT_CONFIG, } from './types';
-// Runtime
-export { createP5Runtime, injectTimeVariables, createProtocolVAR, VAR_COUNT, VAR_MIN, VAR_MAX, CODE_MODE_PROTOCOL_VERSION, CODE_MODE_PROTOCOL_PHASE, CODE_MODE_ENFORCEMENT, } from './p5-runtime';
-// Static engine
-export { runStaticMode, } from './static-engine';
-// Loop engine
-export { runLoopMode, cancelLoopMode, } from './loop-engine';
-// Engine utilities
-export { createEngine, } from './engine';
-/**
- * SDK Identity
- */
-export const SDK_VERSION = '1.1.1';
-export const SDK_NAME = '@nexart/codemode-sdk';