@sprid/cli 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 sprid follows semver: a breaking change to a command's arguments, its output
 shape or its exit codes is a major release.
 
+## 1.0.2 - 2026-10-01
+
+- Local video previews include a safe-zone toggle using the editor's approximate
+  bottom and right interface bands. Guides follow the actual picture through
+  letterboxing, resizing and feed view. They never appear in exported videos.
+- Screen-reel captions stay above the bottom band and left of the action rail,
+  including their entrance animation. Oversized caption cards fail with a
+  readable error instead of drawing under the platform interface.
+
+## 1.0.1 - 2026-10-01
+
+- Local post previews use a compact artwork grid and a caption comparison list.
+  Clicking a post opens its media beside the caption, with icon controls and
+  file details on demand. Search and lane filters also scope post navigation.
+- The preview follows the system theme, with a light/dark switch. Needs attention
+  includes missing files and captions, failed checks, and changed files or captions.
+  Carousel controls, keyboard navigation and the feed view remain available offline.
+- A sound toggle above the grid also controls hover playback. The sun icon’s
+  diagonal rays render correctly.
+- Feed previews preload every visible post plus one beyond each edge, and
+  keep outgoing video frames until scrolling stops.
+
 ## 1.0.0 - 2026-09-30
 
 - Breaking: Sprid record IDs are UUIDs. Post and review references remain accepted. Incremental IDs are refused.

package/README-post.md

@@ -405,21 +405,27 @@ bunx @sprid/cli post preview --open       # file://, fine for watching, cannot s
 bunx @sprid/cli post preview --lane collage --copy --out ~/Desktop/reels
 ```
 
-It reads the registry and nothing else, so it is the same command in every repo,
-and it writes one disposable HTML file with **two views**, because a batch and a
-post are two different questions:
-
-- **Grid.** Everything at once, small. Hover plays a reel and walks a deck, the filter matches slug and
-  caption, and a card carries the caption itself and nothing derived from it -
-  the length, the loudness, the check result and the Sprid state ride along as
-  badges. This is where you see repetition, an outlier, a caption that ran long.
-- **Feed.** One post at reading size with its caption under it, arrow keys
-  between them, `m` for sound, `esc` back. A carousel advances by itself at
-  reading pace (`space` stops it, `[` `]` step it, the dots say how many are
-  left), because the question a batch review asks of a deck is whether it holds
-  together as one set, and that is a thing you watch rather than click through. It is the only view that answers
-  *would I stop on this*, because it is the shape a reader meets. Each reel has
-  its own `#slug` address, so a position is a link.
+The video viewer has a **Safe zones** toggle: approximate bottom 20% and right 14% from 38% down to the bottom band. Hatching follows the video picture, including letterboxing; keep captions and important graphics outside it. This guide is not a guarantee of platform UI placement. Screen-reel captions use the same margins when rendered.
+
+It reads the local registry and writes one self-contained HTML file. The preview
+uses Sprid’s paper colours, follows the system theme, and works offline.
+
+- **Grid.** A compact picture grid. Hover plays a reel or walks through a deck.
+  The sound button above the grid, or `m`, unmutes hover playback.
+  Click opens the post with its full caption beside the media, copy controls,
+  and file details. Missing files remain visible.
+- **List.** One row per post, with the caption’s opening line, lane, length and
+  check state. Use it to compare captions across a batch.
+- **Feed.** One post at reading size, with its caption underneath. Swipe sideways
+  or use arrow keys between posts, `m` for sound, and `esc` to return. Carousels
+  advance automatically; `space` pauses, `[` and `]` step slides manually.
+  Visible media and one extra post beyond each edge preload. Outgoing videos
+  stay loaded until scrolling stops.
+
+Search matches the local ID, lane and caption. The lane selector and
+**Needs attention** filter also apply to navigation between posts. Needs attention
+includes failed checks, missing media or captions, and files or captions changed
+since their saved record. Every post has a `#slug` address.
 
 **`--serve` watches and reloads.** The registry, the lanes' media directories
 and this package's own source are all watched; a change rebuilds the page and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sprid/cli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "The Sprid command line: connect your app, review results, prepare posts and store screenshots, and release mobile apps.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",