@cesdk/node-native 1.77.0-nightly.20260610

package/lib/index.d.ts

@@ -0,0 +1,4072 @@
+/**
+ * Logger types and runtime export. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/types/Logger.ts` so consumers can import
+ * `LogLevel` / `Logger` from either `@cesdk/node` or `@cesdk/node-native`
+ * interchangeably.
+ *
+ * @public
+ */
+export type LogLevel = "Info" | "Warning" | "Error";
+/**
+ * Provides a set of predefined log levels for the Creative Editor SDK.
+ *
+ * The `LogLevel` object contains constants representing different severity levels
+ * for logging messages. These levels can be used to categorize log messages based
+ * on their importance and urgency.
+ *
+ * @public
+ * @deprecated Specifying log levels via `LogLevel.Info` has been deprecated.
+ * Please use the desired LogLevel string directly.
+ */
+export declare const LogLevel: {
+	readonly Info: "Info";
+	readonly Warning: "Warning";
+	readonly Error: "Error";
+};
+/**
+ * Represents a logger callable.
+ *
+ * @public
+ */
+export type Logger = (message: string, level?: LogLevel) => void;
+/**
+ * Block, shape, fill, effect, blur, and animation type constants and
+ * the derived shorthand/longhand/union types. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/types/blockTypes.ts` exactly so a const
+ * array equality check (e.g. `DESIGN_BLOCK_TYPES.includes(t)`) returns
+ * the same value across bindings.
+ */
+/**
+ * The shorthand block type IDs for the top-level design blocks. These
+ * are the IDs used to create new blocks via `engine.block.create(id)`.
+ *
+ * @public
+ */
+export declare const DESIGN_BLOCK_TYPES: readonly [
+	"scene",
+	"stack",
+	"camera",
+	"page",
+	"graphic",
+	"audio",
+	"text",
+	"group",
+	"cutout",
+	"track",
+	"caption",
+	"captionTrack"
+];
+/** @public */
+export type DesignBlockTypeShorthand = (typeof DESIGN_BLOCK_TYPES)[number];
+/** @public */
+export type DesignBlockTypeLonghand = `//ly.img.ubq/${DesignBlockTypeShorthand}`;
+/** @public */
+export type DesignBlockType = DesignBlockTypeShorthand | DesignBlockTypeLonghand;
+/** @public */
+export declare const SHAPE_TYPES: readonly [
+	"rect",
+	"line",
+	"ellipse",
+	"polygon",
+	"star",
+	"vector_path"
+];
+/** @public */
+export type ShapeTypeShorthand = (typeof SHAPE_TYPES)[number];
+/** @public */
+export type ShapeTypeLonghand = `//ly.img.ubq/shape/${ShapeTypeShorthand}`;
+/** @public */
+export type ShapeType = ShapeTypeShorthand | ShapeTypeLonghand;
+/** @public */
+export declare const FILL_TYPES: readonly [
+	"color",
+	"gradient/linear",
+	"gradient/radial",
+	"gradient/conical",
+	"image",
+	"video",
+	"pixelStream"
+];
+/** @public */
+export type FillTypeShorthand = (typeof FILL_TYPES)[number];
+/** @public */
+export type FillTypeLonghand = `//ly.img.ubq/fill/${FillTypeShorthand}`;
+/** @public */
+export type FillType = FillTypeShorthand | FillTypeLonghand;
+/** @public */
+export declare const EFFECT_TYPES: readonly [
+	"adjustments",
+	"cross_cut",
+	"dot_pattern",
+	"duotone_filter",
+	"extrude_blur",
+	"glow",
+	"green_screen",
+	"half_tone",
+	"linocut",
+	"liquid",
+	"lut_filter",
+	"mirror",
+	"outliner",
+	"pixelize",
+	"posterize",
+	"radial_pixel",
+	"recolor",
+	"sharpie",
+	"shifter",
+	"tilt_shift",
+	"tv_glitch",
+	"vignette"
+];
+/** @public */
+export type EffectTypeShorthand = (typeof EFFECT_TYPES)[number];
+/** @public */
+export type EffectTypeLonghand = `//ly.img.ubq/effect/${EffectTypeShorthand}`;
+/** @public */
+export type EffectType = EffectTypeShorthand | EffectTypeLonghand;
+/** @public */
+export declare const BLUR_TYPES: readonly [
+	"uniform",
+	"linear",
+	"mirrored",
+	"radial"
+];
+/** @public */
+export type BlurTypeShorthand = (typeof BLUR_TYPES)[number];
+/** @public */
+export type BlurTypeLonghand = `//ly.img.ubq/blur/${BlurTypeShorthand}`;
+/** @public */
+export type BlurType = BlurTypeShorthand | BlurTypeLonghand;
+/** @public */
+export declare const ANIMATION_TYPES: readonly [
+	"slide",
+	"pan",
+	"fade",
+	"blur",
+	"grow",
+	"zoom",
+	"pop",
+	"wipe",
+	"baseline",
+	"crop_zoom",
+	"spin",
+	"spin_loop",
+	"fade_loop",
+	"blur_loop",
+	"pulsating_loop",
+	"breathing_loop",
+	"jump_loop",
+	"squeeze_loop",
+	"sway_loop",
+	"scale_loop",
+	"typewriter_text",
+	"block_swipe_text",
+	"spread_text",
+	"merge_text",
+	"ken_burns"
+];
+/** @public */
+export type AnimationTypeShorthand = (typeof ANIMATION_TYPES)[number];
+/** @public */
+export type AnimationTypeLonghand = `//ly.img.ubq/animation/${AnimationTypeShorthand}`;
+/** @public */
+export type AnimationType = AnimationTypeShorthand | AnimationTypeLonghand;
+/** @public */
+export type ObjectTypeShorthand = DesignBlockTypeShorthand | `shape/${ShapeTypeShorthand}` | `fill/${FillTypeShorthand}` | `effect/${EffectTypeShorthand}` | `blur/${BlurTypeShorthand}` | `animation/${AnimationTypeShorthand}`;
+/** @public */
+export type ObjectTypeLonghand = DesignBlockTypeLonghand | ShapeTypeLonghand | FillTypeLonghand | EffectTypeLonghand | BlurTypeLonghand | AnimationTypeLonghand;
+/** @public */
+export type ObjectType = ObjectTypeShorthand | ObjectTypeLonghand;
+/**
+ * Shared type definitions for CE.SDK bindings
+ * These types are implemented by both Node.js (Native) and Web (WASM) bindings
+ */
+/** A unique identifier for a design block */
+export type DesignBlockId = number;
+/** A unique identifier for a history state */
+export type HistoryId = number;
+/** A unique identifier for an event subscription (used internally by bindings) */
+export type SubscriptionId = number;
+/**
+ * Render-/decode-/encode-device selector.
+ *
+ * - `'auto'` — engine picks (default).
+ * - `'cpu'` — software path (Skia raster on native, canvas2d on web).
+ * - `'gpu'` — any available GPU backend (Metal on macOS, EGL on Linux,
+ *   WebGL2 in browser, no-op in WASM Node). The engine auto-selects the
+ *   platform backend; there is no per-sub-backend selection.
+ */
+export type Device = "auto" | "cpu" | "gpu";
+/**
+ * Configuration options for engine initialization. Mirrors `@cesdk/node`'s
+ * engine-level `Configuration` (`bindings/wasm/js_web/src/configuration/
+ * index.ts`) verbatim, plus a native-only `device` selector.
+ *
+ * Web/WASM-only fields are kept on the type for cross-binding shape
+ * compatibility — the node native binding ignores them at runtime.
+ */
+export interface Configuration {
+	/** Base URL for loading engine assets. */
+	baseURL?: string;
+	/** License key for the engine. Empty string drops the engine into Evaluation mode. */
+	license?: string;
+	/** Optional user identifier passed through to engine tracking. */
+	userId?: string;
+	/**
+	 * WASM core asset locator. Used by `@cesdk/node` to find `cesdk.wasm`
+	 * / `cesdk.data` next to the loader. Native binding doesn't consume
+	 * this; kept on the shape for cross-binding portability.
+	 */
+	core?: {
+		baseURL: string;
+	};
+	/** Custom logger. Defaults to `console.log` / `console.warn` / `console.error` per level. */
+	logger?: Logger;
+	/** Feature flag bag. Mirrors `@cesdk/node`'s `featureFlags`. */
+	featureFlags?: {
+		[flag: string]: boolean | string;
+	};
+	/** @deprecated Mirrored from `@cesdk/node` for shape parity. Not consumed. */
+	presets?: {
+		typefaces?: {
+			[id: string]: unknown;
+		};
+	};
+	/**
+	 * Render-device selection. Defaults to `'auto'` (Metal/EGL → CPU fallback
+	 * on native; WebGL2/canvas2d on web). Native-only knob today; web/WASM
+	 * accept the value for shape parity but ignore non-`'auto'` strings.
+	 *
+	 * @example
+	 * ```ts
+	 * await CreativeEngine.init({ license, device: 'gpu' });
+	 * await CreativeEngine.init({ license, device: 'cpu' });
+	 * ```
+	 */
+	device?: Device;
+}
+/** Options for exporting images */
+export interface ExportOptions {
+	/** The MIME type of the exported file */
+	mimeType?: "image/png" | "image/jpeg" | "image/webp" | "application/pdf";
+	/** PNG compression level (0-9) */
+	pngCompressionLevel?: number;
+	/** JPEG quality (0-1) */
+	jpegQuality?: number;
+	/** WebP quality (0-1) */
+	webpQuality?: number;
+	/** Target width for export */
+	targetWidth?: number;
+	/** Target height for export */
+	targetHeight?: number;
+	/** Export PDF with high compatibility */
+	exportPdfWithHighCompatibility?: boolean;
+	/** Export PDF with DeviceCMYK color space (instead of sRGB) for prepress workflows */
+	exportPdfWithDeviceCMYK?: boolean;
+	/** Export PDF with underlayer */
+	exportPdfWithUnderlayer?: boolean;
+	/** Spot color name for underlayer */
+	underlayerSpotColorName?: string;
+	/** Underlayer offset */
+	underlayerOffset?: number;
+	/**
+	 * Resolution multiplier for the raster pass that extracts the underlayer contour.
+	 * Higher values produce sharper underlayer outlines at the cost of memory and export time.
+	 * Useful for small text on large pages. Values `<= 0` fall back to 1.0.
+	 */
+	underlayerRenderRatio?: number;
+	/**
+	 * Maximum acceptable curve-fit error, in pixels, when vectorising the underlayer contour.
+	 * Smaller values produce tighter fits at the cost of more path complexity.
+	 * Values `<= 0` fall back to 2.0.
+	 */
+	underlayerMaxError?: number;
+	/** Allow text to extend beyond block boundaries */
+	allowTextOverhang?: boolean;
+}
+/** Options for exporting video */
+export interface VideoExportOptions {
+	/** Time offset in seconds relative to the target block */
+	timeOffset?: number;
+	/** Duration in seconds of the final video */
+	duration?: number;
+	/** H.264 profile */
+	h264Profile?: number;
+	/** H.264 level */
+	h264Level?: number;
+	/** Video bitrate in bits per second */
+	videoBitrate?: number;
+	/** Audio bitrate in bits per second */
+	audioBitrate?: number;
+	/** Target framerate */
+	framerate?: number;
+	/** Whether to use target size instead of block size */
+	useTargetSize?: boolean;
+	/** Target width */
+	targetWidth?: number;
+	/** Target height */
+	targetHeight?: number;
+	/** Allow text to extend beyond block boundaries */
+	allowTextOverhang?: boolean;
+	/** Enable HEVC/H.265 */
+	enableHEVC?: boolean;
+}
+/** Options for exporting audio */
+export interface AudioExportOptions {
+	/** Time offset in seconds relative to the target block */
+	timeOffset?: number;
+	/** Duration in seconds of the final audio */
+	duration?: number;
+	/** Sample rate in Hz */
+	sampleRate?: number;
+	/** Number of channels */
+	numberOfChannels?: number;
+	/** Skip encoding */
+	skipEncoding?: boolean;
+	/** Progress callback */
+	onProgress?: (rendered: number, encoded: number, total: number) => void;
+}
+/** RGBA color representation */
+export interface RGBAColor {
+	r: number;
+	g: number;
+	b: number;
+	a: number;
+}
+/**
+ * CMYK color representation. Field shape matches `@cesdk/engine` (WASM):
+ * `tint` is required so the same `Color` value works against both bindings.
+ */
+export interface CMYKColor {
+	c: number;
+	m: number;
+	y: number;
+	k: number;
+	tint: number;
+}
+/**
+ * Spot color representation. Field shape matches `@cesdk/engine` (WASM) so
+ * the same `Color` union is interchangeable across both bindings.
+ */
+export interface SpotColor {
+	name: string;
+	tint: number;
+	externalReference: string;
+}
+/** Internal color format from the node native binding */
+export interface ColorInternal {
+	colorSpace: number;
+	components: {
+		x: number;
+		y: number;
+		z: number;
+		w: number;
+	};
+	spotColorName?: string;
+	tint: number;
+	externalReference?: string;
+}
+/** Union of all color types */
+export type Color = RGBAColor | CMYKColor | SpotColor;
+/** Source for image/video content */
+export interface Source {
+	uri: string;
+	width: number;
+	height: number;
+}
+/** Rectangle with position and dimensions */
+export interface XYWH {
+	x: number;
+	y: number;
+	width: number;
+	height: number;
+}
+/**
+ * Tight ink-paint bounding box of a single grapheme, in global scene
+ * coordinates. Returned by `block.getTextCharacterInkBoxes`. The baseline
+ * Y is reported separately because it does not equal `y + height` (the
+ * box is the tight ink rect; the baseline anchors glyph descenders).
+ */
+export interface CharacterInkBox {
+	/** Global X of the tight ink rect (left edge, Y-down scene space). */
+	x: number;
+	/** Global Y of the tight ink rect (top edge, Y-down scene space). */
+	y: number;
+	/** Width of the tight ink rect. */
+	width: number;
+	/** Height of the tight ink rect. */
+	height: number;
+	/** Global Y of the glyph baseline. */
+	baselineY: number;
+}
+/** Range of indices */
+export interface Range {
+	from: number;
+	to: number;
+}
+/** Insets/padding values */
+export interface Insets {
+	top: number;
+	right: number;
+	bottom: number;
+	left: number;
+}
+/** Typeface definition */
+export interface Typeface {
+	name: string;
+	fonts: Font[];
+}
+/**
+ * Allowed font weights. Mirrors the `@cesdk/engine` (WASM) `FontWeight`
+ * union so a single `Font` is interchangeable across bindings.
+ */
+export type FontWeight = "thin" | "extraLight" | "light" | "normal" | "medium" | "semiBold" | "bold" | "extraBold" | "heavy";
+/** Allowed font styles. Mirrors the WASM `FontStyle` union. */
+export type FontStyle = "normal" | "italic";
+/**
+ * Individual font within a typeface. Field optionality matches `@cesdk/engine`
+ * (WASM) — fields not present in the engine response are simply omitted
+ * rather than empty strings.
+ */
+export interface Font {
+	uri: string;
+	subFamily?: string;
+	weight?: FontWeight;
+	style?: FontStyle;
+}
+/** Gradient color stop */
+export interface GradientColorStop {
+	color: Color;
+	stop: number;
+}
+/** Locale tag, e.g. `'en'`, `'de'`. */
+export type Locale = string;
+/**
+ * Groups carry semantic meaning used to build and group UIs over assets
+ * (sections in a content library, topics, etc.). Tags in comparison are
+ * looser, used for extended search/filter.
+ */
+export type Groups = string[];
+/**
+ * Sort order applied by an asset source when supported.
+ * `None` keeps insertion order.
+ */
+export type SortingOrder = "None" | "Ascending" | "Descending";
+/**
+ * Asset metadata.
+ *
+ * The known named fields are descriptive — they hint at how the asset is
+ * meant to be created/used (which block type, mime type, dimensions, etc.).
+ * The trailing `Record<string, unknown>` extension lets sources attach
+ * arbitrary data without losing the named-field type safety.
+ *
+ * The node native binding stores `meta` as a flat string map at the C++
+ * layer; non-string values pass through TypeScript but throw a `TypeError`
+ * at the binding boundary. Treat the rich shape as documentation for the
+ * named fields while sticking to string values across bindings.
+ */
+export type AssetMetaData = {
+	/** The mime type of this asset or the data behind the asset's uri. */
+	mimeType?: string;
+	/** Block type id to create from this asset. */
+	blockType?: string;
+	fillType?: string;
+	shapeType?: string;
+	kind?: string;
+	uri?: string;
+	thumbUri?: string;
+	previewUri?: string;
+	sourceSet?: Source[];
+	filename?: string;
+	vectorPath?: string;
+	width?: number;
+	height?: number;
+	duration?: string;
+	/**
+	 * WASM types this as `EffectType` (a union of effect kind strings); shared
+	 * widens to `string` so this type does not depend on WASM-specific enums.
+	 */
+	effectType?: string;
+	/** WASM types this as `BlurType`; shared widens to `string`. */
+	blurType?: string;
+	looping?: boolean;
+} & Record<string, unknown>;
+/** Asset color payload, RGB representation. */
+export interface AssetRGBColor {
+	colorSpace: "sRGB";
+	r: number;
+	g: number;
+	b: number;
+}
+/** Asset color payload, CMYK representation. */
+export interface AssetCMYKColor {
+	colorSpace: "CMYK";
+	c: number;
+	m: number;
+	y: number;
+	k: number;
+}
+/** Asset color payload, spot-color representation. */
+export interface AssetSpotColor {
+	colorSpace: "SpotColor";
+	name: string;
+	externalReference: string;
+	representation: AssetRGBColor | AssetCMYKColor;
+}
+/** Asset color payload (parallel to engine `Color`; intentionally separate). */
+export type AssetColor = AssetRGBColor | AssetCMYKColor | AssetSpotColor;
+/** Asset transform preset — fixed aspect ratio. */
+export interface AssetFixedAspectRatio {
+	type: "FixedAspectRatio";
+	width: number;
+	height: number;
+}
+/** Asset transform preset — free aspect ratio. */
+export interface AssetFreeAspectRatio {
+	type: "FreeAspectRatio";
+}
+/** Asset transform preset — snap to the intrinsic content aspect ratio. */
+export interface AssetContentAspectRatio {
+	type: "ContentAspectRatio";
+}
+/** Asset transform preset — fixed size in design units. */
+export interface AssetFixedSize {
+	type: "FixedSize";
+	width: number;
+	height: number;
+	designUnit: DesignUnit;
+}
+/** Transform preset payload union. */
+export type AssetTransformPreset = AssetFixedAspectRatio | AssetFreeAspectRatio | AssetContentAspectRatio | AssetFixedSize;
+/** Structured asset payload. */
+export interface AssetPayload {
+	color?: AssetColor;
+	sourceSet?: Source[];
+	typeface?: Typeface;
+	transformPreset?: AssetTransformPreset;
+	properties?: AssetProperty[];
+}
+/** Generic asset information. */
+export interface Asset {
+	id: string;
+	groups?: Groups;
+	/** Asset-specific and custom meta information. */
+	meta?: AssetMetaData;
+	/** Structured asset-specific data. */
+	payload?: AssetPayload;
+}
+/**
+ * Query for searching assets. Field shape mirrors `@cesdk/engine`'s
+ * `AssetQueryData` so a single query object is interchangeable across
+ * bindings. `page` and `perPage` are required by WASM but kept optional
+ * here so simpler callers (e.g., native shared tests) can omit them; the
+ * binding layers fall back to defaults.
+ */
+export interface AssetsQuery {
+	query?: string;
+	page?: number;
+	perPage?: number;
+	groups?: Groups;
+	/** Filter by tags. Pass a string for one tag, or an array for any-of. */
+	tags?: string | string[];
+	locale?: Locale;
+	excludeGroups?: Groups;
+	sortKey?: string;
+	sortingOrder?: SortingOrder | string;
+	sortActiveFirst?: boolean;
+	/**
+	 * Structured filter, AND-combined with `query` / `tags` / `groups` /
+	 * `excludeGroups`. The top-level array is an implicit AND of its
+	 * entries.
+	 *
+	 * Prefer `filter` over the legacy `tags` / `groups` / `excludeGroups`
+	 * fields for anything beyond a plain case-sensitive include/exclude
+	 * list (substring matches, `meta.<key>`, `or` / `not` combinators).
+	 */
+	filter?: AssetFilter[];
+}
+/** Alias matching the WASM public type name. */
+export type AssetQueryData = AssetsQuery;
+/**
+ * Dot-path against the resolved asset that a property predicate targets:
+ * `label`, `id`, `tags`, `groups`, or `meta.<key>` (one segment — meta
+ * values in the engine are flat strings).
+ *
+ * The template literal accepts `'meta.'` (empty key) because TypeScript's
+ * `${string}` includes the empty string; the engine rejects this at
+ * runtime with an explanatory error.
+ * @public
+ */
+export type AssetPropertyPath = "label" | "tags" | "id" | "groups" | `meta.${string}`;
+/**
+ * A single property predicate. Exactly one of `contains` (case-insensitive
+ * substring) or `equals` (case-insensitive equality) must be set — the
+ * type forbids passing both or neither. On a string-array property
+ * (`tags`, `groups`), the operator matches if any element matches.
+ *
+ * `meta.<key>` values are flat strings in the engine; if a meta value
+ * was originally serialized as a number or boolean, stringify it the
+ * same way before comparing.
+ * @public
+ */
+export type AssetPropertyFilter = {
+	property: AssetPropertyPath;
+} & ({
+	contains: string;
+	equals?: never;
+} | {
+	equals: string;
+	contains?: never;
+});
+/**
+ * Filter expression — predicate or logical combinator. Combinators nest
+ * arbitrarily. The union is mutually exclusive: an object with both
+ * `and` and `or`, or with `property` next to a combinator key, is
+ * rejected at the type level.
+ *
+ * Missing-key semantics for `not`: a predicate is `false` on an asset
+ * that lacks the targeted field, so a negated `meta.foo === 'x'` matches
+ * assets where `meta.foo !== 'x'` **and** assets that lack `meta.foo`
+ * entirely.
+ * @public
+ */
+export type AssetFilter = AssetPropertyFilter | {
+	and: AssetFilter[];
+	or?: never;
+	not?: never;
+	property?: never;
+} | {
+	or: AssetFilter[];
+	and?: never;
+	not?: never;
+	property?: never;
+} | {
+	not: AssetFilter;
+	and?: never;
+	or?: never;
+	property?: never;
+};
+/**
+ * Result of an assets query. Generic over the result element type so a
+ * binding can refine the surface (WASM returns `CompleteAssetResult`).
+ * `nextPage` is optional — bindings that paginate finitely return
+ * undefined when there's no next page.
+ */
+export interface AssetsQueryResult<T extends AssetResult = AssetResult> {
+	assets: T[];
+	currentPage: number;
+	total: number;
+	nextPage?: number;
+}
+/** Asset source license information */
+export interface AssetSourceLicense {
+	name: string;
+	url?: string;
+}
+/** Asset source credits information */
+export interface AssetSourceCredits {
+	name: string;
+	url?: string;
+}
+/** Audio track information */
+export interface AudioTrackInfo {
+	audioCodec: string;
+	channels: number;
+	sampleRate: number;
+	audioDuration: number;
+	numAudioPackets: number;
+	numAudioFrames: number;
+	trackName: string;
+	trackIndex: number;
+	language: string;
+}
+/**
+ * Supported MIME types. Mirrors `@cesdk/node`'s const-object shape
+ * (`bindings/wasm/js_web/src/types/MimeType.ts`) verbatim so
+ * `MimeType.Png`, `MimeType.Jpeg`, etc. are interchangeable across
+ * bindings.
+ *
+ * @public
+ * @deprecated Use the `MimeType` string literal types instead.
+ */
+export declare const MimeType: {
+	readonly Png: "image/png";
+	readonly Jpeg: "image/jpeg";
+	readonly WebP: "image/webp";
+	readonly Tga: "image/x-tga";
+	readonly Svg: "image/svg+xml";
+	readonly Wav: "audio/wav";
+	readonly Mp4Audio: "audio/mp4";
+	readonly Mp4: "video/mp4";
+	readonly QuickTime: "video/quicktime";
+	readonly Binary: "application/octet-stream";
+	readonly Pdf: "application/pdf";
+	readonly Zip: "application/zip";
+};
+/** @public */
+export type MimeType = (typeof MimeType)[keyof typeof MimeType];
+/** @public */
+export type ImageMimeType = Extract<MimeType, "image/png" | "image/jpeg" | "image/webp" | "image/x-tga" | "image/svg+xml">;
+/** @public */
+export type AudioMimeType = Extract<MimeType, "audio/wav" | "audio/mp4">;
+/** @public */
+export type VideoMimeType = Extract<MimeType, "video/mp4" | "video/quicktime">;
+/** @public */
+export type ApplicationMimeType = Extract<MimeType, "application/octet-stream" | "application/pdf" | "application/zip">;
+/** Scene modes */
+export type SceneMode = "Design" | "Video";
+/** Design units */
+export type DesignUnit = "Pixel" | "Millimeter" | "Inch";
+/** Position modes */
+export type PositionMode = "Absolute" | "Percent" | "Auto";
+/** Size modes */
+export type SizeMode = "Absolute" | "Percent" | "Auto";
+/** Blend modes */
+export type BlendMode = "PassThrough" | "Normal" | "Darken" | "Multiply" | "ColorBurn" | "LinearBurn" | "DarkenColor" | "Lighten" | "Screen" | "ColorDodge" | "LinearDodge" | "LightenColor" | "Overlay" | "SoftLight" | "HardLight" | "VividLight" | "LinearLight" | "PinLight" | "HardMix" | "Difference" | "Exclusion" | "Subtract" | "Divide" | "Hue" | "Saturation" | "Color" | "Luminosity";
+/** Stroke styles */
+export type StrokeStyle = "Solid" | "Dashed" | "DashedRound" | "LongDashed" | "LongDashedRound";
+/** Stroke positions */
+export type StrokePosition = "Center" | "Inner" | "Outer";
+/** Stroke corner geometry */
+export type StrokeCornerGeometry = "Round" | "Miter" | "Bevel";
+/** Stroke cap geometry for open paths (line shapes, dashes). */
+export type StrokeCap = "Butt" | "Round" | "Square";
+/** Text horizontal alignment */
+export type TextHorizontalAlignment = "Left" | "Center" | "Right";
+/** Text vertical alignment */
+export type TextVerticalAlignment = "Top" | "Center" | "Bottom";
+/** Property types */
+export type PropertyType = "Bool" | "Int" | "Float" | "Double" | "String" | "Enum" | "Color" | "Struct" | "SourceSet";
+/** Block event types */
+/**
+ * The kind of block-lifecycle event the engine emits. Matches the engine's
+ * internal `BlockEventType` enum used in subscription payloads.
+ */
+export type BlockEventType = "Created" | "Updated" | "Destroyed";
+/**
+ * Subscription payload delivered to `engine.event.subscribe` callbacks.
+ * Field shape matches `@cesdk/engine` (WASM) so subscribers can be written
+ * once and run against either binding.
+ */
+export interface BlockEvent {
+	block: DesignBlockId;
+	type: BlockEventType;
+}
+/** Scene layout type */
+export type SceneLayout = string;
+/** Asset property types for dynamic asset configuration */
+export interface AssetStringProperty {
+	property: string;
+	type: "String";
+	value: string;
+	defaultValue: string;
+}
+export interface AssetNumberProperty {
+	property: string;
+	type: "Int" | "Float" | "Double";
+	value: number;
+	defaultValue: number;
+	min: number;
+	max: number;
+	step: number;
+}
+export interface AssetBooleanProperty {
+	property: string;
+	type: "Boolean";
+	value: boolean;
+	defaultValue: boolean;
+}
+export interface AssetEnumProperty {
+	property: string;
+	type: "Enum";
+	value: string;
+	defaultValue: string;
+	options: string[];
+}
+export interface AssetColorProperty {
+	property: string;
+	type: "Color";
+	value: Color;
+	defaultValue: Color;
+}
+/** Union of all asset property types */
+export type AssetProperty = AssetBooleanProperty | AssetColorProperty | AssetEnumProperty | AssetNumberProperty | AssetStringProperty;
+/**
+ * Single asset returned from `findAssets`. Field shape mirrors `@cesdk/engine`
+ * (WASM) so a single result is interchangeable across bindings. `label` and
+ * `tags` here are flat strings (already resolved to `locale`); compare to
+ * `AssetDefinition` where they are localized maps.
+ */
+export interface AssetResult extends Asset {
+	/** The locale of the label and tags */
+	locale?: Locale;
+	/** Resolved label for the active locale. */
+	label?: string;
+	/** Resolved tags for the active locale. */
+	tags?: string[];
+	/** If the asset is marked as active */
+	active?: boolean;
+	/** Credits for the asset */
+	credits?: {
+		name: string;
+		url?: string;
+	};
+	/** License for this asset */
+	license?: {
+		name: string;
+		url?: string;
+	};
+	/** UTM parameters */
+	utm?: {
+		source?: string;
+		medium?: string;
+	};
+}
+/** Complete asset result with context information */
+export interface CompleteAssetResult extends AssetResult {
+	/** Context of how/where the asset was used */
+	context: {
+		sourceId: string;
+	};
+	/** Always present in complete results */
+	active: boolean;
+}
+/**
+ * Asset definition supplied to `addAsset`. Distinct from `AssetResult`:
+ * `label` and `tags` here are localized maps (`Locale -> value`) so a single
+ * definition can serve every supported locale.
+ */
+export interface AssetDefinition extends Asset {
+	/** Localized labels (one entry per supported locale). */
+	label?: Record<Locale, string>;
+	/** Localized tags (one entry per supported locale). */
+	tags?: Record<Locale, string[]>;
+}
+/**
+ * A source of assets that can be registered with the engine.
+ * Allows custom asset sources with callbacks for querying and applying assets.
+ */
+export interface AssetSource {
+	/** The unique id of this asset source */
+	id: string;
+	/**
+	 * Find assets matching the query.
+	 * This is the only required callback.
+	 */
+	findAssets(queryData: AssetsQuery): Promise<AssetsQueryResult | undefined>;
+	/** Fetch a single asset by id */
+	fetchAsset?: (id: string, params?: {
+		locale?: string;
+	}) => Promise<AssetResult | null>;
+	/** Return available groups */
+	getGroups?: () => Promise<string[]>;
+	/** Credits for this source */
+	credits?: {
+		name: string;
+		url?: string;
+	};
+	/** General license for assets from this source */
+	license?: {
+		name: string;
+		url?: string;
+	};
+	/**
+	 * @deprecated Will be removed in v1.11
+	 */
+	canManageAssets?: boolean;
+	/** Apply an asset to the active scene */
+	applyAsset?: (asset: CompleteAssetResult) => Promise<DesignBlockId | undefined>;
+	/** Apply an asset to a specific block */
+	applyAssetToBlock?: (asset: CompleteAssetResult, block: DesignBlockId) => Promise<void>;
+	/** Apply a property of an asset */
+	applyAssetProperty?: (asset: CompleteAssetResult, property: AssetProperty) => Promise<void>;
+	/** Add an asset to this source */
+	addAsset?: (asset: AssetDefinition) => void;
+	/** Remove an asset from this source */
+	removeAsset?: (assetId: string) => void;
+	/** Get supported MIME types */
+	getSupportedMimeTypes?: () => string[] | undefined;
+}
+/**
+ * Hex color string starting with `#`. `@cesdk/node` exposes this as a
+ * branded string alias; we use a plain string alias for runtime parity.
+ *
+ * @public
+ */
+export type HexColorString = string;
+/**
+ * RGB color (no alpha). Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/types/color.ts`.
+ *
+ * @public
+ */
+export interface RGBColor {
+	/** Red component (0..1). */
+	r: number;
+	/** Green component (0..1). */
+	g: number;
+	/** Blue component (0..1). */
+	b: number;
+}
+/**
+ * Custom-palette color. Mirrors `@cesdk/node`'s `PaletteColor`.
+ *
+ * @public
+ */
+export type PaletteColor = HexColorString | RGBColor | RGBAColor | SpotColor;
+/**
+ * Engine color space discriminator.
+ *
+ * @public
+ */
+export type ColorSpace = "sRGB" | "CMYK" | "SpotColor";
+/** @public */
+export interface Vec2 {
+	x: number;
+	y: number;
+}
+/** @public */
+export interface Vec3 {
+	x: number;
+	y: number;
+	z: number;
+}
+/** @public */
+export interface Size2 {
+	width: number;
+	height: number;
+}
+/**
+ * Per-export tracking metadata sent to the engine's tracking pipeline.
+ *
+ * @public
+ */
+export interface TrackingMetadata {
+	[key: string]: string | number | boolean;
+}
+/** @public */
+export type ZoomAutoFitAxis = "Horizontal" | "Vertical" | "Both";
+/**
+ * Editor edit mode. Mirrors `@cesdk/node`'s `EditMode` literal union.
+ *
+ * @public
+ */
+export type EditMode = "Transform" | "Crop" | "Text" | "TextLink" | "Playback" | "AdjustmentsCutout" | "AdjustmentsVectorEdit" | string;
+/**
+ * Scene-level design unit. Alias of {@link DesignUnit} for cross-binding
+ * naming parity (`@cesdk/node` exposes both names).
+ *
+ * @public
+ */
+export type SceneDesignUnit = DesignUnit;
+/**
+ * Font-size unit. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/utils/unitConversion.ts`. `'Point'` is
+ * the engine's native unit; the rest are converted to points before
+ * reaching the C++ engine via DPI-aware conversion.
+ *
+ * @public
+ */
+export type FontSizeUnit = SceneDesignUnit | "Point";
+/**
+ * Engine role string. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/types/role.ts`. The engine accepts arbitrary
+ * strings; well-known values are `'Adopter'` and `'Creator'`.
+ *
+ * @public
+ */
+export type RoleString = "Adopter" | "Creator" | string;
+/**
+ * Engine scope string. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/types/scope.ts`.
+ *
+ * @public
+ */
+export type Scope = string;
+/**
+ * Single page's timing window. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/types/Pageduration.ts`.
+ *
+ * @public
+ */
+export interface PageDuration {
+	pageId: DesignBlockId;
+	duration: number;
+	start: number;
+	end: number;
+}
+/**
+ * Boolean operation between cutout shapes. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/types/cutout.ts`.
+ *
+ * @public
+ */
+export type CutoutOperation = "Union" | "Difference" | "Intersection";
+/**
+ * Boolean operation for `block.combineShapes` / cutout creation.
+ *
+ * @public
+ */
+export type BooleanOperation = "Union" | "Difference" | "Intersection" | "XOR";
+/**
+ * Text case transform. Mirrors `@cesdk/node`'s `BlockAPI.ts`.
+ *
+ * @public
+ */
+export type TextCase = "Normal" | "Uppercase" | "Lowercase" | "Titlecase";
+/**
+ * Ordered/unordered text list style. Mirrors `@cesdk/node`'s
+ * `BlockAPI.ts`.
+ *
+ * @public
+ */
+export type ListStyle = "None" | "Disc" | "Decimal";
+/**
+ * Multi-block horizontal alignment passed to `block.alignHorizontally`.
+ * Alias of {@link TextHorizontalAlignment} for cross-binding naming
+ * parity (`@cesdk/node` re-exports it under this name from `BlockAPI`).
+ *
+ * @public
+ */
+export type HorizontalBlockAlignment = TextHorizontalAlignment;
+/**
+ * Multi-block vertical alignment passed to `block.alignVertically`.
+ * Alias of {@link TextVerticalAlignment}.
+ *
+ * @public
+ */
+export type VerticalBlockAlignment = TextVerticalAlignment;
+/**
+ * Dominant color sample returned from `block.getDominantColors`.
+ *
+ * @public
+ */
+export interface DominantColor {
+	/** sRGB color. */
+	color: RGBAColor;
+	/** Relative weight in the source image (0..1). */
+	weight: number;
+}
+/**
+ * Options for `block.getDominantColors`.
+ *
+ * @public
+ */
+export interface DominantColorsOptions {
+	/** Number of color samples to compute. Default: 6. */
+	numColors?: number;
+	/** Sample-grid step in pixels. Higher = faster, lower = more accurate. */
+	step?: number;
+}
+/**
+ * Options for `block.split`. Mirrors `@cesdk/node`'s `SplitOptions`.
+ *
+ * @public
+ */
+export interface SplitOptions {
+	/** Attach the new tail block to the original parent. Default: true. */
+	attachToParent?: boolean;
+	/** Create a parent track if needed. Default: true. */
+	createParentTrackIfNeeded?: boolean;
+	/** Select the newly created tail block after split. Default: false. */
+	selectNewBlock?: boolean;
+}
+/**
+ * Options for `block.setTextFontSize` (new overload). Mirrors
+ * `@cesdk/node`'s `TextFontSizeOptions`.
+ *
+ * @public
+ */
+export interface TextFontSizeOptions {
+	/** Unit of the supplied size value. Default: `'Point'`. */
+	unit?: FontSizeUnit;
+	/** Inclusive start grapheme index of the run. Default: -1 (whole block). */
+	from?: number;
+	/** Exclusive end grapheme index of the run. Default: -1 (whole block). */
+	to?: number;
+}
+/**
+ * Animation entry on `applyAnimation`'s options object.
+ *
+ * @public
+ */
+export interface AnimationEntry {
+	/** Animation type id (shorthand or longhand). */
+	type: AnimationTypeShorthand | AnimationTypeLonghand;
+	/** Animation duration in seconds. */
+	duration?: number;
+	/** Animation start delay in seconds. */
+	delay?: number;
+	/**
+	 * Easing curve. Loose `string` here so each binding can narrow it to
+	 * its own `AnimationEasing` union (`@cesdk/node`'s 18-entry list vs
+	 * the WASM web list).
+	 */
+	easing?: string;
+}
+/**
+ * Options for `block.applyAnimation`.
+ *
+ * @public
+ */
+export interface AnimationOptions {
+	in?: AnimationEntry;
+	loop?: AnimationEntry;
+	out?: AnimationEntry;
+}
+/**
+ * Options for `block.applyDropShadow`.
+ *
+ * @public
+ */
+export interface DropShadowOptions {
+	color?: Color;
+	offset?: {
+		x?: number;
+		y?: number;
+	};
+	blur?: {
+		x?: number;
+		y?: number;
+	};
+}
+/**
+ * Options for `block.addImage`.
+ *
+ * @public
+ */
+export interface AddImageOptions {
+	sizeMode?: SizeMode;
+	positionMode?: PositionMode;
+	x?: number;
+	y?: number;
+	cornerRadius?: number;
+	size?: number | {
+		width: number;
+		height: number;
+	};
+	timeline?: {
+		timeOffset?: number;
+		duration?: number;
+	};
+	shadow?: DropShadowOptions;
+	animation?: AnimationOptions;
+}
+/**
+ * Options for `block.addVideo`.
+ *
+ * @public
+ */
+export interface AddVideoOptions extends AddImageOptions {
+	trimOffset?: number;
+	loop?: boolean;
+	muted?: boolean;
+}
+/**
+ * Options for `block.getAudioInfoFromVideo` /
+ * `block.createAudiosFromVideo`.
+ *
+ * @public
+ */
+export interface AudioFromVideoOptions {
+	trackIndex?: number;
+}
+/**
+ * Options for `block.applyAsset`. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/AssetAPI.ts`.
+ *
+ * @public
+ */
+export interface ApplyAssetOptions {
+	/** Block id to apply the asset to. If omitted, asset becomes a new block. */
+	block?: DesignBlockId;
+}
+/**
+ * Discriminator for `editor.{get,set}Setting` family. Mirrors the strings
+ * accepted by `@cesdk/node`'s typed setter overloads.
+ *
+ * @public
+ */
+export type SettingType = "bool" | "int" | "float" | "string" | "color" | "enum";
+/** @public */
+export type SettingsBool = string;
+/** @public */
+export type SettingsInt = string;
+/** @public */
+export type SettingsFloat = string;
+/** @public */
+export type SettingsString = string;
+/** @public */
+export type SettingsColor = string;
+/** @public */
+export type SettingsColorRGBA = string;
+/** @public */
+export type SettingsEnum = string;
+/**
+ * Helper that strips an optional `ubq://` prefix from a settings keypath.
+ * Mirrors `@cesdk/node`'s `OptionalPrefix<T>`.
+ *
+ * @public
+ */
+export type OptionalPrefix<T extends string> = T | `ubq://${T}`;
+/**
+ * Synchronous URI resolver. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/EditorAPI.ts`.
+ *
+ * @public
+ */
+export type SyncURIResolver = (uri: string, defaultResolver?: SyncURIResolver) => string;
+/**
+ * Asynchronous URI resolver. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/EditorAPI.ts`.
+ *
+ * @public
+ */
+export type AsyncURIResolver = (uri: string, defaultResolver?: AsyncURIResolver) => Promise<string> | string;
+/**
+ * Discriminator emitted by `editor.onHistoryUpdatedWithKind`. Matches engine
+ * `ubq::editor::HistoryUpdate` (`engine/src/ubq/editor/History.hpp`).
+ *
+ * - `Updated`: a snapshot was added or undo/redo applied (scene state mutated).
+ * - `Activated`: a different history buffer was activated via
+ *   `setActiveHistory`. The visible undo stack changed but no new snapshot
+ *   was created — save-button logic should ignore this.
+ *
+ * @public
+ */
+export type HistoryUpdate = "Updated" | "Activated";
+/**
+ * Horizontal alignment of the content fill inside a block. Applies when
+ * `ContentFillMode` is `Contain` or `Cover`. Mirrors engine
+ * `ubq::types::HorizontalContentFillAlignment`
+ * (`engine/src/ubq/types/ContentFillAlignment.hpp`).
+ *
+ * @public
+ */
+export type HorizontalContentFillAlignment = "Left" | "Center" | "Right";
+/**
+ * Vertical alignment of the content fill inside a block. Applies when
+ * `ContentFillMode` is `Contain` or `Cover`. Mirrors engine
+ * `ubq::types::VerticalContentFillAlignment`
+ * (`engine/src/ubq/types/ContentFillAlignment.hpp`).
+ *
+ * @public
+ */
+export type VerticalContentFillAlignment = "Top" | "Center" | "Bottom";
+/**
+ * Typeface migration entry shipped on the deprecated
+ * `Configuration.presets.typefaces` field. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/configuration/types.ts`.
+ *
+ * @public
+ */
+export interface TypefaceDefinition {
+	name: string;
+	fonts: Array<{
+		uri: string;
+		subFamily?: string;
+		weight?: FontWeight;
+		style?: FontStyle;
+	}>;
+}
+/**
+ * Type guard for {@link RGBAColor}.
+ *
+ * @public
+ */
+export declare function isRGBAColor(color: Color): color is RGBAColor;
+/**
+ * Type guard for {@link SpotColor}.
+ *
+ * @public
+ */
+export declare function isSpotColor(color: Color): color is SpotColor;
+/**
+ * Type guard for {@link CMYKColor}.
+ *
+ * @public
+ */
+export declare function isCMYKColor(color: Color): color is CMYKColor;
+/**
+ * Default logger used by `@cesdk/node-native` when `Configuration.logger`
+ * is not supplied. Routes by level to `console.info` / `console.warn` /
+ * `console.error`, mirroring `@cesdk/node`'s defaultLogger
+ * (`bindings/wasm/js_web/src/configuration/defaultLogger.ts`).
+ *
+ * @public
+ */
+export function defaultLogger(message: string, level?: LogLevel): void;
+/**
+ * Interface for block operations
+ * Provides methods for creating, manipulating, and querying design blocks
+ */
+export interface IBlockAPI {
+	create(type: string): DesignBlockId;
+	createFill(type: string): DesignBlockId;
+	createShape(type: string): DesignBlockId;
+	createEffect(type: string): DesignBlockId;
+	createBlur(type: string): DesignBlockId;
+	createAnimation(type: string): DesignBlockId;
+	duplicate(block: DesignBlockId, attachToParent?: boolean): DesignBlockId;
+	destroy(block: DesignBlockId): void;
+	isValid(block: DesignBlockId): boolean;
+	findAll(): DesignBlockId[];
+	findAllPlaceholders(): DesignBlockId[];
+	findByName(name: string): DesignBlockId[];
+	findByType(type: string): DesignBlockId[];
+	findByKind(kind: string): DesignBlockId[];
+	findAllSelected(): DesignBlockId[];
+	getParent(block: DesignBlockId): DesignBlockId | null;
+	getChildren(block: DesignBlockId): DesignBlockId[];
+	insertChild(parent: DesignBlockId, child: DesignBlockId, index: number): void;
+	appendChild(parent: DesignBlockId, child: DesignBlockId): void;
+	getType(block: DesignBlockId): string;
+	getKind(block: DesignBlockId): string;
+	setKind(block: DesignBlockId, kind: string): void;
+	getName(block: DesignBlockId): string;
+	setName(block: DesignBlockId, name: string): void;
+	getUUID(block: DesignBlockId): string;
+	getBool(block: DesignBlockId, property: string): boolean;
+	setBool(block: DesignBlockId, property: string, value: boolean): void;
+	getInt(block: DesignBlockId, property: string): number;
+	setInt(block: DesignBlockId, property: string, value: number): void;
+	getFloat(block: DesignBlockId, property: string): number;
+	setFloat(block: DesignBlockId, property: string, value: number): void;
+	getDouble(block: DesignBlockId, property: string): number;
+	setDouble(block: DesignBlockId, property: string, value: number): void;
+	getString(block: DesignBlockId, property: string): string;
+	setString(block: DesignBlockId, property: string, value: string): void;
+	getColor(block: DesignBlockId, property: string): Color;
+	setColor(block: DesignBlockId, property: string, value: Color): void;
+	getEnum(block: DesignBlockId, property: string): string;
+	setEnum(block: DesignBlockId, property: string, value: string): void;
+	getPositionX(block: DesignBlockId): number;
+	setPositionX(block: DesignBlockId, value: number): void;
+	getPositionY(block: DesignBlockId): number;
+	setPositionY(block: DesignBlockId, value: number): void;
+	getPositionXMode(block: DesignBlockId): string;
+	setPositionXMode(block: DesignBlockId, mode: string): void;
+	getPositionYMode(block: DesignBlockId): string;
+	setPositionYMode(block: DesignBlockId, mode: string): void;
+	getWidth(block: DesignBlockId): number;
+	setWidth(block: DesignBlockId, value: number): void;
+	getWidthMode(block: DesignBlockId): string;
+	setWidthMode(block: DesignBlockId, mode: string): void;
+	getHeight(block: DesignBlockId): number;
+	setHeight(block: DesignBlockId, value: number): void;
+	getHeightMode(block: DesignBlockId): string;
+	setHeightMode(block: DesignBlockId, mode: string): void;
+	getRotation(block: DesignBlockId): number;
+	setRotation(block: DesignBlockId, value: number): void;
+	getGlobalBoundingBoxX(block: DesignBlockId): number;
+	getGlobalBoundingBoxY(block: DesignBlockId): number;
+	getGlobalBoundingBoxWidth(block: DesignBlockId): number;
+	getGlobalBoundingBoxHeight(block: DesignBlockId): number;
+	getScreenSpaceBoundingBoxXYWH(blocks: DesignBlockId[]): XYWH | readonly [
+		number,
+		number,
+		number,
+		number
+	];
+	supportsFill(block: DesignBlockId): boolean;
+	hasFill(block: DesignBlockId): boolean;
+	getFill(block: DesignBlockId): DesignBlockId;
+	setFill(block: DesignBlockId, fill: DesignBlockId): void;
+	isFillEnabled(block: DesignBlockId): boolean;
+	setFillEnabled(block: DesignBlockId, enabled: boolean): void;
+	getFillSolidColor(block: DesignBlockId): Color | readonly [
+		number,
+		number,
+		number,
+		number
+	];
+	setFillSolidColor(block: DesignBlockId, r: number, g: number, b: number, a?: number): void;
+	getGradientColorStops(block: DesignBlockId, property: string): GradientColorStop[];
+	setGradientColorStops(block: DesignBlockId, property: string, stops: GradientColorStop[]): void;
+	supportsStroke(block: DesignBlockId): boolean;
+	hasStroke(block: DesignBlockId): boolean;
+	isStrokeEnabled(block: DesignBlockId): boolean;
+	setStrokeEnabled(block: DesignBlockId, enabled: boolean): void;
+	getStrokeColor(block: DesignBlockId): Color;
+	setStrokeColor(block: DesignBlockId, color: Color): void;
+	getStrokeColorRGBA(block: DesignBlockId): RGBAColor | readonly [
+		number,
+		number,
+		number,
+		number
+	];
+	setStrokeColorRGBA(block: DesignBlockId, r: number, g: number, b: number, a: number): void;
+	getStrokeWidth(block: DesignBlockId): number;
+	setStrokeWidth(block: DesignBlockId, width: number): void;
+	setStrokeCap(block: DesignBlockId, cap: StrokeCap): void;
+	getStrokeCap(block: DesignBlockId): StrokeCap;
+	setStrokeStartCap(block: DesignBlockId, cap: StrokeCap): void;
+	getStrokeStartCap(block: DesignBlockId): StrokeCap;
+	setStrokeEndCap(block: DesignBlockId, cap: StrokeCap): void;
+	getStrokeEndCap(block: DesignBlockId): StrokeCap;
+	setStrokeDashStartCap(block: DesignBlockId, cap: StrokeCap): void;
+	getStrokeDashStartCap(block: DesignBlockId): StrokeCap;
+	setStrokeDashEndCap(block: DesignBlockId, cap: StrokeCap): void;
+	getStrokeDashEndCap(block: DesignBlockId): StrokeCap;
+	setStrokeDashArray(block: DesignBlockId, dashArray: number[]): void;
+	getStrokeDashArray(block: DesignBlockId): number[];
+	setStrokeDashOffset(block: DesignBlockId, dashOffset: number): void;
+	getStrokeDashOffset(block: DesignBlockId): number;
+	isLineOrigin(block: DesignBlockId): boolean;
+	supportsEffects(block: DesignBlockId): boolean;
+	hasEffects(block: DesignBlockId): boolean;
+	getEffects(block: DesignBlockId): DesignBlockId[];
+	appendEffect(block: DesignBlockId, effect: DesignBlockId): void;
+	insertEffect(block: DesignBlockId, effect: DesignBlockId, index: number): void;
+	removeEffect(block: DesignBlockId, index: number): void;
+	isEffectEnabled(effect: DesignBlockId): boolean;
+	setEffectEnabled(effect: DesignBlockId, enabled: boolean): void;
+	supportsBlur(block: DesignBlockId): boolean;
+	hasBlur(block: DesignBlockId): boolean;
+	getBlur(block: DesignBlockId): DesignBlockId;
+	setBlur(block: DesignBlockId, blur: DesignBlockId): void;
+	isBlurEnabled(block: DesignBlockId): boolean;
+	setBlurEnabled(block: DesignBlockId, enabled: boolean): void;
+	supportsDropShadow(block: DesignBlockId): boolean;
+	isDropShadowEnabled(block: DesignBlockId): boolean;
+	setDropShadowEnabled(block: DesignBlockId, enabled: boolean): void;
+	getDropShadowColor(block: DesignBlockId): Color;
+	setDropShadowColor(block: DesignBlockId, color: Color): void;
+	getDropShadowColorRGBA(block: DesignBlockId): RGBAColor | readonly [
+		number,
+		number,
+		number,
+		number
+	];
+	setDropShadowColorRGBA(block: DesignBlockId, r: number, g: number, b: number, a: number): void;
+	supportsBlendMode(block: DesignBlockId): boolean;
+	getBlendMode(block: DesignBlockId): string;
+	setBlendMode(block: DesignBlockId, mode: string): void;
+	supportsOpacity(block: DesignBlockId): boolean;
+	getOpacity(block: DesignBlockId): number;
+	setOpacity(block: DesignBlockId, opacity: number): void;
+	isVisible(block: DesignBlockId): boolean;
+	setVisible(block: DesignBlockId, visible: boolean): void;
+	isClipped(block: DesignBlockId): boolean;
+	setClipped(block: DesignBlockId, clipped: boolean): void;
+	setSelected(block: DesignBlockId, selected: boolean): void;
+	isSelected(block: DesignBlockId): boolean;
+	select(block: DesignBlockId): void;
+	hasMetadata(block: DesignBlockId, key: string): boolean;
+	getMetadata(block: DesignBlockId, key: string): string;
+	setMetadata(block: DesignBlockId, key: string, value: string): void;
+	removeMetadata(block: DesignBlockId, key: string): void;
+	findAllMetadata(block: DesignBlockId): string[];
+	replaceText(block: DesignBlockId, text: string, from?: number, to?: number): void;
+	removeText(block: DesignBlockId, from?: number, to?: number): void;
+	getTextFontSizes(block: DesignBlockId, options?: TextFontSizeOptions): number[];
+	getTextFontSizes(block: DesignBlockId, from?: number, to?: number): number[];
+	setTextFontSize(block: DesignBlockId, size: number): void;
+	getTextColors(block: DesignBlockId): Color[];
+	setTextColor(block: DesignBlockId, color: Color): void;
+	/**
+	 * Resolves the typefaces in use across `block`'s text.
+	 *
+	 * - Without `from`/`to`: returns the union of typefaces resolved across
+	 *   the entire text (never throws on partial coverage).
+	 * - With a range: throws `block has no typeface` when the range has no
+	 *   explicit typeface assignment. Pass the range when you need the
+	 *   strict "no-typeface" signal for downstream font discovery.
+	 */
+	getTypefaces(block: DesignBlockId, from?: number, to?: number): Typeface[];
+	setTypeface(block: DesignBlockId, typeface: Typeface): void;
+	getTypeface(block: DesignBlockId): Typeface;
+	setFont(block: DesignBlockId, fontUri: string, typeface: Typeface): void;
+	setTextKerning(block: DesignBlockId, kerning: number, from?: number, to?: number): void;
+	getTextKernings(block: DesignBlockId, from?: number, to?: number): number[];
+	getTextCharacterInkBoxes(block: DesignBlockId, from?: number, to?: number): CharacterInkBox[];
+	setContentFillHorizontalAlignment(block: DesignBlockId, alignment: HorizontalContentFillAlignment): void;
+	getContentFillHorizontalAlignment(block: DesignBlockId): HorizontalContentFillAlignment;
+	setContentFillVerticalAlignment(block: DesignBlockId, alignment: VerticalContentFillAlignment): void;
+	getContentFillVerticalAlignment(block: DesignBlockId): VerticalContentFillAlignment;
+	getSourceSet(block: DesignBlockId, property: string): Source[];
+	setSourceSet(block: DesignBlockId, property: string, sources: Source[]): void;
+	addImageFileURIToSourceSet(block: DesignBlockId, property: string, uri: string): Promise<void>;
+	addVideoFileURIToSourceSet(block: DesignBlockId, property: string, uri: string): Promise<void>;
+	supportsDuration(block: DesignBlockId): boolean;
+	getDuration(block: DesignBlockId): number;
+	setDuration(block: DesignBlockId, duration: number): void;
+	supportsTimeOffset(block: DesignBlockId): boolean;
+	getTimeOffset(block: DesignBlockId): number;
+	setTimeOffset(block: DesignBlockId, offset: number): void;
+	loadFromString(content: string): Promise<DesignBlockId[]>;
+	loadFromURL(url: string): Promise<DesignBlockId[]>;
+	saveToString(blocks: DesignBlockId[]): Promise<string>;
+	saveToArchive(blocks: DesignBlockId[]): Promise<Uint8Array | Blob>;
+	onStateChanged(ids: DesignBlockId[], callback: (ids: DesignBlockId[]) => void): () => void;
+	onSelectionChanged(callback: () => void): () => void;
+	onClicked(callback: (id: DesignBlockId) => void): () => void;
+}
+/**
+ * Interface for scene operations
+ * Provides methods for creating, loading, and saving scenes
+ */
+export interface ISceneAPI {
+	create(): DesignBlockId;
+	createVideo(): DesignBlockId;
+	createFromImage(uri: string, dpi?: number, pixelScaleFactor?: number): Promise<DesignBlockId>;
+	createFromVideo(uri: string): Promise<DesignBlockId>;
+	loadFromString(content: string): Promise<DesignBlockId>;
+	loadFromURL(url: string): Promise<DesignBlockId>;
+	saveToString(options?: {
+		allowedResourceSchemes?: string[];
+		onDisallowedResourceScheme?: (url: string, dataHash: string) => Promise<string>;
+		compression?: {
+			format?: number;
+			level?: number;
+		};
+	}): Promise<string>;
+	saveToArchive(scene?: DesignBlockId): Promise<Uint8Array | Blob>;
+	applyTemplateFromString(content: string): Promise<void>;
+	applyTemplateFromURL(url: string): Promise<void>;
+	getPages(scene?: DesignBlockId): DesignBlockId[];
+	/** Returns null when there's no scene or no current page. */
+	getCurrentPage(scene?: DesignBlockId): DesignBlockId | null;
+	getMode(scene?: DesignBlockId): string | null;
+	getLayout(scene?: DesignBlockId): SceneLayout;
+	setLayout(layout: SceneLayout, scene?: DesignBlockId): void;
+	getDesignUnit(scene?: DesignBlockId): string;
+	setDesignUnit(unit: string, scene?: DesignBlockId): void;
+	getFontSizeUnit(scene?: DesignBlockId): string;
+	setFontSizeUnit(unit: string, scene?: DesignBlockId): void;
+	get(): DesignBlockId | null;
+}
+/**
+ * Interface for editor operations
+ * Provides methods for editor settings and state management
+ */
+export interface IEditorAPI {
+	/** Active license JWT, or '' in Evaluation mode. */
+	getActiveLicense(): string;
+	/**
+	 * Activate or re-activate the engine with a license key. Empty string =
+	 * Evaluation mode. Most callers should set `Configuration.license` at
+	 * `CreativeEngine.init()` time instead.
+	 */
+	unlockWithLicense(license: string): void;
+	findAllSettings(): string[];
+	getSettingType(key: string): string;
+	getSettingBool(key: string): boolean;
+	setSettingBool(key: string, value: boolean): void;
+	getSettingInt(key: string): number;
+	setSettingInt(key: string, value: number): void;
+	getSettingFloat(key: string): number;
+	setSettingFloat(key: string, value: number): void;
+	getSettingString(key: string): string;
+	setSettingString(key: string, value: string): void;
+	getSettingColor(key: string): Color;
+	setSettingColor(key: string, value: Color): void;
+	getSettingEnum(key: string): string;
+	setSettingEnum(key: string, value: string): void;
+	getSettingEnumOptions(key: string): string[];
+	getEditMode(): string;
+	setEditMode(mode: string): void;
+	getRole(): string;
+	setRole(role: string): void;
+	createHistory(): HistoryId;
+	destroyHistory(history: HistoryId): void;
+	getActiveHistory(): HistoryId;
+	setActiveHistory(history: HistoryId): void;
+	undo(): void;
+	redo(): void;
+	canUndo(): boolean;
+	canRedo(): boolean;
+	addUndoStep(): void;
+	removeUndoStep(): void;
+	convertColorToColorSpace(color: Color, colorSpace: string): Color;
+	supportsP3?(): boolean;
+	findAllSpotColors(): string[];
+	getSpotColorRGBA(name: string): RGBAColor | readonly [
+		number,
+		number,
+		number,
+		number
+	];
+	getSpotColorCMYK(name: string): CMYKColor | readonly [
+		number,
+		number,
+		number,
+		number
+	];
+	setSpotColorRGB(name: string, r: number, g: number, b: number): void;
+	setSpotColorCMYK(name: string, c: number, m: number, y: number, k: number): void;
+	removeSpotColor(name: string): void;
+	setSafeAreaInsets(insets: Insets): void;
+	getSafeAreaInsets(): Insets;
+	getAbsoluteURI(relativeUri: string): string | Promise<string>;
+	defaultURIResolver(relativePath: string): string;
+	getMimeType(uri: string): Promise<string>;
+	relocateResource(currentUri: string, newUri: string): void;
+	findAllMediaURIs(): string[];
+	/**
+	 * Engine-managed in-memory buffers. Allocate via {@link createBuffer},
+	 * write through {@link setBufferData}, read back via
+	 * {@link getBufferData}, and free with {@link destroyBuffer}. The
+	 * returned URI is consumable wherever the engine accepts a resource
+	 * URI (e.g. `image/uri` properties), avoiding a filesystem round-trip
+	 * for transient resources produced by importers and exporters.
+	 */
+	createBuffer(): string;
+	destroyBuffer(uri: string): void;
+	setBufferData(uri: string, offset: number, data: Uint8Array): void;
+	getBufferData(uri: string, offset: number, length: number): Uint8Array;
+	setBufferLength(uri: string, length: number): void;
+	getBufferLength(uri: string): number;
+	/**
+	 * List all transient (in-engine) resources. Each entry has a `size`
+	 * and a URI under one of two field names: WASM emits `URL`, native
+	 * emits `uri`. Portable consumers should read both, e.g.
+	 * `(r as any).URL ?? (r as any).uri`. See
+	 * `@imgly/psd-importer`'s transient-resource-relocation test for the
+	 * canonical pattern.
+	 */
+	findAllTransientResources(): Array<{
+		URL: string;
+		size: number;
+	} | {
+		uri: string;
+		size: number;
+	}>;
+	/** @deprecated Use {@link onHistoryUpdatedWithKind} instead. */
+	onHistoryUpdated(callback: () => void): () => void;
+	onHistoryUpdatedWithKind(callback: (kind: HistoryUpdate) => void): () => void;
+	onSettingsChanged(callback: () => void): () => void;
+}
+/**
+ * Interface for asset operations
+ * Provides methods for managing asset sources
+ */
+export interface IAssetAPI {
+	addSource(source: AssetSource): void;
+	addLocalSource(id: string, supportedMimeTypes?: string[]): void;
+	addLocalAssetSourceFromJSONString(contentJSON: string, basePath?: string): Promise<string>;
+	addLocalAssetSourceFromJSONURI(contentURI: string): Promise<string>;
+	removeSource(id: string): void;
+	findAllSources(): string[];
+	findAssets(sourceId: string, query: AssetsQuery): Promise<AssetsQueryResult<CompleteAssetResult>>;
+	getGroups(sourceId: string): Promise<string[]>;
+	getLicense(sourceId: string): AssetSourceLicense | null | undefined;
+	getCredits(sourceId: string): AssetSourceCredits | null | undefined;
+	getSupportedMimeTypes(sourceId: string): string[];
+	addAssetToSource(sourceId: string, asset: AssetDefinition): void;
+	removeAssetFromSource(sourceId: string, assetId: string): void;
+	assetSourceContentsChanged(sourceId: string): void;
+}
+/**
+ * Interface for event subscriptions
+ */
+export interface IEventAPI {
+	subscribe(blocks: DesignBlockId[], callback: (events: BlockEvent[]) => void): () => void;
+}
+/**
+ * Interface for variable management
+ */
+export interface IVariableAPI {
+	setString(key: string, value: string): void;
+	getString(key: string): string;
+	findAll(): string[];
+	remove(key: string): void;
+}
+/**
+ * Main Creative Engine interface
+ * This interface defines the contract that all binding implementations must fulfill.
+ *
+ * When adding a new `I<X>API` to this file, also add a phantom assertion in
+ * `bindings/wasm/js_web/src/__type_checks__/shared-interface-parity.ts` so the
+ * node wasm binding stays pinned. The node native binding pins itself via
+ * its `class … implements I<X>API` declarations.
+ */
+export interface ICreativeEngine {
+	/** Engine version string */
+	readonly version: string;
+	/** Block operations API */
+	readonly block: IBlockAPI;
+	/** Scene operations API */
+	readonly scene: ISceneAPI;
+	/** Editor operations API */
+	readonly editor: IEditorAPI;
+	/** Asset operations API */
+	readonly asset: IAssetAPI;
+	/** Event subscription API */
+	readonly event: IEventAPI;
+	/** Variable management API */
+	readonly variable: IVariableAPI;
+	/** Dispose the engine and clean up all resources */
+	dispose(): void;
+}
+/**
+ * Normalized contract that both the node wasm binding and the node native
+ * binding can satisfy after a thin adapter layer.
+ *
+ * Each shared API class (`VariableAPI`, `EventAPI`, …) operates against this
+ * interface so the high-level method bodies are written once. Bindings provide
+ * adapters:
+ *
+ *   • The node wasm adapter unwraps `UBQResult<T>`, flattens `Vector<T>` to
+ *     `T[]`, and converts the internal color shape to the user-facing `Color`.
+ *   • The node native adapter is mostly pass-through — it already speaks the
+ *     normalized shape.
+ *
+ * This file is the *minimum* contract needed by the migrated classes. As
+ * additional API classes move into `@cesdk/shared`, methods get added here
+ * (it's an intentionally incremental migration). The interface MUST stay
+ * narrow — every method here is a runtime obligation for both adapters.
+ */
+export interface EngineBindingHandle {
+	findAllVariables(): string[];
+	setVariableString(key: string, value: string): void;
+	getVariableString(key: string): string;
+	removeVariable(key: string): void;
+}
+export declare class VariableAPI implements IVariableAPI {
+	#private;
+	constructor(engine: EngineBindingHandle);
+	/**
+	 * Get all text variable names currently stored in the engine.
+	 * @returns List of variable names.
+	 */
+	findAll(): string[];
+	/**
+	 * Set a text variable's value. Creates the variable if it doesn't exist.
+	 * @param key - The variable's key.
+	 * @param value - The text value to assign.
+	 */
+	setString(key: string, value: string): void;
+	/**
+	 * Get a text variable's value.
+	 * @param key - The variable's key.
+	 * @returns The text value of the variable.
+	 */
+	getString(key: string): string;
+	/**
+	 * Remove a text variable from the engine.
+	 * @param key - The variable's key to remove.
+	 */
+	remove(key: string): void;
+}
+/**
+ * v4-era default asset source IDs. Public surface mirrors @cesdk/node:
+ * bindings/wasm/js_node/src/CreativeEngine.ts uses the same union from
+ * bindings/wasm/js_web/src/addDefaultAssetSources.ts.
+ *
+ * `ly.img.captionPresets` is handled specially (loaded via a dedicated
+ * sub-loader, not content.json) to match WASM behavior.
+ *
+ * @public
+ */
+export type DefaultAssetSourceId = "ly.img.sticker" | "ly.img.vectorpath" | "ly.img.colors.defaultPalette" | "ly.img.filter.lut" | "ly.img.filter.duotone" | "ly.img.effect" | "ly.img.blur" | "ly.img.typeface" | "ly.img.page.presets" | "ly.img.page.presets.video" | "ly.img.crop.presets" | "ly.img.text" | "ly.img.captionPresets";
+/**
+ * Demo (v3) asset source IDs. Mirrors `@cesdk/node`'s
+ * `bindings/wasm/js_web/src/addDemoAssetSources.ts`.
+ *
+ * `ly.img.template`, `ly.img.video.template`, and `ly.img.textComponents`
+ * are accepted on the type even though they need extra wiring (template
+ * sources require a custom `applyAsset` callback that calls
+ * `scene.applyTemplateFromString` / `applyTemplateFromURL`). Native
+ * supplies that wiring via the same callback path.
+ *
+ * @deprecated Mirrors `@cesdk/node`'s deprecated demo asset shape;
+ * migrate to v4 sources via `addLocalAssetSourceFromJSONURI` directly.
+ * @public
+ */
+export type DemoAssetSourceId = "ly.img.template" | "ly.img.video.template" | "ly.img.textComponents" | "ly.img.image" | "ly.img.video" | "ly.img.audio" | "ly.img.image.upload" | "ly.img.video.upload" | "ly.img.audio.upload";
+/**
+ * Options for creating a scene with a default page in one call.
+ * @public
+ */
+export type CreateSceneOptions = {
+	/** Page-level options applied to a freshly-created page. */
+	page?: {
+		/** Page dimensions. A number is treated as a square (w = h). */
+		size: number | {
+			width: number;
+			height: number;
+		};
+		/** Optional solid fill color applied to the page. */
+		color?: Color;
+	};
+	/** Design unit. Also pairs the font-size unit (Pixel→Pixel, else→Point). */
+	designUnit?: string;
+	/** Font-size unit. Overrides the pairing from `designUnit`. */
+	fontSizeUnit?: string;
+};
+/**
+ * Font metrics extracted from a font file.
+ * Values are in the font's design units coordinate space.
+ * @public
+ */
+export interface FontMetrics {
+	ascender: number;
+	descender: number;
+	unitsPerEm: number;
+	lineGap: number;
+	capHeight: number;
+	xHeight: number;
+	underlineOffset: number;
+	underlineSize: number;
+	strikeoutOffset: number;
+	strikeoutSize: number;
+}
+/**
+ * Compression format for `engine.scene.saveToString` / `loadFromString`.
+ * `None` is the default (legacy base64 string output); `Zstd` returns raw
+ * compressed bytes.
+ * @public
+ */
+export declare enum CompressionFormat {
+	None = 0,
+	Zstd = 1
+}
+/**
+ * Compression level preset for Zstd. `Default` is balanced; `Fastest`
+ * trades ratio for speed; `Best` trades speed for ratio.
+ * @public
+ */
+export declare enum CompressionLevel {
+	Fastest = 0,
+	Default = 1,
+	Best = 2
+}
+/**
+ * Lines that can be drawn as text decorations. `None` disables decorations.
+ * Multiple lines may be combined in a single config.
+ * @public
+ */
+export type TextDecorationLine = "None" | "Underline" | "Strikethrough" | "Overline";
+/**
+ * Visual style for text decoration lines.
+ * @public
+ */
+export type TextDecorationStyle = "Solid" | "Double" | "Dotted" | "Dashed" | "Wavy";
+/**
+ * Configuration for text decoration rendering.
+ * @public
+ */
+export interface TextDecorationConfig {
+	lines: TextDecorationLine[];
+	style?: TextDecorationStyle;
+	/** Override color for underlines (only). */
+	underlineColor?: Color;
+	/** Multiplier on the font-derived underline thickness. Default 1.0. */
+	underlineThickness?: number;
+	/** Relative offset multiplier for the underline position. */
+	underlineOffset?: number;
+	/** When true, underlines skip glyph descenders. Default true. */
+	skipInk?: boolean;
+}
+/**
+ * A movement constraint rule. The scope is determined by which key is
+ * present: neither (scene-wide default), `block` (per-block, includes
+ * pages), or `blockType` (per-block-type).
+ *
+ * `overshoot` is a non-negative fraction of the moved block's own size.
+ * @public
+ */
+export type MovementConstraintRule = {
+	overshoot: number;
+} | {
+	overshoot: number;
+	block: number;
+} | {
+	overshoot: number;
+	blockType: string;
+};
+/**
+ * Scope descriptor used to identify an existing movement constraint for
+ * removal.
+ * @public
+ */
+export type MovementConstraintScope = {
+	block: number;
+} | {
+	blockType: string;
+};
+/**
+ * Effective movement constraint for a block, or `null` when no constraint
+ * applies.
+ * @public
+ */
+export type ResolvedMovementConstraint = {
+	overshoot: number;
+} | null;
+/**
+ * Animation easing types for animated operations
+ * @public
+ */
+export type AnimationEasing = "Linear" | "EaseIn" | "EaseOut" | "EaseInOut" | "EaseInQuart" | "EaseOutQuart" | "EaseInOutQuart" | "EaseInQuint" | "EaseOutQuint" | "EaseInOutQuint" | "EaseInBack" | "EaseOutBack" | "EaseInOutBack" | "EaseInSpring" | "EaseOutSpring" | "EaseInOutSpring";
+/**
+ * Options for zooming to a block with optional animation.
+ * @public
+ */
+export type ZoomOptions = {
+	/** Padding configuration around the block */
+	padding?: number | {
+		x?: number;
+		y?: number;
+	} | {
+		top?: number;
+		bottom?: number;
+		left?: number;
+		right?: number;
+	};
+	/** Animation configuration - boolean for default animation or object for custom settings */
+	animate?: boolean | {
+		/** Duration of the animation in seconds */
+		duration?: number;
+		/** Easing function for the animation */
+		easing?: AnimationEasing;
+		/** Whether the animation can be interrupted */
+		interruptible?: boolean;
+	};
+};
+/**
+ * Internal color representation used by the node native binding.
+ * Converts between the internal format (colorSpace, components) and
+ * the user-friendly format (r,g,b,a or c,m,y,k or spotColorName).
+ */
+export interface NativeColorInternal {
+	colorSpace: number;
+	components: {
+		x: number;
+		y: number;
+		z: number;
+		w: number;
+	};
+	spotColorName: string;
+	tint: number;
+	externalReference: string;
+}
+declare namespace NativeColorInternal {
+	enum ColorSpace {
+		sRGB = 0,
+		CMYK = 1,
+		SpotColor = 2
+	}
+	function toColor(color: NativeColorInternal): Color;
+	function fromColor(color: Color): NativeColorInternal;
+}
+/**
+ * BlockAPI provides methods for creating, manipulating, and querying design blocks.
+ * Design blocks are the fundamental building blocks of a scene - they represent
+ * visual elements like graphics, text, images, and containers.
+ *
+ * API matches Web bindings: engine.block.*
+ */
+export declare class BlockAPI implements IBlockAPI {
+	#private;
+	constructor(engine: NativeEngine);
+	/**
+	 * Create a new block of the specified type.
+	 * @param type - The block type (e.g., 'graphic', 'text', 'page', 'audio').
+	 * @returns The ID of the newly created block.
+	 */
+	create(type: string): DesignBlockId;
+	/**
+	 * Create a new fill block of the specified type.
+	 * @param type - The fill type (e.g., 'color', 'gradient/linear', 'gradient/radial', 'image', 'video').
+	 * @returns The ID of the newly created fill block.
+	 */
+	createFill(type: string): DesignBlockId;
+	/**
+	 * Create a new shape block of the specified type.
+	 * @param type - The shape type (e.g., 'rect', 'ellipse', 'polygon', 'star', 'line').
+	 * @returns The ID of the newly created shape block.
+	 */
+	createShape(type: string): DesignBlockId;
+	/**
+	 * Create a new effect block of the specified type.
+	 * @param type - The effect type (e.g., 'adjustments', 'pixelize', 'glow', 'half_tone').
+	 * @returns The ID of the newly created effect block.
+	 */
+	createEffect(type: string): DesignBlockId;
+	/**
+	 * Create a new blur block of the specified type.
+	 * @param type - The blur type (e.g., 'uniform', 'linear', 'mirrored', 'radial').
+	 * @returns The ID of the newly created blur block.
+	 */
+	createBlur(type: string): DesignBlockId;
+	/**
+	 * Create a new animation block of the specified type.
+	 * @param type - The animation type.
+	 * @returns The ID of the newly created animation block.
+	 */
+	createAnimation(type: string): DesignBlockId;
+	/**
+	 * Duplicate an existing block.
+	 * @param block - The ID of the block to duplicate.
+	 * @param attachToParent - Whether to attach the duplicate to the same parent (default: true).
+	 * @returns The ID of the duplicated block.
+	 */
+	duplicate(block: DesignBlockId, attachToParent?: boolean): DesignBlockId;
+	/**
+	 * Destroy a block and release its resources.
+	 * @param block - The ID of the block to destroy.
+	 */
+	destroy(block: DesignBlockId): void;
+	/**
+	 * Check if a block ID refers to a valid, existing block.
+	 * @param block - The ID to check.
+	 * @returns True if the block exists and is valid, false otherwise.
+	 */
+	isValid(block: DesignBlockId): boolean;
+	/**
+	 * Find all blocks in the scene.
+	 * @returns Array of all block IDs.
+	 */
+	findAll(): DesignBlockId[];
+	/**
+	 * Find all placeholder blocks in the scene.
+	 * @returns Array of placeholder block IDs.
+	 */
+	findAllPlaceholders(): DesignBlockId[];
+	/**
+	 * Find all blocks that are not part of the active scene tree (orphans).
+	 * Useful for diagnosing leaks where blocks are created with `create(...)`
+	 * but never appended to a parent.
+	 * @returns Array of unreferenced block IDs.
+	 */
+	findAllUnused(): DesignBlockId[];
+	/**
+	 * Find blocks by their name.
+	 * @param name - The name to search for.
+	 * @returns Array of matching block IDs.
+	 */
+	findByName(name: string): DesignBlockId[];
+	/**
+	 * Find blocks by their type.
+	 * @param type - The type to search for (e.g., '//ly.img.ubq/graphic').
+	 * @returns Array of matching block IDs.
+	 */
+	findByType(type: string): DesignBlockId[];
+	/**
+	 * Find blocks by their kind.
+	 * @param kind - The kind to search for (e.g., 'image', 'text', 'sticker').
+	 * @returns Array of matching block IDs.
+	 */
+	findByKind(kind: string): DesignBlockId[];
+	/**
+	 * Find all currently selected blocks.
+	 * @returns Array of selected block IDs.
+	 */
+	findAllSelected(): DesignBlockId[];
+	/**
+	 * Get the parent of a block.
+	 * @param block - The ID of the block.
+	 * @returns The ID of the parent block, or null if no parent.
+	 */
+	getParent(block: DesignBlockId): DesignBlockId | null;
+	/**
+	 * Check if a block has a parent.
+	 * @param block - The ID of the block.
+	 * @returns True if the block has a parent.
+	 */
+	hasParent(block: DesignBlockId): boolean;
+	/**
+	 * Get all children of a block.
+	 * @param block - The ID of the parent block.
+	 * @returns Array of child block IDs.
+	 */
+	getChildren(block: DesignBlockId): DesignBlockId[];
+	/**
+	 * Insert a child block at a specific index.
+	 * @param parent - The ID of the parent block.
+	 * @param child - The ID of the child block to insert.
+	 * @param index - The index at which to insert the child.
+	 */
+	insertChild(parent: DesignBlockId, child: DesignBlockId, index: number): void;
+	/**
+	 * Append a child block to the end of the parent's children.
+	 * @param parent - The ID of the parent block.
+	 * @param child - The ID of the child block to append.
+	 */
+	appendChild(parent: DesignBlockId, child: DesignBlockId): void;
+	/**
+	 * Get the type of a block.
+	 * @param block - The ID of the block.
+	 * @returns The block type string (e.g., '//ly.img.ubq/graphic').
+	 */
+	getType(block: DesignBlockId): string;
+	/**
+	 * Get the kind of a block.
+	 * @param block - The ID of the block.
+	 * @returns The block kind string (e.g., 'image', 'text', 'sticker').
+	 */
+	getKind(block: DesignBlockId): string;
+	/**
+	 * Set the kind of a block.
+	 * @param block - The ID of the block.
+	 * @param kind - The new kind value.
+	 */
+	setKind(block: DesignBlockId, kind: string): void;
+	/**
+	 * Get the name of a block.
+	 * @param block - The ID of the block.
+	 * @returns The block name.
+	 */
+	getName(block: DesignBlockId): string;
+	/**
+	 * Set the name of a block.
+	 * @param block - The ID of the block.
+	 * @param name - The new name.
+	 */
+	setName(block: DesignBlockId, name: string): void;
+	/**
+	 * Get the UUID of a block.
+	 * @param block - The ID of the block.
+	 * @returns The block's UUID string.
+	 */
+	getUUID(block: DesignBlockId): string;
+	getBool(block: DesignBlockId, property: string): boolean;
+	setBool(block: DesignBlockId, property: string, value: boolean): void;
+	getInt(block: DesignBlockId, property: string): number;
+	setInt(block: DesignBlockId, property: string, value: number): void;
+	getFloat(block: DesignBlockId, property: string): number;
+	setFloat(block: DesignBlockId, property: string, value: number): void;
+	getDouble(block: DesignBlockId, property: string): number;
+	setDouble(block: DesignBlockId, property: string, value: number): void;
+	getString(block: DesignBlockId, property: string): string;
+	setString(block: DesignBlockId, property: string, value: string): void;
+	getColor(block: DesignBlockId, property: string): Color;
+	setColor(block: DesignBlockId, property: string, value: Color): void;
+	getColorRGBA(block: DesignBlockId, property: string): RGBAColor;
+	setColorRGBA(block: DesignBlockId, property: string, r: number, g: number, b: number, a: number): void;
+	getEnum(block: DesignBlockId, property: string): string;
+	setEnum(block: DesignBlockId, property: string, value: string): void;
+	getPositionX(block: DesignBlockId): number;
+	setPositionX(block: DesignBlockId, value: number): void;
+	getPositionY(block: DesignBlockId): number;
+	setPositionY(block: DesignBlockId, value: number): void;
+	getPositionXMode(block: DesignBlockId): string;
+	setPositionXMode(block: DesignBlockId, mode: string): void;
+	getPositionYMode(block: DesignBlockId): string;
+	setPositionYMode(block: DesignBlockId, mode: string): void;
+	getWidth(block: DesignBlockId): number;
+	setWidth(block: DesignBlockId, value: number): void;
+	getWidthMode(block: DesignBlockId): string;
+	setWidthMode(block: DesignBlockId, mode: string): void;
+	getHeight(block: DesignBlockId): number;
+	setHeight(block: DesignBlockId, value: number): void;
+	getHeightMode(block: DesignBlockId): string;
+	setHeightMode(block: DesignBlockId, mode: string): void;
+	getRotation(block: DesignBlockId): number;
+	setRotation(block: DesignBlockId, value: number): void;
+	getFlipHorizontal(block: DesignBlockId): boolean;
+	getFlipVertical(block: DesignBlockId): boolean;
+	setFlipHorizontal(block: DesignBlockId, flip: boolean): void;
+	setFlipVertical(block: DesignBlockId, flip: boolean): void;
+	setPosition(block: DesignBlockId, x: number, y: number, options?: {
+		positionMode?: string;
+	}): void;
+	setSize(block: DesignBlockId, width: number, height: number, options?: {
+		maintainCrop?: boolean;
+		sizeMode?: string;
+	}): void;
+	scale(block: DesignBlockId, scale: number, anchorX?: number, anchorY?: number): void;
+	fillParent(block: DesignBlockId): void;
+	resizeContentAware(blocks: DesignBlockId[], width: number, height: number): Promise<void>;
+	getGlobalBoundingBoxX(block: DesignBlockId): number;
+	getGlobalBoundingBoxY(block: DesignBlockId): number;
+	getGlobalBoundingBoxWidth(block: DesignBlockId): number;
+	getGlobalBoundingBoxHeight(block: DesignBlockId): number;
+	getScreenSpaceBoundingBoxXYWH(blocks: DesignBlockId[]): XYWH;
+	supportsFill(block: DesignBlockId): boolean;
+	hasFill(block: DesignBlockId): boolean;
+	hasFillColor(block: DesignBlockId): boolean;
+	isFillColorEnabled(block: DesignBlockId): boolean;
+	setFillColorEnabled(block: DesignBlockId, enabled: boolean): void;
+	getFillColorRGBA(block: DesignBlockId): RGBAColor;
+	setFillColorRGBA(block: DesignBlockId, r: number, g: number, b: number, a: number): void;
+	getFill(block: DesignBlockId): DesignBlockId;
+	setFill(block: DesignBlockId, fill: DesignBlockId): void;
+	getFillEnabled(block: DesignBlockId): boolean;
+	isFillEnabled(block: DesignBlockId): boolean;
+	setFillEnabled(block: DesignBlockId, enabled: boolean): void;
+	getFillSolidColor(block: DesignBlockId): RGBAColor;
+	setFillSolidColor(block: DesignBlockId, r: number, g: number, b: number, a?: number): void;
+	getGradientColorStops(block: DesignBlockId, property: string): GradientColorStop[];
+	setGradientColorStops(block: DesignBlockId, property: string, stops: GradientColorStop[]): void;
+	supportsStroke(block: DesignBlockId): boolean;
+	hasStroke(block: DesignBlockId): boolean;
+	getStroke(block: DesignBlockId): DesignBlockId;
+	setStroke(block: DesignBlockId, stroke: DesignBlockId): void;
+	getStrokeEnabled(block: DesignBlockId): boolean;
+	isStrokeEnabled(block: DesignBlockId): boolean;
+	setStrokeEnabled(block: DesignBlockId, enabled: boolean): void;
+	getStrokeColor(block: DesignBlockId): Color;
+	setStrokeColor(block: DesignBlockId, color: Color): void;
+	getStrokeWidth(block: DesignBlockId): number;
+	setStrokeWidth(block: DesignBlockId, width: number): void;
+	getStrokeStyle(block: DesignBlockId): string;
+	setStrokeStyle(block: DesignBlockId, style: string): void;
+	getStrokePosition(block: DesignBlockId): string;
+	setStrokePosition(block: DesignBlockId, position: string): void;
+	getStrokeCornerGeometry(block: DesignBlockId): string;
+	setStrokeCornerGeometry(block: DesignBlockId, geometry: string): void;
+	getStrokeCap(block: DesignBlockId): StrokeCap;
+	setStrokeCap(block: DesignBlockId, cap: StrokeCap): void;
+	getStrokeStartCap(block: DesignBlockId): StrokeCap;
+	setStrokeStartCap(block: DesignBlockId, cap: StrokeCap): void;
+	getStrokeEndCap(block: DesignBlockId): StrokeCap;
+	setStrokeEndCap(block: DesignBlockId, cap: StrokeCap): void;
+	getStrokeDashStartCap(block: DesignBlockId): StrokeCap;
+	setStrokeDashStartCap(block: DesignBlockId, cap: StrokeCap): void;
+	getStrokeDashEndCap(block: DesignBlockId): StrokeCap;
+	setStrokeDashEndCap(block: DesignBlockId, cap: StrokeCap): void;
+	getStrokeDashArray(block: DesignBlockId): number[];
+	setStrokeDashArray(block: DesignBlockId, dashArray: number[]): void;
+	getStrokeDashOffset(block: DesignBlockId): number;
+	setStrokeDashOffset(block: DesignBlockId, dashOffset: number): void;
+	isLineOrigin(block: DesignBlockId): boolean;
+	getStrokeColorRGBA(block: DesignBlockId): RGBAColor;
+	setStrokeColorRGBA(block: DesignBlockId, r: number, g: number, b: number, a: number): void;
+	supportsEffects(block: DesignBlockId): boolean;
+	hasEffects(block: DesignBlockId): boolean;
+	getEffects(block: DesignBlockId): DesignBlockId[];
+	appendEffect(block: DesignBlockId, effect: DesignBlockId): void;
+	insertEffect(block: DesignBlockId, effect: DesignBlockId, index: number): void;
+	removeEffect(block: DesignBlockId, index: number): void;
+	isEffectEnabled(effect: DesignBlockId): boolean;
+	hasEffectEnabled(effect: DesignBlockId): boolean;
+	setEffectEnabled(effect: DesignBlockId, enabled: boolean): void;
+	supportsBlur(block: DesignBlockId): boolean;
+	hasBlur(block: DesignBlockId): boolean;
+	getBlur(block: DesignBlockId): DesignBlockId;
+	setBlur(block: DesignBlockId, blur: DesignBlockId): void;
+	getBlurEnabled(block: DesignBlockId): boolean;
+	isBlurEnabled(block: DesignBlockId): boolean;
+	setBlurEnabled(block: DesignBlockId, enabled: boolean): void;
+	supportsShape(block: DesignBlockId): boolean;
+	getShape(block: DesignBlockId): DesignBlockId;
+	setShape(block: DesignBlockId, shape: DesignBlockId): void;
+	hasShape(block: DesignBlockId): boolean;
+	supportsAnimation(block: DesignBlockId): boolean;
+	getInAnimation(block: DesignBlockId): DesignBlockId;
+	setInAnimation(block: DesignBlockId, animation: DesignBlockId): void;
+	getOutAnimation(block: DesignBlockId): DesignBlockId;
+	setOutAnimation(block: DesignBlockId, animation: DesignBlockId): void;
+	getLoopAnimation(block: DesignBlockId): DesignBlockId;
+	setLoopAnimation(block: DesignBlockId, animation: DesignBlockId): void;
+	supportsContentFillMode(block: DesignBlockId): boolean;
+	hasContentFillMode(block: DesignBlockId): boolean;
+	getContentFillMode(block: DesignBlockId): string;
+	setContentFillMode(block: DesignBlockId, mode: string): void;
+	setContentFillHorizontalAlignment(block: DesignBlockId, alignment: HorizontalContentFillAlignment): void;
+	getContentFillHorizontalAlignment(block: DesignBlockId): HorizontalContentFillAlignment;
+	setContentFillVerticalAlignment(block: DesignBlockId, alignment: VerticalContentFillAlignment): void;
+	getContentFillVerticalAlignment(block: DesignBlockId): VerticalContentFillAlignment;
+	supportsCrop(block: DesignBlockId): boolean;
+	hasCrop(block: DesignBlockId): boolean;
+	resetCrop(block: DesignBlockId): void;
+	adjustCropToFillFrame(block: DesignBlockId, minScaleRatio?: number): void;
+	getCropRotation(block: DesignBlockId): number;
+	setCropRotation(block: DesignBlockId, rotation: number): void;
+	getCropScaleX(block: DesignBlockId): number;
+	setCropScaleX(block: DesignBlockId, scale: number): void;
+	getCropScaleY(block: DesignBlockId): number;
+	setCropScaleY(block: DesignBlockId, scale: number): void;
+	getCropScaleRatio(block: DesignBlockId): number;
+	setCropScaleRatio(block: DesignBlockId, ratio: number): void;
+	getCropTranslationX(block: DesignBlockId): number;
+	setCropTranslationX(block: DesignBlockId, translation: number): void;
+	getCropTranslationY(block: DesignBlockId): number;
+	setCropTranslationY(block: DesignBlockId, translation: number): void;
+	isCropAspectRatioLocked(block: DesignBlockId): boolean;
+	setCropAspectRatioLocked(block: DesignBlockId, locked: boolean): void;
+	flipCropHorizontal(block: DesignBlockId): void;
+	flipCropVertical(block: DesignBlockId): void;
+	supportsDropShadow(block: DesignBlockId): boolean;
+	hasDropShadow(block: DesignBlockId): boolean;
+	isDropShadowEnabled(block: DesignBlockId): boolean;
+	setDropShadowEnabled(block: DesignBlockId, enabled: boolean): void;
+	getDropShadowColor(block: DesignBlockId): Color;
+	setDropShadowColor(block: DesignBlockId, color: Color): void;
+	getDropShadowColorRGBA(block: DesignBlockId): RGBAColor;
+	setDropShadowColorRGBA(block: DesignBlockId, r: number, g: number, b: number, a: number): void;
+	getDropShadowOffsetX(block: DesignBlockId): number;
+	setDropShadowOffsetX(block: DesignBlockId, offset: number): void;
+	getDropShadowOffsetY(block: DesignBlockId): number;
+	setDropShadowOffsetY(block: DesignBlockId, offset: number): void;
+	getDropShadowBlurRadiusX(block: DesignBlockId): number;
+	setDropShadowBlurRadiusX(block: DesignBlockId, radius: number): void;
+	getDropShadowBlurRadiusY(block: DesignBlockId): number;
+	setDropShadowBlurRadiusY(block: DesignBlockId, radius: number): void;
+	getDropShadowClip(block: DesignBlockId): boolean;
+	setDropShadowClip(block: DesignBlockId, clip: boolean): void;
+	supportsBlendMode(block: DesignBlockId): boolean;
+	getBlendMode(block: DesignBlockId): string;
+	setBlendMode(block: DesignBlockId, mode: string): void;
+	hasBlendMode(block: DesignBlockId): boolean;
+	supportsOpacity(block: DesignBlockId): boolean;
+	hasOpacity(block: DesignBlockId): boolean;
+	getOpacity(block: DesignBlockId): number;
+	setOpacity(block: DesignBlockId, opacity: number): void;
+	getVisible(block: DesignBlockId): boolean;
+	isVisible(block: DesignBlockId): boolean;
+	setVisible(block: DesignBlockId, visible: boolean): void;
+	getClipped(block: DesignBlockId): boolean;
+	isClipped(block: DesignBlockId): boolean;
+	setClipped(block: DesignBlockId, clipped: boolean): void;
+	setSelected(block: DesignBlockId, selected: boolean): void;
+	isSelected(block: DesignBlockId): boolean;
+	select(block: DesignBlockId): void;
+	bringToFront(block: DesignBlockId): void;
+	sendToBack(block: DesignBlockId): void;
+	bringForward(block: DesignBlockId): void;
+	sendBackward(block: DesignBlockId): void;
+	setAlwaysOnTop(block: DesignBlockId, enabled: boolean): void;
+	setAlwaysOnBottom(block: DesignBlockId, enabled: boolean): void;
+	isAlwaysOnTop(block: DesignBlockId): boolean;
+	isAlwaysOnBottom(block: DesignBlockId): boolean;
+	alignHorizontally(blocks: DesignBlockId[], alignment: string): void;
+	alignVertically(blocks: DesignBlockId[], alignment: string): void;
+	isAlignable(blocks: DesignBlockId[]): boolean;
+	distributeHorizontally(blocks: DesignBlockId[]): void;
+	distributeVertically(blocks: DesignBlockId[]): void;
+	isDistributable(blocks: DesignBlockId[]): boolean;
+	group(blocks: DesignBlockId[]): DesignBlockId;
+	ungroup(group: DesignBlockId): void;
+	isGroupable(blocks: DesignBlockId[]): boolean;
+	enterGroup(group: DesignBlockId): void;
+	exitGroup(block: DesignBlockId): void;
+	combine(blocks: DesignBlockId[], operation: string): DesignBlockId;
+	isCombinable(blocks: DesignBlockId[]): boolean;
+	supportsDuration(block: DesignBlockId): boolean;
+	hasDuration(block: DesignBlockId): boolean;
+	getDuration(block: DesignBlockId): number;
+	setDuration(block: DesignBlockId, duration: number): void;
+	supportsTimeOffset(block: DesignBlockId): boolean;
+	hasTimeOffset(block: DesignBlockId): boolean;
+	getTimeOffset(block: DesignBlockId): number;
+	setTimeOffset(block: DesignBlockId, offset: number): void;
+	supportsTrim(block: DesignBlockId): boolean;
+	hasTrim(block: DesignBlockId): boolean;
+	getTrimOffset(block: DesignBlockId): number;
+	setTrimOffset(block: DesignBlockId, offset: number): void;
+	getTrimLength(block: DesignBlockId): number;
+	setTrimLength(block: DesignBlockId, length: number): void;
+	supportsPlaybackControl(block: DesignBlockId): boolean;
+	hasPlaybackControl(block: DesignBlockId): boolean;
+	supportsPlaybackTime(block: DesignBlockId): boolean;
+	hasPlaybackTime(block: DesignBlockId): boolean;
+	getPlaybackTime(block: DesignBlockId): number;
+	setPlaybackTime(block: DesignBlockId, time: number): void;
+	isPlaying(block: DesignBlockId): boolean;
+	setPlaying(block: DesignBlockId, playing: boolean): void;
+	isLooping(block: DesignBlockId): boolean;
+	setLooping(block: DesignBlockId, looping: boolean): void;
+	getPlaybackSpeed(block: DesignBlockId): number;
+	setPlaybackSpeed(block: DesignBlockId, speed: number): void;
+	isMuted(block: DesignBlockId): boolean;
+	setMuted(block: DesignBlockId, muted: boolean): void;
+	getVolume(block: DesignBlockId): number;
+	setVolume(block: DesignBlockId, volume: number): void;
+	isSoloPlaybackEnabled(block: DesignBlockId): boolean;
+	setSoloPlaybackEnabled(block: DesignBlockId, enabled: boolean): void;
+	isForceMuted(block: DesignBlockId): boolean;
+	getTotalSceneDuration(scene: DesignBlockId): number;
+	isVisibleAtCurrentPlaybackTime(block: DesignBlockId): boolean;
+	isTransformLocked(block: DesignBlockId): boolean;
+	setTransformLocked(block: DesignBlockId, locked: boolean): void;
+	isIncludedInExport(block: DesignBlockId): boolean;
+	setIncludedInExport(block: DesignBlockId, included: boolean): void;
+	isPlaceholderEnabled(block: DesignBlockId): boolean;
+	setPlaceholderEnabled(block: DesignBlockId, enabled: boolean): void;
+	supportsPlaceholderBehavior(block: DesignBlockId): boolean;
+	hasPlaceholderBehavior(block: DesignBlockId): boolean;
+	isPlaceholderBehaviorEnabled(block: DesignBlockId): boolean;
+	setPlaceholderBehaviorEnabled(block: DesignBlockId, enabled: boolean): void;
+	supportsPlaceholderControls(block: DesignBlockId): boolean;
+	hasPlaceholderControls(block: DesignBlockId): boolean;
+	isPlaceholderControlsOverlayEnabled(block: DesignBlockId): boolean;
+	setPlaceholderControlsOverlayEnabled(block: DesignBlockId, enabled: boolean): void;
+	isPlaceholderControlsButtonEnabled(block: DesignBlockId): boolean;
+	setPlaceholderControlsButtonEnabled(block: DesignBlockId, enabled: boolean): void;
+	supportsBackgroundColor(block: DesignBlockId): boolean;
+	hasBackgroundColor(block: DesignBlockId): boolean;
+	isBackgroundColorEnabled(block: DesignBlockId): boolean;
+	setBackgroundColorEnabled(block: DesignBlockId, enabled: boolean): void;
+	getBackgroundColorRGBA(block: DesignBlockId): RGBAColor;
+	setBackgroundColorRGBA(block: DesignBlockId, r: number, g: number, b: number, a: number): void;
+	hasMetadata(block: DesignBlockId, key: string): boolean;
+	getMetadata(block: DesignBlockId, key: string): string;
+	setMetadata(block: DesignBlockId, key: string, value: string): void;
+	removeMetadata(block: DesignBlockId, key: string): void;
+	findAllMetadata(block: DesignBlockId): string[];
+	replaceText(block: DesignBlockId, text: string, from?: number, to?: number): void;
+	removeText(block: DesignBlockId, from?: number, to?: number): void;
+	getTextFontSizes(block: DesignBlockId, options?: TextFontSizeOptions): number[];
+	/** @deprecated Use the options-object overload. */
+	getTextFontSizes(block: DesignBlockId, from?: number, to?: number): number[];
+	setTextFontSize(block: DesignBlockId, size: number, from?: number, to?: number): void;
+	setTextFontSize(block: DesignBlockId, size: number, options: TextFontSizeOptions): void;
+	getTextFontStyles(block: DesignBlockId, from?: number, to?: number): string[];
+	setTextFontStyle(block: DesignBlockId, style: string, from?: number, to?: number): void;
+	getTextFontWeights(block: DesignBlockId, from?: number, to?: number): string[];
+	setTextFontWeight(block: DesignBlockId, weight: string, from?: number, to?: number): void;
+	getTextColors(block: DesignBlockId, from?: number, to?: number): Color[];
+	setTextColor(block: DesignBlockId, color: Color, from?: number, to?: number): void;
+	getTextCases(block: DesignBlockId, from?: number, to?: number): string[];
+	setTextCase(block: DesignBlockId, textCase: string, from?: number, to?: number): void;
+	getTypefaces(block: DesignBlockId, from?: number, to?: number): Typeface[];
+	setTypeface(block: DesignBlockId, typeface: Typeface, from?: number, to?: number): void;
+	getTypeface(block: DesignBlockId): Typeface;
+	/**
+	 * Set extra character-level kerning offset for a grapheme range. The
+	 * value is in em units (1.0 = one full em); 0.0 resets to no extra
+	 * offset. Matches the node wasm binding's `BlockAPI.setTextKerning`.
+	 */
+	setTextKerning(block: DesignBlockId, kerning: number, from?: number, to?: number): void;
+	/**
+	 * Return the unique kerning values seen across the grapheme range.
+	 * Mirrors `getTextFontSizes` / `getTextFontStyles` — `[0]` for a clean
+	 * block, `[v1, v2, …]` when the range spans multiple distinct values.
+	 */
+	getTextKernings(block: DesignBlockId, from?: number, to?: number): number[];
+	setFont(block: DesignBlockId, fontUri: string, typeface: Typeface): void;
+	canToggleBoldFont(block: DesignBlockId): boolean;
+	toggleBoldFont(block: DesignBlockId): void;
+	canToggleItalicFont(block: DesignBlockId): boolean;
+	toggleItalicFont(block: DesignBlockId): void;
+	/**
+	 * Returns the current text cursor range as UTF-16 indices. When no block
+	 * is currently being edited, returns `{ from: -1, to: -1 }`.
+	 */
+	getTextCursorRange(): Range;
+	/**
+	 * Sets the text cursor range. `from`/`to` are UTF-16 indices. Negative
+	 * values mean "from start" / "to end" (so `{ from: -1, to: -1 }` selects
+	 * the entire text).
+	 */
+	setTextCursorRange(range: Range): void;
+	getTextCursorPositionInScreenSpaceX(block: DesignBlockId): number;
+	getTextCursorPositionInScreenSpaceY(block: DesignBlockId): number;
+	getTextVisibleLineCount(block: DesignBlockId): number;
+	getTextVisibleLineContent(block: DesignBlockId, lineIndex: number): string;
+	getTextVisibleLineGlobalBoundingBoxXYWH(block: DesignBlockId, lineIndex: number): XYWH;
+	/**
+	 * Returns the tight ink-paint bounding box for each grapheme in the
+	 * range. One entry per grapheme in [from, to). Non-printable graphemes
+	 * (e.g. newline) get a zero-rect entry. Coordinates are in global
+	 * scene space.
+	 *
+	 * @param block - The text block to query.
+	 * @param from - Start UTF-16 index (-1 = start of cursor selection or 0).
+	 * @param to   - End UTF-16 index (-1 = end of cursor selection or text length).
+	 */
+	getTextCharacterInkBoxes(block: DesignBlockId, from?: number, to?: number): CharacterInkBox[];
+	getTextEffectiveHorizontalAlignment(block: DesignBlockId): string;
+	/**
+	 * Returns the horizontal alignment override for a specific paragraph, or
+	 * the block-level alignment for negative paragraph indices. Returns
+	 * `undefined` when no override is set for the given paragraph.
+	 * @param block - The text block to query.
+	 * @param paragraphIndex - 0-based paragraph index. Negative values return
+	 *                         the block-level `text/horizontalAlignment` setting.
+	 */
+	getTextHorizontalAlignment(block: DesignBlockId, paragraphIndex?: number): string | undefined;
+	/**
+	 * Sets the horizontal alignment override for a specific paragraph of a text
+	 * block. Pass `undefined` for `alignment` to clear the paragraph-level
+	 * override. Negative `paragraphIndex` clears all paragraph overrides and
+	 * applies the alignment block-wide.
+	 */
+	setTextHorizontalAlignment(block: DesignBlockId, alignment: string | undefined, paragraphIndex?: number): void;
+	/**
+	 * Returns the ordered list of unique text-decoration configurations within
+	 * the given grapheme range. `from` / `to` are UTF-16 indices and are
+	 * converted to grapheme indices to match WASM semantics.
+	 */
+	getTextDecorations(block: DesignBlockId, from?: number, to?: number): TextDecorationConfig[];
+	/**
+	 * Sets the given text-decoration config for the given grapheme range. Set
+	 * `lines: ['None']` to clear all decorations.
+	 */
+	setTextDecoration(block: DesignBlockId, config: TextDecorationConfig, from?: number, to?: number): void;
+	toggleTextDecorationUnderline(block: DesignBlockId, from?: number, to?: number): void;
+	toggleTextDecorationStrikethrough(block: DesignBlockId, from?: number, to?: number): void;
+	toggleTextDecorationOverline(block: DesignBlockId, from?: number, to?: number): void;
+	getTextListStyle(block: DesignBlockId, paragraphIndex: number): "None" | "Unordered" | "Ordered";
+	setTextListStyle(block: DesignBlockId, listStyle: "None" | "Unordered" | "Ordered", paragraphIndex?: number, listLevel?: number): void;
+	getTextListLevel(block: DesignBlockId, paragraphIndex: number): number;
+	setTextListLevel(block: DesignBlockId, listLevel: number, paragraphIndex?: number): void;
+	/**
+	 * Returns the 0-based paragraph indices that overlap the given UTF-16 range.
+	 * Range is half-open: `from` inclusive, `to` exclusive. Negative values mean
+	 * "all paragraphs". When `from === to`, returns the paragraph containing the
+	 * cursor at `from`.
+	 */
+	getTextParagraphIndices(block: DesignBlockId, from?: number, to?: number): number[];
+	getTextLineHeight(block: DesignBlockId, paragraphIndex: number): number;
+	setTextLineHeight(block: DesignBlockId, lineHeight: number | null, paragraphIndex?: number): void;
+	getFontMetrics(fontFileUri: string): Promise<FontMetrics>;
+	getSourceSet(block: DesignBlockId, property: string): Source[];
+	setSourceSet(block: DesignBlockId, property: string, sources: Source[]): void;
+	addImageFileURIToSourceSet(block: DesignBlockId, property: string, uri: string): Promise<void>;
+	addVideoFileURIToSourceSet(block: DesignBlockId, property: string, uri: string): Promise<void>;
+	getVideoWidth(block: DesignBlockId): number;
+	getVideoHeight(block: DesignBlockId): number;
+	getAudioTrackCountFromVideo(block: DesignBlockId): number;
+	getAVResourceTotalDuration(block: DesignBlockId): number;
+	/**
+	 * Splits the block at the given time. The original block keeps the
+	 * leading portion; the trailing portion is returned as a newly
+	 * created block id (matches `@cesdk/node`'s return contract).
+	 *
+	 * @remarks Matches `@cesdk/node`'s `SplitOptions` shape:
+	 * `attachToParent` and `selectNewBlock` default to `true`,
+	 * `createParentTrackIfNeeded` defaults to `false`. Non-default values
+	 * are accepted for shape parity but not yet plumbed to the C++ binding
+	 * — when set, a warning is emitted so callers can detect the gap.
+	 *
+	 * @param block - The block to split.
+	 * @param atTime - The time (seconds) at which to split.
+	 * @param options - Split-behavior overrides.
+	 * @returns The id of the newly created trailing block.
+	 * @public
+	 */
+	split(block: DesignBlockId, atTime: number, options?: SplitOptions): DesignBlockId;
+	getFrameX(block: DesignBlockId): number;
+	getFrameY(block: DesignBlockId): number;
+	getFrameWidth(block: DesignBlockId): number;
+	getFrameHeight(block: DesignBlockId): number;
+	supportsPageDurationSource(page: DesignBlockId, block: DesignBlockId): boolean;
+	setPageDurationSource(page: DesignBlockId, block: DesignBlockId): void;
+	removePageDurationSource(page: DesignBlockId): void;
+	isPageDurationSource(block: DesignBlockId): boolean;
+	isScopeEnabled(block: DesignBlockId, scope: string): boolean;
+	setScopeEnabled(block: DesignBlockId, scope: string, enabled: boolean): void;
+	isAllowedByScope(block: DesignBlockId, scope: string): boolean;
+	findAllProperties(block: DesignBlockId): string[];
+	getPropertyType(blockOrProperty: DesignBlockId | string, property?: string): string;
+	isPropertyReadable(blockOrProperty: DesignBlockId | string, property?: string): boolean;
+	isPropertyWritable(blockOrProperty: DesignBlockId | string, property?: string): boolean;
+	getEnumValues(blockOrProperty: DesignBlockId | string, property?: string): string[];
+	getState(block: DesignBlockId): string;
+	export(block: DesignBlockId, options?: ExportOptions): Promise<Blob>;
+	export(block: DesignBlockId, mimeType: string, options?: ExportOptions): Promise<Blob>;
+	exportToBuffer(block: DesignBlockId, mimeType: string, options?: ExportOptions): Promise<Uint8Array>;
+	/**
+	 * Exports a design block and a color mask to two separate buffers.
+	 *
+	 * Removes all pixels that exactly match the given RGB color and replaces them with transparency.
+	 * The output includes two buffers: the masked image and the mask itself.
+	 *
+	 * @param block - The design block element to export.
+	 * @param maskColorR - The red component of the special color mask color (0-1).
+	 * @param maskColorG - The green component of the special color mask color (0-1).
+	 * @param maskColorB - The blue component of the special color mask color (0-1).
+	 * @param options - The options for exporting the block type.
+	 * @returns A promise that resolves with an array of two Uint8Arrays: [image, mask].
+	 */
+	exportWithColorMask(block: DesignBlockId, maskColorR: number, maskColorG: number, maskColorB: number, options?: ExportOptions): Promise<Blob[]>;
+	exportWithColorMask(block: DesignBlockId, mimeType: string | undefined, maskColorR: number, maskColorG: number, maskColorB: number, options?: ExportOptions): Promise<Blob[]>;
+	exportVideo(block: DesignBlockId, options?: VideoExportOptions & {
+		mimeType?: string;
+		onProgress?: (rendered: number, encoded: number, total: number) => void;
+	}): Promise<Blob>;
+	exportVideo(block: DesignBlockId, mimeType: string, progressCallback?: (rendered: number, encoded: number, total: number) => void, options?: VideoExportOptions): Promise<Blob>;
+	exportVideoToBuffer(block: DesignBlockId, mimeType: string, options?: VideoExportOptions, progressCallback?: (rendered: number, encoded: number, total: number) => void): Promise<Uint8Array>;
+	/**
+	 * Export an audio block to a buffer.
+	 *
+	 * Two call shapes are accepted:
+	 * - WASM-style (preferred): `exportAudio(block, options?)` where `options.mimeType`
+	 *   defaults to `'audio/wav'`.
+	 * - Native-only positional: `exportAudio(block, mimeType, options?)`.
+	 *
+	 * The two forms produce identical bytes; the WASM-style form keeps source
+	 * code portable between `@cesdk/node` (WASM) and `@cesdk/node-native`.
+	 */
+	exportAudio(block: DesignBlockId, options?: AudioExportOptions): Promise<Blob>;
+	exportAudio(block: DesignBlockId, mimeType: string, options?: AudioExportOptions): Promise<Blob>;
+	exportAudioToBuffer(block: DesignBlockId, mimeType: string, options?: AudioExportOptions): Promise<Uint8Array>;
+	loadFromString(content: string): Promise<DesignBlockId[]>;
+	loadFromURL(url: string): Promise<DesignBlockId[]>;
+	/**
+	 * Load blocks from an archive URL.
+	 * Also supports data URIs (data:application/zip;base64,...) which are converted to buffer:// protocol internally.
+	 * @param url - The URL of the archive file, or a data URI containing base64-encoded archive data.
+	 * @returns A promise that resolves with an array of block IDs.
+	 */
+	loadFromArchiveURL(url: string): Promise<DesignBlockId[]>;
+	saveToString(blocks: DesignBlockId[]): Promise<string>;
+	saveToArchive(blocks: DesignBlockId[]): Promise<Blob>;
+	/**
+	 * Force-load the audio/video resource for an audio block or video-fill block.
+	 * Resolves once the asset is fully fetched and demuxed (so subsequent
+	 * `exportVideo` calls have data immediately available on frame 0). Without
+	 * this prime, the encoder can race ahead of the HTTP fetch and produce
+	 * silent audio / black-frame video segments.
+	 */
+	forceLoadAVResource(block: DesignBlockId): Promise<void>;
+	/**
+	 * Force-load every resource referenced by `blocks`. Useful before
+	 * `exportVideo` on a scene with multiple remote assets — saves N network
+	 * round-trips compared to calling `forceLoadAVResource` per block.
+	 */
+	forceLoadResources(blocks: DesignBlockId[]): Promise<void>;
+	/**
+	 * Apply an animation set (in/loop/out) to a block. Mirrors
+	 * `@cesdk/node`'s `BlockAPI.applyAnimation` exactly.
+	 *
+	 * @public
+	 */
+	applyAnimation(block: DesignBlockId, animation?: AnimationOptions): void;
+	/**
+	 * Apply a drop shadow effect to a block. Mirrors `@cesdk/node`'s
+	 * `BlockAPI.applyDropShadow` exactly.
+	 *
+	 * @public
+	 */
+	applyDropShadow(block: DesignBlockId, options?: DropShadowOptions): void;
+	/**
+	 * Add an image to the current page as a graphic block with an image fill.
+	 * Mirrors `@cesdk/node`'s `BlockAPI.addImage` shape — same options bag,
+	 * same chained-call sequence.
+	 *
+	 * @remarks Unlike WASM (which uses `new Image()` to auto-detect size when
+	 * `options.size` is omitted), Node has no DOM `Image` global. In Node,
+	 * `options.size` must be supplied; calling without it throws a clear
+	 * error with the suggested fix.
+	 *
+	 * @public
+	 */
+	addImage(url: string, options?: AddImageOptions): DesignBlockId;
+	/**
+	 * Add a video to the current page as a graphic block with a video fill.
+	 * Mirrors `@cesdk/node`'s `BlockAPI.addVideo` shape.
+	 *
+	 * @remarks Like `addImage`, requires explicit `options.size` in Node.
+	 *
+	 * @public
+	 */
+	addVideo(url: string, options?: AddVideoOptions): DesignBlockId;
+	/**
+	 * Subscribe to state changes on a set of blocks. Matches WASM's
+	 * `engine.block.onStateChanged(ids, callback)` contract — pass an empty
+	 * array to monitor every block in the scene. The native C++ side
+	 * already implements this via `subscribeToBlockState`; this wrapper
+	 * exposes it on `engine.block` so portable consumers (e.g.
+	 * `@imgly/psd-importer`'s transient-relocation tests) can subscribe the
+	 * same way on both bindings.
+	 *
+	 * @returns A function to unsubscribe.
+	 */
+	onStateChanged(ids: DesignBlockId[], callback: (ids: DesignBlockId[]) => void): () => void;
+	/**
+	 * Subscribe to selection changes. Matches WASM's
+	 * `engine.block.onSelectionChanged(callback)` contract — fires when the
+	 * set of selected blocks changes. The native C++ side already implements
+	 * this via `subscribeToSelectionChange`; this wrapper exposes it so
+	 * portable consumers (selection-reactive UI) work on both bindings.
+	 *
+	 * @returns A function to unsubscribe.
+	 */
+	onSelectionChanged(callback: () => void): () => void;
+	/**
+	 * Subscribe to block clicks. Matches WASM's
+	 * `engine.block.onClicked((id) => …)` contract. In a headless Node
+	 * context the engine never fires this event (no UI input), but the
+	 * subscription surface exists for API parity so the same code compiles
+	 * and runs against both bindings.
+	 *
+	 * @returns A function to unsubscribe.
+	 */
+	onClicked(callback: (id: DesignBlockId) => void): () => void;
+}
+/**
+ * SceneAPI provides methods for managing scenes and pages
+ */
+export declare class SceneAPI implements ISceneAPI {
+	#private;
+	constructor(engine: NativeEngine);
+	/**
+	 * Create a new design scene, along with its own camera.
+	 * @param sceneLayout - The layout of the scene.
+	 * @returns The scene's handle.
+	 */
+	create(sceneLayout?: SceneLayout, options?: CreateSceneOptions): DesignBlockId;
+	/**
+	 * Create a new scene in video mode, along with its own camera.
+	 * @returns The scene's handle.
+	 */
+	createVideo(options?: CreateSceneOptions): DesignBlockId;
+	/**
+	 * Return the currently active scene.
+	 * @returns The scene or null, if none was created yet.
+	 */
+	get(): DesignBlockId | null;
+	/**
+	 * Load the contents of a scene file.
+	 * @param sceneContent - The scene file contents, a base64 string.
+	 * @param overrideEditorConfig - Whether to override editor configuration.
+	 * @param waitForResources - Whether to wait for all resources to finish loading.
+	 * @returns A handle to the loaded scene.
+	 */
+	loadFromString(sceneContent: string, overrideEditorConfig?: boolean, waitForResources?: boolean): Promise<DesignBlockId>;
+	/**
+	 * Load a scene from the URL to the scene file.
+	 * @param url - The URL of the scene file.
+	 * @param overrideEditorConfig - Whether to override editor configuration.
+	 * @param waitForResources - Whether to wait for all resources to finish loading.
+	 * @returns A promise that resolves with the scene ID.
+	 */
+	loadFromURL(url: string, overrideEditorConfig?: boolean, waitForResources?: boolean): Promise<DesignBlockId>;
+	/**
+	 * Load a previously archived scene from the URL to the scene file.
+	 * Also supports data URIs (data:application/zip;base64,...) which are converted to buffer:// protocol internally.
+	 * @param url - The URL of the scene archive file, or a data URI containing base64-encoded archive data.
+	 * @param overrideEditorConfig - Whether to override editor configuration.
+	 * @param waitForResources - Whether to wait for all resources to finish loading.
+	 * @returns A promise that resolves with the scene ID.
+	 */
+	loadFromArchiveURL(url: string, overrideEditorConfig?: boolean, waitForResources?: boolean): Promise<DesignBlockId>;
+	/**
+	 * Serializes the current scene into a string.
+	 *
+	 * Optionally accepts a `compression` option to apply Zstd compression to
+	 * the output. When compression is enabled the returned string contains
+	 * raw compressed bytes (not base64) — pass it back to `loadFromString`
+	 * to round-trip.
+	 *
+	 * @returns A promise that resolves with the serialized scene.
+	 */
+	saveToString(options?: {
+		compression?: {
+			format?: CompressionFormat;
+			level?: CompressionLevel;
+		};
+	}): Promise<string>;
+	/**
+	 * Saves the current scene and all of its referenced assets into an archive.
+	 * @returns A promise that resolves with a Uint8Array.
+	 */
+	saveToArchive(): Promise<Blob>;
+	/**
+	 * Loads the given image and creates a scene with a single page showing the image.
+	 * @param url - The image URL.
+	 * @param dpi - The scene's DPI.
+	 * @param pixelScaleFactor - The display's pixel scale factor.
+	 * @returns A promise that resolves with the scene ID.
+	 */
+	/**
+	 * Loads the given image and creates a scene with a single page showing the image.
+	 *
+	 * @remarks The 4th/5th/6th args (`sceneLayout`, `spacing`,
+	 * `spacingInScreenSpace`) are part of `@cesdk/node`'s signature and
+	 * accepted here for shape parity. The C++ binding currently hardcodes
+	 * `Free`/`0.f`/`false`; non-default values are not yet plumbed
+	 * through. A warning is emitted when a caller passes a non-default
+	 * value so the discrepancy is visible.
+	 *
+	 * @public
+	 */
+	createFromImage(url: string, dpi?: number, pixelScaleFactor?: number, sceneLayout?: SceneLayout, spacing?: number, spacingInScreenSpace?: boolean): Promise<DesignBlockId>;
+	/**
+	 * Loads the given video and creates a scene with a single page showing the video.
+	 * @param url - The video URL.
+	 * @returns A promise that resolves with the scene ID.
+	 */
+	createFromVideo(url: string): Promise<DesignBlockId>;
+	/**
+	 * Applies the contents of the given template scene to the currently loaded scene.
+	 * @param content - The template scene file contents, a base64 string.
+	 * @returns A Promise that resolves once the template was applied.
+	 */
+	applyTemplateFromString(content: string): Promise<void>;
+	/**
+	 * Applies the contents of the given template scene to the currently loaded scene.
+	 * @param url - The url to the template scene file.
+	 * @returns A Promise that resolves once the template was applied.
+	 */
+	applyTemplateFromURL(url: string): Promise<void>;
+	/**
+	 * Get the current scene mode.
+	 * @deprecated Scene mode no longer affects engine behavior. All features work regardless of mode.
+	 * @returns The current mode of the scene, or null if no mode has been set.
+	 */
+	getMode(): string | null;
+	/**
+	 * Set the mode of the current scene.
+	 * @param mode - The new mode for the scene ('Design' or 'Video').
+	 */
+	setMode(mode: "Design" | "Video"): void;
+	/**
+	 * Converts all values of the current scene into the given design unit.
+	 * @param designUnit - The new design unit of the scene.
+	 */
+	setDesignUnit(designUnit: string): void;
+	/**
+	 * Returns the design unit of the current scene.
+	 * @returns The current design unit.
+	 */
+	getDesignUnit(): string;
+	/**
+	 * Sets the unit ('Pixel' | 'Point') in which the current scene's font sizes
+	 * are interpreted at the API boundary (setTextFontSize / getTextFontSizes).
+	 * The engine stores font sizes in points internally.
+	 * @param unit - The new font-size unit.
+	 */
+	setFontSizeUnit(unit: string): void;
+	/**
+	 * Returns the font-size unit of the current scene ('Pixel' | 'Point').
+	 * @returns The current font-size unit.
+	 */
+	getFontSizeUnit(): string;
+	/** Start or stop playback of the current page. */
+	setPlaying(play: boolean): void;
+	/**
+	 * Get the layout of the current scene.
+	 * @returns The current layout of the scene.
+	 */
+	getLayout(): SceneLayout;
+	/**
+	 * Set the layout of the current scene.
+	 * @param layout - The new layout for the scene.
+	 */
+	setLayout(layout: SceneLayout): void;
+	/**
+	 * Get the sorted list of pages in the scene.
+	 * @returns The sorted list of pages in the scene.
+	 */
+	getPages(): DesignBlockId[];
+	/**
+	 * Add a new page to the scene.
+	 * @param scene - Optional scene ID. If not provided, uses the current scene.
+	 * @returns The ID of the newly created page.
+	 */
+	addPage(scene?: DesignBlockId): DesignBlockId;
+	/**
+	 * Get the current page.
+	 * @returns The current page in the scene or null when there is no scene
+	 *          available or no current page is set.
+	 */
+	getCurrentPage(scene?: DesignBlockId): DesignBlockId | null;
+	/**
+	 * Find all blocks with the given type sorted by the distance to viewport center.
+	 * @param type - The type to search for.
+	 * @returns A list of block ids sorted by distance to viewport center.
+	 */
+	findNearestToViewPortCenterByType(type: string): DesignBlockId[];
+	/**
+	 * Find all blocks with the given kind sorted by the distance to viewport center.
+	 * @param kind - The kind to search for.
+	 * @returns A list of block ids sorted by distance to viewport center.
+	 */
+	findNearestToViewPortCenterByKind(kind: string): DesignBlockId[];
+	/**
+	 * Set the zoom level of the scene.
+	 * @param zoomLevel - The new zoom level.
+	 */
+	setZoomLevel(zoomLevel?: number): void;
+	/**
+	 * Get the zoom level of the scene.
+	 * @returns The zoom level of the scene.
+	 */
+	getZoomLevel(): number;
+	/**
+	 * Sets the zoom and focus to show a block, optionally with animation.
+	 * This only shows an effect if the zoom level is not handled/overwritten by the UI.
+	 * Without padding, this results in a tight view on the block.
+	 *
+	 * @param id - The block that should be focused on.
+	 * @param options - Configuration for padding and animation.
+	 * @returns A promise that resolves once the zoom was set or rejects with an error otherwise.
+	 */
+	zoomToBlock(id: DesignBlockId, options?: ZoomOptions): Promise<void>;
+	/**
+	 * Sets the zoom and focus to show a block.
+	 *
+	 * This only shows an effect if the zoom level is not handled/overwritten by the UI.
+	 * Without padding, this results in a tight view on the block.
+	 *
+	 * @param id - The block that should be focused on.
+	 * @param paddingLeft - Optional padding in screen pixels to the left of the block.
+	 * @param paddingTop - Optional padding in screen pixels to the top of the block.
+	 * @param paddingRight - Optional padding in screen pixels to the right of the block.
+	 * @param paddingBottom - Optional padding in screen pixels to the bottom of the block.
+	 * @returns A promise that resolves once the zoom was set or rejects with an error otherwise.
+	 * @deprecated Use zoomToBlock with options object instead
+	 */
+	zoomToBlock(id: DesignBlockId, paddingLeft?: number, paddingTop?: number, paddingRight?: number, paddingBottom?: number): Promise<void>;
+	/**
+	 * Continually adjust the zoom level to fit the block's bounding box on the
+	 * chosen axis. For 'Horizontal'/'Vertical', the second/third arguments are
+	 * `paddingBefore`/`paddingAfter` along that axis. For 'Both' the four
+	 * arguments map to left/top/right/bottom.
+	 *
+	 * @param id - The block to follow.
+	 * @param axis - 'Horizontal' | 'Vertical' | 'Both'.
+	 */
+	enableZoomAutoFit(id: DesignBlockId, axis: string, paddingBeforeOrLeft?: number, paddingAfterOrTop?: number, paddingRight?: number, paddingBottom?: number): void;
+	/**
+	 * Disables any previously set zoom auto-fit.
+	 * @param blockOrScene - The scene or a block in the scene.
+	 */
+	disableZoomAutoFit(blockOrScene: DesignBlockId): void;
+	/**
+	 * Queries whether zoom auto-fit is enabled for the given block.
+	 * @param blockOrScene - The scene or a block in the scene.
+	 * @returns True if auto-fit is set, false otherwise.
+	 */
+	isZoomAutoFitEnabled(blockOrScene: DesignBlockId): boolean;
+	/**
+	 * Continually clamp the camera position so that the given blocks stay
+	 * within view (with optional padding).
+	 * @experimental
+	 */
+	unstable_enableCameraPositionClamping(blocks: DesignBlockId[], paddingLeft?: number, paddingTop?: number, paddingRight?: number, paddingBottom?: number, scaledPaddingLeft?: number, scaledPaddingTop?: number, scaledPaddingRight?: number, scaledPaddingBottom?: number): void;
+	unstable_disableCameraPositionClamping(block?: DesignBlockId): void;
+	unstable_isCameraPositionClampingEnabled(block?: DesignBlockId): boolean;
+	/**
+	 * Continually clamp the camera zoom level to the range
+	 * `[minZoomLimit, maxZoomLimit]` while showing the given blocks (with
+	 * optional padding).
+	 * @experimental
+	 */
+	unstable_enableCameraZoomClamping(blocks: DesignBlockId[], minZoomLimit?: number, maxZoomLimit?: number, paddingLeft?: number, paddingTop?: number, paddingRight?: number, paddingBottom?: number): void;
+	unstable_disableCameraZoomClamping(block?: DesignBlockId): void;
+	unstable_isCameraZoomClampingEnabled(block?: DesignBlockId): boolean;
+	/**
+	 * Subscribe to zoom-level changes.
+	 * @param callback - Called whenever the zoom level changes.
+	 * @returns A function that unsubscribes when called.
+	 */
+	onZoomLevelChanged(callback: () => void): () => void;
+	/**
+	 * Subscribe to active-scene changes.
+	 * @param callback - Called whenever the active scene changes.
+	 * @returns A function that unsubscribes when called.
+	 */
+	onActiveChanged(callback: () => void): () => void;
+}
+/**
+ * EditorAPI provides methods for editor state management
+ */
+export declare class EditorAPI implements IEditorAPI {
+	#private;
+	constructor(engine: NativeEngine);
+	getEditMode(): string;
+	setEditMode(mode: string): void;
+	/**
+	 * Returns the JWT string of the currently active license. An empty string
+	 * indicates the engine is in Evaluation mode (the trial license created
+	 * when init() is called with an empty/null/undefined license). Throws if
+	 * the engine has no active license at all.
+	 *
+	 * Mirrors @cesdk/node's `engine.editor.getActiveLicense()`.
+	 * @internal
+	 */
+	getActiveLicense(): string;
+	/**
+	 * Activate (or re-activate) the engine with a license key. Pass an empty
+	 * string to drop into Evaluation mode. Mirrors
+	 * `@cesdk/node`'s `engine.editor.unlockWithLicense()`.
+	 *
+	 * Most callers should pass `license` via `CreativeEngine.init({ license })`
+	 * — `init` calls this internally. Use this method only to switch licenses
+	 * at runtime (e.g. trial → paid upgrade in place).
+	 */
+	unlockWithLicense(license: string): void;
+	getSettingBool(key: string): boolean;
+	setSettingBool(key: string, value: boolean): void;
+	getSettingInt(key: string): number;
+	setSettingInt(key: string, value: number): void;
+	getSettingFloat(key: string): number;
+	setSettingFloat(key: string, value: number): void;
+	getSettingString(key: string): string;
+	setSettingString(key: string, value: string): void;
+	getSettingColor(key: string): Color;
+	setSettingColor(key: string, value: Color): void;
+	getSettingEnum(key: string): string;
+	setSettingEnum(key: string, value: string): void;
+	findAllSettings(): string[];
+	getSettingType(key: string): string;
+	getSettingEnumOptions(key: string): string[];
+	/**
+	 * Generic setting getter that dispatches to the typed getter based on
+	 * `getSettingType`.
+	 */
+	getSetting<T = boolean | number | string | Color>(key: string): T;
+	/**
+	 * Generic setting setter — dispatches to the typed setter via
+	 * `getSettingType`.
+	 */
+	setSetting(key: string, value: boolean | number | string | Color): void;
+	/** Get the font metrics for a font URI. */
+	getFontMetrics(fontFileUri: string): Promise<FontMetrics>;
+	/**
+	 * Set one or more rules limiting how far blocks may be moved outside their
+	 * parent page during user interactions.
+	 */
+	setMovementConstraint(rules: MovementConstraintRule | MovementConstraintRule[]): void;
+	/**
+	 * Get the effective movement constraint for a block (most specific rule
+	 * wins: block > parent page > blockType > scene-wide). Returns `null`
+	 * when unconstrained.
+	 */
+	getMovementConstraint(id: DesignBlockId): ResolvedMovementConstraint;
+	/**
+	 * Remove movement constraints. No argument removes the scene-wide default.
+	 * `{ block }` / `{ blockType }` (or array) removes the matching scope(s).
+	 */
+	removeMovementConstraint(scopes?: MovementConstraintScope | MovementConstraintScope[]): void;
+	getCursorType(): string;
+	getCursorRotation(): number;
+	setSafeAreaInsets(insets: Insets): void;
+	getSafeAreaInsets(): Insets;
+	getUsedMemory(): number;
+	getAvailableMemory(): number;
+	convertColorToColorSpace(color: Color, colorSpace: string): Color;
+	supportsP3(): boolean;
+	getAbsoluteURI(relativeUri: string): Promise<string>;
+	getMimeType(uri: string): Promise<string>;
+	defaultURIResolver(relativePath: string): string;
+	/**
+	 * Register a synchronous URI resolver. Matches `@cesdk/node`'s
+	 * `(uri, defaultResolver) => string` signature
+	 * (`bindings/wasm/js_web/src/EditorAPI.ts`). The
+	 * `defaultResolver` argument is the engine's built-in resolver — call
+	 * it to delegate the lookup chain.
+	 *
+	 * @public
+	 */
+	setURIResolver(resolver: SyncURIResolver | ((uri: string) => string) | null): void;
+	/**
+	 * Register an asynchronous URI resolver. Matches `@cesdk/node`'s
+	 * `(uri, defaultResolver) => Promise<string> | string` signature
+	 * (`bindings/wasm/js_web/src/EditorAPI.ts`). Bridges to the
+	 * native callback-style binding by adapting the returned Promise.
+	 *
+	 * Pass `null` to restore the default resolver.
+	 *
+	 * @public
+	 */
+	setURIResolverAsync(resolver: AsyncURIResolver | null): void;
+	relocateResource(currentUri: string, newUri: string): void;
+	findAllMediaURIs(): string[];
+	/**
+	 * List all transient (in-engine) resources — typically `buffer://` URIs
+	 * created by importers (psd, pdf, idml) before they're uploaded to a
+	 * permanent location. Each entry is `{ uri, size }`.
+	 *
+	 * Note: WASM uses `URL` as the key name; consumers that target both
+	 * bindings should accept either (see e.g. psd-importer's
+	 * `transient-resource-relocation.test.ts`).
+	 */
+	findAllTransientResources(): Array<{
+		uri: string;
+		size: number;
+	}>;
+	findAllSpotColors(): string[];
+	getSpotColorRGBA(name: string): RGBAColor;
+	getSpotColorCMYK(name: string): CMYKColor;
+	setSpotColorRGB(name: string, r: number, g: number, b: number): void;
+	setSpotColorCMYK(name: string, c: number, m: number, y: number, k: number): void;
+	removeSpotColor(name: string): void;
+	getRole(): string;
+	setRole(role: string): void;
+	/**
+	 * Start the engine's analytics tracking pipeline. Mirrors
+	 * `@cesdk/node`'s `editor.startTracking(license, userId)`; invoked
+	 * automatically from {@link CreativeEngine.init} when `license` and/or
+	 * `userId` are passed in the Configuration. Safe to call multiple times.
+	 *
+	 * The C++ binding accepts a third `deviceId` argument that the engine
+	 * itself uses for tracking-pipeline disambiguation; WASM always passes
+	 * `''` (see `bindings/wasm/js_web/src/EditorAPI.ts`) — we
+	 * mirror that here so the no-args / "engine picks a default device id"
+	 * path is honored.
+	 *
+	 * @public
+	 */
+	startTracking(license: string, userId: string, deviceId?: string): void;
+	findAllScopes(): string[];
+	getGlobalScope(scope: string): string;
+	setGlobalScope(scope: string, value: string): void;
+	createHistory(): HistoryId;
+	destroyHistory(history: HistoryId): void;
+	getActiveHistory(): HistoryId;
+	setActiveHistory(history: HistoryId): void;
+	/**
+	 * Undo one step in the active history if an undo step is available.
+	 * Use {@link canUndo} beforehand to determine whether a step is available.
+	 */
+	undo(): void;
+	/**
+	 * Redo one step in the active history if a redo step is available.
+	 * Use {@link canRedo} beforehand to determine whether a step is available.
+	 */
+	redo(): void;
+	canUndo(): boolean;
+	canRedo(): boolean;
+	addUndoStep(): void;
+	removeUndoStep(): void;
+	/**
+	 * Subscribe to editor-state changes.
+	 * @param callback - Called whenever the editor state changes.
+	 * @returns A function that unsubscribes when called.
+	 */
+	onStateChanged(callback: () => void): () => void;
+	/**
+	 * Subscribe to editor settings changes. Matches WASM's
+	 * `engine.editor.onSettingsChanged(callback)`. The native C++ side
+	 * implements this via `subscribeToSettings`; this wrapper exposes it on
+	 * the editor API so portable consumers (settings-reactive UI) work on
+	 * both bindings.
+	 * @returns A function that unsubscribes when called.
+	 */
+	onSettingsChanged(callback: () => void): () => void;
+	/**
+	 * Subscribe to history updates.
+	 * @deprecated Use {@link onHistoryUpdatedWithKind} instead, which also
+	 * reports the kind of update.
+	 * @param callback - Called when the undo/redo history changes.
+	 * @returns A function that unsubscribes when called.
+	 */
+	onHistoryUpdated(callback: () => void): () => void;
+	/**
+	 * Subscribe to history updates. The callback receives a `HistoryUpdate`
+	 * describing what kind of update happened (matches the node wasm
+	 * binding's `EditorAPI` surface) so consumers can distinguish a
+	 * snapshot mutation from an `Activated` event triggered by
+	 * `setActiveHistory` — important for save-button logic that should NOT
+	 * fire on activation alone.
+	 * @param callback - Called with the kind of update.
+	 * @returns A function that unsubscribes when called.
+	 */
+	onHistoryUpdatedWithKind(callback: (kind: HistoryUpdate) => void): () => void;
+	/**
+	 * Subscribe to role changes.
+	 * @param callback - Called with the new role when it changes.
+	 * @returns A function that unsubscribes when called.
+	 */
+	onRoleChanged(callback: (role: string) => void): () => void;
+	/**
+	 * Create a new buffer and return its URI.
+	 * @returns A URI to identify the created buffer (buffer://N format).
+	 */
+	createBuffer(): string;
+	/**
+	 * Destroy a buffer and free its resources.
+	 * @param uri - The URI of the buffer to destroy.
+	 */
+	destroyBuffer(uri: string): void;
+	/**
+	 * Set the data of a buffer at a given offset.
+	 * @param uri - The URI of the buffer to update.
+	 * @param offset - The offset in bytes at which to start writing.
+	 * @param data - The data to write.
+	 */
+	setBufferData(uri: string, offset: number, data: Uint8Array): void;
+	/**
+	 * Get the data of a buffer at a given offset.
+	 * @param uri - The URI of the buffer to query.
+	 * @param offset - The offset in bytes at which to start reading.
+	 * @param length - The number of bytes to read.
+	 * @returns The data at the given offset.
+	 */
+	getBufferData(uri: string, offset: number, length: number): Uint8Array;
+	/**
+	 * Get the length of a buffer.
+	 * @param uri - The URI of the buffer to query.
+	 * @returns The length of the buffer in bytes.
+	 */
+	getBufferLength(uri: string): number;
+	/**
+	 * Resize a buffer. Truncates if `length` is smaller than the current
+	 * size; zero-extends if larger. Matches the WASM `editor.setBufferLength`
+	 * shape used by psd/pdf/idml importers to pre-allocate a buffer before
+	 * writing data with `setBufferData`.
+	 */
+	setBufferLength(uri: string, length: number): void;
+}
+/**
+ * EventAPI provides methods for event subscription
+ */
+export declare class EventAPI implements IEventAPI {
+	#private;
+	constructor(engine: NativeEngine);
+	/**
+	 * Subscribe to block lifecycle events.
+	 * Events are bundled and delivered at the end of each engine update cycle.
+	 * @param blocks - List of blocks to filter events by. If empty, events for all blocks are sent.
+	 * @param callback - Function called with bundled events.
+	 * @returns A method to unsubscribe from the events.
+	 */
+	subscribe: (blocks: DesignBlockId[], callback: (events: BlockEvent[]) => void) => (() => void);
+}
+/**
+ * AssetAPI provides methods for asset source management
+ * API matches Web bindings: engine.asset.*
+ */
+export declare class AssetAPI implements IAssetAPI {
+	#private;
+	constructor(engine: NativeEngine);
+	/**
+	 * Add a custom asset source with callbacks.
+	 *
+	 * This allows you to provide custom implementations for finding, fetching,
+	 * and applying assets from any data source.
+	 *
+	 * @param source - The asset source configuration with callbacks.
+	 */
+	addSource(source: AssetSource): void;
+	/**
+	 * Add a local asset source.
+	 *
+	 * Mirrors `@cesdk/node`'s 4-argument shape
+	 * (`bindings/wasm/js_web/src/AssetAPI.ts`): when `applyAsset`
+	 * or `applyAssetToBlock` is supplied, we wrap the local source as a
+	 * synthetic `AssetSource` via {@link addSource} so the callbacks are
+	 * honored. Without callbacks we go through the cheap `addLocalSource`
+	 * fast path.
+	 *
+	 * @param id - Unique identifier for the asset source.
+	 * @param supportedMimeTypes - The mime types of assets that are allowed to be added.
+	 * @param applyAsset - Optional callback invoked when the asset is applied to a new block.
+	 * @param applyAssetToBlock - Optional callback invoked when the asset is applied to an existing block.
+	 */
+	addLocalSource(id: string, supportedMimeTypes?: string[], applyAsset?: (asset: CompleteAssetResult) => Promise<DesignBlockId | undefined>, applyAssetToBlock?: (asset: CompleteAssetResult, block: DesignBlockId) => Promise<void>): void;
+	/**
+	 * Creates a new local asset source from a JSON string.
+	 * @param contentJSON - The JSON string containing the asset definitions.
+	 * @param basePath - Optional base path for resolving relative URLs.
+	 * @param options - Optional configuration with matcher patterns.
+	 * @returns The ID of the created asset source.
+	 */
+	addLocalAssetSourceFromJSONString(contentJSON: string, basePath?: string, options?: {
+		matcher?: string[];
+	}): Promise<string>;
+	/**
+	 * Creates a new local asset source from a JSON URI.
+	 * @param contentURI - The URI for the JSON file to load.
+	 * @param options - Optional configuration with matcher patterns.
+	 * @returns The ID of the created asset source.
+	 */
+	addLocalAssetSourceFromJSONURI(contentURI: string, options?: {
+		matcher?: string[];
+	}): Promise<string>;
+	/**
+	 * Remove a registered asset source.
+	 * @param id - The ID of the asset source to remove.
+	 */
+	removeSource(id: string): void;
+	/**
+	 * Get all registered asset source IDs.
+	 * @returns A list with the IDs of all registered asset sources.
+	 */
+	findAllSources(): string[];
+	/**
+	 * Search for assets in a specific source.
+	 *
+	 * @param sourceId - The ID of the asset source.
+	 * @param query - Query options to filter and sort the search results.
+	 * @returns Promise resolving to paginated search results.
+	 */
+	findAssets(sourceId: string, query: AssetsQuery): Promise<AssetsQueryResult<CompleteAssetResult>>;
+	/**
+	 * Fetch a specific asset by id from an asset source.
+	 * Returns `null` when the asset is not found.
+	 */
+	fetchAsset(sourceId: string, assetId: string, params?: {
+		locale?: string;
+	}): Promise<CompleteAssetResult | null>;
+	/**
+	 * Get available asset groups from a source.
+	 * @param id - The ID of the asset source.
+	 * @returns Promise resolving to list of available group names.
+	 */
+	getGroups(id: string): Promise<string[]>;
+	/**
+	 * Get license information for an asset source.
+	 * @param sourceId - The ID of the asset source.
+	 * @returns The asset source's license info.
+	 */
+	getLicense(sourceId: string): {
+		name: string;
+		url: string | undefined;
+	} | undefined;
+	/**
+	 * Get attribution credits for an asset source.
+	 * @param sourceId - The ID of the asset source.
+	 * @returns The asset source's credits info.
+	 */
+	getCredits(sourceId: string): {
+		name: string;
+		url: string | undefined;
+	} | undefined;
+	/**
+	 * Get supported MIME types for an asset source.
+	 * @param sourceId - The ID of the asset source.
+	 * @returns Array of supported MIME type strings.
+	 */
+	getSupportedMimeTypes(sourceId: string): string[];
+	/**
+	 * Add an asset to a local asset source.
+	 * @param sourceId - The local asset source ID.
+	 * @param asset - The asset definition to add.
+	 */
+	addAssetToSource(sourceId: string, asset: Asset): void;
+	/**
+	 * Remove an asset from a local asset source.
+	 * @param sourceId - The ID of the local asset source.
+	 * @param assetId - The ID of the asset to remove.
+	 */
+	removeAssetFromSource(sourceId: string, assetId: string): void;
+	/**
+	 * Notify the engine that an asset source's contents have changed.
+	 * @param sourceID - The asset source whose contents changed.
+	 */
+	assetSourceContentsChanged(sourceID: string): void;
+	/**
+	 * Subscribe to "asset source added" events.
+	 * @param callback - Called with the source ID whenever a new asset source is registered.
+	 * @returns A function that unsubscribes when called.
+	 */
+	onAssetSourceAdded(callback: (sourceId: string) => void): () => void;
+	/**
+	 * Subscribe to "asset source removed" events.
+	 * @param callback - Called with the source ID whenever an asset source is removed.
+	 * @returns A function that unsubscribes when called.
+	 */
+	onAssetSourceRemoved(callback: (sourceId: string) => void): () => void;
+	/**
+	 * Subscribe to "asset source updated" events.
+	 * @param callback - Called with the source ID whenever an asset source's contents change.
+	 * @returns A function that unsubscribes when called.
+	 */
+	onAssetSourceUpdated(callback: (sourceId: string) => void): () => void;
+	/**
+	 * Apply an asset to the current scene. Honors any middleware registered
+	 * via {@link registerApplyMiddleware} and falls back to
+	 * {@link defaultApplyAsset}.
+	 *
+	 * @public
+	 */
+	apply(sourceId: string, asset: CompleteAssetResult): Promise<DesignBlockId | undefined>;
+	/**
+	 * Apply an asset to a specific block. Honors any middleware registered
+	 * via {@link registerApplyToBlockMiddleware} and falls back to
+	 * {@link defaultApplyAssetToBlock}.
+	 *
+	 * @public
+	 */
+	applyToBlock(sourceId: string, asset: CompleteAssetResult, block: DesignBlockId): Promise<void>;
+	/**
+	 * Apply a property change from an asset payload.
+	 *
+	 * @public
+	 */
+	applyProperty(sourceId: string, asset: CompleteAssetResult, property: AssetProperty): Promise<void>;
+	/**
+	 * Default apply-asset implementation (no middleware). Calls the engine's
+	 * built-in apply logic; used as the tail of the middleware chain in
+	 * {@link apply}.
+	 *
+	 * @public
+	 */
+	defaultApplyAsset(asset: CompleteAssetResult): Promise<DesignBlockId | undefined>;
+	/**
+	 * Default apply-to-block implementation (no middleware). Used as the
+	 * tail of the middleware chain in {@link applyToBlock}.
+	 *
+	 * @public
+	 */
+	defaultApplyAssetToBlock(asset: CompleteAssetResult, block: DesignBlockId): Promise<void>;
+	/**
+	 * Register a middleware in the apply-asset chain for a source.
+	 *
+	 * @param sourceId - The source to install the middleware on.
+	 * @param middleware - Callable that may consume the asset, defer to
+	 *   the next middleware, or short-circuit. Returns the created block id
+	 *   (or undefined to fall through).
+	 * @public
+	 */
+	registerApplyMiddleware(sourceId: string, middleware: (asset: CompleteAssetResult, next: (asset: CompleteAssetResult) => Promise<DesignBlockId | undefined>) => Promise<DesignBlockId | undefined>): void;
+	/**
+	 * Register a middleware in the apply-asset-to-block chain for a source.
+	 *
+	 * @public
+	 */
+	registerApplyToBlockMiddleware(sourceId: string, middleware: (asset: CompleteAssetResult, block: DesignBlockId, next: (asset: CompleteAssetResult, block: DesignBlockId) => Promise<void>) => Promise<void>): void;
+	/**
+	 * Whether the named source supports `addAssetToSource` /
+	 * `removeAssetFromSource`. Local sources return `true` by default; custom
+	 * sources return whatever they declared via `canManageAssets` in their
+	 * registration object.
+	 *
+	 * @public
+	 */
+	canManageAssets(sourceId: string): boolean;
+}
+export interface NativeEngine {
+	update(): boolean;
+	dispose(): void;
+	unlockWithLicense(license: string): void;
+	getActiveLicense(): string;
+	createScene(sceneLayout?: string): DesignBlockId;
+	createVideoScene(): DesignBlockId;
+	createSceneFromImage(uri: string, dpi?: number, pixelScaleFactor?: number): Promise<DesignBlockId>;
+	createSceneFromVideo(uri: string): Promise<DesignBlockId>;
+	loadSceneFromString(content: string, overrideEditorConfig?: boolean, waitForResources?: boolean): Promise<DesignBlockId>;
+	loadSceneFromURL(url: string, overrideEditorConfig?: boolean, waitForResources?: boolean): Promise<DesignBlockId>;
+	loadSceneFromArchiveURL(url: string, overrideEditorConfig?: boolean, waitForResources?: boolean): Promise<DesignBlockId>;
+	saveSceneToString(scene: DesignBlockId, options?: {
+		compression?: {
+			format?: number;
+			level?: number;
+		};
+	}): Promise<string>;
+	saveSceneToArchive(scene: DesignBlockId): Promise<Uint8Array>;
+	applyTemplateFromString(content: string): Promise<void>;
+	applyTemplateFromURL(url: string): Promise<void>;
+	getPages(scene: DesignBlockId): DesignBlockId[];
+	addPage(scene: DesignBlockId): DesignBlockId;
+	getCurrentPage(scene: DesignBlockId): DesignBlockId | null;
+	getSceneMode(scene: DesignBlockId): string;
+	getSceneLayout(scene: DesignBlockId): string;
+	setSceneLayout(scene: DesignBlockId, layout: string): void;
+	getDesignUnit(scene: DesignBlockId): string;
+	setDesignUnit(scene: DesignBlockId, unit: string): void;
+	getFontSizeUnit(scene: DesignBlockId): string;
+	setFontSizeUnit(scene: DesignBlockId, unit: string): void;
+	create(type: string): DesignBlockId;
+	createFill(type: string): DesignBlockId;
+	createShape(type: string): DesignBlockId;
+	createEffect(type: string): DesignBlockId;
+	createBlur(type: string): DesignBlockId;
+	createAnimation(type: string): DesignBlockId;
+	duplicate(block: DesignBlockId, attachToParent?: boolean): DesignBlockId;
+	destroy(block: DesignBlockId): void;
+	isValid(block: DesignBlockId): boolean;
+	findAll(): DesignBlockId[];
+	findAllPlaceholders(): DesignBlockId[];
+	findAllUnused(): DesignBlockId[];
+	findByName(name: string): DesignBlockId[];
+	findByType(type: string): DesignBlockId[];
+	findByKind(kind: string): DesignBlockId[];
+	findAllSelected(): DesignBlockId[];
+	getParent(block: DesignBlockId): DesignBlockId;
+	hasParent(block: DesignBlockId): boolean;
+	getChildren(block: DesignBlockId): DesignBlockId[];
+	insertChild(parent: DesignBlockId, child: DesignBlockId, index: number): void;
+	appendChild(parent: DesignBlockId, child: DesignBlockId): void;
+	getType(block: DesignBlockId): string;
+	getKind(block: DesignBlockId): string;
+	setKind(block: DesignBlockId, kind: string): void;
+	getName(block: DesignBlockId): string;
+	setName(block: DesignBlockId, name: string): void;
+	getUUID(block: DesignBlockId): string;
+	getBool(block: DesignBlockId, property: string): boolean;
+	setBool(block: DesignBlockId, property: string, value: boolean): void;
+	getInt(block: DesignBlockId, property: string): number;
+	setInt(block: DesignBlockId, property: string, value: number): void;
+	getFloat(block: DesignBlockId, property: string): number;
+	setFloat(block: DesignBlockId, property: string, value: number): void;
+	getDouble(block: DesignBlockId, property: string): number;
+	setDouble(block: DesignBlockId, property: string, value: number): void;
+	getString(block: DesignBlockId, property: string): string;
+	setString(block: DesignBlockId, property: string, value: string): void;
+	getColor(block: DesignBlockId, property: string): NativeColorInternal;
+	setColor(block: DesignBlockId, property: string, value: NativeColorInternal): void;
+	getEnum(block: DesignBlockId, property: string): string;
+	setEnum(block: DesignBlockId, property: string, value: string): void;
+	getPositionX(block: DesignBlockId): number;
+	setPositionX(block: DesignBlockId, value: number): void;
+	getPositionY(block: DesignBlockId): number;
+	setPositionY(block: DesignBlockId, value: number): void;
+	getPositionXMode(block: DesignBlockId): string;
+	setPositionXMode(block: DesignBlockId, mode: string): void;
+	getPositionYMode(block: DesignBlockId): string;
+	setPositionYMode(block: DesignBlockId, mode: string): void;
+	getWidth(block: DesignBlockId): number;
+	setWidth(block: DesignBlockId, value: number): void;
+	getWidthMode(block: DesignBlockId): string;
+	setWidthMode(block: DesignBlockId, mode: string): void;
+	getHeight(block: DesignBlockId): number;
+	setHeight(block: DesignBlockId, value: number): void;
+	getHeightMode(block: DesignBlockId): string;
+	setHeightMode(block: DesignBlockId, mode: string): void;
+	getRotation(block: DesignBlockId): number;
+	setRotation(block: DesignBlockId, value: number): void;
+	getScaleX(block: DesignBlockId): number;
+	setScaleX(block: DesignBlockId, value: number): void;
+	getScaleY(block: DesignBlockId): number;
+	setScaleY(block: DesignBlockId, value: number): void;
+	getFlip(block: DesignBlockId): {
+		horizontal: boolean;
+		vertical: boolean;
+	};
+	setFlipHorizontal(block: DesignBlockId, flip: boolean): void;
+	setFlipVertical(block: DesignBlockId, flip: boolean): void;
+	scale(block: DesignBlockId, scale: number, anchorX?: number, anchorY?: number): void;
+	fillParent(block: DesignBlockId): void;
+	resizeContentAware(blocks: DesignBlockId[], width: number, height: number): Promise<void>;
+	getGlobalBoundingBoxX(block: DesignBlockId): number;
+	getGlobalBoundingBoxY(block: DesignBlockId): number;
+	getGlobalBoundingBoxWidth(block: DesignBlockId): number;
+	getGlobalBoundingBoxHeight(block: DesignBlockId): number;
+	getScreenSpaceBoundingBoxXYWH(blocks: DesignBlockId[]): XYWH;
+	supportsFill(block: DesignBlockId): boolean;
+	hasFill(block: DesignBlockId): boolean;
+	getFill(block: DesignBlockId): DesignBlockId;
+	setFill(block: DesignBlockId, fill: DesignBlockId): void;
+	getFillEnabled(block: DesignBlockId): boolean;
+	setFillEnabled(block: DesignBlockId, enabled: boolean): void;
+	getFillSolidColor(block: DesignBlockId): RGBAColor;
+	setFillSolidColor(block: DesignBlockId, color: {
+		r: number;
+		g: number;
+		b: number;
+		a: number;
+	}): void;
+	getGradientColorStops(block: DesignBlockId, property: string): Array<{
+		color: NativeColorInternal;
+		stop: number;
+	}>;
+	setGradientColorStops(block: DesignBlockId, property: string, stops: Array<{
+		color: NativeColorInternal;
+		stop: number;
+	}>): void;
+	supportsStroke(block: DesignBlockId): boolean;
+	hasStroke(block: DesignBlockId): boolean;
+	getStroke(block: DesignBlockId): DesignBlockId;
+	setStroke(block: DesignBlockId, stroke: DesignBlockId): void;
+	getStrokeEnabled(block: DesignBlockId): boolean;
+	setStrokeEnabled(block: DesignBlockId, enabled: boolean): void;
+	getStrokeColor(block: DesignBlockId): NativeColorInternal;
+	setStrokeColor(block: DesignBlockId, color: NativeColorInternal): void;
+	getStrokeColorRGBA(block: DesignBlockId): RGBAColor;
+	setStrokeColorRGBA(block: DesignBlockId, r: number, g: number, b: number, a: number): void;
+	getStrokeWidth(block: DesignBlockId): number;
+	setStrokeWidth(block: DesignBlockId, width: number): void;
+	getStrokeStyle(block: DesignBlockId): string;
+	setStrokeStyle(block: DesignBlockId, style: string): void;
+	getStrokePosition(block: DesignBlockId): string;
+	setStrokePosition(block: DesignBlockId, position: string): void;
+	getStrokeCornerGeometry(block: DesignBlockId): string;
+	setStrokeCornerGeometry(block: DesignBlockId, geometry: string): void;
+	getStrokeCap(block: DesignBlockId): string;
+	setStrokeCap(block: DesignBlockId, cap: string): void;
+	getStrokeStartCap(block: DesignBlockId): string;
+	setStrokeStartCap(block: DesignBlockId, cap: string): void;
+	getStrokeEndCap(block: DesignBlockId): string;
+	setStrokeEndCap(block: DesignBlockId, cap: string): void;
+	getStrokeDashStartCap(block: DesignBlockId): string;
+	setStrokeDashStartCap(block: DesignBlockId, cap: string): void;
+	getStrokeDashEndCap(block: DesignBlockId): string;
+	setStrokeDashEndCap(block: DesignBlockId, cap: string): void;
+	getStrokeDashArray(block: DesignBlockId): number[];
+	setStrokeDashArray(block: DesignBlockId, dashArray: number[]): void;
+	getStrokeDashOffset(block: DesignBlockId): number;
+	setStrokeDashOffset(block: DesignBlockId, dashOffset: number): void;
+	isLineOrigin(block: DesignBlockId): boolean;
+	supportsEffects(block: DesignBlockId): boolean;
+	hasEffects(block: DesignBlockId): boolean;
+	getEffects(block: DesignBlockId): DesignBlockId[];
+	appendEffect(block: DesignBlockId, effect: DesignBlockId): void;
+	insertEffect(block: DesignBlockId, effect: DesignBlockId, index: number): void;
+	removeEffect(block: DesignBlockId, index: number): void;
+	isEffectEnabled(effect: DesignBlockId): boolean;
+	setEffectEnabled(effect: DesignBlockId, enabled: boolean): void;
+	supportsBlur(block: DesignBlockId): boolean;
+	hasBlur(block: DesignBlockId): boolean;
+	getBlur(block: DesignBlockId): DesignBlockId;
+	setBlur(block: DesignBlockId, blur: DesignBlockId): void;
+	getBlurEnabled(block: DesignBlockId): boolean;
+	setBlurEnabled(block: DesignBlockId, enabled: boolean): void;
+	supportsShape(block: DesignBlockId): boolean;
+	getShape(block: DesignBlockId): DesignBlockId;
+	setShape(block: DesignBlockId, shape: DesignBlockId): void;
+	supportsAnimation(block: DesignBlockId): boolean;
+	getInAnimation(block: DesignBlockId): DesignBlockId;
+	setInAnimation(block: DesignBlockId, animation: DesignBlockId): void;
+	getOutAnimation(block: DesignBlockId): DesignBlockId;
+	setOutAnimation(block: DesignBlockId, animation: DesignBlockId): void;
+	getLoopAnimation(block: DesignBlockId): DesignBlockId;
+	setLoopAnimation(block: DesignBlockId, animation: DesignBlockId): void;
+	supportsContentFillMode(block: DesignBlockId): boolean;
+	getContentFillMode(block: DesignBlockId): string;
+	setContentFillMode(block: DesignBlockId, mode: string): void;
+	supportsCrop(block: DesignBlockId): boolean;
+	resetCrop(block: DesignBlockId): void;
+	adjustCropToFillFrame(block: DesignBlockId, minScaleRatio?: number): void;
+	getCropRotation(block: DesignBlockId): number;
+	setCropRotation(block: DesignBlockId, rotation: number): void;
+	getCropScaleX(block: DesignBlockId): number;
+	setCropScaleX(block: DesignBlockId, scale: number): void;
+	getCropScaleY(block: DesignBlockId): number;
+	setCropScaleY(block: DesignBlockId, scale: number): void;
+	getCropScaleRatio(block: DesignBlockId): number;
+	setCropScaleRatio(block: DesignBlockId, ratio: number): void;
+	getCropTranslationX(block: DesignBlockId): number;
+	setCropTranslationX(block: DesignBlockId, translation: number): void;
+	getCropTranslationY(block: DesignBlockId): number;
+	setCropTranslationY(block: DesignBlockId, translation: number): void;
+	isCropAspectRatioLocked(block: DesignBlockId): boolean;
+	setCropAspectRatioLocked(block: DesignBlockId, locked: boolean): void;
+	flipCropHorizontal(block: DesignBlockId): void;
+	flipCropVertical(block: DesignBlockId): void;
+	supportsDropShadow(block: DesignBlockId): boolean;
+	isDropShadowEnabled(block: DesignBlockId): boolean;
+	setDropShadowEnabled(block: DesignBlockId, enabled: boolean): void;
+	getDropShadowColor(block: DesignBlockId): NativeColorInternal;
+	setDropShadowColor(block: DesignBlockId, color: NativeColorInternal): void;
+	getDropShadowColorRGBA(block: DesignBlockId): RGBAColor;
+	setDropShadowColorRGBA(block: DesignBlockId, r: number, g: number, b: number, a: number): void;
+	getDropShadowOffsetX(block: DesignBlockId): number;
+	setDropShadowOffsetX(block: DesignBlockId, offset: number): void;
+	getDropShadowOffsetY(block: DesignBlockId): number;
+	setDropShadowOffsetY(block: DesignBlockId, offset: number): void;
+	getDropShadowBlurRadiusX(block: DesignBlockId): number;
+	setDropShadowBlurRadiusX(block: DesignBlockId, radius: number): void;
+	getDropShadowBlurRadiusY(block: DesignBlockId): number;
+	setDropShadowBlurRadiusY(block: DesignBlockId, radius: number): void;
+	getDropShadowClip(block: DesignBlockId): boolean;
+	setDropShadowClip(block: DesignBlockId, clip: boolean): void;
+	supportsBlendMode(block: DesignBlockId): boolean;
+	getBlendMode(block: DesignBlockId): string;
+	setBlendMode(block: DesignBlockId, mode: string): void;
+	supportsOpacity(block: DesignBlockId): boolean;
+	getOpacity(block: DesignBlockId): number;
+	setOpacity(block: DesignBlockId, opacity: number): void;
+	getVisible(block: DesignBlockId): boolean;
+	setVisible(block: DesignBlockId, visible: boolean): void;
+	getClipped(block: DesignBlockId): boolean;
+	setClipped(block: DesignBlockId, clipped: boolean): void;
+	setSelected(block: DesignBlockId, selected: boolean): void;
+	isSelected(block: DesignBlockId): boolean;
+	select(block: DesignBlockId): void;
+	bringToFront(block: DesignBlockId): void;
+	sendToBack(block: DesignBlockId): void;
+	bringForward(block: DesignBlockId): void;
+	sendBackward(block: DesignBlockId): void;
+	setAlwaysOnTop(block: DesignBlockId, enabled: boolean): void;
+	setAlwaysOnBottom(block: DesignBlockId, enabled: boolean): void;
+	isAlwaysOnTop(block: DesignBlockId): boolean;
+	isAlwaysOnBottom(block: DesignBlockId): boolean;
+	alignHorizontally(blocks: DesignBlockId[], alignment: string): void;
+	alignVertically(blocks: DesignBlockId[], alignment: string): void;
+	isAlignable(blocks: DesignBlockId[]): boolean;
+	distributeHorizontally(blocks: DesignBlockId[]): void;
+	distributeVertically(blocks: DesignBlockId[]): void;
+	isDistributable(blocks: DesignBlockId[]): boolean;
+	group(blocks: DesignBlockId[]): DesignBlockId;
+	ungroup(group: DesignBlockId): void;
+	isGroupable(blocks: DesignBlockId[]): boolean;
+	enterGroup(group: DesignBlockId): void;
+	exitGroup(block: DesignBlockId): void;
+	combine(blocks: DesignBlockId[], operation: string): DesignBlockId;
+	isCombinable(blocks: DesignBlockId[]): boolean;
+	supportsDuration(block: DesignBlockId): boolean;
+	getDuration(block: DesignBlockId): number;
+	setDuration(block: DesignBlockId, duration: number): void;
+	supportsTimeOffset(block: DesignBlockId): boolean;
+	getTimeOffset(block: DesignBlockId): number;
+	setTimeOffset(block: DesignBlockId, offset: number): void;
+	supportsTrim(block: DesignBlockId): boolean;
+	getTrimOffset(block: DesignBlockId): number;
+	setTrimOffset(block: DesignBlockId, offset: number): void;
+	getTrimLength(block: DesignBlockId): number;
+	setTrimLength(block: DesignBlockId, length: number): void;
+	supportsPlaybackControl(block: DesignBlockId): boolean;
+	supportsPlaybackTime(block: DesignBlockId): boolean;
+	getPlaybackTime(block: DesignBlockId): number;
+	setPlaybackTime(block: DesignBlockId, time: number): void;
+	isPlaying(block: DesignBlockId): boolean;
+	setPlaying(block: DesignBlockId, playing: boolean): void;
+	isLooping(block: DesignBlockId): boolean;
+	setLooping(block: DesignBlockId, looping: boolean): void;
+	getPlaybackSpeed(block: DesignBlockId): number;
+	setPlaybackSpeed(block: DesignBlockId, speed: number): void;
+	isMuted(block: DesignBlockId): boolean;
+	setMuted(block: DesignBlockId, muted: boolean): void;
+	getVolume(block: DesignBlockId): number;
+	setVolume(block: DesignBlockId, volume: number): void;
+	isSoloPlaybackEnabled(block: DesignBlockId): boolean;
+	setSoloPlaybackEnabled(block: DesignBlockId, enabled: boolean): void;
+	isForceMuted(block: DesignBlockId): boolean;
+	getTotalSceneDuration(scene: DesignBlockId): number;
+	isVisibleAtCurrentPlaybackTime(block: DesignBlockId): boolean;
+	isTransformLocked(block: DesignBlockId): boolean;
+	setTransformLocked(block: DesignBlockId, locked: boolean): void;
+	isHighlightingEnabled(block: DesignBlockId): boolean;
+	setHighlightingEnabled(block: DesignBlockId, enabled: boolean): void;
+	isSelectionEnabled(block: DesignBlockId): boolean;
+	setSelectionEnabled(block: DesignBlockId, enabled: boolean): void;
+	isIncludedInExport(block: DesignBlockId): boolean;
+	setIncludedInExport(block: DesignBlockId, included: boolean): void;
+	isPlaceholderEnabled(block: DesignBlockId): boolean;
+	setPlaceholderEnabled(block: DesignBlockId, enabled: boolean): void;
+	supportsPlaceholderBehavior(block: DesignBlockId): boolean;
+	isPlaceholderBehaviorEnabled(block: DesignBlockId): boolean;
+	setPlaceholderBehaviorEnabled(block: DesignBlockId, enabled: boolean): void;
+	supportsPlaceholderControls(block: DesignBlockId): boolean;
+	isPlaceholderControlsOverlayEnabled(block: DesignBlockId): boolean;
+	setPlaceholderControlsOverlayEnabled(block: DesignBlockId, enabled: boolean): void;
+	isPlaceholderControlsButtonEnabled(block: DesignBlockId): boolean;
+	setPlaceholderControlsButtonEnabled(block: DesignBlockId, enabled: boolean): void;
+	supportsBackgroundColor(block: DesignBlockId): boolean;
+	isBackgroundColorEnabled(block: DesignBlockId): boolean;
+	setBackgroundColorEnabled(block: DesignBlockId, enabled: boolean): void;
+	hasMetadata(block: DesignBlockId, key: string): boolean;
+	getMetadata(block: DesignBlockId, key: string): string;
+	setMetadata(block: DesignBlockId, key: string, value: string): void;
+	removeMetadata(block: DesignBlockId, key: string): void;
+	findAllMetadata(block: DesignBlockId): string[];
+	replaceText(block: DesignBlockId, text: string, from?: number, to?: number): void;
+	removeText(block: DesignBlockId, from?: number, to?: number): void;
+	getTextFontSizes(block: DesignBlockId, from?: number, to?: number): number[];
+	setTextFontSize(block: DesignBlockId, size: number, from?: number, to?: number): void;
+	getTextFontStyles(block: DesignBlockId, from?: number, to?: number): string[];
+	setTextFontStyle(block: DesignBlockId, style: string, from?: number, to?: number): void;
+	getTextFontWeights(block: DesignBlockId, from?: number, to?: number): string[];
+	setTextFontWeight(block: DesignBlockId, weight: string, from?: number, to?: number): void;
+	getTextColors(block: DesignBlockId, from?: number, to?: number): NativeColorInternal[];
+	setTextColor(block: DesignBlockId, color: NativeColorInternal, from?: number, to?: number): void;
+	getTextCases(block: DesignBlockId, from?: number, to?: number): string[];
+	setTextCase(block: DesignBlockId, textCase: string, from?: number, to?: number): void;
+	getTypefaces(block: DesignBlockId, from?: number, to?: number): Typeface[];
+	setTypeface(block: DesignBlockId, typeface: Typeface, from?: number, to?: number): void;
+	getTypeface(block: DesignBlockId): Typeface;
+	setFont(block: DesignBlockId, fontUri: string, typeface: Typeface): void;
+	setTextKerning(block: DesignBlockId, kerning: number, from?: number, to?: number): void;
+	getTextKernings(block: DesignBlockId, from?: number, to?: number): number[];
+	setContentFillHorizontalAlignment(block: DesignBlockId, alignment: string): void;
+	getContentFillHorizontalAlignment(block: DesignBlockId): string;
+	setContentFillVerticalAlignment(block: DesignBlockId, alignment: string): void;
+	getContentFillVerticalAlignment(block: DesignBlockId): string;
+	canToggleBoldFont(block: DesignBlockId): boolean;
+	toggleBoldFont(block: DesignBlockId): void;
+	canToggleItalicFont(block: DesignBlockId): boolean;
+	toggleItalicFont(block: DesignBlockId): void;
+	getTextCursorRange(): Range;
+	setTextCursorRange(from: number, to: number): void;
+	getTextCursorPositionInScreenSpaceX(block: DesignBlockId): number;
+	getTextCursorPositionInScreenSpaceY(block: DesignBlockId): number;
+	getTextVisibleLineCount(block: DesignBlockId): number;
+	getTextVisibleLineContent(block: DesignBlockId, lineIndex: number): string;
+	getTextVisibleLineGlobalBoundingBoxXYWH(block: DesignBlockId, lineIndex: number): XYWH;
+	getTextCharacterInkBoxes(block: DesignBlockId, from?: number, to?: number): CharacterInkBox[];
+	getTextEffectiveHorizontalAlignment(block: DesignBlockId): string;
+	getTextHorizontalAlignment(block: DesignBlockId, paragraphIndex?: number): string | undefined;
+	setTextHorizontalAlignment(block: DesignBlockId, alignment: string | undefined, paragraphIndex?: number): void;
+	getTextDecorations(block: DesignBlockId, from?: number, to?: number): unknown[];
+	setTextDecoration(block: DesignBlockId, config: unknown, from?: number, to?: number): void;
+	toggleTextDecorationUnderline(block: DesignBlockId, from?: number, to?: number): void;
+	toggleTextDecorationStrikethrough(block: DesignBlockId, from?: number, to?: number): void;
+	toggleTextDecorationOverline(block: DesignBlockId, from?: number, to?: number): void;
+	getTextListStyle(block: DesignBlockId, paragraphIndex: number): string;
+	setTextListStyle(block: DesignBlockId, listStyle: string, paragraphIndex?: number, listLevel?: number): void;
+	getTextListLevel(block: DesignBlockId, paragraphIndex: number): number;
+	setTextListLevel(block: DesignBlockId, listLevel: number, paragraphIndex?: number): void;
+	getTextParagraphIndices(block: DesignBlockId, from?: number, to?: number): number[];
+	getTextLineHeight(block: DesignBlockId, paragraphIndex: number): number;
+	setTextLineHeight(block: DesignBlockId, lineHeight: number | undefined, paragraphIndex?: number): void;
+	getFontMetrics(fontFileUri: string): Promise<FontMetrics>;
+	setMovementConstraint(targets: (DesignBlockId | string)[], overshoot: number): void;
+	getMovementConstraint(block: DesignBlockId): number;
+	removeMovementConstraint(targets: (DesignBlockId | string)[]): void;
+	getSourceSet(block: DesignBlockId, property: string): Source[];
+	setSourceSet(block: DesignBlockId, property: string, sources: Source[]): void;
+	addImageFileURIToSourceSet(block: DesignBlockId, property: string, uri: string): Promise<void>;
+	addVideoFileURIToSourceSet(block: DesignBlockId, property: string, uri: string): Promise<void>;
+	getVideoWidth(block: DesignBlockId): number;
+	getVideoHeight(block: DesignBlockId): number;
+	getAudioTrackCountFromVideo(block: DesignBlockId): number;
+	getAVResourceTotalDuration(block: DesignBlockId): number;
+	split(block: DesignBlockId, time: number): DesignBlockId;
+	getSceneMode(scene: DesignBlockId): string;
+	setSceneMode(scene: DesignBlockId, mode: string): void;
+	getSceneLayout(scene: DesignBlockId): SceneLayout;
+	setSceneLayout(scene: DesignBlockId, layout: SceneLayout): void;
+	getDesignUnit(scene: DesignBlockId): string;
+	setDesignUnit(scene: DesignBlockId, unit: string): void;
+	getFontSizeUnit(scene: DesignBlockId): string;
+	setFontSizeUnit(scene: DesignBlockId, unit: string): void;
+	getLastFrameX(block: DesignBlockId): number;
+	getLastFrameY(block: DesignBlockId): number;
+	getLastFrameWidth(block: DesignBlockId): number;
+	getLastFrameHeight(block: DesignBlockId): number;
+	supportsPageDurationSource(page: DesignBlockId, block: DesignBlockId): boolean;
+	setPageDurationSource(page: DesignBlockId, block: DesignBlockId): void;
+	removePageDurationSource(page: DesignBlockId): void;
+	isPageDurationSource(block: DesignBlockId): boolean;
+	findAllScopes(): string[];
+	getGlobalScope(key: string): string;
+	setGlobalScope(key: string, value: string): void;
+	isScopeEnabled(block: DesignBlockId, scope: string): boolean;
+	setScopeEnabled(block: DesignBlockId, scope: string, enabled: boolean): void;
+	isAllowedByScope(block: DesignBlockId, scope: string): boolean;
+	findAllProperties(block: DesignBlockId): string[];
+	getPropertyType(property: string): string;
+	isPropertyReadable(property: string): boolean;
+	isPropertyWritable(property: string): boolean;
+	getEnumValues(property: string): string[];
+	getRole(): string;
+	setRole(role: string): void;
+	startTracking(license: string, userId: string, deviceId: string): void;
+	getState(block: DesignBlockId): string;
+	setZoomLevel(sceneOrCamera: DesignBlockId, level: number): void;
+	getZoomLevel(sceneOrCamera: DesignBlockId): number;
+	zoomToBlock(block: DesignBlockId, paddingLeft?: number, paddingTop?: number, paddingRight?: number, paddingBottom?: number): Promise<void>;
+	zoomToBlockWithAnimation(block: DesignBlockId, paddingLeft: number, paddingTop: number, paddingRight: number, paddingBottom: number, duration: number, easing: string, interruptible: boolean): Promise<void>;
+	immediateZoomToBlock(block: DesignBlockId, paddingLeft?: number, paddingTop?: number, paddingRight?: number, paddingBottom?: number): void;
+	enableZoomAutoFit(scene: DesignBlockId, axis: string, paddingLeft?: number, paddingTop?: number, paddingRight?: number, paddingBottom?: number): void;
+	disableZoomAutoFit(scene: DesignBlockId): void;
+	isZoomAutoFitEnabled(scene: DesignBlockId): boolean;
+	findNearestToViewPortCenterByType(scene: DesignBlockId, type: string): DesignBlockId[];
+	findNearestToViewPortCenterByKind(scene: DesignBlockId, kind: string): DesignBlockId[];
+	unstable_enableCameraPositionClamping(blocks: DesignBlockId[], paddingLeft?: number, paddingTop?: number, paddingRight?: number, paddingBottom?: number, scaledPaddingLeft?: number, scaledPaddingTop?: number, scaledPaddingRight?: number, scaledPaddingBottom?: number): void;
+	unstable_disableCameraPositionClamping(block: DesignBlockId): void;
+	unstable_isCameraPositionClampingEnabled(block: DesignBlockId): boolean;
+	unstable_enableCameraZoomClamping(blocks: DesignBlockId[], minZoomLimit?: number, maxZoomLimit?: number, paddingLeft?: number, paddingTop?: number, paddingRight?: number, paddingBottom?: number): void;
+	unstable_disableCameraZoomClamping(block: DesignBlockId): void;
+	unstable_isCameraZoomClampingEnabled(block: DesignBlockId): boolean;
+	exportToBuffer(block: DesignBlockId, mimeType: string, options?: Record<string, unknown>): Promise<Uint8Array>;
+	exportWithColorMaskToBuffer(block: DesignBlockId, mimeType: string, maskColorR: number, maskColorG: number, maskColorB: number, options: {
+		targetWidth: number;
+		targetHeight: number;
+		useTargetSize: boolean;
+		jpegQuality: number;
+		webpQuality: number;
+		pngCompressionLevel: number;
+		exportPdfWithHighCompatibility: boolean;
+		exportPdfWithUnderlayer: boolean;
+		underlayerSpotColorName: string;
+		underlayerOffset: number;
+		underlayerRenderRatio: number;
+		underlayerMaxError: number;
+		allowTextOverhang: boolean;
+	}): Promise<Uint8Array[]>;
+	exportVideoToBuffer(block: DesignBlockId, timeOffset: number, duration: number, mimeType: string, progressCallback: (rendered: number, encoded: number, total: number) => void, resultCallback: (error: Error | null, data?: Uint8Array) => void, options: {
+		h264Profile: number;
+		h264Level: number;
+		videoBitrate: number;
+		audioBitrate: number;
+		framerate: number;
+		useTargetSize: boolean;
+		targetWidth: number;
+		targetHeight: number;
+		allowTextOverhang: boolean;
+	}): void;
+	exportAudioToBuffer(block: DesignBlockId, timeOffset: number, duration: number, mimeType: string, progressCallback: (rendered: number, encoded: number, total: number) => void, resultCallback: (error: Error | null, data?: Uint8Array) => void, options: {
+		sampleRate: number;
+		numberOfChannels: number;
+		skipEncoding?: boolean;
+	}): void;
+	loadBlocksFromString(content: string): Promise<DesignBlockId[]>;
+	loadBlocksFromURL(url: string): Promise<DesignBlockId[]>;
+	loadBlocksFromArchiveURL(url: string): Promise<DesignBlockId[]>;
+	saveBlocksToString(blocks: DesignBlockId[]): Promise<string>;
+	saveBlocksToArchive(blocks: DesignBlockId[]): Promise<Uint8Array>;
+	forceLoadAVResource(block: DesignBlockId): Promise<void>;
+	forceLoadResources(blocks: DesignBlockId[]): Promise<void>;
+	createHistory(): HistoryId;
+	destroyHistory(history: HistoryId): void;
+	getActiveHistory(): HistoryId;
+	setActiveHistory(history: HistoryId): void;
+	undo(): void;
+	redo(): void;
+	canUndo(): boolean;
+	canRedo(): boolean;
+	addUndoStep(): void;
+	removeUndoStep(): void;
+	subscribe(blocks: DesignBlockId[], callback: (events: BlockEvent[]) => void): SubscriptionId;
+	unsubscribe(subscription: SubscriptionId): void;
+	subscribeToZoomLevel(callback: () => void): SubscriptionId;
+	subscribeToActiveSceneChange(callback: () => void): SubscriptionId;
+	subscribeToBlockState(blocks: DesignBlockId[], callback: (ids: DesignBlockId[]) => void): SubscriptionId;
+	subscribeToEditorState(callback: () => void): SubscriptionId;
+	subscribeToSettings(callback: () => void): SubscriptionId;
+	subscribeToSelectionChange(callback: () => void): SubscriptionId;
+	subscribeToBlockClicked(callback: (id: DesignBlockId) => void): SubscriptionId;
+	subscribeToHistoryWithKind(callback: (kind: number) => void): SubscriptionId;
+	subscribeToRoleChange(callback: (role: string) => void): SubscriptionId;
+	subscribeToAssetSourceAdded(callback: (sourceId: string) => void): SubscriptionId;
+	subscribeToAssetSourceRemoved(callback: (sourceId: string) => void): SubscriptionId;
+	subscribeToAssetSourceUpdated(callback: (sourceId: string) => void): SubscriptionId;
+	addAssetSource(source: {
+		id: string;
+		findAssets: (query: AssetsQuery, resultCb: (error: any, result?: AssetsQueryResult) => void) => void;
+		fetchAsset?: (id: string, params: {
+			locale?: string;
+		} | undefined, resultCb: (error: any, result?: AssetResult | null) => void) => void;
+		getGroups?: (resultCb: (error: any, result?: string[]) => void) => void;
+		credits?: {
+			name: string;
+			url?: string;
+		};
+		license?: {
+			name: string;
+			url?: string;
+		};
+		getSupportedMimeTypes?: () => string[] | undefined;
+		applyAsset?: (asset: CompleteAssetResult, resultCb: (error: any, result?: DesignBlockId) => void) => void;
+		applyAssetToBlock?: (asset: CompleteAssetResult, block: DesignBlockId, resultCb: (error: any) => void) => void;
+		applyAssetProperty?: (asset: CompleteAssetResult, property: AssetProperty, resultCb: (error: any) => void) => void;
+		addAsset?: (asset: AssetDefinition) => void;
+		removeAsset?: (assetId: string) => void;
+	}): void;
+	addLocalAssetSource(id: string, supportedMimeTypes: string[]): void;
+	addLocalAssetSourceFromJSONString(contentJSON: string, basePath?: string, matcher?: string[]): string;
+	addLocalAssetSourceFromJSONURI(contentURI: string, matcher?: string[]): Promise<string>;
+	removeAssetSource(id: string): void;
+	findAllAssetSources(): string[];
+	findAssetSourceAssets(sourceId: string, query: AssetsQuery): Promise<AssetsQueryResult>;
+	fetchAssetSourceAsset(sourceId: string, assetId: string, query: {
+		locale: string;
+	}): Promise<CompleteAssetResult | null>;
+	getAssetSourceGroups(sourceId: string): string[];
+	getAssetSourceLicense(sourceId: string): AssetSourceLicense | null;
+	getAssetSourceCredits(sourceId: string): AssetSourceCredits | null;
+	getAssetSourceSupportedMimeTypes(sourceId: string): string[];
+	addAssetToSource(sourceId: string, asset: Asset): void;
+	removeAssetFromSource(sourceId: string, assetId: string): void;
+	assetSourceContentsChanged(sourceId: string): void;
+	applyAssetSourceAsset(sourceId: string, asset: CompleteAssetResult): Promise<DesignBlockId | undefined>;
+	applyAssetSourceAssetToBlock(sourceId: string, asset: CompleteAssetResult, block: DesignBlockId): Promise<void>;
+	applyAssetSourceProperty(sourceId: string, asset: CompleteAssetResult, property: AssetProperty): Promise<void>;
+	defaultApplyAsset(asset: CompleteAssetResult): Promise<DesignBlockId | undefined>;
+	defaultApplyAssetToBlock(asset: CompleteAssetResult, block: DesignBlockId): Promise<void>;
+	setVariable(key: string, value: string): void;
+	getVariable(key: string): string;
+	findAllVariables(): string[];
+	removeVariable(key: string): void;
+	getVariableString(key: string): string;
+	setVariableString(key: string, value: string): void;
+	referencesAnyVariables(block: DesignBlockId): boolean;
+	getEditMode(): string;
+	setEditMode(mode: string): void;
+	getSettingBool(key: string): boolean;
+	setSettingBool(key: string, value: boolean): void;
+	getSettingInt(key: string): number;
+	setSettingInt(key: string, value: number): void;
+	getSettingFloat(key: string): number;
+	setSettingFloat(key: string, value: number): void;
+	getSettingString(key: string): string;
+	setSettingString(key: string, value: string): void;
+	getSettingColor(key: string): NativeColorInternal;
+	setSettingColor(key: string, value: NativeColorInternal): void;
+	getSettingEnum(key: string): string;
+	setSettingEnum(key: string, value: string): void;
+	findAllSettings(): string[];
+	getSettingType(key: string): string;
+	getSettingEnumOptions(key: string): string[];
+	getCursorType(): string;
+	getCursorRotation(): number;
+	setSafeAreaInsets(left: number, top: number, right: number, bottom: number): void;
+	getSafeAreaInsets(): Insets;
+	getUsedMemory(): number;
+	getAvailableMemory(): number;
+	convertColorToColorSpace(color: NativeColorInternal, colorSpace: number): NativeColorInternal;
+	supportsP3(): boolean;
+	getAbsoluteURI(relativeUri: string): Promise<string>;
+	defaultURIResolver(relativePath: string): string;
+	setURIResolver(resolver: (uri: string) => string): void;
+	setURIResolverAsync(resolver: (uri: string, callback: (result: string | Error) => void) => void): void;
+	getMimeType(uri: string): Promise<string>;
+	relocateResource(currentUri: string, newUri: string): void;
+	findAllMediaURIs(): string[];
+	findAllTransientResources(): Array<{
+		uri: string;
+		size: number;
+	}>;
+	findAllSpotColors(): string[];
+	getSpotColorRGB(name: string): RGBAColor;
+	getSpotColorCMYK(name: string): CMYKColor;
+	setSpotColorRGB(name: string, r: number, g: number, b: number): void;
+	setSpotColorCMYK(name: string, c: number, m: number, y: number, k: number): void;
+	removeSpotColor(name: string): void;
+	createBuffer(): string;
+	destroyBuffer(uri: string): void;
+	setBufferData(uri: string, offset: number, data: Uint8Array): void;
+	getBufferData(uri: string, offset: number, length: number): Uint8Array;
+	getBufferLength(uri: string): number;
+	setBufferLength(uri: string, length: number): void;
+}
+declare class CreativeEngine implements ICreativeEngine {
+	#private;
+	static readonly version: string;
+	asset: AssetAPI;
+	block: BlockAPI;
+	editor: EditorAPI;
+	event: EventAPI;
+	scene: SceneAPI;
+	variable: VariableAPI;
+	readonly version: string;
+	private constructor();
+	/**
+	 * Update the engine's internal state
+	 * @returns Whether the engine needed an update.
+	 */
+	update(): boolean;
+	/**
+	 * Dispose the engine and clean up all resources
+	 */
+	dispose(): void;
+	/**
+	 * Initialize a CreativeEngine.
+	 *
+	 * Mirrors `@cesdk/node`'s {@link Configuration} shape exactly. The
+	 * native-only `device` field selects the render backend
+	 * (`'auto'` | `'cpu'` | `'gpu'`); web/WASM Node accept the field for shape
+	 * parity but ignore non-`'auto'` values.
+	 *
+	 * @param config - Engine configuration. All fields optional; defaults
+	 *   match `@cesdk/node` + `'auto'` device selection.
+	 * @returns A ready-to-use engine instance.
+	 * @public
+	 */
+	static init(config?: Partial<Configuration>): Promise<CreativeEngine>;
+	/**
+	 * Get the base URL for engine assets
+	 */
+	getBaseURL(): string;
+	/**
+	 * Register a set of default asset sources containing default assets.
+	 *
+	 * Mirrors `@cesdk/node`'s instance method
+	 * (bindings/wasm/js_node/src/CreativeEngine.ts). Loads
+	 * `${baseURL}/<source-id>/content.json` for each id in the default set
+	 * and registers the contents as a local asset source. baseURL defaults
+	 * to the engine's configured baseURL (`file://<addon>/assets/` if none
+	 * was passed to init).
+	 *
+	 * @public
+	 */
+	addDefaultAssetSources({ baseURL, excludeAssetSourceIds }?: {
+		baseURL?: string;
+		excludeAssetSourceIds?: DefaultAssetSourceId[];
+	}): Promise<void>;
+	/**
+	 * Register a set of demo asset sources containing example assets.
+	 *
+	 * Mirrors `@cesdk/node`'s `bindings/wasm/js_web/src/addDemoAssetSources.ts`
+	 * — accepts `sceneMode`, `withUploadAssetSources`, and the full demo
+	 * source-ID union (templates + textComponents + uploads + media).
+	 *
+	 * @public
+	 */
+	addDemoAssetSources({ baseURL, excludeAssetSourceIds, sceneMode, withUploadAssetSources }?: {
+		baseURL?: string;
+		excludeAssetSourceIds?: DemoAssetSourceId[];
+		sceneMode?: "Design" | "Video";
+		withUploadAssetSources?: boolean;
+	}): Promise<void>;
+}
+
+export {
+	CreativeEngine as default,
+	MimeType as MimeTypeString,
+	TextHorizontalAlignment as HorizontalTextAlignment,
+	TextVerticalAlignment as VerticalTextAlignment,
+};
+
+export {};