@morshoto/framekit 0.2.2 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (156) hide show
  1. package/dist-package/adapters/final-cut/typescript/src/analyzers.d.ts +58 -0
  2. package/dist-package/adapters/final-cut/typescript/src/analyzers.js +52 -13
  3. package/dist-package/adapters/final-cut/typescript/src/assets.d.ts +24 -0
  4. package/dist-package/adapters/final-cut/typescript/src/background-export.d.ts +98 -0
  5. package/dist-package/adapters/final-cut/typescript/src/background-materialization.d.ts +47 -0
  6. package/dist-package/adapters/final-cut/typescript/src/canonical-recovery-guard.d.ts +32 -0
  7. package/dist-package/adapters/final-cut/typescript/src/canonical-recovery.d.ts +22 -0
  8. package/dist-package/adapters/final-cut/typescript/src/canonical-verification.d.ts +11 -0
  9. package/dist-package/adapters/final-cut/typescript/src/canonical.d.ts +184 -0
  10. package/dist-package/adapters/final-cut/typescript/src/canonical.js +33 -1
  11. package/dist-package/adapters/final-cut/typescript/src/connection.d.ts +103 -0
  12. package/dist-package/adapters/final-cut/typescript/src/disposable-native.d.ts +90 -0
  13. package/dist-package/adapters/final-cut/typescript/src/documents.d.ts +3 -0
  14. package/dist-package/adapters/final-cut/typescript/src/documents.js +3 -0
  15. package/dist-package/adapters/final-cut/typescript/src/experimental.d.ts +8 -0
  16. package/dist-package/adapters/final-cut/typescript/src/export.d.ts +125 -0
  17. package/dist-package/adapters/final-cut/typescript/src/fcpxml-console-experiment.d.ts +54 -0
  18. package/dist-package/adapters/final-cut/typescript/src/fcpxml.d.ts +75 -0
  19. package/dist-package/adapters/final-cut/typescript/src/fcpxml.js +6 -1
  20. package/dist-package/adapters/final-cut/typescript/src/index.d.ts +22 -0
  21. package/dist-package/adapters/final-cut/typescript/src/library-inspection.d.ts +101 -0
  22. package/dist-package/adapters/final-cut/typescript/src/live.d.ts +101 -0
  23. package/dist-package/adapters/final-cut/typescript/src/live.js +8 -0
  24. package/dist-package/adapters/final-cut/typescript/src/media.d.ts +12 -0
  25. package/dist-package/adapters/final-cut/typescript/src/native-operation.d.ts +6 -0
  26. package/dist-package/adapters/final-cut/typescript/src/native-recovery-inspection.d.ts +77 -0
  27. package/dist-package/adapters/final-cut/typescript/src/native-session.d.ts +130 -0
  28. package/dist-package/adapters/final-cut/typescript/src/native.d.ts +828 -0
  29. package/dist-package/adapters/final-cut/typescript/src/native.js +274 -107
  30. package/dist-package/adapters/final-cut/typescript/src/pasteboard-snapshot.d.ts +114 -0
  31. package/dist-package/adapters/final-cut/typescript/src/publish-readback.d.ts +26 -0
  32. package/dist-package/adapters/final-cut/typescript/src/publish-readback.js +18 -2
  33. package/dist-package/adapters/final-cut/typescript/src/publisher.d.ts +215 -0
  34. package/dist-package/adapters/final-cut/typescript/src/session.d.ts +43 -0
  35. package/dist-package/adapters/final-cut/typescript/src/shadow-mutation.d.ts +51 -0
  36. package/dist-package/adapters/final-cut/typescript/src/sqlite-experiment.d.ts +156 -0
  37. package/dist-package/adapters/final-cut/typescript/src/sqlite-inspection.d.ts +134 -0
  38. package/dist-package/adapters/final-cut/typescript/src/sqlite-materialization.d.ts +110 -0
  39. package/dist-package/adapters/final-cut/typescript/src/sqlite-wal-observation.d.ts +132 -0
  40. package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.d.ts +61 -0
  41. package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.js +28 -4
  42. package/dist-package/adapters/final-cut/typescript/src/unattended-editing.d.ts +54 -0
  43. package/dist-package/adapters/headless/typescript/src/audio-output.d.ts +3 -0
  44. package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.d.ts +11 -0
  45. package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.js +26 -2
  46. package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.d.ts +25 -0
  47. package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.js +5 -0
  48. package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.d.ts +15 -0
  49. package/dist-package/adapters/headless/typescript/src/index.d.ts +3 -0
  50. package/dist-package/apps/cli/src/dev-doctor.d.ts +25 -0
  51. package/dist-package/apps/cli/src/headless-projects.d.ts +3 -0
  52. package/dist-package/apps/cli/src/main.d.ts +10 -0
  53. package/dist-package/apps/mcp-server/runtime/ffmpeg-audio-backend.py +129 -0
  54. package/dist-package/apps/mcp-server/runtime/whisper-speech-backend.py +92 -2
  55. package/dist-package/apps/mcp-server/src/build-alignment.d.ts +10 -0
  56. package/dist-package/apps/mcp-server/src/build-identity.d.ts +7 -0
  57. package/dist-package/apps/mcp-server/src/build-identity.json +2 -2
  58. package/dist-package/apps/mcp-server/src/canonical-native-snapshot.d.ts +8 -0
  59. package/dist-package/apps/mcp-server/src/final-cut-runtime-config.d.ts +5 -0
  60. package/dist-package/apps/mcp-server/src/headless-project-snapshot.d.ts +3 -0
  61. package/dist-package/apps/mcp-server/src/headless-sessions.d.ts +89 -0
  62. package/dist-package/apps/mcp-server/src/main.d.ts +1 -0
  63. package/dist-package/apps/mcp-server/src/materialization-jobs.d.ts +204 -0
  64. package/dist-package/apps/mcp-server/src/readback-policy.d.ts +18 -0
  65. package/dist-package/apps/mcp-server/src/routing.d.ts +90 -0
  66. package/dist-package/apps/mcp-server/src/server.d.ts +75 -0
  67. package/dist-package/apps/mcp-server/src/server.js +77 -7
  68. package/dist-package/apps/mcp-server/src/tools/skills/catalog.d.ts +19 -0
  69. package/dist-package/apps/mcp-server/src/tools/skills/metadata.d.ts +37 -0
  70. package/dist-package/apps/mcp-server/src/tools/skills/register.d.ts +11 -0
  71. package/dist-package/apps/mcp-server/src/version.d.ts +4 -0
  72. package/dist-package/packages/headless-application/src/external-edit.d.ts +30 -0
  73. package/dist-package/packages/headless-application/src/external-edit.js +72 -0
  74. package/dist-package/packages/headless-application/src/headless-projects.d.ts +233 -0
  75. package/dist-package/packages/headless-application/src/headless-projects.js +1 -1
  76. package/dist-package/packages/headless-application/src/index.d.ts +2 -0
  77. package/dist-package/packages/headless-application/src/index.js +1 -0
  78. package/dist-package/packages/runtime/src/application/duration-policy-service.d.ts +4 -0
  79. package/dist-package/packages/runtime/src/application/local-media.d.ts +46 -0
  80. package/dist-package/packages/runtime/src/application/media-analysis-service.d.ts +40 -0
  81. package/dist-package/packages/runtime/src/application/media-analysis-service.js +105 -15
  82. package/dist-package/packages/runtime/src/application/project-service.d.ts +35 -0
  83. package/dist-package/packages/runtime/src/application/project-store.d.ts +56 -0
  84. package/dist-package/packages/runtime/src/application/project-transactions.d.ts +51 -0
  85. package/dist-package/packages/runtime/src/application/runtime-options.d.ts +15 -0
  86. package/dist-package/packages/runtime/src/application/semantic-media-index-store.d.ts +28 -0
  87. package/dist-package/packages/runtime/src/application/transaction-store.d.ts +10 -0
  88. package/dist-package/packages/runtime/src/audio/analysis.d.ts +3 -0
  89. package/dist-package/packages/runtime/src/audio/analysis.js +95 -0
  90. package/dist-package/packages/runtime/src/audio/dialogue-normalization.d.ts +47 -0
  91. package/dist-package/packages/runtime/src/audio/noise-reduction.d.ts +34 -0
  92. package/dist-package/packages/runtime/src/capabilities.d.ts +45 -0
  93. package/dist-package/packages/runtime/src/color-correction.d.ts +33 -0
  94. package/dist-package/packages/runtime/src/context/context-engine.d.ts +28 -0
  95. package/dist-package/packages/runtime/src/context/context-service.d.ts +20 -0
  96. package/dist-package/packages/runtime/src/context/project-catalog.d.ts +12 -0
  97. package/dist-package/packages/runtime/src/context/revision.d.ts +2 -0
  98. package/dist-package/packages/runtime/src/domain/capabilities.d.ts +170 -0
  99. package/dist-package/packages/runtime/src/domain/context.d.ts +179 -0
  100. package/dist-package/packages/runtime/src/domain/diff.d.ts +104 -0
  101. package/dist-package/packages/runtime/src/domain/duration.d.ts +63 -0
  102. package/dist-package/packages/runtime/src/domain/editing.d.ts +227 -0
  103. package/dist-package/packages/runtime/src/domain/incremental-sync.d.ts +67 -0
  104. package/dist-package/packages/runtime/src/domain/index.d.ts +14 -0
  105. package/dist-package/packages/runtime/src/domain/media.d.ts +406 -0
  106. package/dist-package/packages/runtime/src/domain/ports.d.ts +62 -0
  107. package/dist-package/packages/runtime/src/domain/primitives.d.ts +21 -0
  108. package/dist-package/packages/runtime/src/domain/project.d.ts +119 -0
  109. package/dist-package/packages/runtime/src/domain/rough-cut.d.ts +27 -0
  110. package/dist-package/packages/runtime/src/domain/skills.d.ts +145 -0
  111. package/dist-package/packages/runtime/src/domain/timeline-target.d.ts +57 -0
  112. package/dist-package/packages/runtime/src/domain/timeline-target.js +19 -1
  113. package/dist-package/packages/runtime/src/domain/types.d.ts +5 -0
  114. package/dist-package/packages/runtime/src/domain/verification.d.ts +92 -0
  115. package/dist-package/packages/runtime/src/editing/dialogue-normalization-service.d.ts +18 -0
  116. package/dist-package/packages/runtime/src/editing/duration-policy.d.ts +3 -0
  117. package/dist-package/packages/runtime/src/editing/edit-service.d.ts +44 -0
  118. package/dist-package/packages/runtime/src/editing/filler-removal-service.d.ts +23 -0
  119. package/dist-package/packages/runtime/src/editing/intent.d.ts +97 -0
  120. package/dist-package/packages/runtime/src/editing/music-service.d.ts +9 -0
  121. package/dist-package/packages/runtime/src/index.d.ts +32 -0
  122. package/dist-package/packages/runtime/src/index.js +1 -0
  123. package/dist-package/packages/runtime/src/planning/rough-cut.d.ts +3 -0
  124. package/dist-package/packages/runtime/src/render/render-and-verify.d.ts +71 -0
  125. package/dist-package/packages/runtime/src/render/render-contract.d.ts +96 -0
  126. package/dist-package/packages/runtime/src/runtime.d.ts +85 -0
  127. package/dist-package/packages/runtime/src/skills/builtin.d.ts +2 -0
  128. package/dist-package/packages/runtime/src/skills/index.d.ts +3 -0
  129. package/dist-package/packages/runtime/src/skills/registry.d.ts +10 -0
  130. package/dist-package/packages/runtime/src/skills/requirements.d.ts +38 -0
  131. package/dist-package/packages/runtime/src/skills/runtime.d.ts +38 -0
  132. package/dist-package/packages/runtime/src/speech/analysis.d.ts +18 -0
  133. package/dist-package/packages/runtime/src/speech/analysis.js +67 -0
  134. package/dist-package/packages/runtime/src/speech/filler-detector.d.ts +49 -0
  135. package/dist-package/packages/runtime/src/speech/filler-removal.d.ts +37 -0
  136. package/dist-package/packages/runtime/src/speech/mapping.d.ts +56 -0
  137. package/dist-package/packages/runtime/src/speech/mapping.js +27 -4
  138. package/dist-package/packages/runtime/src/speech/safe-cut-resolver.d.ts +52 -0
  139. package/dist-package/packages/runtime/src/timeline/drift-reconciliation.d.ts +42 -0
  140. package/dist-package/packages/runtime/src/timeline/editing-session.d.ts +271 -0
  141. package/dist-package/packages/runtime/src/timeline/editing-session.js +32 -2
  142. package/dist-package/packages/runtime/src/timeline/fast-observation.d.ts +77 -0
  143. package/dist-package/packages/runtime/src/timeline/rational-time.d.ts +11 -0
  144. package/dist-package/packages/runtime/src/timeline/reorder-preview.d.ts +32 -0
  145. package/dist-package/packages/runtime/src/timeline/reorder-preview.js +202 -0
  146. package/dist-package/packages/runtime/src/timeline/snapshot-diff.d.ts +3 -0
  147. package/dist-package/packages/runtime/src/timeline/snapshot-diff.js +1 -0
  148. package/dist-package/packages/runtime/src/timeline/snapshot-digest.d.ts +3 -0
  149. package/dist-package/packages/runtime/src/timeline/snapshot-digest.js +1 -1
  150. package/dist-package/packages/runtime/src/verification/verification.d.ts +6 -0
  151. package/dist-package/packages/testkit/src/fixture-analyzers.d.ts +37 -0
  152. package/dist-package/packages/testkit/src/in-memory-editor.d.ts +55 -0
  153. package/dist-package/packages/testkit/src/index.d.ts +4 -0
  154. package/dist-package/packages/testkit/src/sender-lifecycle-fixture.d.ts +47 -0
  155. package/dist-package/packages/testkit/src/skill-fixtures.d.ts +3 -0
  156. package/package.json +17 -12
