@contractspec/lib.image-gen 0.2.0

package/dist/node/index.js

@@ -0,0 +1,623 @@
+// src/i18n/catalogs/en.ts
+import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
+var enMessages = defineTranslation({
+  meta: {
+    key: "image-gen.messages",
+    version: "1.0.0",
+    domain: "image-gen",
+    description: "All user-facing, LLM-facing, and developer-facing strings for the image-gen package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "en",
+  fallback: "en",
+  messages: {
+    "prompt.system.imagePromptEngineer": {
+      value: "You are an expert image prompt engineer. Given a JSON brief containing title, summary, problems, solutions, purpose, style, and style tokens, produce a single detailed image generation prompt. The prompt should be vivid, specific, and optimized for AI image generation models. Focus on composition, lighting, color palette, and subject matter. Output only the prompt text, no JSON.",
+      description: "System prompt for LLM-based image prompt engineering"
+    },
+    "image.generate.description": {
+      value: "Generate a {style} image for {purpose}",
+      description: "Description template for image generation tasks",
+      placeholders: [
+        { name: "style", type: "string" },
+        { name: "purpose", type: "string" }
+      ]
+    },
+    "image.prompt.featuring": {
+      value: "featuring {solutions}",
+      description: "Prompt fragment for featured solutions",
+      placeholders: [{ name: "solutions", type: "string" }]
+    },
+    "image.prompt.industryContext": {
+      value: "{industry} context",
+      description: "Prompt fragment for industry context",
+      placeholders: [{ name: "industry", type: "string" }]
+    },
+    "image.error.noProvider": {
+      value: "No image provider configured",
+      description: "Error message when no ImageProvider is available"
+    },
+    "image.error.generationFailed": {
+      value: "Image generation failed",
+      description: "Error message when image generation fails"
+    },
+    "purpose.blogHero": {
+      value: "Blog hero image",
+      description: "Label for blog hero image purpose"
+    },
+    "purpose.socialOg": {
+      value: "Social media OG image",
+      description: "Label for Open Graph image purpose"
+    },
+    "purpose.socialTwitter": {
+      value: "Twitter card image",
+      description: "Label for Twitter card image purpose"
+    },
+    "purpose.socialInstagram": {
+      value: "Instagram image",
+      description: "Label for Instagram image purpose"
+    },
+    "purpose.landingHero": {
+      value: "Landing page hero",
+      description: "Label for landing page hero image purpose"
+    },
+    "purpose.videoThumbnail": {
+      value: "Video thumbnail",
+      description: "Label for video thumbnail purpose"
+    },
+    "purpose.emailHeader": {
+      value: "Email header",
+      description: "Label for email header image purpose"
+    },
+    "purpose.illustration": {
+      value: "Illustration",
+      description: "Label for illustration purpose"
+    },
+    "purpose.icon": {
+      value: "Icon",
+      description: "Label for icon purpose"
+    }
+  }
+});
+
+// src/i18n/catalogs/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages = defineTranslation2({
+  meta: {
+    key: "image-gen.messages",
+    version: "1.0.0",
+    domain: "image-gen",
+    description: "French translations for the image-gen package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "fr",
+  fallback: "en",
+  messages: {
+    "prompt.system.imagePromptEngineer": {
+      value: "Vous êtes un expert en ingénierie de prompts d'images. À partir d'un brief JSON contenant titre, résumé, problèmes, solutions, objectif, style et tokens de style, produisez un prompt détaillé de génération d'image. Le prompt doit être vivant, spécifique et optimisé pour les modèles de génération d'images IA. Concentrez-vous sur la composition, l'éclairage, la palette de couleurs et le sujet. Produisez uniquement le texte du prompt, pas de JSON.",
+      description: "Prompt système pour l'ingénierie de prompts d'images par LLM"
+    },
+    "image.generate.description": {
+      value: "Générer une image {style} pour {purpose}",
+      description: "Modèle de description pour les tâches de génération d'images",
+      placeholders: [
+        { name: "style", type: "string" },
+        { name: "purpose", type: "string" }
+      ]
+    },
+    "image.prompt.featuring": {
+      value: "mettant en avant {solutions}",
+      description: "Fragment de prompt pour les solutions mises en avant",
+      placeholders: [{ name: "solutions", type: "string" }]
+    },
+    "image.prompt.industryContext": {
+      value: "contexte {industry}",
+      description: "Fragment de prompt pour le contexte industriel",
+      placeholders: [{ name: "industry", type: "string" }]
+    },
+    "image.error.noProvider": {
+      value: "Aucun fournisseur d'images configuré",
+      description: "Message d'erreur quand aucun ImageProvider n'est disponible"
+    },
+    "image.error.generationFailed": {
+      value: "La génération d'image a échoué",
+      description: "Message d'erreur quand la génération d'image échoue"
+    },
+    "purpose.blogHero": {
+      value: "Image hero de blog",
+      description: "Libellé pour l'objectif image hero de blog"
+    },
+    "purpose.socialOg": {
+      value: "Image OG pour réseaux sociaux",
+      description: "Libellé pour l'objectif image Open Graph"
+    },
+    "purpose.socialTwitter": {
+      value: "Image carte Twitter",
+      description: "Libellé pour l'objectif image carte Twitter"
+    },
+    "purpose.socialInstagram": {
+      value: "Image Instagram",
+      description: "Libellé pour l'objectif image Instagram"
+    },
+    "purpose.landingHero": {
+      value: "Hero de page d'atterrissage",
+      description: "Libellé pour l'objectif image hero de page d'atterrissage"
+    },
+    "purpose.videoThumbnail": {
+      value: "Miniature vidéo",
+      description: "Libellé pour l'objectif miniature vidéo"
+    },
+    "purpose.emailHeader": {
+      value: "En-tête d'email",
+      description: "Libellé pour l'objectif image en-tête d'email"
+    },
+    "purpose.illustration": {
+      value: "Illustration",
+      description: "Libellé pour l'objectif illustration"
+    },
+    "purpose.icon": {
+      value: "Icône",
+      description: "Libellé pour l'objectif icône"
+    }
+  }
+});
+
+// src/i18n/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages = defineTranslation3({
+  meta: {
+    key: "image-gen.messages",
+    version: "1.0.0",
+    domain: "image-gen",
+    description: "Spanish translations for the image-gen package",
+    owners: ["platform"],
+    stability: "experimental"
+  },
+  locale: "es",
+  fallback: "en",
+  messages: {
+    "prompt.system.imagePromptEngineer": {
+      value: "Eres un experto en ingeniería de prompts de imágenes. Dado un brief JSON que contiene título, resumen, problemas, soluciones, propósito, estilo y tokens de estilo, produce un prompt detallado de generación de imágenes. El prompt debe ser vívido, específico y optimizado para modelos de generación de imágenes con IA. Concéntrate en la composición, iluminación, paleta de colores y tema. Produce solo el texto del prompt, sin JSON.",
+      description: "Prompt del sistema para ingeniería de prompts de imágenes por LLM"
+    },
+    "image.generate.description": {
+      value: "Generar una imagen {style} para {purpose}",
+      description: "Plantilla de descripción para tareas de generación de imágenes",
+      placeholders: [
+        { name: "style", type: "string" },
+        { name: "purpose", type: "string" }
+      ]
+    },
+    "image.prompt.featuring": {
+      value: "presentando {solutions}",
+      description: "Fragmento de prompt para soluciones destacadas",
+      placeholders: [{ name: "solutions", type: "string" }]
+    },
+    "image.prompt.industryContext": {
+      value: "contexto de {industry}",
+      description: "Fragmento de prompt para contexto de industria",
+      placeholders: [{ name: "industry", type: "string" }]
+    },
+    "image.error.noProvider": {
+      value: "No hay proveedor de imágenes configurado",
+      description: "Mensaje de error cuando no hay ImageProvider disponible"
+    },
+    "image.error.generationFailed": {
+      value: "La generación de imagen falló",
+      description: "Mensaje de error cuando la generación de imagen falla"
+    },
+    "purpose.blogHero": {
+      value: "Imagen hero de blog",
+      description: "Etiqueta para el propósito imagen hero de blog"
+    },
+    "purpose.socialOg": {
+      value: "Imagen OG para redes sociales",
+      description: "Etiqueta para el propósito imagen Open Graph"
+    },
+    "purpose.socialTwitter": {
+      value: "Imagen de tarjeta Twitter",
+      description: "Etiqueta para el propósito imagen tarjeta Twitter"
+    },
+    "purpose.socialInstagram": {
+      value: "Imagen de Instagram",
+      description: "Etiqueta para el propósito imagen Instagram"
+    },
+    "purpose.landingHero": {
+      value: "Hero de página de aterrizaje",
+      description: "Etiqueta para el propósito imagen hero de página de aterrizaje"
+    },
+    "purpose.videoThumbnail": {
+      value: "Miniatura de video",
+      description: "Etiqueta para el propósito miniatura de video"
+    },
+    "purpose.emailHeader": {
+      value: "Encabezado de email",
+      description: "Etiqueta para el propósito imagen encabezado de email"
+    },
+    "purpose.illustration": {
+      value: "Ilustración",
+      description: "Etiqueta para el propósito ilustración"
+    },
+    "purpose.icon": {
+      value: "Icono",
+      description: "Etiqueta para el propósito icono"
+    }
+  }
+});
+
+// src/i18n/messages.ts
+import {
+  createI18nFactory
+} from "@contractspec/lib.contracts-spec/translations";
+var factory = createI18nFactory({
+  specKey: "image-gen.messages",
+  catalogs: [enMessages, frMessages, esMessages]
+});
+var createImageGenI18n = factory.create;
+var getDefaultI18n = factory.getDefault;
+var resetI18nRegistry = factory.resetRegistry;
+
+// src/generators/prompt-builder.ts
+class PromptBuilder {
+  llm;
+  model;
+  temperature;
+  i18n;
+  constructor(options) {
+    this.llm = options.llm;
+    this.model = options.model;
+    this.temperature = options.temperature ?? 0.4;
+    this.i18n = options.i18n;
+  }
+  async build(brief, resolvedStyle) {
+    const style = brief.style ?? "photorealistic";
+    const format = brief.format ?? "png";
+    if (this.llm) {
+      try {
+        return await this.buildWithLlm(brief, resolvedStyle, style, format);
+      } catch {
+        return this.buildDeterministic(brief, resolvedStyle, style, format);
+      }
+    }
+    return this.buildDeterministic(brief, resolvedStyle, style, format);
+  }
+  async buildWithLlm(brief, resolvedStyle, style, format) {
+    const systemPrompt = this.i18n.t("prompt.system.imagePromptEngineer");
+    const briefJson = JSON.stringify({
+      title: brief.content.title,
+      summary: brief.content.summary,
+      problems: brief.content.problems,
+      solutions: brief.content.solutions,
+      purpose: brief.purpose,
+      style,
+      styleTokens: resolvedStyle.styleTokens
+    });
+    const messages = [
+      {
+        role: "system",
+        content: [{ type: "text", text: systemPrompt }]
+      },
+      {
+        role: "user",
+        content: [{ type: "text", text: briefJson }]
+      }
+    ];
+    const llm = this.llm;
+    if (!llm) {
+      throw new Error("LLM provider is required for buildWithLlm");
+    }
+    const response = await llm.chat(messages, {
+      model: this.model,
+      temperature: this.temperature
+    });
+    const text = response.message.content.filter((block) => block.type === "text").map((block) => ("text" in block) ? block.text : "").join("");
+    return {
+      text: text.trim(),
+      negativeText: resolvedStyle.negativeTokens.join(", "),
+      style,
+      dimensions: resolvedStyle.dimensions,
+      format
+    };
+  }
+  buildDeterministic(brief, resolvedStyle, style, format) {
+    const parts = [
+      brief.content.title,
+      this.i18n.t("image.generate.description", {
+        style,
+        purpose: brief.purpose
+      })
+    ];
+    if (brief.content.solutions.length > 0) {
+      parts.push(this.i18n.t("image.prompt.featuring", {
+        solutions: brief.content.solutions.slice(0, 3).join(", ")
+      }));
+    }
+    if (brief.content.audience?.industry) {
+      parts.push(this.i18n.t("image.prompt.industryContext", {
+        industry: brief.content.audience.industry
+      }));
+    }
+    parts.push(...resolvedStyle.styleTokens);
+    return {
+      text: parts.join(", "),
+      negativeText: resolvedStyle.negativeTokens.join(", "),
+      style,
+      dimensions: resolvedStyle.dimensions,
+      format
+    };
+  }
+}
+
+// src/types.ts
+import { IMAGE_PRESETS } from "@contractspec/lib.contracts-integrations/integrations/providers/image";
+// src/generators/style-resolver.ts
+var PURPOSE_DIMENSIONS = {
+  "blog-hero": IMAGE_PRESETS.blogHero,
+  "social-og": IMAGE_PRESETS.ogImage,
+  "social-twitter": IMAGE_PRESETS.twitterCard,
+  "social-instagram": IMAGE_PRESETS.instagramSquare,
+  "landing-hero": IMAGE_PRESETS.blogHero,
+  "video-thumbnail": IMAGE_PRESETS.thumbnail,
+  "email-header": IMAGE_PRESETS.emailHeader,
+  illustration: IMAGE_PRESETS.illustration,
+  icon: IMAGE_PRESETS.favicon
+};
+var STYLE_TOKENS = {
+  photorealistic: [
+    "professional photography",
+    "high resolution",
+    "natural lighting",
+    "detailed textures"
+  ],
+  illustration: [
+    "digital illustration",
+    "clean lines",
+    "vibrant colors",
+    "artistic composition"
+  ],
+  "3d-render": [
+    "3D render",
+    "volumetric lighting",
+    "glossy materials",
+    "depth of field"
+  ],
+  "flat-design": [
+    "clean flat vector",
+    "geometric shapes",
+    "solid colors",
+    "minimal shadows"
+  ],
+  abstract: [
+    "abstract composition",
+    "bold shapes",
+    "dynamic colors",
+    "artistic interpretation"
+  ],
+  minimalist: [
+    "minimalist design",
+    "clean whitespace",
+    "simple elements",
+    "restrained palette"
+  ],
+  branded: [
+    "brand-consistent design",
+    "professional layout",
+    "corporate aesthetic",
+    "clean composition"
+  ]
+};
+var BASE_NEGATIVE_TOKENS = [
+  "blurry",
+  "low quality",
+  "text overlay",
+  "watermark",
+  "distorted",
+  "pixelated"
+];
+
+class StyleResolver {
+  resolve(purpose, style, brand) {
+    const resolvedStyle = style ?? "photorealistic";
+    const dimensions = PURPOSE_DIMENSIONS[purpose];
+    const styleTokens = [...STYLE_TOKENS[resolvedStyle]];
+    const negativeTokens = [...BASE_NEGATIVE_TOKENS];
+    if (brand) {
+      if (brand.primary) {
+        styleTokens.push(`primary color ${brand.primary} palette`);
+      }
+      if (brand.accent) {
+        styleTokens.push(`accent color ${brand.accent}`);
+      }
+      if (brand.background) {
+        styleTokens.push(`background color ${brand.background}`);
+      }
+    }
+    return { styleTokens, negativeTokens, dimensions };
+  }
+}
+
+// src/generators/image-generator.ts
+var DEFAULT_CLOCK = {
+  now: () => Date.now(),
+  toISOString: () => new Date().toISOString()
+};
+
+class ImageGenerator {
+  promptBuilder;
+  styleResolver;
+  options;
+  i18n;
+  clock;
+  constructor(options) {
+    this.options = options ?? {};
+    this.i18n = createImageGenI18n(options?.locale);
+    this.clock = options?.clock ?? DEFAULT_CLOCK;
+    this.styleResolver = new StyleResolver;
+    this.promptBuilder = new PromptBuilder({
+      llm: options?.llm,
+      model: options?.model,
+      temperature: options?.temperature,
+      i18n: this.i18n
+    });
+  }
+  async generate(brief) {
+    const resolvedStyle = this.styleResolver.resolve(brief.purpose, brief.style ?? this.options.defaultStyle, brief.brandColors);
+    const prompt = await this.promptBuilder.build(brief, resolvedStyle);
+    if (brief.dimensions) {
+      prompt.dimensions = brief.dimensions;
+    }
+    const id = this.generateId(brief);
+    const project = {
+      id,
+      prompt,
+      metadata: {
+        purpose: brief.purpose,
+        title: brief.content.title,
+        createdAt: this.clock.toISOString(),
+        locale: brief.locale ?? this.options.locale ?? "en"
+      }
+    };
+    if (this.options.image) {
+      try {
+        const results = await this.options.image.generate({
+          prompt: prompt.text,
+          negativePrompt: prompt.negativeText,
+          dimensions: prompt.dimensions,
+          format: prompt.format,
+          style: this.mapStyleToProviderStyle(prompt.style),
+          numVariants: brief.variants,
+          seed: brief.seed
+        });
+        project.results = results;
+      } catch (error) {
+        const message = this.i18n.t("image.error.generationFailed");
+        throw new Error(message, error instanceof Error ? { cause: error } : undefined);
+      }
+    }
+    return project;
+  }
+  generateId(brief) {
+    const slug = brief.content.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40);
+    const ts = this.clock.now().toString(36);
+    return `img-${slug}-${ts}`;
+  }
+  mapStyleToProviderStyle(style) {
+    const providerStyles = [
+      "photorealistic",
+      "illustration",
+      "3d-render",
+      "flat-design",
+      "abstract"
+    ];
+    if (providerStyles.includes(style)) {
+      return style;
+    }
+    if (style === "minimalist" || style === "branded") {
+      return "flat-design";
+    }
+    return;
+  }
+}
+// src/presets/social.ts
+function ogImageBrief(content) {
+  return {
+    content,
+    purpose: "social-og",
+    dimensions: IMAGE_PRESETS.ogImage,
+    format: "png",
+    style: "photorealistic"
+  };
+}
+function twitterCardBrief(content) {
+  return {
+    content,
+    purpose: "social-twitter",
+    dimensions: IMAGE_PRESETS.twitterCard,
+    format: "png",
+    style: "photorealistic"
+  };
+}
+function instagramSquareBrief(content) {
+  return {
+    content,
+    purpose: "social-instagram",
+    dimensions: IMAGE_PRESETS.instagramSquare,
+    format: "jpg",
+    style: "photorealistic"
+  };
+}
+function instagramStoryBrief(content) {
+  return {
+    content,
+    purpose: "social-instagram",
+    dimensions: IMAGE_PRESETS.instagramStory,
+    format: "jpg",
+    style: "photorealistic"
+  };
+}
+
+// src/presets/marketing.ts
+function blogHeroBrief(content) {
+  return {
+    content,
+    purpose: "blog-hero",
+    dimensions: IMAGE_PRESETS.blogHero,
+    format: "webp",
+    style: "photorealistic"
+  };
+}
+function landingHeroBrief(content) {
+  return {
+    content,
+    purpose: "landing-hero",
+    dimensions: IMAGE_PRESETS.blogHero,
+    format: "webp",
+    style: "photorealistic"
+  };
+}
+function emailHeaderBrief(content) {
+  return {
+    content,
+    purpose: "email-header",
+    dimensions: IMAGE_PRESETS.emailHeader,
+    format: "png",
+    style: "flat-design"
+  };
+}
+
+// src/presets/video.ts
+function videoThumbnailBrief(content) {
+  return {
+    content,
+    purpose: "video-thumbnail",
+    dimensions: IMAGE_PRESETS.thumbnail,
+    format: "png",
+    style: "photorealistic"
+  };
+}
+function videoThumbnailWideBrief(content) {
+  return {
+    content,
+    purpose: "video-thumbnail",
+    dimensions: { width: 1280, height: 720 },
+    format: "png",
+    style: "photorealistic"
+  };
+}
+export {
+  videoThumbnailWideBrief,
+  videoThumbnailBrief,
+  twitterCardBrief,
+  ogImageBrief,
+  landingHeroBrief,
+  instagramStoryBrief,
+  instagramSquareBrief,
+  emailHeaderBrief,
+  blogHeroBrief,
+  StyleResolver,
+  PromptBuilder,
+  ImageGenerator,
+  IMAGE_PRESETS
+};