premiere-cli 0.2.0__py3-none-any.whl

premiere_cli/panel/host/commands/set-clip-anchor-point.jsx

@@ -0,0 +1,102 @@
+// Command: set-clip-anchor-point → ppb_setClipAnchorPoint
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context — shared helpers (findSequenceByName,
+// findClipComponent, setComponentProperty, ...) are already defined there.
+//
+// Standard-DOM only — no QE needed. Ported from leancoderkavy's
+// premiere-pro-mcp `set_clip_anchor_point` tool (track-targeting.ts),
+// addressed here by trackType/trackIndex/clipIndex (same convention as
+// get-full-clip-info) instead of node_id. Sets the Motion component's
+// Anchor Point property ([x, y] in pixels). Mutating — undo is
+// non-functional on this build, so previousValue in the result is the
+// caller's only restoration path.
+
+function ppb_setClipAnchorPoint(argsJson) {
+  try {
+    var args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "invalid args JSON: " + e.toString() });
+    }
+
+    if (args.trackType !== "video" && args.trackType !== "audio") {
+      return JSON.stringify({ ok: false, error: "trackType must be \"video\" or \"audio\"" });
+    }
+    if (typeof args.trackIndex !== "number" || args.trackIndex < 0 || Math.floor(args.trackIndex) !== args.trackIndex) {
+      return JSON.stringify({ ok: false, error: "trackIndex must be a non-negative integer" });
+    }
+    if (typeof args.clipIndex !== "number" || args.clipIndex < 0 || Math.floor(args.clipIndex) !== args.clipIndex) {
+      return JSON.stringify({ ok: false, error: "clipIndex must be a non-negative integer" });
+    }
+    if (typeof args.x !== "number" || typeof args.y !== "number") {
+      return JSON.stringify({ ok: false, error: "x and y must both be numbers (pixels)" });
+    }
+
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var seq = null;
+    if (args.sequenceName && typeof args.sequenceName === "string") {
+      seq = findSequenceByName(args.sequenceName);
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no sequence named \"" + args.sequenceName + "\" is open" });
+      }
+    } else {
+      seq = app.project.activeSequence;
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no active sequence, and no sequenceName given" });
+      }
+    }
+
+    var trackCollection = args.trackType === "video" ? seq.videoTracks : seq.audioTracks;
+    var numTracks = trackCollection.numTracks;
+    if (args.trackIndex >= numTracks) {
+      return JSON.stringify({
+        ok: false,
+        error: "trackIndex " + args.trackIndex + " is out of range — sequence has " + numTracks + " " + args.trackType + " track(s)"
+      });
+    }
+
+    var track = trackCollection[args.trackIndex];
+    var numClips = track.clips.numItems;
+    if (args.clipIndex >= numClips) {
+      return JSON.stringify({
+        ok: false,
+        error: "clipIndex " + args.clipIndex + " is out of range — track " + args.trackIndex + " has " + numClips + " clip(s)"
+      });
+    }
+
+    var clip = track.clips[args.clipIndex];
+    var clipName = null;
+    try { clipName = clip.name; } catch (e) { clipName = null; }
+
+    var motion = findClipComponent(clip, ["AE.ADBE Motion"], ["Motion"]);
+    if (!motion) {
+      return JSON.stringify({ ok: false, error: "Motion component not found on clip" });
+    }
+
+    var setResult = setComponentProperty(motion, ["Anchor Point"], [args.x, args.y]);
+    if (!setResult.found) {
+      return JSON.stringify({ ok: false, error: "Anchor Point property not found on the Motion component" });
+    }
+
+    return JSON.stringify({
+      ok: true,
+      result: {
+        sequenceName: seq.name,
+        trackType: args.trackType,
+        trackIndex: args.trackIndex,
+        clipIndex: args.clipIndex,
+        clipName: clipName,
+        previousValue: setResult.previousValue,
+        requestedValue: setResult.requestedValue,
+        newValue: setResult.newValue,
+        verified: setResult.verified
+      }
+    });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}

premiere_cli/panel/host/commands/set-clip-enabled.jsx

