@orangecatai/adgen-canvas 0.0.6 → 0.0.7

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

@@ -52,3 +52,4 @@ 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;
@@ -540,6 +609,25 @@ export interface ExcalidrawProps {
     }>;
     /** 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.
@@ -551,6 +639,13 @@ export interface ExcalidrawProps {
      * 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"];
@@ -646,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/package.json

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