@imgly/codesign-mcp 0.1.7 → 0.1.9-next.20260720172141.gfa485d7

package/README.md

@@ -1,8 +1,10 @@
 # @imgly/codesign-mcp
 
 MCP server exposing a CE.SDK CreativeEngine for vector design + print-quality
-PDF output. Ships skills (Iris design loop, cesdk-api signatures, cesdk-guide
-docs), tools (`design_exec`, `design_capture`), and prompts as MCP resources.
+PDF output. Ships a single `skill` tool (read + search over an embedded
+handbook / api / guide catalog), per-skill MCP prompts surfaced as slash
+commands, and the design/workspace tools (`edit`, `preview`, `export`,
+`list`, `history`, …).
 
 ## Install
 
@@ -23,6 +25,16 @@ for the exact per-host snippets — all spawn
 Set `CESDK_LICENSE` in the server's `env` to use your own CE.SDK node license;
 during the internal beta a 30-day trial is bundled, so it's optional.
 
+### Development builds (`@next`)
+
+The newest not-yet-released build is continuously published under the `next`
+dist-tag. It may be less stable than a release, but it's the fastest way to try
+what's coming:
+
+```bash
+claude mcp add codesign-next -- npx -y @imgly/codesign-mcp@next stdio
+```
+
 ### Offline / air-gapped install
 
 Fetch the published package as a self-contained tarball on a connected machine,
