@nodaro/shared 3.52.1 → 3.54.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-6CVY3345.js → chunk-25KAGSPT.js} +3 -3
- package/dist/{chunk-6CVY3345.js.map → chunk-25KAGSPT.js.map} +1 -1
- package/dist/{chunk-FBLMWA2R.cjs → chunk-2OYV6K7D.cjs} +4 -4
- package/dist/{chunk-FBLMWA2R.cjs.map → chunk-2OYV6K7D.cjs.map} +1 -1
- package/dist/{chunk-J3HPEKGJ.cjs → chunk-2R74OU76.cjs} +23 -23
- package/dist/chunk-2R74OU76.cjs.map +1 -0
- package/dist/{chunk-CSPELPDB.cjs → chunk-3633VD2M.cjs} +8 -8
- package/dist/{chunk-CSPELPDB.cjs.map → chunk-3633VD2M.cjs.map} +1 -1
- package/dist/{chunk-A24LLEXS.js → chunk-3CHOZ573.js} +23 -23
- package/dist/chunk-3CHOZ573.js.map +1 -0
- package/dist/{chunk-IJ6XNHSD.cjs → chunk-3GMTGX3D.cjs} +27 -27
- package/dist/{chunk-IJ6XNHSD.cjs.map → chunk-3GMTGX3D.cjs.map} +1 -1
- package/dist/{chunk-AJFQ5242.js → chunk-5DVDHL7Y.js} +5 -5
- package/dist/{chunk-AJFQ5242.js.map → chunk-5DVDHL7Y.js.map} +1 -1
- package/dist/{chunk-VNHX6TQT.cjs → chunk-5R6LTKE5.cjs} +5 -5
- package/dist/{chunk-VNHX6TQT.cjs.map → chunk-5R6LTKE5.cjs.map} +1 -1
- package/dist/{chunk-YOH5AUYL.js → chunk-6UR5UE5G.js} +9 -9
- package/dist/{chunk-YOH5AUYL.js.map → chunk-6UR5UE5G.js.map} +1 -1
- package/dist/{chunk-3RYKIUAE.js → chunk-6XVHYD5R.js} +12 -8
- package/dist/chunk-6XVHYD5R.js.map +1 -0
- package/dist/{chunk-FRXVOYL2.js → chunk-ADWIAQQS.js} +3 -3
- package/dist/{chunk-FRXVOYL2.js.map → chunk-ADWIAQQS.js.map} +1 -1
- package/dist/{chunk-VLNOQJDO.cjs → chunk-AGTCHDG5.cjs} +6 -6
- package/dist/{chunk-VLNOQJDO.cjs.map → chunk-AGTCHDG5.cjs.map} +1 -1
- package/dist/{chunk-MI63SSCJ.cjs → chunk-ATWLKUAI.cjs} +4 -4
- package/dist/{chunk-MI63SSCJ.cjs.map → chunk-ATWLKUAI.cjs.map} +1 -1
- package/dist/{chunk-FIROF3TM.js → chunk-C5S75476.js} +5 -5
- package/dist/{chunk-FIROF3TM.js.map → chunk-C5S75476.js.map} +1 -1
- package/dist/{chunk-7HWXJIQ6.cjs → chunk-C6IQCKJT.cjs} +4 -4
- package/dist/{chunk-7HWXJIQ6.cjs.map → chunk-C6IQCKJT.cjs.map} +1 -1
- package/dist/{chunk-K3QNGRRX.js → chunk-CZCOL3M5.js} +10 -6
- package/dist/chunk-CZCOL3M5.js.map +1 -0
- package/dist/{chunk-JAGYUDOK.js → chunk-DUL5ZLTJ.js} +3 -3
- package/dist/{chunk-JAGYUDOK.js.map → chunk-DUL5ZLTJ.js.map} +1 -1
- package/dist/{chunk-BG5272F5.js → chunk-E4YES25K.js} +4 -4
- package/dist/{chunk-BG5272F5.js.map → chunk-E4YES25K.js.map} +1 -1
- package/dist/{chunk-QBXC3AXS.cjs → chunk-FIYVKW7F.cjs} +12 -12
- package/dist/{chunk-QBXC3AXS.cjs.map → chunk-FIYVKW7F.cjs.map} +1 -1
- package/dist/{chunk-CQJYKSXF.js → chunk-FVVD6XY2.js} +5 -3
- package/dist/chunk-FVVD6XY2.js.map +1 -0
- package/dist/chunk-HD45Y7QU.cjs +27 -0
- package/dist/{chunk-H7HKLN2W.cjs.map → chunk-HD45Y7QU.cjs.map} +1 -1
- package/dist/{chunk-JAD2SBD4.js → chunk-HEF4BIMA.js} +4 -4
- package/dist/{chunk-JAD2SBD4.js.map → chunk-HEF4BIMA.js.map} +1 -1
- package/dist/{chunk-GL5Z3CC4.js → chunk-HG3KKCJJ.js} +3 -3
- package/dist/{chunk-GL5Z3CC4.js.map → chunk-HG3KKCJJ.js.map} +1 -1
- package/dist/{chunk-MI6CZQCG.cjs → chunk-IPCWYKX5.cjs} +45 -45
- package/dist/{chunk-MI6CZQCG.cjs.map → chunk-IPCWYKX5.cjs.map} +1 -1
- package/dist/{chunk-7YFQKR5C.cjs → chunk-KM35K2M5.cjs} +21 -21
- package/dist/{chunk-7YFQKR5C.cjs.map → chunk-KM35K2M5.cjs.map} +1 -1
- package/dist/{chunk-OWVWV4T2.js → chunk-KMSEU6FK.js} +3 -3
- package/dist/{chunk-OWVWV4T2.js.map → chunk-KMSEU6FK.js.map} +1 -1
- package/dist/{chunk-2LNQ2MDO.js → chunk-LYWJAXPT.js} +3 -3
- package/dist/{chunk-2LNQ2MDO.js.map → chunk-LYWJAXPT.js.map} +1 -1
- package/dist/{chunk-6DAWSVX2.cjs → chunk-M3SXUUWC.cjs} +13 -7
- package/dist/chunk-M3SXUUWC.cjs.map +1 -0
- package/dist/{chunk-JZJRD7RG.js → chunk-MGJR5OXO.js} +5 -5
- package/dist/{chunk-JZJRD7RG.js.map → chunk-MGJR5OXO.js.map} +1 -1
- package/dist/{chunk-AVUW7XKP.cjs → chunk-MTUNORQB.cjs} +11 -11
- package/dist/{chunk-AVUW7XKP.cjs.map → chunk-MTUNORQB.cjs.map} +1 -1
- package/dist/{chunk-6LCZPDIF.js → chunk-N3WL6IOJ.js} +3 -3
- package/dist/{chunk-6LCZPDIF.js.map → chunk-N3WL6IOJ.js.map} +1 -1
- package/dist/{chunk-XRXPWW7P.cjs → chunk-ND3IE3IB.cjs} +47 -47
- package/dist/{chunk-XRXPWW7P.cjs.map → chunk-ND3IE3IB.cjs.map} +1 -1
- package/dist/{chunk-34EXMNOX.cjs → chunk-NEIWY6CC.cjs} +6 -6
- package/dist/{chunk-34EXMNOX.cjs.map → chunk-NEIWY6CC.cjs.map} +1 -1
- package/dist/{chunk-AJPV3RZJ.js → chunk-NMX6HQC3.js} +5 -5
- package/dist/{chunk-AJPV3RZJ.js.map → chunk-NMX6HQC3.js.map} +1 -1
- package/dist/{chunk-66GADQRV.cjs → chunk-OVIIJVXH.cjs} +21 -21
- package/dist/{chunk-66GADQRV.cjs.map → chunk-OVIIJVXH.cjs.map} +1 -1
- package/dist/{chunk-5PCI6M44.cjs → chunk-PONP5J5E.cjs} +5 -3
- package/dist/chunk-PONP5J5E.cjs.map +1 -0
- package/dist/{chunk-ETU6NWE2.cjs → chunk-QP5JLSCJ.cjs} +10 -6
- package/dist/chunk-QP5JLSCJ.cjs.map +1 -0
- package/dist/{chunk-SRLWSI6Q.cjs → chunk-SEEQ3H22.cjs} +5 -5
- package/dist/{chunk-SRLWSI6Q.cjs.map → chunk-SEEQ3H22.cjs.map} +1 -1
- package/dist/{chunk-25OWMP6B.cjs → chunk-SZUDEFX2.cjs} +41 -41
- package/dist/{chunk-25OWMP6B.cjs.map → chunk-SZUDEFX2.cjs.map} +1 -1
- package/dist/{chunk-TRZMLQSL.js → chunk-YBZQXZ6A.js} +3 -3
- package/dist/{chunk-TRZMLQSL.js.map → chunk-YBZQXZ6A.js.map} +1 -1
- package/dist/{chunk-WBPJNXYN.js → chunk-ZKHQSG76.js} +4 -4
- package/dist/{chunk-WBPJNXYN.js.map → chunk-ZKHQSG76.js.map} +1 -1
- package/dist/{chunk-VSNQLSME.js → chunk-ZWB3NG4M.js} +3 -3
- package/dist/{chunk-VSNQLSME.js.map → chunk-ZWB3NG4M.js.map} +1 -1
- package/dist/entries/apps.cjs +43 -43
- package/dist/entries/apps.js +8 -8
- package/dist/entries/credits.cjs +150 -150
- package/dist/entries/credits.js +7 -7
- package/dist/entries/media.cjs +81 -73
- package/dist/entries/media.d.cts +60 -80
- package/dist/entries/media.d.ts +60 -80
- package/dist/entries/media.js +2 -2
- package/dist/entries/model-catalog.cjs +66 -66
- package/dist/entries/model-catalog.js +4 -4
- package/dist/entries/models.cjs +277 -277
- package/dist/entries/models.js +5 -5
- package/dist/entries/nodes.cjs +207 -207
- package/dist/entries/nodes.js +9 -9
- package/dist/entries/pipeline.cjs +149 -149
- package/dist/entries/pipeline.js +3 -3
- package/dist/entries/types.d.cts +13 -0
- package/dist/entries/types.d.ts +13 -0
- package/dist/entries/ugc.cjs +71 -71
- package/dist/entries/ugc.js +4 -4
- package/dist/entries/video.cjs +117 -117
- package/dist/entries/video.js +4 -4
- package/dist/entries/workflow.cjs +99 -99
- package/dist/entries/workflow.js +2 -2
- package/dist/index.cjs +1233 -1225
- package/dist/index.d.cts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +21 -21
- package/package.json +1 -1
- package/src/__tests__/priced-clip-seconds.test.ts +193 -0
- package/src/__tests__/video-depth.test.ts +61 -19
- package/src/__tests__/video-face-mesh.test.ts +3 -2
- package/src/__tests__/video-mask.test.ts +1 -1
- package/src/catalog-projection.ts +13 -0
- package/src/entries/media.ts +1 -0
- package/src/generated/unit-contracts.ts +1 -0
- package/src/i18n/style.ar.ts +5 -0
- package/src/i18n/style.de.ts +5 -0
- package/src/i18n/style.es.ts +5 -0
- package/src/i18n/style.fr.ts +5 -0
- package/src/i18n/style.he.ts +5 -0
- package/src/i18n/style.hi.ts +5 -0
- package/src/i18n/style.ja.ts +5 -0
- package/src/i18n/style.ko.ts +5 -0
- package/src/i18n/style.pt-BR.ts +5 -0
- package/src/i18n/style.ru.ts +5 -0
- package/src/i18n/style.zh-CN.ts +5 -0
- package/src/mask-composite.ts +6 -5
- package/src/model-catalog.ts +21 -21
- package/src/priced-clip-seconds.ts +28 -0
- package/src/video-depth.ts +25 -12
- package/src/video-face-mesh.ts +10 -4
- package/src/video-mask.ts +12 -7
- package/dist/chunk-3RYKIUAE.js.map +0 -1
- package/dist/chunk-5PCI6M44.cjs.map +0 -1
- package/dist/chunk-6DAWSVX2.cjs.map +0 -1
- package/dist/chunk-A24LLEXS.js.map +0 -1
- package/dist/chunk-CQJYKSXF.js.map +0 -1
- package/dist/chunk-ETU6NWE2.cjs.map +0 -1
- package/dist/chunk-H7HKLN2W.cjs +0 -27
- package/dist/chunk-J3HPEKGJ.cjs.map +0 -1
- package/dist/chunk-K3QNGRRX.js.map +0 -1
package/dist/entries/media.d.cts
CHANGED
|
@@ -63,6 +63,24 @@ declare function describeMaskRegion(box: PixelBox, image: {
|
|
|
63
63
|
height: number;
|
|
64
64
|
}): MaskRegionDescriptor;
|
|
65
65
|
|
|
66
|
+
/**
|
|
67
|
+
* The whole seconds a clip is PRICED at by Video Depth (both providers), Video
|
|
68
|
+
* Mask, Mask Composite and the face mesh: its length rounded up, after ignoring
|
|
69
|
+
* up to {@link CLIP_PRICE_GRACE_SEC} past a whole second.
|
|
70
|
+
*
|
|
71
|
+
* A whole-second cut of a 29.97 or 23.976 fps clip can come out a little long:
|
|
72
|
+
* 12 s is 360 frames, a 12.012 s file. A quote reads the cut, a run measures the
|
|
73
|
+
* file, and both land on the same row through this one rule, wherever those steps
|
|
74
|
+
* are reserved, charged or quoted.
|
|
75
|
+
*
|
|
76
|
+
* It decides the price only. Each step's limits (the 300 s cap, the frame cap)
|
|
77
|
+
* read the clip's real length. Other models round as they always have.
|
|
78
|
+
*/
|
|
79
|
+
/** How far past a whole second a clip is still priced as that second. */
|
|
80
|
+
declare const CLIP_PRICE_GRACE_SEC = 0.05;
|
|
81
|
+
/** At least one second. The caller has checked that `sec` is a real length. */
|
|
82
|
+
declare function pricedClipSeconds(sec: number): number;
|
|
83
|
+
|
|
66
84
|
/**
|
|
67
85
|
* Video Depth — the one contract every layer reads: which providers exist and
|
|
68
86
|
* which lane serves each, which optional levers a provider honours, how long a
|
|
@@ -74,9 +92,11 @@ declare function describeMaskRegion(box: PixelBox, image: {
|
|
|
74
92
|
* produces from the inferno output (`videoDepthNeedsGrayscalePass`).
|
|
75
93
|
*
|
|
76
94
|
* Price rows are `model_pricing` rows (`<provider>:<n>s`); the credit amounts
|
|
77
|
-
* live there, never here.
|
|
95
|
+
* live there, never here. Both providers have one row per whole second of the
|
|
96
|
+
* clip, up to the longest clip each accepts. Worked examples (repeated in
|
|
78
97
|
* docs/nodes/processing-video/video-depth.md):
|
|
79
|
-
*
|
|
98
|
+
* video-depth-anything: 0.4 s → `:1s`, 9 s → `:9s`, 9.2 s → `:10s`, 15.015 s → `:15s`, 15.06 s → `:16s`.
|
|
99
|
+
* depth-anything-frames: 0.4 s → `:1s`, 4 s → `:4s`, 4.1 s → `:5s`, 15.015 s → `:15s`, 15.06 s → `:16s`, 80 s → `:80s`.
|
|
80
100
|
*/
|
|
81
101
|
declare const VIDEO_DEPTH_PROVIDERS: readonly ["video-depth-anything", "depth-anything-frames"];
|
|
82
102
|
type VideoDepthProvider = (typeof VIDEO_DEPTH_PROVIDERS)[number];
|
|
@@ -109,7 +129,7 @@ declare function videoDepthNeedsGrayscalePass(provider: string, colormap: VideoD
|
|
|
109
129
|
declare const VIDEO_DEPTH_LIMITS: {
|
|
110
130
|
/** fal `max_frames` ceiling. */
|
|
111
131
|
readonly FAL_MAX_FRAMES: 2400;
|
|
112
|
-
/** Longest clip the fal lane accepts, whatever its frame rate:
|
|
132
|
+
/** Longest clip the fal lane accepts, whatever its frame rate: its top price row, `:300s` (a low-fps clip under the frame limit can otherwise run past every price row). */
|
|
113
133
|
readonly FAL_MAX_SECONDS: 300;
|
|
114
134
|
/** Frame rate assumed when the clip reports none (variable-rate or missing). */
|
|
115
135
|
readonly ASSUMED_FPS: 30;
|
|
@@ -126,13 +146,25 @@ declare function checkVideoDepthLength(provider: string, probe: {
|
|
|
126
146
|
ok: false;
|
|
127
147
|
message: string;
|
|
128
148
|
};
|
|
149
|
+
/**
|
|
150
|
+
* The length buckets, in seconds, both providers were priced in before their
|
|
151
|
+
* per-second rows. A row is no longer picked from these: a clip's whole seconds
|
|
152
|
+
* name its row, so a `:15s` is the 15-second row and a `:120s` on Depth Anything
|
|
153
|
+
* per frame is past its limit. Each per-second row took its admin switches from
|
|
154
|
+
* the bucket that priced it (migrations 590 and 595).
|
|
155
|
+
*/
|
|
129
156
|
declare const VIDEO_DEPTH_BUCKETS: readonly [15, 30, 60, 120, 300];
|
|
130
157
|
/**
|
|
131
|
-
* The price row for a clip of `durationSec`.
|
|
132
|
-
*
|
|
133
|
-
*
|
|
134
|
-
*
|
|
135
|
-
*
|
|
158
|
+
* The price row for a clip of `durationSec`.
|
|
159
|
+
*
|
|
160
|
+
* One row per whole second of the clip on both lanes: the clip's length rounded
|
|
161
|
+
* UP (`pricedClipSeconds`: up to 0.05 s past a whole second is ignored first), so
|
|
162
|
+
* a clip under one second is priced as one. `video-depth-anything:1s` … `:300s`
|
|
163
|
+
* (decided 2026-11-03), `depth-anything-frames:1s` … `:80s` (decided 2026-11-04).
|
|
164
|
+
*
|
|
165
|
+
* Unknown, non-positive or longer than the provider accepts → the provider's
|
|
166
|
+
* longest clip (fal `:300s`, Replicate `:80s`), its highest REACHABLE row — the
|
|
167
|
+
* most a run on it can be charged, never a row a run could not reach.
|
|
136
168
|
*/
|
|
137
169
|
declare function videoDepthCreditId(provider: string, durationSec: number | null | undefined): string;
|
|
138
170
|
|
|
@@ -294,24 +326,6 @@ declare const AUDIO_FX_PRESET_LABELS: Record<AudioFxPreset, string>;
|
|
|
294
326
|
/** Presets that apply convolution reverb (afir + inline-synth IR). */
|
|
295
327
|
declare const AUDIO_FX_REVERB_PRESETS: ReadonlySet<AudioFxPreset>;
|
|
296
328
|
|
|
297
|
-
/**
|
|
298
|
-
* Video Mask — text-prompted video segmentation (SAM 3.1 / SAM 3). The wire contract of
|
|
299
|
-
* the `video-mask` node, `POST /v1/video-mask`, the `video_mask` MCP verb,
|
|
300
|
-
* `client.media.videoMask` and `nodaro media video-mask`, defined ONCE:
|
|
301
|
-
* - every bound the route schema, the node panel and the MCP verb read;
|
|
302
|
-
* - `videoMaskBilledSeconds`: the length a run is priced at — the clip's
|
|
303
|
-
* length at the 30 fps basis, so a 60 fps clip is priced at twice its
|
|
304
|
-
* length (the segmentation works per FRAME);
|
|
305
|
-
* - `videoMaskCreditId`: which price row (`model_pricing`) that length is
|
|
306
|
-
* charged from. The credit amounts live in the rows, never here.
|
|
307
|
-
*
|
|
308
|
-
* Worked examples (repeated in docs/nodes/ai-video/video-mask.md):
|
|
309
|
-
* 4 s at 30 fps → `sam-3.1-video:5s`, 12 s at 24 fps → `sam-3.1-video:15s`,
|
|
310
|
-
* 10 s at 60 fps (priced as 20 s) → `sam-3.1-video:30s`, 45 s at 30 fps → `sam-3.1-video:60s`,
|
|
311
|
-
* 100 s at 30 fps → `sam-3.1-video:120s`, 4 min at 30 fps on SAM 3 → `sam-3-video:240s`.
|
|
312
|
-
*
|
|
313
|
-
* Wire contract only — no I/O.
|
|
314
|
-
*/
|
|
315
329
|
/** Segmentation models a Video Mask run can use. SAM 3.1 (the default)
|
|
316
330
|
* tracks several objects in one pass and runs faster; SAM 3 costs half. */
|
|
317
331
|
declare const VIDEO_MASK_PROVIDERS: readonly ["sam-3.1", "sam-3"];
|
|
@@ -451,14 +465,17 @@ declare function videoMaskCreditIds(provider?: VideoMaskProvider): string[];
|
|
|
451
465
|
/**
|
|
452
466
|
* The length a clip is priced at: its duration at the 30 fps basis. A clip
|
|
453
467
|
* at or under 30 fps is priced at its own length; a 60 fps clip at twice it.
|
|
454
|
-
* An unknown frame rate counts as the basis.
|
|
468
|
+
* An unknown frame rate counts as the basis. The cap reads this figure; the
|
|
469
|
+
* price row reads it through `pricedClipSeconds`.
|
|
455
470
|
*/
|
|
456
471
|
declare function videoMaskBilledSeconds(durationSec: number, fps?: number | null): number;
|
|
457
472
|
/**
|
|
458
|
-
* The price row for a clip priced at `billedSec` seconds
|
|
459
|
-
*
|
|
460
|
-
*
|
|
461
|
-
*
|
|
473
|
+
* The price row for a clip priced at `billedSec` seconds: the smallest that
|
|
474
|
+
* holds it, after `pricedClipSeconds` (up to 0.05 s past a row's length stays in
|
|
475
|
+
* that row). An unknown or non-positive length prices the LONGEST row (a clip
|
|
476
|
+
* the route could not measure is refused, so this is only the pre-run quote for
|
|
477
|
+
* a clip whose length is not known yet); anything past the cap prices the last
|
|
478
|
+
* row.
|
|
462
479
|
*/
|
|
463
480
|
declare function videoMaskCreditId(billedSec: number | null | undefined, provider?: VideoMaskProvider): string;
|
|
464
481
|
/** Narrow an arbitrary value to a known provider, falling back to the default. */
|
|
@@ -512,19 +529,6 @@ interface VideoMaskRequest {
|
|
|
512
529
|
readonly redetectEverySec?: number;
|
|
513
530
|
}
|
|
514
531
|
|
|
515
|
-
/**
|
|
516
|
-
* Video Face Mesh (`POST /v1/video-face-mesh`, job type `video-face-mesh`):
|
|
517
|
-
* thin GRAY face lines — a wireframe, and darker eye and lip outlines, each a
|
|
518
|
-
* tone of the picture under it — drawn on the faces of a clip, frame for
|
|
519
|
-
* frame. An internal step of Nodaro Motion's face masking: the lines go on
|
|
520
|
-
* the masked (or depth) clip so the video model still sees where the mouth
|
|
521
|
-
* and the eyes are. A request may draw only the eye and lip outlines, or
|
|
522
|
-
* only the lip outline (`parts`).
|
|
523
|
-
*
|
|
524
|
-
* Priced by the clip's length at the 30 fps basis Video Mask uses
|
|
525
|
-
* (`videoMaskBilledSeconds`), one row per length bucket.
|
|
526
|
-
*/
|
|
527
|
-
|
|
528
532
|
/** The route, as the Cast Swap engine calls it. */
|
|
529
533
|
declare const VIDEO_FACE_MESH_PATH = "/v1/video-face-mesh";
|
|
530
534
|
declare const VIDEO_FACE_MESH_LIMITS: {
|
|
@@ -556,14 +560,18 @@ type VideoFaceMeshParts = (typeof VIDEO_FACE_MESH_PARTS)[number];
|
|
|
556
560
|
* same input: the model, the crop, the smoothing, the filters, the colours or
|
|
557
561
|
* the widths. Never for pricing, limits or messages. 2026-11-02: MediaPipe's
|
|
558
562
|
* refined landmark model (478 points, a 256 × 256 crop) in place of the basic
|
|
559
|
-
* one; the lines' colours and widths are 2026-11-01's.
|
|
563
|
+
* one; the lines' colours and widths are 2026-11-01's. 2026-11-03: a face gets
|
|
564
|
+
* lines only when it is found in at least 3 frames of its track (found faces
|
|
565
|
+
* at the same place in frames at most 2 apart): one found in a frame or two
|
|
566
|
+
* is never drawn.
|
|
560
567
|
*/
|
|
561
|
-
declare const VIDEO_FACE_MESH_RECIPE = "2026-11-
|
|
568
|
+
declare const VIDEO_FACE_MESH_RECIPE = "2026-11-03";
|
|
562
569
|
/** Every price row, smallest first (`video-face-mesh:<n>s`). */
|
|
563
570
|
declare function videoFaceMeshCreditIds(): string[];
|
|
564
571
|
/**
|
|
565
572
|
* The price row for a clip priced at `billedSec` seconds: the smallest bucket
|
|
566
|
-
* that holds it
|
|
573
|
+
* that holds it, after `pricedClipSeconds` (up to 0.05 s past a bucket's length
|
|
574
|
+
* stays in that bucket). An unknown or non-positive length, or one past the cap,
|
|
567
575
|
* prices the LONGEST row (the route measures every clip and refuses one past
|
|
568
576
|
* the cap, so this is only ever a ceiling).
|
|
569
577
|
*/
|
|
@@ -661,35 +669,6 @@ interface GenerateMaskOutput {
|
|
|
661
669
|
readonly imageUrl: string;
|
|
662
670
|
}
|
|
663
671
|
|
|
664
|
-
/**
|
|
665
|
-
* Mask Composite — place a foreground video over a background video through a
|
|
666
|
-
* mask video (white = keep the foreground, black = show the background). The
|
|
667
|
-
* wire contract of the `mask-composite` node, `POST /v1/mask-composite`, the
|
|
668
|
-
* `mask_composite` MCP verb, `client.media.maskComposite` and
|
|
669
|
-
* `nodaro media mask-composite`, defined ONCE. Pair it with Video Mask, whose
|
|
670
|
-
* output is exactly such a mask.
|
|
671
|
-
*
|
|
672
|
-
* The render follows the FOREGROUND: its size, frame rate and length. The
|
|
673
|
-
* background is fitted to that frame (`backgroundFit`) and loops when shorter;
|
|
674
|
-
* the mask is stretched to the frame and holds its last frame when shorter.
|
|
675
|
-
*
|
|
676
|
-
* `fill` picks what fills the masked area. `"video"` (the default) is the
|
|
677
|
-
* foreground, as above. `"pixelate"` and `"blur"` fill it with the BACKGROUND
|
|
678
|
-
* itself, pixelated or blurred: there is no foreground then (a sent
|
|
679
|
-
* `foregroundUrl` is ignored), so the render follows the BACKGROUND (its size,
|
|
680
|
-
* frame rate and length; `backgroundFit` has nothing to fit), and the run is
|
|
681
|
-
* priced on the background's length. With no foreground the result always
|
|
682
|
-
* carries the background's sound — `audioSource` is ignored there
|
|
683
|
-
* ({@link maskCompositeEffectiveAudioSource}); the canvas hides the control.
|
|
684
|
-
*
|
|
685
|
-
* Priced per started 5 seconds of the result (the foreground's length), like
|
|
686
|
-
* Trim / Loop / Combine Videos: the node's own `model_pricing` row is ONE unit
|
|
687
|
-
* (`maskCompositeUnits` counts them). Worked examples (repeated in
|
|
688
|
-
* docs/nodes/processing-video/mask-composite.md, at the 10-credit row):
|
|
689
|
-
* 3 s → 1 unit (10), 10 s → 2 units (20), 61 s → 13 units (130), 5 min → 60 units (600).
|
|
690
|
-
*
|
|
691
|
-
* Wire contract only — no I/O.
|
|
692
|
-
*/
|
|
693
672
|
/** How the background is fitted to the foreground's frame. */
|
|
694
673
|
declare const MASK_COMPOSITE_BACKGROUND_FITS: readonly ["cover", "contain", "stretch"];
|
|
695
674
|
type MaskCompositeBackgroundFit = (typeof MASK_COMPOSITE_BACKGROUND_FITS)[number];
|
|
@@ -725,9 +704,10 @@ declare const MASK_COMPOSITE_BOUNDS: {
|
|
|
725
704
|
declare const MASK_COMPOSITE_UNIT_SEC = 5;
|
|
726
705
|
/**
|
|
727
706
|
* Pricing units for a result `durationSec` long: one per started 5 seconds,
|
|
728
|
-
* at least one
|
|
729
|
-
*
|
|
730
|
-
*
|
|
707
|
+
* at least one, after `pricedClipSeconds` (up to 0.05 s past a whole second is
|
|
708
|
+
* ignored, so a 10.01 s result is 2 units, not 3). An unknown length counts the
|
|
709
|
+
* longest result a run accepts (an upper bound — the pre-run quote for a clip
|
|
710
|
+
* whose length is not known yet; every run measures its foreground).
|
|
731
711
|
*/
|
|
732
712
|
declare function maskCompositeUnits(durationSec: number | null | undefined): number;
|
|
733
713
|
declare const MASK_COMPOSITE_DEFAULTS: {
|
|
@@ -867,4 +847,4 @@ declare function overlayVariantHandle(platformId: string): string;
|
|
|
867
847
|
/** The platform id a variant handle names, or null for any other handle. */
|
|
868
848
|
declare function overlayVariantIdFromHandle(handle: string | null | undefined): string | null;
|
|
869
849
|
|
|
870
|
-
export { AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, type AudioFxPreset, DEFAULT_VIDEO_MASK_PROVIDER, FAL_VIDEO_DEPTH_PROVIDERS, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, type FreecutExportCompletePayload, type FreecutExportProgressPayload, type FreecutImportFile, type FreecutRequestImportPayload, GENERATE_MASK_LIMITS, type GenerateMaskOutput, type GenerateMaskRequest, LEGACY_LOTTIE_HOST_REMAP, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, type LottieOverlayCatalogEntry, type LottieSlotField, MASK_COMPOSITE_AUDIO_SOURCES, MASK_COMPOSITE_BACKGROUND_FITS, MASK_COMPOSITE_BOUNDS, MASK_COMPOSITE_DEFAULTS, MASK_COMPOSITE_FILLS, MASK_COMPOSITE_UNIT_SEC, type MaskCompositeAudioSource, type MaskCompositeBackgroundFit, type MaskCompositeFill, type MaskCompositeRequest, type MaskCompositeSettings, type MaskRegionDescriptor, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, type NodaroLoadTimelinePayload, type NodaroLoadVideoPayload, OVERLAY_MAX_VARIANTS, OVERLAY_PLATFORMS, OVERLAY_PLATFORM_IDS, OVERLAY_SHAPES, OVERLAY_VARIANT_HANDLE_PREFIX, type OverlayPlatformId, type OverlayPlatformPreset, type OverlayPlatformZone, type OverlayShape, type OverlayShapeElement, type PixelBox, REPLICATE_VIDEO_DEPTH_PROVIDERS, type SlotControlDescriptor, type SlotControlKind, VIDEO_DEPTH_BUCKETS, VIDEO_DEPTH_COLORMAPS, VIDEO_DEPTH_LIMITS, VIDEO_DEPTH_MODEL_SIZES, VIDEO_DEPTH_PROVIDERS, VIDEO_DEPTH_RESOLUTIONS, VIDEO_FACE_MESH_LIMITS, VIDEO_FACE_MESH_PARTS, VIDEO_FACE_MESH_PATH, VIDEO_FACE_MESH_RECIPE, VIDEO_MASK_DEFAULTS, VIDEO_MASK_LIMITS, VIDEO_MASK_PROVIDERS, VIDEO_MASK_RECIPE, type VideoDepthColormap, type VideoDepthLever, type VideoDepthModelSize, type VideoDepthProvider, type VideoDepthResolution, type VideoFaceMeshOutput, type VideoFaceMeshParts, type VideoFaceMeshRequest, type VideoMaskProvider, type VideoMaskRequest, type VideoMaskZone, applySlots, checkVideoDepthLength, deriveLottieSlotFields, describeMaskRegion, describeSlotControl, hexToRgbaArray, humanizeSlotSid, listSlotSids, maskCompositeEffectiveAudioSource, maskCompositeFillOf, maskCompositeLeadHandle, maskCompositeUnits, maskCompositeUsesForeground, normalizeLottieLayers, overlayPlatformById, overlayShapeElement, overlayVariantHandle, overlayVariantIdFromHandle, resolveLottieOverlaySrc, resolveMaskCompositeSettings, resolveVideoDepthColormap, resolveVideoDepthModelSize, resolveVideoDepthProvider, resolveVideoMaskProvider, resolveVideoMaskRedetectSec, resolveVideoMaskZone, rgbaArrayToHex, videoDepthColormaps, videoDepthCreditId, videoDepthLevers, videoDepthNeedsGrayscalePass, videoFaceMeshCreditId, videoFaceMeshCreditIds, videoMaskBilledSeconds, videoMaskCreditId, videoMaskCreditIds };
|
|
850
|
+
export { AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, type AudioFxPreset, CLIP_PRICE_GRACE_SEC, DEFAULT_VIDEO_MASK_PROVIDER, FAL_VIDEO_DEPTH_PROVIDERS, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, type FreecutExportCompletePayload, type FreecutExportProgressPayload, type FreecutImportFile, type FreecutRequestImportPayload, GENERATE_MASK_LIMITS, type GenerateMaskOutput, type GenerateMaskRequest, LEGACY_LOTTIE_HOST_REMAP, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, type LottieOverlayCatalogEntry, type LottieSlotField, MASK_COMPOSITE_AUDIO_SOURCES, MASK_COMPOSITE_BACKGROUND_FITS, MASK_COMPOSITE_BOUNDS, MASK_COMPOSITE_DEFAULTS, MASK_COMPOSITE_FILLS, MASK_COMPOSITE_UNIT_SEC, type MaskCompositeAudioSource, type MaskCompositeBackgroundFit, type MaskCompositeFill, type MaskCompositeRequest, type MaskCompositeSettings, type MaskRegionDescriptor, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, type NodaroLoadTimelinePayload, type NodaroLoadVideoPayload, OVERLAY_MAX_VARIANTS, OVERLAY_PLATFORMS, OVERLAY_PLATFORM_IDS, OVERLAY_SHAPES, OVERLAY_VARIANT_HANDLE_PREFIX, type OverlayPlatformId, type OverlayPlatformPreset, type OverlayPlatformZone, type OverlayShape, type OverlayShapeElement, type PixelBox, REPLICATE_VIDEO_DEPTH_PROVIDERS, type SlotControlDescriptor, type SlotControlKind, VIDEO_DEPTH_BUCKETS, VIDEO_DEPTH_COLORMAPS, VIDEO_DEPTH_LIMITS, VIDEO_DEPTH_MODEL_SIZES, VIDEO_DEPTH_PROVIDERS, VIDEO_DEPTH_RESOLUTIONS, VIDEO_FACE_MESH_LIMITS, VIDEO_FACE_MESH_PARTS, VIDEO_FACE_MESH_PATH, VIDEO_FACE_MESH_RECIPE, VIDEO_MASK_DEFAULTS, VIDEO_MASK_LIMITS, VIDEO_MASK_PROVIDERS, VIDEO_MASK_RECIPE, type VideoDepthColormap, type VideoDepthLever, type VideoDepthModelSize, type VideoDepthProvider, type VideoDepthResolution, type VideoFaceMeshOutput, type VideoFaceMeshParts, type VideoFaceMeshRequest, type VideoMaskProvider, type VideoMaskRequest, type VideoMaskZone, applySlots, checkVideoDepthLength, deriveLottieSlotFields, describeMaskRegion, describeSlotControl, hexToRgbaArray, humanizeSlotSid, listSlotSids, maskCompositeEffectiveAudioSource, maskCompositeFillOf, maskCompositeLeadHandle, maskCompositeUnits, maskCompositeUsesForeground, normalizeLottieLayers, overlayPlatformById, overlayShapeElement, overlayVariantHandle, overlayVariantIdFromHandle, pricedClipSeconds, resolveLottieOverlaySrc, resolveMaskCompositeSettings, resolveVideoDepthColormap, resolveVideoDepthModelSize, resolveVideoDepthProvider, resolveVideoMaskProvider, resolveVideoMaskRedetectSec, resolveVideoMaskZone, rgbaArrayToHex, videoDepthColormaps, videoDepthCreditId, videoDepthLevers, videoDepthNeedsGrayscalePass, videoFaceMeshCreditId, videoFaceMeshCreditIds, videoMaskBilledSeconds, videoMaskCreditId, videoMaskCreditIds };
|
package/dist/entries/media.d.ts
CHANGED
|
@@ -63,6 +63,24 @@ declare function describeMaskRegion(box: PixelBox, image: {
|
|
|
63
63
|
height: number;
|
|
64
64
|
}): MaskRegionDescriptor;
|
|
65
65
|
|
|
66
|
+
/**
|
|
67
|
+
* The whole seconds a clip is PRICED at by Video Depth (both providers), Video
|
|
68
|
+
* Mask, Mask Composite and the face mesh: its length rounded up, after ignoring
|
|
69
|
+
* up to {@link CLIP_PRICE_GRACE_SEC} past a whole second.
|
|
70
|
+
*
|
|
71
|
+
* A whole-second cut of a 29.97 or 23.976 fps clip can come out a little long:
|
|
72
|
+
* 12 s is 360 frames, a 12.012 s file. A quote reads the cut, a run measures the
|
|
73
|
+
* file, and both land on the same row through this one rule, wherever those steps
|
|
74
|
+
* are reserved, charged or quoted.
|
|
75
|
+
*
|
|
76
|
+
* It decides the price only. Each step's limits (the 300 s cap, the frame cap)
|
|
77
|
+
* read the clip's real length. Other models round as they always have.
|
|
78
|
+
*/
|
|
79
|
+
/** How far past a whole second a clip is still priced as that second. */
|
|
80
|
+
declare const CLIP_PRICE_GRACE_SEC = 0.05;
|
|
81
|
+
/** At least one second. The caller has checked that `sec` is a real length. */
|
|
82
|
+
declare function pricedClipSeconds(sec: number): number;
|
|
83
|
+
|
|
66
84
|
/**
|
|
67
85
|
* Video Depth — the one contract every layer reads: which providers exist and
|
|
68
86
|
* which lane serves each, which optional levers a provider honours, how long a
|
|
@@ -74,9 +92,11 @@ declare function describeMaskRegion(box: PixelBox, image: {
|
|
|
74
92
|
* produces from the inferno output (`videoDepthNeedsGrayscalePass`).
|
|
75
93
|
*
|
|
76
94
|
* Price rows are `model_pricing` rows (`<provider>:<n>s`); the credit amounts
|
|
77
|
-
* live there, never here.
|
|
95
|
+
* live there, never here. Both providers have one row per whole second of the
|
|
96
|
+
* clip, up to the longest clip each accepts. Worked examples (repeated in
|
|
78
97
|
* docs/nodes/processing-video/video-depth.md):
|
|
79
|
-
*
|
|
98
|
+
* video-depth-anything: 0.4 s → `:1s`, 9 s → `:9s`, 9.2 s → `:10s`, 15.015 s → `:15s`, 15.06 s → `:16s`.
|
|
99
|
+
* depth-anything-frames: 0.4 s → `:1s`, 4 s → `:4s`, 4.1 s → `:5s`, 15.015 s → `:15s`, 15.06 s → `:16s`, 80 s → `:80s`.
|
|
80
100
|
*/
|
|
81
101
|
declare const VIDEO_DEPTH_PROVIDERS: readonly ["video-depth-anything", "depth-anything-frames"];
|
|
82
102
|
type VideoDepthProvider = (typeof VIDEO_DEPTH_PROVIDERS)[number];
|
|
@@ -109,7 +129,7 @@ declare function videoDepthNeedsGrayscalePass(provider: string, colormap: VideoD
|
|
|
109
129
|
declare const VIDEO_DEPTH_LIMITS: {
|
|
110
130
|
/** fal `max_frames` ceiling. */
|
|
111
131
|
readonly FAL_MAX_FRAMES: 2400;
|
|
112
|
-
/** Longest clip the fal lane accepts, whatever its frame rate:
|
|
132
|
+
/** Longest clip the fal lane accepts, whatever its frame rate: its top price row, `:300s` (a low-fps clip under the frame limit can otherwise run past every price row). */
|
|
113
133
|
readonly FAL_MAX_SECONDS: 300;
|
|
114
134
|
/** Frame rate assumed when the clip reports none (variable-rate or missing). */
|
|
115
135
|
readonly ASSUMED_FPS: 30;
|
|
@@ -126,13 +146,25 @@ declare function checkVideoDepthLength(provider: string, probe: {
|
|
|
126
146
|
ok: false;
|
|
127
147
|
message: string;
|
|
128
148
|
};
|
|
149
|
+
/**
|
|
150
|
+
* The length buckets, in seconds, both providers were priced in before their
|
|
151
|
+
* per-second rows. A row is no longer picked from these: a clip's whole seconds
|
|
152
|
+
* name its row, so a `:15s` is the 15-second row and a `:120s` on Depth Anything
|
|
153
|
+
* per frame is past its limit. Each per-second row took its admin switches from
|
|
154
|
+
* the bucket that priced it (migrations 590 and 595).
|
|
155
|
+
*/
|
|
129
156
|
declare const VIDEO_DEPTH_BUCKETS: readonly [15, 30, 60, 120, 300];
|
|
130
157
|
/**
|
|
131
|
-
* The price row for a clip of `durationSec`.
|
|
132
|
-
*
|
|
133
|
-
*
|
|
134
|
-
*
|
|
135
|
-
*
|
|
158
|
+
* The price row for a clip of `durationSec`.
|
|
159
|
+
*
|
|
160
|
+
* One row per whole second of the clip on both lanes: the clip's length rounded
|
|
161
|
+
* UP (`pricedClipSeconds`: up to 0.05 s past a whole second is ignored first), so
|
|
162
|
+
* a clip under one second is priced as one. `video-depth-anything:1s` … `:300s`
|
|
163
|
+
* (decided 2026-11-03), `depth-anything-frames:1s` … `:80s` (decided 2026-11-04).
|
|
164
|
+
*
|
|
165
|
+
* Unknown, non-positive or longer than the provider accepts → the provider's
|
|
166
|
+
* longest clip (fal `:300s`, Replicate `:80s`), its highest REACHABLE row — the
|
|
167
|
+
* most a run on it can be charged, never a row a run could not reach.
|
|
136
168
|
*/
|
|
137
169
|
declare function videoDepthCreditId(provider: string, durationSec: number | null | undefined): string;
|
|
138
170
|
|
|
@@ -294,24 +326,6 @@ declare const AUDIO_FX_PRESET_LABELS: Record<AudioFxPreset, string>;
|
|
|
294
326
|
/** Presets that apply convolution reverb (afir + inline-synth IR). */
|
|
295
327
|
declare const AUDIO_FX_REVERB_PRESETS: ReadonlySet<AudioFxPreset>;
|
|
296
328
|
|
|
297
|
-
/**
|
|
298
|
-
* Video Mask — text-prompted video segmentation (SAM 3.1 / SAM 3). The wire contract of
|
|
299
|
-
* the `video-mask` node, `POST /v1/video-mask`, the `video_mask` MCP verb,
|
|
300
|
-
* `client.media.videoMask` and `nodaro media video-mask`, defined ONCE:
|
|
301
|
-
* - every bound the route schema, the node panel and the MCP verb read;
|
|
302
|
-
* - `videoMaskBilledSeconds`: the length a run is priced at — the clip's
|
|
303
|
-
* length at the 30 fps basis, so a 60 fps clip is priced at twice its
|
|
304
|
-
* length (the segmentation works per FRAME);
|
|
305
|
-
* - `videoMaskCreditId`: which price row (`model_pricing`) that length is
|
|
306
|
-
* charged from. The credit amounts live in the rows, never here.
|
|
307
|
-
*
|
|
308
|
-
* Worked examples (repeated in docs/nodes/ai-video/video-mask.md):
|
|
309
|
-
* 4 s at 30 fps → `sam-3.1-video:5s`, 12 s at 24 fps → `sam-3.1-video:15s`,
|
|
310
|
-
* 10 s at 60 fps (priced as 20 s) → `sam-3.1-video:30s`, 45 s at 30 fps → `sam-3.1-video:60s`,
|
|
311
|
-
* 100 s at 30 fps → `sam-3.1-video:120s`, 4 min at 30 fps on SAM 3 → `sam-3-video:240s`.
|
|
312
|
-
*
|
|
313
|
-
* Wire contract only — no I/O.
|
|
314
|
-
*/
|
|
315
329
|
/** Segmentation models a Video Mask run can use. SAM 3.1 (the default)
|
|
316
330
|
* tracks several objects in one pass and runs faster; SAM 3 costs half. */
|
|
317
331
|
declare const VIDEO_MASK_PROVIDERS: readonly ["sam-3.1", "sam-3"];
|
|
@@ -451,14 +465,17 @@ declare function videoMaskCreditIds(provider?: VideoMaskProvider): string[];
|
|
|
451
465
|
/**
|
|
452
466
|
* The length a clip is priced at: its duration at the 30 fps basis. A clip
|
|
453
467
|
* at or under 30 fps is priced at its own length; a 60 fps clip at twice it.
|
|
454
|
-
* An unknown frame rate counts as the basis.
|
|
468
|
+
* An unknown frame rate counts as the basis. The cap reads this figure; the
|
|
469
|
+
* price row reads it through `pricedClipSeconds`.
|
|
455
470
|
*/
|
|
456
471
|
declare function videoMaskBilledSeconds(durationSec: number, fps?: number | null): number;
|
|
457
472
|
/**
|
|
458
|
-
* The price row for a clip priced at `billedSec` seconds
|
|
459
|
-
*
|
|
460
|
-
*
|
|
461
|
-
*
|
|
473
|
+
* The price row for a clip priced at `billedSec` seconds: the smallest that
|
|
474
|
+
* holds it, after `pricedClipSeconds` (up to 0.05 s past a row's length stays in
|
|
475
|
+
* that row). An unknown or non-positive length prices the LONGEST row (a clip
|
|
476
|
+
* the route could not measure is refused, so this is only the pre-run quote for
|
|
477
|
+
* a clip whose length is not known yet); anything past the cap prices the last
|
|
478
|
+
* row.
|
|
462
479
|
*/
|
|
463
480
|
declare function videoMaskCreditId(billedSec: number | null | undefined, provider?: VideoMaskProvider): string;
|
|
464
481
|
/** Narrow an arbitrary value to a known provider, falling back to the default. */
|
|
@@ -512,19 +529,6 @@ interface VideoMaskRequest {
|
|
|
512
529
|
readonly redetectEverySec?: number;
|
|
513
530
|
}
|
|
514
531
|
|
|
515
|
-
/**
|
|
516
|
-
* Video Face Mesh (`POST /v1/video-face-mesh`, job type `video-face-mesh`):
|
|
517
|
-
* thin GRAY face lines — a wireframe, and darker eye and lip outlines, each a
|
|
518
|
-
* tone of the picture under it — drawn on the faces of a clip, frame for
|
|
519
|
-
* frame. An internal step of Nodaro Motion's face masking: the lines go on
|
|
520
|
-
* the masked (or depth) clip so the video model still sees where the mouth
|
|
521
|
-
* and the eyes are. A request may draw only the eye and lip outlines, or
|
|
522
|
-
* only the lip outline (`parts`).
|
|
523
|
-
*
|
|
524
|
-
* Priced by the clip's length at the 30 fps basis Video Mask uses
|
|
525
|
-
* (`videoMaskBilledSeconds`), one row per length bucket.
|
|
526
|
-
*/
|
|
527
|
-
|
|
528
532
|
/** The route, as the Cast Swap engine calls it. */
|
|
529
533
|
declare const VIDEO_FACE_MESH_PATH = "/v1/video-face-mesh";
|
|
530
534
|
declare const VIDEO_FACE_MESH_LIMITS: {
|
|
@@ -556,14 +560,18 @@ type VideoFaceMeshParts = (typeof VIDEO_FACE_MESH_PARTS)[number];
|
|
|
556
560
|
* same input: the model, the crop, the smoothing, the filters, the colours or
|
|
557
561
|
* the widths. Never for pricing, limits or messages. 2026-11-02: MediaPipe's
|
|
558
562
|
* refined landmark model (478 points, a 256 × 256 crop) in place of the basic
|
|
559
|
-
* one; the lines' colours and widths are 2026-11-01's.
|
|
563
|
+
* one; the lines' colours and widths are 2026-11-01's. 2026-11-03: a face gets
|
|
564
|
+
* lines only when it is found in at least 3 frames of its track (found faces
|
|
565
|
+
* at the same place in frames at most 2 apart): one found in a frame or two
|
|
566
|
+
* is never drawn.
|
|
560
567
|
*/
|
|
561
|
-
declare const VIDEO_FACE_MESH_RECIPE = "2026-11-
|
|
568
|
+
declare const VIDEO_FACE_MESH_RECIPE = "2026-11-03";
|
|
562
569
|
/** Every price row, smallest first (`video-face-mesh:<n>s`). */
|
|
563
570
|
declare function videoFaceMeshCreditIds(): string[];
|
|
564
571
|
/**
|
|
565
572
|
* The price row for a clip priced at `billedSec` seconds: the smallest bucket
|
|
566
|
-
* that holds it
|
|
573
|
+
* that holds it, after `pricedClipSeconds` (up to 0.05 s past a bucket's length
|
|
574
|
+
* stays in that bucket). An unknown or non-positive length, or one past the cap,
|
|
567
575
|
* prices the LONGEST row (the route measures every clip and refuses one past
|
|
568
576
|
* the cap, so this is only ever a ceiling).
|
|
569
577
|
*/
|
|
@@ -661,35 +669,6 @@ interface GenerateMaskOutput {
|
|
|
661
669
|
readonly imageUrl: string;
|
|
662
670
|
}
|
|
663
671
|
|
|
664
|
-
/**
|
|
665
|
-
* Mask Composite — place a foreground video over a background video through a
|
|
666
|
-
* mask video (white = keep the foreground, black = show the background). The
|
|
667
|
-
* wire contract of the `mask-composite` node, `POST /v1/mask-composite`, the
|
|
668
|
-
* `mask_composite` MCP verb, `client.media.maskComposite` and
|
|
669
|
-
* `nodaro media mask-composite`, defined ONCE. Pair it with Video Mask, whose
|
|
670
|
-
* output is exactly such a mask.
|
|
671
|
-
*
|
|
672
|
-
* The render follows the FOREGROUND: its size, frame rate and length. The
|
|
673
|
-
* background is fitted to that frame (`backgroundFit`) and loops when shorter;
|
|
674
|
-
* the mask is stretched to the frame and holds its last frame when shorter.
|
|
675
|
-
*
|
|
676
|
-
* `fill` picks what fills the masked area. `"video"` (the default) is the
|
|
677
|
-
* foreground, as above. `"pixelate"` and `"blur"` fill it with the BACKGROUND
|
|
678
|
-
* itself, pixelated or blurred: there is no foreground then (a sent
|
|
679
|
-
* `foregroundUrl` is ignored), so the render follows the BACKGROUND (its size,
|
|
680
|
-
* frame rate and length; `backgroundFit` has nothing to fit), and the run is
|
|
681
|
-
* priced on the background's length. With no foreground the result always
|
|
682
|
-
* carries the background's sound — `audioSource` is ignored there
|
|
683
|
-
* ({@link maskCompositeEffectiveAudioSource}); the canvas hides the control.
|
|
684
|
-
*
|
|
685
|
-
* Priced per started 5 seconds of the result (the foreground's length), like
|
|
686
|
-
* Trim / Loop / Combine Videos: the node's own `model_pricing` row is ONE unit
|
|
687
|
-
* (`maskCompositeUnits` counts them). Worked examples (repeated in
|
|
688
|
-
* docs/nodes/processing-video/mask-composite.md, at the 10-credit row):
|
|
689
|
-
* 3 s → 1 unit (10), 10 s → 2 units (20), 61 s → 13 units (130), 5 min → 60 units (600).
|
|
690
|
-
*
|
|
691
|
-
* Wire contract only — no I/O.
|
|
692
|
-
*/
|
|
693
672
|
/** How the background is fitted to the foreground's frame. */
|
|
694
673
|
declare const MASK_COMPOSITE_BACKGROUND_FITS: readonly ["cover", "contain", "stretch"];
|
|
695
674
|
type MaskCompositeBackgroundFit = (typeof MASK_COMPOSITE_BACKGROUND_FITS)[number];
|
|
@@ -725,9 +704,10 @@ declare const MASK_COMPOSITE_BOUNDS: {
|
|
|
725
704
|
declare const MASK_COMPOSITE_UNIT_SEC = 5;
|
|
726
705
|
/**
|
|
727
706
|
* Pricing units for a result `durationSec` long: one per started 5 seconds,
|
|
728
|
-
* at least one
|
|
729
|
-
*
|
|
730
|
-
*
|
|
707
|
+
* at least one, after `pricedClipSeconds` (up to 0.05 s past a whole second is
|
|
708
|
+
* ignored, so a 10.01 s result is 2 units, not 3). An unknown length counts the
|
|
709
|
+
* longest result a run accepts (an upper bound — the pre-run quote for a clip
|
|
710
|
+
* whose length is not known yet; every run measures its foreground).
|
|
731
711
|
*/
|
|
732
712
|
declare function maskCompositeUnits(durationSec: number | null | undefined): number;
|
|
733
713
|
declare const MASK_COMPOSITE_DEFAULTS: {
|
|
@@ -867,4 +847,4 @@ declare function overlayVariantHandle(platformId: string): string;
|
|
|
867
847
|
/** The platform id a variant handle names, or null for any other handle. */
|
|
868
848
|
declare function overlayVariantIdFromHandle(handle: string | null | undefined): string | null;
|
|
869
849
|
|
|
870
|
-
export { AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, type AudioFxPreset, DEFAULT_VIDEO_MASK_PROVIDER, FAL_VIDEO_DEPTH_PROVIDERS, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, type FreecutExportCompletePayload, type FreecutExportProgressPayload, type FreecutImportFile, type FreecutRequestImportPayload, GENERATE_MASK_LIMITS, type GenerateMaskOutput, type GenerateMaskRequest, LEGACY_LOTTIE_HOST_REMAP, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, type LottieOverlayCatalogEntry, type LottieSlotField, MASK_COMPOSITE_AUDIO_SOURCES, MASK_COMPOSITE_BACKGROUND_FITS, MASK_COMPOSITE_BOUNDS, MASK_COMPOSITE_DEFAULTS, MASK_COMPOSITE_FILLS, MASK_COMPOSITE_UNIT_SEC, type MaskCompositeAudioSource, type MaskCompositeBackgroundFit, type MaskCompositeFill, type MaskCompositeRequest, type MaskCompositeSettings, type MaskRegionDescriptor, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, type NodaroLoadTimelinePayload, type NodaroLoadVideoPayload, OVERLAY_MAX_VARIANTS, OVERLAY_PLATFORMS, OVERLAY_PLATFORM_IDS, OVERLAY_SHAPES, OVERLAY_VARIANT_HANDLE_PREFIX, type OverlayPlatformId, type OverlayPlatformPreset, type OverlayPlatformZone, type OverlayShape, type OverlayShapeElement, type PixelBox, REPLICATE_VIDEO_DEPTH_PROVIDERS, type SlotControlDescriptor, type SlotControlKind, VIDEO_DEPTH_BUCKETS, VIDEO_DEPTH_COLORMAPS, VIDEO_DEPTH_LIMITS, VIDEO_DEPTH_MODEL_SIZES, VIDEO_DEPTH_PROVIDERS, VIDEO_DEPTH_RESOLUTIONS, VIDEO_FACE_MESH_LIMITS, VIDEO_FACE_MESH_PARTS, VIDEO_FACE_MESH_PATH, VIDEO_FACE_MESH_RECIPE, VIDEO_MASK_DEFAULTS, VIDEO_MASK_LIMITS, VIDEO_MASK_PROVIDERS, VIDEO_MASK_RECIPE, type VideoDepthColormap, type VideoDepthLever, type VideoDepthModelSize, type VideoDepthProvider, type VideoDepthResolution, type VideoFaceMeshOutput, type VideoFaceMeshParts, type VideoFaceMeshRequest, type VideoMaskProvider, type VideoMaskRequest, type VideoMaskZone, applySlots, checkVideoDepthLength, deriveLottieSlotFields, describeMaskRegion, describeSlotControl, hexToRgbaArray, humanizeSlotSid, listSlotSids, maskCompositeEffectiveAudioSource, maskCompositeFillOf, maskCompositeLeadHandle, maskCompositeUnits, maskCompositeUsesForeground, normalizeLottieLayers, overlayPlatformById, overlayShapeElement, overlayVariantHandle, overlayVariantIdFromHandle, resolveLottieOverlaySrc, resolveMaskCompositeSettings, resolveVideoDepthColormap, resolveVideoDepthModelSize, resolveVideoDepthProvider, resolveVideoMaskProvider, resolveVideoMaskRedetectSec, resolveVideoMaskZone, rgbaArrayToHex, videoDepthColormaps, videoDepthCreditId, videoDepthLevers, videoDepthNeedsGrayscalePass, videoFaceMeshCreditId, videoFaceMeshCreditIds, videoMaskBilledSeconds, videoMaskCreditId, videoMaskCreditIds };
|
|
850
|
+
export { AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, type AudioFxPreset, CLIP_PRICE_GRACE_SEC, DEFAULT_VIDEO_MASK_PROVIDER, FAL_VIDEO_DEPTH_PROVIDERS, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, type FreecutExportCompletePayload, type FreecutExportProgressPayload, type FreecutImportFile, type FreecutRequestImportPayload, GENERATE_MASK_LIMITS, type GenerateMaskOutput, type GenerateMaskRequest, LEGACY_LOTTIE_HOST_REMAP, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, type LottieOverlayCatalogEntry, type LottieSlotField, MASK_COMPOSITE_AUDIO_SOURCES, MASK_COMPOSITE_BACKGROUND_FITS, MASK_COMPOSITE_BOUNDS, MASK_COMPOSITE_DEFAULTS, MASK_COMPOSITE_FILLS, MASK_COMPOSITE_UNIT_SEC, type MaskCompositeAudioSource, type MaskCompositeBackgroundFit, type MaskCompositeFill, type MaskCompositeRequest, type MaskCompositeSettings, type MaskRegionDescriptor, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, type NodaroLoadTimelinePayload, type NodaroLoadVideoPayload, OVERLAY_MAX_VARIANTS, OVERLAY_PLATFORMS, OVERLAY_PLATFORM_IDS, OVERLAY_SHAPES, OVERLAY_VARIANT_HANDLE_PREFIX, type OverlayPlatformId, type OverlayPlatformPreset, type OverlayPlatformZone, type OverlayShape, type OverlayShapeElement, type PixelBox, REPLICATE_VIDEO_DEPTH_PROVIDERS, type SlotControlDescriptor, type SlotControlKind, VIDEO_DEPTH_BUCKETS, VIDEO_DEPTH_COLORMAPS, VIDEO_DEPTH_LIMITS, VIDEO_DEPTH_MODEL_SIZES, VIDEO_DEPTH_PROVIDERS, VIDEO_DEPTH_RESOLUTIONS, VIDEO_FACE_MESH_LIMITS, VIDEO_FACE_MESH_PARTS, VIDEO_FACE_MESH_PATH, VIDEO_FACE_MESH_RECIPE, VIDEO_MASK_DEFAULTS, VIDEO_MASK_LIMITS, VIDEO_MASK_PROVIDERS, VIDEO_MASK_RECIPE, type VideoDepthColormap, type VideoDepthLever, type VideoDepthModelSize, type VideoDepthProvider, type VideoDepthResolution, type VideoFaceMeshOutput, type VideoFaceMeshParts, type VideoFaceMeshRequest, type VideoMaskProvider, type VideoMaskRequest, type VideoMaskZone, applySlots, checkVideoDepthLength, deriveLottieSlotFields, describeMaskRegion, describeSlotControl, hexToRgbaArray, humanizeSlotSid, listSlotSids, maskCompositeEffectiveAudioSource, maskCompositeFillOf, maskCompositeLeadHandle, maskCompositeUnits, maskCompositeUsesForeground, normalizeLottieLayers, overlayPlatformById, overlayShapeElement, overlayVariantHandle, overlayVariantIdFromHandle, pricedClipSeconds, resolveLottieOverlaySrc, resolveMaskCompositeSettings, resolveVideoDepthColormap, resolveVideoDepthModelSize, resolveVideoDepthProvider, resolveVideoMaskProvider, resolveVideoMaskRedetectSec, resolveVideoMaskZone, rgbaArrayToHex, videoDepthColormaps, videoDepthCreditId, videoDepthLevers, videoDepthNeedsGrayscalePass, videoFaceMeshCreditId, videoFaceMeshCreditIds, videoMaskBilledSeconds, videoMaskCreditId, videoMaskCreditIds };
|
package/dist/entries/media.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
export { AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, DEFAULT_VIDEO_MASK_PROVIDER, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, GENERATE_MASK_LIMITS, LEGACY_LOTTIE_HOST_REMAP, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, MASK_COMPOSITE_AUDIO_SOURCES, MASK_COMPOSITE_BACKGROUND_FITS, MASK_COMPOSITE_BOUNDS, MASK_COMPOSITE_DEFAULTS, MASK_COMPOSITE_FILLS, MASK_COMPOSITE_UNIT_SEC, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, VIDEO_FACE_MESH_LIMITS, VIDEO_FACE_MESH_PARTS, VIDEO_FACE_MESH_PATH, VIDEO_FACE_MESH_RECIPE, VIDEO_MASK_DEFAULTS, VIDEO_MASK_LIMITS, VIDEO_MASK_PROVIDERS, VIDEO_MASK_RECIPE, applySlots, deriveLottieSlotFields, describeMaskRegion, describeSlotControl, hexToRgbaArray, humanizeSlotSid, listSlotSids, maskCompositeEffectiveAudioSource, maskCompositeFillOf, maskCompositeLeadHandle, maskCompositeUnits, maskCompositeUsesForeground, normalizeLottieLayers, resolveLottieOverlaySrc, resolveMaskCompositeSettings, resolveVideoMaskProvider, resolveVideoMaskRedetectSec, resolveVideoMaskZone, rgbaArrayToHex, videoFaceMeshCreditId, videoFaceMeshCreditIds, videoMaskBilledSeconds, videoMaskCreditId, videoMaskCreditIds } from '../chunk-
|
|
1
|
+
export { AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, DEFAULT_VIDEO_MASK_PROVIDER, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, GENERATE_MASK_LIMITS, LEGACY_LOTTIE_HOST_REMAP, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, MASK_COMPOSITE_AUDIO_SOURCES, MASK_COMPOSITE_BACKGROUND_FITS, MASK_COMPOSITE_BOUNDS, MASK_COMPOSITE_DEFAULTS, MASK_COMPOSITE_FILLS, MASK_COMPOSITE_UNIT_SEC, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, VIDEO_FACE_MESH_LIMITS, VIDEO_FACE_MESH_PARTS, VIDEO_FACE_MESH_PATH, VIDEO_FACE_MESH_RECIPE, VIDEO_MASK_DEFAULTS, VIDEO_MASK_LIMITS, VIDEO_MASK_PROVIDERS, VIDEO_MASK_RECIPE, applySlots, deriveLottieSlotFields, describeMaskRegion, describeSlotControl, hexToRgbaArray, humanizeSlotSid, listSlotSids, maskCompositeEffectiveAudioSource, maskCompositeFillOf, maskCompositeLeadHandle, maskCompositeUnits, maskCompositeUsesForeground, normalizeLottieLayers, resolveLottieOverlaySrc, resolveMaskCompositeSettings, resolveVideoMaskProvider, resolveVideoMaskRedetectSec, resolveVideoMaskZone, rgbaArrayToHex, videoFaceMeshCreditId, videoFaceMeshCreditIds, videoMaskBilledSeconds, videoMaskCreditId, videoMaskCreditIds } from '../chunk-CZCOL3M5.js';
|
|
2
2
|
export { DEFAULT_OVERLAY_QR, DEFAULT_OVERLAY_SHAPE, DEFAULT_OVERLAY_TEXT, OVERLAY_ANCHORS, OVERLAY_FONTS, OVERLAY_FONT_IDS, OVERLAY_IMAGE_MASKS, OVERLAY_LAYER_KINDS, OVERLAY_SHAPES, OVERLAY_TEXT_ALIGNS, isRtlText, overlayFontById, overlayImageEffectsSchema, overlayQrStyleSchema, overlayShapeElement, overlayShapeStyleSchema, overlayStrokeSchema, overlayTextStyleSchema } from '../chunk-ZNZDQAXN.js';
|
|
3
|
-
export { FAL_VIDEO_DEPTH_PROVIDERS, REPLICATE_VIDEO_DEPTH_PROVIDERS, VIDEO_DEPTH_BUCKETS, VIDEO_DEPTH_COLORMAPS, VIDEO_DEPTH_LIMITS, VIDEO_DEPTH_MODEL_SIZES, VIDEO_DEPTH_PROVIDERS, VIDEO_DEPTH_RESOLUTIONS, checkVideoDepthLength, resolveVideoDepthColormap, resolveVideoDepthModelSize, resolveVideoDepthProvider, videoDepthColormaps, videoDepthCreditId, videoDepthLevers, videoDepthNeedsGrayscalePass } from '../chunk-
|
|
3
|
+
export { CLIP_PRICE_GRACE_SEC, FAL_VIDEO_DEPTH_PROVIDERS, REPLICATE_VIDEO_DEPTH_PROVIDERS, VIDEO_DEPTH_BUCKETS, VIDEO_DEPTH_COLORMAPS, VIDEO_DEPTH_LIMITS, VIDEO_DEPTH_MODEL_SIZES, VIDEO_DEPTH_PROVIDERS, VIDEO_DEPTH_RESOLUTIONS, checkVideoDepthLength, pricedClipSeconds, resolveVideoDepthColormap, resolveVideoDepthModelSize, resolveVideoDepthProvider, videoDepthColormaps, videoDepthCreditId, videoDepthLevers, videoDepthNeedsGrayscalePass } from '../chunk-6XVHYD5R.js';
|
|
4
4
|
export { OVERLAY_MAX_VARIANTS, OVERLAY_PLATFORMS, OVERLAY_PLATFORM_IDS, OVERLAY_VARIANT_HANDLE_PREFIX, overlayPlatformById, overlayVariantHandle, overlayVariantIdFromHandle } from '../chunk-5THUHJ3E.js';
|
|
5
5
|
//# sourceMappingURL=media.js.map
|
|
6
6
|
//# sourceMappingURL=media.js.map
|