@@ -0,0 +1,828 @@
1
+ import type { ContextRevision, EditorAsset, EditorLiveState, PictureInPictureCrop, PictureInPictureFrame, PictureInPicturePosition, RationalTime, TimelineTarget } from "../../../../packages/runtime/src/index.js";
2
+ import type { NativeOperationLease } from "./native-operation.js";
3
+ export type NativeFinalCutEdit = {
4
+ type: "rename-selected-clip";
5
+ name: string;
6
+ } | {
7
+ type: "trim-selected-clip-to-playhead";
8
+ edge: "start" | "end";
9
+ } | {
10
+ type: "set-selected-clip-gain";
11
+ gainDb: number;
12
+ } | {
13
+ type: "add-marker-at-playhead";
14
+ name: string;
15
+ duration?: number;
16
+ };
17
+ export interface NativeFinalCutMediaMatch {
18
+ handle: string;
19
+ name: string;
20
+ role?: string;
21
+ identity?: string;
22
+ sourceIdentity?: string;
23
+ /** Independently observed local source path or file URL; never inferred from the query. */
24
+ source?: string;
25
+ browserContext?: string;
26
+ uiIndex?: number;
27
+ }
28
+ export interface NativeFinalCutMediaSearchQueryError {
29
+ code: "FINAL_CUT_NATIVE_SEARCH_WILDCARD_UNSUPPORTED";
30
+ message: string;
31
+ querySemantics: "literal";
32
+ unsupportedSyntax: "wildcard";
33
+ }
34
+ export declare function nativeMediaSearchQueryError(query: string): NativeFinalCutMediaSearchQueryError | undefined;
35
+ export type NativeFinalCutMediaImportStage = "pre-import-browser-discovery" | "native-import-ui" | "post-import-browser-discovery";
36
+ export interface NativeFinalCutMediaImportFailureDetails {
37
+ stage: NativeFinalCutMediaImportStage;
38
+ elapsedMs: number;
39
+ stageElapsedMs: number;
40
+ partialImportPossible: boolean;
41
+ diagnostics?: string;
42
+ }
43
+ export declare class NativeFinalCutMediaImportError extends Error {
44
+ readonly code: string;
45
+ readonly details: NativeFinalCutMediaImportFailureDetails;
46
+ constructor(code: string, message: string, details: NativeFinalCutMediaImportFailureDetails);
47
+ }
48
+ export interface NativeFinalCutMediaImportErrorPayload {
49
+ code: string;
50
+ message: string;
51
+ details: NativeFinalCutMediaImportFailureDetails;
52
+ }
53
+ export declare function serializeNativeFinalCutMediaImportError(error: unknown): NativeFinalCutMediaImportErrorPayload | undefined;
54
+ export interface NativeFinalCutMediaImportResult {
55
+ mediaHandle: string;
56
+ sourcePath: string;
57
+ sourceIdentity: string;
58
+ name: string;
59
+ kind: "video" | "audio";
60
+ verification: {
61
+ verified: true;
62
+ stage: "post-import-browser-discovery";
63
+ detail: string;
64
+ };
65
+ }
66
+ export declare const NATIVE_MEDIA_IMPORT_DIRECTORY_ERROR_CODE: "FINAL_CUT_NATIVE_MEDIA_DIRECTORY_INPUT";
67
+ export declare class NativeFinalCutMediaImportDirectoryError extends Error {
68
+ readonly directoryPath: string;
69
+ readonly code: "FINAL_CUT_NATIVE_MEDIA_DIRECTORY_INPUT";
70
+ readonly guidance: {
71
+ readonly previewTool: "editor.native.media.directory.preview";
72
+ readonly executeTool: "editor.native.media.directory.execute";
73
+ };
74
+ constructor(directoryPath: string);
75
+ }
76
+ export declare const SUPPORTED_VIDEO_EXTENSIONS: readonly string[];
77
+ export interface NativeFinalCutMediaImportDirectoryFile {
78
+ sourcePath: string;
79
+ name: string;
80
+ kind: "video";
81
+ }
82
+ export interface NativeFinalCutMediaImportDirectoryPreview {
83
+ previewToken: string;
84
+ directoryPath: string;
85
+ files: NativeFinalCutMediaImportDirectoryFile[];
86
+ command: "Import all previewed video files";
87
+ expectedImportTarget?: NativeFinalCutImportTarget;
88
+ expiresAt: string;
89
+ }
90
+ export interface NativeFinalCutMediaImportDirectoryFileResult {
91
+ sourcePath: string;
92
+ name: string;
93
+ status: "imported" | "failed" | "not-attempted";
94
+ media?: NativeFinalCutMediaImportResult;
95
+ error?: {
96
+ code: string;
97
+ message: string;
98
+ details?: NativeFinalCutMediaImportFailureDetails;
99
+ };
100
+ }
101
+ export interface NativeFinalCutMediaImportDirectoryResult {
102
+ previewToken: string;
103
+ directoryPath: string;
104
+ files: NativeFinalCutMediaImportDirectoryFile[];
105
+ results: NativeFinalCutMediaImportDirectoryFileResult[];
106
+ importedCount: number;
107
+ failedCount: number;
108
+ notAttemptedCount?: number;
109
+ partial: boolean;
110
+ status: "completed" | "partial" | "failed";
111
+ }
112
+ export interface NativeFinalCutOccurrence {
113
+ handle: string;
114
+ mediaHandle: string;
115
+ name: string;
116
+ identity?: string;
117
+ start?: string;
118
+ duration?: string;
119
+ timelineOffset?: number;
120
+ sourceIdentity?: string;
121
+ role?: string;
122
+ sequence?: string;
123
+ sequenceId?: string;
124
+ revision?: string;
125
+ uiContext?: string;
126
+ nativeIdentity?: string;
127
+ }
128
+ export interface NativeFinalCutOccurrenceSearchResult {
129
+ status: "none" | "unique" | "ambiguous";
130
+ occurrences: NativeFinalCutOccurrence[];
131
+ }
132
+ export type NativeFinalCutTargetKind = "selected-clip" | "browser-media" | "playhead" | "unknown" | "none";
133
+ export type NativeFinalCutReadinessState = "ready" | "unavailable" | "timeout" | "cancelled" | "stale";
134
+ export type NativeFinalCutReadinessAction = "none" | "retry" | "queue" | "unavailable";
135
+ export type NativeFinalCutReadinessRequirement = "frontmost" | "timeline-window" | "timeline-focus" | "overlay" | "permission" | "target" | "undo" | "readback";
136
+ export interface NativeFinalCutReadiness {
137
+ state: NativeFinalCutReadinessState;
138
+ nextAction: NativeFinalCutReadinessAction;
139
+ retryable: boolean;
140
+ firstMissing?: NativeFinalCutReadinessRequirement;
141
+ frontmost: boolean;
142
+ timelineFocus: boolean;
143
+ selectedTarget: boolean;
144
+ targetKind?: NativeFinalCutTargetKind;
145
+ targetBound?: boolean;
146
+ overlay: "clear" | "blocked" | "unknown";
147
+ permission: "granted" | "required" | "unknown";
148
+ undo: "available" | "unavailable" | "unknown";
149
+ guidance: string;
150
+ }
151
+ export interface NativeFinalCutTargetResult {
152
+ query: string;
153
+ status: "unique";
154
+ media: NativeFinalCutMediaMatch;
155
+ occurrence: NativeFinalCutOccurrence;
156
+ target: TimelineTarget;
157
+ selected: boolean;
158
+ playheadTime?: string;
159
+ }
160
+ export interface NativeFinalCutBladePreview {
161
+ previewToken: string;
162
+ occurrence: NativeFinalCutOccurrence;
163
+ playheadTime?: string;
164
+ command: "Blade at playhead";
165
+ expiresAt: string;
166
+ }
167
+ export interface NativeFinalCutBladeResult {
168
+ operationId: string;
169
+ previewToken: string;
170
+ occurrence: NativeFinalCutOccurrence;
171
+ resultingSegments: NativeFinalCutOccurrence[];
172
+ before: NativeFinalCutContext;
173
+ after: NativeFinalCutContext;
174
+ verification: {
175
+ verified: boolean;
176
+ detail: string;
177
+ };
178
+ undoAvailable: boolean;
179
+ undoCommand?: string;
180
+ }
181
+ export interface NativeFinalCutMaskBounds {
182
+ x: number;
183
+ y: number;
184
+ width: number;
185
+ height: number;
186
+ }
187
+ export interface NativeFinalCutMaskConfiguration {
188
+ mode: "rectangle";
189
+ bounds: NativeFinalCutMaskBounds;
190
+ }
191
+ export interface NativeFinalCutMaskRequest {
192
+ occurrenceHandle: string;
193
+ mask: NativeFinalCutMaskConfiguration;
194
+ }
195
+ export interface NativeFinalCutMaskPreview {
196
+ previewToken: string;
197
+ occurrence: NativeFinalCutOccurrence;
198
+ mask: NativeFinalCutMaskConfiguration;
199
+ sequenceId?: string;
200
+ revision: string;
201
+ command: "Add native Draw Mask";
202
+ expiresAt: string;
203
+ }
204
+ export interface NativeFinalCutMaskResult {
205
+ operationId: string;
206
+ previewToken: string;
207
+ occurrence: NativeFinalCutOccurrence;
208
+ mask: NativeFinalCutMaskConfiguration;
209
+ observedMask: NativeFinalCutMaskConfiguration;
210
+ before: NativeFinalCutContext;
211
+ after: NativeFinalCutContext;
212
+ beforeRevision: ContextRevision;
213
+ afterRevision: ContextRevision;
214
+ verification: {
215
+ verified: boolean;
216
+ detail: string;
217
+ };
218
+ undoAvailable: boolean;
219
+ undoCommand?: string;
220
+ }
221
+ export type NativeFinalCutMediaInsertionOperation = "append" | "insert";
222
+ export interface NativeFinalCutMediaInsertionPreview {
223
+ previewToken: string;
224
+ operation: NativeFinalCutMediaInsertionOperation;
225
+ media: NativeFinalCutMediaMatch;
226
+ beforeDuration: RationalTime;
227
+ insertionTime: RationalTime;
228
+ sequenceId?: string;
229
+ revision: string;
230
+ command: "Append selected media" | "Insert selected media at playhead";
231
+ expiresAt: string;
232
+ }
233
+ export interface NativeFinalCutMediaInsertionResult {
234
+ operationId: string;
235
+ previewToken: string;
236
+ operation: NativeFinalCutMediaInsertionOperation;
237
+ media: NativeFinalCutMediaMatch;
238
+ before: NativeFinalCutContext;
239
+ after: NativeFinalCutContext;
240
+ beforeDuration: RationalTime;
241
+ afterDuration: RationalTime;
242
+ beforeRevision: ContextRevision;
243
+ afterRevision: ContextRevision;
244
+ verification: {
245
+ verified: boolean;
246
+ detail: string;
247
+ };
248
+ undoAvailable: boolean;
249
+ undoCommand?: string;
250
+ }
251
+ export interface NativeFinalCutTitleRequest {
252
+ asset: EditorAsset;
253
+ text: string;
254
+ /** Omit start to place the title at the current live playhead. */
255
+ start?: RationalTime;
256
+ duration: RationalTime;
257
+ }
258
+ export interface NativeFinalCutTitlePreview {
259
+ previewToken: string;
260
+ asset: Pick<EditorAsset, "id" | "kind" | "name" | "vendor">;
261
+ text: string;
262
+ target: "playhead" | "selected-range";
263
+ start: RationalTime;
264
+ end: RationalTime;
265
+ duration: RationalTime;
266
+ sequenceId?: string;
267
+ revision: string;
268
+ command: "Add native title";
269
+ expiresAt: string;
270
+ }
271
+ export interface NativeFinalCutTitleResult {
272
+ operationId: string;
273
+ previewToken: string;
274
+ asset: Pick<EditorAsset, "id" | "kind" | "name" | "vendor">;
275
+ text: string;
276
+ target: "playhead" | "selected-range";
277
+ start: RationalTime;
278
+ end: RationalTime;
279
+ duration: RationalTime;
280
+ before: NativeFinalCutContext;
281
+ after: NativeFinalCutContext;
282
+ beforeRevision: ContextRevision;
283
+ afterRevision: ContextRevision;
284
+ verification: {
285
+ verified: boolean;
286
+ detail: string;
287
+ };
288
+ undoAvailable: boolean;
289
+ undoCommand?: string;
290
+ }
291
+ export interface NativeFinalCutPictureInPictureRequest {
292
+ mediaHandle: string;
293
+ anchorOccurrenceHandle: string;
294
+ start: RationalTime;
295
+ duration: RationalTime;
296
+ position: PictureInPicturePosition;
297
+ scale: number;
298
+ crop?: PictureInPictureCrop;
299
+ frame?: PictureInPictureFrame;
300
+ }
301
+ export interface NativeFinalCutPictureInPictureReadback {
302
+ position: PictureInPicturePosition;
303
+ scale: number;
304
+ crop?: PictureInPictureCrop;
305
+ frame?: PictureInPictureFrame;
306
+ }
307
+ export interface NativeFinalCutPictureInPicturePreview {
308
+ previewToken: string;
309
+ media: NativeFinalCutMediaMatch;
310
+ anchorOccurrence: NativeFinalCutOccurrence;
311
+ start: RationalTime;
312
+ end: RationalTime;
313
+ duration: RationalTime;
314
+ position: PictureInPicturePosition;
315
+ scale: number;
316
+ crop?: PictureInPictureCrop;
317
+ frame?: PictureInPictureFrame;
318
+ sequenceId?: string;
319
+ revision: string;
320
+ command: "Add native picture-in-picture";
321
+ expiresAt: string;
322
+ }
323
+ export interface NativeFinalCutPictureInPictureResult {
324
+ operationId: string;
325
+ previewToken: string;
326
+ media: NativeFinalCutMediaMatch;
327
+ anchorOccurrence: NativeFinalCutOccurrence;
328
+ occurrence: NativeFinalCutOccurrence;
329
+ start: RationalTime;
330
+ end: RationalTime;
331
+ duration: RationalTime;
332
+ position: PictureInPicturePosition;
333
+ scale: number;
334
+ crop?: PictureInPictureCrop;
335
+ frame?: PictureInPictureFrame;
336
+ observed: NativeFinalCutPictureInPictureReadback;
337
+ before: NativeFinalCutContext;
338
+ after: NativeFinalCutContext;
339
+ beforeRevision: ContextRevision;
340
+ afterRevision: ContextRevision;
341
+ verification: {
342
+ verified: boolean;
343
+ detail: string;
344
+ };
345
+ undoAvailable: boolean;
346
+ undoCommand?: string;
347
+ }
348
+ export interface NativeFinalCutTransitionMatch {
349
+ id: string;
350
+ kind: "transition";
351
+ name: string;
352
+ vendor: string;
353
+ identity: string;
354
+ }
355
+ export interface NativeFinalCutTitleMatch {
356
+ id: string;
357
+ kind: "title";
358
+ name: string;
359
+ vendor: string;
360
+ identity: string;
361
+ }
362
+ export interface NativeFinalCutTransitionPreview {
363
+ previewToken: string;
364
+ asset: NativeFinalCutTransitionMatch;
365
+ beforeOccurrence: NativeFinalCutOccurrence;
366
+ afterOccurrence: NativeFinalCutOccurrence;
367
+ editPoint: RationalTime;
368
+ duration: RationalTime;
369
+ sequenceId?: string;
370
+ revision: string;
371
+ command: "Add native transition";
372
+ expiresAt: string;
373
+ }
374
+ export interface NativeFinalCutTransitionResult {
375
+ operationId: string;
376
+ previewToken: string;
377
+ asset: NativeFinalCutTransitionMatch;
378
+ beforeOccurrence: NativeFinalCutOccurrence;
379
+ afterOccurrence: NativeFinalCutOccurrence;
380
+ editPoint: RationalTime;
381
+ duration: RationalTime;
382
+ observedDuration: RationalTime;
383
+ before: NativeFinalCutContext;
384
+ after: NativeFinalCutContext;
385
+ beforeRevision: ContextRevision;
386
+ afterRevision: ContextRevision;
387
+ verification: {
388
+ verified: boolean;
389
+ detail: string;
390
+ };
391
+ undoAvailable: boolean;
392
+ undoCommand?: string;
393
+ }
394
+ export type NativeFinalCutRangeOperation = "delete-range" | "trim-to-duration";
395
+ export interface NativeFinalCutRange {
396
+ start: RationalTime;
397
+ end: RationalTime;
398
+ }
399
+ export interface NativeFinalCutRangePreview {
400
+ previewToken: string;
401
+ operation: NativeFinalCutRangeOperation;
402
+ range: NativeFinalCutRange;
403
+ beforeDuration: RationalTime;
404
+ expectedAfterDuration: RationalTime;
405
+ sequenceId?: string;
406
+ revision?: string;
407
+ targetIdentity?: string;
408
+ command: "Delete primary storyline range" | "Trim sequence to duration";
409
+ expiresAt: string;
410
+ }
411
+ export interface NativeFinalCutRangeResult {
412
+ operationId: string;
413
+ previewToken: string;
414
+ operation: NativeFinalCutRangeOperation;
415
+ range: NativeFinalCutRange;
416
+ before: NativeFinalCutContext;
417
+ after: NativeFinalCutContext;
418
+ beforeDuration: RationalTime;
419
+ afterDuration: RationalTime;
420
+ expectedAfterDuration: RationalTime;
421
+ beforeRevision: ContextRevision;
422
+ afterRevision: ContextRevision;
423
+ verification: {
424
+ verified: boolean;
425
+ detail: string;
426
+ };
427
+ undoAvailable: boolean;
428
+ undoCommand?: string;
429
+ }
430
+ export interface NativeFinalCutContext {
431
+ available: boolean;
432
+ application: "Final Cut Pro";
433
+ frontmost: boolean;
434
+ frontWindow?: string;
435
+ timelineWindowAvailable: boolean;
436
+ timelineFocused: boolean;
437
+ focusTarget: "timeline" | "browser" | "text-field" | "modal" | "unknown" | "none";
438
+ focusAttempts?: number;
439
+ focusedName?: string;
440
+ focusedRole?: string;
441
+ focusedDescription?: string;
442
+ focusedWindowName?: string;
443
+ framekitWindowAvailable?: boolean;
444
+ framekitWindowMinimized?: boolean;
445
+ overlayBlocked?: boolean;
446
+ project?: string;
447
+ sequence?: string;
448
+ playheadTime?: string;
449
+ target: {
450
+ kind: NativeFinalCutTargetKind;
451
+ name?: string;
452
+ role?: string;
453
+ identity?: string;
454
+ projectId?: string;
455
+ sequenceId?: string;
456
+ revision?: ContextRevision;
457
+ occurrenceIndex?: number;
458
+ };
459
+ bladeAvailable: boolean;
460
+ undoAvailable: boolean;
461
+ undoCommand?: string;
462
+ readiness: NativeFinalCutReadiness;
463
+ error?: {
464
+ code: string;
465
+ message: string;
466
+ state?: NativeFinalCutReadinessState;
467
+ retryable?: boolean;
468
+ };
469
+ }
470
+ export interface NativeFinalCutCapabilities {
471
+ selectionEdit: boolean;
472
+ undo: boolean;
473
+ mediaLibrarySearch: boolean;
474
+ mediaImport: boolean;
475
+ mediaSelection: boolean;
476
+ mediaAppendSelected: boolean;
477
+ timelineOccurrenceLocate: boolean;
478
+ /** True only when Browser source paths and occurrence source identities are independently observed and comparable. */
479
+ timelineOccurrenceSourceBinding?: boolean;
480
+ bladeAtPlayhead: boolean;
481
+ deleteRange: boolean;
482
+ trimToDuration: boolean;
483
+ mediaAppend: boolean;
484
+ mediaInsert: boolean;
485
+ titlePlacement: boolean;
486
+ titleDiscovery?: boolean;
487
+ pictureInPicture?: boolean;
488
+ transitionDiscovery?: boolean;
489
+ transitionPlacement?: boolean;
490
+ masking?: boolean;
491
+ timelineFocus: boolean;
492
+ requiresAccessibility: true;
493
+ requiresFinalCutFrontmost: true;
494
+ }
495
+ export interface NativeFinalCutEditResult {
496
+ operationId: string;
497
+ operation: NativeFinalCutEdit;
498
+ command: string;
499
+ before: NativeFinalCutContext;
500
+ after: NativeFinalCutContext;
501
+ verification: {
502
+ verified: boolean;
503
+ level: "native-command-accepted" | "selection-observed";
504
+ detail: string;
505
+ };
506
+ undoAvailable: boolean;
507
+ undoCommand?: string;
508
+ }
509
+ export interface NativeFinalCutRollbackEvidence {
510
+ beforeRevision?: string;
511
+ afterRevision?: string;
512
+ revisionAdvanced: boolean;
513
+ projectId?: string;
514
+ sequenceId?: string;
515
+ timelineScopeBound: boolean;
516
+ beforeTargetIdentity?: string;
517
+ afterTargetIdentity?: string;
518
+ targetBound: boolean;
519
+ beforeUndoCommand?: string;
520
+ afterUndoCommand?: string;
521
+ undoCommandChanged: boolean;
522
+ mutationObserved: boolean;
523
+ beforeDuration?: RationalTime;
524
+ afterDuration?: RationalTime;
525
+ }
526
+ export interface NativeFinalCutPartialMutationDetails {
527
+ operationId: string;
528
+ recoveryHandle: string;
529
+ operation: string;
530
+ mutationApplied: true;
531
+ safeToRetry: false;
532
+ recovery: {
533
+ tool: "editor.native.undo";
534
+ operationId: string;
535
+ };
536
+ evidence: NativeFinalCutRollbackEvidence;
537
+ cause: {
538
+ code: string;
539
+ message: string;
540
+ };
541
+ }
542
+ export declare class NativeFinalCutPartialMutationError extends Error {
543
+ readonly details: NativeFinalCutPartialMutationDetails;
544
+ readonly code: "FINAL_CUT_NATIVE_PARTIAL_MUTATION";
545
+ constructor(details: NativeFinalCutPartialMutationDetails);
546
+ }
547
+ export interface NativeFinalCutPartialMutationErrorPayload {
548
+ code: NativeFinalCutPartialMutationError["code"];
549
+ message: string;
550
+ details: NativeFinalCutPartialMutationDetails;
551
+ }
552
+ export declare function serializeNativeFinalCutPartialMutationError(error: unknown): NativeFinalCutPartialMutationErrorPayload | undefined;
553
+ export interface NativeFinalCutUndoResult {
554
+ operationId: string;
555
+ undone: boolean;
556
+ context: NativeFinalCutContext;
557
+ verification: {
558
+ verified: boolean;
559
+ detail: string;
560
+ };
561
+ }
562
+ /** An independent provider must observe the original source and exact native target. */
563
+ export interface NativeFinalCutImportTarget {
564
+ libraryId: string;
565
+ eventId: string;
566
+ projectId: string;
567
+ sequenceId: string;
568
+ revision: string;
569
+ }
570
+ export interface NativeFinalCutImportSourceObserver {
571
+ captureTarget(): Promise<NativeFinalCutImportTarget>;
572
+ observeImportedSource(sourceIdentity: string): Promise<{
573
+ sourceIdentity: string;
574
+ originalSourcePath: string;
575
+ target: NativeFinalCutImportTarget;
576
+ }>;
577
+ }
578
+ export interface NativeFinalCutAutomationOptions {
579
+ enabled?: boolean;
580
+ /** Home directory used to expand ~/ media paths; defaults to the process home. */
581
+ homeDirectory?: string;
582
+ executor?: NativeFinalCutExecutor;
583
+ nativeMouseExecutor?: NativeFinalCutMouseExecutor;
584
+ liveState?: () => Promise<EditorLiveState>;
585
+ /** No bundled observer exists; an injected provider must make independent observations. */
586
+ importSourceObserver?: NativeFinalCutImportSourceObserver;
587
+ nativeOperationLease?: NativeOperationLease;
588
+ suspendLiveConnection?: () => void;
589
+ resumeLiveConnection?: () => void;
590
+ now?: () => number;
591
+ sleep?: (milliseconds: number) => Promise<void>;
592
+ nativePreflightTimeoutMs?: number;
593
+ mediaImportTimeoutMs?: number;
594
+ mediaImportDiscoveryTimeoutMs?: number;
595
+ mediaImportPollMs?: number;
596
+ }
597
+ export interface NativeFinalCutRequestOptions {
598
+ signal?: AbortSignal;
599
+ expectedImportTarget?: NativeFinalCutImportTarget;
600
+ }
601
+ export interface NativeFinalCutExecutorOptions {
602
+ signal?: AbortSignal;
603
+ }
604
+ export type NativeFinalCutExecutor = (script: string, options?: NativeFinalCutExecutorOptions) => Promise<string>;
605
+ export type NativeFinalCutMouseExecutor = (source: string) => Promise<void>;
606
+ export interface NativeFinalCutEditor {
607
+ trackNativeDispatch?<T>(operation: () => Promise<T>, onDispatch: () => void): Promise<T>;
608
+ capabilities(): NativeFinalCutCapabilities;
609
+ inspect(options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutContext>;
610
+ focusTimeline(options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutContext>;
611
+ edit(operation: NativeFinalCutEdit, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutEditResult>;
612
+ trimSelectedClipToRange(range: NativeFinalCutRange, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutEditResult>;
613
+ addMarkerAtTime(marker: {
614
+ start: RationalTime;
615
+ duration: RationalTime;
616
+ name: string;
617
+ }, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutEditResult>;
618
+ undo(operationId: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutUndoResult>;
619
+ importMedia(sourcePath: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaImportResult>;
620
+ previewImportMediaDirectory(directoryPath: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaImportDirectoryPreview>;
621
+ executeImportMediaDirectory(previewToken: string, confirm: boolean, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaImportDirectoryResult>;
622
+ searchMedia(query: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaMatch[]>;
623
+ /** Searches a known canonical source basename for internal target binding, outside the public wildcard-query contract. */
624
+ searchMediaForCanonicalTarget?(query: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaMatch[]>;
625
+ selectMedia(handle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutContext>;
626
+ locateOccurrence(mediaHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutOccurrenceSearchResult>;
627
+ locateOccurrenceForCanonicalTarget?(mediaHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutOccurrenceSearchResult>;
628
+ selectOccurrence(occurrenceHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutContext>;
629
+ /** Observe Inspector source and range independently, binding them to the currently selected identity; fail closed on drift. */
630
+ inspectSelectedOccurrenceSource?(options?: NativeFinalCutRequestOptions): Promise<{
631
+ identity: string;
632
+ source: string;
633
+ sourceStartTime: RationalTime;
634
+ durationTime: RationalTime;
635
+ } | undefined>;
636
+ selectCanonicalOccurrence(name: string, occurrenceIndex: number, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutContext>;
637
+ targetMedia(query: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTargetResult>;
638
+ previewBlade(occurrenceHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutBladePreview>;
639
+ executeBlade(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutBladeResult>;
640
+ previewMask(request: NativeFinalCutMaskRequest, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMaskPreview>;
641
+ executeMask(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMaskResult>;
642
+ previewDeleteRange(range: NativeFinalCutRange, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutRangePreview>;
643
+ executeDeleteRange(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutRangeResult>;
644
+ previewTrimToDuration(duration: RationalTime, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutRangePreview>;
645
+ executeTrimToDuration(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutRangeResult>;
646
+ previewAppendMedia(mediaHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionPreview>;
647
+ executeAppendMedia(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionResult>;
648
+ previewAppendSelectedMedia(options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionPreview>;
649
+ executeAppendSelectedMedia(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionResult>;
650
+ previewInsertMedia(mediaHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionPreview>;
651
+ executeInsertMedia(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionResult>;
652
+ previewTitleAdd(request: NativeFinalCutTitleRequest, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTitlePreview>;
653
+ executeTitleAdd(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTitleResult>;
654
+ searchTitles(query: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTitleMatch[]>;
655
+ previewPictureInPicture(request: NativeFinalCutPictureInPictureRequest, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutPictureInPicturePreview>;
656
+ executePictureInPicture(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutPictureInPictureResult>;
657
+ searchTransitions(query: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTransitionMatch[]>;
658
+ previewTransitionAdd(request: NativeFinalCutTransitionRequest, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTransitionPreview>;
659
+ executeTransitionAdd(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTransitionResult>;
660
+ }
661
+ export interface NativeFinalCutTransitionRequest {
662
+ asset: NativeFinalCutTransitionMatch;
663
+ beforeOccurrenceHandle: string;
664
+ afterOccurrenceHandle: string;
665
+ duration: RationalTime;
666
+ }
667
+ export declare class FinalCutNativeAutomationAdapter implements NativeFinalCutEditor {
668
+ private readonly enabled;
669
+ private readonly homeDirectory;
670
+ private titleDiscoveryAvailable;
671
+ private readonly executor;
672
+ private readonly nativeMouseExecutor?;
673
+ private readonly canDriveNativeMouse;
674
+ private readonly liveState?;
675
+ private readonly importSourceObserver?;
676
+ private readonly nativeOperationLease?;
677
+ private readonly suspendLiveConnection?;
678
+ private readonly resumeLiveConnection?;
679
+ private readonly now;
680
+ private readonly sleep;
681
+ private readonly nativePreflightTimeoutMs;
682
+ private readonly mediaImportTimeoutMs;
683
+ private readonly mediaImportDiscoveryTimeoutMs;
684
+ private readonly mediaImportPollMs;
685
+ private readonly requestContext;
686
+ private readonly dispatchContext;
687
+ private nativeUiDepth;
688
+ private readonly operations;
689
+ private latestOperationId?;
690
+ private readonly mediaHandles;
691
+ private selectedMediaHandle?;
692
+ private readonly stableMediaHandles;
693
+ private readonly occurrenceHandles;
694
+ private readonly ambiguousMediaHandles;
695
+ private readonly mediaImportDirectoryPreviews;
696
+ private readonly bladePreviews;
697
+ private readonly maskPreviews;
698
+ private readonly rangePreviews;
699
+ private readonly mediaInsertionPreviews;
700
+ private readonly titlePreviews;
701
+ private readonly pictureInPicturePreviews;
702
+ private readonly transitionPreviews;
703
+ constructor(options?: NativeFinalCutAutomationOptions);
704
+ capabilities(): NativeFinalCutCapabilities;
705
+ inspect(options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutContext>;
706
+ focusTimeline(options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutContext>;
707
+ private inspectNative;
708
+ private focusTimelineNative;
709
+ private inspectRawNative;
710
+ private attachLiveState;
711
+ private readLiveState;
712
+ private rememberOperation;
713
+ edit(operation: NativeFinalCutEdit, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutEditResult>;
714
+ trackNativeDispatch<T>(operation: () => Promise<T>, onDispatch: () => void): Promise<T>;
715
+ trimSelectedClipToRange(range: NativeFinalCutRange, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutEditResult>;
716
+ private trimSelectedClipToRangeNative;
717
+ addMarkerAtTime(marker: {
718
+ start: RationalTime;
719
+ duration: RationalTime;
720
+ name: string;
721
+ }, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutEditResult>;
722
+ private editNative;
723
+ undo(operationId: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutUndoResult>;
724
+ private undoNative;
725
+ importMedia(sourcePath: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaImportResult>;
726
+ previewImportMediaDirectory(directoryPath: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaImportDirectoryPreview>;
727
+ private previewImportMediaDirectoryNative;
728
+ executeImportMediaDirectory(previewToken: string, confirm: boolean, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaImportDirectoryResult>;
729
+ private importMediaNative;
730
+ private executeImportMediaDirectoryNative;
731
+ searchMedia(query: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaMatch[]>;
732
+ searchMediaForCanonicalTarget(query: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaMatch[]>;
733
+ private searchMediaNative;
734
+ private readBrowserMediaDiagnostics;
735
+ previewAppendSelectedMedia(options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionPreview>;
736
+ private previewSelectedMediaInsertionNative;
737
+ private readSelectedMediaNative;
738
+ selectMedia(handle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutContext>;
739
+ private selectMediaNative;
740
+ locateOccurrence(mediaHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutOccurrenceSearchResult>;
741
+ locateOccurrenceForCanonicalTarget(mediaHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutOccurrenceSearchResult>;
742
+ selectOccurrence(occurrenceHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutContext>;
743
+ selectCanonicalOccurrence(name: string, occurrenceIndex: number, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutContext>;
744
+ targetMedia(query: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTargetResult>;
745
+ private targetMediaNative;
746
+ private locateOccurrenceNative;
747
+ private selectOccurrenceNative;
748
+ private selectCanonicalOccurrenceNative;
749
+ previewBlade(occurrenceHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutBladePreview>;
750
+ private previewBladeNative;
751
+ executeBlade(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutBladeResult>;
752
+ previewMask(request: NativeFinalCutMaskRequest, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMaskPreview>;
753
+ executeMask(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMaskResult>;
754
+ private previewMaskNative;
755
+ private executeMaskNative;
756
+ private rollbackFailedMask;
757
+ private executeBladeNative;
758
+ private assertBladePreviewBinding;
759
+ previewDeleteRange(range: NativeFinalCutRange, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutRangePreview>;
760
+ executeDeleteRange(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutRangeResult>;
761
+ previewTrimToDuration(duration: RationalTime, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutRangePreview>;
762
+ executeTrimToDuration(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutRangeResult>;
763
+ previewAppendMedia(mediaHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionPreview>;
764
+ executeAppendMedia(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionResult>;
765
+ executeAppendSelectedMedia(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionResult>;
766
+ previewInsertMedia(mediaHandle: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionPreview>;
767
+ executeInsertMedia(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutMediaInsertionResult>;
768
+ previewTitleAdd(request: NativeFinalCutTitleRequest, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTitlePreview>;
769
+ executeTitleAdd(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTitleResult>;
770
+ searchTitles(query: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTitleMatch[]>;
771
+ previewPictureInPicture(request: NativeFinalCutPictureInPictureRequest, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutPictureInPicturePreview>;
772
+ executePictureInPicture(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutPictureInPictureResult>;
773
+ searchTransitions(query: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTransitionMatch[]>;
774
+ previewTransitionAdd(request: NativeFinalCutTransitionRequest, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTransitionPreview>;
775
+ executeTransitionAdd(previewToken: string, options?: NativeFinalCutRequestOptions): Promise<NativeFinalCutTransitionResult>;
776
+ private searchTitlesNative;
777
+ private ensureTitleBrowserReady;
778
+ private searchTransitionsNative;
779
+ private previewTransitionAddNative;
780
+ private executeTransitionAddNative;
781
+ private previewTitleAddNative;
782
+ private executeTitleAddNative;
783
+ private previewPictureInPictureNative;
784
+ private executePictureInPictureNative;
785
+ private previewMediaInsertionNative;
786
+ private executeMediaInsertionNative;
787
+ private focusTimelineForMediaInsertion;
788
+ private validateSelectedMediaBinding;
789
+ private previewRangeNative;
790
+ private createRangePreview;
791
+ private executeRangeNative;
792
+ private validateRangeBinding;
793
+ private requireLiveState;
794
+ private validateMediaInsertionBinding;
795
+ private validateTitleBinding;
796
+ private waitForMediaInsertion;
797
+ private waitForRevision;
798
+ private waitForDuration;
799
+ private waitForUndo;
800
+ private positionAndDeleteRange;
801
+ private executeNativeCommand;
802
+ private executeNativeSequence;
803
+ private prepareNativeRetry;
804
+ private assertRetryContext;
805
+ private waitForPlayhead;
806
+ private toTimecode;
807
+ private assertEnabled;
808
+ private withNativeUi;
809
+ private validateOccurrenceBinding;
810
+ private validateSelectedPictureInPictureAnchor;
811
+ private readPictureInPictureOccurrence;
812
+ private ensureOccurrenceRange;
813
+ private waitForLivePlayheadChangeOrCurrent;
814
+ private requireTimelineTarget;
815
+ private requireNativeWriteContext;
816
+ private assertNativeWriteContext;
817
+ private assertNativeRollbackReady;
818
+ private requireTimelineContext;
819
+ private ensureTimelineReady;
820
+ private requireAvailableContext;
821
+ private ensureBrowserReady;
822
+ private selectTimelineOccurrence;
823
+ private executeNativeMouseScript;
824
+ private stableMediaHandle;
825
+ private executeNativeScript;
826
+ }
827
+ /** Construct the disabled focus response without invoking a native provider. */
828
+ export declare function disabledNativeFocusContext(): NativeFinalCutContext;