@nexart/ui-renderer 0.2.1 → 0.4.0

package/README.md

@@ -1,36 +1,177 @@
 # @nexart/ui-renderer
 
-Version: 0.2.1
+Version: 0.4.0
 
-**Declarative System Authoring SDK for NexArt Protocol**
+**Declarative and Code Mode System Authoring SDK for NexArt Protocol**
 
 ---
 
-> ⚠️ **IMPORTANT DISCLAIMER**
+> **This SDK is a PREVIEW MIRROR, not an authority.**
 >
-> **This SDK is for authoring and preview only.**
-> **Canonical, archival output is produced exclusively by @nexart/codemode-sdk.**
+> It mirrors the behavior of @nexart/codemode-sdk faithfully for preview purposes.
 >
-> This SDK is:
+> It is:
 > - **NOT canonical** — Does not produce archival-quality output
-> - **NOT archival** — Not suitable for NFT minting
-> - **NOT protocol-authoritative** — Best-effort rendering only
+> - **NOT archival** — Not the source of truth for production rendering
+> - **NOT protocol-authoritative** — Delegates all Code Mode execution semantics
 >
-> Same system → same preview output within this SDK, but **preview ≠ mint truth**.
+> Same inputs → same restrictions → same errors → same semantics as @nexart/codemode-sdk.
 
 ---
 
-## Philosophy
+## PROTOCOL LOCK — v1.0.0 (MIRROR)
 
-The NexArt Protocol defines how generative art systems work. This SDK provides:
+| Property | Value |
+|----------|-------|
+| Protocol Name | NexArt Code Mode |
+| Version | v1.0.0 |
+| Status | **HARD LOCKED** |
+| This SDK | Mirror only — NOT authoritative |
+| Canonical Authority | @nexart/codemode-sdk |
+| Lock Date | December 2024 |
 
-1. **System Authoring** — Declarative API to define NexArt systems
-2. **Preview Rendering** — Visual approximation in the browser
-3. **Compilation** — Export protocol-compatible JSON for canonical execution
+**This SDK mirrors the frozen v1.0.0 protocol surface. Any future protocol change requires v2.0.0 in @nexart/codemode-sdk first.**
 
-This SDK exists to **reduce friction** for builders, artists, and AI platforms. It is the front door to the NexArt Protocol — not the authority.
+This SDK mirrors:
+- Execution model (Static and Loop modes)
+- VAR[0..9] specification (exactly 10 read-only variables)
+- Determinism behavior (seed + VAR → consistent preview)
+- Time semantics (t, frameCount, time, tGlobal)
+- Forbidden patterns list (13 patterns)
+- Error message format (`[Code Mode Protocol Error]`)
 
