@motionharness/bridge-davinci 0.0.0-stage → 0.0.23

package/dist/runtime_io.py

@@ -0,0 +1,31 @@
+"""File evidence and durable journals shared by the Resolve operations."""
+import hashlib
+import json
+import os
+import uuid
+
+
+def file_digest(path):
+    digest = hashlib.sha256()
+    with open(path, "rb") as stream:
+        for block in iter(lambda: stream.read(1024 * 1024), b""):
+            digest.update(block)
+    return "sha256:" + digest.hexdigest()
+
+
+def atomic_json(path, value, *, allow_nan=True):
+    pending = path + "." + str(uuid.uuid4()) + ".pending"
+    try:
+        with os.fdopen(os.open(pending, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600), "w", encoding="utf-8") as stream:
+            json.dump(value, stream, ensure_ascii=False, allow_nan=allow_nan)
+            stream.flush()
+            os.fsync(stream.fileno())
+        os.replace(pending, path)
+        descriptor = os.open(os.path.dirname(path), os.O_RDONLY)
+        try:
+            os.fsync(descriptor)
+        finally:
+            os.close(descriptor)
+    finally:
+        if os.path.exists(pending):
+            os.unlink(pending)

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@motionharness/bridge-davinci",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.23",
+  "private": false,
+  "type": "module",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VibeMG/vibe-motion-graphics.git",
+    "directory": "packages/bridge/davinci"
+  },
+  "description": "Motion Harness Bridge Component for DaVinci Resolve",
+  "exports": {
+    ".": "./dist/runner.mjs"
+  },
+  "files": [
+    "dist/runner.mjs",
+    "dist/*.py",
+    "bridge-manifest.json",
+    "resources",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "OPENFX_LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "engines": {
+    "node": ">=22.18"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ]
+}

package/resources/HotionHarness.ofx.bundle/Contents/Info.plist

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+<key>CFBundleIdentifier</key><string>com.hotionharness.bridge.davinci</string>
+<key>CFBundleName</key><string>Motion Harness Bridge Component</string>
+<key>CFBundleExecutable</key><string>HotionHarness.ofx</string>
+<key>CFBundlePackageType</key><string>BNDL</string>
+<key>CFBundleVersion</key><string>1</string>
+</dict></plist>

package/resources/HotionHarnessStatus.app/Contents/Info.plist

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+<key>CFBundleIdentifier</key><string>com.hotionharness.bridge.status</string>
+<key>CFBundleName</key><string>Motion Harness Bridge Component</string>
+<key>CFBundleDisplayName</key><string>Motion Harness Bridge Component</string>
+<key>CFBundleExecutable</key><string>HotionHarnessStatus</string>
+<key>CFBundlePackageType</key><string>APPL</string>
+<key>CFBundleVersion</key><string>1</string>
+<key>CFBundleShortVersionString</key><string>1.0</string>
+<key>LSUIElement</key><true/>
+</dict></plist>

package/resources/HotionHarnessStatus.app/Contents/Resources/en.lproj/InfoPlist.strings

@@ -0,0 +1,2 @@
+"CFBundleDisplayName" = "Motion Harness Bridge Component";
+"CFBundleName" = "Motion Harness Bridge Component";

package/resources/HotionHarnessStatus.app/Contents/Resources/zh-Hans.lproj/InfoPlist.strings

@@ -0,0 +1,2 @@
+"CFBundleDisplayName" = "Motion Harness 桥接组件";
+"CFBundleName" = "Motion Harness 桥接组件";

package/resources/legacy-forwarder.lua

