How vark-debug/rocx works
RocX is a Premiere Pro UXP panel for generating MiniMax videos from prompts and optional project references, then previewing and managing results in Premiere. The main flow runs from the Webview through a Comlink bridge to UXP APIs; generation is handled in the Webview, while capture, file operations, persistence, and project import run in the host. The README also documents frame/work-area capture, record management, and optional webhook reporting. Some subsystem links are based on indexed references or README descriptions because their source was not excerpted.
Main entry points: api.ts Host API · main-webview.vue Panel composition · bridge.ts Host API bridge · useGenerationTasks.ts Generation lifecycle
Components 28
Panel UI
- Panel composition
webview-ui/src/main-webview.vue - Prompt and settings
webview-ui/src/components/PromptInput.vue - Reference controls
webview-ui/src/composables/useReferences.ts - Record management
webview-ui/src/composables/useRecordActions.ts - Result preview
webview-ui/src/composables/useRecordPreview.ts - Host API bridge
webview-ui/src/services/bridge.ts
Video generation
- Generation lifecycle
webview-ui/src/composables/useGenerationTasks.ts - Task polling
webview-ui/src/composables/usePolling.ts - MiniMax API service
webview-ui/src/services/MiniMax.ts - Provider registry
webview-ui/src/providers/core/registry.ts - MiniMax provider
webview-ui/src/providers/minimax/MiniMaxProvider.ts
Premiere host
- UXP Webview host
src/webview-setup-host.ts - Host API
src/api/api.ts - Frame capture
src/core/frames.ts - Work-area capture
src/core/captureVideo.ts - Timeline import
src/core/timeline.ts - Project state
src/core/project.ts
Files and records
- File operations
src/core/files.ts - Generation records
src/core/records.ts - Settings storage
src/core/storage.ts
External services
- Reference upload
src/core/ai/upload.ts - UXP AI provider
src/core/ai/providers/minimax/MiniMaxUxPProvider.ts - Result download
src/core/ai/download.ts - Webhook reporting
src/core/webhook.ts
Other components
- Premiere user
- MiniMax service
- Premiere Pro
- Webhook destination
Connections 38
- Premiere user → Panel composition: uses
README.md - Panel composition → Prompt and settings: renders
webview-ui/src/main-webview.vue - Panel composition → Reference controls: uses
webview-ui/src/main-webview.vue - Panel composition → Generation lifecycle: uses
webview-ui/src/main-webview.vue - Panel composition → Record management: uses
webview-ui/src/main-webview.vue - Panel composition → Result preview: uses
webview-ui/src/main-webview.vue - Reference controls → Host API bridge: calls
webview-ui/src/composables/useReferences.ts - Record management → Host API bridge: calls
webview-ui/src/composables/useRecordActions.ts - Result preview → Host API bridge: calls
webview-ui/src/composables/useRecordPreview.ts - Generation lifecycle → MiniMax API service: submits tasks
webview-ui/src/composables/useGenerationTasks.ts - Generation lifecycle → Task polling: starts polling
webview-ui/src/composables/useGenerationTasks.ts - Generation lifecycle → Host API bridge: imports results
webview-ui/src/composables/useGenerationTasks.ts - Task polling → MiniMax API service: queries tasks
webview-ui/src/composables/usePolling.ts - MiniMax API service → Provider registry: selects provider
webview-ui/src/services/MiniMax.ts - Provider registry → MiniMax provider: registers
webview-ui/src/providers/core/registry.ts - MiniMax provider → MiniMax service: sends requests
webview-ui/src/providers/minimax/MiniMaxProvider.ts - UXP Webview host → Host API: exposes API
src/webview-setup-host.ts - UXP Webview host → Host API bridge: bridges calls
- Host API bridge → Host API: forwards calls
- Host API → Settings storage: reads settings
src/api/api.ts - Host API → Generation records: reads and writes
src/api/api.ts - Host API → File operations: handles files
src/api/api.ts - Host API → Frame capture: captures frames
src/api/api.ts - Host API → Work-area capture: captures work area
src/api/api.ts - Host API → Timeline import: imports to timeline
src/api/api.ts - Host API → Project state: queries project
src/api/api.ts - Host API → Webhook reporting: reports results
src/api/api.ts - Frame capture → File operations: writes capture
src/core/frames.ts - Frame capture → Reference upload: uploads capture
src/core/frames.ts - Reference upload → UXP AI provider: delegates upload
src/core/ai/upload.ts - UXP AI provider → File operations: uses file access
src/core/ai/providers/minimax/MiniMaxUxPProvider.ts - Timeline import → Premiere Pro: inserts media
README.md - File operations → Project state: stores project media
README.md - Generation lifecycle → Result download: downloads results
- Webhook reporting → Settings storage: reads configuration
src/core/webhook.ts - Webhook reporting → Project state: gets project details
src/core/webhook.ts - Webhook reporting → Webhook destination: posts report
src/core/webhook.ts - MiniMax API service → MiniMax service: requests generation
webview-ui/src/services/MiniMax.ts