-**Canonical execution happens via `@nexart/codemode-sdk`.**
+---
+
+## Protocol Alignment (v1.0.0)
+
+This SDK mirrors NexArt Protocol behavior. It is NOT canonical.
+
+**Canonical execution is performed exclusively by @nexart/codemode-sdk.**
+
+This SDK exists for:
+- Preview and prototyping
+- Tooling and AI builders
+- Development and experimentation
+
+### Authority Boundaries
+
+| Aspect | This SDK | @nexart/codemode-sdk |
+|--------|----------|---------------------|
+| Authority | None — mirror only | Canonical gate |
+| Determinism | Mirrors protocol RNG | Authoritative RNG |
+| VAR Handling | Protocol-aligned (read-only, 0-100) | Authoritative enforcement |
+| Error Behavior | Mirrors protocol errors | Defines protocol errors |
+| Output | Preview-quality | Archival-quality |
+
+### HARD Enforcement Modes
+
+This SDK mirrors the following protocol-enforced modes:
+- **Code Mode** — Seeded RNG, VAR[0..9], forbidden patterns
+- **SoundArt** — Audio-to-visual transformation via Code Mode
+- **Noise** — Perlin/Cellular noise via Code Mode
+- **Shapes** — Geometric generation via Code Mode
+
+### Forbidden Patterns
+
+The following patterns are rejected (mirroring @nexart/codemode-sdk exactly):
+
+- `setTimeout`, `setInterval`, `requestAnimationFrame` — async timing
+- `Date.now()`, `new Date()` — time-based entropy
+- `Math.random()` — use `random()` instead (seeded)
+- `fetch()`, `XMLHttpRequest` — external IO
+- `createCanvas()` — canvas is pre-initialized
+- `document.*`, `window.*` — DOM access forbidden
+- `import`, `require()` — external imports forbidden
+
+### VAR Protocol — LOCKED v1.0.0 (MIRROR)
+
+VAR[0..9] is a read-only array of 10 protocol variables (0-100 recommended).
+
+**VAR Specification (FROZEN — mirrors @nexart/codemode-sdk):**
+
+| Property | Value | Enforcement |
+|----------|-------|-------------|
+| Count | Exactly 10 (VAR[0]..VAR[9]) | HARD — throws if not 10 |
+| Type | number | HARD — throws if non-number |
+| Range | 0-100 recommended | SOFT — warns, does NOT clamp |
+| Mutability | Read-only | HARD — frozen, writes blocked |
+| Injection | Before execution | Guaranteed |
+| Lifecycle | Stable for entire render | Guaranteed |
+| Default | All zeros | If not provided |
+
+**This specification is INTENTIONAL and MUST NOT be extended in v1.x.**
+
+**DO NOT** add support for dynamic-length VAR arrays.  
+**DO NOT** allow user-defined VAR counts.
+
+```typescript
+// Correct usage
+const size = map(VAR[0], 0, 100, 10, 200);
+const count = floor(map(VAR[1], 0, 100, 5, 50));
+
+// Error: VAR is read-only
+VAR[0] = 50; // Blocked with warning
+```
+
+**Error examples:**
+```typescript
+// Protocol error: wrong length
+vars: [50, 50, 50] // "[Code Mode Protocol Error] VAR array must have exactly 10 elements"
+
+// Warning only: out of range (not clamped)
+vars: [150, 50, 50, 50, 50, 50, 50, 50, 50, 50] // Warns but allows
+```
+
+---
+
+## Supported Element Types
+
+The SDK supports three element types, rendered in order:
+
+### `background`
+
+Opinionated presets with guardrails. Provides consistent, protocol-aligned backgrounds.
+
+```typescript
+{
+  type: 'background',
+  style: 'gradient',  // gradient, solid, noise, grain
+  palette: 'warm'     // warm, cool, neutral, vibrant
+}
+```
+
+### `primitive`
+
+Declarative generative components. Structured parameters, no raw code.
+
+```typescript
+{
+  type: 'primitive',
+  name: 'dots',       // dots, lines, waves, grid, flowField, orbits
+  count: 100,
+  color: '#ffffff',
+  motion: { speed: 0.5 }
+}
+```
+
+### `sketch`
+
+Raw Code Mode execution in a sandboxed environment. Full p5-like API access.
+
+```typescript
+{
+  type: 'sketch',
+  code: `
+    function setup() {
+      background(0);
+    }
+    function draw() {
+      ellipse(width/2, height/2, 100);
+    }
+  `,
+  normalize: true
+}
+```
 
 ---
 
@@ -51,56 +192,66 @@ Or use directly in HTML:
 
 ## Quick Start
 
