@genart-dev/core 0.1.1 → 0.2.0

package/dist/index.d.cts

@@ -1,5 +1,7 @@
 import { ParamDef, ColorDef, RendererType, SketchState, CanvasSpec, SketchDefinition } from '@genart-dev/format';
 export * from '@genart-dev/format';
+import { ResolvedComponent } from '@genart-dev/components';
+export { COMPONENT_REGISTRY, ComponentCategory, ComponentEntry, RendererTarget, ResolvedComponent, resolveComponents } from '@genart-dev/components';
 
 /** A design knowledge skill definition. */
 interface SkillDefinition {
@@ -75,8 +77,9 @@ interface RendererAdapter {
     readonly algorithmLanguage: "javascript" | "glsl" | "typescript";
     /** Validate algorithm source without executing it. */
     validate(algorithm: string): ValidationResult;
-    /** Compile an algorithm string into a runnable form. */
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    /** Compile an algorithm string into a runnable form.
+     *  @param components — Pre-resolved component source to prepend (from resolveComponents). */
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     /** Create a live sketch instance from compiled algorithm + state. */
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     /** Render a single frame offscreen (for capture/export). */
@@ -126,7 +129,7 @@ declare class P5RendererAdapter implements RendererAdapter {
     readonly displayName = "p5.js";
     readonly algorithmLanguage: "javascript";
     validate(algorithm: string): ValidationResult;
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     renderOffscreen(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec, options?: CaptureOptions): Promise<Uint8Array | Blob>;
     generateStandaloneHTML(sketch: SketchDefinition): string;
@@ -145,7 +148,7 @@ declare class Canvas2DRendererAdapter implements RendererAdapter {
     readonly displayName = "Canvas 2D";
     readonly algorithmLanguage: "javascript";
     validate(algorithm: string): ValidationResult;
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     renderOffscreen(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec, options?: CaptureOptions): Promise<Uint8Array | Blob>;
     generateStandaloneHTML(sketch: SketchDefinition): string;
@@ -164,7 +167,7 @@ declare class ThreeRendererAdapter implements RendererAdapter {
     readonly displayName = "Three.js";
     readonly algorithmLanguage: "javascript";
     validate(algorithm: string): ValidationResult;
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     renderOffscreen(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec, options?: CaptureOptions): Promise<Uint8Array | Blob>;
     generateStandaloneHTML(sketch: SketchDefinition): string;
@@ -188,7 +191,7 @@ declare class GLSLRendererAdapter implements RendererAdapter {
     readonly displayName = "GLSL Shader";
     readonly algorithmLanguage: "glsl";
     validate(algorithm: string): ValidationResult;
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     renderOffscreen(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec, options?: CaptureOptions): Promise<Uint8Array | Blob>;
     generateStandaloneHTML(sketch: SketchDefinition): string;
@@ -208,7 +211,7 @@ declare class SVGRendererAdapter implements RendererAdapter {
     readonly displayName = "SVG";
     readonly algorithmLanguage: "javascript";
     validate(algorithm: string): ValidationResult;
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     renderOffscreen(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec, _options?: CaptureOptions): Promise<Uint8Array | Blob>;
     generateStandaloneHTML(sketch: SketchDefinition): string;

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { ParamDef, ColorDef, RendererType, SketchState, CanvasSpec, SketchDefinition } from '@genart-dev/format';
 export * from '@genart-dev/format';
+import { ResolvedComponent } from '@genart-dev/components';
+export { COMPONENT_REGISTRY, ComponentCategory, ComponentEntry, RendererTarget, ResolvedComponent, resolveComponents } from '@genart-dev/components';
 
 /** A design knowledge skill definition. */
 interface SkillDefinition {
@@ -75,8 +77,9 @@ interface RendererAdapter {
     readonly algorithmLanguage: "javascript" | "glsl" | "typescript";
     /** Validate algorithm source without executing it. */
     validate(algorithm: string): ValidationResult;
-    /** Compile an algorithm string into a runnable form. */
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    /** Compile an algorithm string into a runnable form.
+     *  @param components — Pre-resolved component source to prepend (from resolveComponents). */
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     /** Create a live sketch instance from compiled algorithm + state. */
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     /** Render a single frame offscreen (for capture/export). */
@@ -126,7 +129,7 @@ declare class P5RendererAdapter implements RendererAdapter {
     readonly displayName = "p5.js";
     readonly algorithmLanguage: "javascript";
     validate(algorithm: string): ValidationResult;
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     renderOffscreen(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec, options?: CaptureOptions): Promise<Uint8Array | Blob>;
     generateStandaloneHTML(sketch: SketchDefinition): string;
@@ -145,7 +148,7 @@ declare class Canvas2DRendererAdapter implements RendererAdapter {
     readonly displayName = "Canvas 2D";
     readonly algorithmLanguage: "javascript";
     validate(algorithm: string): ValidationResult;
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     renderOffscreen(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec, options?: CaptureOptions): Promise<Uint8Array | Blob>;
     generateStandaloneHTML(sketch: SketchDefinition): string;
@@ -164,7 +167,7 @@ declare class ThreeRendererAdapter implements RendererAdapter {
     readonly displayName = "Three.js";
     readonly algorithmLanguage: "javascript";
     validate(algorithm: string): ValidationResult;
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     renderOffscreen(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec, options?: CaptureOptions): Promise<Uint8Array | Blob>;
     generateStandaloneHTML(sketch: SketchDefinition): string;
@@ -188,7 +191,7 @@ declare class GLSLRendererAdapter implements RendererAdapter {
     readonly displayName = "GLSL Shader";
     readonly algorithmLanguage: "glsl";
     validate(algorithm: string): ValidationResult;
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     renderOffscreen(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec, options?: CaptureOptions): Promise<Uint8Array | Blob>;
     generateStandaloneHTML(sketch: SketchDefinition): string;
@@ -208,7 +211,7 @@ declare class SVGRendererAdapter implements RendererAdapter {
     readonly displayName = "SVG";
     readonly algorithmLanguage: "javascript";
     validate(algorithm: string): ValidationResult;
-    compile(algorithm: string): Promise<CompiledAlgorithm>;
+    compile(algorithm: string, components?: ResolvedComponent[]): Promise<CompiledAlgorithm>;
     createInstance(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec): SketchInstance;
     renderOffscreen(compiled: CompiledAlgorithm, state: SketchState, canvas: CanvasSpec, _options?: CaptureOptions): Promise<Uint8Array | Blob>;
     generateStandaloneHTML(sketch: SketchDefinition): string;

package/dist/index.js

@@ -1,5 +1,24 @@
 // src/index.ts
 export * from "@genart-dev/format";
+import {
+  COMPONENT_REGISTRY,
+  resolveComponents
+} from "@genart-dev/components";
+
+// src/sketch/adapters/component-utils.ts
+function extractComponentCode(components) {
+  if (!components) return "";
+  const blocks = [];
+  for (const [name, value] of Object.entries(components)) {
+    if (typeof value === "string") continue;
+    if (value.code) {
+      const ver = value.version ? ` v${value.version}` : "";
+      blocks.push(`// --- ${name}${ver} ---
+${value.code}`);
+    }
+  }
+  return blocks.join("\n\n");
+}
 
 // src/sketch/adapters/p5.ts
 var P5_CDN_VERSION = "1.11.3";
@@ -25,15 +44,20 @@ var P5RendererAdapter = class {
     }
     return { valid: errors.length === 0, errors };
   }
-  async compile(algorithm) {
+  async compile(algorithm, components) {
     const validation = this.validate(algorithm);
     if (!validation.valid) {
       throw new Error(
         `p5 compilation failed: ${validation.errors.join("; ")}`
       );
     }
+    const componentCode = components?.map(
+      (c) => `// --- ${c.name} v${c.version} ---
+${c.code}`
+    ).join("\n\n") ?? "";
     const wrappedSource = `
       return (function() {
+        ${componentCode}
         ${algorithm}
         return sketch;
       })();
@@ -187,6 +211,7 @@ var P5RendererAdapter = class {
     state.PARAMS = state.params;
     state.COLORS = ${colorsJson};
 
+    ${extractComponentCode(sketch.components)}
     ${sketch.algorithm}
 
     new p5(function(p) {
@@ -242,15 +267,20 @@ var Canvas2DRendererAdapter = class {
     }
     return { valid: errors.length === 0, errors };
   }
-  async compile(algorithm) {
+  async compile(algorithm, components) {
     const validation = this.validate(algorithm);
     if (!validation.valid) {
       throw new Error(
         `Canvas 2D compilation failed: ${validation.errors.join("; ")}`
       );
     }
+    const componentCode = components?.map(
+      (c) => `// --- ${c.name} v${c.version} ---
+${c.code}`
+    ).join("\n\n") ?? "";
     const wrappedSource = `
       return (function() {
+        ${componentCode}
         ${algorithm}
         return sketch;
       })();
@@ -410,6 +440,7 @@ var Canvas2DRendererAdapter = class {
       const state = ${stateJson};
       state.canvas = { width: ${width}, height: ${height}, pixelDensity: ${pixelDensity} };
 
+      ${extractComponentCode(sketch.components)}
       ${sketch.algorithm}
 
       const canvas = document.getElementById('canvas');
@@ -469,15 +500,20 @@ var ThreeRendererAdapter = class {
     }
     return { valid: true, errors: [] };
   }
-  async compile(algorithm) {
+  async compile(algorithm, components) {
     const validation = this.validate(algorithm);
     if (!validation.valid) {
       throw new Error(
         `Three.js compilation failed: ${validation.errors.join("; ")}`
       );
     }
+    const componentCode = components?.map(
+      (c) => `// --- ${c.name} v${c.version} ---
+${c.code}`
+    ).join("\n\n") ?? "";
     const wrappedSource = `
       return (function() {
+        ${componentCode}
         ${algorithm}
         return sketch;
       })();
@@ -620,6 +656,7 @@ var ThreeRendererAdapter = class {
     const state = ${stateJson};
     state.canvas = { width: ${width}, height: ${height}, pixelDensity: ${pixelDensity} };
 
+    ${extractComponentCode(sketch.components)}
     ${sketch.algorithm}
 
     sketch(THREE, state, document.getElementById('canvas-container'));
@@ -724,6 +761,41 @@ function extractUniforms(source) {
   }
   return { params, colors };
 }
+function injectGLSLSource(algorithm, codeToInject) {
+  if (!codeToInject) return algorithm;
+  const trimmed = algorithm.trimStart();
+  const versionMatch = trimmed.match(/^(#version\s+\S+[^\n]*\n)/);
+  const versionLine = versionMatch?.[1] ?? "";
+  let shaderBody = versionMatch ? trimmed.slice(versionLine.length) : trimmed;
+  const precisionLines = [];
+  let precisionMatch;
+  while ((precisionMatch = shaderBody.match(/^\s*(precision\s+\w+\s+\w+;\s*\n)/)) !== null) {
+    precisionLines.push(precisionMatch[1]);
+    shaderBody = shaderBody.slice(precisionMatch[0].length);
+  }
+  return versionLine + precisionLines.join("") + "\n" + codeToInject + "\n\n" + shaderBody;
+}
+function injectGLSLComponents(algorithm, components) {
+  if (!components || components.length === 0) return algorithm;
+  const componentCode = components.map(
+    (c) => `// --- ${c.name} v${c.version} ---
+${c.code}`
+  ).join("\n\n");
+  return injectGLSLSource(algorithm, componentCode);
+}
+function extractGLSLComponentCode(components) {
+  if (!components) return "";
+  const blocks = [];
+  for (const [name, value] of Object.entries(components)) {
+    if (typeof value === "string") continue;
+    if (value.code) {
+      const ver = value.version ? ` v${value.version}` : "";
+      blocks.push(`// --- ${name}${ver} ---
+${value.code}`);
+    }
+  }
+  return blocks.join("\n\n");
+}
 var GLSLRendererAdapter = class {
   type = "glsl";
   displayName = "GLSL Shader";
@@ -747,16 +819,17 @@ var GLSLRendererAdapter = class {
     }
     return { valid: errors.length === 0, errors };
   }
-  async compile(algorithm) {
+  async compile(algorithm, components) {
     const validation = this.validate(algorithm);
     if (!validation.valid) {
       throw new Error(
         `GLSL compilation failed: ${validation.errors.join("; ")}`
       );
     }
-    const uniforms = extractUniforms(algorithm);
+    const fragmentSource = injectGLSLComponents(algorithm, components);
+    const uniforms = extractUniforms(fragmentSource);
     const compiled = {
-      fragmentSource: algorithm,
+      fragmentSource,
       vertexSource: FULLSCREEN_QUAD_VERTEX,
       uniformNames: uniforms
     };
@@ -1002,7 +1075,9 @@ var GLSLRendererAdapter = class {
     const { width, height } = sketch.canvas;
     const pixelDensity = sketch.canvas.pixelDensity ?? 1;
     const stateJson = JSON.stringify(sketch.state, null, 2);
-    const uniforms = extractUniforms(sketch.algorithm);
+    const glslComponentCode = extractGLSLComponentCode(sketch.components);
+    const fullAlgorithm = glslComponentCode ? injectGLSLSource(sketch.algorithm, glslComponentCode) : sketch.algorithm;
+    const uniforms = extractUniforms(fullAlgorithm);
     const paramBindings = uniforms.params.map((u) => {
       const key = u.substring(2);
       return `    { const loc = gl.getUniformLocation(program, "${u}"); if (loc && state.params["${key}"] !== undefined) gl.uniform1f(loc, state.params["${key}"]); }`;
@@ -1036,7 +1111,7 @@ var GLSLRendererAdapter = class {
     const vertSrc = \`${FULLSCREEN_QUAD_VERTEX}\`;
 
     // Fragment shader
-    const fragSrc = \`${sketch.algorithm.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$/g, "\\$")}\`;
+    const fragSrc = \`${fullAlgorithm.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$/g, "\\$")}\`;
 
     function createShader(type, src) {
       const s = gl.createShader(type);
@@ -1133,15 +1208,20 @@ var SVGRendererAdapter = class {
     }
     return { valid: true, errors: [] };
   }
-  async compile(algorithm) {
+  async compile(algorithm, components) {
     const validation = this.validate(algorithm);
     if (!validation.valid) {
       throw new Error(
         `SVG compilation failed: ${validation.errors.join("; ")}`
       );
     }
+    const componentCode = components?.map(
+      (c) => `// --- ${c.name} v${c.version} ---
+${c.code}`
+    ).join("\n\n") ?? "";
     const wrappedSource = `
       return (function() {
+        ${componentCode}
         ${algorithm}
         return sketch;
       })();
@@ -1271,6 +1351,7 @@ var SVGRendererAdapter = class {
     const state = ${stateJson};
     state.canvas = { width: ${width}, height: ${height} };
 
+    ${extractComponentCode(sketch.components)}
     ${sketch.algorithm}
 
     const module = sketch(state);
@@ -1804,6 +1885,7 @@ function createDefaultSkillRegistry() {
 }
 export {
   COLOR_SKILLS,
+  COMPONENT_REGISTRY,
   COMPOSITION_SKILLS,
   Canvas2DRendererAdapter,
   GLSLRendererAdapter,
@@ -1814,6 +1896,7 @@ export {
   ThreeRendererAdapter,
   createDefaultRegistry,
   createDefaultSkillRegistry,
-  hexToVec3
+  hexToVec3,
+  resolveComponents
 };
 //# sourceMappingURL=index.js.map