Skip to content

fix(shotkit): follow-up review polish (caption options, lint, thumbnail-only)#8

Merged
heznpc merged 1 commit into
mainfrom
fix/shotkit-review-followup
Jun 17, 2026
Merged

fix(shotkit): follow-up review polish (caption options, lint, thumbnail-only)#8
heznpc merged 1 commit into
mainfrom
fix/shotkit-review-followup

Conversation

@heznpc

@heznpc heznpc commented Jun 17, 2026

Copy link
Copy Markdown
Member

Second-tier findings deferred from the v1.3.0 correctness pass (#7). None break the handoff contract; these are ergonomics/waste fixes.

  • [8] step(text, fn, options) now honors flat caption display options (e.g. { position }, by analogy with caption()) instead of silently dropping anything outside options.captionOptions.
  • [10] lintDemoStoryboard() no longer emits a spurious "missing mp4" warning when the demo config sets mp4/crop/zoom — the public caller need not pass mp4Requested.
  • [15] A thumbnail-only demo (no mp4/crop/zoom/trim) no longer re-muxes and overwrites the source .webm; the thumbnail is taken from the original clip.

Deliberately NOT changed — [6] (scheduled-caption option handling): on close reading it is working-as-designed. Scheduled captions (from captions: [{at,text}], which carries no per-caption options) merge with controller-level captionOptions, so they render at the intended position; per-call caption(text, opts) options are per-call by design. No wrong on-screen output, so no behavioral change.

Verification

  • npm run lint clean
  • npm test → 13 suites / 83 tests (added lint-mp4 + reused validation/readiness coverage)

Note

Lands under ## [Unreleased] in CHANGELOG; package.json stays 1.3.0 (still unpublished on npm — latest is 1.1.1). Owner decides whether to fold into the first 1.3.0 publish or bump.

…il-only)

Second-tier findings deferred from the v1.3.0 correctness pass:
- step() honors flat caption display options (e.g. { position }) like caption(),
  instead of silently dropping anything outside options.captionOptions
- lintDemoStoryboard() no longer warns 'missing mp4' when demo.mp4/crop/zoom is
  set (public callers need not pass mp4Requested)
- thumbnail-only demo no longer re-muxes/overwrites the source .webm

(Deliberately not changed: scheduled-caption option handling — scheduled
captions use controller-level captionOptions by design; no wrong output.)

lint clean, 13 suites / 83 tests pass.
@heznpc
heznpc merged commit 7e2703f into main Jun 17, 2026
1 check passed
@heznpc
heznpc deleted the fix/shotkit-review-followup branch June 17, 2026 21:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant