@orangecatai/adgen-canvas 0.0.9 → 0.0.11

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

@@ -1 +1 @@
-import{a,b,c,d}from"./chunk-Z5NKEFVG.js";import"./chunk-WHNMS6DF.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-JCRT6UGN.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-WHNMS6DF.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-JCRT6UGN.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/AIChatPanel.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import { type ToolAction } from "./ai-chat/agentLoop";
+import type { ReviewerFeedback } from "./ai-chat/reviewerAgent";
 import "./AIChatPanel.scss";
 import type { ExcalidrawImperativeAPI } from "../types";
 export type ChatMessage = {
@@ -13,6 +14,8 @@ export type ChatMessage = {
         type: "image" | "text";
         dataUrl?: string;
     }>;
+    /** Reviewer feedback attached to an assistant message after HTML ad generation */
+    reviewFeedback?: ReviewerFeedback;
 };
 export type ChatSession = {
     id: string;
@@ -78,5 +81,37 @@ export type AIChatPanelProps = {
      * brand font files are also registered in the canvas.
      */
     brandContext?: import("../types").BrandContext;
+    onSearchBrandAssets?: (query: string, type?: string) => Promise<Array<{
+        id: string;
+        name: string;
+        tags: string[];
+        assetType: string;
+        blobUrl: string;
+    }>>;
+    onListBrandTemplates?: (campaignTag?: string) => Promise<Array<{
+        id: string;
+        name: string;
+        campaignTag?: string;
+        variants: Array<{
+            id: string;
+            label: string;
+            width: number;
+            height: number;
+            thumbnailBlobUrl?: string;
+        }>;
+    }>>;
+    onGetTemplateVariant?: (variantId: string) => Promise<{
+        canvasJson: string;
+    }>;
+    /**
+     * OpenRouter model tag for the reviewer agent. Must be vision-capable.
+     * Defaults to the same model as chatModel.
+     */
+    reviewerModel?: string;
+    /**
+     * Maximum number of reviewer rounds per banner before the reviewer is skipped.
+     * @default 2
+     */
+    maxReviewRounds?: number;
 };
 export declare const AIChatPanel: React.ForwardRefExoticComponent<AIChatPanelProps & React.RefAttributes<AIChatPanelRef>>;

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

@@ -7,6 +7,7 @@ export interface ImageEditToolbarCallbacks {
     onRemoveBG?: () => void;
     onCrop?: () => void;
     onDownload?: () => void;
+    onSwapAsset?: (elementId: string) => Promise<void>;
 }
 export declare const ImageEditToolbar: ({ element, app, callbacks, }: {
     element: ExcalidrawImageElement & NonDeletedExcalidrawElement;

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

@@ -41,11 +41,22 @@ export type AgentUpdate = {
     type: "status" | "tool_start" | "tool_done" | "final" | "content_delta";
     message: string;
     toolAction?: ToolAction;
+} | {
+    type: "review_start";
+    message: string;
+} | {
+    type: "review_done";
+    message: string;
+    feedback: import("./reviewerAgent").ReviewerFeedback;
 };
 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";
@@ -84,5 +95,17 @@ export declare function runAgentLoop(opts: {
      * Kept for API compatibility but no longer used internally.
      */
     customFontIds?: number[];
+    /**
+     * OpenRouter model tag for the reviewer agent. Must be vision-capable.
+     * Defaults to the same model as chatModel.
+     */
+    reviewerModel?: string;
+    /**
+     * Maximum number of reviewer rounds per banner.
+     * After this many rounds the reviewer is skipped and the outer MAX_ITERATIONS
+     * cap handles loop termination.
+     * @default 2
+     */
+    maxReviewRounds?: number;
 }): Promise<AgentResult>;
 export {};

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

@@ -436,6 +436,161 @@ export declare const BANNER_TOOLS: readonly [{
             readonly additionalProperties: false;
         };
     };
+}, {
+    readonly type: "function";
+    readonly function: {
+        readonly name: "search_brand_assets";
+        readonly description: "Search the brand asset bank for existing product shots, logos, and lifestyle images. ALWAYS call this before generate_image to check if a brand asset already exists.";
+        readonly parameters: {
+            readonly type: "object";
+            readonly properties: {
+                readonly query: {
+                    readonly type: "string";
+                    readonly description: "Search query — name or tag keywords";
+                };
+                readonly type: {
+                    readonly type: "string";
+                    readonly enum: readonly ["product", "logo", "lifestyle", "auxiliary"];
+                    readonly description: "Optional filter by asset type";
+                };
+            };
+            readonly required: readonly ["query"];
+            readonly additionalProperties: false;
+        };
+    };
+}, {
+    readonly type: "function";
+    readonly function: {
+        readonly name: "list_brand_templates";
+        readonly description: "List available brand templates. Call this when the user mentions a campaign, template, or asks for multiple sizes.";
+        readonly parameters: {
+            readonly type: "object";
+            readonly properties: {
+                readonly campaignTag: {
+                    readonly type: "string";
+                    readonly description: "Optional campaign tag to filter templates";
+                };
+            };
+            readonly required: readonly [];
+            readonly additionalProperties: false;
+        };
+    };
+}, {
+    readonly type: "function";
+    readonly function: {
+        readonly name: "get_template_variant";
+        readonly description: "Fetch the full canvas JSON for a specific template by its ID.";
+        readonly parameters: {
+            readonly type: "object";
+            readonly properties: {
+                readonly variantId: {
+                    readonly type: "string";
+                    readonly description: "The template ID to fetch";
+                };
+            };
+            readonly required: readonly ["variantId"];
+            readonly additionalProperties: false;
+        };
+    };
+}, {
+    readonly type: "function";
+    readonly function: {
+        readonly name: "load_template_into_frame";
+        readonly description: "Load a template into an existing frame, replacing its contents with the template elements.";
+        readonly parameters: {
+            readonly type: "object";
+            readonly properties: {
+                readonly frameId: {
+                    readonly type: "string";
+                    readonly description: "The frame ID to load the template into";
+                };
+                readonly variantId: {
+                    readonly type: "string";
+                    readonly description: "The template ID to load (from list_brand_templates)";
+                };
+            };
+            readonly required: readonly ["frameId", "variantId"];
+            readonly additionalProperties: false;
+        };
+    };
+}, {
+    readonly type: "function";
+    readonly function: {
+        readonly name: "fill_template_slots";
+        readonly description: "Fill the slot elements inside a frame with content. Use this after load_template_into_frame to populate slots with actual content.";
+        readonly parameters: {
+            readonly type: "object";
+            readonly properties: {
+                readonly frameId: {
+                    readonly type: "string";
+                    readonly description: "The frame ID containing slot elements";
+                };
+                readonly headline: {
+                    readonly type: "string";
+                    readonly description: "Text for the headline slot";
+                };
+                readonly subhead: {
+                    readonly type: "string";
+                    readonly description: "Text for the subhead slot";
+                };
+                readonly cta: {
+                    readonly type: "string";
+                    readonly description: "Text for the CTA slot";
+                };
+                readonly signoff: {
+                    readonly type: "string";
+                    readonly description: "Text for the signoff slot";
+                };
+                readonly product_image_url: {
+                    readonly type: "string";
+                    readonly description: "URL for the product image slot (from search_brand_assets blobUrl, or a generated image data URL)";
+                };
+                readonly product_image_asset_id: {
+                    readonly type: "string";
+                    readonly description: "Asset ID for the product image (from search_brand_assets [id:...] field). Required when using a brand asset so the image can be swapped later.";
+                };
+                readonly logo_url: {
+                    readonly type: "string";
+                    readonly description: "URL for the logo slot (from search_brand_assets blobUrl)";
+                };
+                readonly logo_asset_id: {
+                    readonly type: "string";
+                    readonly description: "Asset ID for the logo (from search_brand_assets [id:...] field). Required when using a brand asset.";
+                };
+                readonly auxiliary_image_url: {
+                    readonly type: "string";
+                    readonly description: "URL for the auxiliary image slot";
+                };
+                readonly auxiliary_image_asset_id: {
+                    readonly type: "string";
+                    readonly description: "Asset ID for the auxiliary image (from search_brand_assets [id:...] field). Required when using a brand asset.";
+                };
+                readonly background_color: {
+                    readonly type: "string";
+                    readonly description: "Hex color (e.g. #000000) for the background slot";
+                };
+            };
+            readonly required: readonly ["frameId"];
+            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 = {
@@ -472,6 +627,32 @@ export type ToolExecutionContext = {
         name: string;
         dataUrl?: string;
     }>;
+    onSearchBrandAssets?: (query: string, type?: string) => Promise<Array<{
+        id: string;
+        name: string;
+        tags: string[];
+        assetType: string;
+        blobUrl: string;
+    }>>;
+    onListBrandTemplates?: (campaignTag?: string) => Promise<Array<{
+        id: string;
+        name: string;
+        campaignTag?: string;
+        label?: string;
+        width?: number;
+        height?: number;
+        thumbnailBlobUrl?: string;
+    }>>;
+    onGetTemplateVariant?: (variantId: string) => Promise<{
+        canvasJson: string;
+    }>;
+    /**
+     * Internal cache: populated by execGetTemplateVariant so that
+     * execLoadTemplateIntoFrame can reuse the already-fetched JSON without a
+     * second round-trip. Avoids the "double fetch → silent {} fallback → crash"
+     * failure mode for private Vercel Blob URLs.
+     */
+    _templateJsonCache?: Map<string, string>;
 };
 export type ToolResult = {
     success: boolean;

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

@@ -0,0 +1,64 @@
+/**
+ * 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.
+ *
+ * The reviewer is a separate LLM call from the main agent loop so it
+ * brings an independent eye to the generated banner.
+ */
+import type { BrandContext } from "../../types";
+export type ReviewIssue = {
+    /** Which design element is affected */
+    element: "headline" | "subheadline" | "cta" | "image" | "layout" | "brand";
+    /** How bad it is */
+    severity: "critical" | "major" | "minor";
+    /** What is wrong — one sentence */
+    problem: string;
+    /** One-line direction for the fix */
+    fix: string;
+    /**
+     * Precise instruction with numeric coordinates or px values.
+     * Examples:
+     *   "Reduce headline font-size from 72px to 48px"
+     *   "Move CTA button to x=380,y=440 (bottom-right quadrant)"
+     *   "Shift text container left boundary from x=0 to x=20 so it clears the image at x=260"
+     */
+    preciseInstruction: string;
+};
+export type ReviewerFeedback = {
+    /** true = no actionable issues; main agent should finalize */
+    approved: boolean;
+    /** empty when approved */
+    issues: ReviewIssue[];
+    /** 1-2 sentence overall verdict */
+    summary: string;
+    /** which reviewer round produced this (1-based) */
+    iteration: number;
+};
+export declare function runReviewerAgent(opts: {
+    screenshotDataUrl: string;
+    htmlSource: string;
+    frame: {
+        width: number;
+        height: number;
+        id: string;
+    };
+    imagePlacement?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Original user request — first message only, not full conversation history */
+    userBrief: string;
+    brandContext?: BrandContext;
+    apiKey: string;
+    /** OpenRouter model tag. Must be vision-capable. Defaults to gemini-3.1-flash-lite-preview */
+    reviewerModel?: string;
+    signal?: AbortSignal;
+    iteration: number;
+}): Promise<ReviewerFeedback>;

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

@@ -16,6 +16,8 @@ export type DimensionResult = {
 export type ProgressCallback = (dimensionIndex: number, total: number, phase: "bg-regen" | "layout" | "inserting" | "done" | "error", label: string) => void;
 type ForegroundEl = {
     kind: "text";
+    elementId: string;
+    slotType?: string;
     relX: number;
     relY: number;
     width: number;
@@ -28,6 +30,8 @@ type ForegroundEl = {
     opacity: number;
 } | {
     kind: "image";
+    elementId: string;
+    slotType?: string;
     relX: number;
     relY: number;
     width: number;
@@ -36,6 +40,8 @@ type ForegroundEl = {
     opacity: number;
 } | {
     kind: "rect";
+    elementId: string;
+    slotType?: string;
     relX: number;
     relY: number;
     width: number;
@@ -49,9 +55,11 @@ type SourceFrameInfo = {
     background: {
         type: "solid";
         color: string;
+        elementId?: string;
     } | {
         type: "image";
         dataUrl: string;
+        elementId?: string;
     } | {
         type: "none";
     };

package/dist/types/excalidraw/components/template-builder/TemplateBuilderPanelHost.d.ts

@@ -0,0 +1,4 @@
+import type { AppClassProperties } from "../../types";
+export declare const TemplateBuilderPanelHost: ({ app, }: {
+    app: AppClassProperties;
+}) => import("react/jsx-runtime").JSX.Element | null;

package/dist/types/excalidraw/components/template-builder/TemplateBuilderTray.d.ts

@@ -0,0 +1,4 @@
+import type { AppClassProperties } from "../../types";
+export declare const TemplateBuilderTray: ({ app }: {
+    app: AppClassProperties;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/types/excalidraw/components/template-builder/slotTypes.d.ts

@@ -0,0 +1,43 @@
+export declare const SLOT_TYPES: readonly [{
+    readonly id: "background";
+    readonly label: "Background";
+    readonly color: "#94a3b8";
+    readonly kind: "rect";
+}, {
+    readonly id: "logo";
+    readonly label: "Logo";
+    readonly color: "#f97316";
+    readonly kind: "image";
+}, {
+    readonly id: "product_image";
+    readonly label: "Product Image";
+    readonly color: "#22c55e";
+    readonly kind: "image";
+}, {
+    readonly id: "headline";
+    readonly label: "Headline";
+    readonly color: "#3b82f6";
+    readonly kind: "text";
+}, {
+    readonly id: "subhead";
+    readonly label: "Subhead";
+    readonly color: "#8b5cf6";
+    readonly kind: "text";
+}, {
+    readonly id: "cta";
+    readonly label: "CTA";
+    readonly color: "#ef4444";
+    readonly kind: "text";
+}, {
+    readonly id: "signoff";
+    readonly label: "Signoff";
+    readonly color: "#64748b";
+    readonly kind: "text";
+}, {
+    readonly id: "auxiliary_image";
+    readonly label: "Aux Image";
+    readonly color: "#14b8a6";
+    readonly kind: "image";
+}];
+export type SlotType = typeof SLOT_TYPES[number];
+export type SlotTypeId = SlotType["id"];

package/dist/types/excalidraw/components/template-builder/templateBuilderStore.d.ts

@@ -0,0 +1,19 @@
+export type TemplateBuilderState = {
+    isOpen: boolean;
+    isBuilding: boolean;
+    templateName: string;
+    campaignTag: string;
+    /** The frame element ID that triggered the template builder (set by FrameToolbar). */
+    sourceFrameId: string | null;
+};
+type Listener = (state: TemplateBuilderState) => void;
+export declare const templateBuilderStore: {
+    open(sourceFrameId?: string): void;
+    close(): void;
+    setBuilding(b: boolean): void;
+    setName(name: string): void;
+    setCampaignTag(tag: string): void;
+    getState(): TemplateBuilderState;
+    subscribe(fn: Listener): () => void;
+};
+export {};

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

@@ -53,3 +53,4 @@ export type { AppState, BinaryFiles, BinaryFileData, ExcalidrawProps, Excalidraw
 export type { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted, OrderedExcalidrawElement, ExcalidrawElementType, } from "@orangecatai/element/types";
 export type { ImageEditToolbarCallbacks } from "./components/ImageEditToolbar";
 export type { CustomFontSpec, BrandContext } from "./types";
+export type { ReviewerFeedback, ReviewIssue } from "./components/ai-chat/reviewerAgent";

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

@@ -628,6 +628,14 @@ export interface ExcalidrawProps {
      * @example "gemini-3.1-flash-image-preview"
      */
     agentImageModel?: string;
+    /**
+     * OpenRouter model tag used by the auto-resize engine for HTML layout
+     * generation. This is the LLM call that figures out how to reflow the ad
+     * content into the target dimensions before Gemini regenerates the background.
+     * @default "google/gemini-3.1-flash-lite-preview"
+     * @example "openai/gpt-4o"
+     */
+    chatModel?: string;
     /**
      * Show the Library sidebar trigger button. Defaults to `false`.
      * Set to `true` to show the library icon in the top-right area.
@@ -646,6 +654,56 @@ export interface ExcalidrawProps {
      * matches the given familyId.
      */
     customFonts?: CustomFontSpec[];
+    /**
+     * Called when the user saves a template from the Template Builder.
+     */
+    onSaveTemplate?: (template: {
+        name: string;
+        campaignTag?: string;
+        label?: string;
+        width?: number;
+        height?: number;
+        canvasJson?: string;
+        thumbnailDataUrl?: string;
+    }) => void;
+    /**
+     * Fetch all available brand assets for the asset picker (in-canvas swap).
+     */
+    onFetchAllAssets?: () => Promise<Array<{
+        id: string;
+        name: string;
+        tags: string[];
+        assetType: string;
+        blobUrl: string;
+    }>>;
+    /**
+     * Search brand assets by query and optional type filter.
+     */
+    onSearchBrandAssets?: (query: string, type?: string) => Promise<Array<{
+        id: string;
+        name: string;
+        tags: string[];
+        assetType: string;
+        blobUrl: string;
+    }>>;
+    /**
+     * List brand templates, optionally filtered by campaignTag.
+     */
+    onListBrandTemplates?: (campaignTag?: string) => Promise<Array<{
+        id: string;
+        name: string;
+        campaignTag?: string;
+        label?: string;
+        width?: number;
+        height?: number;
+        thumbnailBlobUrl?: string;
+    }>>;
+    /**
+     * Fetch the full canvas JSON for a specific template by ID.
+     */
+    onGetTemplateVariant?: (templateId: string) => Promise<{
+        canvasJson: string;
+    }>;
 }
 export type SceneData = {
     elements?: ImportedDataState["elements"];

package/package.json

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

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

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