@nodaro/sdk 2.53.1 → 2.54.0

package/dist/entries/locations.d.cts

@@ -1,7 +1,8 @@
 import { LocationAssetType, CharacterAspectRatio, LocationAttachColumn, SurroundDirection } from '@nodaro/shared/entities';
 export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, SURROUND_DIRECTIONS, SurroundDirection } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
-import { l as GenerationSessionParams } from '../nodes-DGIefTze.cjs';
+import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.cjs';
+import { l as GenerationSessionParams } from '../nodes-bY51Z1Os.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';
@@ -493,6 +494,13 @@ declare class LocationsResource {
         id: string;
         name: string;
     }>;
+    /**
+     * Admin only: put one of your own locations on the shared Nodaro Keepers
+     * shelf (`client.keepers.catalog()`), or take it off. A first-party session
+     * or your personal token; `forbidden` for anyone who is not a platform
+     * admin, `not_found` for a row that is not yours.
+     */
+    setCatalog(id: string, input: SetKeeperCatalogInput): Promise<SetKeeperCatalogResult>;
     /**
      * Fire `POST /v1/generate-location` to produce one or more candidate main
      * images. With `count > 1`, all jobs are reserved up-front before any

package/dist/entries/locations.d.ts

@@ -1,7 +1,8 @@
 import { LocationAssetType, CharacterAspectRatio, LocationAttachColumn, SurroundDirection } from '@nodaro/shared/entities';
 export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, SURROUND_DIRECTIONS, SurroundDirection } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
-import { l as GenerationSessionParams } from '../nodes-C9j0PFto.js';
+import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.js';
+import { l as GenerationSessionParams } from '../nodes-DuXF6XVv.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';
@@ -493,6 +494,13 @@ declare class LocationsResource {
         id: string;
         name: string;
     }>;
+    /**
+     * Admin only: put one of your own locations on the shared Nodaro Keepers
+     * shelf (`client.keepers.catalog()`), or take it off. A first-party session
+     * or your personal token; `forbidden` for anyone who is not a platform
+     * admin, `not_found` for a row that is not yours.
+     */
+    setCatalog(id: string, input: SetKeeperCatalogInput): Promise<SetKeeperCatalogResult>;
     /**
      * Fire `POST /v1/generate-location` to produce one or more candidate main
      * images. With `count > 1`, all jobs are reserved up-front before any

package/dist/entries/locations.js

@@ -1,4 +1,4 @@
 import '../chunk-HFBR6G36.js';
-export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationsResource, SURROUND_DIRECTIONS } from '../chunk-TVENC6PH.js';
+export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationsResource, SURROUND_DIRECTIONS } from '../chunk-I3MEBVLP.js';
 //# sourceMappingURL=locations.js.map
 //# sourceMappingURL=locations.js.map

package/dist/entries/nodes.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunk7CK6I4CT_cjs = require('../chunk-7CK6I4CT.cjs');
-var chunkTK2CEVSK_cjs = require('../chunk-TK2CEVSK.cjs');
+var chunkVHTDOACT_cjs = require('../chunk-VHTDOACT.cjs');
 require('../chunk-FM2KM5TY.cjs');
 
 
@@ -16,7 +16,7 @@ Object.defineProperty(exports, "PROMPT_SUFFIX_KEY", {
 });
 Object.defineProperty(exports, "NodesResource", {
   enumerable: true,
-  get: function () { return chunkTK2CEVSK_cjs.NodesResource; }
+  get: function () { return chunkVHTDOACT_cjs.NodesResource; }
 });
 //# sourceMappingURL=nodes.cjs.map
 //# sourceMappingURL=nodes.cjs.map

package/dist/entries/nodes.d.cts

@@ -4,7 +4,7 @@ export { GeminiOmniVoicePresetId, ImageAspectRatio, ImageEditProvider, ImageEdit
 export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PromptAffixFields } from '@nodaro/shared/nodes';
 export { SocialPlatform, SocialPost, SocialPostAuthor, SocialPostMedia, SocialPostMetrics, SocialSearchCount, SocialSearchMode, SocialSearchParams, SocialSearchPeriod, SocialSearchSort, SocialSearchVideoKind } from '@nodaro/shared/social';
 export { GenerateMaskOutput, GenerateMaskRequest, VideoDepthColormap, VideoDepthModelSize, VideoDepthProvider, VideoDepthResolution } from '@nodaro/shared/media';
-export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-DGIefTze.cjs';
+export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-bY51Z1Os.cjs';
 export { TopazUpscaleFactor } from '@nodaro/shared/credits';
 export { ImageToImageAttachColumn } from '@nodaro/shared/entities';
 import '@nodaro/shared/scene3d';

package/dist/entries/nodes.d.ts

@@ -4,7 +4,7 @@ export { GeminiOmniVoicePresetId, ImageAspectRatio, ImageEditProvider, ImageEdit
 export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PromptAffixFields } from '@nodaro/shared/nodes';
 export { SocialPlatform, SocialPost, SocialPostAuthor, SocialPostMedia, SocialPostMetrics, SocialSearchCount, SocialSearchMode, SocialSearchParams, SocialSearchPeriod, SocialSearchSort, SocialSearchVideoKind } from '@nodaro/shared/social';
 export { GenerateMaskOutput, GenerateMaskRequest, VideoDepthColormap, VideoDepthModelSize, VideoDepthProvider, VideoDepthResolution } from '@nodaro/shared/media';
-export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-C9j0PFto.js';
+export { A as AssembleNarratedVideoParams, B as BatchJobOutcome, E as EditImageCommonParams, a as EditImageFromTaskParams, b as EditImageFromUrlParams, c as EditImageParams, G as GenerateImageBatchGroup, e as GenerateImageBatchOutput, f as GenerateImageBatchResult, g as GenerateImageParams, h as GenerateMaskJobOutput, i as GenerateMaskParams, k as GenerateVideoParams, l as GenerationSessionParams, I as ImageJobStarted, m as ImageToImageParams, J as JobOutputImage, N as NodeCategory, n as NodeCreditRate, o as NodeDescriptor, p as NodeInputField, q as NodeInputSchema, r as NodeJobOutput, s as NodeQuote, t as NodesResource, O as OutputType, Q as QuoteAdjustment, y as QuoteWarning, R as ReferenceCaptionParams, F as RunAndWaitOptions, H as RunManyResult, K as RunNodeAdjustment, L as RunNodeOptions, M as RunNodeResult, S as RunNodeWarning, _ as SocialSearchJobOutput, $ as SplitImageParams, a0 as SplitImageResult, a1 as SplitImageTile, a2 as StructuredReferenceParams, a3 as Subject, a4 as TextToSpeechParams, a5 as TextToVideoParams, a6 as VideoDepthParams, a7 as VideoToVideoParams, a8 as VideoUpscaleParams } from '../nodes-DuXF6XVv.js';
 export { TopazUpscaleFactor } from '@nodaro/shared/credits';
 export { ImageToImageAttachColumn } from '@nodaro/shared/entities';
 import '@nodaro/shared/scene3d';

package/dist/entries/nodes.js

@@ -1,5 +1,5 @@
 export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY } from '../chunk-ZYPH2FPT.js';
-export { NodesResource } from '../chunk-GW76IRQD.js';
+export { NodesResource } from '../chunk-47ULSVO2.js';
 import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=nodes.js.map
 //# sourceMappingURL=nodes.js.map

package/dist/entries/objects.cjs

@@ -1,29 +1,29 @@
 'use strict';
 
 require('../chunk-XWKNE6DH.cjs');
-var chunkCR5E2SF3_cjs = require('../chunk-CR5E2SF3.cjs');
+var chunkW5RMFTPA_cjs = require('../chunk-W5RMFTPA.cjs');
 
 
 
 Object.defineProperty(exports, "OBJECT_ASPECT_DEFAULTS", {
   enumerable: true,
-  get: function () { return chunkCR5E2SF3_cjs.OBJECT_ASPECT_DEFAULTS; }
+  get: function () { return chunkW5RMFTPA_cjs.OBJECT_ASPECT_DEFAULTS; }
 });
 Object.defineProperty(exports, "OBJECT_ASPECT_OPTIONS", {
   enumerable: true,
-  get: function () { return chunkCR5E2SF3_cjs.OBJECT_ASPECT_OPTIONS; }
+  get: function () { return chunkW5RMFTPA_cjs.OBJECT_ASPECT_OPTIONS; }
 });
 Object.defineProperty(exports, "OBJECT_ASSET_TYPES", {
   enumerable: true,
-  get: function () { return chunkCR5E2SF3_cjs.OBJECT_ASSET_TYPES; }
+  get: function () { return chunkW5RMFTPA_cjs.OBJECT_ASSET_TYPES; }
 });
 Object.defineProperty(exports, "OBJECT_ATTACH_COLUMNS", {
   enumerable: true,
-  get: function () { return chunkCR5E2SF3_cjs.OBJECT_ATTACH_COLUMNS; }
+  get: function () { return chunkW5RMFTPA_cjs.OBJECT_ATTACH_COLUMNS; }
 });
 Object.defineProperty(exports, "ObjectsResource", {
   enumerable: true,
-  get: function () { return chunkCR5E2SF3_cjs.ObjectsResource; }
+  get: function () { return chunkW5RMFTPA_cjs.ObjectsResource; }
 });
 //# sourceMappingURL=objects.cjs.map
 //# sourceMappingURL=objects.cjs.map

package/dist/entries/objects.d.cts

@@ -1,7 +1,8 @@
 import { ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio } from '@nodaro/shared/entities';
 export { OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
-import { l as GenerationSessionParams } from '../nodes-DGIefTze.cjs';
+import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.cjs';
+import { l as GenerationSessionParams } from '../nodes-bY51Z1Os.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';
@@ -478,6 +479,13 @@ declare class ObjectsResource {
         id: string;
         name: string;
     }>;
+    /**
+     * Admin only: put one of your own objects on the shared Nodaro Keepers
+     * shelf (`client.keepers.catalog()`), or take it off. A first-party session
+     * or your personal token; `forbidden` for anyone who is not a platform
+     * admin, `not_found` for a row that is not yours.
+     */
+    setCatalog(id: string, input: SetKeeperCatalogInput): Promise<SetKeeperCatalogResult>;
     /**
      * Fire `POST /v1/generate-object` to produce one or more candidate main
      * images. With `count > 1`, all jobs are reserved up-front before any

package/dist/entries/objects.d.ts

@@ -1,7 +1,8 @@
 import { ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio } from '@nodaro/shared/entities';
 export { OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn } from '@nodaro/shared/entities';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
-import { l as GenerationSessionParams } from '../nodes-C9j0PFto.js';
+import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.js';
+import { l as GenerationSessionParams } from '../nodes-DuXF6XVv.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';
@@ -478,6 +479,13 @@ declare class ObjectsResource {
         id: string;
         name: string;
     }>;
+    /**
+     * Admin only: put one of your own objects on the shared Nodaro Keepers
+     * shelf (`client.keepers.catalog()`), or take it off. A first-party session
+     * or your personal token; `forbidden` for anyone who is not a platform
+     * admin, `not_found` for a row that is not yours.
+     */
+    setCatalog(id: string, input: SetKeeperCatalogInput): Promise<SetKeeperCatalogResult>;
     /**
      * Fire `POST /v1/generate-object` to produce one or more candidate main
      * images. With `count > 1`, all jobs are reserved up-front before any

package/dist/entries/objects.js

@@ -1,4 +1,4 @@
 import '../chunk-OLPA44QJ.js';
-export { OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectsResource } from '../chunk-7LSFG2AF.js';
+export { OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectsResource } from '../chunk-QGVOAPUI.js';
 //# sourceMappingURL=objects.js.map
 //# sourceMappingURL=objects.js.map

package/dist/entries/scene3d.d.cts

@@ -1,5 +1,5 @@
-import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-DGIefTze.cjs';
-export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-DGIefTze.cjs';
+import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-bY51Z1Os.cjs';
+export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-bY51Z1Os.cjs';
 import { Scene3DAssetRef } from '@nodaro/shared/scene3d';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
 import '@nodaro/shared/types';

package/dist/entries/scene3d.d.ts

@@ -1,5 +1,5 @@
-import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-C9j0PFto.js';
-export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-C9j0PFto.js';
+import { t as NodesResource, V as Scene3DCapabilities, W as Scene3DDelivery, X as Scene3DDeliveryAsset, C as RetainedScene3DEditParams, D as RetainedScene3DEditResult, j as GenerateScene3DParams, M as RunNodeResult, F as RunAndWaitOptions, Z as Scene3DJobOutput, d as EditScene3DParams, u as Pro3DRenderParams, v as Pro3DRenderQuote, x as Pro3DRenderRunParams, w as Pro3DRenderRunOptions, P as Pro3DRenderJobOutput, z as RenderScene3DParams, r as NodeJobOutput } from '../nodes-DuXF6XVv.js';
+export { T as SCENE3D_DELIVERY_ASSET_USAGE, U as Scene3DAuthoringEngine, Y as Scene3DDeliveryAssetKind } from '../nodes-DuXF6XVv.js';
 import { Scene3DAssetRef } from '@nodaro/shared/scene3d';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
 import '@nodaro/shared/types';

package/dist/entries/trends.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-PG2GBS3K.cjs');
-var chunkNWMO4MHE_cjs = require('../chunk-NWMO4MHE.cjs');
+var chunkDAONQZPI_cjs = require('../chunk-DAONQZPI.cjs');
 
 
 
 Object.defineProperty(exports, "TrendsResource", {
   enumerable: true,
-  get: function () { return chunkNWMO4MHE_cjs.TrendsResource; }
+  get: function () { return chunkDAONQZPI_cjs.TrendsResource; }
 });
 //# sourceMappingURL=trends.cjs.map
 //# sourceMappingURL=trends.cjs.map

package/dist/entries/trends.d.cts

@@ -47,6 +47,29 @@ interface TrendCard {
         width: number;
         height: number;
     };
+    /**
+     * The original's display copy, the same address as {@link TrendDetail.original}
+     * (without its length and preview start). Absent on a version without a
+     * display copy (and from an older server).
+     */
+    original?: {
+        videoUrl: string;
+        posterUrl?: string;
+        width: number;
+        height: number;
+    };
+    /**
+     * Every example's video, in the page's order, so a list can show each clip
+     * without reading the trend's page. Empty on a trend with only its original;
+     * absent from an older server. The pictures each slot used are on the page
+     * ({@link TrendDetail.examples}).
+     */
+    examples?: Array<{
+        videoUrl: string;
+        posterUrl?: string;
+        width: number;
+        height: number;
+    }>;
     /** How many slots of each kind the trend has. */
     needs: Record<TrendSlotKind, number>;
     /** The length of a full run, in seconds. */
