@nexart/codemode-sdk 1.1.1 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (91) hide show
  1. package/README.md +131 -238
  2. package/dist/engine.d.ts +39 -17
  3. package/dist/engine.d.ts.map +1 -1
  4. package/dist/engine.js +253 -52
  5. package/dist/index.d.ts +17 -24
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +16 -30
  8. package/dist/loop-engine.d.ts +2 -1
  9. package/dist/loop-engine.d.ts.map +1 -1
  10. package/dist/loop-engine.js +16 -10
  11. package/dist/p5-runtime.d.ts +3 -3
  12. package/dist/p5-runtime.d.ts.map +1 -1
  13. package/dist/p5-runtime.js +398 -13
  14. package/dist/static-engine.d.ts +1 -1
  15. package/dist/static-engine.d.ts.map +1 -1
  16. package/dist/static-engine.js +3 -2
  17. package/dist/types.d.ts +6 -5
  18. package/dist/types.d.ts.map +1 -1
  19. package/dist/types.js +3 -3
  20. package/package.json +17 -23
  21. package/CHANGELOG.md +0 -109
  22. package/CODE_MODE_PROTOCOL.md +0 -312
  23. package/dist/core-index.d.ts +0 -21
  24. package/dist/core-index.d.ts.map +0 -1
  25. package/dist/core-index.js +0 -26
  26. package/dist/execute.d.ts +0 -46
  27. package/dist/execute.d.ts.map +0 -1
  28. package/dist/execute.js +0 -268
  29. package/dist/noise-bridge.d.ts +0 -44
  30. package/dist/noise-bridge.d.ts.map +0 -1
  31. package/dist/noise-bridge.js +0 -68
  32. package/dist/noise-engine.d.ts +0 -74
  33. package/dist/noise-engine.d.ts.map +0 -1
  34. package/dist/noise-engine.js +0 -132
  35. package/dist/noise-sketches/fractalNoise.d.ts +0 -11
  36. package/dist/noise-sketches/fractalNoise.d.ts.map +0 -1
  37. package/dist/noise-sketches/fractalNoise.js +0 -121
  38. package/dist/noise-sketches/index.d.ts +0 -21
  39. package/dist/noise-sketches/index.d.ts.map +0 -1
  40. package/dist/noise-sketches/index.js +0 -28
  41. package/dist/sound-bridge.d.ts +0 -89
  42. package/dist/sound-bridge.d.ts.map +0 -1
  43. package/dist/sound-bridge.js +0 -128
  44. package/dist/soundart-engine.d.ts +0 -87
  45. package/dist/soundart-engine.d.ts.map +0 -1
  46. package/dist/soundart-engine.js +0 -173
  47. package/dist/soundart-sketches/chladniBloom.d.ts +0 -3
  48. package/dist/soundart-sketches/chladniBloom.d.ts.map +0 -1
  49. package/dist/soundart-sketches/chladniBloom.js +0 -53
  50. package/dist/soundart-sketches/dualVortex.d.ts +0 -3
  51. package/dist/soundart-sketches/dualVortex.d.ts.map +0 -1
  52. package/dist/soundart-sketches/dualVortex.js +0 -67
  53. package/dist/soundart-sketches/geometryIllusion.d.ts +0 -3
  54. package/dist/soundart-sketches/geometryIllusion.d.ts.map +0 -1
  55. package/dist/soundart-sketches/geometryIllusion.js +0 -89
  56. package/dist/soundart-sketches/index.d.ts +0 -39
  57. package/dist/soundart-sketches/index.d.ts.map +0 -1
  58. package/dist/soundart-sketches/index.js +0 -72
  59. package/dist/soundart-sketches/isoflow.d.ts +0 -3
  60. package/dist/soundart-sketches/isoflow.d.ts.map +0 -1
  61. package/dist/soundart-sketches/isoflow.js +0 -60
  62. package/dist/soundart-sketches/loomWeave.d.ts +0 -3
  63. package/dist/soundart-sketches/loomWeave.d.ts.map +0 -1
  64. package/dist/soundart-sketches/loomWeave.js +0 -59
  65. package/dist/soundart-sketches/noiseTerraces.d.ts +0 -3
  66. package/dist/soundart-sketches/noiseTerraces.d.ts.map +0 -1
  67. package/dist/soundart-sketches/noiseTerraces.js +0 -53
  68. package/dist/soundart-sketches/orb.d.ts +0 -3
  69. package/dist/soundart-sketches/orb.d.ts.map +0 -1
  70. package/dist/soundart-sketches/orb.js +0 -50
  71. package/dist/soundart-sketches/pixelGlyphs.d.ts +0 -3
  72. package/dist/soundart-sketches/pixelGlyphs.d.ts.map +0 -1
  73. package/dist/soundart-sketches/pixelGlyphs.js +0 -72
  74. package/dist/soundart-sketches/prismFlowFields.d.ts +0 -3
  75. package/dist/soundart-sketches/prismFlowFields.d.ts.map +0 -1
  76. package/dist/soundart-sketches/prismFlowFields.js +0 -51
  77. package/dist/soundart-sketches/radialBurst.d.ts +0 -3
  78. package/dist/soundart-sketches/radialBurst.d.ts.map +0 -1
  79. package/dist/soundart-sketches/radialBurst.js +0 -60
  80. package/dist/soundart-sketches/resonantSoundBodies.d.ts +0 -3
  81. package/dist/soundart-sketches/resonantSoundBodies.d.ts.map +0 -1
  82. package/dist/soundart-sketches/resonantSoundBodies.js +0 -89
  83. package/dist/soundart-sketches/rings.d.ts +0 -11
  84. package/dist/soundart-sketches/rings.d.ts.map +0 -1
  85. package/dist/soundart-sketches/rings.js +0 -89
  86. package/dist/soundart-sketches/squares.d.ts +0 -3
  87. package/dist/soundart-sketches/squares.d.ts.map +0 -1
  88. package/dist/soundart-sketches/squares.js +0 -52
  89. package/dist/soundart-sketches/waveStripes.d.ts +0 -3
  90. package/dist/soundart-sketches/waveStripes.d.ts.map +0 -1
  91. package/dist/soundart-sketches/waveStripes.js +0 -44
