@nodaro/sdk 2.68.2 → 2.70.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 (126) hide show
  1. package/dist/{chunk-KG4R454Z.js → chunk-25IKUIM3.js} +4 -3
  2. package/dist/chunk-25IKUIM3.js.map +1 -0
  3. package/dist/{chunk-PTH6ZUW3.cjs → chunk-4RPUONS5.cjs} +22 -22
  4. package/dist/{chunk-PTH6ZUW3.cjs.map → chunk-4RPUONS5.cjs.map} +1 -1
  5. package/dist/{chunk-3G65RIZS.cjs → chunk-5W4OCRFX.cjs} +66 -16
  6. package/dist/chunk-5W4OCRFX.cjs.map +1 -0
  7. package/dist/{chunk-FFT2YPB4.js → chunk-6SWRJJQE.js} +66 -16
  8. package/dist/chunk-6SWRJJQE.js.map +1 -0
  9. package/dist/{chunk-7CK6I4CT.cjs → chunk-7WS3VTUG.cjs} +2 -2
  10. package/dist/{chunk-7CK6I4CT.cjs.map → chunk-7WS3VTUG.cjs.map} +1 -1
  11. package/dist/{chunk-7FLTDTHR.cjs → chunk-BNJUMQQ3.cjs} +2 -2
  12. package/dist/chunk-BNJUMQQ3.cjs.map +1 -0
  13. package/dist/{chunk-QAVLYMGM.js → chunk-BY3XIXWC.js} +2 -2
  14. package/dist/chunk-BY3XIXWC.js.map +1 -0
  15. package/dist/{chunk-BPWUWUZ3.cjs → chunk-C4LXPSSF.cjs} +4 -3
  16. package/dist/chunk-C4LXPSSF.cjs.map +1 -0
  17. package/dist/{chunk-PUD5U3EN.cjs → chunk-C5GFDCK2.cjs} +2 -2
  18. package/dist/chunk-C5GFDCK2.cjs.map +1 -0
  19. package/dist/{chunk-PGT4BXR2.cjs → chunk-CAM74LQ2.cjs} +15 -4
  20. package/dist/chunk-CAM74LQ2.cjs.map +1 -0
  21. package/dist/{chunk-7UOEEYJ2.js → chunk-CGRH5UFG.js} +3 -3
  22. package/dist/{chunk-7UOEEYJ2.js.map → chunk-CGRH5UFG.js.map} +1 -1
  23. package/dist/{chunk-52V2G7SL.js → chunk-GKETMNEM.js} +12 -12
  24. package/dist/{chunk-52V2G7SL.js.map → chunk-GKETMNEM.js.map} +1 -1
  25. package/dist/{chunk-QXRV2IMW.cjs → chunk-HRFLEHSS.cjs} +2 -2
  26. package/dist/chunk-HRFLEHSS.cjs.map +1 -0
  27. package/dist/{chunk-5ZLGXVYV.js → chunk-HRW5IGJ2.js} +2 -2
  28. package/dist/chunk-HRW5IGJ2.js.map +1 -0
  29. package/dist/chunk-IWASCR2O.js +3 -0
  30. package/dist/{chunk-ZYPH2FPT.js.map → chunk-IWASCR2O.js.map} +1 -1
  31. package/dist/{chunk-OHC4JIUP.js → chunk-JAGTW35C.js} +15 -4
  32. package/dist/chunk-JAGTW35C.js.map +1 -0
  33. package/dist/{chunk-EP4J3TLQ.cjs → chunk-O4UXEIV6.cjs} +2 -2
  34. package/dist/chunk-O4UXEIV6.cjs.map +1 -0
  35. package/dist/{chunk-76YMDYMT.cjs → chunk-P7UT2YH4.cjs} +2 -2
  36. package/dist/chunk-P7UT2YH4.cjs.map +1 -0
  37. package/dist/{chunk-U6LEZT5B.js → chunk-R5DTFY73.js} +2 -2
  38. package/dist/chunk-R5DTFY73.js.map +1 -0
  39. package/dist/{chunk-CGSDEKJL.cjs → chunk-REXDUXL3.cjs} +3 -3
  40. package/dist/{chunk-CGSDEKJL.cjs.map → chunk-REXDUXL3.cjs.map} +1 -1
  41. package/dist/{chunk-AEUPH7EE.js → chunk-ROUCXQU3.js} +17 -2
  42. package/dist/chunk-ROUCXQU3.js.map +1 -0
  43. package/dist/{chunk-F3AV3TC7.js → chunk-UDRP64FX.js} +2 -2
  44. package/dist/chunk-UDRP64FX.js.map +1 -0
  45. package/dist/{chunk-Q45PC4YD.cjs → chunk-Z3RI7CSA.cjs} +17 -2
  46. package/dist/chunk-Z3RI7CSA.cjs.map +1 -0
  47. package/dist/{chunk-VS5JTLWE.js → chunk-ZMSGJC7L.js} +2 -2
  48. package/dist/chunk-ZMSGJC7L.js.map +1 -0
  49. package/dist/entries/audio.cjs +2 -2
  50. package/dist/entries/audio.d.cts +16 -3
  51. package/dist/entries/audio.d.ts +16 -3
  52. package/dist/entries/audio.js +1 -1
  53. package/dist/entries/catalogs.cjs +2 -2
  54. package/dist/entries/catalogs.d.cts +15 -4
  55. package/dist/entries/catalogs.d.ts +15 -4
  56. package/dist/entries/catalogs.js +1 -1
  57. package/dist/entries/characters.d.cts +1 -1
  58. package/dist/entries/characters.d.ts +1 -1
  59. package/dist/entries/client.cjs +16 -16
  60. package/dist/entries/client.d.cts +1 -1
  61. package/dist/entries/client.d.ts +1 -1
  62. package/dist/entries/client.js +11 -11
  63. package/dist/entries/core.cjs +5 -5
  64. package/dist/entries/core.js +1 -1
  65. package/dist/entries/creatures.d.cts +1 -1
  66. package/dist/entries/creatures.d.ts +1 -1
  67. package/dist/entries/credits.cjs +2 -2
  68. package/dist/entries/credits.d.cts +1 -1
  69. package/dist/entries/credits.d.ts +1 -1
  70. package/dist/entries/credits.js +1 -1
  71. package/dist/entries/jobs.cjs +2 -2
  72. package/dist/entries/jobs.d.cts +3 -1
  73. package/dist/entries/jobs.d.ts +3 -1
  74. package/dist/entries/jobs.js +1 -1
  75. package/dist/entries/locations.d.cts +1 -1
  76. package/dist/entries/locations.d.ts +1 -1
  77. package/dist/entries/media.cjs +2 -2
  78. package/dist/entries/media.d.cts +147 -18
  79. package/dist/entries/media.d.ts +147 -18
  80. package/dist/entries/media.js +1 -1
  81. package/dist/entries/models.cjs +2 -2
  82. package/dist/entries/models.d.cts +13 -4
  83. package/dist/entries/models.d.ts +13 -4
  84. package/dist/entries/models.js +1 -1
  85. package/dist/entries/node-presets.cjs +2 -2
  86. package/dist/entries/node-presets.d.cts +38 -1
  87. package/dist/entries/node-presets.d.ts +38 -1
  88. package/dist/entries/node-presets.js +1 -1
  89. package/dist/entries/nodes.cjs +5 -5
  90. package/dist/entries/nodes.d.cts +2 -2
  91. package/dist/entries/nodes.d.ts +2 -2
  92. package/dist/entries/nodes.js +2 -2
  93. package/dist/entries/objects.d.cts +1 -1
  94. package/dist/entries/objects.d.ts +1 -1
  95. package/dist/entries/picker-catalogs.cjs +2 -2
  96. package/dist/entries/picker-catalogs.d.cts +8 -0
  97. package/dist/entries/picker-catalogs.d.ts +8 -0
  98. package/dist/entries/picker-catalogs.js +1 -1
  99. package/dist/entries/scene3d.d.cts +2 -2
  100. package/dist/entries/scene3d.d.ts +2 -2
  101. package/dist/index.cjs +29 -29
  102. package/dist/index.d.cts +5 -5
  103. package/dist/index.d.ts +5 -5
  104. package/dist/index.js +12 -12
  105. package/dist/{nodes-BYgAjPlF.d.cts → nodes-BHl7gwUn.d.cts} +95 -20
  106. package/dist/{nodes-DC80OcWe.d.ts → nodes-C1pqCwkS.d.ts} +95 -20
  107. package/package.json +3 -3
  108. package/dist/chunk-3G65RIZS.cjs.map +0 -1
  109. package/dist/chunk-5ZLGXVYV.js.map +0 -1
  110. package/dist/chunk-76YMDYMT.cjs.map +0 -1
  111. package/dist/chunk-7FLTDTHR.cjs.map +0 -1
  112. package/dist/chunk-AEUPH7EE.js.map +0 -1
  113. package/dist/chunk-BPWUWUZ3.cjs.map +0 -1
  114. package/dist/chunk-EP4J3TLQ.cjs.map +0 -1
  115. package/dist/chunk-F3AV3TC7.js.map +0 -1
  116. package/dist/chunk-FFT2YPB4.js.map +0 -1
  117. package/dist/chunk-KG4R454Z.js.map +0 -1
  118. package/dist/chunk-OHC4JIUP.js.map +0 -1
  119. package/dist/chunk-PGT4BXR2.cjs.map +0 -1
  120. package/dist/chunk-PUD5U3EN.cjs.map +0 -1
  121. package/dist/chunk-Q45PC4YD.cjs.map +0 -1
  122. package/dist/chunk-QAVLYMGM.js.map +0 -1
  123. package/dist/chunk-QXRV2IMW.cjs.map +0 -1
  124. package/dist/chunk-U6LEZT5B.js.map +0 -1
  125. package/dist/chunk-VS5JTLWE.js.map +0 -1
  126. package/dist/chunk-ZYPH2FPT.js +0 -3
