@nexart/ui-renderer 0.6.0 → 0.8.0

package/dist/capabilities.js

@@ -1,13 +1,12 @@
 /**
- * @nexart/ui-renderer v0.6.0 - Capabilities Discovery
+ * @nexart/ui-renderer v0.8.0 - Capabilities Discovery
  *
  * Exposes SDK capabilities for AI tools and builders.
- * Critical for preventing hallucination and SDK bypass.
+ * Lightweight preview runtime — no protocol enforcement.
  *
- * ⚠️ PRIMITIVES ARE NON-CANONICAL
- * Primitives are helper generators that compile to Code Mode sketches.
- * They exist for convenience and rapid prototyping only.
- * The canonical output is always the compiled Code Mode source.
+ * ⚠️ PREVIEW ONLY
+ * This SDK provides preview rendering with performance limits.
+ * For canonical output: use @nexart/codemode-sdk
  */
 const SHARED_PARAMS = {
     count: {
@@ -59,7 +58,7 @@ function createPrimitive(name, category, description) {
 }
 export function getCapabilities() {
     return {
-        version: '0.6.0',
+        version: '0.8.0',
         isCanonical: false,
         isArchival: false,
         renderer: '@nexart/ui-renderer',

package/dist/compiler.d.ts

@@ -1,7 +1,8 @@
 /**
- * @nexart/ui-renderer v0.3.0 - System Compiler
+ * @nexart/ui-renderer v0.8.0 - System Compiler
  *
- * Compiles validated systems into canonical protocol-compatible JSON.
+ * Compiles validated systems into protocol-compatible JSON.
+ * Lightweight preview runtime — no protocol enforcement.
  */
 import type { NexArtSystem } from './types';
 export interface CompiledDeclarativeSystem {

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,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"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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,10 +1,11 @@
 /**
- * @nexart/ui-renderer v0.3.0 - System Compiler
+ * @nexart/ui-renderer v0.8.0 - System Compiler
  *
- * Compiles validated systems into canonical protocol-compatible JSON.
+ * Compiles validated systems into protocol-compatible JSON.
+ * Lightweight preview runtime — no protocol enforcement.
  */
 import { isCodeModeSystem } from './system';
-const COMPILER_VERSION = '0.3.0';
+const COMPILER_VERSION = '0.8.0';
 export function compileSystem(system) {
     if (isCodeModeSystem(system)) {
         return compileCodeSystem(system);

package/dist/index.d.ts

@@ -1,34 +1,34 @@
 /**
  * @nexart/ui-renderer
- * Version: 0.6.0
+ * Version: 0.8.0
  *
- * Opinionated Generative Design System SDK for NexArt Protocol
+ * Lightweight Preview Runtime for NexArt Protocol
  *
- * ⚠️ IMPORTANT DISCLAIMER
- *
- * This SDK is for authoring and preview only.
- * Canonical, archival output is produced exclusively by @nexart/codemode-sdk.
- *
- * This renderer is:
- * - NOT canonical
- * - NOT archival
- * - NOT protocol-authoritative
- *
- * Use it for:
- * - Creating NexArt systems with background/primitive/sketch elements
- * - Previewing systems in the browser
- * - 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
- *
- * ⚠️ PRIMITIVES ARE NON-CANONICAL
- * Primitives are helper generators that compile to Code Mode sketches.
- * They exist for convenience and rapid prototyping only.
- * The canonical output is always the compiled Code Mode source.
+ * ╔══════════════════════════════════════════════════════════════════════════╗
+ * ║  PREVIEW RUNTIME — NON-AUTHORITATIVE                                     ║
+ * ║                                                                          ║
+ * ║  This renderer is a preview-only runtime.                                ║
+ * ║  It does not guarantee determinism or protocol compliance.               ║
+ * ║                                                                          ║
+ * ║  Performance Limits:                                                     ║
+ * ║  - Max frames: 30                                                        ║
+ * ║  - Max total time: 500ms                                                 ║
+ * ║  - Max canvas dimension: 900px                                           ║
+ * ║  - Frame stride: render every 3rd frame                                  ║
+ * ║                                                                          ║
+ * ║  Use Cases:                                                              ║
+ * ║  - Editor live preview                                                   ║
+ * ║  - Builder dashboards                                                    ║
+ * ║  - Background generative art                                             ║
+ * ║  - Static or loop previews                                               ║
+ * ║                                                                          ║
+ * ║  NOT For:                                                                ║
+ * ║  - Minting / export                                                      ║
+ * ║  - ByX                                                                   ║
+ * ║  - Protocol validation                                                   ║
+ * ║                                                                          ║
+ * ║  For canonical output: use @nexart/codemode-sdk                          ║
+ * ╚══════════════════════════════════════════════════════════════════════════╝
  */
 export { createSystem, validateSystem, isCodeModeSystem, isDeclarativeSystem, isUnifiedModeSystem } from './system';
 export { compileSystem, serializeSystem } from './compiler';
@@ -39,11 +39,15 @@ export { compileBackgroundPreset, getPaletteColors } from './presets/backgrounds
 export { compilePrimitive } from './presets/primitives';
 export { wrapSketch, validateSketchSafety } from './presets/sketch-wrapper';
 export { getCapabilities, getPrimitiveTypes, getPrimitivesByCategory, getPrimitiveInfo, isPrimitiveValid, getMotionSources, getBackgroundTextures, } from './capabilities';
+export { createPreviewEngine, renderStaticPreview, stopActivePreview, } from './preview/preview-engine';
+export { PREVIEW_BUDGET, CANVAS_LIMITS, type RuntimeProfile, type PreviewMode, type PreviewEngineConfig, type PreviewRenderResult, type PreviewRenderer, type FrameBudgetState, } from './preview/preview-types';
+export { createFrameBudget, canRenderFrame, recordFrame, resetBudget, shouldSkipFrame, } from './preview/frame-budget';
+export { calculateScaledDimensions, applyScaledDimensions, type ScaledDimensions, } from './preview/canvas-scaler';
 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.6.0";
-export declare const PROTOCOL_VERSION = "0.6";
+export declare const SDK_VERSION = "0.8.0";
+export declare const PROTOCOL_VERSION = "0.8";
 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;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,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,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;AAC9C,eAAO,MAAM,wBAAwB,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;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,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,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;AAC9C,eAAO,MAAM,wBAAwB,QAAQ,CAAC"}

package/dist/index.js

@@ -1,34 +1,34 @@
 /**
  * @nexart/ui-renderer
- * Version: 0.6.0
+ * Version: 0.8.0
  *
- * Opinionated Generative Design System SDK for NexArt Protocol
+ * Lightweight Preview Runtime for NexArt Protocol
  *
- * ⚠️ IMPORTANT DISCLAIMER
- *
- * This SDK is for authoring and preview only.
- * Canonical, archival output is produced exclusively by @nexart/codemode-sdk.
- *
- * This renderer is:
- * - NOT canonical
- * - NOT archival
- * - NOT protocol-authoritative
- *
- * Use it for:
- * - Creating NexArt systems with background/primitive/sketch elements
- * - Previewing systems in the browser
- * - 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
- *
- * ⚠️ PRIMITIVES ARE NON-CANONICAL
- * Primitives are helper generators that compile to Code Mode sketches.
- * They exist for convenience and rapid prototyping only.
- * The canonical output is always the compiled Code Mode source.
+ * ╔══════════════════════════════════════════════════════════════════════════╗
+ * ║  PREVIEW RUNTIME — NON-AUTHORITATIVE                                     ║
+ * ║                                                                          ║
+ * ║  This renderer is a preview-only runtime.                                ║
+ * ║  It does not guarantee determinism or protocol compliance.               ║
+ * ║                                                                          ║
+ * ║  Performance Limits:                                                     ║
+ * ║  - Max frames: 30                                                        ║
+ * ║  - Max total time: 500ms                                                 ║
+ * ║  - Max canvas dimension: 900px                                           ║
+ * ║  - Frame stride: render every 3rd frame                                  ║
+ * ║                                                                          ║
+ * ║  Use Cases:                                                              ║
+ * ║  - Editor live preview                                                   ║
+ * ║  - Builder dashboards                                                    ║
+ * ║  - Background generative art                                             ║
+ * ║  - Static or loop previews                                               ║
+ * ║                                                                          ║
+ * ║  NOT For:                                                                ║
+ * ║  - Minting / export                                                      ║
+ * ║  - ByX                                                                   ║
+ * ║  - Protocol validation                                                   ║
+ * ║                                                                          ║
+ * ║  For canonical output: use @nexart/codemode-sdk                          ║
+ * ╚══════════════════════════════════════════════════════════════════════════╝
  */
 export { createSystem, validateSystem, isCodeModeSystem, isDeclarativeSystem, isUnifiedModeSystem } from './system';
 export { compileSystem, serializeSystem } from './compiler';
@@ -39,9 +39,13 @@ export { compileBackgroundPreset, getPaletteColors } from './presets/backgrounds
 export { compilePrimitive } from './presets/primitives';
 export { wrapSketch, validateSketchSafety } from './presets/sketch-wrapper';
 export { getCapabilities, getPrimitiveTypes, getPrimitivesByCategory, getPrimitiveInfo, isPrimitiveValid, getMotionSources, getBackgroundTextures, } from './capabilities';
+export { createPreviewEngine, renderStaticPreview, stopActivePreview, } from './preview/preview-engine';
+export { PREVIEW_BUDGET, CANVAS_LIMITS, } from './preview/preview-types';
+export { createFrameBudget, canRenderFrame, recordFrame, resetBudget, shouldSkipFrame, } from './preview/frame-budget';
+export { calculateScaledDimensions, applyScaledDimensions, } from './preview/canvas-scaler';
 export { AESTHETIC_DEFAULTS, SDK_VERSION as TYPE_SDK_VERSION } from './types';
-export const SDK_VERSION = '0.6.0';
-export const PROTOCOL_VERSION = '0.6';
+export const SDK_VERSION = '0.8.0';
+export const PROTOCOL_VERSION = '0.8';
 export const IS_CANONICAL = false;
 export const IS_ARCHIVAL = false;
 export const RENDERER = '@nexart/ui-renderer';

package/dist/preview/canvas-scaler.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @nexart/ui-renderer - Canvas Scaler
+ *
+ * Scales canvas resolution for preview rendering.
+ * Preview renderer does NOT render at full mint resolution.
+ *
+ * ╔══════════════════════════════════════════════════════════════════════════╗
+ * ║  CANVAS SCALING — PERFORMANCE CRITICAL                                   ║
+ * ║                                                                          ║
+ * ║  Max dimension: 900px                                                    ║
+ * ║  Preserves aspect ratio                                                  ║
+ * ║  Uses CSS scaling for display                                            ║
+ * ╚══════════════════════════════════════════════════════════════════════════╝
+ */
+export interface ScaledDimensions {
+    /** Scaled width for rendering */
+    renderWidth: number;
+    /** Scaled height for rendering */
+    renderHeight: number;
+    /** Original width */
+    originalWidth: number;
+    /** Original height */
+    originalHeight: number;
+    /** Scale factor applied */
+    scaleFactor: number;
+    /** Whether scaling was applied */
+    wasScaled: boolean;
+}
+/**
+ * Calculate scaled dimensions for preview rendering.
+ * Maintains aspect ratio, caps at MAX_DIMENSION.
+ */
+export declare function calculateScaledDimensions(width: number, height: number): ScaledDimensions;
+/**
+ * Apply scaled dimensions to a canvas element.
+ * Sets canvas internal resolution and CSS display size.
+ */
+export declare function applyScaledDimensions(canvas: HTMLCanvasElement, dimensions: ScaledDimensions): void;
+/**
+ * Scale coordinates from original space to render space.
+ * Used when the sketch uses original coordinates but canvas is scaled.
+ */
+export declare function scaleCoordinate(value: number, scaleFactor: number): number;
+/**
+ * Create a scaling transform for the canvas context.
+ * This allows sketches to use original coordinates while rendering at scaled resolution.
+ */
+export declare function applyScaleTransform(ctx: CanvasRenderingContext2D, scaleFactor: number): void;
+//# sourceMappingURL=canvas-scaler.d.ts.map

package/dist/preview/canvas-scaler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-scaler.d.ts","sourceRoot":"","sources":["../../src/preview/canvas-scaler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,gBAAgB,CA0BlB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,gBAAgB,GAC3B,IAAI,CAWN;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,wBAAwB,EAC7B,WAAW,EAAE,MAAM,GAClB,IAAI,CAIN"}

package/dist/preview/canvas-scaler.js

@@ -0,0 +1,74 @@
+/**
+ * @nexart/ui-renderer - Canvas Scaler
+ *
+ * Scales canvas resolution for preview rendering.
+ * Preview renderer does NOT render at full mint resolution.
+ *
+ * ╔══════════════════════════════════════════════════════════════════════════╗
+ * ║  CANVAS SCALING — PERFORMANCE CRITICAL                                   ║
+ * ║                                                                          ║
+ * ║  Max dimension: 900px                                                    ║
+ * ║  Preserves aspect ratio                                                  ║
+ * ║  Uses CSS scaling for display                                            ║
+ * ╚══════════════════════════════════════════════════════════════════════════╝
+ */
+import { CANVAS_LIMITS } from './preview-types';
+/**
+ * Calculate scaled dimensions for preview rendering.
+ * Maintains aspect ratio, caps at MAX_DIMENSION.
+ */
+export function calculateScaledDimensions(width, height) {
+    const maxDim = Math.max(width, height);
+    // If already within limits, no scaling needed
+    if (maxDim <= CANVAS_LIMITS.MAX_DIMENSION) {
+        return {
+            renderWidth: width,
+            renderHeight: height,
+            originalWidth: width,
+            originalHeight: height,
+            scaleFactor: 1,
+            wasScaled: false,
+        };
+    }
+    // Calculate scale factor to fit within limits
+    const scaleFactor = CANVAS_LIMITS.MAX_DIMENSION / maxDim;
+    return {
+        renderWidth: Math.round(width * scaleFactor),
+        renderHeight: Math.round(height * scaleFactor),
+        originalWidth: width,
+        originalHeight: height,
+        scaleFactor,
+        wasScaled: true,
+    };
+}
+/**
+ * Apply scaled dimensions to a canvas element.
+ * Sets canvas internal resolution and CSS display size.
+ */
+export function applyScaledDimensions(canvas, dimensions) {
+    // Set canvas internal resolution (what we actually render)
+    canvas.width = dimensions.renderWidth;
+    canvas.height = dimensions.renderHeight;
+    // Set CSS display size (visual size in the UI)
+    // This allows the canvas to display at a larger size while rendering at lower resolution
+    if (dimensions.wasScaled) {
+        canvas.style.width = `${dimensions.originalWidth}px`;
+        canvas.style.height = `${dimensions.originalHeight}px`;
+    }
+}
+/**
+ * Scale coordinates from original space to render space.
+ * Used when the sketch uses original coordinates but canvas is scaled.
+ */
+export function scaleCoordinate(value, scaleFactor) {
+    return value * scaleFactor;
+}
+/**
+ * Create a scaling transform for the canvas context.
+ * This allows sketches to use original coordinates while rendering at scaled resolution.
+ */
+export function applyScaleTransform(ctx, scaleFactor) {
+    if (scaleFactor !== 1) {
+        ctx.scale(scaleFactor, scaleFactor);
+    }
+}

package/dist/preview/code-renderer.d.ts

@@ -1,28 +1,20 @@
 /**
- * @nexart/ui-renderer v0.6.0 - Code Mode Renderer
+ * @nexart/ui-renderer v0.8.0 - Code Mode Renderer
  *
  * ╔══════════════════════════════════════════════════════════════════════════╗
- * ║  PREVIEW RENDERER — MIRRORS @nexart/codemode-sdk BEHAVIOR                ║
+ * ║  PREVIEW RENDERER — LIGHTWEIGHT, NON-AUTHORITATIVE                       ║
  * ║                                                                          ║
- * ║  This file is a MIRROR, not an authority.                                ║
+ * ║  This renderer is a preview-only runtime.                                ║
+ * ║  It does not guarantee determinism or protocol compliance.               ║
  * ║                                                                          ║
- * ║  Authority: @nexart/codemode-sdk (Protocol v1.0.0)                       ║
+ * ║  Performance Limits (MANDATORY):                                         ║
+ * ║  - Max frames: 30                                                        ║
+ * ║  - Max total time: 500ms                                                 ║
+ * ║  - Max canvas dimension: 900px                                           ║
+ * ║  - Frame stride: render every 3rd frame                                  ║
+ * ║                                                                          ║
+ * ║  For minting, export, or validation: use @nexart/codemode-sdk            ║
  * ╚══════════════════════════════════════════════════════════════════════════╝
- *
- * ARCHITECTURAL NOTE:
- * -------------------
- * Live preview animation requires local p5 runtime execution because:
- * - @nexart/codemode-sdk.executeCodeMode() returns blobs (PNG/MP4), not frames
- * - Real-time animation in the browser requires frame-by-frame canvas updates
- * - The SDK's loop mode produces video files, not real-time rendering
- *
- * To ensure faithful mirroring, this renderer:
- * 1. Uses identical forbidden pattern validation as the SDK
- * 2. Uses identical VAR handling (read-only, 0-10 input → 10 runtime, 0-100 strict, errors not clamps)
- * 3. Uses identical seeded RNG (Mulberry32) and Perlin noise
- * 4. Uses identical time variable semantics (frameCount, t, time, tGlobal)
- *
- * For archival/canonical output, use @nexart/codemode-sdk directly.
  */
 import type { NexArtCodeSystem, PreviewOptions } from '../types';
 export interface CodeRenderer {
@@ -33,14 +25,5 @@ export interface CodeRenderer {
     isCanonical: false;
     isArchival: false;
 }
-interface P5Runtime {
-    [key: string]: any;
-    width: number;
-    height: number;
-    frameCount: number;
-    VAR: readonly number[];
-}
-export declare function createP5Runtime(canvas: HTMLCanvasElement, width: number, height: number, seed: number, vars?: number[]): P5Runtime;
 export declare function renderCodeModeSystem(system: NexArtCodeSystem, canvas: HTMLCanvasElement, options?: PreviewOptions): CodeRenderer;
-export {};
 //# sourceMappingURL=code-renderer.d.ts.map

package/dist/preview/code-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-renderer.d.ts","sourceRoot":"","sources":["../../src/preview/code-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAMjE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,EAAE,KAAK,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC;CACnB;AAuDD,UAAU,SAAS;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACxB;AA+GD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,EAAmC,GAC9C,SAAS,CA0eX;AAsCD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,cAAmB,GAC3B,YAAY,CA4Md"}
+{"version":3,"file":"code-renderer.d.ts","sourceRoot":"","sources":["../../src/preview/code-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAwBjE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,EAAE,KAAK,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC;CACnB;AAwBD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,cAAmB,GAC3B,YAAY,CA0Od"}