@ossclip/core 0.1.12 → 0.1.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ossclip/core",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "ossclip's framework-free pipeline: schema, transcription, analysis, cutlist, captions, framing, and the LLM producer",
   "type": "module",
   "license": "MIT",

package/src/cover.ts

@@ -59,6 +59,27 @@ export function coverHeadline(text: string, maxWords = COVER_MAX_WORDS): string
   return out.join(" ").replace(/[,;:—–-]+$/, "");
 }
 
+/**
+ * What the cover step should emit.
+ *
+ * "textless" exists because of the Urdu field run 2026-08-05: a run without
+ * `--produce` has no LLM hook text, and the old behavior skipped the cover
+ * entirely — but frame selection needs no text at all, and the
+ * sharpness-scored face frame is a clean thumbnail on its own. Only the
+ * banner needs a headline; the pick does not, so a missing headline demotes
+ * the cover to a bare frame instead of erasing it.
+ */
+export type CoverDecision = "banner" | "textless" | "none";
+
+/**
+ * Pure so the three-way outcome is testable without a video, ffmpeg, or a
+ * beat sheet on disk — the same I/O split as `openCommand()`.
+ */
+export function coverDecision(coverEnabled: boolean, headline: string): CoverDecision {
+  if (!coverEnabled) return "none";
+  return headline.trim() ? "banner" : "textless";
+}
+
 /** Where the face sits in the COVER frame, as fractions of it. */
 export interface CoverFace {
   centerXFrac: number;

package/src/overrides.ts

@@ -171,6 +171,19 @@ export function captionEditWas(
 export const OverrideDocSchema = z.object({
   /** Global style tokens — the look is a system, so these are not per-element. */
   theme: ThemeSchema.partial().default({}),
+  /**
+   * Captions OFF for the whole video. Doc-global like `theme`, deliberately
+   * NOT a per-scene key: visibility is one decision about the output —
+   * `captionY`/`captionScale` (per scene, above) style captions, this one
+   * removes the track. Optional with NO default so every overrides.json
+   * written before the key existed parses byte-identically; absent means
+   * visible, and the editor DELETES the key rather than writing `false`
+   * (the clearVideo/restoreScene rule — an explicit false is still an
+   * override with nothing to say). Produce ORs this with `--no-captions`
+   * (`resolveCaptionsHidden`, apps/cli/src/produce.ts): either surface can
+   * hide, neither can force captions back on over the other.
+   */
+  captionsHidden: z.boolean().optional(),
   scenes: z.record(z.string(), SceneOverrideSchema).default({}),
   /** Retyped caption words, keyed by caption-stream word index. */
   captions: z.record(z.string(), CaptionEditSchema).default({}),