@@ -1,11 +1,23 @@
1
1
  import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
2
2
  import { OverlayAnchor, VideoMaskRequest, MaskCompositeRequest } from '@nodaro/shared/media';
3
3
  import { CaptionLookId, SupportedFontName, CaptionStyle } from '@nodaro/shared/captions';
4
- import { TranscribeLane } from '@nodaro/shared/models';
5
- export { TranscribeLane } from '@nodaro/shared/models';
4
+ import { CaptionTranscribeLane } from '@nodaro/shared/models';
5
+ export { CaptionTranscribeLane, TranscribeLane } from '@nodaro/shared/models';
6
6
  import { VideoOverlayRequest } from '@nodaro/shared/video';
7
+ import { l as GenerationSessionParams, L as RunNodeOptions } from '../nodes-BHl7gwUn.cjs';
7
8
  import '@nodaro/shared/apps';
8
9
  import '@nodaro/shared/organizations';
10
+ import '@nodaro/shared/types';
11
+ import '@nodaro/shared/nodes';
12
+ import '@nodaro/shared/social';
13
+ import '@nodaro/shared/scene3d';
14
+ import '@nodaro/shared/credits';
15
+ import '@nodaro/shared/entities';
16
+ import './jobs.cjs';
17
+ import './errors.cjs';
18
+ import '../studio-productions-CMiS827q.cjs';
19
+ import '@nodaro/shared/model-catalog';
20
+ import '@nodaro/prompts/prompt-builder';
9
21
 
10
22
  /** One word-timed caption entry (one per WORD for the kinetic styles). */
