@shotstack/shotstack-studio 2.0.0-beta.36 → 2.0.0-beta.38

package/dist/internal.d.ts

@@ -422,15 +422,15 @@ export declare class ShotstackEdit extends Edit {
     /**
      * Apply a merge field to a clip property.
      */
-    applyMergeField(trackIndex: number, clipIndex: number, propertyPath: string, fieldName: string, value: string, originalValue?: string): Promise<void>;
+    applyMergeField(clipId: string, propertyPath: string, fieldName: string, value: string, originalValue?: string): Promise<void>;
     /**
      * Remove a merge field from a clip property, restoring the original value.
      */
-    removeMergeField(trackIndex: number, clipIndex: number, propertyPath: string, restoreValue: string): Promise<void>;
+    removeMergeField(clipId: string, propertyPath: string, restoreValue: string): Promise<void>;
     /**
      * Get the merge field name for a clip property, if any.
      */
-    getMergeFieldForProperty(trackIndex: number, clipIndex: number, propertyPath: string): string | null;
+    getMergeFieldForProperty(clipId: string, propertyPath: string): string | null;
     /**
      * Update the placeholder value of a merge field.
      */
@@ -440,6 +440,19 @@ export declare class ShotstackEdit extends Edit {
      * Used by UI to determine if URL validation should be applied.
      */
     isSrcMergeField(fieldName: string): boolean;
+    /**
+     * Check if a value is type-compatible with all properties a merge field is bound to.
+     * Temporarily swaps the field value, resolves each bound clip, and validates
+     * against ClipSchema — the same Zod schema used at load time.
+     */
+    validateMergeFieldValue(fieldName: string, value: string): string | null;
+    /**
+     * Check if a value is compatible with a specific clip property via Zod schema validation.
+     * Used by the merge field label manager to filter compatible fields in dropdowns.
+     */
+    isValueCompatibleWithClipProperty(clipId: string, propertyPath: string, value: string): boolean;
+    /** Check if any binding in a clip references the given field name. */
+    private clipUsesField;
     /**
      * Remove a merge field globally from all clips and the registry.
      */