@kittl/sdk 0.0.3 → 0.0.5

package/dist/kittl-sdk.esm.js

@@ -18,6 +18,9 @@ var isDesignStateUpdatePushMessage = (data) => {
 var isAppStateUpdatePushMessage = (data) => {
   return typeof data === "object" && data !== null && "command" in data && data.command === "app-state-update" && "updates" in data && Array.isArray(data.updates);
 };
+var isContextUpdatePushMessage = (data) => {
+  return typeof data === "object" && data !== null && "command" in data && data.command === "context-update" && "subscriptionId" in data && typeof data.subscriptionId === "string" && "context" in data && typeof data.context === "object" && data.context !== null;
+};
 
 // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/shared/createApiProxyCore.js
 var buildMethodPath = (rootPrefix, pathSegments) => {
@@ -192,6 +195,13 @@ var createSDKCallMessage = {
     args,
     messageId,
     apiType: "upload"
+  }),
+  data: (dots, args, messageId) => ({
+    command: "sdk-call",
+    dots,
+    args,
+    messageId,
+    apiType: "data"
   })
 };
 function createApiProxy(apiType) {
@@ -210,6 +220,7 @@ function createApiProxy(apiType) {
 
 // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/apiProxy/aiApiProxy.js
 var generationHandlers = /* @__PURE__ */ new Map();
+var generationSubscriptions = /* @__PURE__ */ new Map();
 var dispatchAIGenerationUpdate = (subscriptionId, update) => {
   const handler = generationHandlers.get(subscriptionId);
   if (!handler) {
@@ -218,6 +229,20 @@ var dispatchAIGenerationUpdate = (subscriptionId, update) => {
   void handler(update);
 };
 function createAIApiProxy() {
+  const unregisterGenerationHandler = (generatorId) => {
+    const subscriptionId = generationSubscriptions.get(generatorId);
+    if (!subscriptionId) {
+      return;
+    }
+    generationHandlers.delete(subscriptionId);
+    generationSubscriptions.delete(generatorId);
+    const unregisterMessage = {
+      command: "ai-unregister-handler",
+      generatorId,
+      subscriptionId
+    };
+    postMessageToParent(unregisterMessage);
+  };
   return {
     spendCredits: async (options) => {
       const { onAccept, onDecline, ...serializable } = options;
@@ -247,16 +272,18 @@ function createAIApiProxy() {
       return sendMessage(message);
     },
     registerHandler: async (generatorId, onStatusUpdate) => {
-      const subscriptionId = generateMessageId();
-      const unregister = () => {
-        generationHandlers.delete(subscriptionId);
-        const unregisterMessage = {
-          command: "ai-unregister-handler",
-          subscriptionId
+      if (generationSubscriptions.has(generatorId)) {
+        return {
+          isOk: false,
+          error: {
+            message: `AI handler for generator "${generatorId}" is already registered`,
+            name: "SdkInternalError"
+          }
         };
-        postMessageToParent(unregisterMessage);
-      };
+      }
+      const subscriptionId = generateMessageId();
       generationHandlers.set(subscriptionId, onStatusUpdate);
+      generationSubscriptions.set(generatorId, subscriptionId);
       const registerMessage = {
         command: "ai-register-handler",
         messageId: generateMessageId(),
@@ -267,11 +294,16 @@ function createAIApiProxy() {
         const response = await sendMessage(registerMessage);
         if (!response.isOk) {
           generationHandlers.delete(subscriptionId);
+          generationSubscriptions.delete(generatorId);
           return response;
         }
-        return { isOk: true, result: unregister };
+        return {
+          isOk: true,
+          result: () => unregisterGenerationHandler(generatorId)
+        };
       } catch {
         generationHandlers.delete(subscriptionId);
+        generationSubscriptions.delete(generatorId);
         return {
           isOk: false,
           error: {
@@ -280,6 +312,10 @@ function createAIApiProxy() {
           }
         };
       }
+    },
+    unregisterHandler: async (generatorId) => {
+      unregisterGenerationHandler(generatorId);
+      return { isOk: true, result: void 0 };
     }
   };
 }
@@ -425,8 +461,7 @@ var createAuthBridgeApi = () => {
       const message = {
         command: "auth-refresh",
         messageId: generateMessageId(),
-        provider: request.provider,
-        refresh_token: request.refresh_token
+        provider: request.provider
       };
       return sendMessage(message);
     },
@@ -486,6 +521,53 @@ var createBatch = async () => {
   return buildNode([]);
 };
 
+// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/context/contextBridge.js
+var createContextBridgeApi = () => {
+  const contextProxy = createApiProxy("context");
+  const subscriptionCallbacks = /* @__PURE__ */ new Map();
+  const dispatch = (message) => {
+    const cb = subscriptionCallbacks.get(message.subscriptionId);
+    cb?.(message.context);
+  };
+  const subscribeImpl = async (callback) => {
+    const subscriptionId = generateMessageId();
+    const messageId = generateMessageId();
+    subscriptionCallbacks.set(subscriptionId, callback);
+    let response;
+    try {
+      response = await sendMessage({
+        command: "context-subscribe",
+        messageId,
+        subscriptionId
+      });
+    } catch (error) {
+      subscriptionCallbacks.delete(subscriptionId);
+      throw error;
+    }
+    if (!response.isOk) {
+      subscriptionCallbacks.delete(subscriptionId);
+      throw new Error(`context-subscribe failed: ${response.error.message}`);
+    }
+    return () => {
+      subscriptionCallbacks.delete(subscriptionId);
+      const message = {
+        command: "context-unsubscribe",
+        subscriptionId
+      };
+      postMessageToParent(message);
+    };
+  };
+  const api = new Proxy(contextProxy, {
+    get(target, prop, receiver) {
+      if (prop === "subscribe") {
+        return subscribeImpl;
+      }
+      return Reflect.get(target, prop, receiver);
+    }
+  });
+  return { api, dispatch };
+};
+
 // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/designState/index.js
 var sendUnsubscribe2 = (selectorIds) => {
   const message = {
@@ -607,6 +689,7 @@ var createStatelessBridgeApi = () => {
 var statelessApi = createStatelessBridgeApi();
 var designStateApi = createDesignStateBridgeApi();
 var appStateApi = createAppStateBridgeApi();
+var { api: contextApi, dispatch: dispatchContextUpdate } = createContextBridgeApi();
 var handleIncomingMessage = (event) => {
   const parent = window.parent;
   if (!parent || parent === window) {
@@ -641,10 +724,14 @@ var handleIncomingMessage = (event) => {
     appStateApi.dispatch(data.updates);
     return;
   }
+  if (isContextUpdatePushMessage(data)) {
+    dispatchContextUpdate(data);
+  }
 };
 var bridgeHandlers = {
   ai: createAIApiProxy(),
-  context: createApiProxy("context"),
+  context: contextApi,
+  data: createApiProxy("data"),
   design: createApiProxy("design"),
   designStore: designStateApi,
   appStore: appStateApi,
@@ -925,6 +1012,24 @@ var DragAndDropApi = class {
   }
 };
 
+// src/utils/syncHtmlDataThemeFromHostContext.ts
+async function syncHtmlDataThemeFromHostContext(kittl2) {
+  if (typeof document === "undefined") {
+    return;
+  }
+  const parent = window.parent;
+  if (!parent || parent === window) {
+    return;
+  }
+  const contextResponse = await kittl2.context.get();
+  if (contextResponse.isOk) {
+    document.documentElement.dataset.theme = contextResponse.result.colorScheme;
+  }
+  await kittl2.context.subscribe((ctx) => {
+    document.documentElement.dataset.theme = ctx.colorScheme;
+  });
+}
+
 // src/index.ts
 var kittl = {
   onLoadedCallback: null,
@@ -952,8 +1057,10 @@ var initSdk = () => {
       handleIncomingMessage(event);
     }
   );
-  kittl.onLoadedCallback?.();
-  sendLoaded();
+  void syncHtmlDataThemeFromHostContext(kittl).then(() => {
+    kittl.onLoadedCallback?.();
+    sendLoaded();
+  });
 };
 if (typeof document !== "undefined" && typeof window !== "undefined") {
   window.kittl = kittl;

package/dist/kittl-sdk.js

@@ -19,6 +19,9 @@
   var isAppStateUpdatePushMessage = (data) => {
     return typeof data === "object" && data !== null && "command" in data && data.command === "app-state-update" && "updates" in data && Array.isArray(data.updates);
   };
+  var isContextUpdatePushMessage = (data) => {
+    return typeof data === "object" && data !== null && "command" in data && data.command === "context-update" && "subscriptionId" in data && typeof data.subscriptionId === "string" && "context" in data && typeof data.context === "object" && data.context !== null;
+  };
 
   // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/shared/createApiProxyCore.js
   var buildMethodPath = (rootPrefix, pathSegments) => {
@@ -193,6 +196,13 @@
       args,
       messageId,
       apiType: "upload"
+    }),
+    data: (dots, args, messageId) => ({
+      command: "sdk-call",
+      dots,
+      args,
+      messageId,
+      apiType: "data"
     })
   };
   function createApiProxy(apiType) {
@@ -211,6 +221,7 @@
 
   // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/apiProxy/aiApiProxy.js
   var generationHandlers = /* @__PURE__ */ new Map();
+  var generationSubscriptions = /* @__PURE__ */ new Map();
   var dispatchAIGenerationUpdate = (subscriptionId, update) => {
     const handler = generationHandlers.get(subscriptionId);
     if (!handler) {
@@ -219,6 +230,20 @@
     void handler(update);
   };
   function createAIApiProxy() {
+    const unregisterGenerationHandler = (generatorId) => {
+      const subscriptionId = generationSubscriptions.get(generatorId);
+      if (!subscriptionId) {
+        return;
+      }
+      generationHandlers.delete(subscriptionId);
+      generationSubscriptions.delete(generatorId);
+      const unregisterMessage = {
+        command: "ai-unregister-handler",
+        generatorId,
+        subscriptionId
+      };
+      postMessageToParent(unregisterMessage);
+    };
     return {
       spendCredits: async (options) => {
         const { onAccept, onDecline, ...serializable } = options;
@@ -248,16 +273,18 @@
         return sendMessage(message);
       },
       registerHandler: async (generatorId, onStatusUpdate) => {
-        const subscriptionId = generateMessageId();
-        const unregister = () => {
-          generationHandlers.delete(subscriptionId);
-          const unregisterMessage = {
-            command: "ai-unregister-handler",
-            subscriptionId
+        if (generationSubscriptions.has(generatorId)) {
+          return {
+            isOk: false,
+            error: {
+              message: `AI handler for generator "${generatorId}" is already registered`,
+              name: "SdkInternalError"
+            }
           };
-          postMessageToParent(unregisterMessage);
-        };
+        }
+        const subscriptionId = generateMessageId();
         generationHandlers.set(subscriptionId, onStatusUpdate);
+        generationSubscriptions.set(generatorId, subscriptionId);
         const registerMessage = {
           command: "ai-register-handler",
           messageId: generateMessageId(),
@@ -268,11 +295,16 @@
           const response = await sendMessage(registerMessage);
           if (!response.isOk) {
             generationHandlers.delete(subscriptionId);
+            generationSubscriptions.delete(generatorId);
             return response;
           }
-          return { isOk: true, result: unregister };
+          return {
+            isOk: true,
+            result: () => unregisterGenerationHandler(generatorId)
+          };
         } catch {
           generationHandlers.delete(subscriptionId);
+          generationSubscriptions.delete(generatorId);
           return {
             isOk: false,
             error: {
@@ -281,6 +313,10 @@
             }
           };
         }
+      },
+      unregisterHandler: async (generatorId) => {
+        unregisterGenerationHandler(generatorId);
+        return { isOk: true, result: void 0 };
       }
     };
   }
@@ -426,8 +462,7 @@
         const message = {
           command: "auth-refresh",
           messageId: generateMessageId(),
-          provider: request.provider,
-          refresh_token: request.refresh_token
+          provider: request.provider
         };
         return sendMessage(message);
       },
@@ -487,6 +522,53 @@
     return buildNode([]);
   };
 
+  // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/context/contextBridge.js
+  var createContextBridgeApi = () => {
+    const contextProxy = createApiProxy("context");
+    const subscriptionCallbacks = /* @__PURE__ */ new Map();
+    const dispatch = (message) => {
+      const cb = subscriptionCallbacks.get(message.subscriptionId);
+      cb?.(message.context);
+    };
+    const subscribeImpl = async (callback) => {
+      const subscriptionId = generateMessageId();
+      const messageId = generateMessageId();
+      subscriptionCallbacks.set(subscriptionId, callback);
+      let response;
+      try {
+        response = await sendMessage({
+          command: "context-subscribe",
+          messageId,
+          subscriptionId
+        });
+      } catch (error) {
+        subscriptionCallbacks.delete(subscriptionId);
+        throw error;
+      }
+      if (!response.isOk) {
+        subscriptionCallbacks.delete(subscriptionId);
+        throw new Error(`context-subscribe failed: ${response.error.message}`);
+      }
+      return () => {
+        subscriptionCallbacks.delete(subscriptionId);
+        const message = {
+          command: "context-unsubscribe",
+          subscriptionId
+        };
+        postMessageToParent(message);
+      };
+    };
+    const api = new Proxy(contextProxy, {
+      get(target, prop, receiver) {
+        if (prop === "subscribe") {
+          return subscribeImpl;
+        }
+        return Reflect.get(target, prop, receiver);
+      }
+    });
+    return { api, dispatch };
+  };
+
   // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/designState/index.js
   var sendUnsubscribe2 = (selectorIds) => {
     const message = {
@@ -608,6 +690,7 @@
   var statelessApi = createStatelessBridgeApi();
   var designStateApi = createDesignStateBridgeApi();
   var appStateApi = createAppStateBridgeApi();
+  var { api: contextApi, dispatch: dispatchContextUpdate } = createContextBridgeApi();
   var handleIncomingMessage = (event) => {
     const parent = window.parent;
     if (!parent || parent === window) {
@@ -642,10 +725,14 @@
       appStateApi.dispatch(data.updates);
       return;
     }
+    if (isContextUpdatePushMessage(data)) {
+      dispatchContextUpdate(data);
+    }
   };
   var bridgeHandlers = {
     ai: createAIApiProxy(),
-    context: createApiProxy("context"),
+    context: contextApi,
+    data: createApiProxy("data"),
     design: createApiProxy("design"),
     designStore: designStateApi,
     appStore: appStateApi,
@@ -926,6 +1013,24 @@
     }
   };
 
+  // src/utils/syncHtmlDataThemeFromHostContext.ts
+  async function syncHtmlDataThemeFromHostContext(kittl2) {
+    if (typeof document === "undefined") {
+      return;
+    }
+    const parent = window.parent;
+    if (!parent || parent === window) {
+      return;
+    }
+    const contextResponse = await kittl2.context.get();
+    if (contextResponse.isOk) {
+      document.documentElement.dataset.theme = contextResponse.result.colorScheme;
+    }
+    await kittl2.context.subscribe((ctx) => {
+      document.documentElement.dataset.theme = ctx.colorScheme;
+    });
+  }
+
   // src/index.ts
   var kittl = {
     onLoadedCallback: null,
@@ -953,8 +1058,10 @@
         handleIncomingMessage(event);
       }
     );
-    kittl.onLoadedCallback?.();
-    sendLoaded();
+    void syncHtmlDataThemeFromHostContext(kittl).then(() => {
+      kittl.onLoadedCallback?.();
+      sendLoaded();
+    });
   };
   if (typeof document !== "undefined" && typeof window !== "undefined") {
     window.kittl = kittl;

package/dist/sdk.d.ts

@@ -14,6 +14,16 @@ declare abstract class KittlStateStore<T extends Record<string, unknown>> {
 	abstract internalPatch(args: InternalPatchArgs<T>): void;
 	abstract resetWithState(state: T): void;
 }
+declare class SdkBadInputError extends Error {
+	readonly name: "SdkBadInputError";
+	readonly cause?: Error;
+	constructor(message: string, cause?: Error);
+}
+declare class SdkInternalError extends Error {
+	readonly name: "SdkInternalError";
+	readonly cause?: Error;
+	constructor(message: string, cause?: Error);
+}
 declare const BASIC_SHAPE_DEFAULT_VALUES: {
 	defaultIcon: LayerIconType | undefined;
 	shadowOptions?: {
@@ -193,6 +203,9 @@ declare const GUIDE_DEFAULT_VALUES: {
 	version: string;
 	type: ObjectType.Guide;
 };
+declare const GenerationOperation: {
+	readonly INPAINT: "inpaint";
+};
 declare const GenerationStatus: {
 	readonly CREATED: "CREATED";
 	readonly STARTED: "STARTED";
@@ -552,6 +565,11 @@ export interface AIGenerationOutputSettings {
 		height: number;
 	};
 }
+export interface AddFontStyleOptions {
+	fontFamilyId: string;
+	objectIds: string[];
+	styles: string[];
+}
 export interface AppStateAPI {
 	getSelectedObjectsIds(): string[];
 	setSelectedObjectsIds(ids: string[]): void;
@@ -567,6 +585,7 @@ export interface AppStateAPI {
 	setCanvasMode(mode: AppState["canvasMode"], origin?: Origin): void;
 	getActiveTool(): ActiveTool | null;
 	setActiveTool(tool: ActiveTool | null): void;
+	getIsDragPanning(): boolean;
 	viewport: ViewportAPI;
 	getHighlightedObjectId(): string | null;
 	setHighlightedObjectId(id: string | null): void;
@@ -576,6 +595,7 @@ export interface AsyncAIAPI {
 	spendCredits: (options: SpendCreditsOptions) => SdkResultAsync<SpendCreditsResult, Error>;
 	startGeneration: (generatorId: string, inputSettings: AIGenerationInputSettings, output: AIGenerationOutputSettings) => SdkResultAsync<StartGenerationResult, Error>;
 	registerHandler: (generatorId: string, onStatusUpdate: OnGenerationStatusUpdate) => SdkResultAsync<() => void, Error>;
+	unregisterHandler: (generatorId: string) => SdkResultAsync<void, Error>;
 }
 export interface AsyncAppStateAPI extends WithAsync<AppStateAPI> {
 }
@@ -617,7 +637,10 @@ export interface AsyncAuthAPI {
 export interface AsyncBatchDesignAPI extends AsyncDesignAPI {
 	commit: () => Promise<void>;
 }
-export interface AsyncContextAPI extends WithAsync<ContextAPI> {
+export interface AsyncContextAPI extends Omit<WithAsync<ContextAPI>, "subscribe"> {
+	subscribe(callback: ContextSubscriptionCallback): Promise<() => void>;
+}
+export interface AsyncDataAPI extends WithAsync<DataSDKApi> {
 }
 export interface AsyncDesignAPI extends WithAsync<WithOptsRemoved<DesignAPI>> {
 }
@@ -676,7 +699,6 @@ export interface AuthLogoutRequest {
 }
 export interface AuthRefreshRequest {
 	provider: string;
-	refresh_token: string;
 }
 export interface AuthStartRequest {
 	provider: string;
@@ -757,15 +779,27 @@ export interface CanvasAPI {
 	getPreviewImage: (id: string, options?: Partial<GetPreviewImageOptions>) => Promise<string | null>;
 	getExport: (options: GetExportOptions) => Promise<Blob | null>;
 }
+export interface CatalogItem {
+	id: string;
+	name: string;
+	previewImages: string[];
+}
 export interface ConfigAPI {
 	setConfig(config: Partial<DesignConfig>, opts?: DesignApiOptions): void;
 }
 export interface ContextAPI {
 	get(input?: ContextGetInput): KittlContext;
+	subscribe(callback: ContextSubscriptionCallback): () => void;
 }
 export interface ContextGetInput {
 	iframe?: Pick<HTMLIFrameElement, "getBoundingClientRect">;
 }
+export interface CreateFontOptions {
+	name: string;
+	files: Blob[];
+	styles: string[];
+	previewImage?: Blob;
+}
 export interface CreateLoadingCardInput extends CreateElementWithPositionAndSize {
 	imageGenerationId?: string;
 	startedAt?: number;
@@ -773,6 +807,10 @@ export interface CreateLoadingCardInput extends CreateElementWithPositionAndSize
 	generationAverageSpeed?: number;
 	name?: string;
 }
+export interface DataSDKApi {
+	mockups: MockupDataAPI;
+	fonts: FontDataAPI;
+}
 export interface DecorationOptions {
 	type: "horizontalLines" | "colorCut" | "obliqueLines" | "fadingColorCut";
 	color: string | null;
@@ -780,6 +818,10 @@ export interface DecorationOptions {
 	distance: number;
 	cutDistance: number;
 }
+export interface DeleteFontStyleOptions {
+	fontFamilyId: string;
+	id: string;
+}
 export interface DesignAPI {
 	shape: ShapeAPI;
 	board: BoardAPI;
@@ -837,17 +879,42 @@ export interface DragAndDropStartDragImageEventInput {
 export interface ErrorGenerationResult {
 	type: typeof ResultType.ERROR;
 	message: string;
-	code?: string;
+	subtitle: string;
+	status: "warning" | "error";
 }
 export interface FontAPI {
 	createFont: (params: {
 		name: string;
 		files: Blob[];
 		styles: string[];
-		extensionId?: string;
 		previewImage?: Blob;
 	}) => SdkResultAsync<UploadedFontFamily, Error>;
 }
+export interface FontDataAPI {
+	listUserFonts(options?: PaginationOptions): SdkResultAsync<FontListDto>;
+	listExtensionFonts(options?: PaginationOptions): SdkResultAsync<FontListDto>;
+	get(fontFamilyId: string): SdkResultAsync<FontFamilyDto>;
+	find(ids: string[]): SdkResultAsync<FontFamilyDto[]>;
+	create(options: CreateFontOptions): SdkResultAsync<FontFamilyDto>;
+	update(options: UpdateFontFamilyOptions): SdkResultAsync<FontFamilyDto>;
+	delete(ids: string[]): SdkResultAsync<void>;
+	destroy(ids: string[]): SdkResultAsync<void>;
+	addStyle(options: AddFontStyleOptions): SdkResultAsync<FontFamilyDto>;
+	deleteStyle(options: DeleteFontStyleOptions): SdkResultAsync<void>;
+	updateStyle(options: UpdateFontStyleOptions): SdkResultAsync<void>;
+}
+export interface FontFamilyDto extends CatalogItem {
+	styles: FontStyleDto[];
+	extension: {
+		id: string;
+		name?: string;
+	} | null;
+}
+export interface FontStyleDto {
+	id: string;
+	name: string;
+	style: string | null;
+}
 export interface FontVariation {
 	name: string;
 	min: number;
@@ -876,6 +943,7 @@ export interface GenerationInputData {
 export interface GenerationMeta {
 	generationEndsAt?: number;
 	pendingGenerationId: string;
+	operation?: GenerationOperation;
 }
 export interface GenerationStartedResultCommonProps {
 	generationEndsAt?: number;
@@ -897,7 +965,16 @@ export interface GetExportOptions {
 			height: number;
 		};
 	};
+	size?: {
+		width: number;
+		height: number;
+		unit: Unit;
+	};
+	dpi?: number;
+	colorModel?: "rgb" | "cmyk";
 	removeArtboardBackground?: boolean;
+	optimizedQuality?: boolean;
+	renderingIntent?: "download" | "pdf";
 }
 export interface GetObjectParams {
 	id: string;
@@ -958,6 +1035,9 @@ export interface IllustrationAPI {
 export interface ImageAPI {
 	addImage(params: AddImageParams, opts?: DesignApiOptions): SdkResultAsync<NormalizedIllustrationImageObject, SdkError>;
 	updateImage(params: UpdateImageParams, opts?: DesignApiOptions): NormalizedIllustrationImageObject;
+	updateImageSource(params: UpdateImageSourceParams, opts?: DesignApiOptions): SdkResultAsync<NormalizedIllustrationImageObject, SdkError>;
+	resetImageCrop(params: ResetImageCropParams, opts?: DesignApiOptions): SdkResultAsync<NormalizedIllustrationImageObject, SdkError>;
+	resetImageBackgroundRemoval(params: ResetImageBackgroundRemovalParams, opts?: DesignApiOptions): SdkResultAsync<NormalizedIllustrationImageObject, SdkError>;
 }
 export interface ImageGenerationResult {
 	type: typeof ResultType.IMAGE;
@@ -977,6 +1057,7 @@ export interface KittlSDK {
 	onLoadedCallback: (() => void) | null;
 	onReady: (cb: () => void) => void;
 	ai: AsyncAIAPI;
+	data: AsyncDataAPI;
 	design: AsyncDesignAPI;
 	designStore: AsyncDesignStateAPI;
 	appStore: AsyncAppStateSubscriptionAPI;
@@ -1005,6 +1086,33 @@ export interface LoadingCardAPI {
 	createLoadingCard(input: CreateLoadingCardInput, opts?: DesignApiOptions): NormalizedLoadingCardObject;
 	updateLoadingCard(input: UpdateLoadingCardInput, opts?: DesignApiOptions): NormalizedLoadingCardObject;
 }
+export interface MockupDataAPI {
+	get(id: number): SdkResultAsync<CatalogItem>;
+	getOverview(options?: Pick<PaginationOptions, "sort">): SdkResultAsync<MockupOverviewDto>;
+	getGroup(groupId: string, options?: PaginationOptions): SdkResultAsync<MockupGroupDto>;
+	search(query: string, options?: PaginationOptions): SdkResultAsync<PaginatedResult<CatalogItem>>;
+	getSuggestions(): SdkResultAsync<MockupSuggestions>;
+}
+export interface MockupGroupDto {
+	group: {
+		id: string;
+		name: string;
+	};
+	data: PaginatedResult<CatalogItem>;
+}
+export interface MockupOverviewDto {
+	overview: MockupOverviewGroupDto[];
+}
+export interface MockupOverviewGroupDto {
+	id: string;
+	name: string;
+	mockups: CatalogItem[];
+	total: number;
+}
+export interface MockupSuggestions {
+	tags: string[];
+	groups: string[];
+}
 export interface MockupboardAPI {
 	addMockupBoard(params: AddMockupBoardParams, opts?: DesignApiOptions): NormalizedStandardBoard<MockupBoardOptions>;
 	addMockupDesignObject(params: AddMockupDesignObjectParams, opts?: DesignApiOptions): NormalizedMockupDesignObject;
@@ -1024,6 +1132,17 @@ export interface ObjectAPI {
 		id: string;
 	};
 }
+export interface PaginatedResult<T> {
+	items: T[];
+	total?: number;
+	hasMore: boolean;
+}
+export interface PaginationOptions {
+	take?: number;
+	skip?: number;
+	sort?: string;
+	cursor?: string;
+}
 export interface PhotoFilterOptions {
 	[ImageFilterType.Saturation]: {
 		saturation: number;
@@ -1093,16 +1212,6 @@ export interface RotateObjectParams {
 		y: OriginY;
 	};
 }
-export interface SdkBadInputError extends Error {
-	name: "SdkBadInputError";
-	message: string;
-	cause?: Error;
-}
-export interface SdkInternalError extends Error {
-	name: "SdkInternalError";
-	message: string;
-	cause?: Error;
-}
 export interface SetHiddenParams {
 	id: string;
 	hidden: boolean;
@@ -1183,6 +1292,15 @@ export interface TransformOptions {
 	curve?: number;
 	isChanging?: boolean;
 }
+export interface UpdateFontFamilyOptions {
+	id: string;
+	name: string;
+}
+export interface UpdateFontStyleOptions {
+	fontFamilyId: string;
+	id: string;
+	style: string;
+}
 export interface UpdateGuideInput {
 	id: string;
 	top?: number;
@@ -1202,9 +1320,8 @@ export interface UploadAPI {
 	image: UploadImageAPI;
 }
 export interface UploadImageAPI {
-	upload: ({ blob, extensionId, }: {
+	upload: ({ blob, }: {
 		blob: Blob;
-		extensionId?: string;
 	}) => SdkResultAsync<UserImageUpload[], Error>;
 	uploadTemp: ({ blob, }: {
 		blob: Blob;
@@ -1251,7 +1368,7 @@ export interface WithObjectLayout {
 	flipX: boolean;
 	flipY: boolean;
 }
-export type AIGenerationActionOrigin = "COPILOT" | "RIGHT_PANEL" | "LEFT_PANEL" | "MICRO_APP" | "IMAGE_SETS" | "AI_CHAT" | "SMARTBOARD" | "AI_INPUT_GENERATE_IMAGE" | "AI_INPUT_REMIX_IMAGE" | "AI_INPUT_GENERATE_VIDEO" | "AI_HUB_GENERATE_IMAGE" | "AI_HUB_REMIX_IMAGE" | "AI_HUB_GENERATE_VIDEO" | "VIDEOBOARD";
+export type AIGenerationActionOrigin = "COPILOT" | "RIGHT_PANEL" | "LEFT_PANEL" | "MICRO_APP" | "IMAGE_SETS" | "AI_CHAT" | "SMARTBOARD" | "AI_INPUT_GENERATE_IMAGE" | "AI_INPUT_REMIX_IMAGE" | "AI_INPUT_GENERATE_VIDEO" | "AI_HUB_GENERATE_IMAGE" | "AI_HUB_REMIX_IMAGE" | "AI_HUB_GENERATE_VIDEO" | "VIDEOBOARD" | "AGENT" | "WORKFLOW";
 export type AIGenerationContentType = "image" | "video";
 export type AIGenerationModelTaskType = "IMAGE_TO_IMAGE" | "IMAGE_INPAINT" | "TEXT_TO_IMAGE" | "IMAGE_TO_VIDEO";
 export type APIOptions<T extends Record<string, unknown>> = {
@@ -1267,6 +1384,8 @@ export type ActiveTool = {
 	type: "artboard";
 } | {
 	type: "move";
+} | {
+	type: "hand";
 } | {
 	type: "pen";
 } | {
@@ -1349,6 +1468,7 @@ export type AppState = {
 	canvasMode: CanvasMode | string;
 	activeTool: ActiveTool | null;
 	viewport: Viewport;
+	isDragPanning: boolean;
 	highlightedObjectId: string | null;
 };
 /**
@@ -1409,6 +1529,7 @@ export type CombinedShapeSerializedObject = Omit<typeof DEFAULT_VALUES, "shapes"
 export type ConnectedArtboardOptions<T extends ArtboardLikeType = ArtboardLikeType> = BaseStandardArtboardOptions<T> & {
 	inputBoardIds?: string[];
 };
+export type ContextSubscriptionCallback = (context: KittlContext) => void;
 export type ConvertShapeToMaskInput = {
 	id: NormalizedBasicShapeObject["id"];
 };
@@ -1487,8 +1608,8 @@ export type Expand<T> = T extends infer O ? {
 } : never;
 export type FillMetaTarget = "border" | "fill";
 export type FlattenUnion<T> = UnionToIntersection<T extends unknown ? Partial<T> : never>;
-export type FontVariationAxis = OrAnyString<"wght" | "wdth" | "slnt" | "ital" | "opsz" | "GRAD">;
-export type FontVariationSettings = Partial<Record<FontVariationAxis, number>>;
+export type FontListDto = PaginatedResult<FontFamilyDto>;
+export type FontVariationSettings = Record<string, number> & Partial<Record<KnownFontVariationAxis, number>>;
 export type FontWeight = OrAnyString<"Regular" | "Bold" | "Light" | "Medium" | "Black" | "SemiBold" | "Italic" | "ExtraLight" | "Thin" | "ExtraBold" | "LightItalic" | "MediumItalic" | "SemiBoldItalic" | "BlackItalic" | "ExtraBoldItalic" | "ThinItalic" | "ExtraLightItalic" | "BoldItalic">;
 export type FullColor = {
 	key: "fill" | (Exclude<string, StringColorKeysType> & {});
@@ -1496,6 +1617,7 @@ export type FullColor = {
 	visible: boolean;
 };
 export type FunctionType = (...args: never) => unknown;
+export type GenerationOperation = (typeof GenerationOperation)[keyof typeof GenerationOperation];
 export type GenerationStatus = (typeof GenerationStatus)[keyof typeof GenerationStatus];
 export type GenerationStatusUpdate = {
 	generationId: string;
@@ -1544,6 +1666,7 @@ export type IllustrationProperties = {
 	strokeWidth?: IllustrationSerializedObject["strokeWidth"];
 	fill?: IllustrationSerializedObject["fill"];
 	gradients?: IllustrationSerializedObject["gradients"];
+	generation?: IllustrationSerializedObject["generation"];
 };
 export type IllustrationSerializedObject = typeof ILLUSTRATION_DEFAULT_VALUES;
 export type ImageProperties = {
@@ -1563,6 +1686,7 @@ export type InternalPatchArgs<T> = {
 	historyOrigin?: HistoryOrigins;
 	transactionMeta?: TransactionMeta;
 };
+export type KnownFontVariationAxis = "wght" | "wdth" | "slnt" | "ital" | "opsz" | "GRAD";
 export type LayerIconType = "drawIcon";
 export type LayerType = Exclude<SerializableObjectType, ObjectType.Guide> | typeof structuralGroupType | typeof clippingMaskType | typeof backgroundType | typeof pathType;
 export type LayersMovePosition = "before" | "after" | "into";
@@ -1773,6 +1897,12 @@ export type RenameParams = {
 	objectId: string;
 	newName: string;
 };
+export type ResetImageBackgroundRemovalParams = {
+	id: IllustrationImageSerializedObject["id"];
+};
+export type ResetImageCropParams = {
+	id: IllustrationImageSerializedObject["id"];
+};
 export type ResultType = (typeof ResultType)[keyof typeof ResultType];
 export type RichTextBasePluginSerializedObject = {
 	id: string;
@@ -1987,8 +2117,9 @@ export type TextProperties = {
 	fontFamily?: string;
 	fontSize?: number;
 	fontWeight?: string;
+	fontVariationSettings?: FontVariationSettings;
 	fill?: Color;
-	textAlign?: "left" | "center" | "right" | "justify";
+	textAlign?: TextAlign;
 	lineHeightValue?: LineHeight;
 	resizeBehavior?: "none" | "hug" | "hug-height";
 	charSpacing?: number;
@@ -1998,7 +2129,7 @@ export type TextProperties = {
 	angle?: number;
 	scaleX?: number;
 	scaleY?: number;
-	stroke?: string;
+	stroke?: string | null;
 	strokeWidth?: number;
 };
 export type TransactionMeta = {
@@ -2052,6 +2183,12 @@ export type UpdateImageParams = {
 	stroke?: IllustrationImageSerializedObject["stroke"];
 	strokeWidth?: IllustrationImageSerializedObject["strokeWidth"];
 } & GeneratableObject;
+export type UpdateImageSourceParams = {
+	id: IllustrationImageSerializedObject["id"];
+	objectName: IllustrationImageSerializedObject["objectName"];
+	keepObjectDimensions?: boolean;
+	flatten?: boolean;
+};
 export type UpdateMockupBoardParams = {
 	mockupBoardId: string;
 	size?: Dimensions;
@@ -2100,7 +2237,6 @@ export type UpdateVideoPlaylistItemParams = {
 	videoId: string;
 	playlistItemId: string;
 	playlistItem: Omit<VideoPlaylistItem, "id">;
-	allowAspectRatioMismatch?: boolean;
 };
 export type UpdateVideoboardParams = {
 	videoBoardId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kittl/sdk",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "license": "Apache-2.0",
   "private": false,
   "type": "module",