@@ -0,0 +1,127 @@
+// Command: set-clip-enabled → ppb_setClipEnabled
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context — shared helpers (findSequenceByName,
+// ...) are already defined there.
+//
+// Standard-DOM mutation. Ported from leancoderkavy's premiere-pro-mcp
+// `enable_disable_clip` tool (timeline.ts) — renamed here to
+// `set-clip-enabled` for explicitness (the reference name reads as a
+// verb pair, this one states the positive-sense boolean it takes). Args
+// use `enabled` (true = clip plays, false = clip disabled) — the
+// underlying Premiere property is the INVERTED `clip.disabled` /
+// `clip.setDisabled()`, so this command negates at the boundary. Per
+// PREMIERE_API_NOTES.md, `clip.disabled = bool` [hetpatel] and
+// `clip.setDisabled(bool)` [leancoderkavy] are both cited as existing —
+// probed in that order, whichever sticks (verified via a clip.disabled
+// read-back) determines `method`.
+function ppb_setClipEnabled(argsJson) {
+  try {
+    var args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "invalid args JSON: " + e.toString() });
+    }
+
+    if (args.trackType !== "video" && args.trackType !== "audio") {
+      return JSON.stringify({ ok: false, error: "trackType must be \"video\" or \"audio\"" });
+    }
+    if (typeof args.trackIndex !== "number" || args.trackIndex < 0 || Math.floor(args.trackIndex) !== args.trackIndex) {
+      return JSON.stringify({ ok: false, error: "trackIndex must be a non-negative integer" });
+    }
+    if (typeof args.clipIndex !== "number" || args.clipIndex < 0 || Math.floor(args.clipIndex) !== args.clipIndex) {
+      return JSON.stringify({ ok: false, error: "clipIndex must be a non-negative integer" });
+    }
+    if (typeof args.enabled !== "boolean") {
+      return JSON.stringify({ ok: false, error: "enabled must be a boolean" });
+    }
+
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var seq = null;
+    if (args.sequenceName && typeof args.sequenceName === "string") {
+      seq = findSequenceByName(args.sequenceName);
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no sequence named \"" + args.sequenceName + "\" is open" });
+      }
+    } else {
+      seq = app.project.activeSequence;
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no active sequence, and no sequenceName given" });
+      }
+    }
+
+    var trackCollection = args.trackType === "video" ? seq.videoTracks : seq.audioTracks;
+    var numTracks = trackCollection.numTracks;
+    if (args.trackIndex >= numTracks) {
+      return JSON.stringify({
+        ok: false,
+        error: "trackIndex " + args.trackIndex + " is out of range — sequence has " + numTracks + " " + args.trackType + " track(s)"
+      });
+    }
+
+    var track = trackCollection[args.trackIndex];
+    var numClips = track.clips.numItems;
+    if (args.clipIndex >= numClips) {
+      return JSON.stringify({
+        ok: false,
+        error: "clipIndex " + args.clipIndex + " is out of range — track " + args.trackIndex + " has " + numClips + " clip(s)"
+      });
+    }
+
+    var clip = track.clips[args.clipIndex];
+    var clipName = null;
+    try { clipName = clip.name; } catch (e) { clipName = null; }
+
+    var previousValue = null;
+    try { previousValue = clip.disabled; } catch (e) { previousValue = null; }
+
+    var requestedDisabled = !args.enabled;
+    var method = null;
+    var assignError = null;
+    var setDisabledError = null;
+
+    try {
+      clip.disabled = requestedDisabled;
+      method = "disabledAssignment";
+    } catch (e) {
+      assignError = e.toString();
+    }
+
+    var newValue = null;
+    try { newValue = clip.disabled; } catch (e) { newValue = null; }
+
+    if (newValue !== requestedDisabled) {
+      try {
+        clip.setDisabled(requestedDisabled);
+        method = "setDisabled";
+      } catch (e) {
+        setDisabledError = e.toString();
+      }
+      try { newValue = clip.disabled; } catch (e) { newValue = newValue; }
+    }
+
+    var verified = newValue === requestedDisabled;
+
+    var result = {
+      sequenceName: seq.name,
+      trackType: args.trackType,
+      trackIndex: args.trackIndex,
+      clipIndex: args.clipIndex,
+      clipName: clipName,
+      requestedValue: args.enabled,
+      previousValue: previousValue === null ? null : !previousValue,
+      newValue: newValue === null ? null : !newValue,
+      verified: verified,
+      method: method,
+      assignError: assignError,
+      setDisabledError: setDisabledError
+    };
+
+    return JSON.stringify({ ok: true, result: result });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}