-### 1. Create a System
+### Code Mode Systems with VAR
+
+Create and preview Code Mode sketches using protocol variables:
 
 ```typescript
-import { createSystem } from '@nexart/ui-renderer';
+import { createSystem, previewSystem } from '@nexart/ui-renderer';
 
 const system = createSystem({
-  seed: 29445825,
-  background: {
-    color: 'blue',
-    texture: 'noise'
-  },
-  elements: [
-    {
-      type: 'waves',
-      axis: 'x',
-      amplitude: 0.4,
-      frequency: 0.7
-    },
-    {
-      type: 'dots',
-      distribution: 'radial',
-      count: 400,
-      size: [1, 4]
+  type: 'code',
+  mode: 'loop',
+  width: 1950,
+  height: 2400,
+  totalFrames: 120,
+  seed: 12345,
+  vars: [50, 75, 25, 0, 100, 50, 50, 50, 50, 50], // VAR[0..9]
+  source: `
+    function setup() {
+      noFill();
+      stroke(0);
+    }
+    function draw() {
+      background(246, 245, 242);
+      var count = floor(map(VAR[0], 0, 100, 5, 30));
+      for (var i = 0; i < count; i++) {
+        var x = width / 2 + cos(t * TWO_PI + i * 0.5) * map(VAR[1], 0, 100, 50, 400);
+        var y = height / 2 + sin(t * TWO_PI + i * 0.3) * 200;
+        ellipse(x, y, 50);
+      }
     }
-  ],
-  motion: {
-    source: 'time',
-    speed: 0.2
-  }
+  `
 });
-```
-
-### 2. Preview the System
-
-```typescript
-import { previewSystem } from '@nexart/ui-renderer';
 
 const canvas = document.getElementById('canvas');
-const renderer = previewSystem(system, canvas, { mode: 'loop' });
-
+const renderer = previewSystem(system, canvas);
 renderer.start();
 ```
 
-### 3. Compile for Protocol
+**Static Mode** (single-frame, setup only):
 
 ```typescript
-import { compileSystem } from '@nexart/ui-renderer';
+const staticSystem = createSystem({
+  type: 'code',
+  mode: 'static',
+  width: 1950,
+  height: 2400,
+  seed: 12345,
+  vars: [50, 50, 50, 50, 50, 50, 50, 50, 50, 50],
+  source: `
+    function setup() {
+      background(246, 245, 242);
+      fill(0);
+      var count = floor(map(VAR[0], 0, 100, 10, 200));
+      for (var i = 0; i < count; i++) {
+        ellipse(random(width), random(height), random(10, 50));
+      }
+    }
+  `
+});
 
-const compiled = compileSystem(system);
-console.log(JSON.stringify(compiled, null, 2));
+previewSystem(staticSystem, canvas).render();
 ```
 
 ---
@@ -111,24 +262,17 @@ console.log(JSON.stringify(compiled, null, 2));
 
 Create a validated NexArt system.
 
+**Code Mode Input:**
 ```typescript
 const system = createSystem({
-  version?: string,        // Protocol version (default: '0.2')
-  seed: number,            // Required: PRNG seed
-  background: {
-    color: string,         // Required: background color
-    texture?: 'none' | 'noise' | 'grain',
-    gradient?: {
-      type: 'linear' | 'radial',
-      colors: string[],
-      angle?: number
-    }
-  },
-  elements: SystemElement[], // Required: array of primitives
-  motion?: {
-    source: 'none' | 'time' | 'seed',
-    speed?: number
-  }
+  type: 'code',
+  mode: 'static' | 'loop',
+  width: number,
+  height: number,
+  source: string,           // Raw p5-like sketch code
+  seed?: number,            // Optional: PRNG seed
+  totalFrames?: number,     // Required for loop mode
+  vars?: number[]           // Optional: VAR[0..9] (10 values, 0-100)
 });
 ```
 
@@ -148,25 +292,6 @@ renderer.stop();    // Stop loop
 renderer.destroy(); // Cleanup
 ```
 
-### `compileSystem(system)`
-
-Compile to protocol-compatible JSON.
-
-```typescript
-const compiled = compileSystem(system);
-// {
-//   protocol: 'nexart',
-//   systemVersion: '0.2',
-//   seed: 29445825,
-//   background: {...},
-//   elements: [...],
-//   motion: {...},
-//   deterministic: true,
-//   compiledAt: '2024-12-26T...',
-//   compilerVersion: '0.2.0'
-// }
-```
-
 ### `validateSystem(input)`
 
 Validate system input without creating.
@@ -180,98 +305,59 @@ if (!result.valid) {
 
 ### `getCapabilities()`
 
-Discover SDK capabilities — critical for AI tools and builders.
+Discover SDK capabilities.
 
 ```typescript
 import { getCapabilities } from '@nexart/ui-renderer';
 
 const caps = getCapabilities();
 // {
