@shotstack/shotstack-studio 2.0.0-beta.10 → 2.0.0-beta.12

package/dist/index.d.ts

@@ -281,6 +281,8 @@ export declare class CanvasToolbar {
     constructor(edit?: Edit, options?: {
         mergeFields?: boolean;
     });
+    /** Get the edit as ShotstackEdit if it has merge field capabilities */
+    private getShotstackEdit;
     setPosition(screenX: number, screenY: number): void;
     mount(parent: HTMLElement): void;
     private setupEventListeners;
@@ -528,8 +530,6 @@ export declare class Edit extends Entity {
     private isLoadingEdit;
     private syncCorrectionCount;
     private toolbarButtons;
-    /** Merge field service for managing dynamic content placeholders */
-    mergeFields: MergeFieldService;
     private canvas;
     private lumaMaskController;
     private clipErrors;
@@ -700,12 +700,12 @@ export declare class Edit extends Entity {
      */
     updateClipTiming(trackIdx: number, clipIdx: number, params: TimingUpdateParams): void;
     executeEditCommand(command: EditCommand): void | Promise<void>;
-    private executeCommand;
+    protected executeCommand(command: EditCommand): void | Promise<void>;
     /**
      * Emits a unified `edit:changed` event after any state mutation.
      * Consumers can subscribe to this single event instead of tracking 31+ granular events.
      */
-    private emitEditChanged;
+    protected emitEditChanged(source: string): void;
     /**
      * Detects merge field placeholders in the raw edit before substitution.
      * Returns a map of clip keys ("trackIdx-clipIdx") to their merge field bindings.
@@ -727,7 +727,7 @@ export declare class Edit extends Entity {
      * Only called when structure is unchanged (same track/clip counts).
      */
     private applyGranularChanges;
-    private createCommandContext;
+    protected createCommandContext(): CommandContext;
     private queueDisposeClip;
     protected disposeClips(): void;
     /**
@@ -817,69 +817,9 @@ export declare class Edit extends Entity {
      */
     getToolbarButtons(): ToolbarButtonConfig_2[];
     /** Get the exportable clip (with merge field placeholders restored) */
-    private getTemplateClip;
+    protected getTemplateClip(trackIndex: number, clipIndex: number): ResolvedClip | null;
     /** Get the text content from the template clip (with merge field placeholders) */
     getTemplateClipText(trackIdx: number, clipIdx: number): string | null;
-    /**
-     * Apply a merge field to a clip property.
-     * Creates a command for undo/redo support.
-     *
-     * @param trackIndex - Track index
-     * @param clipIndex - Clip index within the track
-     * @param propertyPath - Dot-notation path to property (e.g., "asset.src", "asset.color")
-     * @param fieldName - Name of the merge field (e.g., "MEDIA_URL")
-     * @param value - The resolved value to apply
-     * @param originalValue - Optional: the original value before merge field (for undo)
-     */
-    applyMergeField(trackIndex: number, clipIndex: number, propertyPath: string, fieldName: string, value: string, originalValue?: string): void;
-    /**
-     * Remove a merge field from a clip property, restoring the original value.
-     *
-     * @param trackIndex - Track index
-     * @param clipIndex - Clip index within the track
-     * @param propertyPath - Dot-notation path to property (e.g., "asset.src")
-     * @param restoreValue - The value to restore (original pre-merge-field value)
-     */
-    removeMergeField(trackIndex: number, clipIndex: number, propertyPath: string, restoreValue: string): void;
-    /**
-     * Get the merge field name for a clip property, if any.
-     *
-     * @returns The field name if a merge field is applied, null otherwise
-     */
-    getMergeFieldForProperty(trackIndex: number, clipIndex: number, propertyPath: string): string | null;
-    /**
-     * Update the value of a merge field. Updates all clips using this field in-place.
-     * This does NOT use the command pattern (no undo) - it's for live preview updates.
-     */
-    updateMergeFieldValueLive(fieldName: string, newValue: string): void;
-    /** Helper: Update merge field binding resolvedValues for a player */
-    private updateMergeFieldBindings;
-    /** Helper: Update merge field occurrences in an object */
-    private updateMergeFieldInObject;
-    /**
-     * Redraw all clips that use a specific merge field.
-     * Call this after updateMergeFieldValueLive() to refresh the canvas.
-     * Handles both text redraws and asset reloads for URL changes.
-     */
-    redrawMergeFieldClips(fieldName: string): void;
-    /** Helper: Check if and how a clip uses a specific merge field */
-    private getMergeFieldUsage;
-    /**
-     * Check if a merge field is used for asset.src in any clip.
-     * Used by UI to determine if URL validation should be applied.
-     */
-    isSrcMergeField(fieldName: string): boolean;
-    /**
-     * Remove a merge field globally from all clips and the registry.
-     * Restores all affected clip properties to the merge field's default value.
-     *
-     * @param fieldName - The merge field name to remove
-     */
-    deleteMergeFieldGlobally(fieldName: string): void;
-    /**
-     * Helper: Find and restore merge field occurrences in a clip
-     */
-    private restoreMergeFieldInClip;
     /** Map of content player → luma player for attachment tracking */
     private lumaAttachments;
     /** Map of asset src → original asset type (for reliable luma detachment) */
@@ -1208,6 +1148,8 @@ export declare class MediaToolbar extends BaseToolbar {
     private showMergeFields;
     private assetType;
     constructor(edit: Edit, options?: MediaToolbarOptions);
+    /** Get the edit as ShotstackEdit if it has merge field capabilities */
+    private getShotstackEdit;
     private currentFit;
     private currentVolume;
     private transitionPanel;
@@ -1548,7 +1490,8 @@ declare enum PlayerType {
     Luma = "luma",
     Html = "html",
     Shape = "shape",
-    Caption = "caption"
+    Caption = "caption",
+    Svg = "svg"
 }
 
 declare type ResolutionChangeCallback = (width: number, height: number) => void;
@@ -1589,6 +1532,7 @@ export declare class RichTextToolbar extends BaseToolbar {
     private fontPicker;
     private sizeInput;
     private sizePopup;
+    private weightDropdown;
     private weightPopup;
     private weightPreview;
     private spacingPopup;
@@ -1644,6 +1588,7 @@ export declare class RichTextToolbar extends BaseToolbar {
     private stylePanel;
     private boundHandleClick;
     constructor(edit: Edit, options?: RichTextToolbarOptions);
+    private getShotstackEdit;
     mount(parent: HTMLElement): void;
     private handleClick;
     private getCurrentAsset;
@@ -1677,7 +1622,7 @@ export declare class RichTextToolbar extends BaseToolbar {
     private getFilteredFieldCount;
     private buildFontPicker;
     private getDisplayName;
-    private selectGoogleFont;
+    private selectFont;
     private updateVerticalAlign;
     private cycleAlignment;
     private updateAlignment;
@@ -1713,17 +1658,12 @@ declare type Seconds = number & {
 
 declare const SecondsSymbol: unique symbol;
 
-/**
- * SelectionHandles renders selection UI (outline + resize handles) on selected players
- * and handles all drag/resize/rotate interactions.
- *
- * This class decouples interaction logic from Player, allowing Canvas to work as a pure renderer.
- */
 export declare class SelectionHandles implements CanvasOverlayRegistration {
     private edit;
     private container;
     private outline;
     private handles;
+    private edgeHandles;
     private app;
     private positionBuilder;
     private selectedPlayer;
@@ -1756,6 +1696,7 @@ export declare class SelectionHandles implements CanvasOverlayRegistration {
     private syncToPlayer;
     private drawOutline;
     private drawHandles;
+    private drawEdgeHandles;
     private getUIScale;
     private onPointerDown;
     private onPointerMove;
@@ -1847,6 +1788,7 @@ export declare class TextToolbar extends BaseToolbar {
     private effectPopup;
     private effectPanel;
     private boundHandleClick;
+    private getShotstackEdit;
     mount(parent: HTMLElement): void;
     private bindElements;
     private setupEventListeners;