premiere_cli/panel/host/commands/set-clip-opacity.jsx

@@ -0,0 +1,102 @@
+// Command: set-clip-opacity → ppb_setClipOpacity
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context — shared helpers (findSequenceByName,
+// findClipComponent, setComponentProperty, ...) are already defined there.
+//
+// Standard-DOM only — no QE needed. Ported from leancoderkavy's
+// premiere-pro-mcp `set_clip_opacity` tool (track-targeting.ts), addressed
+// here by trackType/trackIndex/clipIndex (same convention as
+// get-full-clip-info) instead of node_id. Sets the Opacity component's
+// Opacity property (0-100). Mutating — undo is non-functional on this
+// build, so previousValue in the result is the caller's only restoration
+// path.
+
+function ppb_setClipOpacity(argsJson) {
+  try {
+    var args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "invalid args JSON: " + e.toString() });
+    }
+
+    if (args.trackType !== "video" && args.trackType !== "audio") {
+      return JSON.stringify({ ok: false, error: "trackType must be \"video\" or \"audio\"" });
+    }
+    if (typeof args.trackIndex !== "number" || args.trackIndex < 0 || Math.floor(args.trackIndex) !== args.trackIndex) {
+      return JSON.stringify({ ok: false, error: "trackIndex must be a non-negative integer" });
+    }
+    if (typeof args.clipIndex !== "number" || args.clipIndex < 0 || Math.floor(args.clipIndex) !== args.clipIndex) {
+      return JSON.stringify({ ok: false, error: "clipIndex must be a non-negative integer" });
+    }
+    if (typeof args.opacity !== "number" || args.opacity < 0 || args.opacity > 100) {
+      return JSON.stringify({ ok: false, error: "opacity must be a number between 0 and 100" });
+    }
+
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var seq = null;
+    if (args.sequenceName && typeof args.sequenceName === "string") {
+      seq = findSequenceByName(args.sequenceName);
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no sequence named \"" + args.sequenceName + "\" is open" });
+      }
+    } else {
+      seq = app.project.activeSequence;
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no active sequence, and no sequenceName given" });
+      }
+    }
+
+    var trackCollection = args.trackType === "video" ? seq.videoTracks : seq.audioTracks;
+    var numTracks = trackCollection.numTracks;
+    if (args.trackIndex >= numTracks) {
+      return JSON.stringify({
+        ok: false,
+        error: "trackIndex " + args.trackIndex + " is out of range — sequence has " + numTracks + " " + args.trackType + " track(s)"
+      });
+    }
+
+    var track = trackCollection[args.trackIndex];
+    var numClips = track.clips.numItems;
+    if (args.clipIndex >= numClips) {
+      return JSON.stringify({
+        ok: false,
+        error: "clipIndex " + args.clipIndex + " is out of range — track " + args.trackIndex + " has " + numClips + " clip(s)"
+      });
+    }
+
+    var clip = track.clips[args.clipIndex];
+    var clipName = null;
+    try { clipName = clip.name; } catch (e) { clipName = null; }
+
+    var opacityComp = findClipComponent(clip, ["AE.ADBE Opacity"], ["Opacity"]);
+    if (!opacityComp) {
+      return JSON.stringify({ ok: false, error: "Opacity component not found on clip" });
+    }
+
+    var setResult = setComponentProperty(opacityComp, ["Opacity"], args.opacity);
+    if (!setResult.found) {
+      return JSON.stringify({ ok: false, error: "Opacity property not found on the Opacity component" });
+    }
+
+    return JSON.stringify({
+      ok: true,
+      result: {
+        sequenceName: seq.name,
+        trackType: args.trackType,
+        trackIndex: args.trackIndex,
+        clipIndex: args.clipIndex,
+        clipName: clipName,
+        previousValue: setResult.previousValue,
+        requestedValue: setResult.requestedValue,
+        newValue: setResult.newValue,
+        verified: setResult.verified
+      }
+    });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}

