@nodaro/shared 3.31.0 → 3.32.0

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 (372) hide show
  1. package/README.md +17 -0
  2. package/dist/chunk-2NIQO2J3.cjs +54 -0
  3. package/dist/chunk-2NIQO2J3.cjs.map +1 -0
  4. package/dist/chunk-2OJIVO7R.cjs +32 -0
  5. package/dist/chunk-2OJIVO7R.cjs.map +1 -0
  6. package/dist/chunk-2RF4Z7KG.cjs +803 -0
  7. package/dist/chunk-2RF4Z7KG.cjs.map +1 -0
  8. package/dist/chunk-3CUFITU7.js +1905 -0
  9. package/dist/chunk-3CUFITU7.js.map +1 -0
  10. package/dist/chunk-3RYKIUAE.js +86 -0
  11. package/dist/chunk-3RYKIUAE.js.map +1 -0
  12. package/dist/chunk-44I73CQS.cjs +194 -0
  13. package/dist/chunk-44I73CQS.cjs.map +1 -0
  14. package/dist/chunk-5AUSSJIM.cjs +3372 -0
  15. package/dist/chunk-5AUSSJIM.cjs.map +1 -0
  16. package/dist/chunk-5PC6JBGJ.cjs +1419 -0
  17. package/dist/chunk-5PC6JBGJ.cjs.map +1 -0
  18. package/dist/chunk-5RU2HCW2.js +30 -0
  19. package/dist/chunk-5RU2HCW2.js.map +1 -0
  20. package/dist/chunk-5THUHJ3E.js +46 -0
  21. package/dist/chunk-5THUHJ3E.js.map +1 -0
  22. package/dist/chunk-5U7VLG43.js +141 -0
  23. package/dist/chunk-5U7VLG43.js.map +1 -0
  24. package/dist/chunk-6DAWSVX2.cjs +103 -0
  25. package/dist/chunk-6DAWSVX2.cjs.map +1 -0
  26. package/dist/chunk-6DKDOWBL.js +1567 -0
  27. package/dist/chunk-6DKDOWBL.js.map +1 -0
  28. package/dist/chunk-6IJOPRZP.cjs +197 -0
  29. package/dist/chunk-6IJOPRZP.cjs.map +1 -0
  30. package/dist/chunk-7G7G42KS.js +86 -0
  31. package/dist/chunk-7G7G42KS.js.map +1 -0
  32. package/dist/chunk-AINCI23X.js +2171 -0
  33. package/dist/chunk-AINCI23X.js.map +1 -0
  34. package/dist/chunk-AROWPFO2.js +773 -0
  35. package/dist/chunk-AROWPFO2.js.map +1 -0
  36. package/dist/chunk-AVQK77G6.cjs +2000 -0
  37. package/dist/chunk-AVQK77G6.cjs.map +1 -0
  38. package/dist/chunk-C57NEO3X.js +3327 -0
  39. package/dist/chunk-C57NEO3X.js.map +1 -0
  40. package/dist/chunk-CK3GK34R.js +1381 -0
  41. package/dist/chunk-CK3GK34R.js.map +1 -0
  42. package/dist/chunk-E2TGXG6X.cjs +1770 -0
  43. package/dist/chunk-E2TGXG6X.cjs.map +1 -0
  44. package/dist/chunk-EK362Q45.cjs +38 -0
  45. package/dist/chunk-EK362Q45.cjs.map +1 -0
  46. package/dist/chunk-FBV5DF6D.js +95 -0
  47. package/dist/chunk-FBV5DF6D.js.map +1 -0
  48. package/dist/chunk-FG4E7MTG.cjs +4 -0
  49. package/dist/chunk-FG4E7MTG.cjs.map +1 -0
  50. package/dist/chunk-G6IIVKMO.js +26 -0
  51. package/dist/chunk-G6IIVKMO.js.map +1 -0
  52. package/dist/chunk-HGC5JNVA.cjs +1503 -0
  53. package/dist/chunk-HGC5JNVA.cjs.map +1 -0
  54. package/dist/chunk-HSHCCBIV.js +255 -0
  55. package/dist/chunk-HSHCCBIV.js.map +1 -0
  56. package/dist/chunk-IEBZHTPE.js +254 -0
  57. package/dist/chunk-IEBZHTPE.js.map +1 -0
  58. package/dist/chunk-ISJDAFKS.js +1604 -0
  59. package/dist/chunk-ISJDAFKS.js.map +1 -0
  60. package/dist/chunk-J6KHW2E5.cjs +1963 -0
  61. package/dist/chunk-J6KHW2E5.cjs.map +1 -0
  62. package/dist/chunk-J7BMO73N.cjs +114 -0
  63. package/dist/chunk-J7BMO73N.cjs.map +1 -0
  64. package/dist/chunk-JL4C5VJ7.cjs +488 -0
  65. package/dist/chunk-JL4C5VJ7.cjs.map +1 -0
  66. package/dist/chunk-JSGIEF6Z.cjs +1087 -0
  67. package/dist/chunk-JSGIEF6Z.cjs.map +1 -0
  68. package/dist/chunk-JSNV5O2F.cjs +34 -0
  69. package/dist/chunk-JSNV5O2F.cjs.map +1 -0
  70. package/dist/chunk-JWA5SGCS.js +203 -0
  71. package/dist/chunk-JWA5SGCS.js.map +1 -0
  72. package/dist/chunk-JX5YZ4DH.cjs +430 -0
  73. package/dist/chunk-JX5YZ4DH.cjs.map +1 -0
  74. package/dist/chunk-KHCBJ7KD.js +42 -0
  75. package/dist/chunk-KHCBJ7KD.js.map +1 -0
  76. package/dist/chunk-KU6S7IYV.cjs +210 -0
  77. package/dist/chunk-KU6S7IYV.cjs.map +1 -0
  78. package/dist/chunk-LKAIXWK3.js +181 -0
  79. package/dist/chunk-LKAIXWK3.js.map +1 -0
  80. package/dist/chunk-LPW3XNC2.js +471 -0
  81. package/dist/chunk-LPW3XNC2.js.map +1 -0
  82. package/dist/chunk-M36G6SRP.js +447 -0
  83. package/dist/chunk-M36G6SRP.js.map +1 -0
  84. package/dist/chunk-MRXGWL42.cjs +4 -0
  85. package/dist/chunk-MRXGWL42.cjs.map +1 -0
  86. package/dist/chunk-NB72XWXQ.cjs +54 -0
  87. package/dist/chunk-NB72XWXQ.cjs.map +1 -0
  88. package/dist/chunk-NEJ2PV4C.cjs +211 -0
  89. package/dist/chunk-NEJ2PV4C.cjs.map +1 -0
  90. package/dist/chunk-NT6IJH4L.cjs +273 -0
  91. package/dist/chunk-NT6IJH4L.cjs.map +1 -0
  92. package/dist/chunk-O5MP52U2.cjs +526 -0
  93. package/dist/chunk-O5MP52U2.cjs.map +1 -0
  94. package/dist/chunk-O7PUQLJ3.cjs +818 -0
  95. package/dist/chunk-O7PUQLJ3.cjs.map +1 -0
  96. package/dist/chunk-PQHS255G.js +1369 -0
  97. package/dist/chunk-PQHS255G.js.map +1 -0
  98. package/dist/chunk-PRYE7AZQ.cjs +1227 -0
  99. package/dist/chunk-PRYE7AZQ.cjs.map +1 -0
  100. package/dist/chunk-Q4CDQ2KO.js +21 -0
  101. package/dist/chunk-Q4CDQ2KO.js.map +1 -0
  102. package/dist/chunk-QELDJGDK.cjs +1714 -0
  103. package/dist/chunk-QELDJGDK.cjs.map +1 -0
  104. package/dist/chunk-QJRP44ZO.js +769 -0
  105. package/dist/chunk-QJRP44ZO.js.map +1 -0
  106. package/dist/chunk-QNGNOU4Z.js +29 -0
  107. package/dist/chunk-QNGNOU4Z.js.map +1 -0
  108. package/dist/chunk-RJL7RCEM.cjs +159 -0
  109. package/dist/chunk-RJL7RCEM.cjs.map +1 -0
  110. package/dist/chunk-RN3RMBJZ.js +1164 -0
  111. package/dist/chunk-RN3RMBJZ.js.map +1 -0
  112. package/dist/chunk-S5DMKUWK.cjs +1273 -0
  113. package/dist/chunk-S5DMKUWK.cjs.map +1 -0
  114. package/dist/chunk-SES6GDBQ.cjs +624 -0
  115. package/dist/chunk-SES6GDBQ.cjs.map +1 -0
  116. package/dist/chunk-TNPDV7I4.cjs +2346 -0
  117. package/dist/chunk-TNPDV7I4.cjs.map +1 -0
  118. package/dist/chunk-TZBIY5C3.js +187 -0
  119. package/dist/chunk-TZBIY5C3.js.map +1 -0
  120. package/dist/chunk-TZE673G6.js +3 -0
  121. package/dist/chunk-TZE673G6.js.map +1 -0
  122. package/dist/chunk-ULXI7A6Q.cjs +1047 -0
  123. package/dist/chunk-ULXI7A6Q.cjs.map +1 -0
  124. package/dist/chunk-VIWSWVAW.js +1782 -0
  125. package/dist/chunk-VIWSWVAW.js.map +1 -0
  126. package/dist/chunk-VWGNPMJZ.cjs +19 -0
  127. package/dist/chunk-VWGNPMJZ.cjs.map +1 -0
  128. package/dist/chunk-WDIBOWAA.js +1054 -0
  129. package/dist/chunk-WDIBOWAA.js.map +1 -0
  130. package/dist/chunk-WNG7HRVA.cjs +25 -0
  131. package/dist/chunk-WNG7HRVA.cjs.map +1 -0
  132. package/dist/chunk-WNVQ3SMB.cjs +96 -0
  133. package/dist/chunk-WNVQ3SMB.cjs.map +1 -0
  134. package/dist/chunk-WRSWH7US.cjs +285 -0
  135. package/dist/chunk-WRSWH7US.cjs.map +1 -0
  136. package/dist/chunk-XAMC4S53.js +17 -0
  137. package/dist/chunk-XAMC4S53.js.map +1 -0
  138. package/dist/chunk-XNISPHTZ.js +1039 -0
  139. package/dist/chunk-XNISPHTZ.js.map +1 -0
  140. package/dist/chunk-Y2PM3FFL.js +3 -0
  141. package/dist/chunk-Y2PM3FFL.js.map +1 -0
  142. package/dist/chunk-YBPBK5KI.js +1030 -0
  143. package/dist/chunk-YBPBK5KI.js.map +1 -0
  144. package/dist/chunk-YHRG7UOC.js +31 -0
  145. package/dist/chunk-YHRG7UOC.js.map +1 -0
  146. package/dist/chunk-YWNYGYI7.cjs +31 -0
  147. package/dist/chunk-YWNYGYI7.cjs.map +1 -0
  148. package/dist/chunk-YYV35XOS.js +122 -0
  149. package/dist/chunk-YYV35XOS.js.map +1 -0
  150. package/dist/chunk-Z2OL5AJD.cjs +133 -0
  151. package/dist/chunk-Z2OL5AJD.cjs.map +1 -0
  152. package/dist/chunk-Z4AZW6FY.js +920 -0
  153. package/dist/chunk-Z4AZW6FY.js.map +1 -0
  154. package/dist/chunk-ZDFHA2EC.js +572 -0
  155. package/dist/chunk-ZDFHA2EC.js.map +1 -0
  156. package/dist/chunk-ZNZDQAXN.js +175 -0
  157. package/dist/chunk-ZNZDQAXN.js.map +1 -0
  158. package/dist/chunk-ZRL2UFTH.cjs +1073 -0
  159. package/dist/chunk-ZRL2UFTH.cjs.map +1 -0
  160. package/dist/chunk-ZT77RY6R.js +404 -0
  161. package/dist/chunk-ZT77RY6R.js.map +1 -0
  162. package/dist/entries/apps.cjs +155 -0
  163. package/dist/entries/apps.cjs.map +1 -0
  164. package/dist/entries/apps.d.cts +283 -0
  165. package/dist/entries/apps.d.ts +283 -0
  166. package/dist/entries/apps.js +10 -0
  167. package/dist/entries/apps.js.map +1 -0
  168. package/dist/entries/captions.cjs +124 -0
  169. package/dist/entries/captions.cjs.map +1 -0
  170. package/dist/entries/captions.d.cts +354 -0
  171. package/dist/entries/captions.d.ts +354 -0
  172. package/dist/entries/captions.js +3 -0
  173. package/dist/entries/captions.js.map +1 -0
  174. package/dist/entries/catalogs.cjs +165 -0
  175. package/dist/entries/catalogs.cjs.map +1 -0
  176. package/dist/entries/catalogs.d.cts +385 -0
  177. package/dist/entries/catalogs.d.ts +385 -0
  178. package/dist/entries/catalogs.js +4 -0
  179. package/dist/entries/catalogs.js.map +1 -0
  180. package/dist/entries/credits.cjs +592 -0
  181. package/dist/entries/credits.cjs.map +1 -0
  182. package/dist/entries/credits.d.cts +1429 -0
  183. package/dist/entries/credits.d.ts +1429 -0
  184. package/dist/entries/credits.js +11 -0
  185. package/dist/entries/credits.js.map +1 -0
  186. package/dist/entries/edl.cjs +409 -0
  187. package/dist/entries/edl.cjs.map +1 -0
  188. package/dist/entries/edl.d.cts +1199 -0
  189. package/dist/entries/edl.d.ts +1199 -0
  190. package/dist/entries/edl.js +4 -0
  191. package/dist/entries/edl.js.map +1 -0
  192. package/dist/entries/entities.cjs +530 -0
  193. package/dist/entries/entities.cjs.map +1 -0
  194. package/dist/entries/entities.d.cts +1371 -0
  195. package/dist/entries/entities.d.ts +1371 -0
  196. package/dist/entries/entities.js +5 -0
  197. package/dist/entries/entities.js.map +1 -0
  198. package/dist/entries/i18n.cjs +48 -0
  199. package/dist/entries/i18n.cjs.map +1 -0
  200. package/dist/entries/i18n.d.cts +69 -0
  201. package/dist/entries/i18n.d.ts +69 -0
  202. package/dist/entries/i18n.js +3 -0
  203. package/dist/entries/i18n.js.map +1 -0
  204. package/dist/entries/llm-models.cjs +177 -0
  205. package/dist/entries/llm-models.cjs.map +1 -0
  206. package/dist/entries/llm-models.d.cts +435 -0
  207. package/dist/entries/llm-models.d.ts +435 -0
  208. package/dist/entries/llm-models.js +4 -0
  209. package/dist/entries/llm-models.js.map +1 -0
  210. package/dist/entries/media.cjs +335 -0
  211. package/dist/entries/media.cjs.map +1 -0
  212. package/dist/entries/media.d.cts +518 -0
  213. package/dist/entries/media.d.ts +518 -0
  214. package/dist/entries/media.js +6 -0
  215. package/dist/entries/media.js.map +1 -0
  216. package/dist/entries/model-catalog.cjs +247 -0
  217. package/dist/entries/model-catalog.cjs.map +1 -0
  218. package/dist/entries/model-catalog.d.cts +202 -0
  219. package/dist/entries/model-catalog.d.ts +202 -0
  220. package/dist/entries/model-catalog.js +6 -0
  221. package/dist/entries/model-catalog.js.map +1 -0
  222. package/dist/entries/models.cjs +833 -0
  223. package/dist/entries/models.cjs.map +1 -0
  224. package/dist/entries/models.d.cts +287 -0
  225. package/dist/entries/models.d.ts +287 -0
  226. package/dist/entries/models.js +8 -0
  227. package/dist/entries/models.js.map +1 -0
  228. package/dist/entries/nodes.cjs +789 -0
  229. package/dist/entries/nodes.cjs.map +1 -0
  230. package/dist/entries/nodes.d.cts +1600 -0
  231. package/dist/entries/nodes.d.ts +1600 -0
  232. package/dist/entries/nodes.js +16 -0
  233. package/dist/entries/nodes.js.map +1 -0
  234. package/dist/entries/organizations.cjs +80 -0
  235. package/dist/entries/organizations.cjs.map +1 -0
  236. package/dist/entries/organizations.d.cts +466 -0
  237. package/dist/entries/organizations.d.ts +466 -0
  238. package/dist/entries/organizations.js +3 -0
  239. package/dist/entries/organizations.js.map +1 -0
  240. package/dist/entries/pipeline.cjs +594 -0
  241. package/dist/entries/pipeline.cjs.map +1 -0
  242. package/dist/entries/pipeline.d.cts +2617 -0
  243. package/dist/entries/pipeline.d.ts +2617 -0
  244. package/dist/entries/pipeline.js +5 -0
  245. package/dist/entries/pipeline.js.map +1 -0
  246. package/dist/entries/scene3d.cjs +704 -0
  247. package/dist/entries/scene3d.cjs.map +1 -0
  248. package/dist/entries/scene3d.d.cts +4284 -0
  249. package/dist/entries/scene3d.d.ts +4284 -0
  250. package/dist/entries/scene3d.js +3 -0
  251. package/dist/entries/scene3d.js.map +1 -0
  252. package/dist/entries/social.cjs +714 -0
  253. package/dist/entries/social.cjs.map +1 -0
  254. package/dist/entries/social.d.cts +1366 -0
  255. package/dist/entries/social.d.ts +1366 -0
  256. package/dist/entries/social.js +5 -0
  257. package/dist/entries/social.js.map +1 -0
  258. package/dist/entries/types.cjs +13 -0
  259. package/dist/entries/types.cjs.map +1 -0
  260. package/dist/entries/types.d.cts +162 -0
  261. package/dist/entries/types.d.ts +162 -0
  262. package/dist/entries/types.js +4 -0
  263. package/dist/entries/types.js.map +1 -0
  264. package/dist/entries/ugc.cjs +279 -0
  265. package/dist/entries/ugc.cjs.map +1 -0
  266. package/dist/entries/ugc.d.cts +575 -0
  267. package/dist/entries/ugc.d.ts +575 -0
  268. package/dist/entries/ugc.js +6 -0
  269. package/dist/entries/ugc.js.map +1 -0
  270. package/dist/entries/video.cjs +549 -0
  271. package/dist/entries/video.cjs.map +1 -0
  272. package/dist/entries/video.d.cts +1791 -0
  273. package/dist/entries/video.d.ts +1791 -0
  274. package/dist/entries/video.js +8 -0
  275. package/dist/entries/video.js.map +1 -0
  276. package/dist/entries/workflow.cjs +574 -0
  277. package/dist/entries/workflow.cjs.map +1 -0
  278. package/dist/entries/workflow.d.cts +1733 -0
  279. package/dist/entries/workflow.d.ts +1733 -0
  280. package/dist/entries/workflow.js +5 -0
  281. package/dist/entries/workflow.js.map +1 -0
  282. package/dist/fan-out-meta-Bu6VyXcZ.d.cts +19 -0
  283. package/dist/fan-out-meta-Bu6VyXcZ.d.ts +19 -0
  284. package/dist/gemini-omni-voices-zeRXxSbZ.d.cts +174 -0
  285. package/dist/gemini-omni-voices-zeRXxSbZ.d.ts +174 -0
  286. package/dist/image-overlay-layers-CyBfRhxJ.d.cts +208 -0
  287. package/dist/image-overlay-layers-CyBfRhxJ.d.ts +208 -0
  288. package/dist/index.cjs +7731 -27084
  289. package/dist/index.cjs.map +1 -1
  290. package/dist/index.d.cts +32 -24198
  291. package/dist/index.d.ts +32 -24198
  292. package/dist/index.js +40 -25220
  293. package/dist/index.js.map +1 -1
  294. package/dist/model-catalog-flJYaa-g.d.cts +561 -0
  295. package/dist/model-catalog-flJYaa-g.d.ts +561 -0
  296. package/dist/presentation-types-0ENOCjoj.d.cts +61 -0
  297. package/dist/presentation-types-0ENOCjoj.d.ts +61 -0
  298. package/dist/presentation-utils-BIqiCzSA.d.cts +90 -0
  299. package/dist/presentation-utils-BdiObtwq.d.ts +90 -0
  300. package/dist/scene-node-types-DjenYFLO.d.cts +1949 -0
  301. package/dist/scene-node-types-DjenYFLO.d.ts +1949 -0
  302. package/dist/supported-fonts-CRoF1gOy.d.cts +16 -0
  303. package/dist/supported-fonts-CRoF1gOy.d.ts +16 -0
  304. package/dist/types-BRlFPEru.d.cts +511 -0
  305. package/dist/types-BRlFPEru.d.ts +511 -0
  306. package/dist/types-DffyGSy5.d.cts +67 -0
  307. package/dist/types-DffyGSy5.d.ts +67 -0
  308. package/package.json +102 -1
  309. package/src/__tests__/add-captions-plan.test.ts +6 -2
  310. package/src/__tests__/caption-edge-dash.test.ts +23 -0
  311. package/src/__tests__/fixtures/root-exports.baseline.json +4625 -0
  312. package/src/__tests__/input-field-extra-keys.test.ts +1 -0
  313. package/src/__tests__/no-internal-imports.test.ts +1 -1
  314. package/src/__tests__/node-aspect-ratio.test.ts +25 -0
  315. package/src/__tests__/node-runtime-keys.test.ts +9 -0
  316. package/src/__tests__/package-entries.test.ts +50 -0
  317. package/src/__tests__/pitch-tempo-pricing.test.ts +21 -0
  318. package/src/__tests__/preview-gate-use-case.test.ts +151 -0
  319. package/src/__tests__/run-continuation.test.ts +7 -1
  320. package/src/__tests__/site-capture-node.test.ts +58 -0
  321. package/src/__tests__/ugc-lane-wires.test.ts +228 -0
  322. package/src/__tests__/ugc-node-wires.test.ts +9 -3
  323. package/src/__tests__/ugc-run-state.test.ts +5 -4
  324. package/src/__tests__/video-analysis-catalog-sync.test.ts +1 -1
  325. package/src/__tests__/video-analysis-pricing.test.ts +6 -6
  326. package/src/__tests__/voice-changer-pro-quote.test.ts +79 -0
  327. package/src/add-captions-plan.ts +9 -3
  328. package/src/caption-edge-dash.ts +33 -0
  329. package/src/credit-estimators/index.ts +22 -1
  330. package/src/credit-estimators/pitch-tempo.ts +15 -1
  331. package/src/credit-estimators/speech.ts +72 -4
  332. package/src/credit-estimators/unit-quote.ts +52 -0
  333. package/src/credit-estimators/video-sfx.ts +15 -0
  334. package/src/credit-estimators/voice-changer-pro-quote.ts +138 -0
  335. package/src/entity-image-handle.ts +2 -0
  336. package/src/entries/apps.ts +63 -0
  337. package/src/entries/captions.ts +34 -0
  338. package/src/entries/catalogs.ts +65 -0
  339. package/src/entries/credits.ts +104 -0
  340. package/src/entries/edl.ts +42 -0
  341. package/src/entries/entities.ts +144 -0
  342. package/src/entries/i18n.ts +31 -0
  343. package/src/entries/llm-models.ts +63 -0
  344. package/src/entries/media.ts +36 -0
  345. package/src/entries/model-catalog.ts +89 -0
  346. package/src/entries/models.ts +266 -0
  347. package/src/entries/nodes.ts +245 -0
  348. package/src/entries/organizations.ts +9 -0
  349. package/src/entries/pipeline.ts +43 -0
  350. package/src/entries/scene3d.ts +27 -0
  351. package/src/entries/social.ts +297 -0
  352. package/src/entries/types.ts +26 -0
  353. package/src/entries/ugc.ts +14 -0
  354. package/src/entries/video.ts +59 -0
  355. package/src/entries/workflow.ts +172 -0
  356. package/src/fan-out-rows.ts +2 -0
  357. package/src/index.ts +25 -1845
  358. package/src/json-kinds.ts +4 -0
  359. package/src/model-catalog.ts +36 -34
  360. package/src/node-mappable-fields.ts +1 -0
  361. package/src/node-run-routes.ts +2 -0
  362. package/src/node-runtime-keys.ts +8 -0
  363. package/src/normalize-node-params.ts +30 -0
  364. package/src/presentation-utils.ts +5 -0
  365. package/src/preview-gate.ts +92 -14
  366. package/src/producer-types.ts +16 -2
  367. package/src/run-continuation.ts +21 -0
  368. package/src/site-capture-node.ts +82 -0
  369. package/src/ugc-lane-wires.ts +246 -0
  370. package/src/ugc-node-wires.ts +37 -7
  371. package/src/ugc-run-state.ts +5 -3
  372. package/src/video-analysis-pricing.ts +31 -29