@@ -135,6 +147,28 @@ sessions over `max-sessions` get `503 Service Unavailable` with `Retry-After: 30
 
 Stdio mode uses a single engine for the lifetime of the process.
 
+### Long-running exports (video)
+
+Video is **opt-in**: set `IMGLY_FEATURE_VIDEO=on` to enable video export,
+video/audio import, and the handbook's video guidance (all hidden by default
+while cross-platform video encoding stabilizes). With the flag on and no
+explicit `IMGLY_CESDK_ENGINE`, the server picks the native engine
+automatically — video cannot encode on the WASM engine.
+
+Video export holds the engine for the whole encode and can run for minutes.
+The server reports MCP progress while encoding:
+
+- **Claude Code** shows the progress and keeps the call alive — progress
+  resets its idle timeout (30 min on stdio by default), so no configuration
+  is needed.
+- **Codex CLI** kills tool calls after **300 s** regardless of progress.
+  Raise the per-server timeout in `config.toml` before exporting video:
+
+  ```toml
+  [mcp_servers.codesign]
+  tool_timeout_sec = 1800
+  ```
+
 ## Embedding
 
 The HTTP server is also exposed as a programmatic factory for callers that

package/assets/docs/api/SKILL.md

@@ -1,14 +1,15 @@
 ---
 name: api
 description: |
-  Authoritative TypeScript signatures for the CE.SDK CreativeEngine. Use this skill
-  whenever you need the exact signature, parameter types, or return type of an
-  `engine.*` method — especially before calling a method you haven't used in the
-  current scene, or when the markdown docs in `cesdk-guide` are ambiguous.
+  Authoritative TypeScript signatures for the CE.SDK CreativeEngine. Use this
+  skill whenever you need the exact signature, parameter types, or return type
+  of an `engine.*` method — especially before calling a method you haven't
+  used yet. This is THE source of truth for signatures: the `.d.ts` it wraps
+  ships with the same `@cesdk/node` package the engine runs, while prose docs
+  (the `guide` skill) can drift.
 
-  This is THE source of truth for method signatures. The hand-written cheatsheets
-  in SYSTEM.md and the markdown docs in `cesdk-guide` can drift; this `.d.ts`
-  ships with the same `@cesdk/node` package the engine runs.
+  The entry document is an overview; pass path: "index.d.ts" for the full
+  type definition file (~9000 lines) and slice it with offset/limit.
 
   Triggered when you need to verify an `engine.block.*` or `engine.scene.*`
   signature, look up a parameter type, or confirm an enum/string-property name.
@@ -17,26 +18,27 @@ description: |
 ## Single file: `index.d.ts`
 
 The whole CE.SDK TypeScript surface is in `index.d.ts` (~9000 lines). Use
-`read --offset --limit` to fetch the slice you need; never read the whole file.
+`path: "index.d.ts"` with `offset`/`limit` to fetch the slice you need; never
+read the whole file.
 
 ## Line anchors
 
-The most-used classes are at known line offsets. Pass these directly to `read`:
+The most-used classes are at known line offsets. Pass these directly:
 
-| Class        | Start line | Read example                                      |
-| ------------ | ---------- | ------------------------------------------------- |
-| AssetAPI     | 260        | `read path=… offset=260  limit=200`               |
-| **BlockAPI** | **1421**   | `read path=… offset=1421 limit=400` (largest API) |
-| EditorAPI    | 6300       | `read path=… offset=6300 limit=300`               |
-| EventAPI     | 7382       | `read path=… offset=7382 limit=200`               |
-| **SceneAPI** | **8114**   | `read path=… offset=8114 limit=300`               |
-| VariableAPI  | 9531       | `read path=… offset=9531 limit=100`               |
+| Class        | Start line | Read example                           |
+| ------------ | ---------- | -------------------------------------- |
+| AssetAPI     | 260        | `offset=260, limit=200`                |
+| **BlockAPI** | **1421**   | `offset=1421, limit=400` (largest API) |
+| EditorAPI    | 6300       | `offset=6300, limit=300`               |
+| EventAPI     | 7382       | `offset=7382, limit=200`               |
+| **SceneAPI** | **8114**   | `offset=8114, limit=300`               |
+| VariableAPI  | 9531       | `offset=9531, limit=100`               |
 
 ## How to look up a method
 
 1. Identify which class owns it (e.g. `engine.block.setFont` → BlockAPI).
-2. `grep pattern="setFont\\(" path="**/skills/cesdk-api/index.d.ts" maxResults=5`
-3. `read path=… offset=<grep-line - 5> limit=30` to get the JSDoc + signature.
+2. `skill({ name: 'api', query: 'setFont(' })` — matches come back as `index.d.ts:<line>: …`.
+3. `skill({ name: 'api', path: 'index.d.ts', offset: <match-line - 5>, limit: 30 })` to get the JSDoc + signature.
 
 The JSDoc above each method tells you the canonical usage and lists `@param`
 types. When a method has multiple overloads, prefer the one without
@@ -44,6 +46,6 @@ types. When a method has multiple overloads, prefer the one without
 
 ## When to NOT use this skill
 
-- Reading conceptual prose ("how does XYZ work") → use `cesdk-guide` instead.
-- General topic guides (text, fills, export, rules) → `cesdk-guide`.
-- This skill is signatures only — use `cesdk-guide` for everything else.
+- Reading conceptual prose ("how does XYZ work") → use the `guide` skill instead.
+- General topic guides (text, fills, export, rules) → use the `guide` skill instead.
+- This skill is signatures only — use the `guide` skill for everything else.

package/assets/docs/api/index.d.ts

@@ -893,6 +893,28 @@ export declare interface AssetEnumProperty {
     options: string[];
 }
 
+/**
+ * Property paths that can be faceted — the facetable subset of
+ * `AssetPropertyPath`. `label` and `id` are excluded because their
+ * cardinality is unbounded.
+ * @public
+ */
+export declare type AssetFacetPath = 'tags' | 'groups' | `meta.${string}`;
+
+/**
+ * One bucket of a facet distribution.
+ * @public
+ */
+export declare interface AssetFacetValue {
+    /** Raw value exactly as stored on the assets (no casing or locale normalization). */
+    value: string;
+    /**
+     * Number of matched assets carrying this value. Always set by local
+     * sources; custom sources may omit it when counting is expensive.
+     */
+    count?: number;
+}
+
 /**
  * Filter expression — predicate or logical combinator. Combinators nest
  * arbitrarily. The union is mutually exclusive: an object with both
@@ -1037,10 +1059,10 @@ export declare type AssetProperty = AssetBooleanProperty | AssetColorProperty |
  * 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, compared whole.
  *
- * `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.
+ * If a meta value was originally serialized as a number or boolean,
+ * stringify it the same way before comparing.
  * @public
  */
 export declare type AssetPropertyFilter = {
@@ -1055,8 +1077,7 @@ export declare type AssetPropertyFilter = {
 
 /**
  * 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).
+ * `label`, `id`, `tags`, `groups`, or `meta.<key>` (one segment).
  *
  * The template literal accepts `'meta.'` (empty key) because TypeScript's
  * `${string}` includes the empty string; the engine rejects this at
@@ -1139,6 +1160,13 @@ export declare interface AssetQueryData {
      * ```
      */
     filter?: AssetFilter[];
+    /**
+     * Facet distributions to compute over the matched (pre-pagination) set,
+     * e.g. to populate filter dropdowns. Local sources compute facets
+     * automatically; custom sources may fulfill any subset of the request.
+     * Combine with `perPage: 0` to enumerate values without fetching assets.
+     */
+    facets?: AssetFacetPath[];
 }
 
 /**
@@ -1300,6 +1328,16 @@ export declare interface AssetsQueryResult<T extends AssetResult = AssetResult>
     nextPage?: number;
     /** How many assets are there in total for the current query regardless of the page */
     total: number;
+    /**
+     * Distributions for the requested facet paths, keyed by the exact
+     * requested path string. Ordered by count descending, ties by value
+     * ascending. A missing key signals the
+     * source did not compute that facet. Absent entirely when no facets
+     * were requested or none were computed.
+     */
+    facets?: {
+        [path: string]: AssetFacetValue[];
+    };
 }
 
 /**
@@ -6271,6 +6309,62 @@ export declare class BlockAPI {
      * @returns The "out" animation of the block.
      */
     getOutAnimation(id: DesignBlockId): DesignBlockId;