premiere_cli/panel/host/commands/set-clip-pan.jsx

@@ -0,0 +1,107 @@
+// Command: set-clip-pan → ppb_setClipPan
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context — shared helpers (findSequenceByName,
+// findPannerProperty, ...) are already defined there.
+//
+// Standard-DOM mutation. Ported from leancoderkavy's premiere-pro-mcp
+// `set_clip_pan` tool (track-targeting.ts) — Panner component's
+// Balance/Pan property, -100 (full left) .. 100 (full right), 0 = center,
+// same range as the reference. No dB-style conversion involved, unlike
+// set-clip-volume.
+function ppb_setClipPan(argsJson) {
+  try {
+    var args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "invalid args JSON: " + e.toString() });
+    }
+
+    if (args.trackType !== "video" && args.trackType !== "audio") {
+      return JSON.stringify({ ok: false, error: "trackType must be \"video\" or \"audio\"" });
+    }
+    if (typeof args.trackIndex !== "number" || args.trackIndex < 0 || Math.floor(args.trackIndex) !== args.trackIndex) {
+      return JSON.stringify({ ok: false, error: "trackIndex must be a non-negative integer" });
+    }
+    if (typeof args.clipIndex !== "number" || args.clipIndex < 0 || Math.floor(args.clipIndex) !== args.clipIndex) {
+      return JSON.stringify({ ok: false, error: "clipIndex must be a non-negative integer" });
+    }
+    if (typeof args.pan !== "number" || isNaN(args.pan) || args.pan < -100 || args.pan > 100) {
+      return JSON.stringify({ ok: false, error: "pan must be a number between -100 and 100" });
+    }
+
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var seq = null;
+    if (args.sequenceName && typeof args.sequenceName === "string") {
+      seq = findSequenceByName(args.sequenceName);
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no sequence named \"" + args.sequenceName + "\" is open" });
+      }
+    } else {
+      seq = app.project.activeSequence;
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no active sequence, and no sequenceName given" });
+      }
+    }
+
+    var trackCollection = args.trackType === "video" ? seq.videoTracks : seq.audioTracks;
+    var numTracks = trackCollection.numTracks;
+    if (args.trackIndex >= numTracks) {
+      return JSON.stringify({
+        ok: false,
+        error: "trackIndex " + args.trackIndex + " is out of range — sequence has " + numTracks + " " + args.trackType + " track(s)"
+      });
+    }
+
+    var track = trackCollection[args.trackIndex];
+    var numClips = track.clips.numItems;
+    if (args.clipIndex >= numClips) {
+      return JSON.stringify({
+        ok: false,
+        error: "clipIndex " + args.clipIndex + " is out of range — track " + args.trackIndex + " has " + numClips + " clip(s)"
+      });
+    }
+
+    var clip = track.clips[args.clipIndex];
+    var clipName = null;
+    try { clipName = clip.name; } catch (e) { clipName = null; }
+
+    var panProp = findPannerProperty(clip);
+    if (!panProp) {
+      return JSON.stringify({ ok: false, error: "could not find Panner Balance/Pan property on clip — is this an audio clip?" });
+    }
+
+    var previousValue = null;
+    try { previousValue = panProp.getValue(); } catch (e) { previousValue = null; }
+
+    try {
+      panProp.setValue(args.pan, true);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "panProp.setValue() failed: " + e.toString() });
+    }
+
+    var newValue = null;
+    try { newValue = panProp.getValue(); } catch (e) { newValue = null; }
+
+    var verified = newValue !== null && Math.abs(newValue - args.pan) < 0.001;
+
+    var result = {
+      sequenceName: seq.name,
+      trackType: args.trackType,
+      trackIndex: args.trackIndex,
+      clipIndex: args.clipIndex,
+      clipName: clipName,
+      requestedValue: args.pan,
+      previousValue: previousValue,
+      newValue: newValue,
+      verified: verified
+    };
+
+    return JSON.stringify({ ok: true, result: result });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}

