@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.
Files changed (146) hide show
  1. package/dist/{chunk-6CVY3345.js → chunk-25KAGSPT.js} +3 -3
  2. package/dist/{chunk-6CVY3345.js.map → chunk-25KAGSPT.js.map} +1 -1
  3. package/dist/{chunk-FBLMWA2R.cjs → chunk-2OYV6K7D.cjs} +4 -4
  4. package/dist/{chunk-FBLMWA2R.cjs.map → chunk-2OYV6K7D.cjs.map} +1 -1
  5. package/dist/{chunk-J3HPEKGJ.cjs → chunk-2R74OU76.cjs} +23 -23
  6. package/dist/chunk-2R74OU76.cjs.map +1 -0
  7. package/dist/{chunk-CSPELPDB.cjs → chunk-3633VD2M.cjs} +8 -8
  8. package/dist/{chunk-CSPELPDB.cjs.map → chunk-3633VD2M.cjs.map} +1 -1
  9. package/dist/{chunk-A24LLEXS.js → chunk-3CHOZ573.js} +23 -23
  10. package/dist/chunk-3CHOZ573.js.map +1 -0
  11. package/dist/{chunk-IJ6XNHSD.cjs → chunk-3GMTGX3D.cjs} +27 -27
  12. package/dist/{chunk-IJ6XNHSD.cjs.map → chunk-3GMTGX3D.cjs.map} +1 -1
  13. package/dist/{chunk-AJFQ5242.js → chunk-5DVDHL7Y.js} +5 -5
  14. package/dist/{chunk-AJFQ5242.js.map → chunk-5DVDHL7Y.js.map} +1 -1
  15. package/dist/{chunk-VNHX6TQT.cjs → chunk-5R6LTKE5.cjs} +5 -5
  16. package/dist/{chunk-VNHX6TQT.cjs.map → chunk-5R6LTKE5.cjs.map} +1 -1
  17. package/dist/{chunk-YOH5AUYL.js → chunk-6UR5UE5G.js} +9 -9
  18. package/dist/{chunk-YOH5AUYL.js.map → chunk-6UR5UE5G.js.map} +1 -1
  19. package/dist/{chunk-3RYKIUAE.js → chunk-6XVHYD5R.js} +12 -8
  20. package/dist/chunk-6XVHYD5R.js.map +1 -0
  21. package/dist/{chunk-FRXVOYL2.js → chunk-ADWIAQQS.js} +3 -3
  22. package/dist/{chunk-FRXVOYL2.js.map → chunk-ADWIAQQS.js.map} +1 -1
  23. package/dist/{chunk-VLNOQJDO.cjs → chunk-AGTCHDG5.cjs} +6 -6
  24. package/dist/{chunk-VLNOQJDO.cjs.map → chunk-AGTCHDG5.cjs.map} +1 -1
  25. package/dist/{chunk-MI63SSCJ.cjs → chunk-ATWLKUAI.cjs} +4 -4
  26. package/dist/{chunk-MI63SSCJ.cjs.map → chunk-ATWLKUAI.cjs.map} +1 -1
  27. package/dist/{chunk-FIROF3TM.js → chunk-C5S75476.js} +5 -5
  28. package/dist/{chunk-FIROF3TM.js.map → chunk-C5S75476.js.map} +1 -1
  29. package/dist/{chunk-7HWXJIQ6.cjs → chunk-C6IQCKJT.cjs} +4 -4
  30. package/dist/{chunk-7HWXJIQ6.cjs.map → chunk-C6IQCKJT.cjs.map} +1 -1
  31. package/dist/{chunk-K3QNGRRX.js → chunk-CZCOL3M5.js} +10 -6
  32. package/dist/chunk-CZCOL3M5.js.map +1 -0
  33. package/dist/{chunk-JAGYUDOK.js → chunk-DUL5ZLTJ.js} +3 -3
  34. package/dist/{chunk-JAGYUDOK.js.map → chunk-DUL5ZLTJ.js.map} +1 -1
  35. package/dist/{chunk-BG5272F5.js → chunk-E4YES25K.js} +4 -4
  36. package/dist/{chunk-BG5272F5.js.map → chunk-E4YES25K.js.map} +1 -1
  37. package/dist/{chunk-QBXC3AXS.cjs → chunk-FIYVKW7F.cjs} +12 -12
  38. package/dist/{chunk-QBXC3AXS.cjs.map → chunk-FIYVKW7F.cjs.map} +1 -1
  39. package/dist/{chunk-CQJYKSXF.js → chunk-FVVD6XY2.js} +5 -3
  40. package/dist/chunk-FVVD6XY2.js.map +1 -0
  41. package/dist/chunk-HD45Y7QU.cjs +27 -0
  42. package/dist/{chunk-H7HKLN2W.cjs.map → chunk-HD45Y7QU.cjs.map} +1 -1
  43. package/dist/{chunk-JAD2SBD4.js → chunk-HEF4BIMA.js} +4 -4
  44. package/dist/{chunk-JAD2SBD4.js.map → chunk-HEF4BIMA.js.map} +1 -1
  45. package/dist/{chunk-GL5Z3CC4.js → chunk-HG3KKCJJ.js} +3 -3
  46. package/dist/{chunk-GL5Z3CC4.js.map → chunk-HG3KKCJJ.js.map} +1 -1
  47. package/dist/{chunk-MI6CZQCG.cjs → chunk-IPCWYKX5.cjs} +45 -45
  48. package/dist/{chunk-MI6CZQCG.cjs.map → chunk-IPCWYKX5.cjs.map} +1 -1
  49. package/dist/{chunk-7YFQKR5C.cjs → chunk-KM35K2M5.cjs} +21 -21
  50. package/dist/{chunk-7YFQKR5C.cjs.map → chunk-KM35K2M5.cjs.map} +1 -1
  51. package/dist/{chunk-OWVWV4T2.js → chunk-KMSEU6FK.js} +3 -3
  52. package/dist/{chunk-OWVWV4T2.js.map → chunk-KMSEU6FK.js.map} +1 -1
  53. package/dist/{chunk-2LNQ2MDO.js → chunk-LYWJAXPT.js} +3 -3
  54. package/dist/{chunk-2LNQ2MDO.js.map → chunk-LYWJAXPT.js.map} +1 -1
  55. package/dist/{chunk-6DAWSVX2.cjs → chunk-M3SXUUWC.cjs} +13 -7
  56. package/dist/chunk-M3SXUUWC.cjs.map +1 -0
  57. package/dist/{chunk-JZJRD7RG.js → chunk-MGJR5OXO.js} +5 -5
  58. package/dist/{chunk-JZJRD7RG.js.map → chunk-MGJR5OXO.js.map} +1 -1
  59. package/dist/{chunk-AVUW7XKP.cjs → chunk-MTUNORQB.cjs} +11 -11
  60. package/dist/{chunk-AVUW7XKP.cjs.map → chunk-MTUNORQB.cjs.map} +1 -1
  61. package/dist/{chunk-6LCZPDIF.js → chunk-N3WL6IOJ.js} +3 -3
  62. package/dist/{chunk-6LCZPDIF.js.map → chunk-N3WL6IOJ.js.map} +1 -1
  63. package/dist/{chunk-XRXPWW7P.cjs → chunk-ND3IE3IB.cjs} +47 -47
  64. package/dist/{chunk-XRXPWW7P.cjs.map → chunk-ND3IE3IB.cjs.map} +1 -1
  65. package/dist/{chunk-34EXMNOX.cjs → chunk-NEIWY6CC.cjs} +6 -6
  66. package/dist/{chunk-34EXMNOX.cjs.map → chunk-NEIWY6CC.cjs.map} +1 -1
  67. package/dist/{chunk-AJPV3RZJ.js → chunk-NMX6HQC3.js} +5 -5
  68. package/dist/{chunk-AJPV3RZJ.js.map → chunk-NMX6HQC3.js.map} +1 -1
  69. package/dist/{chunk-66GADQRV.cjs → chunk-OVIIJVXH.cjs} +21 -21
  70. package/dist/{chunk-66GADQRV.cjs.map → chunk-OVIIJVXH.cjs.map} +1 -1
  71. package/dist/{chunk-5PCI6M44.cjs → chunk-PONP5J5E.cjs} +5 -3
  72. package/dist/chunk-PONP5J5E.cjs.map +1 -0
  73. package/dist/{chunk-ETU6NWE2.cjs → chunk-QP5JLSCJ.cjs} +10 -6
  74. package/dist/chunk-QP5JLSCJ.cjs.map +1 -0
  75. package/dist/{chunk-SRLWSI6Q.cjs → chunk-SEEQ3H22.cjs} +5 -5
  76. package/dist/{chunk-SRLWSI6Q.cjs.map → chunk-SEEQ3H22.cjs.map} +1 -1
  77. package/dist/{chunk-25OWMP6B.cjs → chunk-SZUDEFX2.cjs} +41 -41
  78. package/dist/{chunk-25OWMP6B.cjs.map → chunk-SZUDEFX2.cjs.map} +1 -1
  79. package/dist/{chunk-TRZMLQSL.js → chunk-YBZQXZ6A.js} +3 -3
  80. package/dist/{chunk-TRZMLQSL.js.map → chunk-YBZQXZ6A.js.map} +1 -1
  81. package/dist/{chunk-WBPJNXYN.js → chunk-ZKHQSG76.js} +4 -4
  82. package/dist/{chunk-WBPJNXYN.js.map → chunk-ZKHQSG76.js.map} +1 -1
  83. package/dist/{chunk-VSNQLSME.js → chunk-ZWB3NG4M.js} +3 -3
  84. package/dist/{chunk-VSNQLSME.js.map → chunk-ZWB3NG4M.js.map} +1 -1
  85. package/dist/entries/apps.cjs +43 -43
  86. package/dist/entries/apps.js +8 -8
  87. package/dist/entries/credits.cjs +150 -150
  88. package/dist/entries/credits.js +7 -7
  89. package/dist/entries/media.cjs +81 -73
  90. package/dist/entries/media.d.cts +60 -80
  91. package/dist/entries/media.d.ts +60 -80
  92. package/dist/entries/media.js +2 -2
  93. package/dist/entries/model-catalog.cjs +66 -66
  94. package/dist/entries/model-catalog.js +4 -4
  95. package/dist/entries/models.cjs +277 -277
  96. package/dist/entries/models.js +5 -5
  97. package/dist/entries/nodes.cjs +207 -207
  98. package/dist/entries/nodes.js +9 -9
  99. package/dist/entries/pipeline.cjs +149 -149
  100. package/dist/entries/pipeline.js +3 -3
  101. package/dist/entries/types.d.cts +13 -0
  102. package/dist/entries/types.d.ts +13 -0
  103. package/dist/entries/ugc.cjs +71 -71
  104. package/dist/entries/ugc.js +4 -4
  105. package/dist/entries/video.cjs +117 -117
  106. package/dist/entries/video.js +4 -4
  107. package/dist/entries/workflow.cjs +99 -99
  108. package/dist/entries/workflow.js +2 -2
  109. package/dist/index.cjs +1233 -1225
  110. package/dist/index.d.cts +1 -1
  111. package/dist/index.d.ts +1 -1
  112. package/dist/index.js +21 -21
  113. package/package.json +1 -1
  114. package/src/__tests__/priced-clip-seconds.test.ts +193 -0
  115. package/src/__tests__/video-depth.test.ts +61 -19
  116. package/src/__tests__/video-face-mesh.test.ts +3 -2
  117. package/src/__tests__/video-mask.test.ts +1 -1
  118. package/src/catalog-projection.ts +13 -0
  119. package/src/entries/media.ts +1 -0
  120. package/src/generated/unit-contracts.ts +1 -0
  121. package/src/i18n/style.ar.ts +5 -0
  122. package/src/i18n/style.de.ts +5 -0
  123. package/src/i18n/style.es.ts +5 -0
  124. package/src/i18n/style.fr.ts +5 -0
  125. package/src/i18n/style.he.ts +5 -0
  126. package/src/i18n/style.hi.ts +5 -0
  127. package/src/i18n/style.ja.ts +5 -0
  128. package/src/i18n/style.ko.ts +5 -0
  129. package/src/i18n/style.pt-BR.ts +5 -0
  130. package/src/i18n/style.ru.ts +5 -0
  131. package/src/i18n/style.zh-CN.ts +5 -0
  132. package/src/mask-composite.ts +6 -5
  133. package/src/model-catalog.ts +21 -21
  134. package/src/priced-clip-seconds.ts +28 -0
  135. package/src/video-depth.ts +25 -12
  136. package/src/video-face-mesh.ts +10 -4
  137. package/src/video-mask.ts +12 -7
  138. package/dist/chunk-3RYKIUAE.js.map +0 -1
  139. package/dist/chunk-5PCI6M44.cjs.map +0 -1
  140. package/dist/chunk-6DAWSVX2.cjs.map +0 -1
  141. package/dist/chunk-A24LLEXS.js.map +0 -1
  142. package/dist/chunk-CQJYKSXF.js.map +0 -1
  143. package/dist/chunk-ETU6NWE2.cjs.map +0 -1
  144. package/dist/chunk-H7HKLN2W.cjs +0 -27
  145. package/dist/chunk-J3HPEKGJ.cjs.map +0 -1
  146. package/dist/chunk-K3QNGRRX.js.map +0 -1