package/dist/execute.js DELETED
@@ -1,268 +0,0 @@
1
- /**
2
- * NexArt Code Mode Runtime SDK - Canonical Execution Entry Point
3
- *
4
- * ╔══════════════════════════════════════════════════════════════════════════╗
5
- * ║ CODE MODE PROTOCOL v1.0.0 (Phase 1) — CANONICAL ENTRY POINT ║
6
- * ║ ║
7
- * ║ This is the ONLY official way to execute Code Mode. ║
8
- * ║ All implementations (NexArt, ByX, external) MUST use this function. ║
9
- * ║ ║
10
- * ║ Authority: @nexart/codemode-sdk ║
11
- * ╚══════════════════════════════════════════════════════════════════════════╝
12
- */
13
- import { runStaticMode } from './static-engine';
14
- import { runLoopMode } from './loop-engine';
15
- import { PROTOCOL_IDENTITY, DEFAULT_CONFIG, } from './types';
16
- /**
17
- * Validate and normalize VAR array to 10 elements.
18
- *
19
- * Rules (SDK v1.0.2, Protocol v1.0.0):
20
- * - VAR is OPTIONAL: omit or pass [] for empty (defaults to all zeros)
21
- * - VAR input length MUST be 0-10 elements (protocol error if > 10)
22
- * - VAR values MUST be finite numbers (protocol error if not)
23
- * - VAR values MUST be in range 0-100 (protocol error if out of range, NO clamping)
24
- * - VAR is read-only inside sketches
25
- * - Output is ALWAYS 10 elements (padded with zeros) for protocol consistency
26
- */
27
- function normalizeVars(vars) {
28
- if (!vars || !Array.isArray(vars)) {
29
- console.log('[CodeMode] No vars provided, using defaults [0,0,0,0,0,0,0,0,0,0]');
30
- return [0, 0, 0, 0, 0, 0, 0, 0, 0, 0];
31
- }
32
- if (vars.length > 10) {
33
- throw new Error(`[Code Mode Protocol Error] VAR array must have at most 10 elements, got ${vars.length}`);
34
- }
35
- const result = [];
36
- for (let i = 0; i < vars.length; i++) {
37
- const v = vars[i];
38
- if (typeof v !== 'number' || !Number.isFinite(v)) {
39
- throw new Error(`[Code Mode Protocol Error] VAR[${i}] must be a finite number, got ${typeof v === 'number' ? v : typeof v}`);
40
- }
41
- if (v < 0 || v > 100) {
42
- throw new Error(`[Code Mode Protocol Error] VAR[${i}] = ${v} is out of range. Values must be 0-100.`);
43
- }
44
- result.push(v);
45
- }
46
- // Pad with zeros to always have 10 elements for protocol consistency
47
- while (result.length < 10) {
48
- result.push(0);
49
- }
50
- return result;
51
- }
52
- /**
53
- * Validate execution input
54
- */
55
- function validateInput(input) {
56
- if (!input.source || typeof input.source !== 'string') {
57
- throw new Error('[Code Mode Protocol Error] source is required and must be a string');
58
- }
59
- if (typeof input.width !== 'number' || input.width <= 0) {
60
- throw new Error('[Code Mode Protocol Error] width must be a positive number');
61
- }
62
- if (typeof input.height !== 'number' || input.height <= 0) {
63
- throw new Error('[Code Mode Protocol Error] height must be a positive number');
64
- }
65
- if (typeof input.seed !== 'number') {
66
- throw new Error('[Code Mode Protocol Error] seed is required and must be a number');
67
- }
68
- if (input.mode !== 'static' && input.mode !== 'loop') {
69
- throw new Error('[Code Mode Protocol Error] mode must be "static" or "loop"');
70
- }
71
- if (input.mode === 'loop') {
72
- if (typeof input.totalFrames !== 'number' || input.totalFrames <= 0) {
73
- throw new Error('[Code Mode Protocol Error] totalFrames is required for loop mode and must be a positive number');
74
- }
75
- }
76
- // Validate forbidden patterns per CODE_MODE_PROTOCOL.md
77
- const forbiddenPatterns = [
78
- // Async timing (breaks determinism)
79
- { pattern: /setTimeout\s*\(/, name: 'setTimeout' },
80
- { pattern: /setInterval\s*\(/, name: 'setInterval' },
81
- { pattern: /requestAnimationFrame\s*\(/, name: 'requestAnimationFrame' },
82
- // Time-based entropy (breaks determinism)
83
- { pattern: /Date\.now\s*\(/, name: 'Date.now() — use time variable instead' },
84
- { pattern: /new\s+Date\s*\(/, name: 'new Date() — use time variable instead' },
85
- // Unseeded random (use random() instead)
86
- { pattern: /Math\.random\s*\(/, name: 'Math.random() — use random() instead (seeded)' },
87
- // External IO (breaks determinism)
88
- { pattern: /fetch\s*\(/, name: 'fetch() — external IO forbidden' },
89
- { pattern: /XMLHttpRequest/, name: 'XMLHttpRequest — external IO forbidden' },
90
- // Canvas is pre-initialized
91
- { pattern: /createCanvas\s*\(/, name: 'createCanvas() — canvas is pre-initialized' },
92
- // DOM manipulation forbidden
93
- { pattern: /document\./, name: 'DOM access — document.* forbidden' },
94
- { pattern: /window\./, name: 'DOM access — window.* forbidden' },
95
- // External imports forbidden
96
- { pattern: /\bimport\s+/, name: 'import — external imports forbidden' },
97
- { pattern: /\brequire\s*\(/, name: 'require() — external imports forbidden' },
98
- ];
99
- for (const { pattern, name } of forbiddenPatterns) {
100
- if (pattern.test(input.source)) {
101
- throw new Error(`[Code Mode Protocol Error] Forbidden pattern: ${name}`);
102
- }
103
- }
104
- // Loop mode specific validation
105
- if (input.mode === 'loop') {
106
- if (!/function\s+draw\s*\(\s*\)/.test(input.source)) {
107
- throw new Error('[Code Mode Protocol Error] Loop mode requires a draw() function');
108
- }
109
- if (/noLoop\s*\(\s*\)/.test(input.source)) {
110
- throw new Error('[Code Mode Protocol Error] noLoop() is forbidden in Loop mode');
111
- }
112
- }
113
- }
114
- /**
115
- * Create protocol metadata for the execution result
116
- */
117
- function createMetadata(input, vars) {
118
- return {
119
- ...PROTOCOL_IDENTITY,
120
- seed: input.seed,
121
- vars,
122
- width: input.width,
123
- height: input.height,
124
- mode: input.mode,
125
- ...(input.mode === 'loop' && input.totalFrames ? { totalFrames: input.totalFrames } : {}),
126
- };
127
- }
128
- /**
129
- * Execute Code Mode in Static mode - delegates to static-engine.ts
130
- */
131
- async function executeStatic(input, vars) {
132
- console.log('[CodeMode] Rendered via @nexart/codemode-sdk (Protocol v1.0.0)');
133
- console.log('[CodeMode] Execution: Static mode — delegating to static-engine');
134
- return new Promise((resolve, reject) => {
135
- runStaticMode({
136
- mode: 'static',
137
- width: input.width,
138
- height: input.height,
139
- }, {
140
- code: input.source,
141
- seed: input.seed,
142
- vars: vars,
143
- onComplete: (result) => {
144
- resolve({
145
- image: result.blob,
146
- metadata: createMetadata(input, vars),
147
- });
148
- },
149
- onError: (error) => {
150
- reject(error);
151
- },
152
- });
153
- });
154
- }
155
- /**
156
- * Execute Code Mode in Loop mode - delegates to loop-engine.ts
157
- */
158
- async function executeLoop(input, vars) {
159
- console.log('[CodeMode] Rendered via @nexart/codemode-sdk (Protocol v1.0.0)');
160
- console.log(`[CodeMode] Execution: Loop mode — delegating to loop-engine (${input.totalFrames} frames)`);
161
- const fps = DEFAULT_CONFIG.fps;
162
- const duration = (input.totalFrames || 60) / fps;
163
- return new Promise((resolve, reject) => {
164
- runLoopMode({
165
- mode: 'loop',
166
- width: input.width,
167
- height: input.height,
168
- duration: duration,
169
- fps: fps,
170
- }, {
171
- code: input.source,
172
- seed: input.seed,
173
- vars: vars,
174
- onComplete: (result) => {
175
- resolve({
176
- video: result.blob,
177
- metadata: createMetadata(input, vars),
178
- });
179
- },
180
- onError: (error) => {
181
- reject(error);
182
- },
183
- });
184
- });
185
- }
186
- /**
187
- * executeCodeMode — Canonical Code Mode Execution Entry Point
188
- *
189
- * This is the ONLY official way to execute Code Mode.
190
- * All implementations MUST use this function.
191
- *
192
- * @param input - Execution parameters
193
- * @returns Promise<ExecuteCodeModeResult> - Execution result with protocol metadata
194
- *
195
- * @example
196
- * ```typescript
197
- * const result = await executeCodeMode({
198
- * source: `function setup() { background(255); ellipse(width/2, height/2, 100); }`,
199
- * width: 1950,
200
- * height: 2400,
201
- * seed: 12345,
202
- * vars: [50, 75, 0, 0, 0, 0, 0, 0, 0, 0],
203
- * mode: 'static'
204
- * });
205
- *
206
- * console.log(result.metadata.protocolVersion); // '1.0.0'
207
- * console.log(result.image); // PNG Blob
208
- * ```
209
- */
210
- export async function executeCodeMode(input) {
211
- // Validate input
212
- validateInput(input);
213
- // Normalize VAR values
214
- const vars = normalizeVars(input.vars);
215
- // Log protocol execution
216
- console.log('[CodeMode] ════════════════════════════════════════════════');
217
- console.log('[CodeMode] Protocol v1.0.0 — Phase 1 — HARD Enforcement');
218
- console.log(`[CodeMode] Mode: ${input.mode}`);
219
- console.log(`[CodeMode] Seed: ${input.seed}`);
220
- console.log(`[CodeMode] VAR: [${vars.join(', ')}]`);
221
- console.log('[CodeMode] ════════════════════════════════════════════════');
222
- // Execute based on mode
223
- if (input.mode === 'static') {
224
- return executeStatic(input, vars);
225
- }
226
- else {
227
- return executeLoop(input, vars);
228
- }
229
- }
230
- /**
231
- * Validate code without executing
232
- */
233
- export function validateCodeModeSource(source, mode) {
234
- const errors = [];
235
- // Same forbidden patterns as validateInput per CODE_MODE_PROTOCOL.md
236
- const forbiddenPatterns = [
237
- { pattern: /setTimeout\s*\(/, name: 'setTimeout' },
238
- { pattern: /setInterval\s*\(/, name: 'setInterval' },
239
- { pattern: /requestAnimationFrame\s*\(/, name: 'requestAnimationFrame' },
240
- { pattern: /Date\.now\s*\(/, name: 'Date.now() — use time variable instead' },
241
- { pattern: /new\s+Date\s*\(/, name: 'new Date() — use time variable instead' },
242
- { pattern: /Math\.random\s*\(/, name: 'Math.random() — use random() instead (seeded)' },
243
- { pattern: /fetch\s*\(/, name: 'fetch() — external IO forbidden' },
244
- { pattern: /XMLHttpRequest/, name: 'XMLHttpRequest — external IO forbidden' },
245
- { pattern: /createCanvas\s*\(/, name: 'createCanvas() — canvas is pre-initialized' },
246
- { pattern: /document\./, name: 'DOM access — document.* forbidden' },
247
- { pattern: /window\./, name: 'DOM access — window.* forbidden' },
248
- { pattern: /\bimport\s+/, name: 'import — external imports forbidden' },
249
- { pattern: /\brequire\s*\(/, name: 'require() — external imports forbidden' },
250
- ];
251
- for (const { pattern, name } of forbiddenPatterns) {
252
- if (pattern.test(source)) {
253
- errors.push(`Forbidden pattern: ${name}`);
254
- }
255
- }
256
- if (mode === 'loop') {
257
- if (!/function\s+draw\s*\(\s*\)/.test(source)) {
258
- errors.push('Loop mode requires a draw() function');
259
- }
260
- if (/noLoop\s*\(\s*\)/.test(source)) {
261
- errors.push('noLoop() is forbidden in Loop mode');
262
- }
263
- }
264
- return {
265
- valid: errors.length === 0,
266
- errors,
267
- };
268
- }
@@ -1,44 +0,0 @@
1
- /**
2
- * Noise Bridge - Injects N.* globals into Code Mode runtime
3
- *
4
- * This is the bridge between NoiseSnapshot data and the Code Mode p5-runtime.
5
- * It creates frozen N.* globals that noise sketches can access deterministically.
6
- *
7
- * Similar to sound-bridge.ts for SoundArt, but for Noise parameters.
8
- */
9
- import type { NoiseSnapshot, NoiseBlendMode } from '../../shared/noiseSnapshot';
10
- /**
11
- * The N.* global object type for noise sketches
12
- */
13
- export interface NoiseGlobals {
14
- scale: number;
15
- octaves: number;
16
- persistence: number;
17
- lacunarity: number;
18
- cellDensity: number;
19
- cellDistortion: number;
20
- blendMode: NoiseBlendMode;
21
- isPerlinOnly: boolean;
22
- isBlend: boolean;
23
- isWarp: boolean;
24
- isInterleave: boolean;
25
- bgR: number;
26
- bgG: number;
27
- bgB: number;
28
- noiseR: number;
29
- noiseG: number;
30
- noiseB: number;
31
- seed: number;
32
- zoom: number;
33
- }
34
- /**
35
- * Create N.* globals from a NoiseSnapshot
36
- */
37
- export declare function createNoiseGlobals(snapshot: NoiseSnapshot): NoiseGlobals;
38
- /**
39
- * Inject N.* globals into code string
40
- *
41
- * This wraps the sketch code with N.* variable declarations
42
- */
43
- export declare function injectNoiseGlobals(sketchCode: string, globals: NoiseGlobals): string;
44
- //# sourceMappingURL=noise-bridge.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"noise-bridge.d.ts","sourceRoot":"","sources":["../noise-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,YAAY;IAE3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IAGnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IAGvB,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IAGtB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IAGf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,CAsBxE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CA6BpF"}
@@ -1,68 +0,0 @@
1
- /**
2
- * Noise Bridge - Injects N.* globals into Code Mode runtime
3
- *
4
- * This is the bridge between NoiseSnapshot data and the Code Mode p5-runtime.
5
- * It creates frozen N.* globals that noise sketches can access deterministically.
6
- *
7
- * Similar to sound-bridge.ts for SoundArt, but for Noise parameters.
8
- */
9
- /**
10
- * Create N.* globals from a NoiseSnapshot
11
- */
12
- export function createNoiseGlobals(snapshot) {
13
- return Object.freeze({
14
- scale: snapshot.scale,
15
- octaves: snapshot.octaves,
16
- persistence: snapshot.persistence,
17
- lacunarity: snapshot.lacunarity,
18
- cellDensity: snapshot.cellDensity,
19
- cellDistortion: snapshot.cellDistortion,
20
- blendMode: snapshot.blendMode,
21
- isPerlinOnly: snapshot.blendMode === 'perlin_only',
22
- isBlend: snapshot.blendMode === 'blend',
23
- isWarp: snapshot.blendMode === 'warp',
24
- isInterleave: snapshot.blendMode === 'interleave',
25
- bgR: snapshot.bgR,
26
- bgG: snapshot.bgG,
27
- bgB: snapshot.bgB,
28
- noiseR: snapshot.noiseR,
29
- noiseG: snapshot.noiseG,
30
- noiseB: snapshot.noiseB,
31
- seed: snapshot.seed,
32
- zoom: snapshot.zoomLevel,
33
- });
34
- }
35
- /**
36
- * Inject N.* globals into code string
37
- *
38
- * This wraps the sketch code with N.* variable declarations
39
- */
40
- export function injectNoiseGlobals(sketchCode, globals) {
41
- const injection = `
42
- // === Injected Noise Globals (N.*) ===
43
- const N = Object.freeze({
44
- scale: ${globals.scale},
45
- octaves: ${globals.octaves},
46
- persistence: ${globals.persistence},
47
- lacunarity: ${globals.lacunarity},
48
- cellDensity: ${globals.cellDensity},
49
- cellDistortion: ${globals.cellDistortion},
50
- blendMode: '${globals.blendMode}',
51
- isPerlinOnly: ${globals.isPerlinOnly},
52
- isBlend: ${globals.isBlend},
53
- isWarp: ${globals.isWarp},
54
- isInterleave: ${globals.isInterleave},
55
- bgR: ${globals.bgR},
56
- bgG: ${globals.bgG},
57
- bgB: ${globals.bgB},
58
- noiseR: ${globals.noiseR},
59
- noiseG: ${globals.noiseG},
60
- noiseB: ${globals.noiseB},
61
- seed: ${globals.seed},
62
- zoom: ${globals.zoom}
63
- });
64
- // === End Injected Globals ===
65
-
66
- `;
67
- return injection + sketchCode;
68
- }
@@ -1,74 +0,0 @@
1
- /**
2
- * Noise → Code Mode Engine
3
- *
4
- * This is the orchestrator that runs Noise rendering through the Code Mode engine.
5
- * It replaces the legacy p5.js-based NoiseCanvas with a protocol-compliant pipeline.
6
- *
7
- * Architecture:
8
- * 1. NoiseParams from UI state
9
- * 2. NoiseParams → NoiseSnapshot conversion
10
- * 3. NoiseSnapshot injected as N.* globals into Code Mode
11
- * 4. Noise sketch executed via Code Mode runtime
12
- * 5. Result: PNG output (deterministic)
13
- */
14
- import type { NoiseSnapshot, NoiseParams } from '../../shared/noiseSnapshot';
15
- export interface NoiseEngineConfig {
16
- width: number;
17
- height: number;
18
- seed: number;
19
- }
20
- export interface NoiseRenderOptions {
21
- params: NoiseParams;
22
- canvas: HTMLCanvasElement;
23
- config: NoiseEngineConfig;
24
- onProgress?: (progress: number) => void;
25
- }
26
- export interface NoiseRenderResult {
27
- mode: 'noise';
28
- snapshot: NoiseSnapshot;
29
- metadata: NoiseMetadata;
30
- }
31
- export interface NoiseMetadata {
32
- mode: 'Noise';
33
- timestamp: string;
34
- enforcement: 'hard';
35
- renderedVia: 'codemode';
36
- noiseParams: {
37
- scale: number;
38
- octaves: number;
39
- persistence: number;
40
- lacunarity: number;
41
- cellDensity: number;
42
- cellDistortion: number;
43
- blendMode: string;
44
- };
45
- generationParams: {
46
- seed: number;
47
- canvasSize: {
48
- width: number;
49
- height: number;
50
- };
51
- };
52
- }
53
- /**
54
- * Render noise via Code Mode runtime
55
- *
56
- * This is the main entry point for protocol-compliant noise rendering.
57
- * All rendering goes through the Code Mode runtime for determinism.
58
- */
59
- export declare function renderNoiseViaCodeMode(options: NoiseRenderOptions): Promise<NoiseRenderResult>;
60
- /**
61
- * Compile noise params to a Code Mode system
62
- * This produces a reproducible system definition
63
- */
64
- export declare function compileNoiseSystem(params: NoiseParams): {
65
- sketchCode: string;
66
- snapshot: NoiseSnapshot;
67
- seed: number;
68
- };
69
- /**
70
- * Check if noise can be rendered via Code Mode
71
- * (Always true - no legacy fallback)
72
- */
73
- export declare function canRenderNoiseViaCodeMode(): boolean;
74
- //# sourceMappingURL=noise-engine.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"noise-engine.d.ts","sourceRoot":"","sources":["../noise-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAM7E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,gBAAgB,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAsF5B;AAwBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd,CAUA;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD"}
@@ -1,132 +0,0 @@
1
- /**
2
- * Noise → Code Mode Engine
3
- *
4
- * This is the orchestrator that runs Noise rendering through the Code Mode engine.
5
- * It replaces the legacy p5.js-based NoiseCanvas with a protocol-compliant pipeline.
6
- *
7
- * Architecture:
8
- * 1. NoiseParams from UI state
9
- * 2. NoiseParams → NoiseSnapshot conversion
10
- * 3. NoiseSnapshot injected as N.* globals into Code Mode
11
- * 4. Noise sketch executed via Code Mode runtime
12
- * 5. Result: PNG output (deterministic)
13
- */
14
- import { createNoiseSnapshot, validateNoiseSnapshot } from '../../shared/noiseSnapshot';
15
- import { createP5Runtime } from './p5-runtime';
16
- import { createNoiseGlobals, injectNoiseGlobals } from './noise-bridge';
17
- import { getNoiseSketch } from './noise-sketches';
18
- /**
19
- * Render noise via Code Mode runtime
20
- *
21
- * This is the main entry point for protocol-compliant noise rendering.
22
- * All rendering goes through the Code Mode runtime for determinism.
23
- */
24
- export async function renderNoiseViaCodeMode(options) {
25
- const { params, canvas, config, onProgress } = options;
26
- // Protocol enforcement logging
27
- console.log('[Noise] Protocol enforcement: HARD | renderedVia: codemode');
28
- onProgress?.(0.1);
29
- // Create and validate snapshot
30
- const rawSnapshot = createNoiseSnapshot(params);
31
- const snapshot = validateNoiseSnapshot(rawSnapshot);
32
- onProgress?.(0.2);
33
- // Create N.* globals
34
- const noiseGlobals = createNoiseGlobals(snapshot);
35
- // Get the noise sketch
36
- const sketchName = 'fractalNoise';
37
- const sketchCode = getNoiseSketch(sketchName);
38
- // Inject N.* globals into sketch
39
- const injectedCode = injectNoiseGlobals(sketchCode, noiseGlobals);
40
- onProgress?.(0.3);
41
- // Set canvas dimensions
42
- canvas.width = config.width;
43
- canvas.height = config.height;
44
- // Create P5 runtime with correct signature
45
- const runtimeConfig = {
46
- seed: config.seed,
47
- };
48
- const runtime = createP5Runtime(canvas, config.width, config.height, runtimeConfig);
49
- onProgress?.(0.5);
50
- // Build globals with all runtime functions and noise globals
51
- const globals = {
52
- ...runtime,
53
- width: config.width,
54
- height: config.height,
55
- };
56
- // Execute the sketch
57
- try {
58
- executeNoiseSketch(injectedCode, globals);
59
- onProgress?.(0.9);
60
- console.log('[Noise] Rendered via Code Mode runtime');
61
- // Build metadata
62
- const metadata = {
63
- mode: 'Noise',
64
- timestamp: new Date().toISOString(),
65
- enforcement: 'hard',
66
- renderedVia: 'codemode',
67
- noiseParams: {
68
- scale: snapshot.scale,
69
- octaves: snapshot.octaves,
70
- persistence: snapshot.persistence,
71
- lacunarity: snapshot.lacunarity,
72
- cellDensity: snapshot.cellDensity,
73
- cellDistortion: snapshot.cellDistortion,
74
- blendMode: snapshot.blendMode,
75
- },
76
- generationParams: {
77
- seed: config.seed,
78
- canvasSize: { width: config.width, height: config.height },
79
- },
80
- };
81
- onProgress?.(1.0);
82
- return {
83
- mode: 'noise',
84
- snapshot,
85
- metadata,
86
- };
87
- }
88
- catch (error) {
89
- console.error('[Noise] Code Mode execution failed:', error);
90
- throw error;
91
- }
92
- }
93
- /**
94
- * Execute a noise sketch string in the context of the runtime globals
95
- */
96
- function executeNoiseSketch(code, globals) {
97
- const globalNames = Object.keys(globals);
98
- const globalValues = Object.values(globals);
99
- // Wrap the sketch code to call setup()
100
- const wrappedCode = `
101
- ${code}
102
-
103
- // Execute setup (noise is static - single frame)
104
- if (typeof setup === 'function') {
105
- setup();
106
- }
107
- `;
108
- // Create and execute the function
109
- const sketchFunction = new Function(...globalNames, wrappedCode);
110
- sketchFunction(...globalValues);
111
- }
112
- /**
113
- * Compile noise params to a Code Mode system
114
- * This produces a reproducible system definition
115
- */
116
- export function compileNoiseSystem(params) {
117
- const snapshot = validateNoiseSnapshot(createNoiseSnapshot(params));
118
- const noiseGlobals = createNoiseGlobals(snapshot);
119
- const sketchCode = injectNoiseGlobals(getNoiseSketch('fractalNoise'), noiseGlobals);
120
- return {
121
- sketchCode,
122
- snapshot,
123
- seed: params.seed,
124
- };
125
- }
126
- /**
127
- * Check if noise can be rendered via Code Mode
128
- * (Always true - no legacy fallback)
129
- */
130
- export function canRenderNoiseViaCodeMode() {
131
- return true;
132
- }
@@ -1,11 +0,0 @@
1
- /**
2
- * Fractal Noise - Code Mode Sketch
3
- *
4
- * This sketch implements Perlin FBM and Cellular noise rendering
5
- * through the Code Mode p5-runtime. Uses N.* globals for all parameters.
6
- *
7
- * Original: client/src/components/noise-canvas-simple.tsx
8
- */
9
- export declare const FRACTAL_NOISE_SKETCH = "\n// Fractal Noise - Code Mode Sketch\n// Uses N.* noise globals and standard p5-like functions\n\nfunction setup() {\n // Set seeded random for reproducibility\n randomSeed(N.seed);\n noiseSeed(N.seed);\n \n // Set background color\n background(N.bgR, N.bgG, N.bgB);\n \n // Noise rendering parameters\n const adjustedScale = N.scale * (1 / N.zoom) * 0.05;\n const cellSize = 4; // Fixed for quality\n \n // Generate cellular points if needed\n const numPoints = Math.floor(20 + N.cellDensity * 180);\n const cellPoints = [];\n for (let i = 0; i < numPoints; i++) {\n cellPoints.push([random(0, width), random(0, height)]);\n }\n \n // Helper: Perlin FBM (Fractional Brownian Motion)\n function perlinFBM(x, y, scale) {\n let value = 0;\n let amplitude = 1;\n let frequency = 1;\n let maxValue = 0;\n \n const oct = Math.min(N.octaves, 6); // Cap for performance\n \n for (let i = 0; i < oct; i++) {\n value += noise(x * scale * frequency, y * scale * frequency) * amplitude;\n maxValue += amplitude;\n amplitude *= N.persistence;\n frequency *= N.lacunarity;\n }\n \n return value / maxValue;\n }\n \n // Helper: Cellular noise (Worley)\n function cellularNoise(x, y, points) {\n let sampleX = x;\n let sampleY = y;\n \n // Warp distortion if using warp mode\n if (N.isWarp && N.cellDistortion > 0) {\n const distortionAmount = N.cellDistortion * 100;\n sampleX += noise(x * 0.01, y * 0.01) * distortionAmount;\n sampleY += noise(y * 0.01, x * 0.01) * distortionAmount;\n }\n \n // Find distances to closest points\n let minDist = 999999;\n let secondMinDist = 999999;\n \n for (let i = 0; i < points.length; i++) {\n const px = points[i][0];\n const py = points[i][1];\n const dx = sampleX - px;\n const dy = sampleY - py;\n const dist = Math.sqrt(dx * dx + dy * dy);\n \n if (dist < minDist) {\n secondMinDist = minDist;\n minDist = dist;\n } else if (dist < secondMinDist) {\n secondMinDist = dist;\n }\n }\n \n // Normalize distance\n return Math.min(1.0, (secondMinDist - minDist) / 50);\n }\n \n // Render the noise grid\n noStroke();\n \n for (let y = 0; y < height; y += cellSize) {\n for (let x = 0; x < width; x += cellSize) {\n // Calculate Perlin value\n const perlinValue = perlinFBM(x, y, adjustedScale);\n \n // Calculate final value based on blend mode\n let finalValue = perlinValue;\n \n if (!N.isPerlinOnly) {\n const cellValue = cellularNoise(x, y, cellPoints);\n \n if (N.isBlend) {\n finalValue = perlinValue * cellValue;\n } else if (N.isWarp) {\n finalValue = (perlinValue + cellValue) / 2;\n } else if (N.isInterleave) {\n finalValue = (Math.floor(x / 20) + Math.floor(y / 20)) % 2 === 0\n ? perlinValue\n : cellValue;\n }\n }\n \n // Set opacity based on noise value\n const alpha = map(finalValue, 0, 1, 0, 255);\n \n // Fill with noise color and calculated alpha\n fill(N.noiseR, N.noiseG, N.noiseB, alpha);\n rect(x, y, cellSize, cellSize);\n }\n }\n}\n";
10
- export default FRACTAL_NOISE_SKETCH;
11
- //# sourceMappingURL=fractalNoise.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"fractalNoise.d.ts","sourceRoot":"","sources":["../../noise-sketches/fractalNoise.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,oBAAoB,4sGA+GhC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}