@orangecatai/adgen-canvas 0.0.21 → 0.0.22

package/dist/prod/subset-shared.chunk.js

@@ -1 +1 @@
-import{a,b,c,d}from"./chunk-Z5NKEFVG.js";import"./chunk-OWNL6YOR.js";import"./chunk-SRAX5OIU.js";export{a as Commands,b as subsetToBase64,c as subsetToBinary,d as toBase64};
+import{a,b,c,d}from"./chunk-Z5NKEFVG.js";import"./chunk-PJYEU4Z2.js";import"./chunk-SRAX5OIU.js";export{a as Commands,b as subsetToBase64,c as subsetToBinary,d as toBase64};

package/dist/prod/subset-worker.chunk.js

@@ -1 +1 @@
-import{a as r,c as t}from"./chunk-Z5NKEFVG.js";import"./chunk-OWNL6YOR.js";import"./chunk-SRAX5OIU.js";var s=import.meta.url?new URL(import.meta.url):void 0;typeof window>"u"&&typeof self<"u"&&(self.onmessage=async e=>{switch(e.data.command){case r.Subset:let a=await t(e.data.arrayBuffer,e.data.codePoints);self.postMessage(a,{transfer:[a]});break}});export{s as WorkerUrl};
+import{a as r,c as t}from"./chunk-Z5NKEFVG.js";import"./chunk-PJYEU4Z2.js";import"./chunk-SRAX5OIU.js";var s=import.meta.url?new URL(import.meta.url):void 0;typeof window>"u"&&typeof self<"u"&&(self.onmessage=async e=>{switch(e.data.command){case r.Subset:let a=await t(e.data.arrayBuffer,e.data.codePoints);self.postMessage(a,{transfer:[a]});break}});export{s as WorkerUrl};

package/dist/types/excalidraw/components/ImageGeneratorPanel.d.ts

@@ -12,14 +12,14 @@ export declare const MODEL_CONFIG: {
     readonly "nano banana 2": {
         readonly modelId: "google/gemini-3.1-flash-image-preview";
         readonly textOutput: true;
-        readonly supportsImageSize: true;
+        readonly supportsImageSize: false;
         readonly supportedResolutions: readonly ["0.5K", "1K", "2K", "4K"];
         readonly supportedRatios: readonly ["21:9", "16:9", "4:3", "3:2", "1:1", "9:16", "3:4", "2:3", "5:4", "4:5", "4:1", "1:4", "8:1", "1:8"];
     };
     readonly "nano banana pro": {
         readonly modelId: "google/gemini-3-pro-image-preview";
         readonly textOutput: true;
-        readonly supportsImageSize: true;
+        readonly supportsImageSize: false;
         readonly supportedResolutions: readonly ["1K", "2K", "4K"];
         readonly supportedRatios: readonly ["21:9", "16:9", "4:3", "3:2", "1:1", "9:16", "3:4", "2:3", "5:4", "4:5"];
     };
@@ -37,6 +37,20 @@ export declare const MODEL_CONFIG: {
         readonly supportedResolutions: readonly ["1K", "2K"];
         readonly supportedRatios: readonly ["16:9", "4:3", "3:2", "1:1", "9:16", "3:4", "2:3", "5:4", "4:5"];
     };
+    readonly "riverflow 2.5 fast": {
+        readonly modelId: "sourceful/riverflow-v2.5-fast";
+        readonly textOutput: false;
+        readonly supportsImageSize: true;
+        readonly supportedResolutions: readonly ["1K", "2K"];
+        readonly supportedRatios: readonly ["1:1", "21:9", "16:9", "3:2", "4:3", "5:4", "4:5", "3:4", "2:3", "9:16"];
+    };
+    readonly "riverflow 2.5 pro": {
+        readonly modelId: "sourceful/riverflow-v2.5-pro";
+        readonly textOutput: false;
+        readonly supportsImageSize: true;
+        readonly supportedResolutions: readonly ["1K", "2K", "4K"];
+        readonly supportedRatios: readonly ["1:1", "21:9", "16:9", "3:2", "4:3", "5:4", "4:5", "3:4", "2:3", "9:16"];
+    };
 };
 export type ModelName = keyof typeof MODEL_CONFIG;
 export declare const MODEL_NAMES: ModelName[];