@@ -61,7 +84,8 @@ interface TrendDetailSlot {
     kind: TrendSlotKind;
     /**
      * A required slot needs pictures; an optional one left empty takes the
-     * chosen example's, or, on a trend with no example, stays as in the original.
+     * chosen example's, or, on a trend with no example, stays as in the original;
+     * except in Full depth trends, where it uses the trend's default image for that role if one is set, otherwise the original's look.
      */
     required: boolean;
     hint?: string;
@@ -142,12 +166,13 @@ interface TrendRunRequest {
     /**
      * Slot key → what you put in it. Every required slot needs pictures; an
      * optional slot left out takes the chosen example's, or, on a trend with no
-     * example, stays as in the original. 1–3 pictures per slot.
+     * example, stays as in the original; except in Full depth trends, where it uses the trend's default image for that role if one is set, otherwise the original's look.
+     * 1–3 pictures per slot.
      */
     slots: Record<string, TrendRunSlot>;
     /**
-     * 1-based example whose pictures fill the optional slots you leave empty.
-     * Default 1. Leave it out on a trend with no examples: sending one there
+     * 1-based example whose pictures fill the optional slots you leave empty
+     * (never in a Full depth trend, which records `example: 0`). Default 1. Leave it out on a trend with no examples: sending one there
      * answers 400 `example_out_of_range` (and `0` is a `validation_error`).
      */
     example?: number;
@@ -234,6 +259,11 @@ interface TrendRunDisplaySlot extends TrendChips {
      * stayed as in the original.
      */
     fromExample: boolean;
+    /**
+     * `true` when the slot was left empty and the trend's own default pictures
+     * filled it (`fromExample` is then `false`). Absent otherwise.
+     */
+    fromDefault?: true;
 }
 /**
  * One of your trend runs (`runs()`, `getRun()`). Stays readable after the
@@ -268,8 +298,8 @@ interface TrendRun {
         name: string;
     };
     /**
-     * The 1-based example used for empty optional slots; `0` = the trend had no
-     * example (none was used: never show it as "Example 0").
+     * The 1-based example used for empty optional slots; `0` = none was used (the
+     * trend had no example, or is a Full depth trend): never show it as "Example 0".
      */
     example: number;
     slots: TrendRunDisplaySlot[];

package/dist/entries/trends.d.ts

@@ -47,6 +47,29 @@ interface TrendCard {
         width: number;
         height: number;
     };
+    /**
+     * The original's display copy, the same address as {@link TrendDetail.original}
+     * (without its length and preview start). Absent on a version without a
+     * display copy (and from an older server).
+     */
+    original?: {
+        videoUrl: string;
+        posterUrl?: string;
+        width: number;
+        height: number;
+    };
+    /**
+     * Every example's video, in the page's order, so a list can show each clip
+     * without reading the trend's page. Empty on a trend with only its original;
+     * absent from an older server. The pictures each slot used are on the page
+     * ({@link TrendDetail.examples}).
+     */
+    examples?: Array<{
+        videoUrl: string;
+        posterUrl?: string;
+        width: number;
+        height: number;
+    }>;
     /** How many slots of each kind the trend has. */
     needs: Record<TrendSlotKind, number>;
     /** The length of a full run, in seconds. */
@@ -61,7 +84,8 @@ interface TrendDetailSlot {
     kind: TrendSlotKind;
     /**
      * A required slot needs pictures; an optional one left empty takes the
-     * chosen example's, or, on a trend with no example, stays as in the original.
+     * chosen example's, or, on a trend with no example, stays as in the original;
+     * except in Full depth trends, where it uses the trend's default image for that role if one is set, otherwise the original's look.
      */
     required: boolean;
     hint?: string;
@@ -142,12 +166,13 @@ interface TrendRunRequest {
     /**
      * Slot key → what you put in it. Every required slot needs pictures; an
      * optional slot left out takes the chosen example's, or, on a trend with no
-     * example, stays as in the original. 1–3 pictures per slot.
+     * example, stays as in the original; except in Full depth trends, where it uses the trend's default image for that role if one is set, otherwise the original's look.
+     * 1–3 pictures per slot.
      */
     slots: Record<string, TrendRunSlot>;
     /**
-     * 1-based example whose pictures fill the optional slots you leave empty.
-     * Default 1. Leave it out on a trend with no examples: sending one there
+     * 1-based example whose pictures fill the optional slots you leave empty
+     * (never in a Full depth trend, which records `example: 0`). Default 1. Leave it out on a trend with no examples: sending one there
      * answers 400 `example_out_of_range` (and `0` is a `validation_error`).
      */
     example?: number;
@@ -234,6 +259,11 @@ interface TrendRunDisplaySlot extends TrendChips {
      * stayed as in the original.
      */
     fromExample: boolean;
+    /**
+     * `true` when the slot was left empty and the trend's own default pictures
+     * filled it (`fromExample` is then `false`). Absent otherwise.
+     */
+    fromDefault?: true;
 }
 /**
  * One of your trend runs (`runs()`, `getRun()`). Stays readable after the
@@ -268,8 +298,8 @@ interface TrendRun {
         name: string;
     };
     /**
-     * The 1-based example used for empty optional slots; `0` = the trend had no
-     * example (none was used: never show it as "Example 0").
+     * The 1-based example used for empty optional slots; `0` = none was used (the
+     * trend had no example, or is a Full depth trend): never show it as "Example 0".
      */
     example: number;
     slots: TrendRunDisplaySlot[];

package/dist/entries/trends.js

@@ -1,4 +1,4 @@
 import '../chunk-YCVRQZT3.js';
-export { TrendsResource } from '../chunk-35CNQ3WW.js';
+export { TrendsResource } from '../chunk-HAVIVOLO.js';
 //# sourceMappingURL=trends.js.map
 //# sourceMappingURL=trends.js.map