@orangecatai/adgen-canvas 0.0.5 → 0.0.7

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

@@ -0,0 +1,89 @@
+import type { ExcalidrawElement, ExcalidrawFrameLikeElement } from "@orangecatai/element/types";
+import type { AppClassProperties } from "../../types";
+import type { BinaryFiles } from "../../types";
+export type TargetDimension = {
+    width: number;
+    height: number;
+    label?: string;
+};
+export type DimensionResult = {
+    status: "ok";
+    frameId: string;
+} | {
+    status: "error";
+    error: string;
+};
+export type ProgressCallback = (dimensionIndex: number, total: number, phase: "bg-regen" | "layout" | "inserting" | "done" | "error", label: string) => void;
+type ForegroundEl = {
+    kind: "text";
+    relX: number;
+    relY: number;
+    width: number;
+    height: number;
+    text: string;
+    fontSize: number;
+    color: string;
+    textAlign: string;
+    fontWeight: string;
+    opacity: number;
+} | {
+    kind: "image";
+    relX: number;
+    relY: number;
+    width: number;
+    height: number;
+    dataUrl: string;
+    opacity: number;
+} | {
+    kind: "rect";
+    relX: number;
+    relY: number;
+    width: number;
+    height: number;
+    backgroundColor: string;
+    borderRadius: number;
+    opacity: number;
+};
+type SourceFrameInfo = {
+    frame: ExcalidrawFrameLikeElement;
+    background: {
+        type: "solid";
+        color: string;
+    } | {
+        type: "image";
+        dataUrl: string;
+    } | {
+        type: "none";
+    };
+    foreground: ForegroundEl[];
+};
+export declare function extractFrameInfo(elements: readonly ExcalidrawElement[], frame: ExcalidrawFrameLikeElement, files: BinaryFiles): SourceFrameInfo;
+export declare function needsBackgroundRegeneration(srcW: number, srcH: number, tgtW: number, tgtH: number): boolean;
+export type PreCreatedFrameInfo = {
+    frameId: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export declare function preCreateAllFrames(targetDimensions: TargetDimension[], sourceFrame: ExcalidrawFrameLikeElement, app: AppClassProperties): PreCreatedFrameInfo[];
+export declare function runAutoResize(opts: {
+    sourceFrameId: string;
+    targetDimensions: TargetDimension[];
+    app: AppClassProperties;
+    geminiApiKey: string;
+    openRouterApiKey: string;
+    chatModel?: string;
+    agentImageModel?: string;
+    customFontMap?: Record<string, number>;
+    onBeforeAutoResize?: () => Promise<{
+        allowed: boolean;
+        error?: string;
+    }>;
+    onAfterAutoResize?: () => void;
+    onProgress?: ProgressCallback;
+    signal?: AbortSignal;
+    /** Pass the result of preCreateAllFrames() to skip redundant frame creation */
+    preCreatedFrameInfos?: PreCreatedFrameInfo[];
+}): Promise<DimensionResult[]>;
+export {};

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

@@ -0,0 +1,16 @@
+export type LoadingFrameInfo = {
+    frameId: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+type Listener = () => void;
+export declare const autoResizeStore: {
+    setLoadingFrames(frames: LoadingFrameInfo[]): void;
+    markComplete(frameId: string): void;
+    clear(): void;
+    getLoadingFrames(): LoadingFrameInfo[];
+    subscribe(fn: Listener): () => void;
+};
+export {};

package/dist/types/excalidraw/components/hyperlink/Hyperlink.d.ts

@@ -1,6 +1,6 @@
+import "./Hyperlink.scss";
 import type { Scene } from "@orangecatai/element";
 import type { ElementsMap, ExcalidrawEmbeddableElement, NonDeletedExcalidrawElement } from "@orangecatai/element/types";
-import "./Hyperlink.scss";
 import type { AppState, ExcalidrawProps, UIAppState } from "../../types";
 export declare const Hyperlink: ({ element, scene, setAppState, onLinkOpen, setToast, updateEmbedValidationStatus, }: {
     element: NonDeletedExcalidrawElement;

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

@@ -188,6 +188,7 @@ export declare const alertTriangleIcon: import("react/jsx-runtime").JSX.Element;
 export declare const eyeDropperIcon: import("react/jsx-runtime").JSX.Element;
 export declare const extraToolsIcon: import("react/jsx-runtime").JSX.Element;
 export declare const frameToolIcon: import("react/jsx-runtime").JSX.Element;
+export declare const imageGeneratorToolIcon: import("react/jsx-runtime").JSX.Element;
 export declare const mermaidLogoIcon: import("react/jsx-runtime").JSX.Element;
 export declare const RetryIcon: import("react/jsx-runtime").JSX.Element;
 export declare const stackPushIcon: import("react/jsx-runtime").JSX.Element;

package/dist/types/excalidraw/components/main-menu/DefaultItems.d.ts

@@ -1,5 +1,5 @@
-import type { Theme } from "@orangecatai/element/types";
 import "./DefaultItems.scss";
+import type { Theme } from "@orangecatai/element/types";
 export declare const LoadScene: {
     (): import("react/jsx-runtime").JSX.Element | null;
     displayName: string;

package/dist/types/excalidraw/components/ui/button.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { type VariantProps } from "class-variance-authority";
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "outline" | "destructive" | "secondary" | "ghost" | null | undefined;
+    variant?: "link" | "default" | "outline" | "secondary" | "destructive" | "ghost" | null | undefined;
     size?: "icon" | "default" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {

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

@@ -14,6 +14,17 @@ export declare class Fonts {
         metadata: FontMetadata;
         fontFaces: ExcalidrawFontFace[];
     }>;
+    /**
+     * Register a custom font from a URL into the canvas font system.
+     *
+     * Use family IDs >= 1000 to avoid collisions with built-in fonts.
+     *
+     * Note: custom fonts are registered without a weight/style descriptor
+     * because getFontString generates "${size}px ${familyName}" (no weight),
+     * so the browser always requests the normal-weight variant. Pass the font
+     * file that should render by default for this family ID.
+     */
+    static registerCustomFont(spec: import("../types").CustomFontSpec): void;
     private readonly scene;
     constructor(scene: Scene);
     /**

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

@@ -51,3 +51,5 @@ export type { AIChatPanelProps, AIChatPanelRef, ChatMessage, ChatSession, } from
 export type { ExcalidrawImperativeAPI } from "./types";
 export type { AppState, BinaryFiles, BinaryFileData, ExcalidrawProps, ExcalidrawInitialDataState, LibraryItem, LibraryItems, SceneData, UnsubscribeCallback, } from "./types";
 export type { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted, OrderedExcalidrawElement, ExcalidrawElementType, } from "@orangecatai/element/types";
+export type { ImageEditToolbarCallbacks } from "./components/ImageEditToolbar";
+export type { CustomFontSpec, BrandContext } from "./types";

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

@@ -430,6 +430,75 @@ export type OnUserFollowedPayload = {
     userToFollow: UserToFollow;
     action: "FOLLOW" | "UNFOLLOW";
 };
+/**
+ * Describes a custom font to register in the canvas font system.
+ * Use family IDs >= 1000 to avoid collision with built-in fonts.
+ */
+export type CustomFontSpec = {
+    /** Unique numeric family ID. Use 1000+ to avoid collisions with built-ins. */
+    familyId: number;
+    /** CSS font-family name used in @font-face and canvas rendering. */
+    name: string;
+    /** Absolute URL or data: URL pointing to the font file. */
+    url: string;
+    /**
+     * Informational font-weight (e.g. "400", "700"). Not applied as a CSS
+     * descriptor — getFontString never includes weight, so all custom fonts
+     * load as the normal-weight variant for their family ID.
+     */
+    weight?: string;
+};
+/**
+ * Optional brand identity context passed to AIChatPanel.
+ * When provided, the AI agent uses these guidelines when creating ads.
+ */
+export type BrandContext = {
+    colors?: {
+        primary?: string;
+        secondary?: string;
+        accent?: string;
+        background?: string;
+    };
+    typography?: {
+        headline?: {
+            family: string;
+            weight?: string;
+            /** size_scale from brand kit (e.g. "display", "large", "medium", "small") */
+            sizeScale?: string;
+            /**
+             * Font family ID if a matching custom font was registered via
+             * the `customFonts` prop on <Excalidraw>. The agent will pass
+             * this number to add_text fontFamily calls.
+             */
+            fontFamilyId?: number;
+        };
+        body?: {
+            family: string;
+            weight?: string;
+            sizeScale?: string;
+            fontFamilyId?: number;
+        };
+    };
+    visualStyle?: string;
+    layoutPattern?: string;
+    toneOfVoice?: {
+        register?: string;
+        vocabulary?: string;
+        ctaStyle?: string;
+        sentenceLength?: string;
+        person?: string;
+    };
+    imagery?: {
+        type?: string;
+        lighting?: string;
+        composition?: string;
+        subjects?: string;
+        grading?: string;
+        depthOfField?: string;
+        environment?: string;
+        negativeSpace?: string;
+    };
+};
 export interface ExcalidrawProps {
     onChange?: (elements: readonly OrderedExcalidrawElement[], appState: AppState, files: BinaryFiles) => void;
     onIncrement?: (event: DurableIncrement | EphemeralIncrement) => void;
@@ -497,6 +566,16 @@ export interface ExcalidrawProps {
      * Required for image generation when using this package as an npm dependency.
      */
     geminiApiKey?: string;
+    /**
+     * Leonardo API key for image toolbar upscale action.
+     * When provided, takes precedence over the VITE_APP_LEONARDO_API_KEY env variable.
+     */
+    leonardoApiKey?: string;
+    /**
+     * remove.bg API key for the remove background toolbar action.
+     * When provided, takes precedence over the VITE_APP_REMOVE_BG_API_KEY env variable.
+     */
+    removeBgApiKey?: string;
     /**
      * Called before any image generation (ImageGeneratorPanel, ImageQuickEditPanel,
      * or agent loop generate_image tool). Return `{ allowed: false }` to block.
@@ -510,6 +589,63 @@ export interface ExcalidrawProps {
      * Called after a successful image generation from any panel or agent tool.
      */
     onAfterImageGen?: () => void;
+    /**
+     * Called before an upscale is run (deduct credits, check quota).
+     * Return `{ allowed: false, error: "..." }` to block the operation.
+     */
+    onBeforeUpscale?: () => Promise<{
+        allowed: boolean;
+        error?: string;
+    }>;
+    /** Called after a successful upscale. */
+    onAfterUpscale?: () => void;
+    /**
+     * Called before a background removal is run (deduct credits, check quota).
+     * Return `{ allowed: false, error: "..." }` to block the operation.
+     */
+    onBeforeRemoveBg?: () => Promise<{
+        allowed: boolean;
+        error?: string;
+    }>;
+    /** Called after a successful background removal. */
+    onAfterRemoveBg?: () => void;
+    /**
+     * Called before each auto-resize dimension is generated (deduct credits, check quota).
+     * Return `{ allowed: false, error: "..." }` to skip that dimension.
+     */
+    onBeforeAutoResize?: () => Promise<{
+        allowed: boolean;
+        error?: string;
+    }>;
+    /** Called after each successfully generated auto-resize dimension. */
+    onAfterAutoResize?: () => void;
+    /**
+     * Gemini model ID used for AI image generation — covers both the auto-resize
+     * background regeneration and the agent chat `generate_image` tool.
+     * Pass the same value here and to `AIChatPanel.agentImageModel` to keep
+     * both surfaces on the same model with a single configuration.
+     * @default "gemini-3.1-flash-image-preview"
+     * @example "gemini-3.1-flash-image-preview"
+     */
+    agentImageModel?: string;
+    /**
+     * Show the Library sidebar trigger button. Defaults to `false`.
+     * Set to `true` to show the library icon in the top-right area.
+     */
+    showLibraryButton?: boolean;
+    /**
+     * Callbacks for each action in the image edit toolbar
+     * (shown when an image element is selected on canvas).
+     * When callbacks are omitted, built-in toolbar actions are used.
+     */
+    imageEditToolbarCallbacks?: import("./components/ImageEditToolbar").ImageEditToolbarCallbacks;
+    /**
+     * Custom fonts to register in the canvas font system.
+     * Each entry maps a numeric family ID (use 1000+) to a font file URL.
+     * Registered fonts become available for text elements whose fontFamily
+     * matches the given familyId.
+     */
+    customFonts?: CustomFontSpec[];
 }
 export type SceneData = {
     elements?: ImportedDataState["elements"];
@@ -563,6 +699,7 @@ export type AppProps = Merge<ExcalidrawProps, {
 export type AppClassProperties = {
     props: AppProps;
     state: AppState;
+    actionManager: App["actionManager"];
     interactiveCanvas: HTMLCanvasElement | null;
     /** static canvas */
     canvas: HTMLCanvasElement;
@@ -604,6 +741,7 @@ export type AppClassProperties = {
     visibleElements: App["visibleElements"];
     excalidrawContainerValue: App["excalidrawContainerValue"];
     getSceneElements: App["getSceneElements"];
+    updateScene: App["updateScene"];
     onPointerUpEmitter: App["onPointerUpEmitter"];
     updateEditorAtom: App["updateEditorAtom"];
     onPointerDownEmitter: App["onPointerDownEmitter"];

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

@@ -0,0 +1 @@
+export declare function resolveLeonardoApiKey(propKey?: string): string;

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

@@ -0,0 +1 @@
+export declare function resolveRemoveBgApiKey(propKey?: string): string;

package/package.json

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