-//   version: '0.2.0',
+//   version: '0.4.0',
 //   isCanonical: false,
 //   isArchival: false,
 //   renderer: '@nexart/ui-renderer',
-//   primitives: [...],     // Available element types with parameters
-//   background: {...},     // Background options
-//   motion: {...},         // Motion sources and speed
-//   limits: {...}          // Max values for safety
+//   delegatesTo: '@nexart/codemode-sdk',
+//   protocolVersion: '1.0.0',
+//   ...
 // }
 ```
 
-Use this to:
-- Prevent AI hallucination of non-existent primitives
-- Validate parameter ranges before system creation
-- Build dynamic UIs that adapt to SDK capabilities
-
 ---
 
-## Primitive Vocabulary (v0.2)
-
-### Elements
-
-| Type | Properties |
-|------|------------|
-| `dots` | distribution, count, size, color, opacity |
-| `lines` | direction, count, thickness, color, opacity |
-| `waves` | axis, amplitude, frequency, count, color, opacity |
-| `grid` | rows, cols, cellSize, shape, color, opacity |
-| `flowField` | resolution, strength, particles, color, opacity |
-| `orbits` | count, radius, dotCount, speed, color, opacity |
+## Delegation Logging
 
-### Background
+All Code Mode previews log their delegation:
 
-| Property | Options |
-|----------|---------|
-| color | Any CSS color or name |
-| texture | `none`, `noise`, `grain` |
-| gradient | `{ type, colors, angle? }` |
-
-### Motion
-
-| Source | Behavior |
-|--------|----------|
-| `none` | Static image |
-| `time` | Animate based on elapsed time |
-| `seed` | Static per seed |
+```
+[UIRenderer] Preview delegation → @nexart/codemode-sdk
+[UIRenderer] Protocol version: 1.0.0
+[UIRenderer] Mode: loop
+```
 
 ---
 
-## For AI Platforms
-
-This SDK is designed for AI code generation. Use `getCapabilities()` first:
-
-```typescript
-import { getCapabilities, createSystem, previewSystem } from '@nexart/ui-renderer';
-
-// 1. Check what's available (prevents hallucination)
-const caps = getCapabilities();
-console.log(caps.primitives.map(p => p.type));
-// ['dots', 'lines', 'waves', 'grid', 'flowField', 'orbits']
+## Error Mirroring
 
-// 2. Create system using only valid primitives
-const system = createSystem({
-  seed: Date.now(),
-  background: { color: 'blue' },
-  elements: [
-    { type: 'waves', axis: 'x', amplitude: 0.5, frequency: 1 }
-  ]
-});
+If the protocol rejects code:
+- Rendering stops immediately
+- Black canvas is displayed
+- Error is logged verbatim
+- No "best effort" recovery
 
