Search
Loading...
Skip to content

Package: @cesdk/cesdk-js

Classes#

ClassDescription
FeatureAPIControls the availability of features within the Creative Editor SDK.
InternationalizationAPIManages localization and internationalization settings for the Creative Editor SDK.
UserInterfaceAPIControl the user interface and behavior of the Creative Editor SDK.
CreativeEditorSDKThe main entry point for the Creative Editor SDK.
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.
EventAPISubscribe to block lifecycle events in the design engine.
SceneAPICreate, load, save, and manipulate scenes.
VariableAPIManage text variables within design templates.

Functions#

FunctionDescription
supportsBrowserChecks if the current browser supports necessary technologies to match our supported browsers
checkVideoSupportThrows an error if the current browser does not support video editing.
supportsVideoChecks if the current browser supports video editing.
checkVideoExportSupportThrows an error if the current browser does not support video exporting.
supportsVideoExportChecks if the current browser supports video exporting.
supportsWasmChecks if the current browser supports web assembly

Type Aliases#

Type AliasDescription
FeatureIdAll built-in CE.SDK Feature Ids.
ConfigurationRepresents the user-provided configuration for the Creative Editor SDK. This type allows for partial configuration settings, making all properties optional.
PageFormatDefinitionRepresents the definition of a page format in the Creative Editor SDK. This interface defines the width, height, unit, and optional fixed orientation for a page format.
DockOrderComponentIdRepresents the ID of a dock order component.
CanvasMenuComponentIdRepresents the ID of a canvas menu component.
NavigationBarComponentIdRepresents the ID of a navigation bar component.
CanvasBarComponentIdRepresents the ID of a canvas bar component.
InspectorBarComponentIdRepresents the ID of an inspector bar component.
ComponentIdRepresents the ID of a component.
AssetLibraryDockComponentRepresents an asset library dock component.
DockOrderComponentRepresents a dock order component.
DialogTypeRepresents the type of dialog.
DialogSizeRepresents the size of the dialog.
DialogContentRepresents the content of the dialog.
DialogActionRepresents an action in the dialog.
DialogProgressRepresents the progress of the dialog.
NotificationTypeRepresents the type of notification.
NotificationDurationRepresents the duration of the notification.
PanelIdRepresents a unique identifier for a panel in the Creative Editor SDK. This type defines specific panel IDs and allows for custom panel IDs.
AssetLibraryPanelPayloadRepresents the payload for the asset library panel in the Creative Editor SDK. This interface defines the title and entries for the asset library panel.
UnknownPanelPayloadRepresents an unknown payload for a panel in the Creative Editor SDK. This type defines a generic payload with unknown keys and values.
PanelPayloadRepresents the payload for a panel in the Creative Editor SDK. This type defines the payload based on the panel ID.
PanelOptionsRepresents the options for a panel in the Creative Editor SDK. This interface defines the options for a panel, including whether it is closable by the user, its position, whether it is floating, and its payload.
OptionalTurn value at K of T into a Partial
EditorPluginContextRepresents the context for an editor plugin. This type extends the EnginePluginContext with an optional cesdk property.
IsEnabledFeatureContextRepresents the context for determining if a feature is enabled. This type includes the CreativeEngine instance.
FeaturePredicateContextRepresents the context for enabling a feature. This type extends IsEnabledFeatureContext and includes a function to check the previous enable state and a function to get the default predicate.
FeaturePredicateThe feature predicate is used to enable or disable a feature based on the boolean or the return value of the function.
PanelDisposerRepresents a function that disposes of a panel.
CustomPanelMountFunctionRepresents a function that mounts a custom panel.
InsertOrderComponentLocationRepresents the location for inserting an order component.
SuffixRepresents additional options for a button, which can be used as a suffix.
ChildrenOrderRepresents the order of children components in a dropdown.
PreviewTypeImageRepresents an image preview.
PreviewTypeColorRepresents a color preview.
PreviewTypeRepresents a preview, which can be either an image or a color.
BuilderRenderFunctionFunction that defines a component with the help of the passed builder object.
HorizontalBlockAlignmentRepresents the horizontal alignment of blocks.
VerticalBlockAlignmentRepresents the vertical alignment of blocks.
PositionModeRepresents the mode for positioning blocks.
SizeModeRepresents the mode for sizing blocks.
ContentFillModeRepresents the mode for filling content within a block.
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.
StrokePositionRepresents the position of a stroke relative to the shape’s boundary.
StrokeStyleRepresents the style of a stroke.
StrokeCornerGeometryRepresents the corner geometry of a stroke.
BlendModeRepresents the blend mode of a layer or effect.
TextCaseRepresents the text case of a text block.
BooleanOperationRepresents the names of boolean operations.
EngineExportOptionsRepresents the options for exporting a design block.
VideoExportOptionsRepresents the options for exporting a video.
AudioExportOptionsRepresents the options for exporting audio.
DropShadowOptionsOptions for configuring drop shadow effects on blocks.
AnimationEntryConfiguration options for animations.
AnimationOptionsOptions for configuring animations (in, loop, out animations).
AddImageOptionsOptions for adding images to the scene.
SettingTypeRepresents the type of a setting.
SettingsBoolRepresents the boolean settings available in the editor.
SettingsStringRepresents the string settings available in the editor.
SettingsFloatRepresents the float settings available in the editor.
SettingsColorRepresents the color settings available in the editor.
SettingsColorRGBARepresents the color settings available in the editor.
SettingsEnumRepresents the enum settings available in the editor.
ZoomOptionsOptions for zooming to a block with optional animation.
CreateSceneOptionsOptions for creating a video scene.
DefaultAssetSourceIdRepresents the default asset source IDs used in the editor.
DemoAssetSourceIdRepresents the default demo asset source IDs used in the editor.
TypefaceDefinitionRepresents a typeface definition used in the editor.
EnginePluginContextRepresents the context for an engine plugin.
LogLevelProvides logging functionality for the Creative Editor SDK.
MimeTypeRepresents the MIME types used in the editor.
ImageMimeTypeRepresents the image MIME types used in the editor.
AudioMimeTypeRepresents the audio MIME types used in the editor.
VideoMimeTypeRepresents the video MIME types used in the editor.
ApplicationMimeTypeRepresents the application MIME types used in the editor.
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.
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.
AssetMetaDataGeneric asset information
AssetColorAsset Color payload
AssetTransformPresetTransform preset payload
AssetPropertyAsset property for payload
DesignBlockTypeShorthandThe 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).
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).
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.
ShapeTypeShorthandThe shorthand block type IDs for the shape blocks. These are the IDs used to create new shapes using cesdk.engine.block.createShape(id).
ShapeTypeLonghandThe longhand block type IDs for the blocks. These are the IDs used to create new shapes using cesdk.engine.block.createShape(id).
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.
FillTypeShorthandThe shorthand block type IDs for the fill blocks. These are the IDs used to create new fills using cesdk.engine.block.createFill(id).
FillTypeLonghandThe longhand block type IDs for the fill blocks. These are the IDs used to create new fills using cesdk.engine.block.createFill(id).
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.
EffectTypeShorthandThe shorthand block type IDs for the effect blocks. These are the IDs used to create new effects using cesdk.engine.block.createEffect(id).
EffectTypeLonghandThe longhand block type IDs for the effect blocks. These are the IDs used to create new effects using cesdk.engine.block.createEffect(id).
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.
BlurTypeShorthandThe shorthand block type IDs for the blur blocks. These are the IDs used to create new blurs using cesdk.engine.block.createBlur(id).
BlurTypeLonghandThe longhand block type IDs for the blur blocks. These are the IDs used to create new blurs using cesdk.engine.block.createBlur(id).
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.
AnimationTypeShorthandThe shorthand block type IDs for the animation blocks. These are the IDs used to create new animations using cesdk.engine.block.createAnimation(id).
AnimationTypeLonghandThe longhand block type IDs for the animation blocks. These are the IDs used to create new animations using cesdk.engine.block.createAnimation(id).
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.
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.
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.
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.
OffscreenCanvasA simplified placeholder type for OffscreenCanvas, to avoid a dependency on @types/offscreencanvas
CanvasAn HTML Canvas or an Offscreen Canvas
HexColorStringRepresents a hexadecimal color value (RGB or RGBA) that starts with a ’#’.
PaletteColorRepresents a color definition for the custom color palette.
ColorSpaceRepresents the color space used in the editor.
CutoutTypeRepresents the type of a cutout.
CutoutOperationRepresents the operation performed on a cutout.
DesignBlockIdA numerical identifier for a design block
HistoryIdA numerical identifier for a history stack
SceneLayoutThe scene layout determines how the layout stack should layout its pages.
AnimationEasingThe easing options for the camera animation.
SceneModeThe mode of the scene defines how the editor and playback should behave.
ZoomAutoFitAxisThe axis(es) for which to auto-fit.
DesignUnitThe unit type in which the page values (size, distances, etc.) are defined.
EditModeRepresents the current edit mode of the editor.
FontWeightRepresents the weight of a font.
FontStyleRepresents the style of a font.
RoleStringRepresents a role string.
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.
RGBARepresents a color in the RGBA color space.
CMYKRepresents a color in the CMYK color space.
XYWHDescribes a rectangle on the screen.
GradientstopRGBARepresents a gradient stop in the RGBA color space.
BlockStateRepresents the state of a design block.