@@ -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. Worked examples (repeated in
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
- * 5 s → `:15s`, 15 s → `:15s`, 15.01 s → `:30s`, 61 s → `:120s`.
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: the top price bucket (a low-fps clip under the frame limit can otherwise run past every price row). */
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`. Unknown, non-positive or longer
132
- * than the provider accepts → the provider's highest REACHABLE row: the
133
- * smallest bucket at or above its longest clip (Replicate 80 s → `:120s`,
134
- * fal 300 s → `:300s`) — the most a run on it can be charged, never a row a
135
- * run could not reach.
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. An unknown or
459
- * non-positive length prices the LONGEST row (a clip the route could not
460
- * measure is refused, so this is only the pre-run quote for a clip whose
461
- * length is not known yet); anything past the cap prices the last row.
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-02";
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. An unknown or non-positive length, or one past the cap,
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. An unknown length counts the longest result a run accepts
729
- * (an upper bound — the pre-run quote for a clip whose length is not known
730
- * yet; every run measures its foreground).
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 };
@@ -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. Worked examples (repeated in
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
- * 5 s → `:15s`, 15 s → `:15s`, 15.01 s → `:30s`, 61 s → `:120s`.
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: the top price bucket (a low-fps clip under the frame limit can otherwise run past every price row). */
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`. Unknown, non-positive or longer
132
- * than the provider accepts → the provider's highest REACHABLE row: the
133
- * smallest bucket at or above its longest clip (Replicate 80 s → `:120s`,
134
- * fal 300 s → `:300s`) — the most a run on it can be charged, never a row a
135
- * run could not reach.
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. An unknown or
459
- * non-positive length prices the LONGEST row (a clip the route could not
460
- * measure is refused, so this is only the pre-run quote for a clip whose
461
- * length is not known yet); anything past the cap prices the last row.
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-02";
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. An unknown or non-positive length, or one past the cap,
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. An unknown length counts the longest result a run accepts
729
- * (an upper bound — the pre-run quote for a clip whose length is not known
730
- * yet; every run measures its foreground).
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 };
@@ -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-K3QNGRRX.js';
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-3RYKIUAE.js';
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