premiere_cli/panel/host/commands/set-clip-position.jsx

@@ -0,0 +1,103 @@
+// Command: set-clip-position → ppb_setClipPosition
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context — shared helpers (findSequenceByName,
+// findClipComponent, setComponentProperty, ...) are already defined there.
+//
+// Standard-DOM only — no QE needed. Ported from leancoderkavy's
+// premiere-pro-mcp `set_clip_position` tool (track-targeting.ts), which
+// addresses the clip by node_id via that repo's __findClip() helper; this
+// bridge instead uses the same trackType/trackIndex/clipIndex addressing as
+// get-full-clip-info (no node-id lookup helper exists here). Sets the
+// Motion component's Position property ([x, y] in pixels). Mutating —
+// undo is non-functional on this build, so previousValue in the result is
+// the caller's only restoration path.
+
+function ppb_setClipPosition(argsJson) {
+  try {
+    var args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "invalid args JSON: " + e.toString() });
+    }
+
+    if (args.trackType !== "video" && args.trackType !== "audio") {
+      return JSON.stringify({ ok: false, error: "trackType must be \"video\" or \"audio\"" });
+    }
+    if (typeof args.trackIndex !== "number" || args.trackIndex < 0 || Math.floor(args.trackIndex) !== args.trackIndex) {
+      return JSON.stringify({ ok: false, error: "trackIndex must be a non-negative integer" });
+    }
+    if (typeof args.clipIndex !== "number" || args.clipIndex < 0 || Math.floor(args.clipIndex) !== args.clipIndex) {
+      return JSON.stringify({ ok: false, error: "clipIndex must be a non-negative integer" });
+    }
+    if (typeof args.x !== "number" || typeof args.y !== "number") {
+      return JSON.stringify({ ok: false, error: "x and y must both be numbers (pixels)" });
+    }
+
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var seq = null;
+    if (args.sequenceName && typeof args.sequenceName === "string") {
+      seq = findSequenceByName(args.sequenceName);
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no sequence named \"" + args.sequenceName + "\" is open" });
+      }
+    } else {
+      seq = app.project.activeSequence;
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no active sequence, and no sequenceName given" });
+      }
+    }
+
+    var trackCollection = args.trackType === "video" ? seq.videoTracks : seq.audioTracks;
+    var numTracks = trackCollection.numTracks;
+    if (args.trackIndex >= numTracks) {
+      return JSON.stringify({
+        ok: false,
+        error: "trackIndex " + args.trackIndex + " is out of range — sequence has " + numTracks + " " + args.trackType + " track(s)"
+      });
+    }
+
+    var track = trackCollection[args.trackIndex];
+    var numClips = track.clips.numItems;
+    if (args.clipIndex >= numClips) {
+      return JSON.stringify({
+        ok: false,
+        error: "clipIndex " + args.clipIndex + " is out of range — track " + args.trackIndex + " has " + numClips + " clip(s)"
+      });
+    }
+
+    var clip = track.clips[args.clipIndex];
+    var clipName = null;
+    try { clipName = clip.name; } catch (e) { clipName = null; }
+
+    var motion = findClipComponent(clip, ["AE.ADBE Motion"], ["Motion"]);
+    if (!motion) {
+      return JSON.stringify({ ok: false, error: "Motion component not found on clip" });
+    }
+
+    var setResult = setComponentProperty(motion, ["Position"], [args.x, args.y]);
+    if (!setResult.found) {
+      return JSON.stringify({ ok: false, error: "Position property not found on the Motion component" });
+    }
+
+    return JSON.stringify({
+      ok: true,
+      result: {
+        sequenceName: seq.name,
+        trackType: args.trackType,
+        trackIndex: args.trackIndex,
+        clipIndex: args.clipIndex,
+        clipName: clipName,
+        previousValue: setResult.previousValue,
+        requestedValue: setResult.requestedValue,
+        newValue: setResult.newValue,
+        verified: setResult.verified
+      }
+    });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}