package/dist/types/excalidraw/components/ai-chat/AdGenShimmerLayer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Renders a shimmer overlay on top of frames that are currently being
+ * generated by the AI chat agent (create_frame → generate_image → review).
+ *
+ * Rendered unconditionally from App.tsx alongside AutoResizeShimmerLayer.
+ * Uses useExcalidrawAppState() so it repositions correctly on scroll/zoom.
+ * Reads current frame position from scene elements so it follows the frame
+ * if the user drags it during generation.
+ */
+export declare const AdGenShimmerLayer: () => import("react/jsx-runtime").JSX.Element | null;

package/dist/types/excalidraw/components/ai-chat/adGenShimmerStore.d.ts

@@ -0,0 +1,12 @@
+export type AdGenFrameInfo = {
+    frameId: string;
+};
+type Listener = () => void;
+export declare const adGenShimmerStore: {
+    startGenerating(frameId: string): void;
+    stopGenerating(frameId: string): void;
+    clear(): void;
+    getLoadingFrames(): AdGenFrameInfo[];
+    subscribe(fn: Listener): () => void;
+};
+export {};

package/dist/types/excalidraw/components/ai-chat/agentLoop.d.ts

@@ -60,10 +60,6 @@ export type AgentResult = {
     reply: string;
     toolActions: ToolAction[];
 };