-// 3. Preview
-previewSystem(system, canvas).render();
 ```
-
-**AI Prompt Example:**
-```
-"Create a blue background with flowing waves using NexArt"
+[UIRenderer Protocol Error] Forbidden pattern: Math.random() — use random() instead (seeded)
 ```
 
-The finite vocabulary prevents invalid systems and ensures protocol alignment.
+---
+
+## What This SDK Does NOT Guarantee
 
-**Key AI Integration Points:**
-- `getCapabilities()` — Discover what's possible
-- `validateSystem()` — Check before creating
-- `compileSystem()` — Export protocol JSON
+| Not Guaranteed | Explanation |
+|----------------|-------------|
+| Canonical output | Production runtime is the only authority |
+| Archival quality | Output is for preview, not permanent storage |
+| Cross-version stability | Internal rendering may change between SDK versions |
+| Frame-perfect matching | Minor differences from production are expected |
 
 ---
 
@@ -282,21 +368,6 @@ The finite vocabulary prevents invalid systems and ensures protocol alignment.
 - Safari 13+
 - Edge 80+
 
-No polyfills required.
-
----
-
-## Comparison with @nexart/codemode-sdk
-
-| Feature | @nexart/ui-renderer | @nexart/codemode-sdk |
-|---------|---------------------|----------------------|
-| Environment | Browser only | Node.js / Server |
-| Purpose | Authoring / Preview | Production / Minting |
-| Canonical | ❌ No | ✅ Yes |
-| Archival | ❌ No | ✅ Yes |
-| Output | Canvas / JSON | PNG / MP4 buffers |
-| API | Declarative systems | Code execution |
-
 ---
 
 ## License
@@ -304,8 +375,3 @@ No polyfills required.
 MIT License
 
 Copyright (c) 2024 NexArt
-
----
-
-> **Reminder:** This SDK authors systems. It does NOT invent new rendering rules.
-> Canonical execution always happens via `@nexart/codemode-sdk`.

package/dist/compiler.d.ts

@@ -1,11 +1,12 @@
 /**
- * @nexart/ui-renderer v0.2.0 - System Compiler
+ * @nexart/ui-renderer v0.3.0 - System Compiler
  *
  * Compiles validated systems into canonical protocol-compatible JSON.
  */
 import type { NexArtSystem } from './types';
-export interface CompiledSystem {
+export interface CompiledDeclarativeSystem {
     protocol: 'nexart';
+    systemType: 'declarative';
     systemVersion: string;
     seed: number;
     background: {
@@ -29,6 +30,21 @@ export interface CompiledSystem {
     compiledAt: string;
     compilerVersion: string;
 }
+export interface CompiledCodeSystem {
+    protocol: 'nexart';
+    systemType: 'code';
+    systemVersion: string;
+    source: string;
+    mode: 'static' | 'loop';
+    width: number;
+    height: number;
+    seed: number;
+    totalFrames?: number;
+    deterministic: boolean;
+    compiledAt: string;
+    compilerVersion: string;
+}
+export type CompiledSystem = CompiledDeclarativeSystem | CompiledCodeSystem;
 export declare function compileSystem(system: NexArtSystem): CompiledSystem;
 export declare function serializeSystem(system: NexArtSystem): string;
 //# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,SAAS,CAAC;AAG3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE;YACT,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC,CAAC;IACH,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAyClE;AAuCD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAG5D"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAsD,MAAM,SAAS,CAAC;AAGhG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,aAAa,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE;YACT,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC,CAAC;IACH,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GAAG,yBAAyB,GAAG,kBAAkB,CAAC;AAI5E,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAMlE;AAyFD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAG5D"}

package/dist/compiler.js

@@ -1,22 +1,36 @@
 /**
- * @nexart/ui-renderer v0.2.0 - System Compiler
+ * @nexart/ui-renderer v0.3.0 - System Compiler
  *
  * Compiles validated systems into canonical protocol-compatible JSON.
  */
-import { validateSystem } from './system';
-const COMPILER_VERSION = '0.2.0';
+import { isCodeModeSystem } from './system';
+const COMPILER_VERSION = '0.3.0';
 export function compileSystem(system) {
-    const validation = validateSystem({
-        seed: system.seed,
-        background: system.background,
-        elements: system.elements,
-        motion: system.motion,
-    });
-    if (!validation.valid) {
-        throw new Error(`Cannot compile invalid system: ${validation.errors.join('; ')}`);
+    if (isCodeModeSystem(system)) {
+        return compileCodeSystem(system);
     }
+    return compileDeclarativeSystem(system);
+}
+function compileCodeSystem(system) {
+    return {
+        protocol: 'nexart',
+        systemType: 'code',
+        systemVersion: system.systemVersion,
+        source: system.source,
+        mode: system.mode,
+        width: system.width,
+        height: system.height,
+        seed: system.seed,
+        ...(system.totalFrames !== undefined && { totalFrames: system.totalFrames }),
+        deterministic: true,
+        compiledAt: new Date().toISOString(),
+        compilerVersion: COMPILER_VERSION,
+    };
+}
+function compileDeclarativeSystem(system) {
     const compiled = {
         protocol: 'nexart',
+        systemType: 'declarative',
         systemVersion: system.systemVersion,
         seed: system.seed,
         background: {

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 /**
  * @nexart/ui-renderer
- * Version: 0.2.0
+ * Version: 0.4.0
  *
- * Declarative System Authoring SDK for NexArt Protocol
+ * Opinionated Generative Design System SDK for NexArt Protocol
  *
  * ⚠️ IMPORTANT DISCLAIMER
  *
@@ -15,19 +15,30 @@
  * - NOT protocol-authoritative
  *
  * Use it for:
- * - Creating NexArt systems declaratively
+ * - Creating NexArt systems with background/primitive/sketch elements
  * - Previewing systems in the browser
- * - Compiling systems to protocol-compatible JSON
+ * - Building AI-friendly generative backgrounds
  * - Building platforms, tools, and integrations
+ *
+ * Design Philosophy:
+ * - Beauty by default > unlimited freedom
+ * - Aesthetic guardrails ensure pleasing output automatically
+ * - All elements compile to Code Mode for deterministic rendering
  */
-export { createSystem, validateSystem } from './system';
+export { createSystem, validateSystem, isCodeModeSystem, isDeclarativeSystem, isUnifiedModeSystem } from './system';
 export { compileSystem, serializeSystem } from './compiler';
 export { previewSystem } from './preview/renderer';
+export { renderCodeModeSystem } from './preview/code-renderer';
+export { renderUnifiedSystem } from './preview/unified-renderer';
+export { compileBackgroundPreset, getPaletteColors } from './presets/backgrounds';
+export { compilePrimitive } from './presets/primitives';
+export { wrapSketch, validateSketchSafety } from './presets/sketch-wrapper';
 export { getCapabilities, getPrimitiveTypes, getMotionSources, getBackgroundTextures, } from './capabilities';
-export type { NexArtSystemInput, NexArtSystem, SystemElement, DotsElement, LinesElement, WavesElement, GridElement, FlowFieldElement, OrbitsElement, BackgroundConfig, MotionConfig, PreviewOptions, ValidationResult, } from './types';
+export type { NexArtSystemInput, NexArtSystem, DeclarativeSystemInput, DeclarativeSystem, CodeSystem, NexArtCodeSystem, UnifiedSystemInput, UnifiedSystem, UnifiedElement, BackgroundElement, PrimitiveElement, SketchElement, BackgroundPreset, PrimitiveName, ColorPalette, MotionSpeed, StrokeWeightAuto, LoopConfig, DeclarativeElement, SystemElement, DotsElement, LinesElement, WavesElement, GridElement, FlowFieldElement, OrbitsElement, BackgroundConfig, MotionConfig, PreviewOptions, ValidationResult, } from './types';
+export { AESTHETIC_DEFAULTS, SDK_VERSION as TYPE_SDK_VERSION } from './types';
 export type { Capabilities, PrimitiveCapability, ParameterSpec, } from './capabilities';
-export declare const SDK_VERSION = "0.2.1";
-export declare const PROTOCOL_VERSION = "0.2";
+export declare const SDK_VERSION = "0.4.0";
+export declare const PROTOCOL_VERSION = "0.4";
 export declare const IS_CANONICAL = false;
 export declare const IS_ARCHIVAL = false;
 export declare const RENDERER = "@nexart/ui-renderer";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,YAAY,QAAQ,CAAC;AAClC,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,QAAQ,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,kBAAkB,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE9E,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,YAAY,QAAQ,CAAC;AAClC,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,QAAQ,wBAAwB,CAAC"}