Enumerations#

EnumerationDescription
ViewStyleRepresents the view style options in the Creative Editor SDK. This enum defines the possible view styles, which are ‘advanced’ and ‘default’.
PanelPositionThis enum is used to specify the position of various panels within the user interface, such as the inspector, settings, and asset library panels.

Interfaces#

InterfaceDescription
CESDKConfigurationRepresents the configuration settings for the Creative Editor SDK. This interface defines various settings such as locale, theme, development mode, user interface, internationalization, accessibility, callbacks, feature flags, and logger.
AssetLibraryEntryRepresents an entry in the asset library, combining data and view configurations.
ReplaceAssetLibraryEntriesContextProvides context for replacing asset library entries, including selected blocks and default entry IDs.
UserInterfaceSpecifies the configuration for the user interface of the Creative Editor SDK.
ComponentPayloadRepresents the payload of a component.
OrderComponentRepresents an order component.
CustomDockComponentRepresents a custom dock component.
ExportOptionsSpecifies options for exporting design blocks to various formats.
DialogRepresents a dialog configuration.
NotificationRepresents a notification configuration.
EditorPluginRepresents an editor plugin. This interface defines the structure of an editor plugin, including its name, version, and initialization function.
TranslationsRepresents a set of translations for the Creative Editor SDK.
OrderContextInterface representing the context for ordering components.
ComponentOptionsRepresents options for a component.
ButtonOptionsRepresents options for a button.
ButtonGroupOptionsRepresents options for a button group.
CheckboxOptionsRepresents options for a checkbox.
SelectValueRepresents a value for a select input.
SelectOptionsRepresents options for a select input.
DropdownChildrenContextRepresents the context for the children of a dropdown.
DropdownOptionsRepresents options for a dropdown.
MediaPreviewOptionsRepresents options for a media preview.
InputOptionsRepresents options for an input.
TextAreaOptionsRepresents options for a text area.
TextInputOptionsRepresents options for a text input.
NumberInputOptionsRepresents options for a number input.
ColorInputOptionsRepresents options for a color input.
SliderOptionsRepresents options for a slider.
LibraryOptionsRepresents options for a library.
SectionOptionsRepresents options for a section.
TextOptionsRepresents options for text.
HeadingOptionsRepresents options for a heading.
BuilderInterface for all available builder. Depending on the context different implementation might be used. A “Button” in the canvas menu might render different component than a button in the topbar or a panel.
BuilderRenderFunctionContextRepresents the context for rendering a builder function.
AddVideoOptionsOptions for adding videos to the scene.
HTMLCreativeEngineCanvasElementA wrapper around a plain canvas
_EngineConfigurationSpecifies the configuration for the Creative Editor SDK.
EnginePluginRepresents an engine plugin.
LoggerRepresents a logger function.
SourceA single source width an intrinsic width & height.
AssetRGBColorAsset Color payload RGB representation
AssetCMYKColorAsset Color payload CMYK representation
AssetSpotColorAsset Color payload SpotColor representation
AssetFixedAspectRatioAsset transform preset payload fixed aspect ratio
AssetFreeAspectRatioAsset transform preset payload free aspect ratio
AssetFixedSizeAsset transform preset payload fixed size
AssetStringPropertyAsset string property definition
AssetNumberPropertyAsset number property definition
AssetBooleanPropertyAsset boolean property definition
AssetEnumPropertyAsset enum property definition
AssetColorPropertyAsset color property definition
AssetPayloadAsset payload
AssetGeneric asset information
AssetDefinitionDefinition of an asset used if an asset is added to an asset source.
AssetResultSingle asset result of a query from the engine.
CompleteAssetResultAsset results that are returned from the engine.
AssetQueryDataDefines a request for querying assets
AssetsQueryResultReturn type of a findAssets query.
AssetSourceA source of assets
RGBColorRepresents an RGB color value.
RGBAColorRepresents an RGBA color value.
CMYKColorRepresents a CMYK color value.
SpotColorRepresents a spot color value.
GradientColorStopRepresents a gradient color stop.
RangeAn open range.
FontRepresents a font.
TypefaceRepresents a typeface.
BufferRepresents a buffer of data.
TransientResourceRepresents a transient resource.
BlockEventRepresents an event related to a design block.

Namespaces#

NamespaceDescription
ConfigTypesDefines the configuration settings for the Creative Editor SDK.
CESDKConfigurationNamespace for CESDKConfiguration to include deprecated keys. This namespace includes deprecated keys that are part of the public API via the CombinedConfiguration type. These keys are used in the ConfigMigrations but are not used internally.
UserInterfaceElementsDefines the configuration for user interface elements, including panels, dock, libraries, blocks, navigation, and inspector bar.
ExperimentalUserInterfaceAPIProvides experimental methods for controlling the UI of the Creative Editor SDK.
ExperimentalBuilderNamespace containing experimental features for the builder. These features are subject to change and may not be stable for production use.

Variables#

VariableDescription
LogLevelProvides a set of predefined log levels for the Creative Editor SDK.
MimeTypeRepresents the MIME types used in the editor.