Search Docs
Loading...
Skip to content

Package: documentation

Classes#

ClassDescription
AssetAPIManage asset sources and apply assets to scenes.
BlockAPICreate, manipulate, and query the building blocks of your design.
CreativeEngineThe CreativeEngine is the core processing unit of CE.SDK and handles state management, rendering, input handling, and much more. It provides APIs to directly interact with assets, blocks, scenes, and variables. These APIs can be used in a headless environment to build and manipulate designs programmatically, or in a browser to create interactive applications.
EditorAPIControl the design editor’s behavior and settings.
EngineActionsNamed, overridable actions for one engine. Actions are either JS closures you register or engine defaults (e.g. undo/redo), and either kind can override the other by reusing the id.
EventAPISubscribe to block lifecycle events in the design engine.
SceneAPICreate, load, save, and manipulate scenes.
VariableAPIManage text variables within design templates.

Functions#

FunctionDescription
isCMYKColorType guard for CMYKColor.
isRGBAColorType guard for RGBAColor.
isSpotColorType guard for SpotColor.

Type Aliases#

Type AliasDescription
AddImageOptionsOptions for adding images to the scene.
AnimationBaselineDirection-
AnimationBlockSwipeTextDirection-
AnimationEasing-
AnimationEntryConfiguration options for animations.
AnimationGrowDirection-
AnimationJumpLoopDirection-
AnimationKenBurnsDirection-
AnimationMergeTextDirection-
AnimationOptionsOptions for configuring animations (in, loop, out animations).
AnimationSpinDirection-
AnimationSpinLoopDirection-
AnimationTypeThe block type IDs for the animation blocks. These are the IDs used to create new animations using cesdk.engine.block.createAnimation(id). Refer to AnimationTypeShorthand and AnimationTypeLonghand for more details.
AnimationTypeLonghandThe longhand block type IDs for the animation blocks. These are the IDs used to create new animations using cesdk.engine.block.createAnimation(id).
AnimationTypeShorthand-
AnimationTypewriterTextWritingStyle-
AnimationWipeDirection-
ApplicationMimeTypeRepresents the application MIME types used in the editor.
AssetColorAsset Color payload
AssetFilterFilter 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.
AssetGroupsAn asset can be member of multiple groups. Groups have a semantic meaning used to build and group UIs exploring the assets, e.g.sections in the content library, or for things like topics in Unsplash for instance.
AssetMetaDataGeneric asset information
AssetPropertyAsset property for payload
AssetPropertyFilterA 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.
AssetPropertyPathDot-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).
AssetStylePresetAnimationPropertiesThe parameters of an AssetStylePresetAnimation: a map of the animation’s property paths to values. The animation’s animation/* properties (e.g. animation/slide/fade, animation/grow/scaleFactor) are value-checked and autocomplete, as are the animation controls (playback/duration, animationEasing, textWritingStyle, textWritingOverlap); any other property path is still accepted. These are animation paths, distinct from the block-property paths in AssetStylePresetProperties.
AssetStylePresetPropertiesThe look of an AssetStylePreset: a map of property paths to values. Known paths are value-checked and autocomplete (e.g. stroke/enabled must be a boolean, stroke/width a number, fill/solid/color a color); any other property path is still accepted with the broader AssetStylePresetPropertyValue. Keys without a / are namespaced to the block (text/ or caption/); keys with a / are used verbatim.
AssetStylePresetPropertyValueA value a style preset can set on a property: a boolean, number, string (including enum values) or an RGB(A) color. Colors must be RGB(A) ({ r, g, b, a? }); CMYK and spot colors are not supported in presets. Structs and source sets cannot be set from a preset. A null value is ignored for regular properties; for the virtual text/path property it clears the baseline path.
AssetStylePresetScalablePropertyA length property a style preset may scale with the block’s font size (see AssetStylePreset.scaleWithFontSize). Restricted to the decoration lengths for which scaling is meaningful — stroke width, drop-shadow offset/blur and the caption background corner radius — not arbitrary numeric properties like rotation or opacity.
AssetTransformPresetTransform preset payload
AsyncURIResolverAn async-compatible URI resolver function.
AudioExportOptionsRepresents the options for exporting audio.
AudioFromVideoOptionsOptions for configuring audio extraction from video operations.
AudioMimeTypeRepresents the audio MIME types used in the editor.
BlendMode-
BlockEnumType-
BlockStateRepresents the state of a design block.
BlurTypeThe block type IDs for the blur blocks. These are the IDs used to create new blurs using cesdk.engine.block.createBlur(id). Refer to BlurTypeShorthand and BlurTypeLonghand for more details.
BlurTypeLonghandThe longhand block type IDs for the blur blocks. These are the IDs used to create new blurs using cesdk.engine.block.createBlur(id).
BlurTypeShorthand-
BooleanOperationRepresents the names of boolean operations.
BoolPropertyName-
CameraClampingOvershootMode-
CaptionHorizontalAlignment-
CaptionVerticalAlignment-
CMYKRepresents a color in the CMYK color space.
ColorRepresents all color types supported by the engine.
ColorPickerColorMode-
ColorPropertyName-
ColorSpaceRepresents the color space used in the editor.
ContentFillMode-
ControlGizmoMoveHandleVisibility-
ControlGizmoResizeHandlesVisibility-
ControlGizmoRotateHandlesVisibility-
ControlGizmoScaleHandlesVisibility-
CreateSceneOptionsOptions for creating a video scene.
CutoutOperationRepresents the type of a cutout.
CutoutType-
DefaultAssetSourceIdRepresents the default asset source IDs used in the editor.
DemoAssetSourceIdRepresents the default demo asset source IDs used in the editor.
DesignBlockIdA numerical identifier for a design block
DesignBlockTypeThe block type IDs for the top-level design blocks. These are the IDs used to create new blocks using cesdk.engine.block.create(id). Refer to DesignBlockTypeShorthand and DesignBlockTypeLonghand for more details.
DesignBlockTypeLonghandThe longhand block type IDs for the top-level design blocks. These are the IDs used to create new blocks using cesdk.engine.block.create(id).
DesignBlockTypeShorthand-
DoubleClickSelectionMode-
DoublePropertyName-
DropShadowOptionsOptions for configuring drop shadow effects on blocks.
EditModeRepresents the current edit mode of the editor.
EffectTypeThe block type IDs for the effect blocks. These are the IDs used to create new effects using cesdk.engine.block.createEffect(id). Refer to EffectTypeShorthand and EffectTypeLonghand for more details.
EffectTypeLonghandThe longhand block type IDs for the effect blocks. These are the IDs used to create new effects using cesdk.engine.block.createEffect(id).
EffectTypeShorthand-
EngineActionIdKnown action ids from EngineActionsRegistry.
EngineCustomActionFunctionA generic, untyped action function for custom ids.
EnginePluginContextRepresents the context for an engine plugin.
EnumPropertyName-
EnumValues-
ExportOptionsRepresents the options for exporting a design block.
FillPixelStreamOrientation-
FillTypeThe block type IDs for the fill blocks. These are the IDs used to create new fills using cesdk.engine.block.createFill(id). Refer to FillTypeShorthand and FillTypeLonghand for more details.
FillTypeLonghandThe longhand block type IDs for the fill blocks. These are the IDs used to create new fills using cesdk.engine.block.createFill(id).
FillTypeShorthand-
FloatPropertyName-
FontSizeUnitExtended design unit type that includes Point for font size operations. Maintains consistency with SceneDesignUnit’s capitalized naming convention.
FontStyleAllowed font styles. Mirrors the WASM FontStyle union.
FontWeightAllowed font weights. Mirrors the @cesdk/engine (WASM) FontWeight union so a single Font is interchangeable across bindings.
GradientstopRGBARepresents a gradient stop in the RGBA color space.
HeightMode-
HexColorStringRepresents a hexadecimal color value (RGB or RGBA) that starts with a ’#’.
HistoryIdA numerical identifier for a history stack
HistoryUpdateDescribes the kind of update that triggered an onHistoryUpdatedWithKind callback.
HorizontalBlockAlignment-
HorizontalContentFillAlignment-
ImageMimeTypeRepresents the image MIME types used in the editor.
IntPropertyName-
ListStyleRepresents the list style of a paragraph.
Localee.g. en, de, etc.
LogLevelProvides logging functionality for the Creative Editor SDK.
MimeTypeRepresents the MIME types used in the editor.
ObjectTypeThe block type IDs for all blocks types in the Creative Engine. Those are the types that can be passed to cesdk.engine.block.findByType(type) for example. Refer to ObjectTypeShorthand and ObjectTypeLonghand for more details.
ObjectTypeLonghandThe longhand block type IDs for all blocks types in the Creative Engine. Those are the Types returned by the engine when calling cesdk.engine.block.getType(blockId) for example.
ObjectTypeShorthandThe shorthand block type IDs for all blocks types in the Creative Engine. Those are the types that can be passed to cesdk.engine.block.findByType(type) for example.
OptionalPrefix-
PageGuidesSource-
PaletteColorRepresents a color definition for the custom color palette.
PositionMode-
PositionXMode-
PositionYMode-
PropertyTypeRepresents the various types of properties that can be associated with design blocks. Each type corresponds to a different kind of data that can be used to define the properties of a design block within the system.
RGBARepresents a color in the RGBA color space.
RoleStringRepresents a role string.
DesignUnit-
SceneFontSizeUnit-
SceneLayout-
SceneMode-
ScopeRepresents the various scopes that define the capabilities and permissions within the Creative Editor SDK. Each scope corresponds to a specific functionality or action that can be performed within the editor.
SettingBoolPropertyName-
SettingColorPropertyName-
SettingEnumPropertyName-
SettingEnumType-
SettingEnumValues-
SettingFloatPropertyName-
SettingIntPropertyName-
SettingKeyUnion type of all valid setting keys.
SettingsBool-
SettingsColorRepresents the color settings available in the editor.
SettingsColorRGBARepresents the color settings available in the editor.
SettingsEnum-
SettingsFloat-
SettingsInt-
SettingsString-
SettingStringPropertyName-
SettingTypeRepresents the type of a setting.
SettingValueTypeGets the value type for a specific setting key.
ShapeTypeThe block type IDs for the shape blocks. These are the IDs used to create new shapes using cesdk.engine.block.createShape(id). Refer to ShapeTypeShorthand and ShapeTypeLonghand for more details.
ShapeTypeLonghandThe longhand block type IDs for the blocks. These are the IDs used to create new shapes using cesdk.engine.block.createShape(id).
ShapeTypeShorthand-
ShapeVectorPathFillRule-
SizeMode-
SortingOrderThe order to sort by if the asset source supports sorting. If set to None, the order is the same as the assets were added to the source.
SourceSetPropertyName-
SplitOptionsOptions for configuring block split operations.
StringPropertyName-
StrokeCap-
StrokeCornerGeometry-
StrokeDashEndCap-
StrokeDashStartCap-
StrokeEndCap-
StrokePosition-
StrokeStartCap-
StrokeStyle-
SyncURIResolverA synchronous URI resolver function.
TextAnimationWritingStyle-
TextCaseRepresents the text case of a text block.
TextDecorationLineRepresents a line type for text decoration.
TextDecorationStyleRepresents the style of a text decoration line.
HorizontalTextAlignment-
TextVerticalAlignment-
TimelineTrackVisibility-
TouchPinchAction-
TouchRotateAction-
TypefaceDefinitionRepresents a typeface definition used in the editor.
VerticalBlockAlignment-
VerticalContentFillAlignment-
VideoExportOptionsRepresents the options for exporting a video.
VideoMimeTypeRepresents the video MIME types used in the editor.
WidthMode-
XYWHDescribes a rectangle on the screen.
ZoomAutoFitAxisThe axis(es) for which to auto-fit.
ZoomOptionsOptions for zooming to a block with optional animation.

Enumerations#

EnumerationDescription
CompressionFormatCompression format for scene serialization.
CompressionLevelCompression level for scene serialization.

Interfaces#

InterfaceDescription
AddVideoOptionsOptions for adding videos to the scene.
ApplyAssetOptionsOptions for applying an asset to the scene.
AssetGeneric asset information
AssetBooleanPropertyAsset boolean property definition
AssetCMYKColorAsset Color payload CMYK representation
AssetColorPropertyAsset color property definition
AssetContentAspectRatioAsset transform preset payload that snaps a block’s frame to the intrinsic aspect ratio of the block’s content (e.g. the underlying image or video).
AssetDefinitionDefinition of an asset used if an asset is added to an asset source.
AssetEnumPropertyAsset enum property definition
AssetFixedAspectRatioAsset transform preset payload fixed aspect ratio
AssetFixedSizeAsset transform preset payload fixed size
AssetFreeAspectRatioAsset transform preset payload free aspect ratio
AssetNumberPropertyAsset number property definition
AssetPayloadAsset payload
AssetQueryDataDefines a request for querying assets
AssetResultSingle asset result of a query from the engine.
AssetRGBColorAsset Color payload RGB representation
AssetSourceA source of assets
AssetSpotColorAsset Color payload SpotColor representation
AssetsQueryResultReturn type of a findAssets query.
AssetStringPropertyAsset string property definition
AssetStylePresetA declarative style preset the engine applies to text and caption blocks. The engine parses and applies it identically on every platform. Lives in AssetPayload.stylePreset.
AssetStylePresetAnimationAn animation slot of an AssetStylePreset (inAnimation, outAnimation or loopAnimation).
AudioTrackInfoInformation about a single audio track from a video. This interface provides comprehensive metadata about audio tracks, including codec information, technical specifications, and track details.
BlockEventRepresents an event related to a design block.
BlockStateErrorRepresents an error state for a design block.
BlockStatePendingRepresents a pending state for a design block.
BlockStateReadyRepresents a ready state for a design block.
BufferRepresents a buffer of data.
CharacterInkBoxTight 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).
CMYKColorRepresents a CMYK color value.
CompleteAssetResultAsset results that are returned from the engine.
ConfigurationSpecifies the configuration for the Creative Editor SDK.
DominantColorA single color extracted from the rendered appearance of a block.
DominantColorsOptionsOptions for BlockAPI.getDominantColors.
EngineActionInfoInfo about a registered action, from EngineActions.list.
EngineActionsRegistryHook for hosts to add strongly-typed action ids. Augment via declare module '@cesdk/engine' to get autocomplete on register/run while still allowing custom string ids.
EnginePluginRepresents an engine plugin.
FontIndividual font within a typeface. Field optionality matches @cesdk/engine (WASM) — fields not present in the engine response are simply omitted rather than empty strings.
FontMetricsFont metrics extracted from a font file. Values are in the font’s design units coordinate space.
GradientColorStopRepresents a gradient color stop.
LoggerRepresents a logger function.
PageDuration-
RangeAn open range.
RGBAColorRepresents an RGBA color value.
RGBColorRepresents an RGB color value.
SettingsMap of all available settings with their types. This provides type-safe access to all editor settings.
Size2-
SourceA single source width an intrinsic width & height.
SpotColorRepresents a spot color value.
TextDecorationConfigConfiguration for text decorations on a text run.
TextFontSizeOptionsOptions for text font size operations with unit support.
TextRunInfoRepresents a single contiguous text run with uniform formatting.
TransientResourceRepresents a transient resource.
TypefaceTypeface definition
Vec2-
Vec3-

Variables#

VariableDescription
ANIMATION_TYPESThe shorthand block type IDs for the animation blocks. These are the IDs used to create new animations using cesdk.engine.block.createAnimation(id).
AnimationBaselineDirectionValues-
AnimationBlockSwipeTextDirectionValues-
AnimationEasingValues-
AnimationGrowDirectionValues-
AnimationJumpLoopDirectionValues-
AnimationKenBurnsDirectionValues-
AnimationMergeTextDirectionValues-
AnimationSpinDirectionValues-
AnimationSpinLoopDirectionValues-
AnimationTypewriterTextWritingStyleValues-
AnimationWipeDirectionValues-
BlendModeValues-
BLUR_TYPESThe shorthand block type IDs for the blur blocks. These are the IDs used to create new blurs using cesdk.engine.block.createBlur(id).
CameraClampingOvershootModeValues-
CaptionHorizontalAlignmentValues-
CaptionVerticalAlignmentValues-
ColorPickerColorModeValues-
ContentFillModeValues-
ControlGizmoMoveHandleVisibilityValues-
ControlGizmoResizeHandlesVisibilityValues-
ControlGizmoRotateHandlesVisibilityValues-
ControlGizmoScaleHandlesVisibilityValues-
CutoutTypeValues-
DESIGN_BLOCK_TYPESThe shorthand block type IDs for the top-level design blocks. These are the IDs used to create new blocks using cesdk.engine.block.create(id).
DoubleClickSelectionModeValues-
EFFECT_TYPESThe shorthand block type IDs for the effect blocks. These are the IDs used to create new effects using cesdk.engine.block.createEffect(id).
FILL_TYPESThe shorthand block type IDs for the fill blocks. These are the IDs used to create new fills using cesdk.engine.block.createFill(id).
FillPixelStreamOrientationValues-
HeightModeValues-
HorizontalContentFillAlignmentValues-
LogLevelProvides a set of predefined log levels for the Creative Editor SDK.
MimeTypeRepresents the MIME types used in the editor.
PageGuidesSourceValues-
PositionXModeValues-
PositionYModeValues-
SceneDesignUnitValues-
SceneFontSizeUnitValues-
SceneLayoutValues-
SceneModeValues-
SHAPE_TYPESThe shorthand block type IDs for the shape blocks. These are the IDs used to create new shapes using cesdk.engine.block.createShape(id).
ShapeVectorPathFillRuleValues-
StrokeCapValues-
StrokeCornerGeometryValues-
StrokeDashEndCapValues-
StrokeDashStartCapValues-
StrokeEndCapValues-
StrokePositionValues-
StrokeStartCapValues-
StrokeStyleValues-
TextAnimationWritingStyleValues-
TextHorizontalAlignmentValues-
TextVerticalAlignmentValues-
TimelineTrackVisibilityValues-
TouchPinchActionValues-
TouchRotateActionValues-
VerticalContentFillAlignmentValues-
WidthModeValues-