@contractspec/lib.image-gen 0.2.0

package/dist/node/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/node/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/node/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/node/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/node/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/presets/index.d.ts

@@ -0,0 +1,3 @@
+export { ogImageBrief, twitterCardBrief, instagramSquareBrief, instagramStoryBrief, } from './social';
+export { blogHeroBrief, landingHeroBrief, emailHeaderBrief } from './marketing';
+export { videoThumbnailBrief, videoThumbnailWideBrief } from './video';

package/dist/presets/index.js

@@ -0,0 +1,100 @@
+// @bun
+// 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/presets/marketing.d.ts

@@ -0,0 +1,8 @@
+import type { ImageBrief } from '../types';
+import type { ContentBrief } from '@contractspec/lib.content-gen/types';
+/** Create a blog hero image brief from content. */
+export declare function blogHeroBrief(content: ContentBrief): ImageBrief;
+/** Create a landing page hero image brief from content. */
+export declare function landingHeroBrief(content: ContentBrief): ImageBrief;
+/** Create an email header image brief from content. */
+export declare function emailHeaderBrief(content: ContentBrief): ImageBrief;

package/dist/presets/marketing.js

@@ -0,0 +1,36 @@
+// @bun
+// 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/presets/presets.test.d.ts

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

package/dist/presets/social.d.ts

@@ -0,0 +1,10 @@
+import type { ImageBrief } from '../types';
+import type { ContentBrief } from '@contractspec/lib.content-gen/types';
+/** Create an OG image brief from content. */
+export declare function ogImageBrief(content: ContentBrief): ImageBrief;
+/** Create a Twitter card image brief from content. */
+export declare function twitterCardBrief(content: ContentBrief): ImageBrief;
+/** Create an Instagram square image brief from content. */
+export declare function instagramSquareBrief(content: ContentBrief): ImageBrief;
+/** Create an Instagram story image brief from content. */
+export declare function instagramStoryBrief(content: ContentBrief): ImageBrief;

package/dist/presets/social.js

@@ -0,0 +1,46 @@
+// @bun
+// 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/presets/video.d.ts

@@ -0,0 +1,6 @@
+import type { ImageBrief } from '../types';
+import type { ContentBrief } from '@contractspec/lib.content-gen/types';
+/** Create a video thumbnail image brief from content. */
+export declare function videoThumbnailBrief(content: ContentBrief): ImageBrief;
+/** Create a 16:9 video thumbnail brief from content. */
+export declare function videoThumbnailWideBrief(content: ContentBrief): ImageBrief;

package/dist/presets/video.js

@@ -0,0 +1,26 @@
+// @bun
+// 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/types.d.ts

@@ -0,0 +1,56 @@
+import type { LLMProvider } from '@contractspec/lib.contracts-integrations/integrations/providers/llm';
+import type { ImageProvider, ImageDimensions, ImageFormat, ImageGenerationResult } from '@contractspec/lib.contracts-integrations/integrations/providers/image';
+import { IMAGE_PRESETS } from '@contractspec/lib.contracts-integrations/integrations/providers/image';
+import type { ContentBrief } from '@contractspec/lib.content-gen/types';
+export type { ImageProvider, ImageDimensions, ImageFormat, ImageGenerationResult, };
+export { IMAGE_PRESETS };
+export interface ImageBrief {
+    content: ContentBrief;
+    purpose: ImagePurpose;
+    dimensions?: ImageDimensions;
+    format?: ImageFormat;
+    style?: ImageStyle;
+    brandColors?: BrandColorOverrides;
+    variants?: number;
+    locale?: string;
+    seed?: number;
+}
+export type ImagePurpose = 'blog-hero' | 'social-og' | 'social-twitter' | 'social-instagram' | 'landing-hero' | 'video-thumbnail' | 'email-header' | 'illustration' | 'icon';
+export type ImageStyle = 'photorealistic' | 'illustration' | '3d-render' | 'flat-design' | 'abstract' | 'minimalist' | 'branded';
+export interface BrandColorOverrides {
+    primary?: string;
+    accent?: string;
+    background?: string;
+}
+export interface ImageGeneratorOptions {
+    llm?: LLMProvider;
+    image?: ImageProvider;
+    model?: string;
+    temperature?: number;
+    locale?: string;
+    defaultStyle?: ImageStyle;
+    /** Injectable clock for deterministic testing. Defaults to `Date`. */
+    clock?: {
+        now(): number;
+        toISOString(): string;
+    };
+}
+export interface ImageProject {
+    id: string;
+    prompt: ImagePrompt;
+    results?: ImageGenerationResult;
+    metadata: ImageProjectMetadata;
+}
+export interface ImagePrompt {
+    text: string;
+    negativeText?: string;
+    style: ImageStyle;
+    dimensions: ImageDimensions;
+    format: ImageFormat;
+}
+export interface ImageProjectMetadata {
+    purpose: ImagePurpose;
+    title: string;
+    createdAt: string;
+    locale: string;
+}

package/dist/types.js

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