11
23
  interface CaptionEntry {
@@ -65,7 +77,8 @@ interface AddCaptionsInput extends CaptionLookInput {
65
77
  captions?: CaptionEntry[];
66
78
  /** Transcribe the video's audio when no text/captions are given (default true). */
67
79
  autoTranscribe?: boolean;
68
- transcribeProvider?: TranscribeLane;
80
+ /** The engine the render transcribes on — Add Captions' own lanes (a length-priced engine such as Nemotron 3.5 Transcribe is not one: transcribe with `audio.transcribe` and pass its `words` as `captions`). */
81
+ transcribeProvider?: CaptionTranscribeLane;
69
82
  style?: CaptionStyle;
70
83
  position?: "bottom" | "top" | "center";
71
84
  fontSize?: number;
@@ -380,6 +393,27 @@ declare class MediaResource {
380
393
  shotCuts(input: ShotCutsInput): Promise<{
381
394
  jobId: string;
382
395
  }>;
396
+ /**
397
+ * Split one image into a base picture and separate layers
398
+ * (`POST /v1/split-into-layers`): each element on its own transparent PNG,
399
+ * with its name, description, stacking order and the box it sits in on the
400
+ * base. `maxLayers` (1–99, default 9) caps the layers — more elements than
401
+ * that merge into fewer layers, none is dropped; `size` is each image's
402
+ * pixel budget (`1K` default, `auto` keeps the picture's own size between 1K
403
+ * and 2K); `prompt` names what to separate. A run holds the price of the
404
+ * most images it may return (`maxLayers` + 1, the base included) and is
405
+ * charged only for the images it returns: ask that price first with
406
+ * `client.nodes.quote("split-into-layers", input)` (nothing is started).
407
+ * Poll `jobs.get(jobId)`; the completed job's `output_data` is a
408
+ * {@link SplitIntoLayersOutput}. `sessionId` files the job in one of your
409
+ * sessions; `origin` tags it with your app's slug.
410
+ *
411
+ * With `options.idempotencyKey` (sent as the `Idempotency-Key` header, at
412
+ * least 8 characters) a retry of the same request answers the job it
413
+ * already started (`deduped: true`) instead of starting and charging a
414
+ * second one.
415
+ */
416
+ splitIntoLayers(input: SplitIntoLayersInput, options?: MediaRunOptions): Promise<MediaJobStarted>;
383
417
  /**
384
418
  * Turn one still image + one audio track into an MP4
385
419
  * (`POST /v1/still-to-video`) — locally rendered (FFmpeg), no AI model,
@@ -429,20 +463,42 @@ declare class MediaResource {
429
463
  jobId: string;
430
464
  }>;
431
465
  /**
432
- * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —
433
- * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept
434
- * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`
435
- * in seconds (no `end` = to the end of the video) and a placement: a
436
- * `preset` (`"card"`, `"corner-badge"` with a `corner`, `"full-frame"`) or
437
- * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary
438
- * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field
439
- * overrides the preset, and a layer with neither is a corner badge
440
- * (bottom-right, or the `corner` it names). `outputAspect` renders onto a
441
- * 16:9 / 9:16 / 1:1 / 4:5 canvas
442
- * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll
443
- * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,
444
- * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the
445
- * video's end, an animated image's first frame, re-encoded audio).
466
+ * Place 1–20 timed image or video layers over a video
467
+ * (`POST /v1/video-overlay`) — rendered locally (FFmpeg) in one pass, no AI.
468
+ * Each layer has exactly one source, `imageUrl` or `videoUrl` (at most 2
469
+ * video layers), a `start` and an optional `end` in seconds (no `end` = to
470
+ * the end of the video) and a placement: a `preset` (`"card"`,
471
+ * `"corner-badge"` with a `corner`, `"full-frame"`) or an explicit box in
472
+ * {@link MediaResource.imageOverlay}'s percent vocabulary (`anchor`, `x`,
473
+ * `y`, `width`, `height`, `fit`) — an explicit box field overrides the
474
+ * preset, and a layer with neither is a corner badge (bottom-right, or the
475
+ * `corner` it names). `animate` (a short fade in and out) defaults on for an
476
+ * image and off for a video.
477
+ *
478
+ * A video layer plays from its first frame at its `start`, stops at its
479
+ * `end` (or the base's end) and holds its last frame if it runs out first.
480
+ * It is silent unless it has `sound: { volume }` (0–1): its audio is then
481
+ * mixed with the base's during its window, under a limiter, as AAC. With no
482
+ * layer's sound on, the base audio is kept untouched.
483
+ *
484
+ * `outputAspect` renders onto a 16:9 / 9:16 / 1:1 / 4:5 canvas (`baseFit`
485
+ * cover by default; `backgroundColor` pads `contain`). `baseBox` places the
486
+ * base itself in a layer's box vocabulary (needs `outputAspect`; `anchor`
487
+ * and `width` are required, `x` and `y` default to 0 and `fit` to
488
+ * contain); the canvas it leaves uncovered shows `backgroundColor`. `layout` writes the boxes:
489
+ * `"video-bottom"` / `"video-top"` (the base whole, full width, against that
490
+ * edge), `"stack-whole"` / `"stack-filled"` (the base above the first video
491
+ * layer, both whole or each cropped to half the frame; no `baseBox`) and
492
+ * `"pip"` (the first video layer 30 % wide in its `corner`, default
493
+ * bottom-right). Every layout but `"pip"` needs `outputAspect`; the stacks
494
+ * and `"pip"` need a video layer.
495
+ *
496
+ * A run with a video layer takes a base of up to 60 s and is priced per
497
+ * started 5 s of it; an image-only run is one flat price. Poll
498
+ * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`,
499
+ * `width`, `height`, `durationSec` and `warnings[]` (a layer clipped or
500
+ * skipped at the video's end, an animated image's first frame, re-encoded
501
+ * audio, a video layer with sound on but no audio track).
446
502
  */
447
503
  videoOverlay(input: VideoOverlayRequest): Promise<{
448
504
  jobId: string;
@@ -666,6 +722,79 @@ interface ShotCutsOutput {
666
722
  /** With `frames`: each shot's last frame, in shot order. */
667
723
  lastFrames?: string[];
668
724
  }
725
+ /** A layer split's pixel budget per image: about one megapixel at `1K`; `auto` keeps the picture's own size (between 1K and 2K). */
726
+ type SplitIntoLayersSize = "1K" | "1.5K" | "2K" | "auto";
727
+ /** Per-call options of a media request that starts a job ({@link MediaResource.splitIntoLayers}). */
728
+ interface MediaRunOptions extends RunNodeOptions {
729
+ /** Abort the request. */
730
+ readonly signal?: AbortSignal;
731
+ /** This request's timeout in ms, in place of the client's `timeoutMs`. */
732
+ readonly timeoutMs?: number;
733
+ }
734
+ /** A media job started: its id, and `deduped: true` when an `Idempotency-Key` retry found the job already started. */
735
+ interface MediaJobStarted {
736
+ jobId: string;
737
+ deduped?: true;
738
+ }
739
+ /** Body of {@link MediaResource.splitIntoLayers} (`POST /v1/split-into-layers`), and of its quote (`nodes.quote("split-into-layers", …)`). */
740
+ interface SplitIntoLayersInput extends GenerationSessionParams {
741
+ /** The picture to split (an http or https URL). */
742
+ imageUrl: string;
743
+ /** "Max layers", 1–99 (default 9): more elements than this merge into fewer layers; none is dropped. */
744
+ maxLayers?: number;
745
+ /** Default `1K`. `1K` and `1.5K` are priced alike, as are `2K` and `auto`. */
746
+ size?: SplitIntoLayersSize;
747
+ /** What to separate (up to 2,000 characters): the elements to split out; `<bbox>x1 y1 x2 y2</bbox>` marks (0–1000) may be typed in it. Empty: the main elements are found automatically. */
748
+ prompt?: string;
749
+ }
750
+ /** A box on the base picture: `x1`/`y1` its top-left corner, `x2`/`y2` its bottom-right. */
751
+ interface SplitLayerBox {
752
+ x1: number;
753
+ y1: number;
754
+ x2: number;
755
+ y2: number;
756
+ }
757
+ /**
758
+ * One layer of a {@link SplitIntoLayersOutput}. A layer is NOT in the base's
759
+ * pixels: it is a transparent PNG cropped to its element, at about the size
760
+ * setting's pixel budget and the element's own shape. To put it back in place,
761
+ * scale it to its `box`.
762
+ */
763
+ interface SplitLayer {
764
+ name?: string;
765
+ description?: string;
766
+ /** Stacking order: 1 sits on the base, higher is drawn above. */
767
+ zIndex: number;
768
+ /** The layer file's own pixels (not the base's). */
769
+ width?: number;
770
+ height?: number;
771
+ /** Where the layer sits on the base picture, in the base's pixels. */
772
+ box?: SplitLayerBox;
773
+ /** The same box on a 0–1000 scale of the base's width and height. */
774
+ boxNormalized?: SplitLayerBox;
775
+ /** The layer's stored file. */
776
+ url: string;
777
+ /** The stored base picture this layer was cut from: the job's own `imageUrl`. */
778
+ baseUrl?: string;
779
+ }
780
+ /** A completed split-into-layers job's `output_data`. A run that finds no element returns the base only (`layers` empty). */
781
+ interface SplitIntoLayersOutput {
782
+ /** The base picture: an opaque PNG. */
783
+ imageUrl: string;
784
+ /** Each layer's stored file, bottom to top. */
785
+ layers: string[];
786
+ /** One entry per layer, in the same order. */
787
+ layerData: SplitLayer[];
788
+ /** The number of layers saved. */
789
+ layerCount: number;
790
+ /** Layers the model returned that could not be saved (each is tried a few times first); 0 when every layer was saved. The run is charged only for the images saved. */
791
+ layersNotSaved?: number;
792
+ /** Each layer as it was filed in the Library, under its name. */
793
+ libraryImages?: Array<{
794
+ url: string;
795
+ name?: string;
796
+ }>;
797
+ }
669
798
  interface MediaProcessInput {
670
799
  sourceUrl: string;
671
800
  type: "video" | "audio";
@@ -696,4 +825,4 @@ interface MediaProcessResult {
696
825
  metadata: Record<string, unknown>;
697
826
  }
698
827
 
699
- export { type AddCaptionsInput, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type DownloadVideoProgress, type MediaDiscardResult, type MediaProcessInput, type MediaProcessResult, MediaResource, type OverlayPlacement, type ShotCutsInput, type ShotCutsOutput, type ShotCutsResult, type ShotCutsShot, type SplitMediaByDurationInput, type SplitMediaByShotsInput, type SplitMediaInput, type SplitMediaOutput, type SplitMediaShot, type VideoMetadata };
828
+ export { type AddCaptionsInput, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type DownloadVideoProgress, type MediaDiscardResult, type MediaJobStarted, type MediaProcessInput, type MediaProcessResult, MediaResource, type MediaRunOptions, type OverlayPlacement, type ShotCutsInput, type ShotCutsOutput, type ShotCutsResult, type ShotCutsShot, type SplitIntoLayersInput, type SplitIntoLayersOutput, type SplitIntoLayersSize, type SplitLayer, type SplitLayerBox, type SplitMediaByDurationInput, type SplitMediaByShotsInput, type SplitMediaInput, type SplitMediaOutput, type SplitMediaShot, type VideoMetadata };
@@ -1,11 +1,23 @@
1
1
  import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
2
2
  import { OverlayAnchor, VideoMaskRequest, MaskCompositeRequest } from '@nodaro/shared/media';
3
3
  import { CaptionLookId, SupportedFontName, CaptionStyle } from '@nodaro/shared/captions';
4
- import { TranscribeLane } from '@nodaro/shared/models';
5
- export { TranscribeLane } from '@nodaro/shared/models';
4
+ import { CaptionTranscribeLane } from '@nodaro/shared/models';
5
+ export { CaptionTranscribeLane, TranscribeLane } from '@nodaro/shared/models';
6
6
  import { VideoOverlayRequest } from '@nodaro/shared/video';
7
+ import { l as GenerationSessionParams, L as RunNodeOptions } from '../nodes-C1pqCwkS.js';
7
8
  import '@nodaro/shared/apps';
8
9
  import '@nodaro/shared/organizations';
10
+ import '@nodaro/shared/types';
11
+ import '@nodaro/shared/nodes';
12
+ import '@nodaro/shared/social';
13
+ import '@nodaro/shared/scene3d';
14
+ import '@nodaro/shared/credits';
15
+ import '@nodaro/shared/entities';
16
+ import './jobs.js';
17
+ import './errors.js';
18
+ import '../studio-productions-DkI51Z9M.js';
19
+ import '@nodaro/shared/model-catalog';
20
+ import '@nodaro/prompts/prompt-builder';
9
21
 
10
22
  /** One word-timed caption entry (one per WORD for the kinetic styles). */
11
23
  interface CaptionEntry {
@@ -65,7 +77,8 @@ interface AddCaptionsInput extends CaptionLookInput {
65
77
  captions?: CaptionEntry[];
66
78
  /** Transcribe the video's audio when no text/captions are given (default true). */
67
79
  autoTranscribe?: boolean;
68
- transcribeProvider?: TranscribeLane;
80
+ /** The engine the render transcribes on — Add Captions' own lanes (a length-priced engine such as Nemotron 3.5 Transcribe is not one: transcribe with `audio.transcribe` and pass its `words` as `captions`). */
81
+ transcribeProvider?: CaptionTranscribeLane;
69
82
  style?: CaptionStyle;
70
83
  position?: "bottom" | "top" | "center";
71
84
  fontSize?: number;
@@ -380,6 +393,27 @@ declare class MediaResource {
380
393
  shotCuts(input: ShotCutsInput): Promise<{
381
394
  jobId: string;
382
395
  }>;
396
+ /**
397
+ * Split one image into a base picture and separate layers
398
+ * (`POST /v1/split-into-layers`): each element on its own transparent PNG,
399
+ * with its name, description, stacking order and the box it sits in on the
400
+ * base. `maxLayers` (1–99, default 9) caps the layers — more elements than
401
+ * that merge into fewer layers, none is dropped; `size` is each image's
402
+ * pixel budget (`1K` default, `auto` keeps the picture's own size between 1K
403
+ * and 2K); `prompt` names what to separate. A run holds the price of the
404
+ * most images it may return (`maxLayers` + 1, the base included) and is
405
+ * charged only for the images it returns: ask that price first with
406
+ * `client.nodes.quote("split-into-layers", input)` (nothing is started).
407
+ * Poll `jobs.get(jobId)`; the completed job's `output_data` is a
408
+ * {@link SplitIntoLayersOutput}. `sessionId` files the job in one of your
409
+ * sessions; `origin` tags it with your app's slug.
410
+ *
411
+ * With `options.idempotencyKey` (sent as the `Idempotency-Key` header, at
412
+ * least 8 characters) a retry of the same request answers the job it
413
+ * already started (`deduped: true`) instead of starting and charging a
414
+ * second one.
415
+ */
416
+ splitIntoLayers(input: SplitIntoLayersInput, options?: MediaRunOptions): Promise<MediaJobStarted>;
383
417
  /**
384
418
  * Turn one still image + one audio track into an MP4
385
419
  * (`POST /v1/still-to-video`) — locally rendered (FFmpeg), no AI model,
@@ -429,20 +463,42 @@ declare class MediaResource {
429
463
  jobId: string;
430
464
  }>;
431
465
  /**
432
- * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —
433
- * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept
434
- * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`
435
- * in seconds (no `end` = to the end of the video) and a placement: a
436
- * `preset` (`"card"`, `"corner-badge"` with a `corner`, `"full-frame"`) or
437
- * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary
438
- * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field
439
- * overrides the preset, and a layer with neither is a corner badge
440
- * (bottom-right, or the `corner` it names). `outputAspect` renders onto a
441
- * 16:9 / 9:16 / 1:1 / 4:5 canvas
442
- * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll
443
- * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,
444
- * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the
445
- * video's end, an animated image's first frame, re-encoded audio).
466
+ * Place 1–20 timed image or video layers over a video
467
+ * (`POST /v1/video-overlay`) — rendered locally (FFmpeg) in one pass, no AI.
468
+ * Each layer has exactly one source, `imageUrl` or `videoUrl` (at most 2
469
+ * video layers), a `start` and an optional `end` in seconds (no `end` = to
470
+ * the end of the video) and a placement: a `preset` (`"card"`,
471
+ * `"corner-badge"` with a `corner`, `"full-frame"`) or an explicit box in
472
+ * {@link MediaResource.imageOverlay}'s percent vocabulary (`anchor`, `x`,
473
+ * `y`, `width`, `height`, `fit`) — an explicit box field overrides the
474
+ * preset, and a layer with neither is a corner badge (bottom-right, or the
475
+ * `corner` it names). `animate` (a short fade in and out) defaults on for an
476
+ * image and off for a video.
477
+ *
478
+ * A video layer plays from its first frame at its `start`, stops at its
479
+ * `end` (or the base's end) and holds its last frame if it runs out first.
480
+ * It is silent unless it has `sound: { volume }` (0–1): its audio is then
481
+ * mixed with the base's during its window, under a limiter, as AAC. With no
482
+ * layer's sound on, the base audio is kept untouched.
483
+ *
484
+ * `outputAspect` renders onto a 16:9 / 9:16 / 1:1 / 4:5 canvas (`baseFit`
485
+ * cover by default; `backgroundColor` pads `contain`). `baseBox` places the
486
+ * base itself in a layer's box vocabulary (needs `outputAspect`; `anchor`
487
+ * and `width` are required, `x` and `y` default to 0 and `fit` to
488
+ * contain); the canvas it leaves uncovered shows `backgroundColor`. `layout` writes the boxes:
489
+ * `"video-bottom"` / `"video-top"` (the base whole, full width, against that
490
+ * edge), `"stack-whole"` / `"stack-filled"` (the base above the first video
491
+ * layer, both whole or each cropped to half the frame; no `baseBox`) and
492
+ * `"pip"` (the first video layer 30 % wide in its `corner`, default
493
+ * bottom-right). Every layout but `"pip"` needs `outputAspect`; the stacks
494
+ * and `"pip"` need a video layer.
495
+ *
496
+ * A run with a video layer takes a base of up to 60 s and is priced per
497
+ * started 5 s of it; an image-only run is one flat price. Poll
498
+ * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`,
499
+ * `width`, `height`, `durationSec` and `warnings[]` (a layer clipped or
500
+ * skipped at the video's end, an animated image's first frame, re-encoded
501
+ * audio, a video layer with sound on but no audio track).
446
502
  */
447
503
  videoOverlay(input: VideoOverlayRequest): Promise<{
448
504
  jobId: string;
@@ -666,6 +722,79 @@ interface ShotCutsOutput {
666
722
  /** With `frames`: each shot's last frame, in shot order. */
667
723
  lastFrames?: string[];
668
724
  }
725
+ /** A layer split's pixel budget per image: about one megapixel at `1K`; `auto` keeps the picture's own size (between 1K and 2K). */
726
+ type SplitIntoLayersSize = "1K" | "1.5K" | "2K" | "auto";
727
+ /** Per-call options of a media request that starts a job ({@link MediaResource.splitIntoLayers}). */
728
+ interface MediaRunOptions extends RunNodeOptions {
729
+ /** Abort the request. */
730
+ readonly signal?: AbortSignal;
731
+ /** This request's timeout in ms, in place of the client's `timeoutMs`. */
732
+ readonly timeoutMs?: number;
733
+ }
734
+ /** A media job started: its id, and `deduped: true` when an `Idempotency-Key` retry found the job already started. */
735
+ interface MediaJobStarted {
736
+ jobId: string;
737
+ deduped?: true;
738
+ }
739
+ /** Body of {@link MediaResource.splitIntoLayers} (`POST /v1/split-into-layers`), and of its quote (`nodes.quote("split-into-layers", …)`). */
740
+ interface SplitIntoLayersInput extends GenerationSessionParams {
741
+ /** The picture to split (an http or https URL). */
742
+ imageUrl: string;
743
+ /** "Max layers", 1–99 (default 9): more elements than this merge into fewer layers; none is dropped. */
744
+ maxLayers?: number;
745
+ /** Default `1K`. `1K` and `1.5K` are priced alike, as are `2K` and `auto`. */
746
+ size?: SplitIntoLayersSize;
747
+ /** What to separate (up to 2,000 characters): the elements to split out; `<bbox>x1 y1 x2 y2</bbox>` marks (0–1000) may be typed in it. Empty: the main elements are found automatically. */
748
+ prompt?: string;
749
+ }
750
+ /** A box on the base picture: `x1`/`y1` its top-left corner, `x2`/`y2` its bottom-right. */
751
+ interface SplitLayerBox {
752
+ x1: number;
753
+ y1: number;
754
+ x2: number;
755
+ y2: number;
756
+ }
757
+ /**
758
+ * One layer of a {@link SplitIntoLayersOutput}. A layer is NOT in the base's
759
+ * pixels: it is a transparent PNG cropped to its element, at about the size
760
+ * setting's pixel budget and the element's own shape. To put it back in place,
761
+ * scale it to its `box`.
762
+ */
763
+ interface SplitLayer {
764
+ name?: string;
765
+ description?: string;
766
+ /** Stacking order: 1 sits on the base, higher is drawn above. */
767
+ zIndex: number;
768
+ /** The layer file's own pixels (not the base's). */
769
+ width?: number;
770
+ height?: number;
771
+ /** Where the layer sits on the base picture, in the base's pixels. */
772
+ box?: SplitLayerBox;
773
+ /** The same box on a 0–1000 scale of the base's width and height. */
774
+ boxNormalized?: SplitLayerBox;
775
+ /** The layer's stored file. */
776
+ url: string;
777
+ /** The stored base picture this layer was cut from: the job's own `imageUrl`. */
778
+ baseUrl?: string;
779
+ }
780
+ /** A completed split-into-layers job's `output_data`. A run that finds no element returns the base only (`layers` empty). */
781
+ interface SplitIntoLayersOutput {
782
+ /** The base picture: an opaque PNG. */
783
+ imageUrl: string;
784
+ /** Each layer's stored file, bottom to top. */
785
+ layers: string[];
786
+ /** One entry per layer, in the same order. */
787
+ layerData: SplitLayer[];
788
+ /** The number of layers saved. */
789
+ layerCount: number;
790
+ /** Layers the model returned that could not be saved (each is tried a few times first); 0 when every layer was saved. The run is charged only for the images saved. */
791
+ layersNotSaved?: number;
792
+ /** Each layer as it was filed in the Library, under its name. */
793
+ libraryImages?: Array<{
794
+ url: string;
795
+ name?: string;
796
+ }>;
797
+ }
669
798
  interface MediaProcessInput {
670
799
  sourceUrl: string;
671
800
  type: "video" | "audio";
@@ -696,4 +825,4 @@ interface MediaProcessResult {
696
825
  metadata: Record<string, unknown>;
697
826
  }
698
827
 
699
- export { type AddCaptionsInput, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type DownloadVideoProgress, type MediaDiscardResult, type MediaProcessInput, type MediaProcessResult, MediaResource, type OverlayPlacement, type ShotCutsInput, type ShotCutsOutput, type ShotCutsResult, type ShotCutsShot, type SplitMediaByDurationInput, type SplitMediaByShotsInput, type SplitMediaInput, type SplitMediaOutput, type SplitMediaShot, type VideoMetadata };
828
+ export { type AddCaptionsInput, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type DownloadVideoProgress, type MediaDiscardResult, type MediaJobStarted, type MediaProcessInput, type MediaProcessResult, MediaResource, type MediaRunOptions, type OverlayPlacement, type ShotCutsInput, type ShotCutsOutput, type ShotCutsResult, type ShotCutsShot, type SplitIntoLayersInput, type SplitIntoLayersOutput, type SplitIntoLayersSize, type SplitLayer, type SplitLayerBox, type SplitMediaByDurationInput, type SplitMediaByShotsInput, type SplitMediaInput, type SplitMediaOutput, type SplitMediaShot, type VideoMetadata };
@@ -1,5 +1,5 @@
1
1
  import '../chunk-ES2E65HT.js';
2
- export { MediaResource } from '../chunk-FFT2YPB4.js';
2
+ export { MediaResource } from '../chunk-6SWRJJQE.js';
3
3
  import '../chunk-SZ67PDKE.js';
4
4
  import '../chunk-IJAJTVEW.js';
5
5
  //# sourceMappingURL=media.js.map
@@ -1,13 +1,13 @@
1
1
  'use strict';
2
2
 
3
3
  require('../chunk-QUFU5RJ7.cjs');
4
- var chunk76YMDYMT_cjs = require('../chunk-76YMDYMT.cjs');
4
+ var chunkP7UT2YH4_cjs = require('../chunk-P7UT2YH4.cjs');
5
5
 
6
6
 
7
7
 
8
8
  Object.defineProperty(exports, "ModelsResource", {
9
9
  enumerable: true,
10
- get: function () { return chunk76YMDYMT_cjs.ModelsResource; }
10
+ get: function () { return chunkP7UT2YH4_cjs.ModelsResource; }
11
11
  });
12
12
  //# sourceMappingURL=models.cjs.map
13
13
  //# sourceMappingURL=models.cjs.map
@@ -23,13 +23,15 @@ interface ModelSummary {
23
23
  /** The company that made the model. Not the same as the family it is
24
24
  * grouped under: a few families name a lab or a product line (Tongyi-MAI
25
25
  * and HappyHorse are Alibaba's, Depth Anything is ByteDance's). Absent on
26
- * an older server. */
26
+ * a model the instance offers under its own label (it names no maker), and
27
+ * on an older server. */
27
28
  maker?: ModelMaker;
28
29
  /** The maker's official mark (an SVG) on this deployment's media CDN, or
29
30
  * null when the deployment does not publish one for this maker — draw a
30
- * fallback (the maker's name or initial) then. The address carries its
31
- * file's version, so a replaced mark arrives under a new address. Absent
32
- * on an older server. */
31
+ * fallback (the maker's name or initial) then — and null for a model the
32
+ * instance offers under its own label (it names no maker). The address
33
+ * carries its file's version, so a replaced mark arrives under a new
34
+ * address. Absent on an older server. */
33
35
  logoUrl?: string | null;
34
36
  description: string;
35
37
  modes: string[];
@@ -100,6 +102,13 @@ interface ModelSummary {
100
102
  defaultDuration?: number;
101
103
  /** `true` when the model accepts `duration: -1`: it picks the length itself. */
102
104
  autoDuration?: true;
105
+ /**
106
+ * The values `referenceTaskType` takes on this model (what a request's
107
+ * reference media is for): `["reference", "edit", "extend"]` on
108
+ * `seedance-2-5`. Absent on a model that takes none (and on an older
109
+ * server); `"auto"`, the default, is never listed.
110
+ */
111
+ referenceTaskTypes?: Array<"reference" | "edit" | "extend">;
103
112
  /** Compact per-model prompting tips (present when a doctrine exists). */
104
113
  promptTips?: string[];
105
114
  /** TRUE only when a sourced per-family prompt doctrine exists for this
@@ -23,13 +23,15 @@ interface ModelSummary {
23
23
  /** The company that made the model. Not the same as the family it is
24
24
  * grouped under: a few families name a lab or a product line (Tongyi-MAI
25
25
  * and HappyHorse are Alibaba's, Depth Anything is ByteDance's). Absent on
26
- * an older server. */
26
+ * a model the instance offers under its own label (it names no maker), and
27
+ * on an older server. */
27
28
  maker?: ModelMaker;
28
29
  /** The maker's official mark (an SVG) on this deployment's media CDN, or
29
30
  * null when the deployment does not publish one for this maker — draw a
30
- * fallback (the maker's name or initial) then. The address carries its
31
- * file's version, so a replaced mark arrives under a new address. Absent
32
- * on an older server. */
31
+ * fallback (the maker's name or initial) then — and null for a model the
32
+ * instance offers under its own label (it names no maker). The address
33
+ * carries its file's version, so a replaced mark arrives under a new
34
+ * address. Absent on an older server. */
33
35
  logoUrl?: string | null;
34
36
  description: string;
35
37
  modes: string[];
@@ -100,6 +102,13 @@ interface ModelSummary {
100
102
  defaultDuration?: number;
101
103
  /** `true` when the model accepts `duration: -1`: it picks the length itself. */
102
104
  autoDuration?: true;
105
+ /**
106
+ * The values `referenceTaskType` takes on this model (what a request's
107
+ * reference media is for): `["reference", "edit", "extend"]` on
108
+ * `seedance-2-5`. Absent on a model that takes none (and on an older
109
+ * server); `"auto"`, the default, is never listed.
110
+ */
111
+ referenceTaskTypes?: Array<"reference" | "edit" | "extend">;
103
112
  /** Compact per-model prompting tips (present when a doctrine exists). */
104
113
  promptTips?: string[];
105
114
  /** TRUE only when a sourced per-family prompt doctrine exists for this
@@ -1,4 +1,4 @@
1
1
  import '../chunk-OMH7ATOQ.js';
2
- export { ModelsResource } from '../chunk-VS5JTLWE.js';
2
+ export { ModelsResource } from '../chunk-ZMSGJC7L.js';
3
3
  //# sourceMappingURL=models.js.map
4
4
  //# sourceMappingURL=models.js.map
@@ -1,13 +1,13 @@
1
1
  'use strict';
2
2
 
3
3
  require('../chunk-RA42NMWV.cjs');
4
- var chunkQ45PC4YD_cjs = require('../chunk-Q45PC4YD.cjs');
4
+ var chunkZ3RI7CSA_cjs = require('../chunk-Z3RI7CSA.cjs');
5
5
 
6
6
 
7
7
 
8
8
  Object.defineProperty(exports, "PresetsResource", {
9
9
  enumerable: true,
10
- get: function () { return chunkQ45PC4YD_cjs.PresetsResource; }
10
+ get: function () { return chunkZ3RI7CSA_cjs.PresetsResource; }
11
11
  });
12
12
  //# sourceMappingURL=node-presets.cjs.map
13
13
  //# sourceMappingURL=node-presets.cjs.map
@@ -64,6 +64,14 @@ interface FactoryPresetEntry extends FactoryPreset {
64
64
  * preset has both; absent from servers that predate it.
65
65
  */
66
66
  previewSrcSet?: string;
67
+ /**
68
+ * The tile picture's real width and height (`previewUrl`'s), so a client
69
+ * draws it in a box of its own shape before it loads — a preset's
70
+ * `data.aspectRatio` is what it generates, not always its picture's shape.
71
+ * Present for a built-in picture; absent from servers that predate it.
72
+ */
73
+ previewWidth?: number;
74
+ previewHeight?: number;
67
75
  }
68
76
  /**
69
77
  * Result of `GET /v1/node-presets/factory` — the built-in (factory) catalog for
@@ -72,6 +80,26 @@ interface FactoryPresetEntry extends FactoryPreset {
72
80
  interface FactoryPresetsResult {
73
81
  data: FactoryPresetEntry[];
74
82
  }
83
+ /**
84
+ * One category (group) of the built-in catalog, as `listFactoryGroups()` lists
85
+ * it: enough to show the categories (a menu, a shelf) without the whole catalog.
86
+ */
87
+ interface FactoryPresetGroupSummary {
88
+ /** The group's name, as the presets carry it (`FactoryPresetEntry.group`). */
89
+ group: string;
90
+ /**
91
+ * The shelf a picker files it under: `"video"`, `"marketing"`, `"photos"`,
92
+ * `"creative"`, `"life"`, `"pro"` (the pro catalog), or `"more"` (a group no
93
+ * shelf names yet). Shown in that order.
94
+ */
95
+ shelf: string;
96
+ /** How many presets it holds. */
97
+ count: number;
98
+ /** The example picture of its first preset that has one, or null. */
99
+ previewUrl: string | null;
100
+ /** Its first example pictures, in catalog order, each once: at most three (empty when none has one). */
101
+ previewUrls: string[];
102
+ }
75
103
  /** `POST /v1/node-presets` body. */
76
104
  interface CreateNodePresetInput {
77
105
  /** The node type the preset configures, e.g. `"generate-image"`. */
@@ -172,6 +200,15 @@ declare class PresetsResource {
172
200
  * when they generate. Your OWN presets (`list()`) still need a token.
173
201
  */
174
202
  listFactory(nodeType: string): Promise<FactoryPresetsResult>;
203
+ /**
204
+ * `GET /v1/node-presets/factory/groups` → the built-in catalog's categories for
205
+ * `nodeType`, in the order a picker shows them (shelf by shelf, then the
206
+ * design's order, then catalog order): each group's name, its shelf, how many
207
+ * presets it holds and its first example picture. A few KB where `listFactory()` is the
208
+ * whole catalog: for a menu or a shelf that lists the categories. Public, as
209
+ * `listFactory()` is: no credential needed.
210
+ */
211
+ listFactoryGroups(nodeType: string): Promise<FactoryPresetGroupSummary[]>;
175
212
  /** `POST /v1/node-presets` → the new preset. */
176
213
  create(input: CreateNodePresetInput): Promise<NodePreset>;
177
214
  /**
@@ -220,4 +257,4 @@ declare class PresetsResource {
220
257
  }>;
221
258
  }
222
259
 
223
- export { type CreateNodePresetGroupInput, type CreateNodePresetInput, type FactoryPresetEntry, type FactoryPresetsResult, type ImportNodePresetInput, type NodePreset, type NodePresetFavoriteInput, type NodePresetGroup, PresetsResource, type ReorderNodePresetsInput, type UpdateNodePresetGroupInput, type UpdateNodePresetInput };
260
+ export { type CreateNodePresetGroupInput, type CreateNodePresetInput, type FactoryPresetEntry, type FactoryPresetGroupSummary, type FactoryPresetsResult, type ImportNodePresetInput, type NodePreset, type NodePresetFavoriteInput, type NodePresetGroup, PresetsResource, type ReorderNodePresetsInput, type UpdateNodePresetGroupInput, type UpdateNodePresetInput };