@@ -0,0 +1,1199 @@
1
+ /**
2
+ * Catalog of every transition the combine-videos node supports.
3
+ *
4
+ * `id` is the stable identifier used in workflow JSON, Zod validation, and
5
+ * the preview-CSS class suffix. `xfade` is the FFmpeg `xfade transition=`
6
+ * name (or `null` for `cut`, which goes through the concat demuxer).
7
+ *
8
+ * The 5 original ids (`cut`, `fade`, `dissolve`, `dip-to-black`,
9
+ * `dip-to-white`) are kept for back-compat with workflows saved before the
10
+ * picker shipped.
11
+ */
12
+ type CombineTransitionGroup = "fades" | "wipes" | "slides" | "shapes" | "smooth" | "slices" | "reveals" | "covers" | "effects";
13
+ interface CombineTransition {
14
+ readonly id: string;
15
+ readonly label: string;
16
+ /** FFmpeg `xfade transition=` name. `null` = special path (concat demuxer for cut). */
17
+ readonly xfade: string | null;
18
+ readonly group: CombineTransitionGroup;
19
+ readonly common?: boolean;
20
+ readonly description: string;
21
+ }
22
+ declare const COMBINE_TRANSITIONS: readonly CombineTransition[];
23
+ /** All valid transition ids, sorted in catalog order. Use this for Zod enums. */
24
+ declare const COMBINE_TRANSITION_IDS: readonly string[];
25
+ /** Ordered list of group tab keys. `common` is a virtual tab, prepended in UI. */
26
+ declare const COMBINE_TRANSITION_GROUP_ORDER: readonly CombineTransitionGroup[];
27
+ declare const COMBINE_TRANSITION_GROUP_LABELS: Record<CombineTransitionGroup, string>;
28
+ declare function getCombineTransition(id: string): CombineTransition | undefined;
29
+ /**
30
+ * Resolve the FFmpeg `xfade transition=` name for a given transition id.
31
+ * Returns `null` for `cut` (handled via the concat demuxer instead of xfade).
32
+ * Throws for unknown ids — callers validate input via Zod first.
33
+ */
34
+ declare function resolveXfadeName(id: string): string | null;
35
+ /**
36
+ * Map a `transition` PARAMETER-NODE pick (the @nodaro/prompts creative
37
+ * catalog — prose-hint transitions for AI video prompts) onto the ffmpeg
38
+ * xfade vocabulary above. The two vocabularies are deliberately different
39
+ * (the picker describes shots, this table describes blends); only the
40
+ * visually-faithful subset maps — everything else falls back to `cut`.
41
+ *
42
+ * Consumed by the slideshow node (its transition TYPE comes from a wired
43
+ * transition parameter node; unwired defaults to cut). Kept here — not in
44
+ * @nodaro/prompts — because the dependency points prompts → shared, and the
45
+ * ids are plain strings on both sides.
46
+ */
47
+ declare const PICKER_TO_COMBINE_TRANSITION: Readonly<Record<string, string>>;
48
+ /**
49
+ * Resolve ANY transition string a slideshow may receive — a combine id
50
+ * (already valid), a picker id (mapped), or anything else (→ cut).
51
+ */
52
+ declare function resolveSlideshowTransition(value: string | undefined | null): string;
53
+
54
+ /**
55
+ * Curated subset of FFmpeg `acrossfade=curve=...` options for combine-videos
56
+ * audio crossfades. We expose 5 well-understood presets out of the ~21 raw
57
+ * curves FFmpeg supports; the rest are either visually indistinguishable to
58
+ * non-audio-engineers or rarely useful in this context.
59
+ *
60
+ * Default `linear` matches today's behavior — adding this catalog is a pure
61
+ * additive change for existing workflows.
62
+ */
63
+ interface AudioCrossfadeCurve {
64
+ readonly id: string;
65
+ /** FFmpeg `acrossfade=curve=...` name. */
66
+ readonly ffmpeg: string;
67
+ readonly label: string;
68
+ readonly description: string;
69
+ }
70
+ declare const AUDIO_CROSSFADE_CURVES: readonly AudioCrossfadeCurve[];
71
+ declare const AUDIO_CROSSFADE_CURVE_IDS: readonly string[];
72
+ declare const DEFAULT_AUDIO_CROSSFADE_CURVE_ID = "linear";
73
+ declare function getAudioCrossfadeCurve(id: string): AudioCrossfadeCurve | undefined;
74
+ /**
75
+ * Resolve a curve id to its FFmpeg `acrossfade=curve=` name. Unknown ids fall
76
+ * back to `tri` (linear) — this matches the route's Zod default so callers
77
+ * downstream of validation never see undefined.
78
+ */
79
+ declare function resolveAudioCrossfadeCurve(id: string | undefined): string;
80
+
81
+ /**
82
+ * Smart-cut SEARCH WINDOWS — the shared bound + clamp for the
83
+ * `smartCutFramesPrev` / `smartCutFramesNext` of BOTH smart-cut nodes:
84
+ * generate-video-pro (segment boundaries) and combine-videos (clip joins).
85
+ *
86
+ * They bound how much of each side of a boundary the engine considers when
87
+ * it places the cut: N frames from the end of a segment and M from the start
88
+ * of the next. Absent → the engine's own default, byte-identical to the
89
+ * behavior before they were exposed. A boundary the engine cannot resolve
90
+ * inside the window falls back to the fixed freeze-trims; recast pins 24/24.
91
+ *
92
+ * Why a shared clamp: the config panel, the canvas node (single-node Run) and
93
+ * the orchestrator (workflow Run) are three independent writers/send paths into
94
+ * the same route, whose Zod schema REJECTS out-of-range values (its `.min()` /
95
+ * `.max()` are these very constants). Deriving all of them from this one
96
+ * function means a stale, imported or hand-edited node value degrades to a
97
+ * legal request instead of 400-ing an entire run — and the paths cannot drift
98
+ * apart. An `<input type="number" max={…}>` is not a substitute: the browser
99
+ * does not stop a typed or pasted value from reaching React's onChange.
100
+ */
101
+ /** Widest window we accept anywhere — the UI's `max`, the clamp's ceiling and
102
+ * `/v1/combine-videos`' own Zod `.max()` (the generate-video-pro engine route
103
+ * itself accepts up to 48). Past this, added frames only cost search time and
104
+ * invite a false match. */
105
+ declare const SMART_CUT_WINDOW_MAX = 24;
106
+ /** Narrowest meaningful window — one frame each side. */
107
+ declare const SMART_CUT_WINDOW_MIN = 1;
108
+ /** The engine's default when the field is absent. Documented here so the UI
109
+ * can show it as the placeholder without hardcoding a second copy. */
110
+ declare const SMART_CUT_WINDOW_DEFAULT = 8;
111
+ /**
112
+ * Narrow an arbitrary node value to a legal window, or `undefined` to mean
113
+ * "let the engine use its default". Non-numbers, NaN, and non-integers all
114
+ * collapse to `undefined` rather than to a guessed number: a malformed value
115
+ * should fall back to the proven default, not silently pick a different
116
+ * search width than the user asked for.
117
+ */
118
+ declare function clampSmartCutWindow(value: unknown): number | undefined;
119
+
120
+ /**
121
+ * Speaker-view presentation registries — the STRUCTURAL vocabulary behind an
122
+ * EDL segment's `layout` (see `EdlLayout` in `edl.ts`).
123
+ *
124
+ * What lives here is structure only: which layout ids exist, how many slots
125
+ * each takes, which output aspects a renderer exists for, which speaker-switch
126
+ * ids exist and whether they consume output time, and the atomic emphasis
127
+ * styles. Taste — default emphasis, which transitions are allowed or preferred
128
+ * for a show, timing defaults — is deliberately NOT here.
129
+ *
130
+ * Every list is widened ADDITIVELY. That is why a finding judged against one of
131
+ * these registries is a validation WARNING, never an issue: an older validator
132
+ * must never reject an EDL written by a newer producer that knows more ids.
133
+ * An executor that cannot honour an id refuses it itself.
134
+ */
135
+
136
+ declare const EDL_TARGET_ASPECTS: readonly ["16:9", "9:16", "1:1", "4:5"];
137
+ type EdlTargetAspect = (typeof EDL_TARGET_ASPECTS)[number];
138
+ /** Narrow an open `Edl.meta.targetAspect` (or any value) to a known aspect. */
139
+ declare function isEdlTargetAspect(v: unknown): v is EdlTargetAspect;
140
+ interface SpeakerLayoutSheet {
141
+ readonly id: string;
142
+ /** Inclusive slot-count range when a segment lists `layout.slots`. */
143
+ readonly minSlots: number;
144
+ readonly maxSlots: number;
145
+ /** The output aspects this layout is DRAWN for (a renderer exists) — not "looks good". Widened additively. */
146
+ readonly aspects: readonly EdlTargetAspect[];
147
+ }
148
+ declare const SPEAKER_LAYOUTS: readonly SpeakerLayoutSheet[];
149
+ declare const SPEAKER_LAYOUT_IDS: readonly string[];
150
+ declare function getSpeakerLayout(id: string): SpeakerLayoutSheet | undefined;
151
+ /** Omitted query fields are unconstrained. */
152
+ declare function speakerLayoutAllows(sheet: SpeakerLayoutSheet, q: {
153
+ readonly aspect?: EdlTargetAspect;
154
+ readonly slotCount?: number;
155
+ }): boolean;
156
+ /** D17: a switch consumes output time iff it is in the `xfade:*` family. THE one overlap rule (edl.ts uses it). */
157
+ declare function speakerSwitchOverlaps(type: string): boolean;
158
+ interface SpeakerSwitchSheet {
159
+ /** "cut" | "pan" | "zoom" | `xfade:${combine id}` */
160
+ readonly id: string;
161
+ /** = `speakerSwitchOverlaps(id)`, derived, never hand-set. */
162
+ readonly overlaps: boolean;
163
+ /** true only for `pan`: an eased sweep between two regions of ONE picture source. */
164
+ readonly requiresSameSource: boolean;
165
+ }
166
+ /** `cut` / `pan` / `zoom` consume no time (pan: a geometry tween inside ONE
167
+ * source; zoom: a tween inside each segment). The `xfade:*` family is DERIVED
168
+ * from every combine-videos transition that is a real ffmpeg xfade (so never
169
+ * `cut`, which has no xfade) — it is never hand-listed here. */
170
+ declare const SPEAKER_SWITCHES: readonly SpeakerSwitchSheet[];
171
+ declare const SPEAKER_SWITCH_IDS: readonly string[];
172
+ /** A plain lookup: `undefined` for an unknown id (never throws). */
173
+ declare function getSpeakerSwitch(id: string): SpeakerSwitchSheet | undefined;
174
+ /** Atomic emphasis styles; `layout.emphasis.style` is a "+"-joined set of
175
+ * them. `none` stands alone (it means "no emphasis"), and an atom appears at
176
+ * most once. */
177
+ declare const SPEAKER_EMPHASIS_STYLES: readonly ["none", "scale", "border", "dim"];
178
+ type SpeakerEmphasisStyle = (typeof SPEAKER_EMPHASIS_STYLES)[number];
179
+ /** Split a `+`-joined style into its atoms: trimmed, empties dropped. */
180
+ declare function parseSpeakerEmphasisStyle(style: string): readonly string[];
181
+ /** At least one atom, every atom a known `SPEAKER_EMPHASIS_STYLES` id, no
182
+ * atom repeated, and `none` only on its own ("none+scale" contradicts itself). */
183
+ declare function isKnownSpeakerEmphasisStyle(style: string): boolean;
184
+ /** Registry-derived findings — ALL warning-class. Pure; never throws (guard non-array sources/segments the
185
+ * way validateEdl does). `validateEdl` already includes these in its `warnings`; call this directly only
186
+ * when you want the presentation findings alone. */
187
+ declare function speakerPresentationWarnings(edl: Edl): readonly string[];
188
+
189
+ /**
190
+ * EDL — the edit decision list contract.
191
+ *
192
+ * WHY THIS EXISTS
193
+ * The podcast-editing primitives (transcript-driven cut, clip finding,
194
+ * multicam, speaker view) compose because they share ONE data shape: every
195
+ * analysis node produces an EDL, every render node consumes one. This module
196
+ * is that shape plus the pure functions that read it. It is structural
197
+ * vocabulary — no prompts, no heuristics, no editorial judgment — which is why
198
+ * it lives in the Apache-licensed `@nodaro/shared` (the wire shape of
199
+ * `/v1/edl/*`, an SDK type, an MCP output). Every published version is an
200
+ * irrevocable grant, so the three resolved decisions (see below) all land in
201
+ * version 1: renaming a field, or adding a REQUIRED one, later would be a
202
+ * breaking major bump — so every later field is optional and additive.
203
+ *
204
+ * This module is PURE — no I/O, no ffmpeg, no network. The executors
205
+ * (`apply-edl`, `speaker-view`) turn an EDL into pixels; they live in the app
206
+ * and the plugins.
207
+ *
208
+ * DESIGN DECISIONS baked into v1 (so multicam and speaker view extend the
209
+ * contract additively rather than with a breaking bump):
210
+ * - D17 OVERLAP: a crossfade consumes time from the outgoing segment (ffmpeg
211
+ * `xfade`, as combine-videos already does), so the rendered timeline is
212
+ * SHORTER than the sum of segment durations. `edlDurationMs` subtracts the
213
+ * overlap transitions; cut/pan/zoom consume no time (pan: a geometry tween
214
+ * inside ONE source; zoom: a tween inside each segment); only the `xfade:*`
215
+ * family and a segment `crossfade` overlap.
216
+ * - D19 CLOCK/SOURCE/SIGN: `Edl.clock` says whether `segments` are on the
217
+ * source master clock or an output clock; `Transcript.sourceId` says which
218
+ * source a transcript came from; the offset sign is `masterMs = sourceMs +
219
+ * offsetMs(source)`, applied by the remap functions.
220
+ * - D20 PRECEDENCE/RENAME: region precedence
221
+ * `slot.region ▷ segment.region (single-slot only) ▷ a caller's per-slot
222
+ * resolver (v3 tracks) ▷ regions[(source, speaker)] ▷ source.region ▷ full
223
+ * frame`, implemented ONCE by `resolveEdlSegmentSlots` (edl-multicam.ts);
224
+ * `segment.region` is invalid when the segment's layout has more than one
225
+ * slot; `slots[].weight` (0..1, active = 1) replaces the design's
226
+ * `slots[].emphasis` so it no longer collides with `layout.emphasis`
227
+ * ({ style, durationMs }).
228
+ * - P3-8 FOLLOW (decided 2026-10-06, field added decided 2026-10-09): a
229
+ * slot a renderer framed on a face track names that track in
230
+ * `slots[].follow` (`EdlSlotFollow`). It records what the render followed;
231
+ * the path itself is recomputed from the tracks, and `slot.region` keeps a
232
+ * static region, so a reader that ignores `follow` still gets a sane frame.
233
+ *
234
+ * Time is INTEGER MILLISECONDS everywhere. There is no seconds→ms guessing
235
+ * (`normalizeEdl` never reinterprets a unit — an implausible value is a
236
+ * validation error, not a silent 1000× edit).
237
+ */
238
+ declare const EDL_VERSION: 1;
239
+ /** A crop region, as fractions 0..1 of the source frame. */
240
+ interface EdlRegion {
241
+ readonly x: number;
242
+ readonly y: number;
243
+ readonly w: number;
244
+ readonly h: number;
245
+ }
246
+ declare const EDL_SOURCE_ROLES: readonly ["master-audio", "camera", "wide", "screen"];
247
+ type EdlSourceRole = (typeof EDL_SOURCE_ROLES)[number];
248
+ /** A media input to the edit. Ids are minted once (by `edit-plan`) and never
249
+ * re-derived, so downstream nodes resolve media from `url` in the data, not
250
+ * from canvas handle order. Keep the `url` key: the cloud relay re-hosts
251
+ * private media by walking `url`-suffixed fields. */
252
+ interface EdlSource {
253
+ readonly id: string;
254
+ readonly url: string;
255
+ readonly kind: "video" | "audio";
256
+ /** This source's origin on the master clock. `masterMs = sourceMs + offsetMs`. Default 0. */
257
+ readonly offsetMs?: number;
258
+ /** Known roles: EDL_SOURCE_ROLES. Open (`string & {}`) so an EDL written by a newer producer still type-checks
259
+ * and still validates — an unknown role is a WARNING (validateEdl); an executor that cannot honour it refuses it. */
260
+ readonly role?: EdlSourceRole | (string & {});
261
+ /** Speaker labels this source frames (multicam). Empty = unknown. */
262
+ readonly speakers?: readonly string[];
263
+ /** A static crop for this source (speaker-view v1 framing). */
264
+ readonly region?: EdlRegion;
265
+ }
266
+ type EdlSlotFollowMotion = "static" | "glide";
267
+ /** The face track a slot followed (P3-8). `sourceId` is the slot's own video
268
+ * source; `trackId` is a track id of the speaker-track set the render read
269
+ * (unique in that set); `motion` is how it followed: `static` = one region
270
+ * per segment from the track, `glide` = a moving crop along it. Additive and
271
+ * optional: an EDL without it is unchanged. */
272
+ interface EdlSlotFollow {
273
+ readonly sourceId: string;
274
+ readonly trackId: string;
275
+ readonly motion: EdlSlotFollowMotion;
276
+ }
277
+ /** How a segment is presented on screen (speaker-view, phase 2). `mode` and
278
+ * `transition.type` are ids from the `SPEAKER_LAYOUTS` / `SPEAKER_SWITCHES`
279
+ * registries (speaker-layouts.ts); `emphasis.style` is a `+`-joined set of
280
+ * atomic `SPEAKER_EMPHASIS_STYLES` (e.g. "scale+border"). Unknown ids are
281
+ * validation WARNINGS, and `mode` stays an open string on purpose. v1 leaves
282
+ * layout undefined (single camera). */
283
+ interface EdlLayout {
284
+ /** "single" | "side-by-side" | "stacked" | "grid" | "pip" | … */
285
+ readonly mode: string;
286
+ readonly slots?: ReadonlyArray<{
287
+ readonly source: string;
288
+ readonly region?: EdlRegion;
289
+ readonly speaker?: string;
290
+ /** D20: 0..1, the active slot = 1. (Was `emphasis`; renamed to avoid
291
+ * colliding with `layout.emphasis`.) */
292
+ readonly weight?: number;
293
+ /** P3-8: the face track this slot followed. `region` then holds the
294
+ * static region an older reader draws. */
295
+ readonly follow?: EdlSlotFollow;
296
+ }>;
297
+ /** A "+"-joined set of "none" | "scale" | "border" | "dim" | …, eased over durationMs. */
298
+ readonly emphasis?: {
299
+ readonly style: string;
300
+ readonly durationMs: number;
301
+ };
302
+ /** Into THIS segment. "cut" | "pan" | "zoom" consume no time; "xfade:<id>" overlaps (D17).
303
+ * `durationMs` never consumes timeline time for the non-overlap types: it
304
+ * is the tween length for `pan` / `zoom` and is ignored for `cut`. */
305
+ readonly transition?: {
306
+ readonly type: string;
307
+ readonly durationMs?: number;
308
+ };
309
+ }
310
+ interface EdlSegment {
311
+ readonly id: string;
312
+ /** On the MASTER clock. */
313
+ readonly inMs: number;
314
+ /** Exclusive, > inMs. */
315
+ readonly outMs: number;
316
+ /** `EdlSource.id` supplying picture. Omit = audio-only EDL. */
317
+ readonly video?: string;
318
+ /** `EdlSource.id` supplying sound. Default: the unique `role:"master-audio"` source, else `video`. */
319
+ readonly audio?: string;
320
+ /** Dominant speaker label (informational). */
321
+ readonly speaker?: string;
322
+ /** Into THIS segment. Only "crossfade" consumes time (D17); never on segments[0].
323
+ * `durationMs` is optional and inert for "cut". */
324
+ readonly transition?: {
325
+ readonly type: "cut" | "crossfade";
326
+ readonly durationMs?: number;
327
+ };
328
+ /** Per-segment crop override — SINGLE-slot only (D20). */
329
+ readonly region?: EdlRegion;
330
+ readonly layout?: EdlLayout;
331
+ /** Free tags: "hook", "chapter:2", … (removed spans live in `Edl.dropped`). */
332
+ readonly labels?: readonly string[];
333
+ }
334
+ interface EdlDropped {
335
+ readonly inMs: number;
336
+ readonly outMs: number;
337
+ readonly reason: "silence" | "filler" | "false-start" | "tangent" | "manual" | string;
338
+ }
339
+ interface Edl {
340
+ readonly version: 1;
341
+ /** D19: are `segments` on the source master clock, or an already-rendered output clock? */
342
+ readonly clock: "master" | "output";
343
+ readonly sources: readonly EdlSource[];
344
+ /** The ordered output timeline. Output time = cumulative segment durations, less overlap transitions. */
345
+ readonly segments: readonly EdlSegment[];
346
+ readonly dropped?: readonly EdlDropped[];
347
+ /** Set when this EDL was re-cut from a rendered output (speaker-view after apply-edl). */
348
+ readonly derivedFrom?: {
349
+ readonly edlId: string;
350
+ readonly clock: "output";
351
+ };
352
+ readonly meta?: {
353
+ readonly title?: string;
354
+ readonly hook?: string;
355
+ /** Known aspects: `EDL_TARGET_ASPECTS`. Open (`string & {}`) so an EDL
356
+ * written by a newer producer still type-checks — an unknown aspect is a
357
+ * validation WARNING (validateEdl), never an issue. */
358
+ readonly targetAspect?: EdlTargetAspect | (string & {});
359
+ readonly platform?: string;
360
+ readonly notes?: string;
361
+ };
362
+ }
363
+ /** The `clips` mode's response/SDK shape. On the canvas the node emits a bare
364
+ * `Edl[]` (T5: the `list` fan-out reads a top-level JSON array), and the
365
+ * cloud relay writes `output_data` as this object — the unwrap to the bare
366
+ * array happens in the output extractors, never in `output_data`. */
367
+ interface EdlClipSet {
368
+ readonly version: 1;
369
+ readonly clips: readonly Edl[];
370
+ }
371
+ /** The `chapters` mode's `output_data` shape — a plain `data` list. */
372
+ interface ChapterSet {
373
+ readonly version: 1;
374
+ readonly chapters: ReadonlyArray<{
375
+ readonly startMs: number;
376
+ readonly title: string;
377
+ }>;
378
+ }
379
+ /** The normalized JSON form of a transcribe result. */
380
+ interface Transcript {
381
+ readonly version: 1;
382
+ /** D19: which `EdlSource` this transcript was made from (drives the offset in remap). */
383
+ readonly sourceId?: string;
384
+ readonly language?: string;
385
+ readonly words: ReadonlyArray<{
386
+ readonly text: string;
387
+ readonly startMs: number;
388
+ readonly endMs: number;
389
+ readonly speaker?: string;
390
+ readonly confidence?: number;
391
+ }>;
392
+ readonly segments?: ReadonlyArray<{
393
+ readonly startMs: number;
394
+ readonly endMs: number;
395
+ readonly text: string;
396
+ readonly speaker?: string;
397
+ }>;
398
+ /** Raw speaker label → the display name the words and segments now carry,
399
+ * published by a node that renamed the speakers (Camera Switch), so a later
400
+ * node can still find a speaker's original label. Absent = not renamed. */
401
+ readonly speakerNames?: Readonly<Record<string, string>>;
402
+ }
403
+ /** Duration (seconds) implied by a transcript — the LATEST word/segment `endMs`
404
+ * across the whole transcript, in seconds. The edit-plan reserve's duration
405
+ * fallback BENEATH the master-source ffprobe (`computeEditPlanReserveId`): the
406
+ * authoritative reserve basis is a probe of the master media, exactly like the
407
+ * plugin route; this transcript clock is used only in `buildPayload` (which
408
+ * cannot ffprobe) and when that probe can't run, for a MASTER source node that
409
+ * exposes no length of its own (a `reference-audio`/youtube or direct-URL
410
+ * master carries its length in neither `data.duration` nor
411
+ * `metadata.durationSeconds` — see `editPlanSourceDurationSec` — and its live
412
+ * orchestrator output is a bare URL). The transcript is a REQUIRED edit-plan
413
+ * input and is the timing map of that same master, so its last word's `endMs`
414
+ * is a lower bound on the source's own clock.
415
+ *
416
+ * Accepts `unknown` because the cloud plugin's Zod is the transcript's schema
417
+ * authority; this reads defensively and returns `undefined` for any shape it
418
+ * can't measure (so the caller falls back to the ceiling bucket — the safe
419
+ * over-reserve direction). Takes the MAX endMs rather than the last element so
420
+ * an out-of-order words array can't under-report. NOTE the direction: a
421
+ * transcript's last spoken word ends at or before the true media end (trailing
422
+ * music/silence is not transcribed), so this can UNDER-estimate; bucket
423
+ * round-up is the headroom, and the cloud re-probe money-gate refuses (never
424
+ * overcharges) if the probed master still exceeds the reserved bucket. */
425
+ declare function transcriptDurationSec(transcript: unknown): number | undefined;
426
+ /** Rendered duration of the edit, in ms. Σ segment durations minus the
427
+ * overlap transitions (D17: an `xfade`/`crossfade` compresses the timeline
428
+ * by its duration per boundary; `cut`/`pan`/`zoom` do not). Total over BOTH
429
+ * the segment- and layout-transition fields.
430
+ *
431
+ * Derived FROM `segmentOutputStarts` so the invariant
432
+ * `outputStart(last) + dur(last) === edlDurationMs` holds by construction on
433
+ * every input — including a normalized-but-not-yet-validated EDL (the reserve
434
+ * runs this before validate). The two must never be two independent overlap
435
+ * implementations that can drift. */
436
+ declare function edlDurationMs(edl: Edl): number;
437
+ /** The output-clock start time of each segment (index-aligned to
438
+ * `edl.segments`), accounting for D17 overlap: the transition INTO segment k
439
+ * pulls its duration back from the boundary. `outputStart(0) = 0`;
440
+ * `outputStart(n) + dur(n) === edlDurationMs`. The one output clock every
441
+ * remap reads — a player seeking a rendered cut reads it too. */
442
+ declare function edlSegmentOutputStarts(edl: Edl): number[];
443
+ /** Library-produced (never construct one yourself — fields may be added). `ok` is `issues.length === 0`;
444
+ * warnings never flip it. Issues = facts intrinsic to the EDL. Warnings = judgements against a REGISTRY
445
+ * (source roles, speaker layouts/switches/emphasis, target aspects) that a newer version may widen — so an
446
+ * older validator never rejects a newer EDL. */
447
+ interface EdlValidation {
448
+ readonly ok: boolean;
449
+ readonly issues: readonly string[];
450
+ readonly warnings: readonly string[];
451
+ }
452
+ /** Structural validation. Coercion (defaults, clamping) is `normalizeEdl`'s
453
+ * job; this reports what is still wrong after normalization. Segment ORDER is
454
+ * the output timeline order and is NOT required to be monotonic on the master
455
+ * clock — a legitimate multicam/clips EDL revisits earlier source time — so
456
+ * the only per-segment ordering rule is `outMs > inMs`.
457
+ *
458
+ * The transition duration bound is the per-boundary ffmpeg-`xfade` limit: the
459
+ * blend must be shorter than the adjacent material, so we validate at
460
+ * `0.9 · min(the two adjacent segments)`. (combine-videos uses a more
461
+ * conservative GLOBAL `0.9 · min(all clips)`; the per-boundary bound here is
462
+ * the correct one, and the `apply-edl` executor must clamp per-boundary too —
463
+ * copying combine's global-min would let validate pass a transition the
464
+ * renderer then silently shortens, the R5 silent-edit this bound prevents.)
465
+ * It applies only to overlap transitions; `cut`/`pan`/`zoom` are unbounded. */
466
+ declare function validateEdl(edl: Edl): EdlValidation;
467
+ /** Validate a clip set (the `clips` mode output). */
468
+ declare function validateEdlClipSet(set: EdlClipSet): EdlValidation;
469
+ /**
470
+ * Map an instant on `sourceId`'s clock to the rendered output clock, or `null`
471
+ * if that instant was dropped (falls in no kept segment). Applies the D19
472
+ * offset (`masterMs = sourceMs + offsetMs`) and the D17 overlap compression.
473
+ * `sourceId` omitted ⇒ the instant is already on the master clock.
474
+ */
475
+ declare function remapMsThroughEdl(edl: Edl, sourceMs: number, sourceId?: string): number | null;
476
+ /**
477
+ * The inverse of `remapMsThroughEdl`: the master-clock instant the rendered
478
+ * output plays at `outputMs`, or `null` before the start, at or past the end,
479
+ * and for a non-finite time. Inside a crossfade both segments play; the
480
+ * INCOMING one (the later segment) is the one named, since the cut has moved
481
+ * to it. On an EDL that never revisits master time (a Tighten cut),
482
+ * `remapMsThroughEdl(edl, outputMsToMasterMs(edl, t)) === t` for every output
483
+ * instant `t`; an EDL that re-reads a span maps two output instants to one
484
+ * master instant, and the remap names the first.
485
+ */
486
+ declare function outputMsToMasterMs(edl: Edl, outputMs: number): number | null;
487
+ /**
488
+ * Remap a transcript onto the rendered output: drop words that fall entirely
489
+ * in removed material, clip a word that straddles a cut to its kept part (a
490
+ * word running across two TOUCHING segments — contiguous on both the master
491
+ * and the output clock — is not cut, and keeps its full length), and apply
492
+ * the source offset (via `transcript.sourceId`). Captions, chapters and
493
+ * clip offsets all depend on this one function.
494
+ */
495
+ declare function remapTranscriptThroughEdl(edl: Edl, transcript: Transcript): Transcript;
496
+ /** Speaker turns: consecutive same-speaker words merged across gaps shorter
497
+ * than `mergeGapMs`, then turns shorter than `minTurnMs` dropped. */
498
+ declare function speakerTurns(transcript: Transcript, opts: {
499
+ minTurnMs: number;
500
+ mergeGapMs: number;
501
+ }): Array<{
502
+ speaker: string;
503
+ startMs: number;
504
+ endMs: number;
505
+ }>;
506
+ /**
507
+ * Coerce an unknown value into a well-formed `Edl`: fill defaults, drop unknown
508
+ * fields, clamp regions to 0..1. All times are integer ms — there is NO
509
+ * seconds→ms guessing (an integer-seconds EDL would silently become a
510
+ * 1000×-longer edit; the contract is ms-only and a value that cannot be a
511
+ * plausible ms EDL is a validation error, not a reinterpretation).
512
+ *
513
+ * Segment ORDER is preserved verbatim: it is the output timeline order, and a
514
+ * multicam/clips EDL legitimately revisits earlier source time, so re-sorting
515
+ * would corrupt it. (`dropped` has no ordering semantics and is left as-is.)
516
+ */
517
+ declare function normalizeEdl(input: unknown): Edl;
518
+ /**
519
+ * Coerce an unknown value into a `Transcript` — THE transcript reader
520
+ * (decided 2026-10-08). The Cloud plugin's `coerceTranscript` reads by the
521
+ * same rule, so the app and the plugin read one transcript the same way.
522
+ * ms-only, as `normalizeEdl`; the `start`/`end` aliases are read when
523
+ * `startMs`/`endMs` are absent. A zero-width word or segment (also one that
524
+ * rounds to zero width) is a POINT and is kept, as before. Only a broken one
525
+ * is dropped, never clamped: a missing start or end, a time that is not a
526
+ * finite, non-negative number, or an end before its start. Words come out
527
+ * sorted by start time (stable). A renamed transcript's `speakerNames` map is
528
+ * kept (its non-empty string entries).
529
+ */
530
+ declare function normalizeTranscript(input: unknown): Transcript;
531
+
532
+ /**
533
+ * Multicam helpers over the EDL contract (`edl.ts`): folding measured source
534
+ * offsets into an EDL (D19) and resolving what each on-screen slot of a
535
+ * segment shows (D20). Pure — no I/O. Type-only imports from `edl.ts` keep the
536
+ * module graph free of runtime cycles.
537
+ */
538
+
539
+ /** audio-sync → EDL source offsets (D19: masterMs = sourceMs + offsetMs).
540
+ * `offsets` are measured against ONE common reference (audio-sync's `reference`, which need not be the master).
541
+ * ANCHORED SET: anchor = opts.anchor ?? the unique role:"master-audio" source ?? none.
542
+ * - The anchor's own offsetMs is NEVER changed (the segments are on its clock).
543
+ * - Every other provided source s: offsetMs = round((anchor.offsetMs ?? 0) + offsets[s] − (offsets[anchor] ?? 0)).
544
+ * - No anchor: offsetMs = round(offsets[s]) verbatim (offsets already relative to the master clock).
545
+ * SET, never ADD (re-running is idempotent). Returns a new Edl; never mutates; never throws.
546
+ * `ignored[].reason` is a documented open string: "unknown-source" | "not-finite" | "anchor-unknown" | "anchor-not-finite".
547
+ * opts.anchor not in edl.sources → NOTHING applied, ignored = [{ sourceId: anchor, reason: "anchor-unknown" }].
548
+ * offsets[anchor] present but non-finite → NOTHING applied, ignored = [{ sourceId: anchor, reason: "anchor-not-finite" }]. */
549
+ declare function mergeEdlSourceOffsets(edl: Edl, offsets: Readonly<Record<string, number>>, opts?: {
550
+ readonly anchor?: string;
551
+ }): {
552
+ readonly edl: Edl;
553
+ /** The source the offsets were anchored to — present whenever one resolved (it exists in `edl.sources`). */
554
+ readonly anchor?: string;
555
+ /** Source ids whose `offsetMs` was set, in `offsets` key order. */
556
+ readonly applied: readonly string[];
557
+ readonly ignored: ReadonlyArray<{
558
+ readonly sourceId: string;
559
+ readonly reason: string;
560
+ }>;
561
+ };
562
+ /** Below this, a measured offset is not trusted (audio-sync's own
563
+ * "check it by ear" line). */
564
+ declare const AUDIO_SYNC_MIN_CONFIDENCE = 0.5;
565
+ /** One source row as a planner (edit-plan) sends it. */
566
+ interface AudioSyncOffsetSource {
567
+ readonly id: string;
568
+ readonly role?: string;
569
+ /** Set = a hand-set offset, which always wins over a measured one. */
570
+ readonly offsetMs?: number;
571
+ }
572
+ /** Why measured offsets could not be applied. Every code names the source to
573
+ * fix, so a caller can phrase it with its own label (`describeAudioSyncOffsetIssue`). */
574
+ type AudioSyncOffsetIssue = {
575
+ readonly code: "not-audio-sync";
576
+ } | {
577
+ readonly code: "invalid-offset";
578
+ readonly sourceId: string;
579
+ } | {
580
+ readonly code: "anchor-offset";
581
+ readonly sourceId: string;
582
+ readonly offsetMs: number;
583
+ } | {
584
+ readonly code: "anchor-unmeasured";
585
+ readonly sourceId: string;
586
+ } | {
587
+ readonly code: "weak-match";
588
+ readonly sourceId: string;
589
+ readonly confidence: number;
590
+ readonly anchor: boolean;
591
+ } | {
592
+ readonly code: "unmeasured";
593
+ readonly sourceId: string;
594
+ };
595
+ type AudioSyncOffsetsResult<S> = {
596
+ readonly ok: true;
597
+ /** The sources, with the measured offsets written onto `offsetMs`. */
598
+ readonly sources: S[];
599
+ /** The source whose clock the offsets are anchored to. */
600
+ readonly anchor?: string;
601
+ /** Source ids that took a measured offset. */
602
+ readonly applied: readonly string[];
603
+ } | {
604
+ readonly ok: false;
605
+ readonly issues: readonly AudioSyncOffsetIssue[];
606
+ };
607
+ /** B4 — audio-sync's measured offsets → a planner's `sources[].offsetMs`
608
+ * (decided 2026-09-25). The planner makes its plan on its MASTER's clock:
609
+ * the `master-audio` source, else its first source (edit-plan's own rule) —
610
+ * the ANCHOR. Every other source gets `offsetMs = measured(s) − measured(anchor)`
611
+ * (D19 via `mergeEdlSourceOffsets`), so audio-sync's reference need not be the
612
+ * master. Never out of sync silently — each of these is an issue instead:
613
+ * - a source with a hand-set `offsetMs` keeps it (it always wins);
614
+ * - a source audio-sync did not measure → "unmeasured";
615
+ * - a measured source under `AUDIO_SYNC_MIN_CONFIDENCE` → "weak-match";
616
+ * - the anchor unmeasured / weak, when any source needs it → "anchor-…";
617
+ * - a hand-set non-zero offset on the anchor → "anchor-offset" (its clock is the plan's).
618
+ * Rows for sources the planner does not have are ignored. Pure; never throws. */
619
+ declare function applyAudioSyncOffsets<S extends AudioSyncOffsetSource>(sources: readonly S[], sync: unknown): AudioSyncOffsetsResult<S>;
620
+ /** Why edit-plan's sources cannot be planned as given: an audio-sync issue,
621
+ * or a transcript made from a recording that is off the plan's clock. */
622
+ type EditPlanSourceIssue = AudioSyncOffsetIssue | {
623
+ readonly code: "transcript-off-clock";
624
+ readonly sourceId: string;
625
+ readonly masterId: string;
626
+ readonly offsetMs: number;
627
+ };
628
+ /** B4 — the ONE check every edit-plan caller runs before dispatch (the
629
+ * orchestrator, the editor, MCP, the SDK), so a plan that would render out of
630
+ * sync fails before charging (decided 2026-09-25):
631
+ * - `offsets` given (audio-sync's result; null/"" when wired but empty) →
632
+ * `applyAudioSyncOffsets`;
633
+ * - the master's own offset must be 0 (the plan follows its clock);
634
+ * - `transcriptSourceId` (the recording the transcript was made from, when
635
+ * known) must be on the master's clock: the master itself, or a source
636
+ * whose offset is 0. Unknown → assumed the master's.
637
+ * `transcriptSourceId` is echoed back only when it names one of the sources,
638
+ * for the caller to stamp on the transcript. Pure; never throws. */
639
+ declare function resolveEditPlanSources<S extends AudioSyncOffsetSource>(sources: readonly S[], opts?: {
640
+ readonly offsets?: unknown;
641
+ readonly transcriptSourceId?: string;
642
+ }): {
643
+ readonly ok: true;
644
+ readonly sources: S[];
645
+ readonly transcriptSourceId?: string;
646
+ } | {
647
+ readonly ok: false;
648
+ readonly issues: readonly EditPlanSourceIssue[];
649
+ };
650
+ /** The recording a transcript was made from, traced on a canvas: the node
651
+ * feeding the transcribing node, through clock-preserving hops (extract-audio).
652
+ * Undefined when the producer is not a transcriber or the trace is ambiguous
653
+ * (more than one upstream) — the caller then assumes the master's clock. */
654
+ declare function editPlanTranscriptOrigin(producerId: string, typeOf: (nodeId: string) => string | undefined, edges: ReadonlyArray<{
655
+ readonly source: string;
656
+ readonly target: string;
657
+ }>): string | undefined;
658
+ /** A plain-language line for one issue; `labelOf` turns a source id into the
659
+ * name the user sees (a canvas node's label, say). */
660
+ declare function describeAudioSyncOffsetIssue(issue: EditPlanSourceIssue, labelOf?: (sourceId: string) => string): string;
661
+ declare const EDL_FULL_FRAME: EdlRegion;
662
+ interface EdlResolvedSlot {
663
+ readonly source: string;
664
+ readonly region: EdlRegion;
665
+ /** "resolver" = the caller's `regionFor` (v3 per-segment tracks). */
666
+ readonly regionFrom: "slot" | "segment" | "resolver" | "speaker" | "source" | "full";
667
+ readonly speaker?: string;
668
+ readonly weight?: number;
669
+ }
670
+ interface ResolveEdlSlotsOptions {
671
+ /** speaker-view's per-speaker framing table (a node SETTING, not an EDL field), keyed by (source, speaker) so a
672
+ * wide-shot region never lands on a close-up camera framing the same person. */
673
+ readonly speakerRegions?: ReadonlyArray<{
674
+ readonly source: string;
675
+ readonly speaker: string;
676
+ readonly region: EdlRegion;
677
+ }>;
678
+ /** v3 hook: a per-(segment, slot) region, e.g. from a face track. Undefined = no opinion. */
679
+ readonly regionFor?: (q: {
680
+ readonly segment: EdlSegment;
681
+ readonly source: string;
682
+ readonly speaker?: string;
683
+ }) => EdlRegion | undefined;
684
+ }
685
+ /** D20 — the ONE region-precedence implementation:
686
+ * slot.region ▷ segment.region (single-slot only) ▷ regionFor ▷ speakerRegions[(source, speaker)] ▷ source.region ▷ full frame.
687
+ * Slots = layout.slots when non-empty, else ONE implicit slot from segment.video (no video → []).
688
+ * A slot's speaker = slot.speaker ?? (single slot ? segment.speaker : undefined); no speaker → the speaker rung is skipped.
689
+ * A rung whose region is not a valid in-frame box (finite, 0..1, w/h > 0, x+w ≤ 1, y+h ≤ 1) falls through to the next.
690
+ * Unknown source id → the source rung is skipped. Pure; never throws on its own. */
691
+ declare function resolveEdlSegmentSlots(edl: Edl, segment: EdlSegment, opts?: ResolveEdlSlotsOptions): readonly EdlResolvedSlot[];
692
+
693
+ /**
694
+ * Speaker tracks — where each speaker's face is, over time, per camera.
695
+ *
696
+ * WHY THIS EXISTS
697
+ * A face-tracking analysis node samples each camera an edit shows, finds the
698
+ * faces, links them into tracks and labels each track with a speaker. Its
699
+ * result feeds the framing rung `resolveEdlSegmentSlots` reserves for a
700
+ * per-segment resolver (D20, edl-multicam.ts). This module is the wire shape
701
+ * of that result plus the pure functions that read it: structural vocabulary
702
+ * only — no detector, no linking or attribution rule, no framing or follow
703
+ * math, no thresholds. That is why it lives in the Apache-licensed
704
+ * `@nodaro/shared` (the public contract: the API response, the SDK type and
705
+ * the MCP output). Every published version is an irrevocable grant, so every
706
+ * later field is optional and additive.
707
+ *
708
+ * TWO SHAPES, ONE PROJECTION
709
+ * - `SpeakerTrackSet` — the full set, boxes included. At a long multi-camera
710
+ * edit it is megabytes of JSON, so it is stored as a JSON artifact (the
711
+ * versioned box body), never inline in a job row or a node's data.
712
+ * - `SpeakerTrackSetDescriptor` — what the node outputs: the same set with
713
+ * every box removed (a `boxCount` per track instead) plus the artifact's
714
+ * `url`, `sha256` and `bytes`. Consumers fetch the body by URL, check the
715
+ * hash, run `normalizeSpeakerTracks` + `validateSpeakerTracks` on it, and
716
+ * can confirm it is the body the descriptor names with
717
+ * `describeSpeakerTracks(body, artifact)` deep-equal to the descriptor.
718
+ *
719
+ * CLOCK (D19)
720
+ * Boxes are per SOURCE and on that source's own clock (`clock: "source"`), in
721
+ * integer ms. A consumer maps to the master clock through the EDL source's
722
+ * offset: `masterMs = ms + offsetMs` (`remapMsThroughEdl(edl, ms, sourceId)`).
723
+ * Nothing here applies the offset, and nothing ever rescales a time (no
724
+ * seconds→ms guessing — an implausible value is a validation error).
725
+ *
726
+ * GEOMETRY
727
+ * Box coordinates are fractions 0..1 of `frame`: the display-oriented frame
728
+ * (after rotation, square pixels) the producer sampled.
729
+ *
730
+ * SAMPLING
731
+ * `sampledSpans` say what was looked at. No box for a track outside them means
732
+ * "not sampled"; inside them it means "no face there". Spans are half-open
733
+ * `[startMs, endMs)`, like EDL segments.
734
+ */
735
+ declare const SPEAKER_TRACKS_VERSION: 1;
736
+ /** How a track got its speaker. Open: a newer producer may add a method, which
737
+ * an older validator reports as a WARNING, never an issue. */
738
+ declare const SPEAKER_TRACK_ATTRIBUTION_METHODS: readonly ["source-map", "region", "mouth-motion", "manual"];
739
+ type SpeakerTrackAttributionMethod = (typeof SPEAKER_TRACK_ATTRIBUTION_METHODS)[number];
740
+ /** Default hard cap on boxes per source. The longest edit the platform plans
741
+ * for (180 minutes) sampled at 2 per second is 21,600 samples per source; the
742
+ * cap leaves room for several faces in every sample. Override per call with
743
+ * `maxBoxesPerSource`. */
744
+ declare const SPEAKER_TRACKS_MAX_BOXES_PER_SOURCE = 100000;
745
+ /** Default hard cap on the serialized size of a track set (UTF-8 bytes of its
746
+ * JSON), so no consumer ever loads an unbounded body. Override per call with
747
+ * `maxBytes`. */
748
+ declare const SPEAKER_TRACKS_MAX_BYTES: number;
749
+ /** One detection. `ms` on the source clock; x/y/w/h fractions 0..1 of the frame. */
750
+ interface SpeakerTrackBox {
751
+ readonly ms: number;
752
+ readonly x: number;
753
+ readonly y: number;
754
+ readonly w: number;
755
+ readonly h: number;
756
+ /** Detector confidence 0..1, when the detector reports one. */
757
+ readonly score?: number;
758
+ }
759
+ interface SpeakerTrackAttribution {
760
+ /** Known: `SPEAKER_TRACK_ATTRIBUTION_METHODS`. */
761
+ readonly method: SpeakerTrackAttributionMethod | (string & {});
762
+ /** 0..1. */
763
+ readonly confidence: number;
764
+ /** The transcript's own label for this speaker, kept beside the display name
765
+ * in `speaker` so a later rename re-maps instead of orphaning the track. */
766
+ readonly rawSpeaker?: string;
767
+ }
768
+ /** What a track says about itself, without its boxes. */
769
+ interface SpeakerTrackHeader {
770
+ /** Unique in the whole set, e.g. "wide/t3". */
771
+ readonly id: string;
772
+ /** A label in the edit's speaker space. Absent = unattributed. */
773
+ readonly speaker?: string;
774
+ readonly attribution?: SpeakerTrackAttribution;
775
+ }
776
+ interface SpeakerTrack extends SpeakerTrackHeader {
777
+ /** Strictly increasing `ms`, each inside one of the source's `sampledSpans`. */
778
+ readonly boxes: readonly SpeakerTrackBox[];
779
+ }
780
+ interface SpeakerTrackSummary extends SpeakerTrackHeader {
781
+ readonly boxCount: number;
782
+ }
783
+ interface SpeakerTrackSpan {
784
+ readonly startMs: number;
785
+ /** Exclusive, > startMs. */
786
+ readonly endMs: number;
787
+ }
788
+ interface SpeakerTrackSourceFields {
789
+ /** `EdlSource.id` of a video source. */
790
+ readonly sourceId: string;
791
+ /** Boxes, spans and cuts are ms on this SOURCE's own clock (D19). */
792
+ readonly clock: "source";
793
+ /** The display-oriented frame (after rotation, square pixels), in pixels, that box fractions refer to. */
794
+ readonly frame: {
795
+ readonly w: number;
796
+ readonly h: number;
797
+ };
798
+ /** What was sampled: sorted, non-overlapping, half-open. */
799
+ readonly sampledSpans: readonly SpeakerTrackSpan[];
800
+ /** Source-clock ms of detected scene changes, ascending. No track spans one. */
801
+ readonly cuts?: readonly number[];
802
+ }
803
+ interface SpeakerTrackSource extends SpeakerTrackSourceFields {
804
+ readonly tracks: readonly SpeakerTrack[];
805
+ }
806
+ interface SpeakerTrackSourceSummary extends SpeakerTrackSourceFields {
807
+ readonly tracks: readonly SpeakerTrackSummary[];
808
+ }
809
+ interface SpeakerTrackSetFields {
810
+ readonly version: 1;
811
+ /** Samples per second the producer looked at. */
812
+ readonly sampleFps: number;
813
+ /** Informational: which detector produced the boxes, e.g. "example:face-detector". */
814
+ readonly detector: {
815
+ readonly id: string;
816
+ readonly version?: string;
817
+ };
818
+ }
819
+ /** The full set — the versioned box body, stored as a JSON artifact. */
820
+ interface SpeakerTrackSet extends SpeakerTrackSetFields {
821
+ readonly sources: readonly SpeakerTrackSource[];
822
+ }
823
+ /** What the analysis node outputs: the set without its boxes, plus where the body is. */
824
+ interface SpeakerTrackSetDescriptor extends SpeakerTrackSetFields {
825
+ readonly sources: readonly SpeakerTrackSourceSummary[];
826
+ /** Where the `SpeakerTrackSet` body is stored. */
827
+ readonly url: string;
828
+ /** SHA-256 of the stored body's bytes, 64 lowercase hex characters. */
829
+ readonly sha256: string;
830
+ /** Size of the stored body in bytes. */
831
+ readonly bytes: number;
832
+ }
833
+ /**
834
+ * Coerce an unknown value into a well-formed `SpeakerTrackSet` (the box body):
835
+ * drop unknown keys and malformed boxes, crop every box to the frame (an
836
+ * entirely off-frame box is dropped, an overhang keeps its visible part), clamp
837
+ * scores and confidences to 0..1, round every time to integer ms, sort each
838
+ * track's boxes by time (box order IS time, unlike EDL segment order), sort and
839
+ * merge sampled spans, sort and de-duplicate cuts.
840
+ *
841
+ * It never repairs what would change meaning: a box outside every sampled
842
+ * span, two boxes at one instant, a track across a cut, another version or
843
+ * another clock all survive for `validateSpeakerTracks` to report.
844
+ */
845
+ declare function normalizeSpeakerTracks(input: unknown): SpeakerTrackSet;
846
+ /** Coerce an unknown value into a `SpeakerTrackSetDescriptor`, by the same rules
847
+ * as `normalizeSpeakerTracks`; a missing or broken `boxCount` becomes 0. */
848
+ declare function normalizeSpeakerTrackSetDescriptor(input: unknown): SpeakerTrackSetDescriptor;
849
+ /** The descriptor of a (normalized) set stored at `artifact.url`: every box
850
+ * removed, a `boxCount` per track. Pure; the caller hashes and stores the body. */
851
+ declare function describeSpeakerTracks(set: SpeakerTrackSet, artifact: {
852
+ readonly url: string;
853
+ readonly sha256: string;
854
+ readonly bytes: number;
855
+ }): SpeakerTrackSetDescriptor;
856
+ /** The speaker labels an edit uses: the union of `sources[].speakers`,
857
+ * `segments[].speaker` and `segments[].layout.slots[].speaker`, over every EDL
858
+ * given (a clip pack), sorted by code unit. Tracks must be labelled in this
859
+ * space, or no track ever matches a segment's speaker. */
860
+ declare function edlSpeakerSpace(edl: Edl | readonly Edl[]): string[];
861
+ interface SpeakerTracksValidateOptions {
862
+ /** The edit the tracks are for — one EDL, or every clip of a pack. When given,
863
+ * every source must resolve to one of its video sources, and attributed
864
+ * speakers must be in its speaker space (`edlSpeakerSpace`). */
865
+ readonly edl?: Edl | readonly Edl[];
866
+ /** Default `SPEAKER_TRACKS_MAX_BOXES_PER_SOURCE`. */
867
+ readonly maxBoxesPerSource?: number;
868
+ /** Default `SPEAKER_TRACKS_MAX_BYTES`. */
869
+ readonly maxBytes?: number;
870
+ /** `validateSpeakerTracks` only: the body's known size in bytes (e.g. the
871
+ * fetched length), so a large body is not serialized again to measure it. */
872
+ readonly serializedBytes?: number;
873
+ }
874
+ /**
875
+ * Structural validation of a track set (the box body). Normalization is
876
+ * `normalizeSpeakerTracks`'s job; this reports what is still wrong after it.
877
+ * Issues are facts intrinsic to the set (or to the set against the EDL);
878
+ * warnings are judgements an older validator must not turn into a refusal
879
+ * (an unknown attribution method, one stray speaker label).
880
+ *
881
+ * Rules: version; a positive sample rate; unique source ids that resolve to
882
+ * the EDL's video sources; the source clock; a positive frame; sorted,
883
+ * non-overlapping, positive, integer-ms spans; ascending integer cuts; unique
884
+ * track ids; every box in-frame, at an integer ms, strictly after the previous
885
+ * one and inside a sampled span; no track across a cut; the speaker name
886
+ * space; the box and byte caps.
887
+ *
888
+ * The listing is bounded: per track, the first few boxes breaking each rule
889
+ * are listed and the rest counted in one line; past a fixed total, one line
890
+ * counts the issues (or warnings) not listed. `ok` counts every finding.
891
+ */
892
+ declare function validateSpeakerTracks(set: SpeakerTrackSet, opts?: SpeakerTracksValidateOptions): EdlValidation;
893
+ /**
894
+ * Structural validation of a descriptor (the node's output): the same rules as
895
+ * `validateSpeakerTracks` minus the per-box ones (it has no boxes; `boxCount`
896
+ * feeds the per-source cap), plus a non-empty `url`, a well-formed `sha256`
897
+ * and a positive `bytes` within the byte cap.
898
+ */
899
+ declare function validateSpeakerTrackSetDescriptor(d: SpeakerTrackSetDescriptor, opts?: Omit<SpeakerTracksValidateOptions, "serializedBytes">): EdlValidation;
900
+
901
+ /** The settings and their decided defaults (the plugin holds its own copy, D13). */
902
+ declare const CAMERA_SWITCH_DEFAULTS: Readonly<{
903
+ /** The shortest shot; a shorter turn (an interjection) holds the shot. */
904
+ minShotMs: 2500;
905
+ /** Cut this long before the new speaker starts. */
906
+ leadMs: 200;
907
+ /** With a `wide` camera: break to it after this long on one camera. */
908
+ maxShotMs: 20000;
909
+ /** With a `wide` camera: every N-th cut goes to the wide (0 = off). */
910
+ wideEvery: 0;
911
+ /** Overlapping speech → a side-by-side / stacked layout hint. */
912
+ layoutHints: false;
913
+ }>;
914
+ /** The flat credit id and price (decided 2026-10-03). */
915
+ declare const CAMERA_SWITCH_CREDIT_ID = "camera-switch";
916
+ /** Distinct speaker labels of a transcript (an object or its JSON string), in
917
+ * order of first appearance in time. Read through `normalizeTranscript`
918
+ * (decided 2026-10-08) — the Cloud plugin's reading — so a broken word (no
919
+ * usable time) names no speaker here either; a zero-width word is a point
920
+ * and does. Empty → camera-switch refuses before charging. */
921
+ declare function transcriptSpeakerLabels(transcript: unknown): string[];
922
+ /** The cameras a speaker can be given: an EDL's video sources in order,
923
+ * without the `wide` / `screen` angles (those are not anyone's close-up). */
924
+ declare function cameraSwitchCameras(edl: unknown): Array<{
925
+ id: string;
926
+ role?: string;
927
+ }>;
928
+ /** The settings' accepted ranges — exactly the Cloud route's (it answers 400
929
+ * outside them), so every caller clamps to the same numbers before sending. */
930
+ declare const CAMERA_SWITCH_BOUNDS: Readonly<{
931
+ minShotMs: Readonly<{
932
+ min: 500;
933
+ max: 60000;
934
+ }>;
935
+ leadMs: Readonly<{
936
+ min: 0;
937
+ max: 5000;
938
+ }>;
939
+ maxShotMs: Readonly<{
940
+ min: 0;
941
+ max: 600000;
942
+ }>;
943
+ wideEvery: Readonly<{
944
+ min: 0;
945
+ max: 20;
946
+ }>;
947
+ }>;
948
+ /** The longest display name a speaker can be given. */
949
+ declare const CAMERA_SWITCH_NAME_MAX = 80;
950
+ type CameraSwitchNumericSetting = keyof typeof CAMERA_SWITCH_BOUNDS;
951
+ /** A setting as a whole number inside its range; undefined when unset. */
952
+ declare function clampCameraSwitchSetting(key: CameraSwitchNumericSetting, value: unknown): number | undefined;
953
+ /** Display names trimmed, empty ones dropped, each cut to
954
+ * `CAMERA_SWITCH_NAME_MAX` characters. */
955
+ declare function cleanSpeakerNames(raw: unknown): Record<string, string>;
956
+ /** Why camera-switch would refuse this edit (the route's 400 `invalid_edl`),
957
+ * or null. One edit (an object or its JSON string) on the master clock, with
958
+ * sources and at least one segment of numeric inMs < outMs; a clip SET is
959
+ * refused — on the canvas each clip fans out to its own run. */
960
+ declare function cameraSwitchEdlProblem(edl: unknown): string | null;
961
+ /** The speaker table pre-filled by order (decided 2026-10-03): speaker 1 →
962
+ * camera 1, speaker 2 → camera 2 … A speaker past the last camera stays
963
+ * unmapped (the wide shows them, else any camera with picture). `existing`
964
+ * entries are kept as the person set them — an explicit `""` means "no
965
+ * camera of their own" and is SENT as `""`, so it also beats a source whose
966
+ * `speakers` list names them. */
967
+ declare function defaultSpeakerMap(labels: readonly string[], cameraIds: readonly string[], existing?: Readonly<Record<string, string>>): Record<string, string>;
968
+ /** What a Camera Switch node sends besides its two inputs — ONE funnel for the
969
+ * canvas executor and the orchestrator, so both send the same clamped
970
+ * settings and the same pre-filled speaker table. */
971
+ interface CameraSwitchNodeSettings {
972
+ readonly speakerMap?: Readonly<Record<string, string>>;
973
+ readonly speakerNames?: Readonly<Record<string, string>>;
974
+ readonly minShotMs?: number;
975
+ readonly leadMs?: number;
976
+ readonly maxShotMs?: number;
977
+ readonly wideEvery?: number;
978
+ readonly layoutHints?: boolean;
979
+ }
980
+ declare function cameraSwitchSettingsPayload(data: CameraSwitchNodeSettings, edl: unknown, transcript: unknown): {
981
+ speakerMap: Record<string, string>;
982
+ speakerNames: Record<string, string>;
983
+ minShotMs?: number;
984
+ leadMs?: number;
985
+ maxShotMs?: number;
986
+ wideEvery?: number;
987
+ layoutHints: boolean;
988
+ };
989
+
990
+ /** `trailer` (Track D1): one short teaser EDL built from the strongest moments,
991
+ * priced like `clips` (the per-minute rate plus the clips flat). */
992
+ type EditPlanMode = "tighten" | "clips" | "chapters" | "trailer";
993
+ type EditPlanTier = "economy" | "standard" | "premium";
994
+ declare const EDIT_PLAN_MODES: readonly EditPlanMode[];
995
+ declare const EDIT_PLAN_TIERS: readonly EditPlanTier[];
996
+ /** The coarse duration ladder (MINUTES) a probed source duration rounds UP to;
997
+ * the composite credit id carries the bucket. 4 modes × 3 tiers × 6 buckets =
998
+ * 72 composites (+ the bare `edit-plan`). */
999
+ declare const EDIT_PLAN_BUCKET_MINUTES: readonly number[];
1000
+ /** Hard duration cap (design §7.4). */
1001
+ declare const EDIT_PLAN_MAX_MINUTES = 180;
1002
+ /** `clips` mode: how many clips a plan returns when the caller names no count,
1003
+ * and the most it may be asked for. One source for the credit estimate, the
1004
+ * orchestrated payload clamp and the request schema. */
1005
+ declare const EDIT_PLAN_DEFAULT_CLIP_COUNT = 8;
1006
+ declare const EDIT_PLAN_MAX_CLIP_COUNT = 50;
1007
+ /** Clamp a requested clip count into `[1, EDIT_PLAN_MAX_CLIP_COUNT]`; `undefined`
1008
+ * for anything that is not a positive number (the planner then uses its default). */
1009
+ declare function clampEditPlanClipCount(count: unknown): number | undefined;
1010
+ /** The bare estimator / DB-down fallback id. */
1011
+ declare const EDIT_PLAN_BASE_CREDIT_ID = "edit-plan";
1012
+ /** Round a source duration (seconds) UP to the smallest covering ladder bucket
1013
+ * (capped at the max), in minutes. `undefined` / non-finite → the ceiling
1014
+ * bucket (the safe over-reserve direction). */
1015
+ declare function editPlanBucketMinutes(durationSec: number | undefined): number;
1016
+ /** `edit-plan:<mode>:<tier>:<bucket>m`. `durationSec` undefined → the ceiling
1017
+ * bucket. Single source of truth for the composite id shape. */
1018
+ declare function buildEditPlanCreditId(mode: EditPlanMode, tier: EditPlanTier, durationSec?: number): string;
1019
+ /** Started minutes of a source (seconds): ceil(sec / 60), at least 1, capped at
1020
+ * the maximum. `undefined` / non-finite → the maximum (over-reserve direction). */
1021
+ declare function editPlanStartedMinutes(durationSec: number | undefined): number;
1022
+ /** `edit-plan:<mode>:<tier>:<N>m` for N minutes (a started-minute count or a step). */
1023
+ declare function editPlanMinutesCreditId(mode: EditPlanMode, tier: EditPlanTier, minutes: number): string;
1024
+ /** The id a run of this mode/tier on a source of `durationSec` reserves: per
1025
+ * started minute when the plugin charges that way (`perMinute`), else the step
1026
+ * the length rounds up to. An unknown length → the 180-minute maximum either way. */
1027
+ declare function editPlanReserveCreditId(mode: EditPlanMode, tier: EditPlanTier, durationSec: number | undefined, perMinute: boolean): string;
1028
+ /** The rate row: credits per started source minute for a mode/tier. Never reserved. */
1029
+ declare function editPlanRateCreditId(mode: EditPlanMode, tier: EditPlanTier): string;
1030
+ /** The flat row: credits once per plan for a mode/tier (0 for tighten and chapters). Never reserved. */
1031
+ declare function editPlanFlatCreditId(mode: EditPlanMode, tier: EditPlanTier): string;
1032
+ /** The mode, tier and minutes of an `edit-plan:<mode>:<tier>:<N>m` id (1 ≤ N ≤
1033
+ * the maximum), or `undefined` for anything else (the bare id, a rate or flat
1034
+ * row, an unknown mode or tier). */
1035
+ declare function parseEditPlanMinutesCreditId(id: string): {
1036
+ mode: EditPlanMode;
1037
+ tier: EditPlanTier;
1038
+ minutes: number;
1039
+ } | undefined;
1040
+ /** flat + rate × N, rounded up, at least 1 credit — what an
1041
+ * `edit-plan:<mode>:<tier>:<N>m` id costs from its two rows (the plugin's formula). */
1042
+ declare function editPlanMinutesBaseCredits(flat: number, rate: number, minutes: number): number;
1043
+ /** Narrow an arbitrary value to a known edit-plan mode, defaulting to "tighten".
1044
+ * For display and estimates only: anything that DISPATCHES a plan must use
1045
+ * {@link parseEditPlanMode} and refuse an unknown mode, or that mode is planned
1046
+ * (and charged) as tighten. */
1047
+ declare function asEditPlanMode(v: unknown): EditPlanMode;
1048
+ /** The strict sibling of {@link asEditPlanMode}: the mode when `v` is exactly a
1049
+ * known edit-plan mode, otherwise `undefined` — never a substitute. */
1050
+ declare function parseEditPlanMode(v: unknown): EditPlanMode | undefined;
1051
+ /** Narrow an arbitrary value to a known edit-plan tier, defaulting to "standard". */
1052
+ declare function asEditPlanTier(v: unknown): EditPlanTier;
1053
+ /**
1054
+ * Unwrap an `edit-plan` job's `output_data` into the value stored on the node's
1055
+ * `data.generatedJson`, which every output extractor then reads. This is the ONE
1056
+ * place the modes are normalized (the same rule on both engines and every
1057
+ * result-application site, so audit-dag parity can't drift):
1058
+ * - `clips` → the BARE `Edl[]` (T5: the `list` fan-out reads `Array.isArray`
1059
+ * on `generatedJson`; each element becomes one JSON-stringified
1060
+ * item a downstream `edl` input `normalizeEdl`-parses).
1061
+ * - `chapters` → the `{ version, chapters }` object.
1062
+ * - `tighten` / `trailer` → the `Edl` object at top level.
1063
+ *
1064
+ * The cloud relay object-spreads `output_data` and adds `viaNodaroCloud: true`;
1065
+ * that key (and any other bookkeeping) is stripped here. The unwrap lives HERE —
1066
+ * NEVER in `output_data` — because a bare array written into `output_data` would
1067
+ * be corrupted into numeric keys by the relay's object-spread (see `EdlClipSet`).
1068
+ */
1069
+ declare function unwrapEditPlanOutput(outputData: unknown): unknown;
1070
+
1071
+ /**
1072
+ * A person's review of an Edit Plan, and the ONE rule that makes it win.
1073
+ *
1074
+ * The planner's output stays on `data.generatedJson`, untouched. A review edit
1075
+ * lives beside it on `data.editedEdl` (TA13, decided 2026-10-04), tagged by
1076
+ * `kind` and fingerprinted with `basis` — the hash of the plan it was made
1077
+ * against. An edit whose basis no longer matches (the plan was re-run) is
1078
+ * ignored by construction, so no writer has to remember to clear it for the
1079
+ * read to be right. The edit is run-result data (TA14, decided 2026-10-04):
1080
+ * `editedEdl` is in `EXECUTION_DATA_KEYS`, so it stays out of undo, presets,
1081
+ * templates and exports, and Clear results wipes it.
1082
+ *
1083
+ * - Tighten: `{v:1, kind:"edl", basis, edl:{segments, dropped}}`. The resolved
1084
+ * plan is the planner's EDL with the edit's segments and dropped spans;
1085
+ * sources, clock and meta always come from the plan (an edit never stores
1086
+ * sources).
1087
+ * - Clips: `{v:1, kind:"clips", basis, clips:[{keep, hook?}]}`, index-aligned
1088
+ * with the plan's clips, holding decisions only. The list a fan-out reads
1089
+ * stays on the PLAN's indices, with `""` at every dropped clip (TA16,
1090
+ * decided 2026-10-04), so an edge selector picks the same clips it picked
1091
+ * for the preview. `json` holds the kept clips only, so a scalar read (the
1092
+ * first item) is the first kept clip. An edited hook travels as `meta.hook`
1093
+ * (TA20, decided 2026-10-04: text only).
1094
+ * - Chapters have no review: an edit never applies.
1095
+ *
1096
+ * Every read of an Edit Plan's saved output calls `editPlanSavedOutput`, on
1097
+ * both engines; `extractGeneratedJsonAsList` stays generic.
1098
+ */
1099
+
1100
+ declare const EDITED_EDL_VERSION: 1;
1101
+ /** A Tighten plan's review: the kept segments and the dropped spans. */
1102
+ interface EditedEdlCut {
1103
+ readonly v: typeof EDITED_EDL_VERSION;
1104
+ readonly kind: "edl";
1105
+ /** `editPlanBasis` of the `generatedJson` this edit was made against. */
1106
+ readonly basis: string;
1107
+ readonly edl: {
1108
+ readonly segments: readonly EdlSegment[];
1109
+ readonly dropped: readonly EdlDropped[];
1110
+ };
1111
+ }
1112
+ /** One clip's review decision, at the clip's index in the plan. */
1113
+ interface EditedClipDecision {
1114
+ readonly keep: boolean;
1115
+ /** The clip's hook as the person rewrote it (text only); absent = the plan's. */
1116
+ readonly hook?: string;
1117
+ }
1118
+ /** A clip set's review: one decision per planned clip, index-aligned. */
1119
+ interface EditedClipSet {
1120
+ readonly v: typeof EDITED_EDL_VERSION;
1121
+ readonly kind: "clips";
1122
+ /** `editPlanBasis` of the `generatedJson` this edit was made against. */
1123
+ readonly basis: string;
1124
+ readonly clips: readonly EditedClipDecision[];
1125
+ }
1126
+ /** What `data.editedEdl` on an Edit Plan holds. */
1127
+ type EditedEdl = EditedEdlCut | EditedClipSet;
1128
+ /**
1129
+ * How the review edit stood when the plan was resolved:
1130
+ * - `none`: there is no edit;
1131
+ * - `applied`: the edit was made on this plan and wins;
1132
+ * - `stale`: it was made on another plan (a re-run, including one that
1133
+ * changed the clip count or the plan's mode) and is ignored;
1134
+ * - `invalid`: it is malformed, or, made on this plan, it does not fit its
1135
+ * kind or shape; it is ignored.
1136
+ */
1137
+ type EditPlanEditStatus = "none" | "applied" | "stale" | "invalid";
1138
+ /** An Edit Plan's output as every reader receives it. */
1139
+ interface EditPlanSavedOutput {
1140
+ /** Tighten: the EDL. Clips: the kept clips. Chapters: the chapter set. */
1141
+ readonly json: unknown;
1142
+ /** Clips only: one JSON string per PLANNED clip, `""` where a clip is dropped. */
1143
+ readonly listResults?: string[];
1144
+ }
1145
+ interface ResolvedEditPlanOutput extends EditPlanSavedOutput {
1146
+ readonly status: EditPlanEditStatus;
1147
+ }
1148
+ /**
1149
+ * The fingerprint of an Edit Plan's stored output (`data.generatedJson`, as
1150
+ * unwrapped): FNV-1a-64 of the UTF-8 bytes of its key-sorted JSON, as 16
1151
+ * lowercase hex digits. Equal for any key order, so a JSONB round trip keeps
1152
+ * it; any change to a value, or to array order, changes it.
1153
+ */
1154
+ declare function editPlanBasis(plan: unknown): string;
1155
+ /**
1156
+ * An Edit Plan's output with the person's review applied: what every edit-plan
1157
+ * read hands downstream, on both engines.
1158
+ *
1159
+ * The edit applies when its shape matches the plan's kind and its `basis` is
1160
+ * this plan's. It applies even when the cut it holds is not a well-formed EDL:
1161
+ * the render then refuses it with its own issues, where falling back to the
1162
+ * planner's cut would silently render what the person removed. A stale or
1163
+ * invalid edit is ignored, and the plan is read as planned.
1164
+ */
1165
+ declare function resolveEditPlanOutput(plan: unknown, editedEdl: unknown): ResolvedEditPlanOutput;
1166
+ /**
1167
+ * An Edit Plan node's SAVED output — the one read every edit-plan reader makes
1168
+ * of `data` (a node outside the run, the editor's own read of the canvas).
1169
+ * `undefined` when the node holds no plan. With no edit it is exactly the plan:
1170
+ * `{json}`, plus `listResults` (one JSON string per clip) for a clip set.
1171
+ */
1172
+ declare function editPlanSavedOutput(data: Readonly<Record<string, unknown>>): EditPlanSavedOutput | undefined;
1173
+ /**
1174
+ * What a result writer writes when a plan lands on an Edit Plan node: the plan
1175
+ * itself, and `editedEdl: undefined` ONLY when the plan is not the one the
1176
+ * person's review was made on (its `editPlanBasis` differs from
1177
+ * `editedEdl.basis`; an edit that names no plan counts as different). The same
1178
+ * plan landing again, for example a reopen while the run is still live after
1179
+ * the plan finished, keeps the review (decided 2026-10-05). On a keep the patch
1180
+ * does not name `editedEdl` at all, so a merging write leaves the review as it
1181
+ * is. Pass the review the node holds now.
1182
+ *
1183
+ * The one place a review is cleared: `frontend/src/lib/__tests__/
1184
+ * edit-plan-saved-output-sites.test.ts` fails on a clearing write anywhere else.
1185
+ */
1186
+ declare function editPlanResultPatch(plan: unknown, editedEdl: unknown): {
1187
+ readonly generatedJson: unknown;
1188
+ readonly editedEdl?: undefined;
1189
+ };
1190
+ /**
1191
+ * Check a review edit before it is saved. The envelope (version, kind), the
1192
+ * basis, then the plan's shape and one decision per clip, and, for a Tighten edit,
1193
+ * the structural `validateEdl` of the edited cut — the Edit Plan's own
1194
+ * "well-formed" rule (TA1 a, decided 2026-10-04); what a given render can draw
1195
+ * is the render's rule, not this one. Issues are English, like `validateEdl`'s.
1196
+ */
1197
+ declare function validateEditedEdl(editedEdl: unknown, plan: unknown): EdlValidation;
1198
+
1199
+ export { AUDIO_CROSSFADE_CURVES, AUDIO_CROSSFADE_CURVE_IDS, AUDIO_SYNC_MIN_CONFIDENCE, type AudioCrossfadeCurve, type AudioSyncOffsetIssue, type AudioSyncOffsetSource, type AudioSyncOffsetsResult, CAMERA_SWITCH_BOUNDS, CAMERA_SWITCH_CREDIT_ID, CAMERA_SWITCH_DEFAULTS, CAMERA_SWITCH_NAME_MAX, COMBINE_TRANSITIONS, COMBINE_TRANSITION_GROUP_LABELS, COMBINE_TRANSITION_GROUP_ORDER, COMBINE_TRANSITION_IDS, type CameraSwitchNodeSettings, type CameraSwitchNumericSetting, type ChapterSet, type CombineTransition, type CombineTransitionGroup, DEFAULT_AUDIO_CROSSFADE_CURVE_ID, EDITED_EDL_VERSION, EDIT_PLAN_BASE_CREDIT_ID, EDIT_PLAN_BUCKET_MINUTES, EDIT_PLAN_DEFAULT_CLIP_COUNT, EDIT_PLAN_MAX_CLIP_COUNT, EDIT_PLAN_MAX_MINUTES, EDIT_PLAN_MODES, EDIT_PLAN_TIERS, EDL_FULL_FRAME, EDL_SOURCE_ROLES, EDL_TARGET_ASPECTS, EDL_VERSION, type EditPlanEditStatus, type EditPlanMode, type EditPlanSavedOutput, type EditPlanSourceIssue, type EditPlanTier, type EditedClipDecision, type EditedClipSet, type EditedEdl, type EditedEdlCut, type Edl, type EdlClipSet, type EdlDropped, type EdlLayout, type EdlRegion, type EdlResolvedSlot, type EdlSegment, type EdlSlotFollow, type EdlSlotFollowMotion, type EdlSource, type EdlSourceRole, type EdlTargetAspect, type EdlValidation, PICKER_TO_COMBINE_TRANSITION, type ResolveEdlSlotsOptions, type ResolvedEditPlanOutput, SMART_CUT_WINDOW_DEFAULT, SMART_CUT_WINDOW_MAX, SMART_CUT_WINDOW_MIN, SPEAKER_EMPHASIS_STYLES, SPEAKER_LAYOUTS, SPEAKER_LAYOUT_IDS, SPEAKER_SWITCHES, SPEAKER_SWITCH_IDS, SPEAKER_TRACKS_MAX_BOXES_PER_SOURCE, SPEAKER_TRACKS_MAX_BYTES, SPEAKER_TRACKS_VERSION, SPEAKER_TRACK_ATTRIBUTION_METHODS, type SpeakerEmphasisStyle, type SpeakerLayoutSheet, type SpeakerSwitchSheet, type SpeakerTrack, type SpeakerTrackAttribution, type SpeakerTrackAttributionMethod, type SpeakerTrackBox, type SpeakerTrackHeader, type SpeakerTrackSet, type SpeakerTrackSetDescriptor, type SpeakerTrackSource, type SpeakerTrackSourceSummary, type SpeakerTrackSpan, type SpeakerTrackSummary, type SpeakerTracksValidateOptions, type Transcript, applyAudioSyncOffsets, asEditPlanMode, asEditPlanTier, buildEditPlanCreditId, cameraSwitchCameras, cameraSwitchEdlProblem, cameraSwitchSettingsPayload, clampCameraSwitchSetting, clampEditPlanClipCount, clampSmartCutWindow, cleanSpeakerNames, defaultSpeakerMap, describeAudioSyncOffsetIssue, describeSpeakerTracks, editPlanBasis, editPlanBucketMinutes, editPlanFlatCreditId, editPlanMinutesBaseCredits, editPlanMinutesCreditId, editPlanRateCreditId, editPlanReserveCreditId, editPlanResultPatch, editPlanSavedOutput, editPlanStartedMinutes, editPlanTranscriptOrigin, edlDurationMs, edlSegmentOutputStarts, edlSpeakerSpace, getAudioCrossfadeCurve, getCombineTransition, getSpeakerLayout, getSpeakerSwitch, isEdlTargetAspect, isKnownSpeakerEmphasisStyle, mergeEdlSourceOffsets, normalizeEdl, normalizeSpeakerTrackSetDescriptor, normalizeSpeakerTracks, normalizeTranscript, outputMsToMasterMs, parseEditPlanMinutesCreditId, parseEditPlanMode, parseSpeakerEmphasisStyle, remapMsThroughEdl, remapTranscriptThroughEdl, resolveAudioCrossfadeCurve, resolveEditPlanOutput, resolveEditPlanSources, resolveEdlSegmentSlots, resolveSlideshowTransition, resolveXfadeName, speakerLayoutAllows, speakerPresentationWarnings, speakerSwitchOverlaps, speakerTurns, transcriptDurationSec, transcriptSpeakerLabels, unwrapEditPlanOutput, validateEditedEdl, validateEdl, validateEdlClipSet, validateSpeakerTrackSetDescriptor, validateSpeakerTracks };