@kittl/sdk 0.0.7 → 0.0.9

package/dist/sdk.d.ts

@@ -10,9 +10,9 @@ declare abstract class KittlStateStore<T extends Record<string, unknown>> {
 	abstract subscribe<U>(selector: Selector<T, U>, callback: (selected: U, meta: {
 		patch: PatchTree<T>[];
 		senderOrigin: Origin;
-	}) => void, subscriberOrigin?: Origin): () => void;
+	}) => void, subscriberOrigin?: Origin, options?: SubscribeOptions): () => void;
 	abstract internalPatch(args: InternalPatchArgs<T>): void;
-	abstract resetWithState(state: T): void;
+	abstract resetWithState(state: T, origin?: Origin): void;
 }
 declare class SdkBadInputError extends Error {
 	readonly name: "SdkBadInputError";
@@ -32,7 +32,6 @@ declare const BASIC_SHAPE_DEFAULT_VALUES: {
 		offset?: number;
 		angle?: number;
 	};
-	presets?: LinkedPreset[] | undefined;
 	gradients?: StateGradientInfo | undefined;
 	clipPathMaskId?: string | undefined | null;
 	childrenInfo?: {
@@ -86,7 +85,6 @@ declare const DEFAULT_VALUES$1: {
 		offset?: number;
 		angle?: number;
 	};
-	presets?: LinkedPreset[] | undefined;
 	opacity?: number | undefined;
 	objectName: string;
 	width: number;
@@ -119,7 +117,8 @@ declare const DEFAULT_VALUES$1: {
 	generation?: {
 		meta?: GenerationMeta;
 		generationId?: string;
-		generatorKey: string;
+		aiArtId?: string;
+		generatorKey?: string;
 	};
 };
 declare const DEFAULT_VALUES$2: {
@@ -173,7 +172,6 @@ declare const DEFAULT_VALUES: {
 		angle?: number;
 	};
 	gradients?: StateGradientInfo | undefined;
-	presets?: LinkedPreset[] | undefined;
 	opacity?: number | undefined;
 	hiddenColors?: Record<string, NonNullable<Color>> | undefined;
 	stroke?: string | null;
@@ -198,19 +196,25 @@ declare const DEFAULT_VALUES: {
 	version: string;
 	type: ObjectType.CombinedShape;
 };
+declare const EXPORT_MIME_TYPES: {
+	readonly jpeg: "image/jpeg";
+	readonly mp4: "video/mp4";
+	readonly pdf: "application/pdf";
+	readonly png: "image/png";
+	readonly svg: "image/svg+xml";
+};
 declare const GUIDE_DEFAULT_VALUES: {
 	id: DesignObjectId;
 	version: string;
 	type: ObjectType.Guide;
 };
-declare const GenerationOperation: {
-	readonly INPAINT: "inpaint";
-};
 declare const GenerationStatus: {
 	readonly CREATED: "CREATED";
+	readonly QUEUED: "QUEUED";
 	readonly STARTED: "STARTED";
 	readonly COMPLETE: "COMPLETE";
 	readonly FAILED: "FAILED";
+	readonly CANCELLED: "CANCELLED";
 };
 declare const ILLUSTRATION_DEFAULT_VALUES: {
 	hiddenColors?: Record<string, NonNullable<Color>> | undefined;
@@ -221,7 +225,8 @@ declare const ILLUSTRATION_DEFAULT_VALUES: {
 	generation?: {
 		meta?: GenerationMeta;
 		generationId?: string;
-		generatorKey: string;
+		aiArtId?: string;
+		generatorKey?: string;
 	};
 	childrenInfo?: {
 		objectName?: string;
@@ -237,7 +242,6 @@ declare const ILLUSTRATION_DEFAULT_VALUES: {
 		angle?: number;
 	};
 	gradients?: StateGradientInfo | undefined;
-	presets?: LinkedPreset[] | undefined;
 	opacity?: number | undefined;
 	stroke?: string | null;
 	strokeWidth?: number;
@@ -325,7 +329,6 @@ declare const PATH_TEXT_DEFAULT_VALUES: {
 	useLigatures: boolean;
 	strokeWidth?: number;
 	fill?: Color | undefined;
-	presets?: LinkedPreset[] | undefined;
 	opacity?: number | undefined;
 	locked?: boolean | undefined;
 	hidden?: boolean | undefined;
@@ -344,8 +347,17 @@ declare const PATH_TEXT_DEFAULT_VALUES: {
 	version: string;
 	type: ObjectType.PathText;
 };
+declare const PendingOperation: {
+	readonly GENERATE: "generate";
+	readonly INPAINT: "inpaint";
+	readonly ERASE_AND_FILL: "eraseAndFill";
+	readonly VECTORIZE: "vectorize";
+	readonly LAYERIZE: "layerize";
+	readonly UPSCALE: "upscale";
+	readonly REMOVE_BACKGROUND: "removeBackground";
+	readonly REFRAME: "reframe";
+};
 declare const RICH_TEXT_DEFAULT_VALUES: {
-	presets?: LinkedPreset[] | undefined;
 	opacity?: number | undefined;
 	stroke?: string | null;
 	strokeWidth?: number;
@@ -372,6 +384,17 @@ declare const ResultType: {
 	readonly IMAGE: "image";
 	readonly ERROR: "error";
 };
+declare const UploadType: {
+	readonly EXTENSION: "EXTENSION";
+	readonly AI_GENERATED: "AI_GENERATED";
+	readonly AI_GENERATED_SETS: "AI_GENERATED_SETS";
+	readonly AI_UPSCALED: "AI_UPSCALED";
+	readonly AI_EDITED: "AI_EDITED";
+	readonly MOCKUP: "MOCKUP";
+	readonly CLIPPED: "CLIPPED";
+	readonly BRAND_KIT: "BRAND_KIT";
+	readonly QUICK_EDIT: "QUICK_EDIT";
+};
 declare const backgroundType = "background";
 declare const clippingMaskType = "clippingMask";
 declare const pathType = "path";
@@ -464,26 +487,20 @@ declare enum HistoryOrigins {
 	Untracked = "untracked:origin"
 }
 declare enum ImageFilterType {
-	"Saturation" = "Saturation",
-	"Contrast" = "Contrast",
-	"Brightness" = "Brightness",
-	"Vibrance" = "Vibrance",
-	"HueRotation" = "HueRotation",
-	"Noise" = "Noise",
-	"Blur" = "Blur",
-	"Convolute" = "Convolute",
-	"Pixelate" = "Pixelate",
-	"RemoveColor" = "RemoveColor"
-}
-declare enum LibraryPresetType {
-	FILL = "FILL",
-	TRANSFORMATION = "TRANSFORMATION",
-	PHOTO_FILTER = "PHOTO_FILTER",
-	SHADOW = "SHADOW",
-	TEXT = "TEXT",
-	TEXT_EFFECT = "TEXT_EFFECT",
-	TEXT_DECORATION = "TEXT_DECORATION",
-	COLOR_PALETTE = "COLOR_PALETTE"
+	Saturation = "Saturation",
+	Contrast = "Contrast",
+	Brightness = "Brightness",
+	Vibrance = "Vibrance",
+	HueRotation = "HueRotation",
+	Noise = "Noise",
+	Blur = "Blur",
+	Convolute = "Convolute",
+	Pixelate = "Pixelate",
+	RemoveColor = "RemoveColor"
+}
+declare enum InpaintingSelectionMode {
+	ADD = "add",
+	SUBTRACT = "subtract"
 }
 declare enum ObjectType {
 	Artboard = "artboard",
@@ -503,7 +520,6 @@ declare enum ObjectType {
 	LoadingCard = "loadingCard",
 	MockupDesign = "mockupDesign",
 	ActiveSelection = "activeSelection",
-	WarpedImage = "warpedImage",
 	ArtboardTitle = "artboardTitle",
 	ArtboardTitleIcon = "artboardTitleIcon",
 	OverlayTexture = "overlayTexture",
@@ -526,7 +542,8 @@ declare enum Origin {
 	UI = 4,
 	VOLATILE = 8,
 	EVENTS_SYNC = 16,
-	API = 32
+	API = 32,
+	UNDO_REDO = 64
 }
 declare enum TextAlignment {
 	right = "right",
@@ -551,12 +568,13 @@ export interface AIGenerationInputSettings {
 	prompt: string;
 	taskType?: AIGenerationModelTaskType;
 	promptStyleId?: number;
-	model: {
+	model?: {
 		id: string;
 	};
 	additionalParams?: Record<string, unknown>;
 	actionOrigin?: AIGenerationActionOrigin;
 	type: AIGenerationContentType;
+	referenceImageMode?: AIGenerationReferenceImageMode;
 }
 export interface AIGenerationOutputSettings {
 	id?: string;
@@ -567,12 +585,12 @@ export interface AIGenerationOutputSettings {
 }
 export interface AddFontStyleOptions {
 	fontFamilyId: string;
-	objectIds: string[];
+	files: Blob[];
 	styles: string[];
 }
 export interface AppStateAPI {
 	getSelectedObjectsIds(): string[];
-	setSelectedObjectsIds(ids: string[]): void;
+	setSelectedObjectsIds(ids: string[], origin?: Origin): void;
 	getSelectedLayersIds(): string[];
 	setSelectedLayersIds(ids: string[]): void;
 	getSelectedArtboardIds(): string[];
@@ -581,15 +599,31 @@ export interface AppStateAPI {
 	setSelectedArtboardsObjectIds(ids: string[]): void;
 	getAllSelectedObjectsIds(): string[];
 	setAllSelectedObjectsIds(ids: string[]): void;
-	getCanvasMode(): AppState["canvasMode"];
-	setCanvasMode(mode: AppState["canvasMode"], origin?: Origin): void;
-	getActiveTool(): ActiveTool | null;
-	setActiveTool(tool: ActiveTool | null): void;
+	getCanvasMode(): CanvasModeKind | string;
+	getCanvasModeTargetId(): string | null;
+	setCanvasMode(mode: CanvasModeKind | string, origin?: Origin): void;
+	setCanvasModeWithTarget(mode: CanvasModeKind, options?: SetCanvasModeWithTargetOptions): void;
+	setCustomCanvasMode<const Id extends string>(params: SetCustomCanvasModeParams<Id>, origin?: Origin): void;
+	getActiveTool(): ActiveTool;
+	setActiveTool(tool: ActiveTool, origin?: Origin): void;
 	getIsDragPanning(): boolean;
 	viewport: ViewportAPI;
 	getHighlightedObjectId(): string | null;
 	setHighlightedObjectId(id: string | null): void;
-	setMany(fields: Partial<AppState>, origin?: Origin): void;
+	setMany(fields: Partial<AppStateWithoutModes>, origin?: Origin): void;
+	getIsViewOnlyMode(): boolean;
+	setIsViewOnlyMode(isViewOnlyMode: boolean): void;
+	setCanvasSettings: (settings: Partial<SettingsType>) => void;
+	getCanvasSettings(): SettingsType;
+	getPenToolSetting(): AppState["penToolSetting"];
+	setPenToolSetting(setting: Partial<AppState["penToolSetting"]>): void;
+	getOutlineLoading(): AppState["outlineLoading"];
+	setOutlineLoading(id: string, loading: boolean): void;
+	isObjectLoading(id: string): boolean;
+	getPendingOperations(): AppState["pendingOperations"];
+	isOperationPending(id: string, operation?: PendingOperation): boolean;
+	setPendingOperation(id: string, operation: PendingOperation, origin?: Origin): void;
+	clearPendingOperation(id: string, operation: PendingOperation, origin?: Origin): void;
 }
 export interface AsyncAIAPI {
 	spendCredits: (options: SpendCreditsOptions) => SdkResultAsync<SpendCreditsResult, Error>;
@@ -598,29 +632,9 @@ export interface AsyncAIAPI {
 	unregisterHandler: (generatorId: string) => SdkResultAsync<void, Error>;
 }
 export interface AsyncAppStateAPI extends WithAsync<AppStateAPI> {
+	setCustomCanvasMode<const Id extends string>(params: SetCustomCanvasModeParams<Id>, origin?: Origin): Promise<BridgedSdkResult<void>>;
 }
 export interface AsyncAppStateSubscriptionAPI {
-	/**
-	 * Subscribe to one or more paths in the app state.
-	 * Each path is a dot-separated string like `'selectedObjectsIds'`.
-	 * The callback receives the current value at each path as positional
-	 * arguments whenever any subscribed value changes.
-	 * Returns a single unsubscribe function that tears down all subscriptions.
-	 *
-	 * @example
-	 * // Single path
-	 * const unsub = await kittl.appStore.subscribe(
-	 *   ['selectedObjectsIds'],
-	 *   (ids) => console.log('selection changed:', ids)
-	 * );
-	 *
-	 * // Multiple paths
-	 * const unsub = await kittl.appStore.subscribe(
-	 *   ['selectedObjectsIds', 'activeTool'],
-	 *   (ids, tool) => console.log('changed:', ids, tool)
-	 * );
-	 * unsub();
-	 */
 	subscribe<T extends readonly AppStateSelectorPath[]>(paths: [
 		...T
 	], callback: (...values: {
@@ -641,38 +655,20 @@ export interface AsyncBatchDesignAPI extends AsyncDesignAPI {
 export interface AsyncContextAPI extends Omit<WithAsync<ContextAPI>, "subscribe"> {
 	subscribe(callback: ContextSubscriptionCallback): Promise<() => void>;
 }
-export interface AsyncDataAPI extends WithAsync<DataSDKApi> {
+export interface AsyncDataAPI extends WithAsync<DataAPI> {
 }
 export interface AsyncDesignAPI extends WithAsync<WithOptsRemoved<DesignAPI>> {
 }
 export interface AsyncDesignStateAPI {
-	/**
-	 * Subscribe to one or more paths in the design state.
-	 * Each path is a dot-separated string like `'objects.id1.width'`.
-	 * The callback receives the current value at each path as positional
-	 * arguments whenever any subscribed value changes.
-	 * Returns a single unsubscribe function that tears down all subscriptions.
-	 *
-	 * @example
-	 * // Single path
-	 * const unsub = await kittl.designStore.subscribe(
-	 *   ['objects.id1.width'],
-	 *   (width) => console.log('width changed:', width)
-	 * );
-	 *
-	 * // Multiple paths
-	 * const unsub = await kittl.designStore.subscribe(
-	 *   ['objects.id1.width', 'objects.id1.height'],
-	 *   (width, height) => console.log('changed:', width, height)
-	 * );
-	 * unsub();
-	 */
 	subscribe<T extends readonly DesignStateSelectorPath[]>(paths: [
 		...T
 	], callback: (...values: {
 		[K in keyof T]: T[K] extends string ? DeepValue<SelectorState, T[K]> | undefined : unknown;
 	}) => void): Promise<() => void>;
 }
+export interface AsyncExportAPI extends Omit<WithAsync<ExportAPI>, "showExportModal"> {
+	showExportModal<Mime extends ExportMimeType>(request: ExportRequest<Mime>): Promise<BridgedSdkResult<ExportResult>>;
+}
 export interface AsyncFontAPI extends WithAsync<FontAPI> {
 }
 export interface AsyncStatelessAPI {
@@ -710,9 +706,6 @@ export interface AuthStartResult {
 	code: string;
 	code_verifier?: string;
 }
-/**
- * Token response returned by the token endpoint (code exchange or refresh).
- */
 export interface AuthTokenResponse {
 	access_token?: string;
 	refresh_token?: string;
@@ -742,8 +735,8 @@ export interface BaseStandardArtboardOptions<T extends ArtboardLikeType = Artboa
 	lockMovementX?: boolean;
 	lockMovementY?: boolean;
 	activeLayout: BoardLayout;
-	left?: number;
-	top?: number;
+	left: number;
+	top: number;
 	width: number;
 	height: number;
 	fill: string | GradientObject | undefined | null;
@@ -753,7 +746,6 @@ export interface BaseStandardArtboardOptions<T extends ArtboardLikeType = Artboa
 	dpi?: number;
 	fullSize?: boolean;
 	clip?: boolean;
-	presets?: LinkedPreset[];
 	printMargins?: PrintMargins;
 	scaleX?: number;
 	scaleY?: number;
@@ -764,12 +756,15 @@ export interface BaseStandardBoard<T extends ArtboardOptions = ArtboardOptions>
 	title?: string;
 	texture?: TextureOptions;
 	backgroundImage?: BackgroundImageOptions;
+	originTemplateId?: string;
 }
 export interface BoardAPI {
 	createStandardBoard(params: CreateBoardParams, opts?: DesignApiOptions): NormalizedBoard;
 	cloneArtboard(params: CloneArtboardParams, opts?: DesignApiOptions): NormalizedBoard;
 	updateArtboardBackground(params: UpdateArtboardBackgroundParams, opts?: DesignApiOptions): NormalizedBoard;
 	updateArtboard(params: UpdateArtboardParams, opts?: DesignApiOptions): NormalizedBoard;
+	connectBoards(params: ConnectBoardsParams, opts?: DesignApiOptions): void;
+	disconnectBoards(params: DisconnectBoardsParams, opts?: DesignApiOptions): void;
 }
 export interface CanvasAPI {
 	getScreenshot(): Promise<{
@@ -808,7 +803,9 @@ export interface CreateLoadingCardInput extends CreateElementWithPositionAndSize
 	generationAverageSpeed?: number;
 	name?: string;
 }
-export interface DataSDKApi {
+export interface CustomCanvasModeStateById {
+}
+export interface DataAPI {
 	mockups: MockupDataAPI;
 	fonts: FontDataAPI;
 }
@@ -842,8 +839,13 @@ export interface DesignAPI {
 	layers: LayersAPI;
 	group: GroupAPI;
 	texture: TextureAPI;
+	placement: PlacementAPI;
 }
 export interface DesignConfig {
+	microEditor?: {
+		mainObjectId?: DesignObjectId;
+		layerized?: boolean;
+	};
 	title?: string;
 	dpiVersion?: number;
 	designId?: string;
@@ -882,9 +884,11 @@ export interface ErrorGenerationResult {
 	message: string;
 	subtitle: string;
 	status: "warning" | "error";
+	isRecognized?: boolean;
+	errorKey?: string;
 }
 export interface FileBrowserAPI {
-	registerUploadBrowser: (tab: FileBrowserTab) => Promise<SdkResponse<void>>;
+	registerUploadBrowser: (tab: Omit<FileBrowserTab, "onEvent">) => Promise<SdkResponse<void>>;
 }
 export interface FontAPI {
 	createFont: (params: {
@@ -934,7 +938,8 @@ export interface GeneratableObject {
 	generation?: {
 		meta?: GenerationMeta;
 		generationId?: string;
-		generatorKey: string;
+		aiArtId?: string;
+		generatorKey?: string;
 	};
 }
 export interface GenerationCreditUse {
@@ -952,11 +957,15 @@ export interface GenerationInputData {
 }
 export interface GenerationMeta {
 	generationEndsAt?: number;
+	generationStartedAt?: number;
 	pendingGenerationId: string;
-	operation?: GenerationOperation;
+	pendingGeneratorKey?: string;
+	operation?: PendingOperation;
 }
 export interface GenerationStartedResultCommonProps {
 	generationEndsAt?: number;
+	generationStartedAt?: number;
+	scheduledStartAt?: number;
 }
 export interface GetExportOptions {
 	format: "png" | "jpg" | "pdf" | "svg" | "mp4";
@@ -991,6 +1000,8 @@ export interface GetObjectParams {
 }
 export interface GetPreviewImageOptions {
 	targetPixelCount: number;
+	format: "png" | "jpg";
+	quality: number;
 }
 export interface GradientColorStop {
 	color: string | null;
@@ -1039,13 +1050,18 @@ export interface GuideAPI {
 	updateGuide(input: UpdateGuideInput, opts?: DesignApiOptions): NormalizedGuideObject;
 }
 export interface IllustrationAPI {
-	addIllustration(params: AddIllustrationParams, opts?: DesignApiOptions): Promise<NormalizedIllustrationObject>;
-	updateIllustration(params: UpdateIllustrationParams, opts?: DesignApiOptions): NormalizedIllustrationObject;
+	getPaths: (params: GetIllustrationPathsParams) => SdkResultAsync<IllustrationSerializedChildren, SdkError>;
+	renamePath: (params: RenameIllustrationPathParams, opts?: DesignApiOptions) => SdkResultAsync<void, SdkError>;
+	removePaths: (params: RemoveIllustrationPathParams, opts?: DesignApiOptions) => SdkResultAsync<void, SdkError>;
+	togglePathLocked: (params: ToggleLockIllustrationPathParams, opts?: DesignApiOptions) => SdkResultAsync<void, SdkError>;
+	togglePathHidden: (params: ToggleHideIllustrationPathParams, opts?: DesignApiOptions) => SdkResultAsync<void, SdkError>;
+	addIllustration(params: AddIllustrationParams, opts?: DesignApiOptions): Promise<AddedIllustration>;
+	updateIllustration(params: UpdateIllustrationParams, opts?: UpdateObjectApiOptions): NormalizedIllustrationObject;
 }
 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>;
+	updateImage(params: UpdateImageParams, opts?: UpdateObjectApiOptions): NormalizedIllustrationImageObject;
+	updateImageSource(params: UpdateImageSourceParams, opts?: UpdateObjectApiOptions): SdkResultAsync<NormalizedIllustrationImageObject, SdkError>;
 	resetImageCrop(params: ResetImageCropParams, opts?: DesignApiOptions): SdkResultAsync<NormalizedIllustrationImageObject, SdkError>;
 	resetImageBackgroundRemoval(params: ResetImageBackgroundRemovalParams, opts?: DesignApiOptions): SdkResultAsync<NormalizedIllustrationImageObject, SdkError>;
 }
@@ -1056,19 +1072,27 @@ export interface ImageGenerationResult {
 export interface ImageGenerationStartedResult extends GenerationStartedResultCommonProps {
 	type: typeof ResultType.IMAGE;
 }
+export interface ImageUploadAPI {
+	upload: (params: {
+		blob: Blob;
+	}) => SdkResultAsync<UserImageUpload[], Error>;
+	uploadTemp: (params: {
+		blob: Blob;
+	}) => SdkResultAsync<TempUserImageUpload[], Error>;
+}
 export interface KittlContext {
 	colorScheme: EditorColorScheme;
 	dragAndDrop: {
 		offset: DragAndDropOffset;
 	};
 }
-export interface KittlSDK {
-	loaded: boolean;
-	onLoadedCallback: (() => void) | null;
-	onReady: (cb: () => void) => void;
+export interface KittlSDK extends KittlSDKLifecycle, KittlSDKEditorAPIs, KittlSDKFileBrowserAPI {
+}
+export interface KittlSDKEditorAPIs {
 	ai: AsyncAIAPI;
 	data: AsyncDataAPI;
 	design: AsyncDesignAPI;
+	export: AsyncExportAPI;
 	designStore: AsyncDesignStateAPI;
 	appStore: AsyncAppStateSubscriptionAPI;
 	context: AsyncContextAPI;
@@ -1076,11 +1100,18 @@ export interface KittlSDK {
 	state: AsyncAppStateAPI;
 	auth: AsyncAuthAPI;
 	upload: AsyncUploadAPI;
-	fileBrowser: FileBrowserAPI;
 	stateless: AsyncStatelessAPI;
 	font: AsyncFontAPI;
 	createBatch: () => Promise<AsyncBatchDesignAPI>;
 }
+export interface KittlSDKFileBrowserAPI {
+	fileBrowser: FileBrowserAPI;
+}
+export interface KittlSDKLifecycle {
+	loaded: boolean;
+	onLoadedCallback: (() => void) | null;
+	onReady: (cb: () => void) => void;
+}
 export interface LayersAPI {
 	moveTo(input: MoveToParams, opts?: DesignApiOptions): void;
 	sendForward(input: SendToParams, opts?: DesignApiOptions): void;
@@ -1088,14 +1119,9 @@ export interface LayersAPI {
 	sendBackward(input: SendToParams, opts?: DesignApiOptions): void;
 	sendToBack(input: SendToParams, opts?: DesignApiOptions): void;
 }
-export interface LinkedFillPresetMeta {
-	key: string;
-	target: FillMetaTarget;
-	source?: string;
-}
 export interface LoadingCardAPI {
 	createLoadingCard(input: CreateLoadingCardInput, opts?: DesignApiOptions): NormalizedLoadingCardObject;
-	updateLoadingCard(input: UpdateLoadingCardInput, opts?: DesignApiOptions): NormalizedLoadingCardObject;
+	updateLoadingCard(input: UpdateLoadingCardInput, opts?: UpdateObjectApiOptions): NormalizedLoadingCardObject;
 }
 export interface MockupDataAPI {
 	get(id: number): SdkResultAsync<CatalogItem>;
@@ -1130,8 +1156,10 @@ export interface MockupboardAPI {
 	updateMockupBoard(params: UpdateMockupBoardParams, opts?: DesignApiOptions): NormalizedStandardBoard<MockupBoardOptions>;
 }
 export interface ObjectAPI {
+	setColors(params: SetColorsParams, opts?: DesignApiOptions): void;
+	getColors(params: GetColorsParams): SDKColorEntry[];
 	setLockedState(params: SetLockedParams, opts?: DesignApiOptions): WithLocked;
-	removeObject(params: RemoveObjectParams, opts?: DesignApiOptions): RemoveObjectResult;
+	removeObject(params: RemoveObjectParams, opts?: DesignApiOptions): RemoveObjectResult | null;
 	setHiddenState(params: SetHiddenParams, opts?: DesignApiOptions): WithHidden;
 	rotateObject(params: RotateObjectParams, opts?: DesignApiOptions): WithObjectLayout;
 	getAllByFilter<T extends NormalizedObject>(predicate: (object: NormalizedObject) => boolean, opts?: DesignApiOptions): T[];
@@ -1187,15 +1215,25 @@ export interface PhotoFilterOptions {
 		distance: number;
 	};
 }
+export interface PlacementAPI {
+	getSmartPlacement(params: SmartPlacementInput, opts?: {
+		batchClient?: BatchClient<NormalizedDesignState>;
+	}): SmartPlacementOutput;
+}
 export interface PublicDragAndDropAPI {
 	startDragImageEvent(input: DragAndDropStartDragImageEventInput): void;
 	dropImage(input: DragAndDropDropImageInput): Promise<string | null>;
 }
+export interface PublicExportAPI {
+	bypassExportDialog: BypassExportDialog;
+	showExportModal: <Mime extends ExportMimeType>(request: ExportRequest<Mime>) => Promise<ExportResult>;
+}
 export interface RemoveObjectParams {
 	id: string;
+	skipIfMissing?: boolean;
 }
 export interface RemoveObjectResult {
-	removedObject: NormalizedObject;
+	removedObjectId: string;
 }
 export interface RichTextCompressedStylesV1 {
 	version: "v1";
@@ -1240,12 +1278,13 @@ export interface ShadowOptions {
 export interface ShapeAPI {
 	createPredefinedShape(input: CreateShapeInput, opts?: DesignApiOptions): NormalizedBasicShapeObject;
 	createBasicShape(input: CreateBasicShapeInput, opts?: DesignApiOptions): Promise<NormalizedBasicShapeObject>;
-	updateShape(input: UpdateShapeInput, opts?: DesignApiOptions): NormalizedBasicShapeObject;
+	updateShape(input: UpdateShapeInput, opts?: UpdateObjectApiOptions): NormalizedBasicShapeObject;
 	convertShapeToMask(input: ConvertShapeToMaskInput, opts?: DesignApiOptions): DesignStructureObject;
 }
 export interface SmartboardAPI {
 	addSmartboard(params: AddSmartboardParams, opts?: DesignApiOptions): NormalizedStandardBoard<SmartboardOptions>;
 	updateSmartboard(params: UpdateSmartboardParams, opts?: DesignApiOptions): NormalizedStandardBoard<SmartboardOptions>;
+	updateBackgroundImage(params: UpdateSmartboardBackgroundImageParams, opts?: DesignApiOptions): Promise<NormalizedStandardBoard<SmartboardOptions>>;
 }
 export interface SpendCreditsOptions {
 	amount: number;
@@ -1262,10 +1301,13 @@ export interface StartGenerationResult {
 	generationId: string;
 }
 export interface StateAPI {
-	implementSubState(params: Partial<NormalizedDesignState>, opts?: DesignApiOptions): Partial<NormalizedDesignState>;
+	implementSubState(params: Partial<NormalizedDesignState>, opts?: ImplementSubStateOptions): Partial<NormalizedDesignState>;
 	getState(): NormalizedDesignState;
 }
 export interface StructureObjectMeta {
+	textBadge?: {
+		styleId: string;
+	};
 	name?: string;
 	type?: LayerType;
 	defaultIcon?: LayerIconType;
@@ -1278,7 +1320,7 @@ export interface StructureObjectMeta {
 }
 export interface TextAPI {
 	addText(params: AddTextParams, opts?: DesignApiOptions): NormalizedRichTextObject;
-	updateText(params: UpdateTextParams, opts?: DesignApiOptions): NormalizedRichTextObject;
+	updateText(params: UpdateTextParams, opts?: UpdateObjectApiOptions): NormalizedRichTextObject;
 	updateRenderPlugin(params: UpdateRenderPluginParams, opts?: DesignApiOptions): NormalizedRichTextObject;
 	updateDecorationPlugin(params: UpdateDecorationPluginParams, opts?: DesignApiOptions): NormalizedRichTextObject;
 }
@@ -1328,15 +1370,7 @@ export interface UpdateLoadingCardInput {
 	name?: string;
 }
 export interface UploadAPI {
-	image: UploadImageAPI;
-}
-export interface UploadImageAPI {
-	upload: ({ blob, }: {
-		blob: Blob;
-	}) => SdkResultAsync<UserImageUpload[], Error>;
-	uploadTemp: ({ blob, }: {
-		blob: Blob;
-	}) => SdkResultAsync<TempUserImageUpload[], Error>;
+	image: ImageUploadAPI;
 }
 export interface UserTokenResult {
 	success: true;
@@ -1344,8 +1378,10 @@ export interface UserTokenResult {
 }
 export interface VideoAPI {
 	addVideo(params: AddVideoParams, opts?: DesignApiOptions): Promise<NormalizedVideoObject>;
-	updateVideo(params: UpdateVideoParams, opts?: DesignApiOptions): NormalizedVideoObject;
+	updateVideo(params: UpdateVideoParams, opts?: UpdateObjectApiOptions): NormalizedVideoObject;
 	removePlaylistItem(params: RemoveVideoPlaylistItemParams, opts?: DesignApiOptions): NormalizedVideoObject;
+	reorderPlaylistItem(params: ReorderVideoPlaylistItemParams, opts?: DesignApiOptions): NormalizedVideoObject;
+	addPlaylistItem(params: AddVideoPlaylistItemParams, opts?: DesignApiOptions): NormalizedVideoObject;
 	updatePlaylistItem(params: UpdateVideoPlaylistItemParams, opts?: DesignApiOptions): Promise<NormalizedVideoObject>;
 }
 export interface VideoGenerationResult {
@@ -1383,9 +1419,10 @@ 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" | "AGENT" | "WORKFLOW";
+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_INPUT_MICRO_EDITOR_REMIX" | "AI_INPUT_MICRO_EDITOR_INPAINT" | "AI_HUB_GENERATE_IMAGE" | "AI_HUB_REMIX_IMAGE" | "AI_HUB_GENERATE_VIDEO" | "VIDEOBOARD" | "AGENT" | "AI_HUB_AGENT" | "WORKFLOW" | "MCP" | "MCP_WORKFLOW" | "AI_AGENT" | "AI_AGENT_CHAT" | "AI_AGENT_CHAT_WEBSITE";
 export type AIGenerationContentType = "image" | "video";
 export type AIGenerationModelTaskType = "IMAGE_TO_IMAGE" | "IMAGE_INPAINT" | "IMAGE_OUTPAINT" | "TEXT_TO_IMAGE" | "IMAGE_TO_VIDEO";
+export type AIGenerationReferenceImageMode = "keyframe" | "reference";
 export type APIOptions<T extends Record<string, unknown>> = {
 	batchClient?: BatchClient<T>;
 } | {
@@ -1407,6 +1444,8 @@ export type ActiveTool = {
 	type: "pen-vector-editing";
 } | {
 	type: "comment";
+} | {
+	type: "text";
 } | {
 	type: "shape";
 	shape: BasicShapeType;
@@ -1423,6 +1462,7 @@ export type AddImageParams = ({
 	src?: never;
 }) & GeneratableObject & {
 	objectProperties?: ImageProperties;
+	crop?: ImageCrop;
 } & CreateElementWithPositionAndSize;
 export type AddIntoGroupParams = {
 	groupId: string;
@@ -1431,6 +1471,7 @@ export type AddIntoGroupParams = {
 export type AddMockupBoardParams = {
 	inputBoardIds: string[];
 	mockupTemplateId: number;
+	fill?: string;
 	shouldMockupColorMatchArtboard?: boolean;
 	initialDesigns?: AddMockupDesignObjectParams[];
 } & {
@@ -1457,49 +1498,64 @@ export type AddTextParams = {
 	size: Dimensions;
 };
 export type AddVideoParams = {
-	playlist: Omit<VideoPlaylistItem, "id">[];
+	playlist: VideoPlaylistItemInput[];
 	videoSize?: {
 		width: number;
 		height: number;
 	};
 } & CreateElementWithPositionAndSize;
+export type AddVideoPlaylistItemParams = {
+	videoId: string;
+	playlistItem: VideoPlaylistItemInput;
+	playlistItemId?: string;
+	previousPlaylistItemId?: string;
+	nextPlaylistItemId?: string;
+};
 export type AddVideoboardParams = {
 	linkedBoardIds?: string[];
 	video?: {
 		width?: number;
 		height?: number;
-		playlist: Omit<VideoPlaylistItem, "id">[];
+		playlist: VideoPlaylistItemInput[];
 	};
 } & {
 	position: AbsolutePosition | RelativePosition;
 	size: Dimensions;
 };
+export type AddedIllustration = NormalizedIllustrationObject & {
+	hasTextElements: boolean;
+};
+export type AnimateViewportParams = ViewportPatch & ViewportAnimationSettings;
+export type AnimateViewportToBoundsParams = ViewportAnimationSettings & ObjectPositionRect & {
+	viewportPadding?: ViewportBoundsPadding;
+};
+export type AnimateViewportToCenterParams = ViewportAnimationSettings & ObjectPositionRect;
 export type AppState = {
 	selectedObjectsIds: string[];
 	selectedLayersIds: string[];
 	selectedArtboardIds: string[];
 	selectedArtboardsObjectIds: string[];
 	allSelectedObjectsIds: string[];
-	canvasMode: CanvasMode | string;
-	activeTool: ActiveTool | null;
+	canvasMode: CanvasMode;
+	activeTool: ActiveTool;
 	viewport: Viewport;
 	isDragPanning: boolean;
 	highlightedObjectId: string | null;
+	isViewOnlyMode: boolean;
+	hasLegacyOutOfBoundsObjects: boolean;
+	canvasSettings: SettingsType;
+	penToolSetting: {
+		stroke: string | null | undefined;
+		strokeWidth: number;
+		fill: Color;
+	};
+	outlineLoading: Record<string, boolean>;
+	objectLoading: Record<string, boolean>;
+	pendingOperations: Record<string, PendingOperation>;
 };
-/**
- * A dot-separated string path into the app state.
- * The first segment must be a valid top-level key of AppState.
- *
- * @example
- * 'selectedObjectsIds'
- * 'viewport.coords.tl.x'
- * 'activeTool.type'
- */
 export type AppStateSelectorPath = AppStateTopLevelKey | `${AppStateTopLevelKey}.${string}`;
-/**
- * Top-level keys of AppState that extensions can subscribe to.
- */
 export type AppStateTopLevelKey = keyof AppState;
+export type AppStateWithoutModes = Omit<AppState, "canvasMode" | "activeTool" | "viewport" | "isDragPanning" | "highlightedObjectId" | "canvasSettings" | "objectLoading">;
 export type ArtboardLikeType = ObjectType.Artboard | ObjectType.MockupBoard | ObjectType.Smartboard | ObjectType.Videoboard;
 export type ArtboardOptions = StandardArtboardOptions | SmartboardOptions | MockupBoardOptions | VideoboardOptions;
 export type AvailableShadowOptions = Partial<Pick<ShadowOptions, "blur">> & Omit<ShadowOptions, "blur">;
@@ -1528,9 +1584,45 @@ export type BasicShapeSerializedObject = typeof BASIC_SHAPE_DEFAULT_VALUES & {
 	nPoints?: number | undefined;
 };
 export type BasicShapeType = (typeof BasicShapeType)[keyof typeof BasicShapeType];
+export type BoardRelinkOptions = {
+	relinkBoardAfterPlacement?: boolean;
+};
+export type BoundingBox = {
+	left: number;
+	top: number;
+	width: number;
+	height: number;
+};
+export type BoundingRect = {
+	top: number;
+	left: number;
+	bottom: number;
+	right: number;
+};
 export type BridgedSdkResult<T> = T extends SdkResult<infer _R, infer _E> ? T : SdkResult<T, Error>;
-export type Builtin = Date | Function | Uint8Array | RegExp | Map<unknown, unknown> | Set<unknown>;
-export type CanvasMode = "erase" | "crop" | "reframe" | "inpaint" | null;
+export type Builtin = Date | ((...args: never[]) => unknown) | Uint8Array | RegExp | Map<unknown, unknown> | Set<unknown>;
+export type BypassExportDialog = (options: GetExportOptions) => Promise<Blob | null>;
+export type CanvasMode = {
+	mode: "crop";
+	targetId: string;
+} | {
+	mode: "erase";
+	targetId: string;
+} | {
+	mode: "erase-and-fill";
+	targetId: string;
+} | {
+	mode: "reframe";
+	targetId: string;
+} | {
+	mode: "inpaint";
+	targetId: string;
+} | {
+	mode: "custom";
+	id: string;
+	state: JSONObject;
+} | null;
+export type CanvasModeKind = "erase" | "erase-and-fill" | "crop" | "reframe" | "inpaint" | null;
 export type CharacterIndex = number;
 export type CloneArtboardParams = {
 	boardId: string;
@@ -1541,6 +1633,10 @@ export type ColorInfo = StringColor | FullColor;
 export type CombinedShapeSerializedObject = Omit<typeof DEFAULT_VALUES, "shapes"> & {
 	shapes: Shape[];
 };
+export type ConnectBoardsParams = {
+	inputBoardId: string;
+	targetBoardId: string;
+};
 export type ConnectedArtboardOptions<T extends ArtboardLikeType = ArtboardLikeType> = BaseStandardArtboardOptions<T> & {
 	inputBoardIds?: string[];
 };
@@ -1576,36 +1672,24 @@ export type CreateShapeInput = CreateElementWithPositionAndSize & {
 	shapeType: BasicShapeType;
 	objectProperties?: ShapeProperties;
 };
+export type CubicBezierEasing = {
+	type: "cubic-bezier";
+	controlPoints: readonly [
+		x1: number,
+		y1: number,
+		x2: number,
+		y2: number
+	];
+};
+export type CustomCanvasModeId<Id extends string> = Id extends Exclude<CanvasModeKind, null> ? never : Id;
+export type CustomCanvasModeState<Id extends string> = Id extends keyof CustomCanvasModeStateById ? CustomCanvasModeStateById[Id] extends JSONObject ? CustomCanvasModeStateById[Id] : never : JSONObject;
 export type DeepPartial<T> = {
 	[P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
 };
-/**
- * Resolves a dot-separated string path against a type `T`.
- *
- * For `Record<string, V>` intermediaries (e.g. `objects`), any string
- * key is accepted and the type continues into `V`.
- *
- * @example
- * DeepValue<SelectorState, 'objects.id1.width'> // number | undefined
- * DeepValue<SelectorState, 'config'>            // DesignConfig
- * DeepValue<AppState, 'viewport.coords.tl.x'>  // number
- */
 export type DeepValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? DeepValue<NonNullable<T[K]>, Rest> : T extends Record<string, infer V> ? DeepValue<NonNullable<V>, Rest> : undefined : P extends keyof T ? T[P] : T extends Record<string, infer V> ? V : undefined;
 export type DesignApiOptions = APIOptions<NormalizedDesignState>;
 export type DesignObjectId = string;
-/**
- * A dot-separated string path into the design state.
- * The first segment must be a valid top-level key of NormalizedDesignState.
- *
- * @example
- * 'objects.id1.width'
- * 'config.title'
- * 'boards.board1.backgroundColor'
- */
 export type DesignStateSelectorPath = DesignStateTopLevelKey | `${DesignStateTopLevelKey}.${string}`;
-/**
- * Top-level keys of NormalizedDesignState that extensions can subscribe to.
- */
 export type DesignStateTopLevelKey = keyof NormalizedDesignState;
 export type DesignStructureObject = {
 	id?: StructureObjectId | null;
@@ -1616,15 +1700,34 @@ export type Dimensions = {
 	width: number;
 	height: number;
 };
+export type DisconnectBoardsParams = ConnectBoardsParams;
+export type EasingName = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out";
 export type EditorColorScheme = "light" | "dark";
 export type ElementLocation = "origin" | "center";
 export type Expand<T> = T extends infer O ? {
 	[K in keyof O]: O[K];
 } : never;
+export type ExportAPI = PublicExportAPI;
+export type ExportFieldValue = string | number | boolean | string[];
+export type ExportFieldValues = Record<string, ExportFieldValue>;
+export type ExportMimeType = (typeof EXPORT_MIME_TYPES)[keyof typeof EXPORT_MIME_TYPES];
+export type ExportRequest<Mime extends ExportMimeType = ExportMimeType> = {
+	target: readonly string[];
+	title: string;
+	exportLabel: string;
+	customFields?: readonly PlainInputSetting[];
+	mimeTypes?: readonly Mime[];
+	initialFileFormat?: Mime;
+};
+export type ExportResult = {
+	blobs: readonly Blob[];
+	settings: ExportFieldValues;
+};
 export type FileBrowserContent = FileBrowserItem | FileBrowserFolder;
 export type FileBrowserFetchContentParams = {
 	id?: string;
 	next?: string | number;
+	formats?: readonly FileBrowserMediaFormat[];
 };
 export type FileBrowserFetchContentResult = {
 	content: FileBrowserContent[];
@@ -1643,16 +1746,25 @@ export type FileBrowserItem = {
 	label: string;
 	id: string;
 	preview?: string;
+	animatedPreview?: string;
 	content: {
 		data: string;
+		mimeType?: string;
+		uploadType?: UploadType;
 	};
 };
+export type FileBrowserMediaFormat = "image" | "video";
 export type FileBrowserTab = {
 	id: string;
 	label: string;
+	order?: number;
+	emptyState?: FileBrowserTabEmptyState;
+	supportedFormats?: readonly FileBrowserMediaFormat[];
 	fetchContent: (params?: FileBrowserFetchContentParams) => Promise<FileBrowserFetchContentResult>;
+	onEvent?: (event: FileBrowserTabEvent) => void;
 };
-export type FillMetaTarget = "border" | "fill";
+export type FileBrowserTabEmptyState = "aiCreations" | "uploads";
+export type FileBrowserTabEvent = "close" | "open" | "upload";
 export type FlattenUnion<T> = UnionToIntersection<T extends unknown ? Partial<T> : never>;
 export type FontListDto = PaginatedResult<FontFamilyDto>;
 export type FontVariationSettings = Record<string, number> & Partial<Record<KnownFontVariationAxis, number>>;
@@ -1663,7 +1775,6 @@ 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;
@@ -1671,6 +1782,12 @@ export type GenerationStatusUpdate = {
 	inputData: undefined;
 	creditUse: undefined;
 	result: undefined;
+} | {
+	generationId: string;
+	status: typeof GenerationStatus.QUEUED;
+	inputData?: GenerationInputData;
+	creditUse?: GenerationCreditUse;
+	result?: StartedGenerationResult;
 } | {
 	generationId: string;
 	status: typeof GenerationStatus.STARTED;
@@ -1689,6 +1806,18 @@ export type GenerationStatusUpdate = {
 	inputData: GenerationInputData | undefined;
 	creditUse?: GenerationCreditUse;
 	result: ErrorGenerationResult;
+} | {
+	generationId: string;
+	status: typeof GenerationStatus.CANCELLED;
+	inputData?: GenerationInputData;
+	creditUse?: GenerationCreditUse;
+	result: undefined;
+};
+export type GetColorsParams = {
+	objectId: string;
+};
+export type GetIllustrationPathsParams = {
+	id: string;
 };
 export type GuideSerializedObject = typeof GUIDE_DEFAULT_VALUES & OrientationDir;
 export type ID = string;
@@ -1705,9 +1834,13 @@ export type IllustrationImageSerializedObject = typeof DEFAULT_VALUES$1 & {
 	} | undefined;
 	eraseStrokeWidth?: number | undefined;
 	inpaintingStrokeWidth?: number | undefined;
+	inpaintingSelectionMode?: InpaintingSelectionMode;
+	eraseAndFillStrokeWidth?: number | undefined;
+	unsplashId?: string | undefined;
 };
 export type IllustrationProperties = {
 	angle?: IllustrationSerializedObject["angle"];
+	defaultName?: IllustrationSerializedObject["defaultName"];
 	flipX?: IllustrationSerializedObject["flipX"];
 	flipY?: IllustrationSerializedObject["flipY"];
 	hidden?: IllustrationSerializedObject["hidden"];
@@ -1719,7 +1852,42 @@ export type IllustrationProperties = {
 	gradients?: IllustrationSerializedObject["gradients"];
 	generation?: IllustrationSerializedObject["generation"];
 };
+export type IllustrationSerializedChild = {
+	id: string;
+	isChild: true;
+	baseFill?: string | GradientObject | null;
+	baseStroke?: string | GradientObject | null;
+	name?: string | null;
+	defaultName: string;
+	width: number;
+	height: number;
+	fillRule?: CanvasFillRule;
+	strokeLineCap?: CanvasLineCap;
+	strokeLineJoin?: CanvasLineJoin;
+	strokeWidth?: number;
+	strokeUniform?: boolean;
+	strokeDashArray?: number[];
+	strokeDashOffset?: number;
+	strokeMiterLimit?: number;
+	transform: number[];
+	type: string;
+	opacity: number;
+	locked: boolean;
+	hidden: boolean;
+	path: (string | number)[][];
+	pathOffset?: {
+		x: number;
+		y: number;
+	};
+};
+export type IllustrationSerializedChildren = IllustrationSerializedChild[];
 export type IllustrationSerializedObject = typeof ILLUSTRATION_DEFAULT_VALUES;
+export type ImageCrop = {
+	x: number;
+	y: number;
+	width: number;
+	height: number;
+};
 export type ImageProperties = {
 	angle?: IllustrationImageSerializedObject["angle"];
 	flipX?: IllustrationImageSerializedObject["flipX"];
@@ -1730,13 +1898,33 @@ export type ImageProperties = {
 	stroke?: IllustrationImageSerializedObject["stroke"];
 	strokeWidth?: IllustrationImageSerializedObject["strokeWidth"];
 	fill?: IllustrationImageSerializedObject["fill"];
+	defaultName?: IllustrationImageSerializedObject["defaultName"];
+	unsplashId?: IllustrationImageSerializedObject["unsplashId"];
+};
+export type ImplementSubStateOptions = DesignApiOptions & {
+	placement?: ImplementSubStatePlacement;
+};
+export type ImplementSubStatePlacement = {
+	afterExistingStandardBoards: {
+		gap?: number;
+		top?: number;
+	};
+} | {
+	absolute: {
+		left: number;
+		top?: number;
+		gap?: number;
+	};
 };
 export type InternalPatchArgs<T> = {
 	patch: PatchTree<T> | PatchTree<T>[];
 	origin: Origin;
 	historyOrigin?: HistoryOrigins;
-	transactionMeta?: TransactionMeta;
 };
+export type JSONObject = {
+	[key: string]: JSONValue;
+};
+export type JSONValue = null | boolean | number | string | Array<JSONValue> | JSONObject;
 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;
@@ -1751,32 +1939,6 @@ export type LineHeight = {
 };
 export type LineHeightUnit = "px" | "%";
 export type LineIndex = number;
-export type LinkedPreset = {
-	id: string;
-	libraryId: string;
-} & LinkedPresetMeta;
-export type LinkedPresetMeta = {
-	type: LibraryPresetType.FILL;
-	meta: LinkedFillPresetMeta;
-} | {
-	type: LibraryPresetType.TRANSFORMATION;
-	meta?: never;
-} | {
-	type: LibraryPresetType.PHOTO_FILTER;
-	meta?: never;
-} | {
-	type: LibraryPresetType.SHADOW;
-	meta?: never;
-} | {
-	type: LibraryPresetType.TEXT;
-	meta?: never;
-} | {
-	type: LibraryPresetType.TEXT_EFFECT;
-	meta?: never;
-} | {
-	type: LibraryPresetType.TEXT_DECORATION;
-	meta?: never;
-};
 export type LoadingCardSerializedObject = typeof LOADING_CARD_DEFAULT_VALUES & {
 	imageGenerationId?: string | undefined;
 	startedAt?: number | undefined;
@@ -1844,6 +2006,14 @@ export type NormalizedVideoObject = Normalized<VideoSerializedObject>;
 export type NullablePathTextShadowOptions = PathTextShadowOptions | {
 	type: null;
 };
+export type ObjectPosition = {
+	top: number;
+	left: number;
+};
+export type ObjectPositionRect = {
+	width: number;
+	height: number;
+} & ObjectPosition;
 export type OnGenerationStatusUpdate = (update: GenerationStatusUpdate) => void | Promise<void>;
 export type OrAnyString<T extends string> = T | (string & {});
 export type OrientationConditional = {
@@ -1899,6 +2069,34 @@ export type PathTextTransformOptions = TransformOptions & {
 		y: number;
 	}[];
 };
+export type PendingOperation = (typeof PendingOperation)[keyof typeof PendingOperation];
+export type PlainInputSetting = {
+	isPremium?: boolean;
+	name: "combineBoards" | (string & {});
+	label?: string;
+	disabled?: true;
+} & ({
+	type: "selection";
+	options: readonly SelectionOption[];
+	default?: string;
+} | {
+	type: "input";
+	propType: "string";
+	unit?: string;
+	default?: string;
+} | {
+	type: "input";
+	propType: "number";
+	unit?: string;
+	default?: number;
+	max?: number;
+	min?: number;
+} | {
+	type: "input";
+	propType: "boolean";
+	unit?: string;
+	default?: boolean;
+});
 export type PrintMargins = {
 	enabled: boolean;
 	top: number;
@@ -1933,6 +2131,10 @@ export type RemoveFromGroupParams = {
 export type RemoveGroupParams = {
 	groupId: string;
 };
+export type RemoveIllustrationPathParams = {
+	illustrationId: string;
+	pathIds: string[];
+};
 export type RemovePlaylistItemParams = {
 	videoBoardId: string;
 	playlistItemId: string;
@@ -1944,10 +2146,21 @@ export type RemoveVideoPlaylistItemParams = {
 	videoId: string;
 	playlistItemId: string;
 };
+export type RenameIllustrationPathParams = {
+	illustrationId: string;
+	pathId: string;
+	newName: string;
+};
 export type RenameParams = {
 	objectId: string;
 	newName: string;
 };
+export type ReorderVideoPlaylistItemParams = {
+	videoId: string;
+	playlistItemId: string;
+	previousPlaylistItemId?: string;
+	nextPlaylistItemId?: string;
+};
 export type ResetImageBackgroundRemovalParams = {
 	id: IllustrationImageSerializedObject["id"];
 };
@@ -1976,7 +2189,7 @@ export type RichTextRenderPluginSerializedObject = RichTextBasePluginSerializedO
 	offset: number;
 	[key: string]: string | number;
 };
-export type RichTextResizeBehavior = "hug" | "none" | "hug-height";
+export type RichTextResizeBehavior = "hug" | "none" | "hug-height" | "fixed-box-fit";
 export type RichTextSerializedCharacterStyle = Partial<{
 	fontFamily: string;
 	fontWeight: FontWeight;
@@ -2033,6 +2246,37 @@ export type RichTextSerializedTransformPluginObject = RichTextBasePluginSerializ
 	curveHeight?: number;
 	directionInverted?: boolean;
 };
+export type SDKColor = string | SDKGradient;
+export type SDKColorEntry = {
+	key: string;
+	color: SDKColor | null;
+};
+export type SDKColorStop = {
+	offset: number;
+	color: string | null;
+};
+export type SDKGradient = SDKLinearGradient | SDKRadialGradient;
+export type SDKLinearGradient = {
+	type: GradientType.Linear;
+	colorStops: SDKColorStop[];
+	angle: number;
+	coords: SDKLinearGradientCoords;
+};
+export type SDKLinearGradientCoords = {
+	x1: number;
+	y1: number;
+	x2: number;
+	y2: number;
+};
+export type SDKRadialGradient = {
+	type: GradientType.Radial;
+	colorStops: SDKColorStop[];
+	angle: number;
+	coords: SDKRadialGradientCoords;
+};
+export type SDKRadialGradientCoords = SDKLinearGradientCoords & {
+	r2: number;
+};
 export type ScreenCoordinates = {
 	x: number;
 	y: number;
@@ -2063,12 +2307,13 @@ export type SdkResultAsync<T, E = SdkError> = Promise<{
 	result?: never;
 	error: E;
 }>;
+export type SelectionOption = {
+	value: string;
+	label: string;
+	disabled?: true;
+	isPremium?: true;
+};
 export type Selector<T, U = unknown> = (state: T) => U;
-/**
- * The design state shape exposed to string path selectors.
- * `objects` values are flattened so that variant-specific properties
- * (e.g. `width`, `fill`) are accessible without manual narrowing.
- */
 export type SelectorState = Omit<NormalizedDesignState, "objects"> & {
 	objects: Record<string, FlattenUnion<NormalizedObject>>;
 };
@@ -2084,6 +2329,18 @@ export type SerialisedPhotoFilter = ({
 export type SerializableCornerRadii = Record<string, Record<string, number>>;
 export type SerializableObjectType = ObjectType.IllustrationImage | ObjectType.Illustration | ObjectType.Artboard | ObjectType.Smartboard | ObjectType.Videoboard | ObjectType.MockupBoard | ObjectType.PathText | ObjectType.RichText | ObjectType.MockupDesign | ObjectType.OverlayTexture | ObjectType.Mask | ObjectType.BasicShape | ObjectType.VectorPath | ObjectType.Guide | ObjectType.CombinedShape | ObjectType.LoadingCard | ObjectType.Video;
 export type SerializedObject = StandardSerializedObject | GuideSerializedObject;
+export type SetCanvasModeWithTargetOptions = {
+	origin?: Origin;
+	targetId?: string | null;
+};
+export type SetColorsParams = {
+	objectId: string;
+	colorEntries: SDKColorEntry[];
+};
+export type SetCustomCanvasModeParams<Id extends string> = {
+	id: CustomCanvasModeId<Id>;
+	state: CustomCanvasModeState<Id>;
+};
 export type SetTextureParams = {
 	boardId: string;
 	texture: string;
@@ -2094,9 +2351,16 @@ export type SetVideoOnVideoboardParams = {
 	video: {
 		width?: number;
 		height?: number;
-		playlist: Omit<VideoPlaylistItem, "id">[];
+		playlist: VideoPlaylistItemInput[];
 	};
 } & Pick<VideoboardOptions, "generationSettings">;
+export type SettingsType = {
+	gridSize: number;
+	showGrid: boolean;
+	showRuler: boolean;
+	showPrintMargins: boolean;
+	enableGuideRedraw: boolean;
+};
 export type ShadingOptions = AvailableShadowOptions & {
 	type: "drop" | "line" | "block" | "detail";
 	outlineWidth?: number;
@@ -2122,6 +2386,17 @@ export type ShapeProperties = {
 	stroke?: NonNullable<BasicShapeSerializedObject["stroke"]>;
 	strokeWidth?: NonNullable<BasicShapeSerializedObject["strokeWidth"]>;
 };
+export type SmartPlacementInput = {
+	objects: BoundingBox[];
+	padding?: number;
+	applyViewportScale?: boolean;
+	ignoredIds?: string[];
+	targetBoardId?: string;
+};
+export type SmartPlacementOutput = {
+	insertionBoundingBox: BoundingBox;
+	objectPlacements: BoundingBox[];
+};
 export type SmartboardAction = SmartboardActionWithAiPrompt | SmartboardActionInitial;
 export type SmartboardActionInitial = {
 	type: "noAction";
@@ -2164,6 +2439,9 @@ export type StringColor = {
 };
 export type StringColorKeysType = (typeof stringColorKeys)[number];
 export type StructureObjectId = string;
+export type SubscribeOptions = {
+	skipDedupe?: boolean;
+};
 export type SuccessGenerationResult = VideoGenerationResult | ImageGenerationResult;
 export type TempUserImageUpload = {
 	objectId: string;
@@ -2179,7 +2457,7 @@ export type TextProperties = {
 	fill?: Color;
 	textAlign?: TextAlign;
 	lineHeightValue?: LineHeight;
-	resizeBehavior?: "none" | "hug" | "hug-height";
+	resizeBehavior?: RichTextResizeBehavior;
 	charSpacing?: number;
 	underline?: boolean;
 	overline?: boolean;
@@ -2190,15 +2468,16 @@ export type TextProperties = {
 	stroke?: string | null;
 	strokeWidth?: number;
 };
-export type TransactionMeta = {
-	isLocal: boolean;
-	isUndoRedo: boolean;
+export type ToggleHideIllustrationPathParams = {
+	illustrationId: string;
+	pathId: string;
+	hidden: boolean;
+};
+export type ToggleLockIllustrationPathParams = {
+	illustrationId: string;
+	pathId: string;
+	locked: boolean;
 };
-/**
- * Collapses a union type into a single object type where:
- * - Properties shared by all members keep their original type.
- * - Properties that exist only on some members become optional.
- */
 export type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 export type UpdateArtboardBackgroundParams = {
 	id: string;
@@ -2236,27 +2515,34 @@ export type UpdateImageParams = {
 	width?: IllustrationImageSerializedObject["width"];
 	height?: IllustrationImageSerializedObject["height"];
 	objectName?: IllustrationImageSerializedObject["objectName"];
+	backgroundRemoved?: IllustrationImageSerializedObject["backgroundRemoved"];
+	objectNameWithBackground?: IllustrationImageSerializedObject["objectNameWithBackground"];
 	shadowOptions?: IllustrationImageSerializedObject["shadowOptions"];
 	shadowColor?: NonNullable<IllustrationImageSerializedObject["shadowOptions"]>["color"];
 	stroke?: IllustrationImageSerializedObject["stroke"];
 	strokeWidth?: IllustrationImageSerializedObject["strokeWidth"];
+	inpaintingStrokeWidth?: IllustrationImageSerializedObject["inpaintingStrokeWidth"];
+	inpaintingSelectionMode?: IllustrationImageSerializedObject["inpaintingSelectionMode"];
 } & GeneratableObject;
 export type UpdateImageSourceParams = {
 	id: IllustrationImageSerializedObject["id"];
 	objectName: IllustrationImageSerializedObject["objectName"];
 	keepObjectDimensions?: boolean;
+	resizeMode?: "preserve-rendered-bounds" | "preserve-min-dimension";
 	flatten?: boolean;
 };
 export type UpdateMockupBoardParams = {
 	mockupBoardId: string;
 	size?: Dimensions;
 	mockupTemplateId?: number;
+	fill?: string;
 	shouldMockupColorMatchArtboard?: boolean;
 };
+export type UpdateObjectApiOptions = (Exclude<DesignApiOptions, undefined> & BoardRelinkOptions) | undefined;
 export type UpdatePlaylistItemParams = {
 	videoBoardId: string;
 	playlistItemId: string;
-	playlistItem: Omit<VideoPlaylistItem, "id">;
+	playlistItem: Partial<Omit<VideoPlaylistItemInput, "id">>;
 };
 export type UpdateRenderPluginParams = {
 	textId: string;
@@ -2266,6 +2552,9 @@ export type UpdateRenderPluginParams = {
 export type UpdateShapeInput = Partial<CreateElementWithPositionAndSize> & BasicShapeConfigurableFields & {
 	id: NormalizedBasicShapeObject["id"];
 };
+export type UpdateSmartboardBackgroundImageParams = {
+	smartboardId: string;
+} & Partial<Pick<BackgroundImageOptions, "objectName" | "generation" | "opacity" | "filters" | "globalCompositeOperation" | "hidden">>;
 export type UpdateSmartboardParams = {
 	smartboardId: string;
 	size?: Dimensions;
@@ -2294,12 +2583,13 @@ export type UpdateVideoParams = {
 export type UpdateVideoPlaylistItemParams = {
 	videoId: string;
 	playlistItemId: string;
-	playlistItem: Omit<VideoPlaylistItem, "id">;
+	playlistItem: Partial<Omit<VideoPlaylistItemInput, "id">>;
 };
 export type UpdateVideoboardParams = {
 	videoBoardId: string;
 	size?: Dimensions;
 } & Pick<VideoboardOptions, "generationSettings">;
+export type UploadType = (typeof UploadType)[keyof typeof UploadType];
 export type UploadedFontFamily = {
 	id: string;
 	name: string;
@@ -2326,12 +2616,20 @@ export type VideoBoardGenerationSettings = Record<string, unknown>;
 export type VideoPlaylistItem = {
 	id: string;
 	objectName?: string;
+	startOffset?: number;
+	endOffset?: number;
+	playbackRate: number;
+	volume: number;
 	meta?: GeneratableObject & {
 		generation?: {
 			isGenerating?: boolean;
 		};
 	};
 };
+export type VideoPlaylistItemInput = Omit<VideoPlaylistItem, "id" | "playbackRate" | "volume"> & {
+	playbackRate?: number;
+	volume?: number;
+};
 export type VideoSerializedObject = typeof DEFAULT_VALUES$2 & {
 	playlist: VideoPlaylistItem[];
 	realWidth?: number;
@@ -2377,8 +2675,16 @@ export type ViewportAPI = {
 	set(patch: ViewportPatch, origin?: Origin): void;
 	getTransform(): Viewport["transform"];
 	setTransform(transform: Viewport["transform"], origin?: Origin): void;
+	getPixelSize(): {
+		width: number;
+		height: number;
+	};
 	getZoom(): number;
 	setZoom(zoom: number, origin?: Origin): void;
+	zoomToPoint(screenPoint: {
+		x: number;
+		y: number;
+	}, zoom: number, origin?: Origin): void;
 	getCoords(): Viewport["coords"];
 	setCoords(coords: Viewport["coords"], origin?: Origin): void;
 	getPosition(): {
@@ -2389,7 +2695,33 @@ export type ViewportAPI = {
 		x: number;
 		y: number;
 	}, origin?: Origin): void;
+	centerOnBounds(bounds: BoundingRect, origin?: Origin): void;
+	panTo(position: {
+		x: number;
+		y: number;
+	}, origin?: Origin): void;
+	animateTo(params: AnimateViewportParams, origin?: Origin): Promise<ViewportAnimationResult>;
+	animateToBounds(params: AnimateViewportToBoundsParams, origin?: Origin): Promise<ViewportAnimationResult>;
+	centerToBounds(params: AnimateViewportToCenterParams, origin?: Origin): Promise<ViewportAnimationResult>;
+	expandToBounds(params: AnimateViewportToBoundsParams, origin?: Origin): Promise<ViewportAnimationResult>;
+};
+export type ViewportAnimationResult = {
+	status: "completed";
+} | {
+	status: "interrupted";
+	reason: "superseded" | "viewport-updated" | "destroyed";
+};
+export type ViewportAnimationSettings = {
+	duration?: number;
+	ease?: ViewportEasing;
+};
+export type ViewportBoundsPadding = number | {
+	left?: number;
+	right?: number;
+	top?: number;
+	bottom?: number;
 };
+export type ViewportEasing = EasingName | CubicBezierEasing;
 export type ViewportPatch = {
 	transform: Viewport["transform"];
 	zoom?: never;