Search Docs
Loading...
Skip to content

Package: documentation

Classes#

ClassDescription
ActionsAPIActionsAPI provides a centralized way to manage and customize actions for various user interactions in the Creative Engine SDK.
CreativeEditorSDKThe main entry point for the Creative Editor SDK.
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.
UtilsAPIUtilsAPI provides utility functions for common operations in the Creative Engine SDK.

Functions#

FunctionDescription
isGlobPatternChecks if a string is a glob pattern (contains *).
matchGlobMatches a value against a glob pattern.
useOrderContextHook for reading and setting order context for a UI area.

Type Aliases#

Type AliasDescription
ActionFunctionType helper for retrieving the correct action function type based on the action ID. Returns the strongly-typed action for known actions, or a custom action type for unknown IDs.
ActionIdAvailable action event types that can be registered with the ActionsAPI. These correspond to different UI actions that can be customized. Supports both predefined action types from the Actions interface and custom string identifiers.
AnyUILocationOptionsUnion type for location options. Resolves to the appropriate options type based on area-specific requirements.
AssetEntryIdAsset library entry IDs that can be used with asset library APIs. Includes built-in entry IDs registered by the SDK, and allows custom entry IDs.
AssetLibraryDockComponentRepresents an asset library dock component.
AssetLibraryPanelPayloadRepresents the payload for the asset library panel in the Creative Editor SDK. This interface defines the title, entries, and placement options for the asset library panel.
BuilderRenderFunctionFunction that defines a component with the help of the passed builder object.
CanvasBarComponentIdRepresents the ID of a canvas bar component.
CanvasMenuComponentIdA list of the component IDs that can be used in the canvas menu.
CanvasMenuComponents-
CanvasMenuOrderComponent-
CaptionPanelComponentIdRepresents the ID of a caption panel component.
ChildrenOrderRepresents the order of children components in a dropdown.
ClipContextMenuComponentIdRepresents the ID of a video clip menu component.
ComponentGlobPatternA glob pattern for matching component IDs.
ComponentIdRepresents the ID of a component.
ComponentIdForMaps UI areas to their component ID types.
ComponentMatcherUnified component matcher type supporting all matching strategies.
ComponentSpecSpecifies a component either by ID or as a full component object.
ComponentSpecOrArraySpecifies one or more components for insertion.
ConfigurationRepresents the user-provided configuration for the Creative Editor SDK. This type allows for partial configuration settings, making all properties optional.
CopyActionAction function for copying selected blocks to the clipboard
CustomActionFunctionA generic action function type for custom actions. Supports both synchronous and asynchronous implementations with flexible parameters.
CustomPanelMountFunctionRepresents a function that mounts a custom panel.
DeleteAssetActionAction function for deleting an asset from an asset source.
DialogActionRepresents an action in the dialog.
DialogBackdropRepresents the backdrop style for the dialog.
DialogContentRepresents the content of the dialog.
DialogProgressRepresents the progress of the dialog.
DialogSizeRepresents the size of the dialog.
DialogTypeRepresents the type of dialog.
DockOrderComponentRepresents a dock order component.
DockOrderComponentIdRepresents the ID of a dock order component.
DockPositionValid positions for the dock: 'left', 'right', or 'bottom'.
EditorCheckBrowserSupportActionAction for checking browser capabilities at editor startup. Idempotent: only runs checks once per editor lifetime.
EditorPluginContextRepresents the context for an editor plugin. This type extends the EnginePluginContext with an optional cesdk property.
ExportActionAction function for handling export operations. Can be called with or without options to customize the export behavior. Supports both standard and video export workflows through a generic type parameter. The return type is automatically inferred based on the input options type.
ExportSceneActionAction function for handling scene export operations.
FeatureIdAll built-in CE.SDK Feature Ids.
FeaturePredicateThe feature predicate is used to enable or disable a feature based on the boolean or the return value of the function.
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.
FileMimeTypeRepresents the MIME types for files supported by the file operations in UtilsAPI.
GetOrderOptionsOptions for getting component order. Only single area queries are supported to ensure type-safe returns.
GlobPatternA glob pattern string for matching UI areas or component IDs. Supports * as a wildcard.
ImportSceneActionAction function for handling scene import operations.
InferComponentTypeInfers the component type from a UI area specifier. - Single area: returns area-specific component type - Array of areas: returns union of component types - Glob pattern: returns base OrderComponent (all IDs)
InferOrderContextInfers the order context type from a UI area specifier. - Single area: returns area-specific context type - Array of areas: returns union of context types - Glob pattern: returns base OrderContext (all areas)
InsertComponentOptionsOptions for inserting a component into a UI area. Supports mutual exclusion: only one of before, after, or position can be specified. Positional areas (like canvas bar) require the at property to specify which slot.
InsertOrderComponentLocationRepresents the location for inserting an order component.
InspectorBarComponentIdRepresents the ID of an inspector bar component.
IsEnabledFeatureContextRepresents the context for determining if a feature is enabled. This type includes the CreativeEngine instance.
LoadingComponentRepresents a loading indicator component.
LoadingOrderOrder type for loading indicator components.
LocaleKeyRepresents the supported locale keys for the Creative Editor SDK.
MultiAreaRemoveResultResult of a multi-area remove operation.
MultiAreaUpdateResultResult of a multi-area update operation.
NavigationBarComponentIdA list of the component IDs that can be used in the navigation bar.
NavigationBarComponents-
NavigationBarOrderComponent-
NotificationDurationRepresents the duration of the notification.
NotificationTypeRepresents the type of notification.
OnExportOptionsThis interface extends the base ExportOptions with additional information about the export, including which design blocks were exported and the mimeType.
OnExportVideoOptionsThis interface extends the base VideoExportOptions with additional information about the export, including which design blocks were exported and the mimeType.
OnUnsupportedBrowserActionAction function that is invoked when an unsupported browser is detected. This allows custom handling of unsupported browser scenarios.
OptionalTurn value at K of T into a Partial
OrderComponentForMaps UI areas to their order component types.
OrderComponentMatcherRepresents a matcher for order components.
OrderContextForMaps a UI area to its appropriate order context type for public API usage. - Caption panel uses CaptionPanelOrderContext (adds view property) - Video clip menu uses VideoClipMenuOrderContext (adds clipType) - All other areas use OrderContext (editMode only)
PageAssetReferenceReference to a page preset from an asset source.
PageDimensionsDirect page dimensions specification.
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.
PageResizePanelPayloadRepresents the payload for the page resize panel in the Creative Editor SDK.
PageSpecA page can be specified as direct dimensions, an asset source reference, or an asset object (e.g., from engine.asset.fetchAsset()). All variants optionally accept a color to set the page fill color.
PanelDisposerRepresents a function that disposes of a panel.
PanelIdRepresents a unique identifier for a panel in the Creative Editor SDK. This type defines specific panel IDs and allows for custom panel IDs.
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.
PanelPayloadRepresents the payload for a panel in the Creative Editor SDK. This type defines the payload based on the panel ID.
PanelPositionThis type is used to specify the position of various panels within the user interface, such as the inspector, settings, and asset library panels.
PasteActionAction function for pasting blocks from the clipboard
PositionalUIAreaUI areas where at is required to specify a slot.
PositionForMaps positional UI areas to their valid at values.
PreviewTypeRepresents a preview, which can be either an image or a color.
PreviewTypeColorRepresents a color preview.
PreviewTypeImageRepresents an image preview.
SaveSceneActionAction function for handling scene saving operations.
SceneCreateActionAction for creating a new scene with configurable mode and page sizes. Returns the scene block ID.
SceneCreateOptionsOptions for creating a new scene.
ScrollToBlockActionAction function for scrolling to a specific block
ScrollToPageActionAction function for scrolling to a specific page
SetOrderOptionsOptions for setting component order. Single area only for type safety with area-specific component types.
ShareSceneActionAction function for handling scene sharing operations.
SuffixRepresents additional options for a button, which can be used as a suffix.
TimelineCollapseActionAction function for collapsing the video timeline.
TimelineExpandActionAction function for expanding the video timeline.
TimelineZoomInActionAction function for zooming in the video timeline by one step.
TimelineZoomOutActionAction function for zooming out the video timeline by one step.
TimelineZoomResetActionAction function for resetting the video timeline zoom to default level (1.0).
TimelineZoomToFitActionAction function for fitting the video timeline to show all content.
TimelineZoomToLevelActionAction function for setting the video timeline zoom to a specific level.
UIAreaRepresents a UI area where components can be ordered.
UIAreaContextUI area-specific context - excludes base OrderContext properties (like editMode) that are read-only and derived from the engine.
UIAreaSpecifierSpecifies which UI area(s) to target. Can be a single area, an array of areas, or a glob pattern.
UnknownPanelPayloadRepresents an unknown payload for a panel in the Creative Editor SDK. This type defines a generic payload with unknown keys and values.
UnknownTranslationsAllows for custom translation keys beyond the built-in ones.
UnsupportedCapabilityBehaviorBehavior for a browser capability check at editor startup. - 'block': Show a blocking error dialog (no dismiss) - 'warn': Show a dismissible warning dialog - 'ignore': Skip the check entirely
UpdateSpecSpecifies an update either as a new ID, partial update, or updater function.
UploadActionAction function for uploading files to asset sources.
VideoClipTypeThe type of clip in the video timeline. - 'clip' — clips on the main (background) track - 'overlay' — clips on overlay tracks above the main track - 'caption' — caption clips
VideoDecodeCheckSupportActionAction function for checking video decoding/playback support. Returns true if WebCodecs APIs are available for video decoding and playback. Shows a blocking error dialog if not supported (unless dialog is disabled).
VideoEncodeCheckSupportActionAction function for checking video encoding/export support. Returns true if H.264 video encoding and AAC audio encoding are supported. Shows a warning dialog if not supported (unless dialog is disabled).
VideoSupportDialogOptionsDialog display options for video support check actions. Allows configuring whether and how the dialog is displayed.
ViewStyleRepresents the view style options in the Creative Editor SDK. This type defines the possible view styles, which are ‘advanced’ and ‘default’.
ZoomInActionAction function for zooming in by one step
ZoomOutActionAction function for zooming out by one step
ZoomToBlockActionAction function for zooming to a specific block
ZoomToLevelActionAction function for setting zoom to a specific level
ZoomToPageActionAction function for zooming to a page with optional padding
ZoomToSelectionActionAction function for zooming to the current selection

