@contractspec/lib.image-gen 0.2.0

package/dist/browser/presets/index.js

@@ -0,0 +1,99 @@
+// src/types.ts
+import { IMAGE_PRESETS } from "@contractspec/lib.contracts-integrations/integrations/providers/image";
+// 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
+};

package/dist/browser/presets/marketing.js

@@ -0,0 +1,35 @@
+// src/types.ts
+import { IMAGE_PRESETS } from "@contractspec/lib.contracts-integrations/integrations/providers/image";
+// 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"
+  };
+}
+export {
+  landingHeroBrief,
+  emailHeaderBrief,
+  blogHeroBrief
+};

package/dist/browser/presets/social.js

@@ -0,0 +1,45 @@
+// src/types.ts
+import { IMAGE_PRESETS } from "@contractspec/lib.contracts-integrations/integrations/providers/image";
+// 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"
+  };
+}
+export {
+  twitterCardBrief,
+  ogImageBrief,
+  instagramStoryBrief,
+  instagramSquareBrief
+};

package/dist/browser/presets/video.js

@@ -0,0 +1,25 @@
+// src/types.ts
+import { IMAGE_PRESETS } from "@contractspec/lib.contracts-integrations/integrations/providers/image";
+// 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
+};

package/dist/browser/types.js

@@ -0,0 +1,5 @@
+// src/types.ts
+import { IMAGE_PRESETS } from "@contractspec/lib.contracts-integrations/integrations/providers/image";
+export {
+  IMAGE_PRESETS
+};

package/dist/docs/generators.docblock.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/docs/generators.docblock.js

@@ -0,0 +1,37 @@
+// @bun
+// src/docs/generators.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
+var generatorDocBlocks = [
+  {
+    id: "docs.image-gen.generators",
+    title: "Image Generators",
+    summary: "Core generator classes: ImageGenerator, PromptBuilder, and StyleResolver.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/image-gen/generators",
+    tags: ["image", "generator", "prompt", "style"],
+    owners: ["@contractspec/lib.image-gen"],
+    body: `# Image Generators
+
+## ImageGenerator
+
+The main orchestrator. Accepts an \`ImageBrief\` and produces an \`ImageProject\`.
+
+1. **StyleResolver.resolve()** \u2014 resolves dimensions, style tokens, negative tokens
+2. **PromptBuilder.build()** \u2014 constructs the image prompt (deterministic or LLM)
+3. **ImageProvider.generate()** \u2014 calls the image generation provider (optional)
+
+## PromptBuilder
+
+Supports two modes:
+- **Deterministic**: Assembles a prompt from brief fields and style tokens
+- **LLM-enhanced**: Sends a system prompt + brief JSON to the LLM, falls back to deterministic
+
+## StyleResolver
+
+Maps \`ImagePurpose\` to default dimensions from \`IMAGE_PRESETS\`, and \`ImageStyle\` to
+prompt tokens (e.g. "professional photography", "clean flat vector").
+`
+  }
+];
+registerDocBlocks(generatorDocBlocks);

package/dist/docs/image-gen.docblock.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/docs/image-gen.docblock.js

@@ -0,0 +1,48 @@
+// @bun
+// src/docs/image-gen.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
+var imageGenDocBlocks = [
+  {
+    id: "docs.image-gen.overview",
+    title: "Image Generation Library",
+    summary: "AI-powered image generation for hero, social, thumbnail, OG, and illustration assets.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/image-gen/overview",
+    tags: ["image", "generation", "ai", "content"],
+    owners: ["@contractspec/lib.image-gen"],
+    body: `# Image Generation Library
+
+\`@contractspec/lib.image-gen\` provides deterministic and LLM-enhanced image prompt generation
+for content pipelines. It supports multiple purposes (blog hero, social OG, thumbnail, etc.)
+and styles (photorealistic, illustration, flat-design, etc.).
+
+## Key Features
+
+- **Deterministic mode**: Generates structured prompts without an LLM
+- **LLM-enhanced mode**: Uses an LLM to craft optimized image prompts
+- **Style resolution**: Maps purposes to dimensions and style tokens
+- **Preset briefs**: Ready-made brief constructors for common use cases
+- **i18n support**: Localized strings for EN, FR, ES
+
+## Quick Start
+
+\`\`\`typescript
+import { ImageGenerator } from '@contractspec/lib.image-gen/generators';
+import { blogHeroBrief } from '@contractspec/lib.image-gen/presets';
+
+const generator = new ImageGenerator();
+const brief = blogHeroBrief(contentBrief);
+const project = await generator.generate(brief);
+\`\`\`
+
+## Architecture
+
+- **ImageGenerator** \u2014 orchestrates style resolution, prompt building, and provider calls
+- **StyleResolver** \u2014 maps purpose + style to dimensions, tokens, and negative tokens
+- **PromptBuilder** \u2014 constructs deterministic or LLM-enhanced image prompts
+- **Presets** \u2014 convenience functions for social, marketing, and video thumbnails
+`
+  }
+];
+registerDocBlocks(imageGenDocBlocks);

package/dist/generators/image-generator.d.ts

@@ -0,0 +1,12 @@
+import type { ImageBrief, ImageGeneratorOptions, ImageProject } from '../types';
+export declare class ImageGenerator {
+    private readonly promptBuilder;
+    private readonly styleResolver;
+    private readonly options;
+    private readonly i18n;
+    private readonly clock;
+    constructor(options?: ImageGeneratorOptions);
+    generate(brief: ImageBrief): Promise<ImageProject>;
+    private generateId;
+    private mapStyleToProviderStyle;
+}