@shotstack/cli 0.14.0 → 0.15.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -15,9 +15,9 @@ This skill loads in **terminal-based AI agents** (Claude Code, Cursor, Codex CLI
|
|
|
15
15
|
|
|
16
16
|
## Check versions once per session
|
|
17
17
|
|
|
18
|
-
This skill is version **0.
|
|
18
|
+
This skill is version **0.15.0** and needs `@shotstack/cli` **0.15.0** or later. Before the first `shotstack` command in a session:
|
|
19
19
|
|
|
20
|
-
1. Run `shotstack --version`. If it is older than 0.
|
|
20
|
+
1. Run `shotstack --version`. If it is older than 0.15.0, tell the user: what this skill documents, such as the html5 size steps from `ingest upload --watch`, is missing until they run `npm install -g @shotstack/cli@latest`.
|
|
21
21
|
2. Run `npm view @shotstack/cli version`. If it is newer than this skill's version, tell the user an update is available and ask whether to install it. Only on a yes, run `npx skills update shotstack -y` and `npm install -g @shotstack/cli@latest`. Never update without asking. `npx skills check` is not a read-only check: it installs the update.
|
|
22
22
|
|
|
23
23
|
If a check fails (no network, no npm, a sandbox), skip it and carry on.
|
|
@@ -119,6 +119,9 @@ FONT=$(shotstack ingest upload ./Brand.woff2 --watch --output json | tail -n1 |
|
|
|
119
119
|
- **Same account and environment only.** A file ingested on `stage` works in `stage` renders, not in `v1`, and another account's files are refused. Every other remote URL is still blocked.
|
|
120
120
|
- **10 MiB per file, 25 MiB per page.** A file counts once for every place the page references it, so reference a large image once (a CSS class, say) and reuse the class.
|
|
121
121
|
- **Size images to the clip.** A photo much larger than the clip makes a heavier page and a slower capture. If the source has a WebP rendition named `html5-512`, `html5-1024`, `html5-2048` or `html5-4096`, the renderer uses the smallest one that covers the clip's longest edge; otherwise it uses the original.
|
|
122
|
+
<!-- surface:cli -->
|
|
123
|
+
- `shotstack ingest upload --watch` and `ingest fetch --watch` request those renditions for an image and wait up to 60 s for them, so the `source` URL is all the page needs.
|
|
124
|
+
<!-- /surface -->
|
|
122
125
|
- **A file that can't be used fails the render**, for example one that's missing, too large, or not an image or font.
|
|
123
126
|
- **Studio's preview doesn't load ingested files yet**, so they show as missing there. The render is unaffected.
|
|
124
127
|
<!-- surface:cli -->
|
|
@@ -85,6 +85,11 @@ An `html5` page can use images and fonts you ingested by putting their
|
|
|
85
85
|
The file must belong to the same account and environment as the render. Limits
|
|
86
86
|
and details are in [`html5.md`](html5.md).
|
|
87
87
|
|
|
88
|
+
With `--watch`, an image upload or fetch also requests smaller WebP copies
|
|
89
|
+
(`html5-512` up to `html5-4096`, only those smaller than the image) and waits
|
|
90
|
+
up to 60 s for them. They're listed under `outputs.renditions`; the renderer
|
|
91
|
+
picks one for the clip size, so keep using the `source` URL.
|
|
92
|
+
|
|
88
93
|
## Fetch a remote URL instead of uploading
|
|
89
94
|
|
|
90
95
|
If the media is already at a URL but you want Shotstack to host its own copy
|