@@ -0,0 +1,55 @@
+-- Motion Harness legacy entry forwarder v1
+-- Explicit button callbacks only; image evaluation never executes this file.
+local helper, config, workspace = @@HELPER@@, @@CONFIG@@, @@WORKSPACE@@
+local function quote(value)
+    return "'" .. tostring(value):gsub("'", "'\\''") .. "'"
+end
+local function json_string(value)
+    assert(type(value) == 'string', 'Missing legacy entry identity')
+    return '"' .. value:gsub('[%z\1-\31\\"]', function(c)
+        if c == '\\' then return '\\\\' end
+        if c == '"' then return '\\"' end
+        return string.format('\\u%04x', string.byte(c))
+    end) .. '"'
+end
+local function clicked_target()
+    local application = Resolve()
+    local manager = application and application:GetProjectManager()
+    local project = manager and manager:GetCurrentProject()
+    local timeline = project and project:GetCurrentTimeline()
+    assert(timeline and not project:IsRenderingInProgress())
+    local video = nil
+    for _, item in ipairs(timeline:GetSelectedClips() or {}) do
+        if string.lower(item:GetType() or '') == 'video' then assert(video == nil); video = item end
+    end
+    assert(video)
+    return { projectId = project:GetUniqueId(), timelineId = timeline:GetUniqueId(), itemId = video:GetUniqueId() }
+end
+return function(request)
+    local ok, clicked = pcall(clicked_target)
+    local again_ok, again = pcall(clicked_target)
+    ok = ok and again_ok and clicked.projectId == again.projectId
+        and clicked.timelineId == again.timelineId and clicked.itemId == again.itemId
+        and type(request) == 'table' and (request.action == 'edit' or request.action == 'more')
+    if ok then
+        for _, key in ipairs({'workspaceKey', 'sourceId', 'bindingId'}) do
+            if type(request[key]) ~= 'string' or request[key] == '' then ok = false end
+        end
+    end
+    local action, payload = 'legacy', nil
+    if ok then
+        local fields = {'"workspace":' .. json_string(workspace)}
+        for _, key in ipairs({'action', 'workspaceKey', 'sourceId', 'bindingId'}) do
+            fields[#fields + 1] = json_string(key) .. ':' .. json_string(request[key])
+        end
+        fields[#fields + 1] = '"clicked":{"projectId":' .. json_string(clicked.projectId)
+            .. ',"timelineId":' .. json_string(clicked.timelineId) .. ',"itemId":' .. json_string(clicked.itemId) .. '}'
+        payload = '{' .. table.concat(fields, ',') .. '}'
+    else
+        action = 'error'
+        payload = '{"workspace":' .. json_string(workspace)
+            .. ',"code":"SELECTION_UNAVAILABLE","message":"无法确认当前所选片段，请只选择一个 Motion Harness 片段后重试。"}'
+    end
+    os.execute(quote(helper) .. ' --config ' .. quote(config) .. ' --action ' .. quote(action)
+        .. ' --request ' .. quote(payload) .. ' >/dev/null 2>&1 &')
+end

package/resources/legacy-inspector-v1.lua

@@ -0,0 +1,31 @@
+-- MH Resolve Bridge inspector v1
+-- Called only by an explicit Inspector button. Nothing executes during rendering.
+local node, cli, workspace = @@NODE@@, @@CLI@@, @@WORKSPACE@@
+local mh, node_dir = @@MH@@, @@NODE_DIR@@
+
+local function quote(value)
+    return "'" .. tostring(value):gsub("'", "'\\''") .. "'"
+end
+
+local function json_string(value)
+    assert(type(value) == 'string', 'Hotion Harness Bridge: missing Inspector identity')
+    return '"' .. value:gsub('[%z\1-\31\\"]', function(c)
+        if c == '\\' then return '\\\\' end
+        if c == '"' then return '\\"' end
+        return string.format('\\u%04x', string.byte(c))
+    end) .. '"'
+end
+
+return function(request)
+    assert(type(request) == 'table', '请从 Hotion Harness Bridge 检查器按钮打开。')
+    assert(request.action == 'edit' or request.action == 'more', 'Hotion Harness Bridge: unknown action')
+    local fields = {}
+    for _, key in ipairs({'action', 'workspaceKey', 'sourceId', 'bindingId'}) do
+        fields[#fields + 1] = json_string(key) .. ':' .. json_string(request[key])
+    end
+    local payload = '{' .. table.concat(fields, ',') .. '}'
+    local command = 'PATH=' .. quote(node_dir) .. ':"$PATH" MH_BRIDGE_MH=' .. quote(mh) .. ' ' .. quote(node) .. ' ' .. quote(cli) .. ' inspector-action --workspace ' .. quote(workspace) .. ' --json ' .. quote(payload)
+    -- The controller opens public MH or the Bridge window. This UI callback
+    -- never waits on Resolve or MH, and never renders/synchronizes a video.
+    os.execute(command .. ' >/dev/null 2>&1 &')
+end

package/resources/menu-entry.py

@@ -0,0 +1,164 @@
+"""Installed menu: snapshot the selected video, then use the public CLI."""
+
+import json
+import hashlib
+import os
+import subprocess
+import sys
+import uuid
+from pathlib import Path
+
+
+_translations = {}
+
+
+def tr(source):
+    return _translations.get(source, source)
+
+
+class SelectionError(Exception):
+    def __init__(self, code, message):
+        super().__init__(message)
+        self.code = code
+
+
+def command_environment(config):
+    environment = dict(os.environ)
+    tools = config.get("tools") if isinstance(config.get("tools"), dict) else {}
+    paths = {name: path for name, path in tools.items()
+             if name in {"node", "pnpm", "ffmpeg", "ffprobe"}
+             and isinstance(path, str) and os.path.isabs(path)}
+    allowed = list(dict.fromkeys(os.path.dirname(path) for path in paths.values()))
+    preferred = config.get("toolDirectories")
+    preferred = preferred if isinstance(preferred, list) else []
+    directories = list(dict.fromkeys([value for value in preferred if value in allowed] + allowed))
+    if directories:
+        environment["PATH"] = os.pathsep.join(directories + [environment.get("PATH", "/usr/bin:/bin")])
+    for name in ("ffmpeg", "ffprobe"):
+        if name in paths:
+            environment["MH_" + name.upper()] = paths[name]
+    bridge_directory = config.get("bridgeDirectory")
+    if isinstance(bridge_directory, str) and os.path.isabs(bridge_directory):
+        environment["MH_BRIDGE_DIR"] = bridge_directory
+    environment["MH_UI_LOCALE"] = os.environ.get("MH_UI_LOCALE", config.get("locale", "zh-CN"))
+    return environment
+
+
+def selected_target(application, management=False):
+    if not application:
+        raise SelectionError("RESOLVE_UNAVAILABLE", tr("达芬奇尚未连接。请打开工程后重试。"))
+    manager = application.GetProjectManager()
+    project = manager.GetCurrentProject()
+    timeline = project.GetCurrentTimeline() if project else None
+    if not timeline:
+        raise SelectionError("NO_TIMELINE", tr("请打开时间线并选择一个 Motion Harness 片段。"))
+    if project.IsRenderingInProgress():
+        raise SelectionError("RESOLVE_BUSY", tr("达芬奇正在导出，请完成后重试。"))
+    selected = timeline.GetSelectedClips() or []
+    identifiers = sorted(item.GetUniqueId() for item in selected)
+    videos = [item for item in selected if item.GetType().lower() == "video"]
+    if len(videos) != 1:
+        raise SelectionError("SELECTION_AMBIGUOUS", tr("请只选择一个 Motion Harness 视频片段。"))
+    media = videos[0].GetMediaPoolItem()
+    if not media:
+        raise SelectionError("NOT_PLAIN_MEDIA", tr("所选片段没有普通视频素材。请先转换旧版生成器。"))
+    encoded = (media.GetThirdPartyMetadata() or {}).get("motionharness.bridge") if media else None
+    try:
+        link = json.loads(encoded) if isinstance(encoded, str) else None
+    except (ValueError, TypeError):
+        link = None
+    linked = isinstance(link, dict) and link.get("schemaVersion") == 1 and all(
+        isinstance(link.get(key), str) and link[key] for key in ("bindingId", "sourceId", "artifactId")
+    )
+    if not linked and not management:
+        raise SelectionError("NOT_LINKED", tr("所选视频未关联 Motion Harness 工程。"))
+    database = manager.GetCurrentDatabase() if management else None
+    if management and (not isinstance(database, dict) or not database):
+        raise SelectionError("SCOPE_UNAVAILABLE", tr("无法确认当前工程位置，请检查达芬奇连接。"))
+    current = manager.GetCurrentProject()
+    active = current.GetCurrentTimeline() if current else None
+    if not current or current.GetUniqueId() != project.GetUniqueId() or not active or active.GetUniqueId() != timeline.GetUniqueId() or sorted(
+        item.GetUniqueId() for item in (active.GetSelectedClips() or [])
+    ) != identifiers:
+        raise SelectionError("SELECTION_CHANGED", tr("所选片段已改变，请重新点击。"))
+    if management:
+        if manager.GetCurrentDatabase() != database:
+            raise SelectionError("SELECTION_CHANGED", tr("当前工程位置已改变，请重新点击。"))
+        database_id = "sha256:" + hashlib.sha256(json.dumps(database, sort_keys=True, separators=(",", ":"), ensure_ascii=False).encode()).hexdigest()
+        return {"selection": {"scope": {"databaseId": database_id, "projectId": project.GetUniqueId()},
+                "timelineId": timeline.GetUniqueId(), "itemId": videos[0].GetUniqueId(), "mediaPoolItemId": media.GetUniqueId(),
+                **({key: link[key] for key in ("bindingId", "sourceId", "artifactId")} if linked else {})}}
+    return {"bindingId": link["bindingId"], "selection": {
+        "projectId": project.GetUniqueId(), "mediaPoolItemId": media.GetUniqueId(),
+        "sourceId": link["sourceId"], "artifactId": link["artifactId"]}}
+
+
+def resolve_application():
+    application = globals().get("resolve")
+    if application:
+        return application
+    try:
+        import DaVinciResolveScript
+    except ImportError:
+        # Installed SDK locations, as documented by the Resolve scripting API.
+        sdk = "/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules"
+        if sys.platform == "darwin" and sdk not in sys.path:
+            sys.path.append(sdk)
+        import DaVinciResolveScript
+    return DaVinciResolveScript.scriptapp("Resolve")
+
+
+def main():
+    config_path = Path(__HOTION_CONFIG_PATH_JSON__)
+    status_path = Path(__HOTION_STATUS_PATH_JSON__)
+    action = __HOTION_ACTION_JSON__
+    global _translations
+    _translations = {}
+    repair = None
+    try:
+        config = json.loads(config_path.read_text(encoding="utf-8"))
+        if not isinstance(config, dict):
+            raise ValueError("invalid config")
+    except (OSError, ValueError, TypeError):
+        config = {}
+        repair = tr("桥接安装配置缺失或损坏，请运行 mh bridge davinci install 修复组件。")
+    if os.environ.get("MH_UI_LOCALE", config.get("locale", "zh-CN")).startswith("en"):
+        try:
+            translations = json.loads(Path(config["translationsPath"]).read_text(encoding="utf-8"))
+            if isinstance(translations, dict):
+                _translations = translations
+        except (OSError, ValueError, TypeError, KeyError):
+            pass
+    if not status_path.is_absolute() or not status_path.is_file() or not os.access(status_path, os.X_OK):
+        raise RuntimeError(tr("缺少 Motion Harness 状态窗口，请运行 mh bridge davinci install 修复组件。"))
+    # The shared helper resolves the installed CLI launcher. Checking the old
+    # platform-binary path here would incorrectly reject a completed npm upgrade.
+    request = {}
+    if isinstance(config.get("workspace"), str):
+        request["workspace"] = config["workspace"]
+    if repair:
+        action = "error"
+        request.update(code="INSTALL_MISSING", message=repair)
+    else:
+        try:
+            request.update(selected_target(resolve_application(), management=action == "manage"))
+        except SelectionError as error:
+            action = "error"
+            request.update(code=error.code, message=str(error))
+        except (ImportError, AttributeError, RuntimeError):
+            action = "error"
+            request.update(code="SELECTION_UNAVAILABLE", message=tr("无法读取所选片段，请检查达芬奇脚本连接。"))
+    if action == "update":
+        request["idempotencyKey"] = str(uuid.uuid4())
+    arguments = [str(status_path), "--config", str(config_path), "--action", action,
+                 "--request", json.dumps(request, ensure_ascii=False)]
+    subprocess.Popen(arguments, stdin=subprocess.DEVNULL,
+                     stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,
+                     env=command_environment(config), close_fds=True, start_new_session=True)
+    print(request["message"] if action == "error" else tr("正在打开 Motion Harness 工程…") if action == "edit" else
+          tr("正在读取所选 Motion Harness 片段…") if action == "manage" else
+          tr("正在提交 Motion Harness 请求，状态窗口将显示进度。"))
+
+
+if __name__ == "__main__":
+    main()

package/resources/sidebar-help/en.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>Motion Harness Bridge Component · Add the sidebar editing entry</title>
+<style>
+:root{color-scheme:dark;font:15px/1.7 system-ui,-apple-system,sans-serif;color:#eee;background:#191a1e}*{box-sizing:border-box}body{max-width:960px;margin:auto;padding:32px 24px}h1{font-size:26px;line-height:1.3;margin:0 0 12px}p{color:#c9cad2}li{margin:14px 0}strong{color:#fff}code,kbd{font:inherit;background:#303139;border-radius:5px;padding:2px 6px}.diagram{display:grid;grid-template-columns:1fr 1fr;gap:16px;padding:20px;background:#22242b;border:1px solid #555661;border-radius:10px}.panel{border:1px solid #51545f;border-radius:6px;padding:16px}.panel h2{font-size:15px;margin:0 0 12px}.search,.effect{padding:8px 10px;margin:8px 0;background:#30333e;border-radius:5px}.effect{border-left:3px solid #81aaff}.timeline{grid-column:1/-1;border-top:1px solid #50535f;padding-top:14px}.clip{background:#36496e;border:1px solid #81aaff;border-radius:5px;padding:12px}.caption{font-size:13px}aside{border-top:1px solid #40414b;margin-top:24px;padding-top:12px}@media(max-width:600px){body{padding:20px 16px}.diagram{grid-template-columns:1fr}.timeline{grid-column:auto}}
+</style>
+<h1>Add the sidebar editing entry</h1><p>The media sent through the bridge is already linked to its source project. Adding this optional effect does not render the video again.</p>
+<ol><li>On the <strong>Edit</strong> page in DaVinci Resolve, open the <strong>Effects Library</strong> (magic wand icon).</li><li>Search for <strong>Motion Harness Bridge Component</strong> and drag the Open FX effect onto the target animation clip.</li><li>Select the clip and click <strong>Edit Motion Harness project</strong> under <strong>Inspector → Effects → Open FX</strong>.</li></ol>
+<div class="diagram" role="img" aria-label="Illustration: Effects Library, inspector and target clip">
+<section class="panel"><h2>① Effects Library</h2><div class="search">⌕ Motion Harness</div><div class="effect">② Motion Harness Bridge Component</div></section>
+<section class="panel"><h2>Inspector → Effects → Open FX</h2><div class="effect">Edit Motion Harness project</div><p>Update this media · Check status · More…</p></section>
+<div class="timeline"><div class="clip">③ Target animation clip · Add the effect here</div></div></div>
+<p class="caption">Layout illustration. Labels follow the language selected when installing the component. Search for “Motion Harness” in either language.</p><aside><p><strong>Shortcut:</strong> Select the clip, press <kbd>Shift</kbd> + <kbd>Space</kbd>, and search for Motion Harness. If your shortcuts are customized, use the Effects Library.</p><p><strong>Cannot find the effect?</strong> Install the Motion Harness Bridge Component with <code>mh bridge davinci install</code>. Save your project and restart DaVinci Resolve after installation.</p><p><strong>Menu alternative:</strong> Workspace → Scripts → Utility → Motion Harness Bridge Component → Edit project. Clips with the effect already attached do not need it added again.</p></aside>
+</html>

package/resources/sidebar-help/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="zh-CN">
+<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>Motion Harness 桥接组件 · 添加侧栏编辑入口</title>
+<style>
+:root{color-scheme:dark;font:15px/1.7 system-ui,-apple-system,sans-serif;color:#eee;background:#191a1e}*{box-sizing:border-box}body{max-width:960px;margin:auto;padding:32px 24px}h1{font-size:26px;line-height:1.3;margin:0 0 12px}p{color:#c9cad2}li{margin:14px 0}strong{color:#fff}code,kbd{font:inherit;background:#303139;border-radius:5px;padding:2px 6px}.diagram{display:grid;grid-template-columns:1fr 1fr;gap:16px;padding:20px;background:#22242b;border:1px solid #555661;border-radius:10px}.panel{border:1px solid #51545f;border-radius:6px;padding:16px}.panel h2{font-size:15px;margin:0 0 12px}.search,.effect{padding:8px 10px;margin:8px 0;background:#30333e;border-radius:5px}.effect{border-left:3px solid #81aaff}.timeline{grid-column:1/-1;border-top:1px solid #50535f;padding-top:14px}.clip{background:#36496e;border:1px solid #81aaff;border-radius:5px;padding:12px}.caption{font-size:13px}aside{border-top:1px solid #40414b;margin-top:24px;padding-top:12px}@media(max-width:600px){body{padding:20px 16px}.diagram{grid-template-columns:1fr}.timeline{grid-column:auto}}
+</style>
+<h1>添加侧栏编辑入口</h1><p>通过桥接发送的素材已关联源工程。添加这个可选效果不会重新导出视频。</p>
+<ol><li>进入达芬奇的<strong>「剪辑」页</strong>，打开左上角的<strong>「特效库」</strong>（魔棒图标）。</li><li>搜索 <strong>Motion Harness 桥接组件</strong>，将 Open FX 中的同名效果拖到时间线上的目标动效片段。</li><li>选中片段，在<strong>「检查器 → 特效 → Open FX」</strong>中点击<strong>「编辑 Motion Harness 工程」</strong>。</li></ol>
+<div class="diagram" role="img" aria-label="特效库、检查器和目标片段的布局示意">
+<section class="panel"><h2>① 特效库</h2><div class="search">⌕ Motion Harness</div><div class="effect">② Motion Harness 桥接组件</div></section>
+<section class="panel"><h2>检查器 → 特效 → Open FX</h2><div class="effect">编辑 Motion Harness 工程</div><p>更新此素材 · 查看状态 · 更多…</p></section>
+<div class="timeline"><div class="clip">③ 目标动效片段 · 将效果拖到这里</div></div></div>
+<p class="caption">布局示意图。名称按组件安装时的语言显示；中英文均可搜索“Motion Harness”。</p><aside><p><strong>快捷方式：</strong>选中片段，按 <kbd>Shift</kbd> + <kbd>Space</kbd>，搜索 Motion Harness 并添加。快捷键被自定义时，请使用特效库。</p><p><strong>找不到效果？</strong>先安装 Motion Harness 桥接组件：<code>mh bridge davinci install</code>。安装完成后保存工程并重启达芬奇。</p><p><strong>也可以使用菜单：</strong>工作区 → 脚本 → Utility → Motion Harness 桥接组件 → 编辑工程。已经添加过效果的片段无需重复添加。</p></aside>
+</html>