@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.
- package/dist/{chunk-5Y42RIGY.cjs → chunk-2D5LQFV4.cjs} +18 -332
- package/dist/chunk-2D5LQFV4.cjs.map +1 -0
- package/dist/{chunk-5G23AJBU.cjs → chunk-2HZGDZZN.cjs} +6 -6
- package/dist/{chunk-5G23AJBU.cjs.map → chunk-2HZGDZZN.cjs.map} +1 -1
- package/dist/{chunk-DS2TOM32.js → chunk-2QKF7M2Z.js} +28 -4
- package/dist/chunk-2QKF7M2Z.js.map +1 -0
- package/dist/{chunk-CIOXUPCJ.cjs → chunk-2W745U4A.cjs} +228 -355
- package/dist/chunk-2W745U4A.cjs.map +1 -0
- package/dist/{chunk-LN3EVFRS.js → chunk-3OYO3XCC.js} +70 -6
- package/dist/chunk-3OYO3XCC.js.map +1 -0
- package/dist/{chunk-5HK5Z5OB.cjs → chunk-4ZEFP2FQ.cjs} +4 -4
- package/dist/{chunk-5HK5Z5OB.cjs.map → chunk-4ZEFP2FQ.cjs.map} +1 -1
- package/dist/{chunk-KOLC7AF2.js → chunk-5YYN5X57.js} +398 -38
- package/dist/chunk-5YYN5X57.js.map +1 -0
- package/dist/{chunk-RRPPXZ36.cjs → chunk-6CSXMWL4.cjs} +4 -4
- package/dist/{chunk-RRPPXZ36.cjs.map → chunk-6CSXMWL4.cjs.map} +1 -1
- package/dist/{chunk-M3SXUUWC.cjs → chunk-6FQBKI2A.cjs} +4 -11
- package/dist/chunk-6FQBKI2A.cjs.map +1 -0
- package/dist/{chunk-G4XWVWRI.js → chunk-6G7NN4S4.js} +5 -4
- package/dist/chunk-6G7NN4S4.js.map +1 -0
- package/dist/{chunk-HOKWJXHA.cjs → chunk-A2PX5IRC.cjs} +31 -4
- package/dist/chunk-A2PX5IRC.cjs.map +1 -0
- package/dist/{chunk-W4M7TNXG.cjs → chunk-AFYTX4AI.cjs} +52 -43
- package/dist/chunk-AFYTX4AI.cjs.map +1 -0
- package/dist/chunk-ALRXY4QH.cjs +13 -0
- package/dist/chunk-ALRXY4QH.cjs.map +1 -0
- package/dist/chunk-AOJ6B7K4.cjs +351 -0
- package/dist/chunk-AOJ6B7K4.cjs.map +1 -0
- package/dist/{chunk-KJZVQIN4.js → chunk-C7POAYFE.js} +3 -3
- package/dist/{chunk-KJZVQIN4.js.map → chunk-C7POAYFE.js.map} +1 -1
- package/dist/{chunk-6Q6SI7AG.js → chunk-CC4V2B7S.js} +3 -3
- package/dist/{chunk-6Q6SI7AG.js.map → chunk-CC4V2B7S.js.map} +1 -1
- package/dist/{chunk-GNPJ2JLE.cjs → chunk-CIPPPT7E.cjs} +6 -6
- package/dist/{chunk-GNPJ2JLE.cjs.map → chunk-CIPPPT7E.cjs.map} +1 -1
- package/dist/{chunk-6XVHYD5R.js → chunk-CLAKSLXF.js} +4 -9
- package/dist/chunk-CLAKSLXF.js.map +1 -0
- package/dist/chunk-CTANEPMY.js +61 -0
- package/dist/chunk-CTANEPMY.js.map +1 -0
- package/dist/{chunk-WGKAOUEQ.cjs → chunk-D34K455O.cjs} +3 -2
- package/dist/chunk-D34K455O.cjs.map +1 -0
- package/dist/chunk-E2HZTGYX.js +331 -0
- package/dist/chunk-E2HZTGYX.js.map +1 -0
- package/dist/{chunk-SKFJIFEV.cjs → chunk-G3KVK7OU.cjs} +21 -21
- package/dist/{chunk-SKFJIFEV.cjs.map → chunk-G3KVK7OU.cjs.map} +1 -1
- package/dist/chunk-G4U3HW6W.js +453 -0
- package/dist/chunk-G4U3HW6W.js.map +1 -0
- package/dist/{chunk-EN2YI5TV.js → chunk-GSFB537T.js} +3 -3
- package/dist/{chunk-EN2YI5TV.js.map → chunk-GSFB537T.js.map} +1 -1
- package/dist/chunk-HRY7KGAE.cjs +506 -0
- package/dist/chunk-HRY7KGAE.cjs.map +1 -0
- package/dist/{chunk-6AJOTEVC.js → chunk-I2RQB7VG.js} +3 -3
- package/dist/{chunk-6AJOTEVC.js.map → chunk-I2RQB7VG.js.map} +1 -1
- package/dist/chunk-IDTKF5EX.cjs +48 -0
- package/dist/chunk-IDTKF5EX.cjs.map +1 -0
- package/dist/{chunk-DQIJPDHC.cjs → chunk-IWWVPR3W.cjs} +88 -11
- package/dist/chunk-IWWVPR3W.cjs.map +1 -0
- package/dist/{chunk-URLDVK67.js → chunk-JJNNM23P.js} +3 -3
- package/dist/{chunk-URLDVK67.js.map → chunk-JJNNM23P.js.map} +1 -1
- package/dist/{chunk-YHVEZVAO.js → chunk-JZGZ26YB.js} +6 -306
- package/dist/chunk-JZGZ26YB.js.map +1 -0
- package/dist/{chunk-XROE3CAS.cjs → chunk-KHH54GRP.cjs} +120 -79
- package/dist/chunk-KHH54GRP.cjs.map +1 -0
- package/dist/{chunk-AXT7YNOR.cjs → chunk-KJSRPHJ2.cjs} +48 -47
- package/dist/chunk-KJSRPHJ2.cjs.map +1 -0
- package/dist/{chunk-FVVD6XY2.js → chunk-KL6GAYTT.js} +13 -4
- package/dist/chunk-KL6GAYTT.js.map +1 -0
- package/dist/{chunk-AFQFGZN7.cjs → chunk-KYMHFVAZ.cjs} +8 -6
- package/dist/chunk-KYMHFVAZ.cjs.map +1 -0
- package/dist/{chunk-A6HRY3WF.cjs → chunk-MYJQELFN.cjs} +420 -37
- package/dist/chunk-MYJQELFN.cjs.map +1 -0
- package/dist/chunk-N5HH46JF.cjs +68 -0
- package/dist/chunk-N5HH46JF.cjs.map +1 -0
- package/dist/{chunk-BXNPO3PL.cjs → chunk-N7OUQK7E.cjs} +8 -8
- package/dist/{chunk-BXNPO3PL.cjs.map → chunk-N7OUQK7E.cjs.map} +1 -1
- package/dist/{chunk-JKZVRKN3.js → chunk-NGKKNSK6.js} +31 -8
- package/dist/chunk-NGKKNSK6.js.map +1 -0
- package/dist/{chunk-SWVGHAYO.js → chunk-O7RZRUMZ.js} +110 -74
- package/dist/chunk-O7RZRUMZ.js.map +1 -0
- package/dist/{chunk-SCYBGTX6.js → chunk-PTD6EDUU.js} +3 -3
- package/dist/{chunk-SCYBGTX6.js.map → chunk-PTD6EDUU.js.map} +1 -1
- package/dist/{chunk-BDXXOEBZ.cjs → chunk-QWYFHQYK.cjs} +79 -54
- package/dist/chunk-QWYFHQYK.cjs.map +1 -0
- package/dist/{chunk-VB2ARGQ6.js → chunk-RGNHHIMN.js} +3 -3
- package/dist/chunk-RGNHHIMN.js.map +1 -0
- package/dist/{chunk-AZGONXWV.js → chunk-S24ZBUB4.js} +194 -299
- package/dist/chunk-S24ZBUB4.js.map +1 -0
- package/dist/{chunk-IV6IDECY.js → chunk-S5TMRJMX.js} +4 -4
- package/dist/{chunk-IV6IDECY.js.map → chunk-S5TMRJMX.js.map} +1 -1
- package/dist/chunk-SMOO5FAH.js +10 -0
- package/dist/chunk-SMOO5FAH.js.map +1 -0
- package/dist/{chunk-HYBACFYW.js → chunk-SYWR5G3T.js} +16 -7
- package/dist/chunk-SYWR5G3T.js.map +1 -0
- package/dist/{chunk-GWBQ3GPO.cjs → chunk-TRVWMKNE.cjs} +343 -53
- package/dist/chunk-TRVWMKNE.cjs.map +1 -0
- package/dist/{chunk-G6GMY5BC.js → chunk-UDDVDQMF.js} +298 -36
- package/dist/chunk-UDDVDQMF.js.map +1 -0
- package/dist/{chunk-PONP5J5E.cjs → chunk-V24EPI5N.cjs} +13 -3
- package/dist/chunk-V24EPI5N.cjs.map +1 -0
- package/dist/{chunk-HDHLZK7C.cjs → chunk-VACPZPUA.cjs} +5 -5
- package/dist/{chunk-HDHLZK7C.cjs.map → chunk-VACPZPUA.cjs.map} +1 -1
- package/dist/{chunk-ICDLYU4I.js → chunk-Y6X7UJSD.js} +10 -9
- package/dist/chunk-Y6X7UJSD.js.map +1 -0
- package/dist/chunk-YCXRSWCQ.js +42 -0
- package/dist/chunk-YCXRSWCQ.js.map +1 -0
- package/dist/entries/apps.cjs +44 -44
- package/dist/entries/apps.js +9 -9
- package/dist/entries/credits.cjs +217 -152
- package/dist/entries/credits.d.cts +112 -6
- package/dist/entries/credits.d.ts +112 -6
- package/dist/entries/credits.js +13 -8
- package/dist/entries/entities.cjs +188 -143
- package/dist/entries/entities.d.cts +122 -1
- package/dist/entries/entities.d.ts +122 -1
- package/dist/entries/entities.js +2 -1
- package/dist/entries/llm-models.d.cts +2 -1
- package/dist/entries/llm-models.d.ts +2 -1
- package/dist/entries/media.cjs +92 -87
- package/dist/entries/media.d.cts +11 -1
- package/dist/entries/media.d.ts +11 -1
- package/dist/entries/media.js +3 -2
- package/dist/entries/model-catalog.cjs +207 -99
- package/dist/entries/model-catalog.d.cts +90 -4
- package/dist/entries/model-catalog.d.ts +90 -4
- package/dist/entries/model-catalog.js +5 -5
- package/dist/entries/models.cjs +407 -294
- package/dist/entries/models.d.cts +4 -3
- package/dist/entries/models.d.ts +4 -3
- package/dist/entries/models.js +6 -5
- package/dist/entries/nodes.cjs +241 -233
- package/dist/entries/nodes.d.cts +15 -2
- package/dist/entries/nodes.d.ts +15 -2
- package/dist/entries/nodes.js +10 -10
- package/dist/entries/pipeline.cjs +152 -152
- package/dist/entries/pipeline.d.cts +2 -1
- package/dist/entries/pipeline.d.ts +2 -1
- package/dist/entries/pipeline.js +3 -3
- package/dist/entries/ugc.cjs +71 -71
- package/dist/entries/ugc.js +4 -4
- package/dist/entries/video.cjs +308 -204
- package/dist/entries/video.d.cts +480 -98
- package/dist/entries/video.d.ts +480 -98
- package/dist/entries/video.js +8 -4
- package/dist/entries/workflow.cjs +111 -99
- package/dist/entries/workflow.d.cts +29 -2
- package/dist/entries/workflow.d.ts +29 -2
- package/dist/entries/workflow.js +2 -2
- package/dist/{gpt-image-2-6-BeZdT-pW.d.cts → gpt-image-2-6-jIRQBRag.d.cts} +6 -0
- package/dist/{gpt-image-2-6-BeZdT-pW.d.ts → gpt-image-2-6-jIRQBRag.d.ts} +6 -0
- package/dist/index.cjs +2321 -1870
- package/dist/index.d.cts +10 -10
- package/dist/index.d.ts +10 -10
- package/dist/index.js +26 -23
- package/dist/{model-catalog-D6Es7VG-.d.cts → model-catalog-CCEcv08q.d.cts} +179 -14
- package/dist/{model-catalog-D6Es7VG-.d.ts → model-catalog-CCEcv08q.d.ts} +179 -14
- package/dist/{model-constants-22k3fjp1.d.cts → model-constants-B88p6XR0.d.ts} +305 -20
- package/dist/{model-constants-22k3fjp1.d.ts → model-constants-Cf3zaITt.d.cts} +305 -20
- package/package.json +1 -1
- package/src/__tests__/extend-providers.test.ts +114 -0
- package/src/__tests__/fixtures/mask-composite-quote-parity.json +118 -0
- package/src/__tests__/fixtures/root-exports.baseline.json +68 -0
- package/src/__tests__/gpt-image-2-6-formats.test.ts +4 -1
- package/src/__tests__/gpt-image-2-6.test.ts +7 -0
- package/src/__tests__/grok-video-15-catalog.test.ts +189 -0
- package/src/__tests__/gvp-supported-providers.test.ts +5 -2
- package/src/__tests__/image-mask-mode.test.ts +34 -1
- package/src/__tests__/mask-edit-follows-source.test.ts +150 -0
- package/src/__tests__/minimax-h3-image.test.ts +140 -0
- package/src/__tests__/model-makers.test.ts +49 -11
- package/src/__tests__/model-tree.test.ts +13 -0
- package/src/__tests__/retired-video-provider.test.ts +15 -5
- package/src/__tests__/seedance-25-catalog-modes.test.ts +1 -1
- package/src/__tests__/seedance-task-type.test.ts +178 -0
- package/src/__tests__/seedream-5-5.test.ts +117 -0
- package/src/__tests__/unit-contract-compose.test.ts +27 -1
- package/src/__tests__/unit-contracts.test.ts +20 -6
- package/src/__tests__/upscale-factors.test.ts +107 -0
- package/src/__tests__/video-character-refs.test.ts +20 -2
- package/src/__tests__/video-collapse-parity.test.ts +19 -0
- package/src/__tests__/video-overlay-geometry.test.ts +68 -0
- package/src/__tests__/video-overlay-layer-plan.test.ts +3 -4
- package/src/__tests__/video-overlay-layouts.test.ts +529 -0
- package/src/__tests__/video-overlay-pricing.test.ts +61 -0
- package/src/__tests__/video-overlay-validate.test.ts +128 -0
- package/src/__tests__/video-overlay-wired-kind.test.ts +207 -0
- package/src/__tests__/video-overlay.test.ts +280 -194
- package/src/__tests__/video-ref-limits.test.ts +2 -1
- package/src/__tests__/video-reference-only.test.ts +6 -2
- package/src/__tests__/video-start-frame-only.test.ts +98 -0
- package/src/__tests__/wired-character-names.test.ts +220 -0
- package/src/credit-estimators/index.ts +8 -0
- package/src/credit-estimators/video-overlay.ts +70 -0
- package/src/credit-identifiers.ts +102 -5
- package/src/entity-image-url.ts +21 -0
- package/src/entries/credits.ts +14 -0
- package/src/entries/entities.ts +14 -0
- package/src/entries/model-catalog.ts +39 -1
- package/src/entries/models.ts +34 -0
- package/src/entries/nodes.ts +2 -0
- package/src/entries/video.ts +6 -0
- package/src/entries/workflow.ts +1 -0
- package/src/generated/unit-contracts.ts +8 -1
- package/src/gpt-image-2-6.ts +6 -0
- package/src/input-image-pricing.ts +76 -0
- package/src/mask-composite.ts +11 -0
- package/src/minimax-h3-image.ts +61 -0
- package/src/model-catalog.ts +512 -48
- package/src/model-constants.ts +602 -34
- package/src/node-default-mappings.ts +12 -2
- package/src/node-execution-state.ts +4 -1
- package/src/producer-types.ts +23 -1
- package/src/seedance-task-type.ts +37 -0
- package/src/seedream-5-5.ts +45 -0
- package/src/unit-contract-compose.ts +4 -1
- package/src/upscale-factors.ts +111 -0
- package/src/video-character-refs.ts +7 -4
- package/src/video-overlay-geometry.ts +99 -0
- package/src/video-overlay-input.ts +25 -0
- package/src/video-overlay-layout-ids.ts +48 -0
- package/src/video-overlay-layouts.ts +315 -0
- package/src/video-overlay-validate.ts +223 -0
- package/src/video-overlay-video-layers.ts +304 -0
- package/src/video-overlay.ts +165 -297
- package/src/video-ui-defaults.ts +8 -6
- package/src/wired-character-names.ts +202 -0
- package/src/wired-image-size.ts +55 -0
- package/dist/chunk-5Y42RIGY.cjs.map +0 -1
- package/dist/chunk-6XVHYD5R.js.map +0 -1
- package/dist/chunk-A6HRY3WF.cjs.map +0 -1
- package/dist/chunk-AFQFGZN7.cjs.map +0 -1
- package/dist/chunk-AXT7YNOR.cjs.map +0 -1
- package/dist/chunk-AZGONXWV.js.map +0 -1
- package/dist/chunk-BDXXOEBZ.cjs.map +0 -1
- package/dist/chunk-CIOXUPCJ.cjs.map +0 -1
- package/dist/chunk-DQIJPDHC.cjs.map +0 -1
- package/dist/chunk-DS2TOM32.js.map +0 -1
- package/dist/chunk-FVVD6XY2.js.map +0 -1
- package/dist/chunk-G4XWVWRI.js.map +0 -1
- package/dist/chunk-G6GMY5BC.js.map +0 -1
- package/dist/chunk-G7ZYZQKO.cjs +0 -27
- package/dist/chunk-G7ZYZQKO.cjs.map +0 -1
- package/dist/chunk-GWBQ3GPO.cjs.map +0 -1
- package/dist/chunk-HNEF2N5C.cjs +0 -19
- package/dist/chunk-HNEF2N5C.cjs.map +0 -1
- package/dist/chunk-HOKWJXHA.cjs.map +0 -1
- package/dist/chunk-HYBACFYW.js.map +0 -1
- package/dist/chunk-ICDLYU4I.js.map +0 -1
- package/dist/chunk-JKZVRKN3.js.map +0 -1
- package/dist/chunk-KOLC7AF2.js.map +0 -1
- package/dist/chunk-LN3EVFRS.js.map +0 -1
- package/dist/chunk-M3SXUUWC.cjs.map +0 -1
- package/dist/chunk-MHY47BLL.js +0 -23
- package/dist/chunk-MHY47BLL.js.map +0 -1
- package/dist/chunk-PONP5J5E.cjs.map +0 -1
- package/dist/chunk-SWVGHAYO.js.map +0 -1
- package/dist/chunk-VB2ARGQ6.js.map +0 -1
- package/dist/chunk-VYQ25YQF.js +0 -17
- package/dist/chunk-VYQ25YQF.js.map +0 -1
- package/dist/chunk-W4M7TNXG.cjs.map +0 -1
- package/dist/chunk-WGKAOUEQ.cjs.map +0 -1
- package/dist/chunk-XROE3CAS.cjs.map +0 -1
- package/dist/chunk-YHVEZVAO.js.map +0 -1
package/dist/entries/video.d.cts
CHANGED
|
@@ -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 —
|
|
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
|
|
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
|
|
404
|
-
* engine entry. It returns a CODE, never
|
|
405
|
-
* renders the route / worker text, the
|
|
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
|
-
/**
|
|
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
|
|
575
|
-
*
|
|
576
|
-
*
|
|
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
|
|
587
|
-
* (`wiredSlots`: 1-based)
|
|
588
|
-
* is
|
|
589
|
-
*
|
|
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
|
|
714
|
-
*
|
|
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
|
-
|
|
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
|
-
*
|
|
740
|
-
*
|
|
741
|
-
*
|
|
742
|
-
*
|
|
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
|
|
756
|
-
*
|
|
757
|
-
*
|
|
758
|
-
*
|
|
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
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
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
|
-
*
|
|
770
|
-
*
|
|
771
|
-
*
|
|
772
|
-
*
|
|
773
|
-
*
|
|
774
|
-
*
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
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
|
-
*
|
|
790
|
-
*
|
|
791
|
-
*
|
|
792
|
-
*
|
|
793
|
-
*
|
|
794
|
-
|
|
795
|
-
|
|
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
|
-
*
|
|
798
|
-
*
|
|
799
|
-
*
|
|
800
|
-
*
|
|
801
|
-
*
|
|
802
|
-
*
|
|
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
|
-
|
|
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 };
|