+    /**
+     * Creates a new transition block.
+     *
+     * The created block is standalone until assigned to a clip with `setTransition`.
+     * Once assigned, it is owned by that clip: it is destroyed together with the
+     * clip, and the engine also destroys it automatically when the two clips stop
+     * being timeline-adjacent on the track (e.g. after a manual gap is introduced).
+     *
+     * @category Block Transitions
+     * @param type - The type of transition to create.
+     * @returns The handle of the new transition instance.
+     */
+    createTransition(type: TransitionType): DesignBlockId;
+    /**
+     * Checks whether a clip can own an outgoing clip-to-clip transition.
+     *
+     * Only leaf clips inside a video track qualify. Audio, group, caption, and
+     * cutout blocks — as well as blocks outside a video track — report `false`.
+     *
+     * @category Block Transitions
+     * @param id - The clip block to check.
+     * @returns Whether the block can own an outgoing transition.
+     */
+    supportsTransition(id: DesignBlockId): boolean;
+    /**
+     * Assigns the outgoing transition of a clip.
+     *
+     * A previously assigned transition block is detached but not destroyed
+     * automatically. Throws an error if the given transition block is invalid or
+     * already assigned to another clip. Both the clip and its following clip on
+     * the track must support transitions, see `supportsTransition`. To clear a
+     * clip's transition, use `removeTransition` instead.
+     *
+     * @category Block Transitions
+     * @param id - The outgoing clip that owns the transition relation.
+     * @param transition - The transition block to assign.
+     */
+    setTransition(id: DesignBlockId, transition: DesignBlockId): void;
+    /**
+     * Removes the outgoing transition of a clip.
+     *
+     * The removed transition block is detached but not destroyed automatically.
+     * Removing from a clip without an assigned transition is a no-op.
+     *
+     * @category Block Transitions
+     * @param id - The outgoing clip whose transition relation should be cleared.
+     */
+    removeTransition(id: DesignBlockId): void;
+    /**
+     * Gets the outgoing transition assigned to a clip.
+     *
+     * @category Block Transitions
+     * @param id - The outgoing clip whose transition relation should be queried.
+     * @returns The assigned transition block, or an invalid block if unset.
+     */
+    getTransition(id: DesignBlockId): DesignBlockId;
     /**
      * Updates a pixel stream fill block with a new pixel buffer.
      *
@@ -6556,7 +6650,7 @@ export declare type BlurTypeShorthand = (typeof BLUR_TYPES)[number];
 export declare type BooleanOperation = 'Difference' | 'Intersection' | 'Union' | 'XOR';
 
 /** @public */
