@nodaro/shared 3.60.1 → 3.62.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 (261) hide show
  1. package/dist/{chunk-5Y42RIGY.cjs → chunk-2D5LQFV4.cjs} +18 -332
  2. package/dist/chunk-2D5LQFV4.cjs.map +1 -0
  3. package/dist/{chunk-5G23AJBU.cjs → chunk-2HZGDZZN.cjs} +6 -6
  4. package/dist/{chunk-5G23AJBU.cjs.map → chunk-2HZGDZZN.cjs.map} +1 -1
  5. package/dist/{chunk-DS2TOM32.js → chunk-2QKF7M2Z.js} +28 -4
  6. package/dist/chunk-2QKF7M2Z.js.map +1 -0
  7. package/dist/{chunk-CIOXUPCJ.cjs → chunk-2W745U4A.cjs} +228 -355
  8. package/dist/chunk-2W745U4A.cjs.map +1 -0
  9. package/dist/{chunk-LN3EVFRS.js → chunk-3OYO3XCC.js} +70 -6
  10. package/dist/chunk-3OYO3XCC.js.map +1 -0
  11. package/dist/{chunk-5HK5Z5OB.cjs → chunk-4ZEFP2FQ.cjs} +4 -4
  12. package/dist/{chunk-5HK5Z5OB.cjs.map → chunk-4ZEFP2FQ.cjs.map} +1 -1
  13. package/dist/{chunk-KOLC7AF2.js → chunk-5YYN5X57.js} +398 -38
  14. package/dist/chunk-5YYN5X57.js.map +1 -0
  15. package/dist/{chunk-RRPPXZ36.cjs → chunk-6CSXMWL4.cjs} +4 -4
  16. package/dist/{chunk-RRPPXZ36.cjs.map → chunk-6CSXMWL4.cjs.map} +1 -1
  17. package/dist/{chunk-M3SXUUWC.cjs → chunk-6FQBKI2A.cjs} +4 -11
  18. package/dist/chunk-6FQBKI2A.cjs.map +1 -0
  19. package/dist/{chunk-G4XWVWRI.js → chunk-6G7NN4S4.js} +5 -4
  20. package/dist/chunk-6G7NN4S4.js.map +1 -0
  21. package/dist/{chunk-HOKWJXHA.cjs → chunk-A2PX5IRC.cjs} +31 -4
  22. package/dist/chunk-A2PX5IRC.cjs.map +1 -0
  23. package/dist/{chunk-W4M7TNXG.cjs → chunk-AFYTX4AI.cjs} +52 -43
  24. package/dist/chunk-AFYTX4AI.cjs.map +1 -0
  25. package/dist/chunk-ALRXY4QH.cjs +13 -0
  26. package/dist/chunk-ALRXY4QH.cjs.map +1 -0
  27. package/dist/chunk-AOJ6B7K4.cjs +351 -0
  28. package/dist/chunk-AOJ6B7K4.cjs.map +1 -0
  29. package/dist/{chunk-KJZVQIN4.js → chunk-C7POAYFE.js} +3 -3
  30. package/dist/{chunk-KJZVQIN4.js.map → chunk-C7POAYFE.js.map} +1 -1
  31. package/dist/{chunk-6Q6SI7AG.js → chunk-CC4V2B7S.js} +3 -3
  32. package/dist/{chunk-6Q6SI7AG.js.map → chunk-CC4V2B7S.js.map} +1 -1
  33. package/dist/{chunk-GNPJ2JLE.cjs → chunk-CIPPPT7E.cjs} +6 -6
  34. package/dist/{chunk-GNPJ2JLE.cjs.map → chunk-CIPPPT7E.cjs.map} +1 -1
  35. package/dist/{chunk-6XVHYD5R.js → chunk-CLAKSLXF.js} +4 -9
  36. package/dist/chunk-CLAKSLXF.js.map +1 -0
  37. package/dist/chunk-CTANEPMY.js +61 -0
  38. package/dist/chunk-CTANEPMY.js.map +1 -0
  39. package/dist/{chunk-WGKAOUEQ.cjs → chunk-D34K455O.cjs} +3 -2
  40. package/dist/chunk-D34K455O.cjs.map +1 -0
  41. package/dist/chunk-E2HZTGYX.js +331 -0
  42. package/dist/chunk-E2HZTGYX.js.map +1 -0
  43. package/dist/{chunk-SKFJIFEV.cjs → chunk-G3KVK7OU.cjs} +21 -21
  44. package/dist/{chunk-SKFJIFEV.cjs.map → chunk-G3KVK7OU.cjs.map} +1 -1
  45. package/dist/chunk-G4U3HW6W.js +453 -0
  46. package/dist/chunk-G4U3HW6W.js.map +1 -0
  47. package/dist/{chunk-EN2YI5TV.js → chunk-GSFB537T.js} +3 -3
  48. package/dist/{chunk-EN2YI5TV.js.map → chunk-GSFB537T.js.map} +1 -1
  49. package/dist/chunk-HRY7KGAE.cjs +506 -0
  50. package/dist/chunk-HRY7KGAE.cjs.map +1 -0
  51. package/dist/{chunk-6AJOTEVC.js → chunk-I2RQB7VG.js} +3 -3
  52. package/dist/{chunk-6AJOTEVC.js.map → chunk-I2RQB7VG.js.map} +1 -1
  53. package/dist/chunk-IDTKF5EX.cjs +48 -0
  54. package/dist/chunk-IDTKF5EX.cjs.map +1 -0
  55. package/dist/{chunk-DQIJPDHC.cjs → chunk-IWWVPR3W.cjs} +88 -11
  56. package/dist/chunk-IWWVPR3W.cjs.map +1 -0
  57. package/dist/{chunk-URLDVK67.js → chunk-JJNNM23P.js} +3 -3
  58. package/dist/{chunk-URLDVK67.js.map → chunk-JJNNM23P.js.map} +1 -1
  59. package/dist/{chunk-YHVEZVAO.js → chunk-JZGZ26YB.js} +6 -306
  60. package/dist/chunk-JZGZ26YB.js.map +1 -0
  61. package/dist/{chunk-XROE3CAS.cjs → chunk-KHH54GRP.cjs} +120 -79
  62. package/dist/chunk-KHH54GRP.cjs.map +1 -0
  63. package/dist/{chunk-AXT7YNOR.cjs → chunk-KJSRPHJ2.cjs} +48 -47
  64. package/dist/chunk-KJSRPHJ2.cjs.map +1 -0
  65. package/dist/{chunk-FVVD6XY2.js → chunk-KL6GAYTT.js} +13 -4
  66. package/dist/chunk-KL6GAYTT.js.map +1 -0
  67. package/dist/{chunk-AFQFGZN7.cjs → chunk-KYMHFVAZ.cjs} +8 -6
  68. package/dist/chunk-KYMHFVAZ.cjs.map +1 -0
  69. package/dist/{chunk-A6HRY3WF.cjs → chunk-MYJQELFN.cjs} +420 -37
  70. package/dist/chunk-MYJQELFN.cjs.map +1 -0
  71. package/dist/chunk-N5HH46JF.cjs +68 -0
  72. package/dist/chunk-N5HH46JF.cjs.map +1 -0
  73. package/dist/{chunk-BXNPO3PL.cjs → chunk-N7OUQK7E.cjs} +8 -8
  74. package/dist/{chunk-BXNPO3PL.cjs.map → chunk-N7OUQK7E.cjs.map} +1 -1
  75. package/dist/{chunk-JKZVRKN3.js → chunk-NGKKNSK6.js} +31 -8
  76. package/dist/chunk-NGKKNSK6.js.map +1 -0
  77. package/dist/{chunk-SWVGHAYO.js → chunk-O7RZRUMZ.js} +110 -74
  78. package/dist/chunk-O7RZRUMZ.js.map +1 -0
  79. package/dist/{chunk-SCYBGTX6.js → chunk-PTD6EDUU.js} +3 -3
  80. package/dist/{chunk-SCYBGTX6.js.map → chunk-PTD6EDUU.js.map} +1 -1
  81. package/dist/{chunk-BDXXOEBZ.cjs → chunk-QWYFHQYK.cjs} +79 -54
  82. package/dist/chunk-QWYFHQYK.cjs.map +1 -0
  83. package/dist/{chunk-VB2ARGQ6.js → chunk-RGNHHIMN.js} +3 -3
  84. package/dist/chunk-RGNHHIMN.js.map +1 -0
  85. package/dist/{chunk-AZGONXWV.js → chunk-S24ZBUB4.js} +194 -299
  86. package/dist/chunk-S24ZBUB4.js.map +1 -0
  87. package/dist/{chunk-IV6IDECY.js → chunk-S5TMRJMX.js} +4 -4
  88. package/dist/{chunk-IV6IDECY.js.map → chunk-S5TMRJMX.js.map} +1 -1
  89. package/dist/chunk-SMOO5FAH.js +10 -0
  90. package/dist/chunk-SMOO5FAH.js.map +1 -0
  91. package/dist/{chunk-HYBACFYW.js → chunk-SYWR5G3T.js} +16 -7
  92. package/dist/chunk-SYWR5G3T.js.map +1 -0
  93. package/dist/{chunk-GWBQ3GPO.cjs → chunk-TRVWMKNE.cjs} +343 -53
  94. package/dist/chunk-TRVWMKNE.cjs.map +1 -0
  95. package/dist/{chunk-G6GMY5BC.js → chunk-UDDVDQMF.js} +298 -36
  96. package/dist/chunk-UDDVDQMF.js.map +1 -0
  97. package/dist/{chunk-PONP5J5E.cjs → chunk-V24EPI5N.cjs} +13 -3
  98. package/dist/chunk-V24EPI5N.cjs.map +1 -0
  99. package/dist/{chunk-HDHLZK7C.cjs → chunk-VACPZPUA.cjs} +5 -5
  100. package/dist/{chunk-HDHLZK7C.cjs.map → chunk-VACPZPUA.cjs.map} +1 -1
  101. package/dist/{chunk-ICDLYU4I.js → chunk-Y6X7UJSD.js} +10 -9
  102. package/dist/chunk-Y6X7UJSD.js.map +1 -0
  103. package/dist/chunk-YCXRSWCQ.js +42 -0
  104. package/dist/chunk-YCXRSWCQ.js.map +1 -0
  105. package/dist/entries/apps.cjs +44 -44
  106. package/dist/entries/apps.js +9 -9
  107. package/dist/entries/credits.cjs +217 -152
  108. package/dist/entries/credits.d.cts +112 -6
  109. package/dist/entries/credits.d.ts +112 -6
  110. package/dist/entries/credits.js +13 -8
  111. package/dist/entries/entities.cjs +188 -143
  112. package/dist/entries/entities.d.cts +122 -1
  113. package/dist/entries/entities.d.ts +122 -1
  114. package/dist/entries/entities.js +2 -1
  115. package/dist/entries/llm-models.d.cts +2 -1
  116. package/dist/entries/llm-models.d.ts +2 -1
  117. package/dist/entries/media.cjs +92 -87
  118. package/dist/entries/media.d.cts +11 -1
  119. package/dist/entries/media.d.ts +11 -1
  120. package/dist/entries/media.js +3 -2
  121. package/dist/entries/model-catalog.cjs +207 -99
  122. package/dist/entries/model-catalog.d.cts +90 -4
  123. package/dist/entries/model-catalog.d.ts +90 -4
  124. package/dist/entries/model-catalog.js +5 -5
  125. package/dist/entries/models.cjs +407 -294
  126. package/dist/entries/models.d.cts +4 -3
  127. package/dist/entries/models.d.ts +4 -3
  128. package/dist/entries/models.js +6 -5
  129. package/dist/entries/nodes.cjs +241 -233
  130. package/dist/entries/nodes.d.cts +15 -2
  131. package/dist/entries/nodes.d.ts +15 -2
  132. package/dist/entries/nodes.js +10 -10
  133. package/dist/entries/pipeline.cjs +152 -152
  134. package/dist/entries/pipeline.d.cts +2 -1
  135. package/dist/entries/pipeline.d.ts +2 -1
  136. package/dist/entries/pipeline.js +3 -3
  137. package/dist/entries/ugc.cjs +71 -71
  138. package/dist/entries/ugc.js +4 -4
  139. package/dist/entries/video.cjs +308 -204
  140. package/dist/entries/video.d.cts +480 -98
  141. package/dist/entries/video.d.ts +480 -98
  142. package/dist/entries/video.js +8 -4
  143. package/dist/entries/workflow.cjs +111 -99
  144. package/dist/entries/workflow.d.cts +29 -2
  145. package/dist/entries/workflow.d.ts +29 -2
  146. package/dist/entries/workflow.js +2 -2
  147. package/dist/{gpt-image-2-6-BeZdT-pW.d.cts → gpt-image-2-6-jIRQBRag.d.cts} +6 -0
  148. package/dist/{gpt-image-2-6-BeZdT-pW.d.ts → gpt-image-2-6-jIRQBRag.d.ts} +6 -0
  149. package/dist/index.cjs +2321 -1870
  150. package/dist/index.d.cts +10 -10
  151. package/dist/index.d.ts +10 -10
  152. package/dist/index.js +26 -23
  153. package/dist/{model-catalog-D6Es7VG-.d.cts → model-catalog-CCEcv08q.d.cts} +179 -14
  154. package/dist/{model-catalog-D6Es7VG-.d.ts → model-catalog-CCEcv08q.d.ts} +179 -14
  155. package/dist/{model-constants-22k3fjp1.d.cts → model-constants-B88p6XR0.d.ts} +305 -20
  156. package/dist/{model-constants-22k3fjp1.d.ts → model-constants-Cf3zaITt.d.cts} +305 -20
  157. package/package.json +1 -1
  158. package/src/__tests__/extend-providers.test.ts +114 -0
  159. package/src/__tests__/fixtures/mask-composite-quote-parity.json +118 -0
  160. package/src/__tests__/fixtures/root-exports.baseline.json +68 -0
  161. package/src/__tests__/gpt-image-2-6-formats.test.ts +4 -1
  162. package/src/__tests__/gpt-image-2-6.test.ts +7 -0
  163. package/src/__tests__/grok-video-15-catalog.test.ts +189 -0
  164. package/src/__tests__/gvp-supported-providers.test.ts +5 -2
  165. package/src/__tests__/image-mask-mode.test.ts +34 -1
  166. package/src/__tests__/mask-edit-follows-source.test.ts +150 -0
  167. package/src/__tests__/minimax-h3-image.test.ts +140 -0
  168. package/src/__tests__/model-makers.test.ts +49 -11
  169. package/src/__tests__/model-tree.test.ts +13 -0
  170. package/src/__tests__/retired-video-provider.test.ts +15 -5
  171. package/src/__tests__/seedance-25-catalog-modes.test.ts +1 -1
  172. package/src/__tests__/seedance-task-type.test.ts +178 -0
  173. package/src/__tests__/seedream-5-5.test.ts +117 -0
  174. package/src/__tests__/unit-contract-compose.test.ts +27 -1
  175. package/src/__tests__/unit-contracts.test.ts +20 -6
  176. package/src/__tests__/upscale-factors.test.ts +107 -0
  177. package/src/__tests__/video-character-refs.test.ts +20 -2
  178. package/src/__tests__/video-collapse-parity.test.ts +19 -0
  179. package/src/__tests__/video-overlay-geometry.test.ts +68 -0
  180. package/src/__tests__/video-overlay-layer-plan.test.ts +3 -4
  181. package/src/__tests__/video-overlay-layouts.test.ts +529 -0
  182. package/src/__tests__/video-overlay-pricing.test.ts +61 -0
  183. package/src/__tests__/video-overlay-validate.test.ts +128 -0
  184. package/src/__tests__/video-overlay-wired-kind.test.ts +207 -0
  185. package/src/__tests__/video-overlay.test.ts +280 -194
  186. package/src/__tests__/video-ref-limits.test.ts +2 -1
  187. package/src/__tests__/video-reference-only.test.ts +6 -2
  188. package/src/__tests__/video-start-frame-only.test.ts +98 -0
  189. package/src/__tests__/wired-character-names.test.ts +220 -0
  190. package/src/credit-estimators/index.ts +8 -0
  191. package/src/credit-estimators/video-overlay.ts +70 -0
  192. package/src/credit-identifiers.ts +102 -5
  193. package/src/entity-image-url.ts +21 -0
  194. package/src/entries/credits.ts +14 -0
  195. package/src/entries/entities.ts +14 -0
  196. package/src/entries/model-catalog.ts +39 -1
  197. package/src/entries/models.ts +34 -0
  198. package/src/entries/nodes.ts +2 -0
  199. package/src/entries/video.ts +6 -0
  200. package/src/entries/workflow.ts +1 -0
  201. package/src/generated/unit-contracts.ts +8 -1
  202. package/src/gpt-image-2-6.ts +6 -0
  203. package/src/input-image-pricing.ts +76 -0
  204. package/src/mask-composite.ts +11 -0
  205. package/src/minimax-h3-image.ts +61 -0
  206. package/src/model-catalog.ts +512 -48
  207. package/src/model-constants.ts +602 -34
  208. package/src/node-default-mappings.ts +12 -2
  209. package/src/node-execution-state.ts +4 -1
  210. package/src/producer-types.ts +23 -1
  211. package/src/seedance-task-type.ts +37 -0
  212. package/src/seedream-5-5.ts +45 -0
  213. package/src/unit-contract-compose.ts +4 -1
  214. package/src/upscale-factors.ts +111 -0
  215. package/src/video-character-refs.ts +7 -4
  216. package/src/video-overlay-geometry.ts +99 -0
  217. package/src/video-overlay-input.ts +25 -0
  218. package/src/video-overlay-layout-ids.ts +48 -0
  219. package/src/video-overlay-layouts.ts +315 -0
  220. package/src/video-overlay-validate.ts +223 -0
  221. package/src/video-overlay-video-layers.ts +304 -0
  222. package/src/video-overlay.ts +165 -297
  223. package/src/video-ui-defaults.ts +8 -6
  224. package/src/wired-character-names.ts +202 -0
  225. package/src/wired-image-size.ts +55 -0
  226. package/dist/chunk-5Y42RIGY.cjs.map +0 -1
  227. package/dist/chunk-6XVHYD5R.js.map +0 -1
  228. package/dist/chunk-A6HRY3WF.cjs.map +0 -1
  229. package/dist/chunk-AFQFGZN7.cjs.map +0 -1
  230. package/dist/chunk-AXT7YNOR.cjs.map +0 -1
  231. package/dist/chunk-AZGONXWV.js.map +0 -1
  232. package/dist/chunk-BDXXOEBZ.cjs.map +0 -1
  233. package/dist/chunk-CIOXUPCJ.cjs.map +0 -1
  234. package/dist/chunk-DQIJPDHC.cjs.map +0 -1
  235. package/dist/chunk-DS2TOM32.js.map +0 -1
  236. package/dist/chunk-FVVD6XY2.js.map +0 -1
  237. package/dist/chunk-G4XWVWRI.js.map +0 -1
  238. package/dist/chunk-G6GMY5BC.js.map +0 -1
  239. package/dist/chunk-G7ZYZQKO.cjs +0 -27
  240. package/dist/chunk-G7ZYZQKO.cjs.map +0 -1
  241. package/dist/chunk-GWBQ3GPO.cjs.map +0 -1
  242. package/dist/chunk-HNEF2N5C.cjs +0 -19
  243. package/dist/chunk-HNEF2N5C.cjs.map +0 -1
  244. package/dist/chunk-HOKWJXHA.cjs.map +0 -1
  245. package/dist/chunk-HYBACFYW.js.map +0 -1
  246. package/dist/chunk-ICDLYU4I.js.map +0 -1
  247. package/dist/chunk-JKZVRKN3.js.map +0 -1
  248. package/dist/chunk-KOLC7AF2.js.map +0 -1
  249. package/dist/chunk-LN3EVFRS.js.map +0 -1
  250. package/dist/chunk-M3SXUUWC.cjs.map +0 -1
  251. package/dist/chunk-MHY47BLL.js +0 -23
  252. package/dist/chunk-MHY47BLL.js.map +0 -1
  253. package/dist/chunk-PONP5J5E.cjs.map +0 -1
  254. package/dist/chunk-SWVGHAYO.js.map +0 -1
  255. package/dist/chunk-VB2ARGQ6.js.map +0 -1
  256. package/dist/chunk-VYQ25YQF.js +0 -17
  257. package/dist/chunk-VYQ25YQF.js.map +0 -1
  258. package/dist/chunk-W4M7TNXG.cjs.map +0 -1
  259. package/dist/chunk-WGKAOUEQ.cjs.map +0 -1
  260. package/dist/chunk-XROE3CAS.cjs.map +0 -1
  261. package/dist/chunk-YHVEZVAO.js.map +0 -1
@@ -377,7 +377,36 @@ declare const VIDEO_LINK_DERIVED_FIELDS: readonly ["videoId", "title", "thumbnai
377
377
  declare function dropStaleVideoLinkFields(data: Record<string, unknown>, incoming: Record<string, unknown>): Record<string, unknown>;
378
378
 
379
379
  /**
380
- * Video Overlay — timed image layers over a video. The wire contract of the
380
+ * Video Overlay layouts — the ids, and what each one needs. A layout is a
381
+ * named shortcut that writes the boxes (`expandVideoOverlayLayout` in
382
+ * `video-overlay-layouts.ts`); like a placement preset, it is a TAG and the
383
+ * boxes are the truth, except for the two stacks, whose boxes depend on the
384
+ * sources' shapes and are resolved where those are known.
385
+ *
386
+ * Dependency-free on purpose: the validator in `video-overlay-validate.ts`
387
+ * reads these, and `video-overlay-layouts.ts` imports the contract in
388
+ * `video-overlay.ts`, so they cannot live in either without a cycle. Wire contract only — no I/O.
389
+ */
390
+ /**
391
+ * - `video-bottom` / `video-top`: the base whole, full width, against that edge.
392
+ * - `stack-whole`: the base directly above the first video layer, both whole,
393
+ * the same width, the pair centred.
394
+ * - `stack-filled`: the base fills the top half, the first video layer the
395
+ * bottom half, both cropped (`cover`).
396
+ * - `pip`: the base fills the frame, the first video layer sits in a corner.
397
+ */
398
+ declare const VIDEO_OVERLAY_LAYOUT_IDS: readonly ["video-bottom", "video-top", "stack-whole", "stack-filled", "pip"];
399
+ type VideoOverlayLayoutId = (typeof VIDEO_OVERLAY_LAYOUT_IDS)[number];
400
+ declare function isVideoOverlayLayoutId(v: unknown): v is VideoOverlayLayoutId;
401
+ /** True when the layout is refused without an `outputAspect` (`layout_needs_aspect`). */
402
+ declare function videoOverlayLayoutNeedsAspect(id: VideoOverlayLayoutId): boolean;
403
+ /** True when the layout is refused without a video layer (`layout_needs_video_layer`). */
404
+ declare function videoOverlayLayoutNeedsVideoLayer(id: VideoOverlayLayoutId): boolean;
405
+ /** True when the layout places the base itself and is refused with a `baseBox` (`layout_conflicts_base_box`): the two stacks. */
406
+ declare function videoOverlayLayoutPlacesBase(id: VideoOverlayLayoutId): boolean;
407
+
408
+ /**
409
+ * Video Overlay — timed image and video layers over a video. The wire contract of the
381
410
  * `video-overlay` node, `POST /v1/video-overlay`, the `overlay_images` MCP
382
411
  * verb, `client.media.videoOverlay` and `nodaro media video-overlay`, defined
383
412
  * ONCE:
@@ -390,8 +419,8 @@ declare function dropStaleVideoLinkFields(data: Record<string, unknown>, incomin
390
419
  * never switch on the tag;
391
420
  * - `expandVideoOverlayLayer` / `expandVideoOverlayPresets`: the one
392
421
  * normaliser every write boundary calls;
393
- * - `resolveVideoOverlayGeometry`: the one placement function the canvas
394
- * preview and the ffmpeg worker both call;
422
+ * - `resolveVideoOverlayGeometry` (in `video-overlay-geometry.ts`): the one
423
+ * placement function the canvas preview and the ffmpeg worker both call;
395
424
  * - `assembleVideoOverlayRequest`: the one node-data → request assembly both
396
425
  * workflow engines call;
397
426
  * - `videoOverlayCompositionKey` (+ `videoOverlaySlotSources`): the freshness
@@ -400,10 +429,12 @@ declare function dropStaleVideoLinkFields(data: Record<string, unknown>, incomin
400
429
  * `VIDEO_OVERLAY_MAX_COMPOSITION_KEY_LENGTH`) and the DAG payload compute
401
430
  * it with this one function, and the node compares it against the key of
402
431
  * its current settings;
403
- * - `validateVideoOverlayRequest`: what a schema cannot express, at every
404
- * engine entry. It returns a CODE, never English: `formatVideoOverlayError`
405
- * renders the route / worker text, the canvas renders the code through its
406
- * dictionaries.
432
+ * - `validateVideoOverlayRequest` (in `video-overlay-validate.ts`): what a
433
+ * schema cannot express, at every engine entry. It returns a CODE, never
434
+ * English: `formatVideoOverlayError` renders the route / worker text, the
435
+ * canvas renders the code through its dictionaries.
436
+ * The geometry and validator siblings import from this file; it imports
437
+ * nothing from them.
407
438
  * Wire contract only — no prompt content, no I/O.
408
439
  */
409
440
 
@@ -445,6 +476,22 @@ declare const VIDEO_OVERLAY_BOUNDS: {
445
476
  };
446
477
  /** Σ downloaded layer bytes per job. */
447
478
  declare const VIDEO_OVERLAY_MAX_TOTAL_LAYER_BYTES: number;
479
+ /** A video layer's `sound.volume` (1 = as recorded). */
480
+ declare const VIDEO_OVERLAY_VOLUME_BOUNDS: readonly [0, 1];
481
+ /**
482
+ * Video layers per request. Measured on the pinned ffmpeg: a 60 s base with
483
+ * two video layers renders well inside the 10-minute limit (three times its
484
+ * slowest render), and three video layers do not at 60 s.
485
+ */
486
+ declare const VIDEO_OVERLAY_MAX_VIDEO_LAYERS = 2;
487
+ /**
488
+ * The longest base video, seconds, for a run with a video layer — the
489
+ * longest base for which one and two video layers both render within the
490
+ * 10-minute limit with room for three times the slowest measured render.
491
+ */
492
+ declare const VIDEO_OVERLAY_VIDEO_MAX_BASE_SEC = 60;
493
+ /** One video layer's file, bytes. */
494
+ declare const VIDEO_OVERLAY_MAX_LAYER_VIDEO_BYTES: number;
448
495
  /** Fade + scale ramp, seconds each way (clamped to half of a short layer). */
449
496
  declare const VIDEO_OVERLAY_ANIMATION_SEC = 0.15;
450
497
  /** The scale a layer grows from and shrinks back to during the ramp. */
@@ -456,9 +503,9 @@ declare const VIDEO_OVERLAY_BADGE_INSET = 4;
456
503
  declare const VIDEO_OVERLAY_DEFAULT_BACKGROUND = "#000000";
457
504
  /** The six box fields — exactly what a preset writes. */
458
505
  declare const VIDEO_OVERLAY_BOX_FIELDS: readonly ["anchor", "x", "y", "width", "height", "fit"];
459
- declare const VIDEO_OVERLAY_WARNING_CODES: readonly ["clipped", "skipped", "animated_first_frame", "audio_reencoded"];
506
+ declare const VIDEO_OVERLAY_WARNING_CODES: readonly ["clipped", "skipped", "animated_first_frame", "audio_reencoded", "layer_no_audio"];
460
507
  type VideoOverlayWarningCode = (typeof VIDEO_OVERLAY_WARNING_CODES)[number];
461
- declare const VIDEO_OVERLAY_ERROR_CODES: readonly ["no_layers", "too_many_layers", "incomplete_box", "layer_without_image", "time_out_of_range", "end_before_start", "fit_without_aspect", "field_out_of_bounds", "invalid_layer_plan"];
508
+ declare const VIDEO_OVERLAY_ERROR_CODES: readonly ["no_layers", "too_many_layers", "incomplete_box", "layer_without_image", "time_out_of_range", "end_before_start", "fit_without_aspect", "field_out_of_bounds", "invalid_layer_plan", "layer_two_sources", "too_many_video_layers", "sound_without_video", "base_box_needs_aspect", "layout_needs_aspect", "layout_needs_video_layer", "layout_conflicts_base_box"];
462
509
  type VideoOverlayErrorCode = (typeof VIDEO_OVERLAY_ERROR_CODES)[number];
463
510
  interface VideoOverlayBox {
464
511
  readonly anchor: OverlayAnchor;
@@ -468,6 +515,15 @@ interface VideoOverlayBox {
468
515
  readonly height?: number;
469
516
  readonly fit: VideoOverlayFit;
470
517
  }
518
+ /** A box as a writer may send it (the base box from workflow JSON): every field optional; `null` means absent. */
519
+ type VideoOverlayBoxInput = {
520
+ readonly [K in keyof VideoOverlayBox]?: VideoOverlayBox[K] | null;
521
+ };
522
+ /** A video layer's sound, mixed with the base's during the layer's window. Absent = the layer is silent. */
523
+ interface VideoOverlaySound {
524
+ /** 0..1 (`VIDEO_OVERLAY_VOLUME_BOUNDS`). */
525
+ readonly volume: number;
526
+ }
471
527
  /** A layer as stored and enqueued — complete: every box and look field present. */
472
528
  interface VideoOverlayLayer {
473
529
  /**
@@ -477,6 +533,14 @@ interface VideoOverlayLayer {
477
533
  * and the run-time merge is still `wired ?? imageUrl` everywhere.
478
534
  */
479
535
  imageUrl?: string;
536
+ /**
537
+ * The layer's video, instead of `imageUrl` — never both. Cleared by wiring
538
+ * exactly as `imageUrl` is; a wired handle's source is a video when the
539
+ * assembly is told so (`wiredVideoSlots`).
540
+ */
541
+ videoUrl?: string;
542
+ /** A video layer only. */
543
+ sound?: VideoOverlaySound;
480
544
  /** 1-based canvas slot (overlay = 1 … overlay12 = 12; 13 and up handle-less), stamped by both engine assemblies. Messages prefer it. */
481
545
  slot?: number;
482
546
  /** 1-based entry of a wired layer plan, stamped by the assembly. Messages prefer it. */
@@ -496,12 +560,12 @@ interface VideoOverlayLayer {
496
560
  y: number;
497
561
  /** % of the output canvas width (1..100). */
498
562
  width: number;
499
- /** % of the output canvas height (1..100); absent = follows the image's aspect. */
563
+ /** % of the output canvas height (1..100); absent = follows the image's (or video's) aspect. */
500
564
  height?: number;
501
565
  fit: VideoOverlayFit;
502
566
  /** 0..1 */
503
567
  opacity: number;
504
- /** Fade + slight scale in and out, 0.15 s each way. */
568
+ /** Fade + slight scale in and out, 0.15 s each way. Default on for an image, off for a video. */
505
569
  animate: boolean;
506
570
  /** Integer 0..100; absent = its position (slot − 1: layer 1 lowest). */
507
571
  zIndex?: number;
@@ -510,25 +574,54 @@ interface VideoOverlayLayer {
510
574
  type VideoOverlayLayerInput = {
511
575
  [K in keyof VideoOverlayLayer]?: VideoOverlayLayer[K] | null;
512
576
  };
513
- /** A layer on the REST / SDK wire: image and start required; the box may be a preset, explicit fields, or nothing (→ the corner-badge default). */
577
+ /**
578
+ * A layer on the REST / SDK wire: exactly one of `imageUrl` / `videoUrl`, and
579
+ * `start`, required; the box may be a preset, explicit fields, or nothing
580
+ * (→ the corner-badge default).
581
+ */
514
582
  type VideoOverlayLayerSpec = {
515
- imageUrl: string;
516
583
  start: number;
517
- } & Partial<Omit<VideoOverlayLayer, "imageUrl" | "start">>;
584
+ } & Partial<Omit<VideoOverlayLayer, "imageUrl" | "videoUrl" | "start">> & ({
585
+ imageUrl: string;
586
+ videoUrl?: never;
587
+ } | {
588
+ videoUrl: string;
589
+ imageUrl?: never;
590
+ });
591
+ /**
592
+ * A base box on the REST / SDK wire: `anchor` and `width` required; `x` and
593
+ * `y` default to 0 and `fit` to contain (`expandVideoOverlayLayout`), and no
594
+ * `height` follows the base's own aspect.
595
+ */
596
+ type VideoOverlayBaseBoxSpec = Pick<VideoOverlayBox, "anchor" | "width"> & Partial<Omit<VideoOverlayBox, "anchor" | "width">>;
518
597
  /** The `POST /v1/video-overlay` body. */
519
598
  interface VideoOverlayRequest {
520
599
  videoUrl: string;
521
- /** 1..20 */
600
+ /** 1..20, at most `VIDEO_OVERLAY_MAX_VIDEO_LAYERS` (2) of them videos. */
522
601
  layers: VideoOverlayLayerSpec[];
523
602
  outputAspect?: VideoOverlayOutputAspect;
524
603
  /** Only with `outputAspect`; default cover. */
525
604
  baseFit?: VideoOverlayFit;
526
605
  /** `#rrggbb`, only with `outputAspect` (drawn under `contain`); default `#000000`. */
527
606
  backgroundColor?: string;
607
+ /** Where the base sits, in a layer's box vocabulary; only with `outputAspect`. Overrides `baseFit`; uncovered canvas shows `backgroundColor`. Refused with a stack layout. */
608
+ baseBox?: VideoOverlayBaseBoxSpec;
609
+ /**
610
+ * A named layout that writes the boxes (`expandVideoOverlayLayout`): an
611
+ * explicit `baseBox` wins over `video-bottom` / `video-top`; a stack places
612
+ * the base itself and takes none; `pip` replaces the first video layer's box.
613
+ */
614
+ layout?: VideoOverlayLayoutId;
528
615
  }
529
616
  /** A request whose layers went through `expandVideoOverlayPresets`. */
530
- interface ExpandedVideoOverlayRequest extends Omit<VideoOverlayRequest, "layers"> {
617
+ interface ExpandedVideoOverlayRequest extends Omit<VideoOverlayRequest, "layers" | "baseBox"> {
531
618
  layers: VideoOverlayLayer[];
619
+ /**
620
+ * The base box as stored or sent, its `null` fields dropped — any field may
621
+ * be absent. The validator refuses one without an anchor and a width; the
622
+ * worker fills the rest (`expandVideoOverlayLayout`) after it.
623
+ */
624
+ baseBox?: Partial<VideoOverlayBox>;
532
625
  /** Set by the assembly when a wired layer plan could not be read; `validateVideoOverlayRequest` reports it first. */
533
626
  planError?: "invalid_layer_plan";
534
627
  }
@@ -571,9 +664,12 @@ declare function videoOverlayPresetBox(preset: VideoOverlayPresetId, corner?: Vi
571
664
  * fields, the layer's own fields winning (D8): `{}` → the full default.
572
665
  * - no `preset` + a PARTIAL box (not anchor AND width) → returned untouched;
573
666
  * the validator answers `incomplete_box`.
574
- * Trailing defaults x 0, y 0, fit contain, opacity 1, animate true are filled
575
- * here and nowhere else. `null` reads as absent. Returned BY REFERENCE when
576
- * nothing changes; idempotent, tag included.
667
+ * Trailing defaults x 0, y 0, fit contain, opacity 1, and animate (true for an
668
+ * image, false for a video layer — in every branch, the default layer's included)
669
+ * are filled here and nowhere else. A VIDEO layer with a preset and no `start`
670
+ * starts at 0, like the default layer; an image one is left to the validator
671
+ * (`time_out_of_range`), as it always was. `null` reads as absent. Returned BY
672
+ * REFERENCE when nothing changes; idempotent, tag included.
577
673
  */
578
674
  declare function expandVideoOverlayLayer(raw: VideoOverlayLayerInput | null | undefined): VideoOverlayLayer;
579
675
  /** `expandVideoOverlayLayer` over an array; the SAME array when no layer changed. */
@@ -583,10 +679,11 @@ declare function applyVideoOverlayPreset(layer: VideoOverlayLayerInput | null |
583
679
  /** The panel's "Custom": the tag is cleared, the box kept. */
584
680
  declare function toCustomVideoOverlayLayer(layer: VideoOverlayLayerInput | null | undefined): VideoOverlayLayer;
585
681
  /**
586
- * D10 — delete `imageUrl` from every layer whose canvas handle is wired
587
- * (`wiredSlots`: 1-based). Pure over `layers` (the route has no edges, so this
588
- * is a sibling of the expansion, not part of it). Slots 13 and up have no handle
589
- * and are never touched. The input array by reference when nothing changes.
682
+ * D10 — delete `imageUrl` AND `videoUrl` from every layer whose canvas handle
683
+ * is wired (`wiredSlots`: 1-based): the wire is the layer's source, whichever
684
+ * kind it is. Pure over `layers` (the route has no edges, so this is a sibling
685
+ * of the expansion, not part of it). Slots 13 and up have no handle and are
686
+ * never touched. The input array by reference when nothing changes.
590
687
  */
591
688
  declare function clearWiredVideoOverlayImageUrls<T extends VideoOverlayLayerInput | null | undefined>(layers: readonly T[], wiredSlots: ReadonlySet<number>): readonly T[];
592
689
  interface NodeLike {
@@ -633,6 +730,107 @@ interface VideoOverlayOrderable {
633
730
  * (layer 1 lowest).
634
731
  */
635
732
  declare function videoOverlayRenderOrder(layers: ReadonlyArray<VideoOverlayOrderable | null | undefined>): number[];
733
+ /** The wired `layerPlan` value (a JSON string or an array) → its layers, or `invalid_layer_plan`. */
734
+ declare function parseVideoOverlayLayerPlan(raw: unknown): {
735
+ layers: VideoOverlayLayerInput[];
736
+ } | {
737
+ error: "invalid_layer_plan";
738
+ };
739
+ /** The node-data fields the assembly reads. */
740
+ interface VideoOverlayNodeFields {
741
+ readonly layers?: ReadonlyArray<VideoOverlayLayerInput | null | undefined> | null;
742
+ readonly outputAspect?: string | null;
743
+ readonly baseFit?: string | null;
744
+ readonly backgroundColor?: string | null;
745
+ /** As written, like the fields above: the validator, not the type, refuses a malformed box or an unknown layout. */
746
+ readonly baseBox?: VideoOverlayBoxInput | null;
747
+ readonly layout?: string | null;
748
+ }
749
+ /**
750
+ * The ONE node → request assembly, called by the canvas single-node run AND
751
+ * payload-builder (so both engines refuse identically). Per slot i over
752
+ * max(wired handles (≤ 12), stored layers) — every stored slot, so more than
753
+ * 20 layers that render reach the validator's `too_many_layers` instead of
754
+ * being dropped: the source is the wired handle's — a `videoUrl` when its slot
755
+ * is in `wiredVideoSlots`, else an `imageUrl` (a stored `sound` skipped, so a
756
+ * wire read as an image at the run never refuses it), replacing both stored
757
+ * sources — else the layer's own `imageUrl` / `videoUrl` as stored (both stored reach
758
+ * the validator's `layer_two_sources`; an empty-string one is dropped —
759
+ * `withoutEmptyVideoOverlaySources`, plan layers too); a slot with neither is dropped; a slot with
760
+ * no settings is the default layer (D2 — a `null` / missing / `{}` entry);
761
+ * `slot = i + 1` is stamped; the layer is expanded. `baseFit` /
762
+ * `backgroundColor` ride as stored, WITH or WITHOUT an `outputAspect`: the
763
+ * validator — not this assembly — refuses them without one
764
+ * (`fit_without_aspect`, spec §3.5), so a JSON-written node carrying a fit
765
+ * and no aspect is refused on both engines instead of silently rendering.
766
+ * (The canvas never builds that request: its two aspect writers clear both
767
+ * fields with the aspect.) A value the route's schema would reject — an
768
+ * unknown aspect or fit, a colour that is not `#rrggbb` — is dropped here.
769
+ * `baseBox` and `layout` ride AS STORED (a `""` layout reads as absent, like
770
+ * `null`; a box's `null` fields are dropped, as a layer's are by its
771
+ * expansion — every reader treats them as absent, and the REST route's schema
772
+ * takes no `null`, so the canvas run's request stays one the route accepts): a
773
+ * malformed box or an unknown layout reaches the validator, which refuses it
774
+ * on both engines.
775
+ *
776
+ * A wired layer plan (`planLayers`, a JSON string or an array) contributes its
777
+ * layers FIRST, then the slot layers: plan layers carry `planLayer` (1-based)
778
+ * and never a `slot`, and a plan layer's image is only its own `imageUrl` —
779
+ * never the index-aligned handle's (R18). An unreadable plan sets `planError`,
780
+ * which the validator reports before anything else.
781
+ */
782
+ declare function assembleVideoOverlayRequest(input: {
783
+ readonly videoUrl: string;
784
+ readonly data: VideoOverlayNodeFields;
785
+ /** Each wired handle's source, by slot (images and videos alike). */
786
+ readonly wiredImageUrls: ReadonlyArray<string | null | undefined>;
787
+ /** 1-based slots whose wired source is a video (`videoOverlayWiredLayerKind`); absent = every wire is an image. */
788
+ readonly wiredVideoSlots?: ReadonlySet<number>;
789
+ /** The wired `layerPlan` value (string or array); absent when nothing is wired. */
790
+ readonly planLayers?: unknown;
791
+ }): ExpandedVideoOverlayRequest;
792
+ /**
793
+ * Slot i's source: the wired handle's, else the layer's own `imageUrl`, else
794
+ * its own `videoUrl` — the one source rule the stage, the panel, the canvas
795
+ * executor and the DAG payload share (the render's merge is the same
796
+ * `wired ?? imageUrl ?? videoUrl`, spec §3.5). Every stored slot, past 20 too:
797
+ * the limit is the layer COUNT, not the slot (layers 1–4 removed from a
798
+ * 24-layer node leave 20 at slots 5–24). Only the wired list is capped, at the
799
+ * 12 handles.
800
+ */
801
+ declare function videoOverlaySlotSources(layers: ReadonlyArray<VideoOverlayLayerInput | null | undefined> | null | undefined, wiredImageUrls: ReadonlyArray<string | null | undefined>): Array<string | undefined>;
802
+ /** Everything that decides what a Video Overlay run paints. */
803
+ interface VideoOverlayComposition {
804
+ /** The resolved base video URL. */
805
+ readonly baseUrl?: string | null;
806
+ /** The image or video each slot draws, by slot index (`videoOverlaySlotSources`). */
807
+ readonly sources: ReadonlyArray<string | null | undefined>;
808
+ /** The node's stored settings — never the expanded request. */
809
+ readonly data: VideoOverlayNodeFields;
810
+ /** The wired `layerPlan` value (string or array); absent when nothing is wired. */
811
+ readonly planLayers?: unknown;
812
+ /** The 1-based slots whose wired source is a video (the assembly's `wiredVideoSlots`); absent or empty = every wire is an image. */
813
+ readonly videoSlots?: Iterable<number> | null;
814
+ }
815
+ /**
816
+ * The longest `resultCompositionKey` the REST route accepts. The canvas sends
817
+ * its key with a single-node Run so the job's output_data carries it (a result
818
+ * that lands after a page reload reads fresh); the route stores it opaquely and
819
+ * reads it for nothing else. A full 20-layer composition with long signed URLs
820
+ * fits well inside; a canvas key past it is not sent.
821
+ */
822
+ declare const VIDEO_OVERLAY_MAX_COMPOSITION_KEY_LENGTH = 65536;
823
+ /**
824
+ * The composition key a run stamps on its result (`resultCompositionKey`): the
825
+ * base, every slot's image, the layers, the output aspect, the fit, the pad
826
+ * colour, the base box, the layout and which wired slots are videos. A later
827
+ * change to any of them marks the result "Result (old)".
828
+ * Canonical — independent of object key order, of absent vs undefined vs null
829
+ * fields, and of trailing empty slots — so the canvas (the node and its
830
+ * single-node Run) and the DAG payload give one key for one composition.
831
+ */
832
+ declare function videoOverlayCompositionKey(c: VideoOverlayComposition): string;
833
+
636
834
  interface VideoOverlayRect {
637
835
  readonly left: number;
638
836
  readonly top: number;
@@ -671,6 +869,7 @@ declare function videoOverlayCanvas(display: {
671
869
  * the canvas clamp, the even rounding.
672
870
  */
673
871
  declare function resolveVideoOverlayGeometry(canvas: VideoOverlayCanvas, layer: Pick<VideoOverlayLayer, "anchor" | "x" | "y" | "width" | "height" | "fit">, imageAspect: number): VideoOverlayGeometry;
872
+
674
873
  interface VideoOverlayIssue {
675
874
  readonly ok: false;
676
875
  readonly code: VideoOverlayErrorCode;
@@ -688,6 +887,8 @@ interface VideoOverlayValidationInput {
688
887
  readonly outputAspect?: string | null;
689
888
  readonly baseFit?: string | null;
690
889
  readonly backgroundColor?: string | null;
890
+ readonly baseBox?: VideoOverlayBoxInput | null;
891
+ readonly layout?: string | null;
691
892
  /** From `assembleVideoOverlayRequest`: the wired layer plan was unreadable. */
692
893
  readonly planError?: "invalid_layer_plan";
693
894
  }
@@ -710,8 +911,16 @@ declare function hasDrawableVideoOverlayBox(layer: unknown): boolean;
710
911
  * expanded field). Also refuses a PRESENT box / look field outside
711
912
  * `VIDEO_OVERLAY_BOUNDS` or its enum / type (`field_out_of_bounds`, spec §4.4's
712
913
  * "out-of-bounds box/opacity/zIndex" row — on the DAG path this validator is
713
- * the only check). A non-object `layers[]` entry reads as an empty layer. The
714
- * FIRST failure, as a code.
914
+ * the only check). A layer carries an image or a video, never both
915
+ * (`layer_two_sources`), at most `VIDEO_OVERLAY_MAX_VIDEO_LAYERS` are videos,
916
+ * and only a video layer has `sound`. A non-object `layers[]` entry reads as
917
+ * an empty layer. A `layout` (`""` reads as absent) must be known, a stack
918
+ * takes no `baseBox` (`layout_conflicts_base_box`: it places the base
919
+ * itself); a `baseBox` follows the layer rule (`incomplete_box`,
920
+ * `field_out_of_bounds` as `baseBox.<field>`) and needs an `outputAspect`; a
921
+ * layout gets what it needs (an aspect, a video layer) — checked before
922
+ * `base_box_needs_aspect`, so writing a layout's base box does not change the
923
+ * verdict. The FIRST failure, as a code.
715
924
  */
716
925
  declare function validateVideoOverlayRequest(body: VideoOverlayValidationInput): VideoOverlayValidation;
717
926
  /** `Plan layer <n>` for a layer-plan entry, `Layer <slot>` when the layer came from the canvas, else `layers[<index>]`; "" for a request-wide failure. */
@@ -722,86 +931,259 @@ declare function videoOverlayLayerLabel(ref: {
722
931
  }): string;
723
932
  /** The ONE English rendering of a verdict — the route's 400 text and the worker's error message. */
724
933
  declare function formatVideoOverlayError(issue: VideoOverlayIssue): string;
725
- /** The wired `layerPlan` value (a JSON string or an array) → its layers, or `invalid_layer_plan`. */
726
- declare function parseVideoOverlayLayerPlan(raw: unknown): {
727
- layers: VideoOverlayLayerInput[];
728
- } | {
729
- error: "invalid_layer_plan";
730
- };
731
- /** The node-data fields the assembly reads. */
732
- interface VideoOverlayNodeFields {
733
- readonly layers?: ReadonlyArray<VideoOverlayLayerInput | null | undefined> | null;
734
- readonly outputAspect?: string | null;
735
- readonly baseFit?: string | null;
736
- readonly backgroundColor?: string | null;
737
- }
934
+
738
935
  /**
739
- * The ONE node → request assembly, called by the canvas single-node run AND
740
- * payload-builder (so both engines refuse identically). Per slot i over
741
- * max(wired handles (≤ 12), stored layers) — every stored slot, so more than
742
- * 20 layers that render reach the validator's `too_many_layers` instead of
743
- * being dropped: the image is the wired handle's,
744
- * else the layer's own `imageUrl`; a slot with neither is dropped; a slot with
745
- * no settings is the default layer (D2 — a `null` / missing / `{}` entry);
746
- * `slot = i + 1` is stamped; the layer is expanded. `baseFit` /
747
- * `backgroundColor` ride as stored, WITH or WITHOUT an `outputAspect`: the
748
- * validator — not this assembly — refuses them without one
749
- * (`fit_without_aspect`, spec §3.5), so a JSON-written node carrying a fit
750
- * and no aspect is refused on both engines instead of silently rendering.
751
- * (The canvas never builds that request: its two aspect writers clear both
752
- * fields with the aspect.) A value the route's schema would reject — an
753
- * unknown aspect or fit, a colour that is not `#rrggbb` — is dropped here.
936
+ * Video Overlay video layers — what makes a layer a video, and what kind of
937
+ * layer a wired source becomes. A sibling of `video-overlay.ts`, which imports
938
+ * from here at run time; this file imports from it for TYPES only, so the
939
+ * dependency stays one-way.
754
940
  *
755
- * A wired layer plan (`planLayers`, a JSON string or an array) contributes its
756
- * layers FIRST, then the slot layers: plan layers carry `planLayer` (1-based)
757
- * and never a `slot`, and a plan layer's image is only its own `imageUrl` —
758
- * never the index-aligned handle's (R18). An unreadable plan sets `planError`,
759
- * which the validator reports before anything else.
941
+ * A layer is a video layer when it carries a non-empty `videoUrl`: the
942
+ * validator's count, the `animate` default and `videoOverlayHasVideoLayer`
943
+ * all read it through `isVideoOverlayVideoLayer`, so they cannot disagree.
944
+ * Wire contract only — no I/O.
760
945
  */
761
- declare function assembleVideoOverlayRequest(input: {
762
- readonly videoUrl: string;
763
- readonly data: VideoOverlayNodeFields;
764
- readonly wiredImageUrls: ReadonlyArray<string | null | undefined>;
765
- /** The wired `layerPlan` value (string or array); absent when nothing is wired. */
766
- readonly planLayers?: unknown;
767
- }): ExpandedVideoOverlayRequest;
946
+
947
+ /** True when any layer is a video layer. Non-array input and non-object entries read as none. */
948
+ declare function videoOverlayHasVideoLayer(layers: ReadonlyArray<VideoOverlayLayerInput | null | undefined> | null | undefined): boolean;
949
+ type VideoOverlayWiredLayerKind = "image" | "video";
950
+ /** The wire a layer handle receives, as both engines' resolvers know it. */
951
+ interface VideoOverlayWiredSource {
952
+ /** The source node's type. */
953
+ readonly type?: string | null;
954
+ /** The source handle the wire leaves (through any teleport). */
955
+ readonly handle?: string | null;
956
+ /** The medium the source declares for that handle — a component's or sub-workflow's port (`declaredOutputMediaType`). */
957
+ readonly declaredMediaType?: string | null;
958
+ /**
959
+ * The medium a List column's type declares for that handle
960
+ * (`listColumnMediaType`). It ranks BELOW the URL's extension: it only fills
961
+ * the gap for a link with no recognisable one.
962
+ */
963
+ readonly columnMediaType?: string | null;
964
+ }
768
965
  /**
769
- * Slot i's image: the wired handle's, else the layer's own `imageUrl` — the
770
- * one source rule the stage, the panel, the canvas executor and the DAG
771
- * payload share (the render's merge is the same `wired ?? imageUrl`, spec
772
- * §3.5). Every stored slot, past 20 too: the limit is the layer COUNT, not
773
- * the slot (layers 1–4 removed from a 24-layer node leave 20 at slots 5–24).
774
- * Only the wired list is capped, at the 12 handles.
775
- */
776
- declare function videoOverlaySlotSources(layers: ReadonlyArray<VideoOverlayLayerInput | null | undefined> | null | undefined, wiredImageUrls: ReadonlyArray<string | null | undefined>): Array<string | undefined>;
777
- /** Everything that decides what a Video Overlay run paints. */
778
- interface VideoOverlayComposition {
779
- /** The resolved base video URL. */
780
- readonly baseUrl?: string | null;
781
- /** The image each slot draws, by slot index (`videoOverlaySlotSources`). */
782
- readonly sources: ReadonlyArray<string | null | undefined>;
783
- /** The node's stored settings — never the expanded request. */
784
- readonly data: VideoOverlayNodeFields;
785
- /** The wired `layerPlan` value (string or array); absent when nothing is wired. */
786
- readonly planLayers?: unknown;
966
+ * What a source wired to a layer handle draws as — the ONE rule both engines
967
+ * call, in this order:
968
+ * 1. the medium the wire is known to carry: a pip row of its own
969
+ * (`LAYER_PIP_KINDS`), the medium a port declares (`declaredMediaType`:
970
+ * `image` or `video`), or the source's effective type for that handle
971
+ * (an aggregate lane, a scraper's typed pip, an entity's or an output's
972
+ * image pip — `resolveEffectiveSourceType`) when that is a single-medium producer;
973
+ * 2. the producer sets, for a single-medium producer only;
974
+ * 3. the URL path's extension, when it is a recognisable video or image one
975
+ * (a list, a sub-workflow, a producer in both sets);
976
+ * 4. a List column's declared type (`columnMediaType`: `image` or `video`),
977
+ * for a link with no recognisable extension — so a `.png` in a
978
+ * `video-url` column stays an image, as it was before video layers;
979
+ * 5. an image, as every layer was before video layers existed.
980
+ */
981
+ declare function videoOverlayWiredLayerKind(source: VideoOverlayWiredSource, url: string): VideoOverlayWiredLayerKind;
982
+ /** What a wire hands a Video Overlay before the run: an image, a video, or not known yet. */
983
+ type VideoOverlayWireMedium = VideoOverlayWiredLayerKind | "unknown";
984
+ /** Where a wire lands on a Video Overlay: a layer handle, or the `layerPlan` handle. */
985
+ interface VideoOverlayWireBeforeRun {
986
+ /** Default `layer`. */
987
+ readonly target?: "layer" | "plan";
988
+ /** A layer wire's files already known before the run (a List's own cells); none = not known. */
989
+ readonly knownUrls?: readonly string[];
787
990
  }
788
991
  /**
789
- * The longest `resultCompositionKey` the REST route accepts. The canvas sends
790
- * its key with a single-node Run so the job's output_data carries it (a result
791
- * that lands after a page reload reads fresh); the route stores it opaquely and
792
- * reads it for nothing else. A full 20-layer composition with long signed URLs
793
- * fits well inside; a canvas key past it is not sent.
794
- */
795
- declare const VIDEO_OVERLAY_MAX_COMPOSITION_KEY_LENGTH = 65536;
992
+ * What a source wired to a Video Overlay hands it, as far as it is known
993
+ * BEFORE the run: the ONE place a run estimate asks.
994
+ *
995
+ * On a layer handle, by the run's own rule ({@link videoOverlayWiredLayerKind}):
996
+ * a source that decides by itself (a pip row, a declared port, a single-medium
997
+ * producer) answers its kind; one whose kind follows its file answers by the
998
+ * files already known (`knownUrls`, read in the run's order: the extension,
999
+ * then a List column's type), and is `unknown` when none is.
1000
+ *
1001
+ * On the `layerPlan` handle, only a plan pip row answers `image`
1002
+ * (`LAYER_PLAN_PIP_KINDS`: UGC Cards' plan is its card images): a declared
1003
+ * port, a producer set or a List column says what a FILE is, not what a
1004
+ * plan's layers are, so any other plan is `video` when its source is a video
1005
+ * and `unknown` otherwise.
1006
+ *
1007
+ * A run estimate prices `unknown` as a video run, so a quote is never below
1008
+ * what the run is charged; once a file is known, the answer is the run's.
1009
+ */
1010
+ declare function videoOverlayWireMediumBeforeRun(source: VideoOverlayWiredSource, wire?: VideoOverlayWireBeforeRun): VideoOverlayWireMedium;
1011
+ /**
1012
+ * The medium a component or sub-workflow declares for the handle a wire
1013
+ * leaves (`image`, `video`, `audio`, `text`, `any`), or undefined. A
1014
+ * sub-workflow (and a component) names its output ports in
1015
+ * `routeSnapshot.outputPorts`, its handles `out_<port>`; a component falls back
1016
+ * to `componentMetadata.outputs[].type`; a sub-workflow input node names its
1017
+ * ports in `ports`, by their own ids. The same fields both engines' input
1018
+ * resolvers route these wires by. (A List's column type is not a port
1019
+ * declaration: `listColumnMediaType` reads it, and it ranks below the URL's
1020
+ * extension.) Untrusted node data: anything malformed declares nothing.
1021
+ */
1022
+ declare function declaredOutputMediaType(type: string | null | undefined, data: unknown, handle: string | null | undefined): string | undefined;
1023
+ /**
1024
+ * The medium a List's column type declares for the pip a wire leaves
1025
+ * (`image-url` → image, `video-url` → video, `audio-url` → audio): the column
1026
+ * whose `handleId` the pip names, else its first column — the column a List's
1027
+ * own `list` pip carries, as both engines' input resolvers route it. Undefined
1028
+ * for any other source, a text or JSON column, or malformed data. Handed to the
1029
+ * wired-kind rule as `columnMediaType`, where it ranks below the URL's extension.
1030
+ */
1031
+ declare function listColumnMediaType(type: string | null | undefined, data: unknown, handle: string | null | undefined): string | undefined;
1032
+ /**
1033
+ * A WIRED slot's layer as it is stored: the expanded layer `expanded`, minus an
1034
+ * `animate` its writer did not set (`written`: the stored layer and the edit
1035
+ * applied to it). A wired slot's kind is its wire's, known only where the wire
1036
+ * is read — the run's assembly and the canvas stage — and the expansion there
1037
+ * fills the fade default by that kind (on for an image, off for a video); a
1038
+ * default stored here would fix one kind's default on the other, so a video
1039
+ * wired in later would fade. `written` itself when the result has the same
1040
+ * fields (an idempotent write); `expanded` by reference when nothing is removed.
1041
+ */
1042
+ declare function withoutImpliedVideoOverlayAnimate(expanded: VideoOverlayLayerInput, written: VideoOverlayLayerInput | null | undefined): VideoOverlayLayerInput;
1043
+
796
1044
  /**
797
- * The composition key a run stamps on its result (`resultCompositionKey`): the
798
- * base, every slot's image, the layers, the output aspect, the fit and the pad
799
- * colour. A later change to any of them marks the result "Result (old)".
800
- * Canonical — independent of object key order, of absent vs undefined vs null
801
- * fields, and of trailing empty slots — so the canvas (the node and its
802
- * single-node Run) and the DAG payload give one key for one composition.
1045
+ * Video Overlay layouts and the placed base — the request-level normaliser
1046
+ * (`expandVideoOverlayLayout`) and the geometry the canvas preview and the
1047
+ * ffmpeg worker both call, so the preview and the render cannot disagree.
1048
+ * A sibling of `video-overlay.ts`: it imports from there, nothing there imports
1049
+ * from here, and the layout ids live in the dependency-free
1050
+ * `video-overlay-layout-ids.ts`.
1051
+ *
1052
+ * - `video-bottom` / `video-top` write a base box; an explicit one wins.
1053
+ * - `pip` writes the first video layer's box in its corner.
1054
+ * - The two stacks write no box: their rects depend on the sources' shapes,
1055
+ * known only after probing, so the worker and the preview call
1056
+ * `resolveVideoOverlayStackRects` with them. A stack places the base
1057
+ * itself, so the validator refuses one with a `baseBox` (`layout_conflicts_base_box`).
1058
+ * `pip` and the two stacks turn the first video layer's fade off;
1059
+ * `video-bottom` / `video-top` touch no layer. "First video layer" is the
1060
+ * lowest one (`firstVideoLayerIndex`); image layers are left where they are.
1061
+ * A probed video's aspect goes through `clampVideoOverlayAspect` before any of
1062
+ * this geometry, and a video's rect through `evenVideoOverlayRect` after it —
1063
+ * in the worker and the preview alike.
1064
+ * Wire contract only — no I/O.
803
1065
  */
804
- declare function videoOverlayCompositionKey(c: VideoOverlayComposition): string;
1066
+
1067
+ /** Picture in picture: the inset's width and its margin from the corner, % of the output canvas (Speaker View's inset). */
1068
+ declare const VIDEO_OVERLAY_PIP_WIDTH = 30;
1069
+ declare const VIDEO_OVERLAY_PIP_INSET = 4;
1070
+ /** What a layout reads and writes — a request, an assembled request, or node data. */
1071
+ interface VideoOverlayLayoutFields {
1072
+ readonly layout?: string | null;
1073
+ readonly baseBox?: VideoOverlayBoxInput | null;
1074
+ readonly layers?: ReadonlyArray<VideoOverlayLayerInput | null | undefined> | null;
1075
+ }
1076
+ /**
1077
+ * The narrowest and widest aspect a probed video is placed at. A video's
1078
+ * shape is only known from its probe, and nothing bounds a probe, so a stack
1079
+ * of a 1:1000 sliver could otherwise place a rect off the canvas. Inside these
1080
+ * bounds every stack, base and layer rect stays on it.
1081
+ */
1082
+ declare const VIDEO_OVERLAY_ASPECT_BOUNDS: readonly [number, 8];
1083
+ /**
1084
+ * A probed video's display aspect (width ÷ height), held inside
1085
+ * `VIDEO_OVERLAY_ASPECT_BOUNDS`; one that is not a positive finite number
1086
+ * reads as square, as in the layer geometry. The worker and the preview pass
1087
+ * every video's aspect (the base's and each video layer's) through this before
1088
+ * any placement, so they place the same rects.
1089
+ */
1090
+ declare function clampVideoOverlayAspect(aspect: number): number;
1091
+ /**
1092
+ * A video's rect as the render draws it: left and top rounded DOWN to even,
1093
+ * and the size down to even. ffmpeg's overlay on yuv420 clears the low bit of
1094
+ * an odd x or y (a base placed at top 371 is drawn at 370), so this is where
1095
+ * the picture lands anyway; the worker hands the graph these numbers and the
1096
+ * preview draws them, so the two agree to the pixel. A stack's two rects move
1097
+ * by the same pixel (its heights are even), so its join stays exact. Applied
1098
+ * to the base's rect and to video layers only — an image layer's geometry is
1099
+ * unchanged. By reference when the rect is already even.
1100
+ */
1101
+ declare function evenVideoOverlayRect(rect: VideoOverlayRect): VideoOverlayRect;
1102
+ /** The lowest video layer by `videoOverlayRenderOrder`, as its index in `layers`; -1 when there is none. */
1103
+ declare function firstVideoLayerIndex(layers: ReadonlyArray<(VideoOverlayOrderable & {
1104
+ readonly videoUrl?: string | null;
1105
+ }) | null | undefined> | null | undefined): number;
1106
+ /**
1107
+ * The request-level normaliser: what a `layout` writes, and an explicit base
1108
+ * box's defaults. Called at the write boundaries and by the worker after the
1109
+ * validator. An explicit `baseBox` wins over `video-bottom` / `video-top`;
1110
+ * `pip` places the first video layer; the stacks write no box. An unknown
1111
+ * layout writes nothing (the validator refuses it), and neither does any
1112
+ * layout to a first video layer the validator refuses, so the verdict is the
1113
+ * same before and after. Never mutates; the request BY REFERENCE when nothing
1114
+ * changes; idempotent.
1115
+ */
1116
+ declare function expandVideoOverlayLayout<T extends VideoOverlayLayoutFields>(req: T): T & {
1117
+ readonly baseBox?: VideoOverlayBox;
1118
+ };
1119
+ /**
1120
+ * The two stacked rects, `top` for the base and `bottom` for the first video
1121
+ * layer, in output pixels.
1122
+ * - `stack-whole`: both whole, the same even width, touching, the pair centred
1123
+ * with equal spare room above and below (±1 px). They shrink together only
1124
+ * when both together are taller than the canvas. The join is pixel-exact.
1125
+ * - `stack-filled`: the top half (rounded down to even) and the rest, full
1126
+ * width; the aspects are not read — both are cropped (`cover`).
1127
+ * An aspect that is not a positive finite number reads as square.
1128
+ */
1129
+ declare function resolveVideoOverlayStackRects(layout: "stack-whole" | "stack-filled", canvas: VideoOverlayCanvas, topAspect: number, bottomAspect: number): {
1130
+ top: VideoOverlayRect;
1131
+ bottom: VideoOverlayRect;
1132
+ };
1133
+ /** A picture placed on the output canvas: its even rect and how it fills it (contain = scaled to the rect, cover = cropped to it). */
1134
+ interface VideoOverlayPlacedRect {
1135
+ readonly drawn: VideoOverlayRect;
1136
+ readonly fit: VideoOverlayFit;
1137
+ }
1138
+ /** A video layer to place. */
1139
+ interface PlacedVideoOverlayVideoInput {
1140
+ /** 0-based index in the request's layers[] (what `firstVideo` names). */
1141
+ readonly index: number;
1142
+ readonly layer: Pick<VideoOverlayLayer, "anchor" | "x" | "y" | "width" | "height" | "fit">;
1143
+ /** Its display aspect (width ÷ height, rotation and sample aspect resolved); held inside the bounds here. */
1144
+ readonly aspect: number;
1145
+ }
1146
+ interface VideoOverlayVideoPlacement {
1147
+ /** Present when the base is placed (a stack or a base box); absent = the base as before (its own size, or `outputAspect` with `baseFit`). */
1148
+ readonly basePlacement?: VideoOverlayPlacedRect;
1149
+ /** Each video layer's even drawn rect and fit, by request index. */
1150
+ readonly layers: ReadonlyMap<number, VideoOverlayPlacedRect>;
1151
+ }
1152
+ /**
1153
+ * Where the base and every video layer draw, on the output canvas — the ONE
1154
+ * placement the worker renders with and the canvas preview draws with. Every
1155
+ * aspect goes through `clampVideoOverlayAspect` and every rect through
1156
+ * `evenVideoOverlayRect` here, so neither caller can skip them.
1157
+ * - A stack (`stack-whole` / `stack-filled`): both rects from
1158
+ * `resolveVideoOverlayStackRects` with the base's and the first video
1159
+ * layer's aspects; that layer's stored box is not read. `stack-filled` draws
1160
+ * both `cover`, `stack-whole` both `contain`, whatever fit is stored.
1161
+ * - Otherwise a base box (written by `video-bottom` / `video-top`, or explicit)
1162
+ * places the base with `resolveVideoOverlayBaseRect` at its own fit.
1163
+ * - Every other video layer: its box, `resolveVideoOverlayGeometry`, at its
1164
+ * aspect (`pip` has already written its box).
1165
+ * An image layer is not placed here: its geometry is unchanged. The caller
1166
+ * passes a stack's first video layer among `videos` (the worker refuses a
1167
+ * stack whose first video layer it does not keep). Pure.
1168
+ */
1169
+ declare function placeVideoOverlayVideos(input: {
1170
+ readonly canvas: VideoOverlayCanvas;
1171
+ readonly layout?: string | null;
1172
+ readonly baseBox?: VideoOverlayBox;
1173
+ readonly baseAspect: number;
1174
+ /** `firstVideoLayerIndex` of the request's layers: what a stack places under the base. */
1175
+ readonly firstVideo: number;
1176
+ readonly videos: ReadonlyArray<PlacedVideoOverlayVideoInput>;
1177
+ }): VideoOverlayVideoPlacement;
1178
+ /**
1179
+ * Where a placed base draws, in output pixels. Its SIZE is the layer
1180
+ * geometry's drawn size (`resolveVideoOverlayGeometry`: the same clamp and even
1181
+ * rounding as an image layer); it is then placed by that drawn size against the
1182
+ * anchor, plus the x / y offsets — so a contained base sits flush on its
1183
+ * anchored edge rather than centred in a box rounded to other numbers (a 16:9
1184
+ * base at the bottom of 1080x1920 draws at y 1314–1920, with no strip under it).
1185
+ */
1186
+ declare function resolveVideoOverlayBaseRect(canvas: VideoOverlayCanvas, box: VideoOverlayBox, baseAspect: number): VideoOverlayRect;
805
1187
 
806
1188
  /**
807
1189
  * Video-analysis node — shared data contract.
@@ -1815,4 +2197,4 @@ declare function resolveFrameDelivery(args: {
1815
2197
  supportsReferenceImages: boolean;
1816
2198
  }): Exclude<FrameDelivery, "auto">;
1817
2199
 
1818
- export { AUTO_DOWNLOAD_MAX_SEC, type AnalyzedScene, type AudioLayer, type ClipLook, DEFAULT_FRAME_DELIVERY, DEFAULT_FRAME_FIT, DEFAULT_VIDEO_OVERLAY_LAYER, DIRECT_VIDEO_EXTENSIONS, type EntitySlot, type EntitySlotOwner, type ExpandedVideoOverlayRequest, FRAME_DELIVERIES, FRAME_DELIVERY_BY_PROVIDER, FRAME_FITS, FRAME_FIT_STRETCH_TOLERANCE, type FrameDelivery, type FrameFit, type FrameFitPlan, INSTAGRAM_HOSTS, MAX_VIDEO_LINK_INPUT_CHARS, SLOT_TOKEN_RE, SOCIAL_VIDEO_HOSTS, type SlotVariation, VIDEO_ANALYSIS_AUDIO_MODES, VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN, VIDEO_ANALYSIS_DEFAULT_VARIATION, VIDEO_ANALYSIS_ENTITY_SOURCES, VIDEO_ANALYSIS_FACELESS_ANGLES, VIDEO_ANALYSIS_MAX_SCENE_SEC, VIDEO_ANALYSIS_MAX_VARIATIONS, VIDEO_ANALYSIS_SHOT_ANGLES, VIDEO_ANALYSIS_SPEED_EFFECTS, VIDEO_ANALYSIS_STORY_JUMPS, VIDEO_ANALYSIS_TEXT_KINDS, VIDEO_ANALYSIS_TIMES_OF_DAY, VIDEO_ANALYSIS_TRANSITIONS, VIDEO_ANALYSIS_VARIATION_SLUGS, VIDEO_ANALYSIS_VISUAL_EFFECTS, VIDEO_CHARACTER_DESCRIPTION_MAX, VIDEO_CHARACTER_EXTRA_IMAGES_MAX, VIDEO_CHARACTER_NAME_MAX, VIDEO_CHARACTER_REFS_WIRE_MAX, VIDEO_CHARACTER_VOICE_DESCRIPTION_MAX, VIDEO_CHARACTER_VOICE_EXAMPLE_MAX, VIDEO_LINK_AUDIO_CONSUMER_TYPES, VIDEO_LINK_DERIVED_FIELDS, VIDEO_LINK_TOLERANT_CONSUMER_TYPES, VIDEO_OUTPUT_CANVAS, VIDEO_OVERLAY_ANIMATION_MIN_SCALE, VIDEO_OVERLAY_ANIMATION_SEC, VIDEO_OVERLAY_BADGE_INSET, VIDEO_OVERLAY_BADGE_WIDTH, VIDEO_OVERLAY_BOUNDS, VIDEO_OVERLAY_BOX_FIELDS, VIDEO_OVERLAY_CORNERS, VIDEO_OVERLAY_DEFAULT_BACKGROUND, VIDEO_OVERLAY_ERROR_CODES, VIDEO_OVERLAY_FITS, VIDEO_OVERLAY_HANDLE_IDS, VIDEO_OVERLAY_LAYER_PLAN_HANDLE, VIDEO_OVERLAY_MAX_COMPOSITION_KEY_LENGTH, VIDEO_OVERLAY_MAX_LAYERS, VIDEO_OVERLAY_MAX_TIME_SEC, VIDEO_OVERLAY_MAX_TOTAL_LAYER_BYTES, VIDEO_OVERLAY_OUTPUT_ASPECTS, VIDEO_OVERLAY_PRESETS, VIDEO_OVERLAY_PRESET_IDS, VIDEO_OVERLAY_WARNING_CODES, type VideoAnalysisAudioMode, type VideoAnalysisClipTransitionIn, type VideoAnalysisEntitySource, type VideoAnalysisResult, type VideoAnalysisShotAngle, type VideoAnalysisSpeedEffect, type VideoAnalysisTextKind, type VideoAnalysisTransition, type VideoAnalysisVisualEffect, type VideoCharacterRefProblem, type VideoCharacterReference, type VideoCharacterVoice, type VideoLinkGraphEdge, type VideoLinkGraphNode, type VideoLinkInputProblem, type VideoLinkNeed, type VideoLinkNodeFields, type VideoLinkPlatform, type VideoOutputCanvas, type VideoOverlayBox, type VideoOverlayCanvas, type VideoOverlayComposition, type VideoOverlayCorner, type VideoOverlayErrorCode, type VideoOverlayFit, type VideoOverlayGeometry, type VideoOverlayIssue, type VideoOverlayLayer, type VideoOverlayLayerInput, type VideoOverlayLayerSpec, type VideoOverlayNodeFields, type VideoOverlayOrderable, type VideoOverlayOutputAspect, type VideoOverlayPresetId, type VideoOverlayRect, type VideoOverlayRequest, type VideoOverlayValidation, type VideoOverlayValidationInput, type VideoOverlayWarning, type VideoOverlayWarningCode, type WindowAnalysis, type WindowScene, YOUTUBE_HOSTS, YOUTUBE_MAX_HEIGHT, analyzedSceneSchema, applyVideoOverlayPreset, aspectRatioFromDims, assembleVideoOverlayRequest, centreCropToAspect, characterReferencesFromWired, clearWiredVideoOverlayImageUrls, clipLookSchema, computeFrameFitPlan, deriveSlotRefs, detectVideoLinkPlatform, dropStaleVideoLinkFields, dropUnknownBindings, dropUnknownSpeakers, editPlanSourceDurationSec, entitySlotSchema, expandVideoOverlayLayer, expandVideoOverlayPresets, extractVideoDurationFromNode, formatVideoOverlayError, hasDrawableVideoOverlayBox, hasUrlParserHazard, hostnameMatchesAllowlist, inferMusicVideo, isDirectVideoFileUrl, isOversizedScene, isSocialVideoUrl, isVideoOverlayCorner, isVideoOverlayOutputAspect, isVideoOverlayPresetId, measuredCanvasCombinations, mergeClipLook, minimalRatioDimensions, normalizeVideoOverlayNodes, parseAspectToken, parseVideoOverlayLayerPlan, renderAnalyzedScene, resolveFrameDelivery, resolveFrameFitAspect, resolveOutputCanvas, resolveVideoLinkOutput, resolveVideoOverlayGeometry, rewriteSceneBindings, rewriteSlotTokens, rewriteSpeakerSlots, slotVariationSchema, stripDerivedAnalysisFields, toCustomVideoOverlayLayer, uiAspectRatioFill, uiDurationFill, uiResolutionFill, unwrapUnresolvedTokens, validateVideoOverlayRequest, videoAnalysisResultSchema, videoCharacterDistinctVoices, videoCharacterRefCap, videoCharacterRefProblem, videoCharacterRefProviders, videoCharacterRefUnits, videoCharacterVoiceCap, videoCharacterVoiceKey, videoCharacterVoiceProblem, videoLinkDownloadedFile, videoLinkInputProblem, videoLinkNeedOf, videoLinkNeedsDownload, videoLinkPageUrl, videoLinkRunNeeds, videoOverlayCanvas, videoOverlayCompositionKey, videoOverlayLayerLabel, videoOverlayPresetBox, videoOverlayRenderOrder, videoOverlaySlotOfHandle, videoOverlaySlotSources, windowAnalysisSchema };
2200
+ export { AUTO_DOWNLOAD_MAX_SEC, type AnalyzedScene, type AudioLayer, type ClipLook, DEFAULT_FRAME_DELIVERY, DEFAULT_FRAME_FIT, DEFAULT_VIDEO_OVERLAY_LAYER, DIRECT_VIDEO_EXTENSIONS, type EntitySlot, type EntitySlotOwner, type ExpandedVideoOverlayRequest, FRAME_DELIVERIES, FRAME_DELIVERY_BY_PROVIDER, FRAME_FITS, FRAME_FIT_STRETCH_TOLERANCE, type FrameDelivery, type FrameFit, type FrameFitPlan, INSTAGRAM_HOSTS, MAX_VIDEO_LINK_INPUT_CHARS, type PlacedVideoOverlayVideoInput, SLOT_TOKEN_RE, SOCIAL_VIDEO_HOSTS, type SlotVariation, VIDEO_ANALYSIS_AUDIO_MODES, VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN, VIDEO_ANALYSIS_DEFAULT_VARIATION, VIDEO_ANALYSIS_ENTITY_SOURCES, VIDEO_ANALYSIS_FACELESS_ANGLES, VIDEO_ANALYSIS_MAX_SCENE_SEC, VIDEO_ANALYSIS_MAX_VARIATIONS, VIDEO_ANALYSIS_SHOT_ANGLES, VIDEO_ANALYSIS_SPEED_EFFECTS, VIDEO_ANALYSIS_STORY_JUMPS, VIDEO_ANALYSIS_TEXT_KINDS, VIDEO_ANALYSIS_TIMES_OF_DAY, VIDEO_ANALYSIS_TRANSITIONS, VIDEO_ANALYSIS_VARIATION_SLUGS, VIDEO_ANALYSIS_VISUAL_EFFECTS, VIDEO_CHARACTER_DESCRIPTION_MAX, VIDEO_CHARACTER_EXTRA_IMAGES_MAX, VIDEO_CHARACTER_NAME_MAX, VIDEO_CHARACTER_REFS_WIRE_MAX, VIDEO_CHARACTER_VOICE_DESCRIPTION_MAX, VIDEO_CHARACTER_VOICE_EXAMPLE_MAX, VIDEO_LINK_AUDIO_CONSUMER_TYPES, VIDEO_LINK_DERIVED_FIELDS, VIDEO_LINK_TOLERANT_CONSUMER_TYPES, VIDEO_OUTPUT_CANVAS, VIDEO_OVERLAY_ANIMATION_MIN_SCALE, VIDEO_OVERLAY_ANIMATION_SEC, VIDEO_OVERLAY_ASPECT_BOUNDS, VIDEO_OVERLAY_BADGE_INSET, VIDEO_OVERLAY_BADGE_WIDTH, VIDEO_OVERLAY_BOUNDS, VIDEO_OVERLAY_BOX_FIELDS, VIDEO_OVERLAY_CORNERS, VIDEO_OVERLAY_DEFAULT_BACKGROUND, VIDEO_OVERLAY_ERROR_CODES, VIDEO_OVERLAY_FITS, VIDEO_OVERLAY_HANDLE_IDS, VIDEO_OVERLAY_LAYER_PLAN_HANDLE, VIDEO_OVERLAY_LAYOUT_IDS, VIDEO_OVERLAY_MAX_COMPOSITION_KEY_LENGTH, VIDEO_OVERLAY_MAX_LAYERS, VIDEO_OVERLAY_MAX_LAYER_VIDEO_BYTES, VIDEO_OVERLAY_MAX_TIME_SEC, VIDEO_OVERLAY_MAX_TOTAL_LAYER_BYTES, VIDEO_OVERLAY_MAX_VIDEO_LAYERS, VIDEO_OVERLAY_OUTPUT_ASPECTS, VIDEO_OVERLAY_PIP_INSET, VIDEO_OVERLAY_PIP_WIDTH, VIDEO_OVERLAY_PRESETS, VIDEO_OVERLAY_PRESET_IDS, VIDEO_OVERLAY_VIDEO_MAX_BASE_SEC, VIDEO_OVERLAY_VOLUME_BOUNDS, VIDEO_OVERLAY_WARNING_CODES, type VideoAnalysisAudioMode, type VideoAnalysisClipTransitionIn, type VideoAnalysisEntitySource, type VideoAnalysisResult, type VideoAnalysisShotAngle, type VideoAnalysisSpeedEffect, type VideoAnalysisTextKind, type VideoAnalysisTransition, type VideoAnalysisVisualEffect, type VideoCharacterRefProblem, type VideoCharacterReference, type VideoCharacterVoice, type VideoLinkGraphEdge, type VideoLinkGraphNode, type VideoLinkInputProblem, type VideoLinkNeed, type VideoLinkNodeFields, type VideoLinkPlatform, type VideoOutputCanvas, type VideoOverlayBaseBoxSpec, type VideoOverlayBox, type VideoOverlayBoxInput, type VideoOverlayCanvas, type VideoOverlayComposition, type VideoOverlayCorner, type VideoOverlayErrorCode, type VideoOverlayFit, type VideoOverlayGeometry, type VideoOverlayIssue, type VideoOverlayLayer, type VideoOverlayLayerInput, type VideoOverlayLayerSpec, type VideoOverlayLayoutFields, type VideoOverlayLayoutId, type VideoOverlayNodeFields, type VideoOverlayOrderable, type VideoOverlayOutputAspect, type VideoOverlayPlacedRect, type VideoOverlayPresetId, type VideoOverlayRect, type VideoOverlayRequest, type VideoOverlaySound, type VideoOverlayValidation, type VideoOverlayValidationInput, type VideoOverlayVideoPlacement, type VideoOverlayWarning, type VideoOverlayWarningCode, type VideoOverlayWireBeforeRun, type VideoOverlayWireMedium, type VideoOverlayWiredLayerKind, type VideoOverlayWiredSource, type WindowAnalysis, type WindowScene, YOUTUBE_HOSTS, YOUTUBE_MAX_HEIGHT, analyzedSceneSchema, applyVideoOverlayPreset, aspectRatioFromDims, assembleVideoOverlayRequest, centreCropToAspect, characterReferencesFromWired, clampVideoOverlayAspect, clearWiredVideoOverlayImageUrls, clipLookSchema, computeFrameFitPlan, declaredOutputMediaType, deriveSlotRefs, detectVideoLinkPlatform, dropStaleVideoLinkFields, dropUnknownBindings, dropUnknownSpeakers, editPlanSourceDurationSec, entitySlotSchema, evenVideoOverlayRect, expandVideoOverlayLayer, expandVideoOverlayLayout, expandVideoOverlayPresets, extractVideoDurationFromNode, firstVideoLayerIndex, formatVideoOverlayError, hasDrawableVideoOverlayBox, hasUrlParserHazard, hostnameMatchesAllowlist, inferMusicVideo, isDirectVideoFileUrl, isOversizedScene, isSocialVideoUrl, isVideoOverlayCorner, isVideoOverlayLayoutId, isVideoOverlayOutputAspect, isVideoOverlayPresetId, listColumnMediaType, measuredCanvasCombinations, mergeClipLook, minimalRatioDimensions, normalizeVideoOverlayNodes, parseAspectToken, parseVideoOverlayLayerPlan, placeVideoOverlayVideos, renderAnalyzedScene, resolveFrameDelivery, resolveFrameFitAspect, resolveOutputCanvas, resolveVideoLinkOutput, resolveVideoOverlayBaseRect, resolveVideoOverlayGeometry, resolveVideoOverlayStackRects, rewriteSceneBindings, rewriteSlotTokens, rewriteSpeakerSlots, slotVariationSchema, stripDerivedAnalysisFields, toCustomVideoOverlayLayer, uiAspectRatioFill, uiDurationFill, uiResolutionFill, unwrapUnresolvedTokens, validateVideoOverlayRequest, videoAnalysisResultSchema, videoCharacterDistinctVoices, videoCharacterRefCap, videoCharacterRefProblem, videoCharacterRefProviders, videoCharacterRefUnits, videoCharacterVoiceCap, videoCharacterVoiceKey, videoCharacterVoiceProblem, videoLinkDownloadedFile, videoLinkInputProblem, videoLinkNeedOf, videoLinkNeedsDownload, videoLinkPageUrl, videoLinkRunNeeds, videoOverlayCanvas, videoOverlayCompositionKey, videoOverlayHasVideoLayer, videoOverlayLayerLabel, videoOverlayLayoutNeedsAspect, videoOverlayLayoutNeedsVideoLayer, videoOverlayLayoutPlacesBase, videoOverlayPresetBox, videoOverlayRenderOrder, videoOverlaySlotOfHandle, videoOverlaySlotSources, videoOverlayWireMediumBeforeRun, videoOverlayWiredLayerKind, windowAnalysisSchema, withoutImpliedVideoOverlayAnimate };