Interfaces#

InterfaceDescription
AssetLibraryEntryRepresents an entry in the asset library, combining data and view configurations.
BaseInsertOptionsOptions for inserting components into a UI area.
BasePositionalInsertOptionsOptions for inserting components into a positional UI area (e.g., canvas bar).
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.
BuiltinTranslationsBuilt-in translation keys provided by the Creative Editor SDK.
ButtonGroupOptionsRepresents options for a button group.
ButtonOptionsRepresents options for a button.
CanvasBarLocationOptionsLocation options specifically for the canvas bar, which requires a position.
CanvasMenuActionButtonBase interface for action buttons in the canvas menu. Contains common properties shared across all canvas menu button types.
CanvasMenuCustomActionButtonInterface representing a custom canvas menu action button. Note: This component requires a key and has a required label, unlike other action buttons.
CanvasMenuOptionsComponentInterface representing the canvas menu options dropdown component. This component can contain children components that are rendered in a dropdown menu.
CaptionPanelOrderContextContext for the caption panel which adds view-based filtering.
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.
CheckboxOptionsRepresents options for a checkbox.
ClipContextMenuCustomActionInterface representing a generic custom action in the clip context menu. Requires a key to uniquely identify the action and a label for display.
ColorInputOptionsRepresents options for a color input.
ComponentMatchOptionsOptions for update and remove operations. Supports multi-area operations via arrays or glob patterns.
ComponentOptionsRepresents options for a component.
ComponentPayloadRepresents the payload of a component.
CustomDockComponentRepresents a custom dock component.
DialogRepresents a dialog configuration.
DockLocationOptionsLocation options specifically for the dock, which supports an optional position.
DropdownChildrenContextRepresents the context for the children of a dropdown.
DropdownOptionsRepresents options for a dropdown.
EditorPluginRepresents an editor plugin. This interface defines the structure of an editor plugin, including its name, version, and initialization function.
ExportOptionsSpecifies options for exporting design blocks to various formats.
HeadingOptionsRepresents options for a heading.
InputOptionsRepresents options for an input.
InsertAfterOptionsInsert after a matched component.
InsertAppendOptionsAppend to end (default behavior).
InsertAtPositionOptionsInsert at a specific position.
InsertBeforeOptionsInsert before a matched component.
InsertResultResult of an insert operation.
LibraryOptionsRepresents options for a library.
MediaPreviewOptionsRepresents options for a media preview.
NavigationBarActionButtonBase interface for action buttons in the navigation bar. Contains common properties shared across all action button types.
NavigationBarCustomActionButtonInterface representing a generic Action Button in the navigation bar component. Note: This component requires a key and has a required label, unlike other action buttons.
NotificationRepresents a notification configuration.
NumberInputOptionsRepresents options for a number input.
OrderComponentRepresents an order component.
OrderComponentWithChildrenRepresents a custom dock component.
OrderContextContext for ordering components. Contains editMode which is used by most UI areas.
PositionalInsertAfterOptionsInsert after a matched component (positional areas).
PositionalInsertAppendOptionsAppend to end (positional areas).
PositionalInsertAtPositionOptionsInsert at a specific position (positional areas).
PositionalInsertBeforeOptionsInsert before a matched component (positional areas).
RegisteredActionsRepresents a collection of action functions used throughout the application. Each property corresponds to a specific UI action or event that can be customized.
RemoveResultResult of a remove operation on a single area.
ReplaceAssetLibraryEntriesContextProvides context for replacing asset library entries, including selected blocks and default entry IDs.
SectionOptionsRepresents options for a section.
SelectOptionsOptions for a select input.
SelectValueRepresents a value for a select input.
SliderOptionsRepresents options for a slider.
SpinnerOptionsRepresents options for a loading spinner.
TextAreaOptionsRepresents options for a text area.
TextInputOptionsRepresents options for a text input.
TextOptionsRepresents options for text.
TranslationsComplete translation type that includes both built-in and custom translations.
UILocationOptionsLocation options for non-positional UI areas.
UpdateResultResult of an update operation on a single area.
UserInterfaceSpecifies the configuration for the user interface of the Creative Editor SDK.
VideoClipMenuOrderContextContext for the clip context menu which adds clip type filtering.

Namespaces#

NamespaceDescription
ConfigTypes-
ExperimentalBuilderNamespace containing experimental features for the builder. These features are subject to change and may not be stable for production use.
ExperimentalUserInterfaceAPIProvides experimental methods for controlling the UI of the Creative Editor SDK.
UserInterfaceElements-

Variables#

VariableDescription
AddImageOptions-
PanelPosition-