-export declare type BoolPropertyName = 'alwaysOnBottom' | 'alwaysOnTop' | 'clipped' | 'flip/horizontal' | 'flip/vertical' | 'highlightEnabled' | 'includedInExport' | 'placeholder/enabled' | 'playback/playing' | 'playback/soloPlaybackEnabled' | 'scene/aspectRatioLock' | 'scene/extendedPanningArea' | 'selected' | 'selectionEnabled' | 'transformLocked' | 'visible' | 'blur/enabled' | 'dropShadow/clip' | 'dropShadow/enabled' | 'fill/enabled' | 'fill/overprint' | 'page/guides/gridEnabled' | 'page/guides/gridSnapEnabled' | 'page/marginEnabled' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'playback/looping' | 'playback/muted' | 'stroke/enabled' | 'stroke/overprint' | 'backgroundColor/enabled' | 'placeholderBehavior/enabled' | 'text/automaticFontSizeEnabled' | 'text/clipLinesOutsideOfFrame' | 'text/hasClippedLines' | 'text/pathFlipped' | 'text/useContextualLigatures' | 'text/useDiscretionaryLigatures' | 'text/useKerning' | 'text/useLigatures' | 'track/automaticallyManageBlockOffsets' | 'caption/automaticFontSizeEnabled' | 'caption/clipLinesOutsideOfFrame' | 'caption/hasClippedLines' | 'caption/pathFlipped' | 'caption/useContextualLigatures' | 'caption/useDiscretionaryLigatures' | 'caption/useKerning' | 'caption/useLigatures' | 'captionTrack/automaticallyManageBlockOffsets' | 'animation/slide/fade' | 'animation/pan/fade' | 'animation/blur/fade' | 'animation/zoom/fade' | 'animation/crop_zoom/fade' | 'animation/spin/fade' | 'animation/block_swipe_text/useTextColor' | 'animation/spread_text/fade' | 'animation/ken_burns/fade' | 'effect/enabled' | (string & {});
+export declare type BoolPropertyName = 'alwaysOnBottom' | 'alwaysOnTop' | 'clipped' | 'flip/horizontal' | 'flip/vertical' | 'highlightEnabled' | 'includedInExport' | 'placeholder/enabled' | 'playback/playing' | 'playback/soloPlaybackEnabled' | 'scene/aspectRatioLock' | 'scene/extendedPanningArea' | 'selected' | 'selectionEnabled' | 'transformLocked' | 'visible' | 'blur/enabled' | 'dropShadow/clip' | 'dropShadow/enabled' | 'fill/enabled' | 'fill/overprint' | 'page/guides/gridEnabled' | 'page/guides/gridSnapEnabled' | 'page/marginEnabled' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'playback/looping' | 'playback/muted' | 'stroke/enabled' | 'stroke/overprint' | 'backgroundColor/enabled' | 'placeholderBehavior/enabled' | 'text/automaticFontSizeEnabled' | 'text/clipLinesOutsideOfFrame' | 'text/hasClippedLines' | 'text/pathFlipped' | 'text/useContextualAlternates' | 'text/useContextualLigatures' | 'text/useDiscretionaryLigatures' | 'text/useKerning' | 'text/useLigatures' | 'track/automaticallyManageBlockOffsets' | 'caption/automaticFontSizeEnabled' | 'caption/clipLinesOutsideOfFrame' | 'caption/hasClippedLines' | 'caption/pathFlipped' | 'caption/useContextualAlternates' | 'caption/useContextualLigatures' | 'caption/useDiscretionaryLigatures' | 'caption/useKerning' | 'caption/useLigatures' | 'captionTrack/automaticallyManageBlockOffsets' | 'animation/slide/fade' | 'animation/pan/fade' | 'animation/blur/fade' | 'animation/zoom/fade' | 'animation/crop_zoom/fade' | 'animation/spin/fade' | 'animation/block_swipe_text/useTextColor' | 'animation/spread_text/fade' | 'animation/ken_burns/fade' | 'effect/enabled' | (string & {});
 
 /**
  * Represents a buffer of data.
@@ -6884,16 +6978,20 @@ declare class CreativeEngine {
      * - `'ly.img.filter.duotone'` - Color effects of various kinds
      *
      * These assets are parsed at \{\{base_url\}\}/<id>/content.json, where
-     * `base_url` defaults to the IMG.LY CDN.
+     * `base_url` defaults to the engine's configured baseURL. For `@cesdk/node`
+     * that is the local package (`file://<pkg>/assets/`), which does not bundle
+     * these sources, so pass a `baseURL` to load them.
      * Each source is created via `addLocalSource` and populated with the parsed assets. To modify the available
      * assets, you may either exclude certain IDs via `excludeAssetSourceIds` or alter the sources after creation.
      *
+     * @deprecated This method uses legacy v4 asset source IDs and will be removed in a future version.
+     * Please migrate to v5 asset sources using engine.asset.addLocalAssetSourceFromJSONURI().
      * @category Asset Sources
      * @param options - Configuration options for loading default asset sources.
      * @returns A promise that resolves when all asset sources are loaded.
      */
     addDefaultAssetSources({ baseURL, excludeAssetSourceIds }?: {
-        /** The source of the asset definitions, must be absolute. Defaults to IMG.LY CDN. */
+        /** The source of the asset definitions, must be absolute. Defaults to the engine's configured baseURL. */
         baseURL?: string;
         /** A list of IDs, that will be ignored during load. */
         excludeAssetSourceIds?: DefaultAssetSourceId[];
@@ -6911,12 +7009,14 @@ declare class CreativeEngine {
      * - `'ly.img.video'` - Sample videos
      * - `'ly.img.video.upload'` - Demo source to upload video assets
      *
+     * @deprecated This method uses legacy v3 demo asset source IDs and will be removed in a future version.
+     * Please migrate to v4 asset sources using engine.asset.addLocalAssetSourceFromJSONURI().
      * @category Asset Sources
      * @param options - Configuration options for loading demo asset sources.
      * @returns A promise that resolves when all demo asset sources are loaded.
      */
     addDemoAssetSources({ baseURL, excludeAssetSourceIds, sceneMode, withUploadAssetSources }?: {
-        /** The source of the demo asset definitions, must be absolute. Defaults to IMG.LY CDN. */
+        /** The source of the demo asset definitions, must be absolute. Defaults to the engine's configured baseURL. */
         baseURL?: string;
         /** A list of IDs, that will be ignored during load */
         excludeAssetSourceIds?: DemoAssetSourceId[];
@@ -8599,6 +8699,8 @@ declare interface FindAssetsQuery {
     sortKey: string;
     sortActiveFirst: boolean;
     filter: AssetFilter[];
+    /** Facet paths crossing the binding boundary as plain path strings. */
+    facets: AssetFacetPath[];
 }
 
 /**
@@ -8964,14 +9066,14 @@ export declare type ObjectType = ObjectTypeShorthand | ObjectTypeLonghand;
  * engine when calling `cesdk.engine.block.getType(blockId)` for example.
  * @public
  */
-export declare type ObjectTypeLonghand = DesignBlockTypeLonghand | ShapeTypeLonghand | FillTypeLonghand | EffectTypeLonghand | BlurTypeLonghand | AnimationTypeLonghand;
+export declare type ObjectTypeLonghand = DesignBlockTypeLonghand | ShapeTypeLonghand | FillTypeLonghand | EffectTypeLonghand | BlurTypeLonghand | AnimationTypeLonghand | TransitionTypeLonghand;
 
 /**
  * The 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.
  * @public
  */
-export declare type ObjectTypeShorthand = DesignBlockTypeShorthand | `shape/${ShapeTypeShorthand}` | `fill/${FillTypeShorthand}` | `effect/${EffectTypeShorthand}` | `blur/${BlurTypeShorthand}` | `animation/${AnimationTypeShorthand}`;
+export declare type ObjectTypeShorthand = DesignBlockTypeShorthand | `shape/${ShapeTypeShorthand}` | `fill/${FillTypeShorthand}` | `effect/${EffectTypeShorthand}` | `blur/${BlurTypeShorthand}` | `animation/${AnimationTypeShorthand}` | `transition/${TransitionTypeShorthand}`;
 
 /** @public */
 export declare type OptionalPrefix<T extends string> = `ubq://${T}` | T;
@@ -10577,6 +10679,31 @@ export declare interface TransientResource {
     size: number;
 }
 
+/**
+ * The shorthand block type IDs for the transition blocks. These are the IDs used to create new transitions
+ * using `cesdk.engine.block.createTransition(id)`.
+ * @public
+ */
+export declare const TRANSITION_TYPES: readonly ["none", "cross-fade", "cross-blur", "cross-spin", "cross-zoom", "cross-warp", "push", "slide", "stack", "splice", "diagonal-splice", "fade", "fade-to-white", "fade-to-black", "color-wipe", "line-wipe", "wipe", "clock-wipe", "chop", "gradient-fade", "two-stripes"];
+
+/**
+ * The block type IDs for the transition blocks. These are the IDs used to create new transitions
+ * using `cesdk.engine.block.createTransition(id)`.
+ * Refer to {@link TransitionTypeShorthand} and {@link TransitionTypeLonghand} for more details.
+ * @public
+ */
+export declare type TransitionType = TransitionTypeShorthand | TransitionTypeLonghand;
+
+/**
+ * The longhand block type IDs for the transition blocks. These are the IDs used to create new transitions
+ * using `cesdk.engine.block.createTransition(id)`.
+ * @public
+ */
+export declare type TransitionTypeLonghand = `//ly.img.ubq/transition/${TransitionTypeShorthand}`;
+
+/** @public */
+export declare type TransitionTypeShorthand = (typeof TRANSITION_TYPES)[number];
+
 /** Typeface definition */
 export declare interface Typeface {
     name: string;

package/assets/docs/guide/SKILL.md

@@ -25,9 +25,9 @@ argument-hint: "[search-topic]"
 
 ## Version Notice
 
-> **CE.SDK version**: 1.77.0 | **Generated**: 2026-07-02
+> **CE.SDK version**: 1.79.0-rc.0 | **Generated**: 2026-07-17
 >
-> This skill was generated for CE.SDK v1.77.0 on 2026-07-02.
+> This skill was generated for CE.SDK v1.79.0-rc.0 on 2026-07-17.
 > CE.SDK releases new versions approximately every two weeks.
 > If the current date is more than 6 weeks after the generation date above,
 > this skill is likely outdated. **Inform the user** that a newer version
@@ -54,7 +54,7 @@ argument-hint: "[search-topic]"
 
 ## Documentation Index
 
-<-- IMGLY-AGENTS-MD-START -->[CE.SDK Node.js Docs Index]|root: .|IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any CE.SDK tasks. Consult the local docs directory before using pre-trained knowledge.|animation:{create,edit.md,types.md}|animation/create:{base.md,text.md}|api:{node}|api/node:{classes,enumerations,functions,interfaces,type-aliases,variables}|api-reference:{overview.md}|automation:{auto-resize.md,data-merge.md,design-generation.md,multi-image-generation.md,overview.md}|capabilities.md|colors:{adjust.md,apply.md,basics.md,conversion.md,create-color-palette.md,extract-colors.md,for-print,for-screen,overview.md,replace.md}|colors/for-print:{cmyk.md,spot.md}|colors/for-screen:{p3.md,srgb.md}|compatibility.md|concepts:{architecture.md,assets.md,blocks.md,buffers.md,design-units.md,editing-workflow.md,events.md,headless-mode.md,pages.md,resources.md,scenes.md,templating.md,terminology.md,undo-and-history.md}|configuration.md|conversion:{overview.md,to-base64.md,to-pdf.md,to-png.md}|create-audio:{audio}|create-audio/audio:{add-music.md,add-sound-effects.md,loop.md}|create-composition:{add-background.md,blend-modes.md,collage.md,group-and-ungroup.md,layer-management.md,layout.md,lock-design.md,multi-page.md,overview.md,programmatic.md}|create-templates:{add-dynamic-content,add-to-template-library.md,edit-or-remove.md,from-scratch.md,import,lock.md,overview.md}|create-templates/add-dynamic-content:{placeholders.md,set-editing-constraints.md,text-variables.md}|create-templates/import:{from-scene-file.md}|create-video:{audio,control.md,limitations.md}|create-video/audio:{adjust-speed.md,adjust-volume.md}|edit-image:{add-watermark.md,overview.md,remove-bg.md,replace-colors.md,transform}|edit-image/transform:{crop.md,flip.md,move.md,resize.md,rotate.md,scale.md}|edit-video:{add-captions.md,add-watermark.md,join-and-arrange.md,redaction.md,split.md,transform,trim.md}|edit-video/transform:{crop.md,flip.md,move.md,resize.md,rotate.md,scale.md}|engine-interface.md|export-save-publish:{create-thumbnail.md,export,for-printing.md,for-social-media.md,pre-export-validation.md,save.md,store-custom-metadata.md}|export-save-publish/export:{compress.md,overview.md,partial-export.md,size-limits.md,to-jpeg.md,to-pdf.md,to-png.md,to-raw-data.md,to-webp.md,with-color-mask.md}|file-format-support.md|fills:{color.md,image.md,overview.md,video.md}|filters-and-effects:{apply.md,blur.md,chroma-key-green-screen.md,create-custom-filters.md,create-custom-lut-filter.md,distortion.md,duotone.md,gradients.md,overview.md,support.md}|get-started:{agent-skills.md,build-with-ai.md,bun.md,deno.md,mcp-server.md,overview.md,vanilla.md,vanilla-aws-lambda.md,vanilla-clone-github-project.md}|guides:{export-save-publish}|guides/export-save-publish:{export}|import-media:{asset-panel,concepts.md,content-json-schema.md,default-assets.md,edit-or-remove-assets.md,file-format-support.md,from-remote-source,overview.md,retrieve-mimetype.md,size-limits.md,source-sets.md}|import-media/asset-panel:{refresh-assets.md}|import-media/from-remote-source:{asset-versioning.md,remote-asset.md}|insert-media:{audio.md,images.md,position-and-align.md,shapes-or-stickers.md,videos.md}|key-capabilities.md|key-concepts.md|licensing.md|llms-txt.md|open-the-editor:{blank-canvas.md,from-image.md,from-template.md,from-video.md,import-design,load-scene.md,overview.md,uri-resolver.md}|open-the-editor/import-design:{from-archive.md,from-indesign.md,from-photoshop.md}|outlines:{overview.md,shadows-and-glows.md,strokes.md}|overview.md|performance.md|plugins:{print-ready-pdf.md}|rules:{asset-handling.md,common-pitfalls.md,content-fill-mode.md,enforce-brand-guidelines.md,lock-content.md,moderate-content.md,overview.md,silent-init-errors.md,verify-properties-before-use.md}|security.md|serve-assets.md|settings.md|shapes.md|stickers.md|stickers-and-shapes:{combine.md,create-cutout.md,create-edit,insert-qr-code.md}|stickers-and-shapes/create-edit:{create-shapes.md,create-stickers.md,edit-shapes.md}|text:{add.md,adjust-spacing.md,auto-size.md,edit.md,effects.md,emojis.md,language-support.md,overview.md,styling.md,text-designs.md}|to-v1-19.md|upgrade.md|use-templates:{apply-template.md,generate.md,overview.md,programmatic.md,replace-content.md}|what-is-cesdk.md|<-- IMGLY-AGENTS-MD-END -->
+<-- IMGLY-AGENTS-MD-START -->[CE.SDK Node.js Docs Index]|root: .|IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any CE.SDK tasks. Consult the local docs directory before using pre-trained knowledge.|animation:{create,edit.md,types.md}|animation/create:{base.md,text.md}|api:{node}|api/node:{classes,enumerations,functions,interfaces,type-aliases,variables}|api-reference:{overview.md}|automation:{auto-resize.md,data-merge.md,design-generation.md,multi-image-generation.md,overview.md}|capabilities.md|colors:{adjust.md,apply.md,basics.md,conversion.md,create-color-palette.md,extract-colors.md,for-print,for-screen,overview.md,replace.md}|colors/for-print:{cmyk.md,spot.md}|colors/for-screen:{p3.md,srgb.md}|compatibility.md|concepts:{architecture.md,assets.md,blocks.md,buffers.md,design-units.md,editing-workflow.md,error-catalog.md,events.md,headless-mode.md,pages.md,resources.md,scenes.md,templating.md,terminology.md,undo-and-history.md}|configuration.md|conversion:{overview.md,to-base64.md,to-pdf.md,to-png.md}|create-audio:{audio}|create-audio/audio:{add-music.md,add-sound-effects.md,adjust-speed.md,adjust-volume.md,loop.md}|create-composition:{add-background.md,blend-modes.md,collage.md,group-and-ungroup.md,layer-management.md,layout.md,lock-design.md,multi-page.md,overview.md,programmatic.md}|create-templates:{add-dynamic-content,add-to-template-library.md,edit-or-remove.md,from-scratch.md,import,lock.md,overview.md}|create-templates/add-dynamic-content:{placeholders.md,set-editing-constraints.md,text-variables.md}|create-templates/import:{from-scene-file.md}|create-video:{control.md,limitations.md}|edit-image:{add-watermark.md,overview.md,remove-bg.md,replace-colors.md,transform}|edit-image/transform:{crop.md,flip.md,move.md,resize.md,rotate.md,scale.md}|edit-video:{add-captions.md,add-watermark.md,join-and-arrange.md,redaction.md,split.md,transform,trim.md}|edit-video/transform:{crop.md,flip.md,move.md,resize.md,rotate.md,scale.md}|engine-interface.md|export-save-publish:{create-thumbnail.md,export,for-printing.md,for-social-media.md,pre-export-validation.md,save.md,store-custom-metadata.md}|export-save-publish/export:{compress.md,overview.md,partial-export.md,size-limits.md,to-jpeg.md,to-pdf.md,to-png.md,to-raw-data.md,to-webp.md,with-color-mask.md}|file-format-support.md|fills:{color.md,gradient.md,image.md,overview.md,video.md}|filters-and-effects:{apply.md,blur.md,chroma-key-green-screen.md,create-custom-filters.md,create-custom-lut-filter.md,distortion.md,duotone.md,overview.md,support.md}|get-started:{agent-skills.md,build-with-ai.md,bun.md,cesdk-plugin-coding-agents.md,deno.md,mcp-server.md,overview.md,vanilla.md,vanilla-aws-lambda.md,vanilla-clone-github-project.md}|guides:{export-save-publish}|guides/export-save-publish:{export}|import-media:{asset-panel,concepts.md,content-json-schema.md,default-assets.md,edit-or-remove-assets.md,file-format-support.md,from-remote-source,overview.md,retrieve-mimetype.md,size-limits.md,source-sets.md}|import-media/asset-panel:{refresh-assets.md}|import-media/from-remote-source:{asset-versioning.md,remote-asset.md}|insert-media:{audio.md,images.md,position-and-align.md,shapes-or-stickers.md,videos.md}|key-capabilities.md|key-concepts.md|licensing.md|llms-txt.md|open-the-editor:{blank-canvas.md,from-image.md,from-template.md,from-video.md,import-design,load-scene.md,overview.md,uri-resolver.md}|open-the-editor/import-design:{from-archive.md,from-indesign.md,from-photoshop.md}|outlines:{overview.md,shadows-and-glows.md,strokes.md}|overview.md|performance.md|plugins:{print-ready-pdf.md}|rules:{asset-handling.md,common-pitfalls.md,content-fill-mode.md,enforce-brand-guidelines.md,lock-content.md,moderate-content.md,overview.md,silent-init-errors.md,verify-properties-before-use.md}|security.md|serve-assets.md|settings.md|shapes.md|stickers.md|stickers-and-shapes:{combine.md,create-cutout.md,create-edit,insert-qr-code.md}|stickers-and-shapes/create-edit:{create-shapes.md,create-stickers.md,edit-shapes.md}|text:{add.md,adjust-spacing.md,auto-size.md,edit.md,effects.md,emojis.md,language-support.md,overview.md,styling.md,text-designs.md}|to-v1-19.md|upgrade.md|use-templates:{apply-template.md,generate.md,overview.md,programmatic.md,replace-content.md}|what-is-cesdk.md|<-- IMGLY-AGENTS-MD-END -->
 
 ## API Index
 
@@ -62,7 +62,7 @@ argument-hint: "[search-topic]"
 [CE.SDK Web API Index]|root: .
 
 CreativeEngine:{asset,block,editor,event,scene,variable,actions,shortcuts,reactor,version,addPlugin,unstable_setVideoExportInactivityTimeout,unstable_setExportInactivityTimeout,addPostUpdateCallback,addPreUpdateCallback},... (+7)
-BlockAPI:{export,getDominantColors,exportWithColorMask,exportVideo,exportAudio,loadFromString,loadFromArchiveURL,loadFromURL,saveToString,saveToArchive,create,createFill,getAudioTrackCountFromVideo,createAudioFromVideo,createAudiosFromVideo},... (+397)
+BlockAPI:{export,getDominantColors,exportWithColorMask,exportVideo,exportAudio,loadFromString,loadFromArchiveURL,loadFromURL,saveToString,saveToArchive,create,createFill,getAudioTrackCountFromVideo,createAudioFromVideo,createAudiosFromVideo},... (+402)
 AssetAPI:{registerApplyMiddleware,registerApplyToBlockMiddleware,addSource,addLocalSource,addLocalAssetSourceFromJSONString,addLocalAssetSourceFromJSONURI,removeSource,findAllSources,findAssets,fetchAsset,getGroups,getSupportedMimeTypes,getCredits,name,url},... (+14)
 SceneAPI:{loadFromString,loadFromURL,loadFromArchiveURL,saveToString,saveToArchive,create,createVideo,createFromImage,createFromVideo,get,applyTemplateFromString,applyTemplateFromURL,getMode,setMode,setDesignUnit},... (+24)
 EditorAPI:{unlockWithLicense,startTracking,setTrackingMetadata,getTrackingMetadata,getActiveLicense,onStateChanged,setEditMode,getEditMode,unstable_isInteractionHappening,hasSelectedVectorNode,addVectorNode,deleteVectorNode,hasSelectedVectorControlPoint,deleteSelectedVectorControlPoints,toggleSelectedVectorNodeSmooth},... (+95)

package/assets/docs/guide/api/BlockAPI.md

@@ -6224,6 +6224,83 @@ getOutAnimation(id: DesignBlockId): DesignBlockId
 
 **Returns:** The "out" animation of the block.
 
+## Block Transitions
+
+### createTransition()
+
+Creates a new transition block.
+The created block is standalone until assigned to a clip with `setTransition`.
+Once assigned, it is owned by that clip: it is destroyed together with the
+clip, and the engine also destroys it automatically when the two clips stop
+being timeline-adjacent on the track (e.g. after a manual gap is introduced).
+
+```typescript
+createTransition(type: TransitionType): DesignBlockId
+```
+
+**Parameters:**
+- `type` - The type of transition to create.
+
+**Returns:** The handle of the new transition instance.
+
+### supportsTransition()
+
+Checks whether a clip can own an outgoing clip-to-clip transition.
+Only leaf clips inside a video track qualify. Audio, group, caption, and
+cutout blocks — as well as blocks outside a video track — report `false`.
+
+```typescript
+supportsTransition(id: DesignBlockId): boolean
+```
+
+**Parameters:**
+- `id` - The clip block to check.
+
+**Returns:** Whether the block can own an outgoing transition.
+
+### setTransition()
+
+Assigns the outgoing transition of a clip.
+A previously assigned transition block is detached but not destroyed
+automatically. Throws an error if the given transition block is invalid or
+already assigned to another clip. Both the clip and its following clip on
+the track must support transitions, see `supportsTransition`. To clear a
+clip's transition, use `removeTransition` instead.
+
+```typescript
+setTransition(id: DesignBlockId, transition: DesignBlockId): void
+```
+
+**Parameters:**
+- `id` - The outgoing clip that owns the transition relation.
+- `transition` - The transition block to assign.
+
+### removeTransition()
+
+Removes the outgoing transition of a clip.
+The removed transition block is detached but not destroyed automatically.
+Removing from a clip without an assigned transition is a no-op.
+
+```typescript
+removeTransition(id: DesignBlockId): void
+```
+
+**Parameters:**
+- `id` - The outgoing clip whose transition relation should be cleared.
+
+### getTransition()
+
+Gets the outgoing transition assigned to a clip.
+
+```typescript
+getTransition(id: DesignBlockId): DesignBlockId
+```
+
+**Parameters:**
+- `id` - The outgoing clip whose transition relation should be queried.
+
+**Returns:** The assigned transition block, or an invalid block if unset.
+
 ---
 
 For complete type definitions, see the [CE.SDK TypeScript API Reference](https://img.ly/docs/cesdk/engine/api/).