-/**
- * Converts a BrandContext object to a concise system message string.
- */
-export declare function buildBrandContextMessage(ctx: BrandContext): string;
 export type FileAttachment = {
     name: string;
     type: "image" | "text" | "pdf" | "docx";

package/dist/types/excalidraw/components/ai-chat/canvasTools.d.ts

@@ -297,7 +297,7 @@ export declare const BANNER_TOOLS: readonly [{
     readonly type: "function";
     readonly function: {
         readonly name: "generate_image";
-        readonly description: "Generate an image using AI (Gemini) and place it onto the canvas. Always call this for any photo or image content — even when the user has attached a reference image. The attached image is passed to Gemini as visual reference; Gemini generates the final output. Use referenceImageIndex to tell Gemini which user attachment to reference. IMPORTANT: your prompt must describe a purely visual scene — NO text, NO typography, NO words, NO captions, NO watermarks. All copy is handled by the HTML layer. A 'no text' safety suffix will be auto-appended, but you must also describe composition clearly (e.g. which side should be left open/empty for the HTML text).";
+        readonly description: "Generate the COMPLETE advertisement as a single AI image and place it into the frame. The image must contain BOTH the visuals AND all copy (headline, subheadline, CTA button, sign-off/brand name) rendered as legible text inside the image — this is the entire ad, not a text-free background. Fill the whole frame (x:0, y:0, width:frameW, height:frameH). Use referenceImageIndex when the user attached an image to use as a subject/style reference. Your prompt must spell on-image text exactly and specify brand colors, typographic style, composition, and dimensions. Do NOT call generate_html_banner afterwards — there is no separate text layer.";
         readonly parameters: {
             readonly type: "object";
             readonly properties: {
@@ -307,7 +307,7 @@ export declare const BANNER_TOOLS: readonly [{
                 };
                 readonly prompt: {
                     readonly type: "string";
-                    readonly description: "Detailed generation prompt. When using a reference image, describe what you want Gemini to produce — e.g. 'use this building as the subject, wide cinematic crop with open sky on the left for text overlay'.";
+                    readonly description: "Detailed prompt for the COMPLETE ad: the visual scene PLUS the exact on-image copy (quote headline/subheadline/CTA/sign-off verbatim), brand colors per element, typographic style described in words, composition/layout, and the target dimensions/aspect.";
                 };
                 readonly x: {
                     readonly type: "number";
@@ -334,27 +334,6 @@ export declare const BANNER_TOOLS: readonly [{
             readonly additionalProperties: false;
         };
     };
-}, {
-    readonly type: "function";
-    readonly function: {
-        readonly name: "generate_html_banner";
-        readonly description: "Place HTML/CSS text and shape elements into an EXISTING frame on the canvas. Always call create_frame first to get a frameId, then generate_image, then call this with that frameId. frameId is required — this tool does NOT create frames.";
-        readonly parameters: {
-            readonly type: "object";
-            readonly properties: {
-                readonly html: {
-                    readonly type: "string";
-                    readonly description: "Complete self-contained HTML with inline <style>. All layer elements must use position:absolute with explicit left/top/width/height in px. Root div must have class='canvas'.";
-                };
-                readonly frameId: {
-                    readonly type: "string";
-                    readonly description: "Required. The ID of the frame created by create_frame. Adds HTML elements into this existing frame, preserving existing children like images.";
-                };
-            };
-            readonly required: readonly ["html", "frameId"];
-            readonly additionalProperties: false;
-        };
-    };
 }, {
     readonly type: "function";
     readonly function: {
@@ -589,23 +568,6 @@ export declare const BANNER_TOOLS: readonly [{
             readonly additionalProperties: false;
         };
     };
-}, {
-    readonly type: "function";
-    readonly function: {
-        readonly name: "finalize_ad";
-        readonly description: "Call this when ALL elements are placed on the canvas — brand assets, generated images, and the HTML text overlay. Captures a screenshot of the complete frame for review. Do NOT call this before all assets are in place.";
-        readonly parameters: {
-            readonly type: "object";
-            readonly properties: {
-                readonly frameId: {
-                    readonly type: "string";
-                    readonly description: "ID of the frame to capture for review";
-                };
-            };
-            readonly required: readonly ["frameId"];
-            readonly additionalProperties: false;
-        };
-    };
 }];
 export declare function serializeElements(elements: readonly ExcalidrawElement[]): Record<string, unknown>[];
 export type FrameInfo = {
@@ -641,6 +603,19 @@ export type ToolExecutionContext = {
     brandHeadlineFontName?: string;
     /** Brand body font file name. Sourced from brand DNA. */
     brandBodyFontName?: string;
+    /** Data URL of the master brand logo — passed as a visual reference image to the image generation model. */
+    brandLogoDataUrl?: string;
+    /** Data URL of text rendered in the brand headline font — passed as a visual reference to the image generation model. */
+    brandFontPreviewDataUrl?: string;
+    /** Data URL of text rendered in the brand body font — passed as a second visual reference to the image generation model. */
+    brandBodyFontPreviewDataUrl?: string;
+    /**
+     * Fetchable URL of the actual headline font file (.ttf/.otf), e.g. a presigned
+     * S3 URL. Only consumed by image models that accept a font file as input
+     * (Sourceful Riverflow v2+ -> OpenRouter `image_config.font_inputs`). Other
+     * models ignore it.
+     */
+    brandFontUrl?: string;
     /**
      * Excalidraw fontFamilyId for the brand headline font.
      * When set, ALL text elements (add_text, fill_template_slots headline slots)

package/dist/types/excalidraw/components/ai-chat/reviewerAgent.d.ts

@@ -1,19 +1,28 @@
 /**
  * reviewerAgent.ts
  *
- * Stateless reviewer module. After generate_html_banner succeeds, this
- * agent receives a partial, focused context (rendered screenshot, HTML
- * source, frame dimensions, brand guidelines, original user brief) and
- * returns precise layout/readability critique — NOT the full agent
- * conversation history.
+ * Brand Governance Agent — stateless reviewer that runs after the main agent
+ * generates a complete ad image (visuals + all copy baked in) and calls
+ * finalize_ad. It receives a focused context (the rendered screenshot, frame
+ * dimensions, brand guidelines, original user brief) and returns a precise
+ * critique covering creative quality AND brand-governance compliance:
+ * copy correctness, brand tone, logo usage, claim accuracy, legal mandatories,
+ * offer disclaimers, regulatory sensitivity, prohibited language, competitive
+ * claims, and data/privacy concerns.
  *
- * The reviewer is a separate LLM call from the main agent loop so it
- * brings an independent eye to the generated banner.
+ * The reviewer is a separate LLM call from the main agent loop so it brings an
+ * independent eye to the generated ad. Because the ad is a single image, every
+ * fix is applied by regenerating the image with a revised prompt — there is no
+ * HTML/CSS layer to patch.
+ *
+ * @deprecated note (2026-06-17): this reviewer previously audited an HTML text
+ * layer composited over a text-free image and emitted CSS-only fixes. That
+ * flow is gone — see the image-first agent loop in agentLoop.ts.
  */
 import type { BrandContext } from "../../types";
 export type ReviewIssue = {
-    /** Which design element is affected */
-    element: "headline" | "subheadline" | "cta" | "image" | "layout" | "brand";
+    /** Which design element or governance dimension is affected */
+    element: "headline" | "subheadline" | "cta" | "image" | "layout" | "brand" | "brand_tone" | "logo" | "claim" | "legal" | "disclaimer" | "regulatory" | "prohibited_language" | "competitive_claim" | "privacy";
     /** How bad it is */
     severity: "critical" | "major" | "minor";
     /** What is wrong — one sentence */

package/dist/types/excalidraw/components/auto-resize/autoResizeEngine.d.ts

@@ -69,6 +69,37 @@ export declare function extractFrameInfo(elements: readonly ExcalidrawElement[],
 export declare function computeCropLoss(sourceAR: number, targetAR: number): number;
 export declare function needsBackgroundRegeneration(srcW: number, srcH: number, tgtW: number, tgtH: number): boolean;
 export declare function nearestGeminiAspectRatio(w: number, h: number): string;
+/**
+ * Resolution dimensions available for each aspect ratio in Gemini 3.1 Flash
+ * Image (Nano Banana 2). Maps aspect ratio → resolution level → [width, height].
+ * Exported so the Auto Resize panel can build its dimension presets from the
+ * exact model-supported sizes instead of duplicating the numbers.
+ */
+export declare const GEMINI_RESOLUTION_TABLE: Record<string, Record<string, [number, number]>>;
+/**
+ * Resolution levels offered by the Auto Resize panel.
+ * Nano Banana (gemini-2.5-flash-image) and Nano Banana 2 (gemini-3.1-flash-image-preview)
+ * both support 0.5K–4K. 0.5K is the fastest/cheapest tier.
+ */
+export declare const AUTO_RESIZE_RESOLUTIONS: readonly ["0.5K", "1K", "2K", "4K"];
+export type AutoResizeResolution = typeof AUTO_RESIZE_RESOLUTIONS[number];
+/**
+ * Aspect ratios the Nano Banana 2 / Gemini 3.1 Flash Image model supports,
+ * ordered for display (common first, then the ultrawide / extreme-narrow ones).
+ * Each carries a human label for the panel.
+ */
+export declare const AUTO_RESIZE_ASPECT_RATIOS: {
+    ratio: string;
+    desc: string;
+}[];
+/**
+ * Concrete pixel dimensions for a given aspect ratio + resolution, straight from
+ * the Nano Banana 2 resolution table. Falls back to 1:1 / 1K if unknown.
+ */
+export declare function geminiDimsFor(ratio: string, resolution: string): {
+    width: number;
+    height: number;
+};
 /**
  * Selects the optimal resolution for a given target dimension and aspect ratio.
  * Chooses the resolution level that is closest to (but preferably >= ) the target size.
@@ -139,5 +170,15 @@ export declare function runAutoResize(opts: {
     signal?: AbortSignal;
     /** Pass the result of preCreateAllFrames() to skip redundant frame creation */
     preCreatedFrameInfos?: PreCreatedFrameInfo[];
+    /**
+     * Brand assets handed to the image model so the recomposed ad keeps the brand
+     * logo, typeface, and (for font-aware models) the real font file. Sourced from
+     * `app.state.brandContext` by the panel.
+     */
+    brandImages?: {
+        logo?: string;
+        fontPreview?: string;
+        fontUrl?: string;
+    };
 }): Promise<DimensionResult[]>;
 export {};

package/dist/types/excalidraw/types.d.ts

@@ -503,6 +503,21 @@ export type BrandContext = {
         environment?: string;
         negativeSpace?: string;
     };
+    /** Data URL of the master brand logo — passed as a visual reference to the image generation model. */
+    logoDataUrl?: string;
+    /** Data URL of text rendered in the brand headline font — passed as a visual reference to the image generation model. */
+    headlineFontPreviewDataUrl?: string;
+    /** Data URL of text rendered in the brand body font — passed as a second visual reference alongside the headline preview. */
+    bodyFontPreviewDataUrl?: string;
+    /**
+     * Fetchable URL (e.g. a short-lived presigned S3 URL) of the actual headline
+     * font file (.ttf/.otf). Passed to image models that accept a font file as
+     * input (Sourceful Riverflow v2+ via OpenRouter `image_config.font_inputs`).
+     * Unlike `headlineFontPreviewDataUrl` (a rendered preview image), this is the
+     * real font file the provider's servers fetch directly, so it must be a URL
+     * reachable without auth cookies — not the private `/api/brand/font` proxy.
+     */
+    headlineFontUrl?: string;
 };
 export interface ExcalidrawProps {
     onChange?: (elements: readonly OrderedExcalidrawElement[], appState: AppState, files: BinaryFiles) => void;
@@ -572,6 +587,13 @@ export interface ExcalidrawProps {
      * browser.
      */
     imageGenUrl?: string;
+    /**
+     * Brand context (colors, typography, logo, font preview) passed to every
+     * image generation surface (ImageGeneratorPanel, ImageQuickEditPanel, and the
+     * AI chat agent). When present, the logo and font preview are sent as visual
+     * references to the image model.
+     */
+    brandContext?: BrandContext;
     /**
      * Host proxy URL for the auto-resize engine's OpenRouter calls (layout
      * planning, vision tagging, HTML generation, reviewer). Key stays server-side.

package/dist/types/excalidraw/utils/brandContextUtils.d.ts

@@ -0,0 +1,20 @@
+import type { BrandContext } from "../types";
+/**
+ * Converts a BrandContext object to a concise text block describing brand
+ * identity guidelines. Used as a system/prompt prefix for both the agent loop
+ * and direct image generation panels.
+ */
+export declare function buildBrandContextMessage(ctx: BrandContext): string;
+/**
+ * Augments a raw user prompt with strong brand asset instructions — identical to
+ * the approach used by execGenerateImage in the AI chat agent. Call this in
+ * ImageGeneratorPanel and ImageQuickEditPanel before invoking callOpenRouterImageAPI
+ * so that direct-generation panels produce the same brand-faithful output as the
+ * agent loop.
+ *
+ * Brand DNA text (colors, visual style, etc.) should be passed separately as
+ * `brandImages.brandContextText` in callOpenRouterImageAPI so it's prepended as a
+ * block before the prompt. This function only appends the per-asset mandatory
+ * instructions that reference the visual attachments by position.
+ */
+export declare function buildImageGenSafePrompt(prompt: string, brandContext: BrandContext): string;

package/dist/types/excalidraw/utils/imageApi.d.ts

@@ -1 +1,19 @@
-export declare function callOpenRouterImageAPI(prompt: string, modelId: string, aspectRatio: string, imageSize: string | null, textOutput: boolean, imageGenUrl: string, referenceImageDataUrl?: string, signal?: AbortSignal): Promise<string>;
+export declare function callOpenRouterImageAPI(prompt: string, modelId: string, aspectRatio: string, imageSize: string | null, textOutput: boolean, imageGenUrl: string, referenceImageDataUrl?: string, signal?: AbortSignal, brandImages?: {
+    logo?: string;
+    fontPreview?: string;
+    /** Optional second font preview (brand body typeface) shown as a reference. */
+    fontPreviewBody?: string;
+    /**
+     * Fetchable URL of the real headline font file (.ttf/.otf). Only Sourceful
+     * Riverflow v2+ consumes this — sent via `image_config.font_inputs` so the
+     * model renders text in the actual brand typeface (not just a preview img).
+     */
+    fontUrl?: string;
+    /** Text to render with `fontUrl` for the font_inputs entry. */
+    fontText?: string;
+    /**
+     * Full brand identity context text (colors, typography, visual style, etc.)
+     * prepended to the prompt so the model applies brand guidelines to the image.
+     */
+    brandContextText?: string;
+}): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orangecatai/adgen-canvas",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "type": "module",
   "types": "./dist/types/excalidraw/index.d.ts",
   "main": "./dist/prod/index.js",

package/dist/prod/data/image-I7MZ4QNS.js

@@ -1 +0,0 @@
-import{T as a,U as b,V as c}from"../chunk-RXJEXEKA.js";import"../chunk-OWNL6YOR.js";import"../chunk-SRAX5OIU.js";export{c as decodePngMetadata,b as encodePngMetadata,a as getTEXtChunk};