@shotstack/shotstack-studio 2.26.0 → 2.26.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -6,7 +6,7 @@
6
6
  "dazzatron",
7
7
  "kratos2k7"
8
8
  ],
9
- "version": "2.26.0",
9
+ "version": "2.26.2",
10
10
  "description": "A video editing library for creating and editing videos with Shotstack",
11
11
  "type": "module",
12
12
  "main": "dist/shotstack-studio.umd.js",
package/readme.md CHANGED
@@ -337,7 +337,7 @@ const exporter = new VideoExporter(edit, canvas);
337
337
  await exporter.export("my-video.mp4", 25);
338
338
  ```
339
339
 
340
- `exportBlob()` runs the same export without the progress overlay or the download and resolves with the MP4 `Blob`. `onProgress` receives a fraction from 0 to 1 and a stage label. Aborting the signal rejects with an `ExportError` whose `phase` is `cancelled`.
340
+ `exportBlob()` runs the same export without the progress overlay or the download and resolves with the MP4 `Blob`. `onProgress` receives a fraction from 0 to 1 and a stage label. Aborting the signal rejects with an `ExportError` whose `phase` is `cancelled`. The editor stays live while an export runs: changing the edit rejects the export with `phase` `export`, and so does playing, pausing or seeking once it has started drawing frames.
341
341
 
342
342
  ```typescript
343
343
  import { ExportError } from "@shotstack/shotstack-studio";
@@ -354,6 +354,23 @@ const file = await exporter
354
354
  });
355
355
  ```
356
356
 
357
+ Before encoding, both methods check the edit for features the browser is known to draw differently from a cloud render. If they find any, they reject with an `ExportError` whose `phase` is `unsupported` and whose `issues` list each problem as `{ code, message, clipId? }`. `clipId` is the clip's `id` as returned by `edit.getEdit({ includeIds: true })`. A clip that failed to load, or whose asset is still loading after 30 seconds, rejects with `phase` `assets` and its `clipId` in `context`. Starting an export while another export of the same edit runs rejects with `phase` `init`, and a failure while encoding rejects with `phase` `export`.
358
+
359
+ | Code | Reason |
360
+ | --- | --- |
361
+ | `ai-pending` | A prompt clip hasn't been generated yet |
362
+ | `output-format` | `output.format` isn't `mp4`, or the edit sets `output.range` or `output.scaleTo` |
363
+ | `video-source` | The browser can't decode a video (MP4 and WebM only) |
364
+ | `chroma-key` | A video uses chroma key |
365
+ | `filter` | A clip uses a filter |
366
+ | `html` | An `html` clip that isn't the plain text form, or any `html5` clip |
367
+ | `effect` | An effect without a preset in the editor |
368
+ | `transition` | A transition without a preset in the editor |
369
+ | `font` | A font that is neither built in (including the Google catalogue) nor loaded with the edit's `timeline.fonts` |
370
+ | `luma` | A luma matte whose source is a video |
371
+ | `too-long` | The edit runs longer than five minutes, or than the shorter limit for sizes above 1080p (75 seconds at 4K) |
372
+ | `browser` | The browser can't encode H.264 at the output size, or AAC when the edit has audio |
373
+
357
374
  ## Merge Fields
358
375
 
359
376
  Merge fields are template placeholders, typically in the form `{{ FIELD_NAME }}`.