@contractspec/lib.image-gen 0.2.0

package/dist/i18n/index.js

@@ -0,0 +1,310 @@
+// @bun
+// 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 \xEAtes un expert en ing\xE9nierie de prompts d'images. \xC0 partir d'un brief JSON contenant titre, r\xE9sum\xE9, probl\xE8mes, solutions, objectif, style et tokens de style, produisez un prompt d\xE9taill\xE9 de g\xE9n\xE9ration d'image. Le prompt doit \xEAtre vivant, sp\xE9cifique et optimis\xE9 pour les mod\xE8les de g\xE9n\xE9ration d'images IA. Concentrez-vous sur la composition, l'\xE9clairage, la palette de couleurs et le sujet. Produisez uniquement le texte du prompt, pas de JSON.",
+      description: "Prompt syst\xE8me pour l'ing\xE9nierie de prompts d'images par LLM"
+    },
+    "image.generate.description": {
+      value: "G\xE9n\xE9rer une image {style} pour {purpose}",
+      description: "Mod\xE8le de description pour les t\xE2ches de g\xE9n\xE9ration 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\xE9",
+      description: "Message d'erreur quand aucun ImageProvider n'est disponible"
+    },
+    "image.error.generationFailed": {
+      value: "La g\xE9n\xE9ration d'image a \xE9chou\xE9",
+      description: "Message d'erreur quand la g\xE9n\xE9ration d'image \xE9choue"
+    },
+    "purpose.blogHero": {
+      value: "Image hero de blog",
+      description: "Libell\xE9 pour l'objectif image hero de blog"
+    },
+    "purpose.socialOg": {
+      value: "Image OG pour r\xE9seaux sociaux",
+      description: "Libell\xE9 pour l'objectif image Open Graph"
+    },
+    "purpose.socialTwitter": {
+      value: "Image carte Twitter",
+      description: "Libell\xE9 pour l'objectif image carte Twitter"
+    },
+    "purpose.socialInstagram": {
+      value: "Image Instagram",
+      description: "Libell\xE9 pour l'objectif image Instagram"
+    },
+    "purpose.landingHero": {
+      value: "Hero de page d'atterrissage",
+      description: "Libell\xE9 pour l'objectif image hero de page d'atterrissage"
+    },
+    "purpose.videoThumbnail": {
+      value: "Miniature vid\xE9o",
+      description: "Libell\xE9 pour l'objectif miniature vid\xE9o"
+    },
+    "purpose.emailHeader": {
+      value: "En-t\xEAte d'email",
+      description: "Libell\xE9 pour l'objectif image en-t\xEAte d'email"
+    },
+    "purpose.illustration": {
+      value: "Illustration",
+      description: "Libell\xE9 pour l'objectif illustration"
+    },
+    "purpose.icon": {
+      value: "Ic\xF4ne",
+      description: "Libell\xE9 pour l'objectif ic\xF4ne"
+    }
+  }
+});
+
+// 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\xEDa de prompts de im\xE1genes. Dado un brief JSON que contiene t\xEDtulo, resumen, problemas, soluciones, prop\xF3sito, estilo y tokens de estilo, produce un prompt detallado de generaci\xF3n de im\xE1genes. El prompt debe ser v\xEDvido, espec\xEDfico y optimizado para modelos de generaci\xF3n de im\xE1genes con IA. Conc\xE9ntrate en la composici\xF3n, iluminaci\xF3n, paleta de colores y tema. Produce solo el texto del prompt, sin JSON.",
+      description: "Prompt del sistema para ingenier\xEDa de prompts de im\xE1genes por LLM"
+    },
+    "image.generate.description": {
+      value: "Generar una imagen {style} para {purpose}",
+      description: "Plantilla de descripci\xF3n para tareas de generaci\xF3n de im\xE1genes",
+      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\xE1genes configurado",
+      description: "Mensaje de error cuando no hay ImageProvider disponible"
+    },
+    "image.error.generationFailed": {
+      value: "La generaci\xF3n de imagen fall\xF3",
+      description: "Mensaje de error cuando la generaci\xF3n de imagen falla"
+    },
+    "purpose.blogHero": {
+      value: "Imagen hero de blog",
+      description: "Etiqueta para el prop\xF3sito imagen hero de blog"
+    },
+    "purpose.socialOg": {
+      value: "Imagen OG para redes sociales",
+      description: "Etiqueta para el prop\xF3sito imagen Open Graph"
+    },
+    "purpose.socialTwitter": {
+      value: "Imagen de tarjeta Twitter",
+      description: "Etiqueta para el prop\xF3sito imagen tarjeta Twitter"
+    },
+    "purpose.socialInstagram": {
+      value: "Imagen de Instagram",
+      description: "Etiqueta para el prop\xF3sito imagen Instagram"
+    },
+    "purpose.landingHero": {
+      value: "Hero de p\xE1gina de aterrizaje",
+      description: "Etiqueta para el prop\xF3sito imagen hero de p\xE1gina de aterrizaje"
+    },
+    "purpose.videoThumbnail": {
+      value: "Miniatura de video",
+      description: "Etiqueta para el prop\xF3sito miniatura de video"
+    },
+    "purpose.emailHeader": {
+      value: "Encabezado de email",
+      description: "Etiqueta para el prop\xF3sito imagen encabezado de email"
+    },
+    "purpose.illustration": {
+      value: "Ilustraci\xF3n",
+      description: "Etiqueta para el prop\xF3sito ilustraci\xF3n"
+    },
+    "purpose.icon": {
+      value: "Icono",
+      description: "Etiqueta para el prop\xF3sito 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/i18n/keys.ts
+var PROMPT_KEYS = {
+  "prompt.system.imagePromptEngineer": "prompt.system.imagePromptEngineer"
+};
+var IMAGE_KEYS = {
+  "image.generate.description": "image.generate.description",
+  "image.prompt.featuring": "image.prompt.featuring",
+  "image.prompt.industryContext": "image.prompt.industryContext",
+  "image.error.noProvider": "image.error.noProvider",
+  "image.error.generationFailed": "image.error.generationFailed"
+};
+var PURPOSE_KEYS = {
+  "purpose.blogHero": "purpose.blogHero",
+  "purpose.socialOg": "purpose.socialOg",
+  "purpose.socialTwitter": "purpose.socialTwitter",
+  "purpose.socialInstagram": "purpose.socialInstagram",
+  "purpose.landingHero": "purpose.landingHero",
+  "purpose.videoThumbnail": "purpose.videoThumbnail",
+  "purpose.emailHeader": "purpose.emailHeader",
+  "purpose.illustration": "purpose.illustration",
+  "purpose.icon": "purpose.icon"
+};
+var I18N_KEYS = {
+  ...PROMPT_KEYS,
+  ...IMAGE_KEYS,
+  ...PURPOSE_KEYS
+};
+
+// src/i18n/locale.ts
+import {
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  resolveLocale,
+  isSupportedLocale
+} from "@contractspec/lib.contracts-spec/translations";
+export {
+  resolveLocale,
+  resetI18nRegistry,
+  isSupportedLocale,
+  getDefaultI18n,
+  createImageGenI18n,
+  SUPPORTED_LOCALES,
+  PURPOSE_KEYS,
+  PROMPT_KEYS,
+  IMAGE_KEYS,
+  I18N_KEYS,
+  DEFAULT_LOCALE
+};

package/dist/i18n/keys.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Typed message keys for the image-gen i18n system.
+ *
+ * All translatable strings in the package are referenced by these keys.
+ * Organized by domain: prompt, image, purpose.
+ *
+ * @module i18n/keys
+ */
+export declare const PROMPT_KEYS: {
+    /** Image prompt engineer system prompt */
+    readonly 'prompt.system.imagePromptEngineer': "prompt.system.imagePromptEngineer";
+};
+export declare const IMAGE_KEYS: {
+    /** "Generate a {style} image for {purpose}" */
+    readonly 'image.generate.description': "image.generate.description";
+    /** "Featuring {solutions}" */
+    readonly 'image.prompt.featuring': "image.prompt.featuring";
+    /** "{industry} context" */
+    readonly 'image.prompt.industryContext': "image.prompt.industryContext";
+    /** "No image provider configured" */
+    readonly 'image.error.noProvider': "image.error.noProvider";
+    /** "Image generation failed" */
+    readonly 'image.error.generationFailed': "image.error.generationFailed";
+};
+export declare const PURPOSE_KEYS: {
+    /** "Blog hero image" */
+    readonly 'purpose.blogHero': "purpose.blogHero";
+    /** "Social media OG image" */
+    readonly 'purpose.socialOg': "purpose.socialOg";
+    /** "Twitter card image" */
+    readonly 'purpose.socialTwitter': "purpose.socialTwitter";
+    /** "Instagram image" */
+    readonly 'purpose.socialInstagram': "purpose.socialInstagram";
+    /** "Landing page hero" */
+    readonly 'purpose.landingHero': "purpose.landingHero";
+    /** "Video thumbnail" */
+    readonly 'purpose.videoThumbnail': "purpose.videoThumbnail";
+    /** "Email header" */
+    readonly 'purpose.emailHeader': "purpose.emailHeader";
+    /** "Illustration" */
+    readonly 'purpose.illustration': "purpose.illustration";
+    /** "Icon" */
+    readonly 'purpose.icon': "purpose.icon";
+};
+export declare const I18N_KEYS: {
+    /** "Blog hero image" */
+    readonly 'purpose.blogHero': "purpose.blogHero";
+    /** "Social media OG image" */
+    readonly 'purpose.socialOg': "purpose.socialOg";
+    /** "Twitter card image" */
+    readonly 'purpose.socialTwitter': "purpose.socialTwitter";
+    /** "Instagram image" */
+    readonly 'purpose.socialInstagram': "purpose.socialInstagram";
+    /** "Landing page hero" */
+    readonly 'purpose.landingHero': "purpose.landingHero";
+    /** "Video thumbnail" */
+    readonly 'purpose.videoThumbnail': "purpose.videoThumbnail";
+    /** "Email header" */
+    readonly 'purpose.emailHeader': "purpose.emailHeader";
+    /** "Illustration" */
+    readonly 'purpose.illustration': "purpose.illustration";
+    /** "Icon" */
+    readonly 'purpose.icon': "purpose.icon";
+    /** "Generate a {style} image for {purpose}" */
+    readonly 'image.generate.description': "image.generate.description";
+    /** "Featuring {solutions}" */
+    readonly 'image.prompt.featuring': "image.prompt.featuring";
+    /** "{industry} context" */
+    readonly 'image.prompt.industryContext': "image.prompt.industryContext";
+    /** "No image provider configured" */
+    readonly 'image.error.noProvider': "image.error.noProvider";
+    /** "Image generation failed" */
+    readonly 'image.error.generationFailed': "image.error.generationFailed";
+    /** Image prompt engineer system prompt */
+    readonly 'prompt.system.imagePromptEngineer': "prompt.system.imagePromptEngineer";
+};
+/** Union type of all valid image-gen i18n keys */
+export type ImageGenMessageKey = keyof typeof I18N_KEYS;

package/dist/i18n/keys.js

@@ -0,0 +1,34 @@
+// @bun
+// src/i18n/keys.ts
+var PROMPT_KEYS = {
+  "prompt.system.imagePromptEngineer": "prompt.system.imagePromptEngineer"
+};
+var IMAGE_KEYS = {
+  "image.generate.description": "image.generate.description",
+  "image.prompt.featuring": "image.prompt.featuring",
+  "image.prompt.industryContext": "image.prompt.industryContext",
+  "image.error.noProvider": "image.error.noProvider",
+  "image.error.generationFailed": "image.error.generationFailed"
+};
+var PURPOSE_KEYS = {
+  "purpose.blogHero": "purpose.blogHero",
+  "purpose.socialOg": "purpose.socialOg",
+  "purpose.socialTwitter": "purpose.socialTwitter",
+  "purpose.socialInstagram": "purpose.socialInstagram",
+  "purpose.landingHero": "purpose.landingHero",
+  "purpose.videoThumbnail": "purpose.videoThumbnail",
+  "purpose.emailHeader": "purpose.emailHeader",
+  "purpose.illustration": "purpose.illustration",
+  "purpose.icon": "purpose.icon"
+};
+var I18N_KEYS = {
+  ...PROMPT_KEYS,
+  ...IMAGE_KEYS,
+  ...PURPOSE_KEYS
+};
+export {
+  PURPOSE_KEYS,
+  PROMPT_KEYS,
+  IMAGE_KEYS,
+  I18N_KEYS
+};

package/dist/i18n/locale.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Locale utilities for the image-gen package.
+ *
+ * Re-exported from the shared i18n factory in contracts-spec.
+ *
+ * @module i18n/locale
+ */
+export { DEFAULT_LOCALE, SUPPORTED_LOCALES, resolveLocale, isSupportedLocale, type SupportedLocale, } from '@contractspec/lib.contracts-spec/translations';

package/dist/i18n/locale.js

@@ -0,0 +1,14 @@
+// @bun
+// src/i18n/locale.ts
+import {
+  DEFAULT_LOCALE,
+  SUPPORTED_LOCALES,
+  resolveLocale,
+  isSupportedLocale
+} from "@contractspec/lib.contracts-spec/translations";
+export {
+  resolveLocale,
+  isSupportedLocale,
+  SUPPORTED_LOCALES,
+  DEFAULT_LOCALE
+};

package/dist/i18n/messages.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Translation helper for the image-gen package.
+ * @module i18n/messages
+ */
+import { type I18nInstance } from '@contractspec/lib.contracts-spec/translations';
+import type { ImageGenMessageKey } from './keys';
+/** I18n instance type for the image-gen package. */
+export type ImageGenI18n = I18nInstance<ImageGenMessageKey>;
+/** Create an i18n instance for a given locale. */
+export declare const createImageGenI18n: (optionsLocale?: string, runtimeLocale?: string) => I18nInstance<"prompt.system.imagePromptEngineer" | "image.generate.description" | "image.prompt.featuring" | "image.prompt.industryContext" | "image.error.noProvider" | "image.error.generationFailed" | "purpose.blogHero" | "purpose.socialOg" | "purpose.socialTwitter" | "purpose.socialInstagram" | "purpose.landingHero" | "purpose.videoThumbnail" | "purpose.emailHeader" | "purpose.illustration" | "purpose.icon">;
+/** Create a default (English) i18n instance. */
+export declare const getDefaultI18n: () => I18nInstance<"prompt.system.imagePromptEngineer" | "image.generate.description" | "image.prompt.featuring" | "image.prompt.industryContext" | "image.error.noProvider" | "image.error.generationFailed" | "purpose.blogHero" | "purpose.socialOg" | "purpose.socialTwitter" | "purpose.socialInstagram" | "purpose.landingHero" | "purpose.videoThumbnail" | "purpose.emailHeader" | "purpose.illustration" | "purpose.icon">;
+/** Reset the shared registry (useful for testing). @internal */
+export declare const resetI18nRegistry: () => void;