@vosjs/studio-core 0.40.3 → 0.41.1

package/README.md

@@ -45,7 +45,7 @@ The shared layers lower as one engine `stack` entry, `STUDIO_ENTRY_ID` (`'vosso.
 
 ## Destinations
 
-`DESTINATIONS` is the table of launch destinations (store listings, Product Hunt, social, OG cards, README loops) with exact pixel sizes, byte and duration ceilings, generated from `channel-specs.json` in `@vosjs/cli` and hash-gated by a test. `destinationById`, `destinationsForChannel`, `exportSizeFor(ratio, resolution)` and `resolveExportSize` size an export; `ExportResolution` is `720p | 1080p | 2k | 4k`.
+`DESTINATIONS` is the table of video destinations (a YouTube demo, an X feed cut, a vertical cut for Shorts and LinkedIn, a GitHub README loop) with exact pixel sizes, byte and duration ceilings and a word policy, generated from `channel-specs.json` in `@vosjs/cli` and hash-gated by a test. `destinationById`, `destinationsForChannel`, `exportSizeFor(ratio, resolution)` and `resolveExportSize` size an export; `ExportResolution` is `720p | 1080p | 2k | 4k`.
 
 ## Exports by area
 

package/dist/index.d.ts

@@ -1100,8 +1100,8 @@ interface FrameStyle {
      * How footage meets an off-ratio frame. 'contain' (default) fits the
      * whole card inside the padded area, letterboxing onto the background;
      * 'cover' makes the padded area the card and cover-fills it with footage,
-     * cropped around `focus` — what a 440x280 store tile or a 2.5:1 marquee
-     * demands ("fill the region"). Absent = contain; every existing doc is
+     * cropped around `focus` — what a 9:16 cut of 16:9 footage demands
+     * ("fill the region"). Absent = contain; every existing doc is
      * byte-identical.
      */
     fit?: 'contain' | 'cover';
@@ -1816,8 +1816,8 @@ interface ProjectDoc {
     media?: Media[];
     /**
      * The frame that stands for this document (OUTPUT seconds): the cover the
-     * shelf shows, the still a kit leads with. Absent, `docStillTime` derives
-     * it: the document's own last freeze (a poster's rest), else the hero
+     * shelf shows. Absent, `docStillTime` derives it: the document's own
+     * last freeze (the rest a closing hold ends on), else the hero
      * moment after the opening has entered. A template never sets it.
      */
     still?: number;
@@ -3857,8 +3857,8 @@ declare function wrapProgramLength(source: string): string;
 declare function lowerProgramDoc(doc: ProgramAnchorDoc, opts?: LowerProgramOptions): LoweredComposition;
 
 /**
- * A destination is where a release's media goes — the output twin of the
- * doors registry's "a door is what you bring". One row per channel asset,
+ * A destination is where a release's video goes — the output twin of the
+ * doors registry's "a door is what you bring". One row per channel video,
  * derived from the verified channel specs; `vos deliver` loops these and
  * the kit manifest records them.
  */
@@ -3868,58 +3868,29 @@ interface Destination {
     channel: string;
     asset: string;
     label: string;
-    kind: 'video' | 'still' | 'still-set';
     /** Reduced aspect ratio, the exportSizeFor convention. */
     ratio: string;
     px: {
         w: number;
         h: number;
     };
-    /** still-set only: how many the channel takes. */
-    count?: {
-        min: number;
-        max: number;
-    };
-    /**
-     * Image genre: 'screenshot' = real UI from the take (store policy demands
-     * real UX); 'card' = a COMPOSED cover — rendered from the maker's poster
-     * program when `vos deliver --poster` has one.
-     */
-    genre?: 'screenshot' | 'card';
     minSeconds?: number;
     maxSeconds?: number;
     maxBytes?: number;
     /** The format the kit renders. */
-    format: 'mp4' | 'png';
+    format: 'mp4';
     /** What the channel accepts, in the spec's own words. */
     accepts: string;
-    /** How footage meets an off-ratio frame (a still fills, a video letterboxes). */
-    fit: 'contain' | 'cover';
     /**
-     * The destination's word policy: 'none' = the picture carries it alone (a
-     * tile, a store screenshot), 'allowed', 'expected' = a card that should
-     * say something. The picture checks read it.
+     * The destination's word policy: 'none' = the picture carries it alone
+     * (a README loop, so the beat captions drop), 'allowed', 'expected' = a
+     * cut that should say something.
      */
     text: 'none' | 'allowed' | 'expected';
-    /**
-     * The rect, as fractions of the frame, every text box must sit inside:
-     * the platform's own chrome or crop covers the rest.
-     */
-    safe: {
-        x: number;
-        y: number;
-        w: number;
-        h: number;
-    };
-    /**
-     * The poster template a card destination renders from by default (the
-     * family that ships with the CLI); absent on screenshots and videos.
-     */
-    template?: string;
     notes: string;
 }
 declare const CHANNEL_SPECS_VERIFIED = "2026-08-04";
-declare const CHANNEL_SPECS_HASH = "e48926c22737b5dfaabf5cb33916a50a5eccd4b93498c2059a1468bd963a0a86";
+declare const CHANNEL_SPECS_HASH = "0f12781634495af6af1b49845009f04810d75829cfb0088dbf903d136e330f25";
 declare const DESTINATIONS: Destination[];
 declare function destinationById(id: string): Destination | undefined;
 declare function destinationsForChannel(channel: string): Destination[];
@@ -4346,9 +4317,9 @@ declare function ownFreezes(doc: ProjectDoc): FreezeSpan[];
 /** The still a document with nothing to say gets: the old default. */
 declare const STILL_DEFAULT = 0.5;
 /**
- * The output moment that STANDS for a document: its cover on the shelf,
- * the still a kit leads with. One ladder, one derivation, read by the
- * fleet thumbnail, the stills export and the kit alike; a template can
+ * The output moment that STANDS for a document: its cover on the shelf.
+ * One ladder, one derivation, read by every surface that takes a cover
+ * (the fleet thumbnail, `vos frames --at-still`); a template can
  * never move it, because everything a template lays is stamped `from`.
  *
  * 1. `doc.still`, the author's own choice, clamped to the output.

package/dist/index.js

@@ -5061,26 +5061,32 @@ var STUDIO_SETUP = `async (ctx) => {
       fontCache.set(oc.asset.url, font)
     } catch (e) { console.warn('[voila] typeface failed to load', oc.asset.url, e) }
   }
-  // Audio clips (music/SFX): pre-decode into a shared cache so first play is
-  // instant. The AudioContext starts suspended (autoplay policy) \u2014 onFrame
-  // resumes it on the first play. Failures degrade to a silent clip.
+  // Audio clips (music/SFX): start decoding into the shared cache now, but
+  // never hold the first frame for it. Playback starts on a press, so the
+  // decodes almost always land first; one that lands later clears the
+  // scheduler's signature and the next playing frame schedules it at the
+  // right offset (the onFrame path does the same for clips added later).
+  // Exports never read this cache: they mix offline. The AudioContext starts
+  // suspended (autoplay policy); onFrame resumes it on the first play.
+  // Failures degrade to a silent clip.
   const clips = ctx.data.audio || []
   if (clips.length && window.AudioContext) {
     const actx = ns.audioCtx || (ns.audioCtx = new window.AudioContext())
     const bufs = ns.audioBuffers || (ns.audioBuffers = new Map())
     const pend = ns.audioPending || (ns.audioPending = new Set())
-    await Promise.all(clips.map(async (c) => {
-      if (bufs.has(c.key) || pend.has(c.key)) return
+    for (const c of clips) {
+      if (bufs.has(c.key) || pend.has(c.key)) continue
       pend.add(c.key)
-      try {
-        const res = await fetch(c.key)
-        bufs.set(c.key, await actx.decodeAudioData(await res.arrayBuffer()))
-      } catch (e) {
-        console.warn('[voila] audio decode failed', c.key, e)
-      } finally {
-        pend.delete(c.key)
-      }
-    }))
+      fetch(c.key)
+        .then((res) => res.arrayBuffer())
+        .then((ab) => actx.decodeAudioData(ab))
+        .then((b) => {
+          bufs.set(c.key, b)
+          if (ns.audioSched) ns.audioSched.sig = ''
+        })
+        .catch((e) => console.warn('[voila] audio decode failed', c.key, e))
+        .then(() => pend.delete(c.key))
+    }
   }
 }`;
 var STUDIO_CONTENT = `(ctx) => {
@@ -10278,14 +10284,13 @@ function lowerProgramDoc(doc, opts = {}) {
 
 // src/destinations.ts
 var CHANNEL_SPECS_VERIFIED = "2026-08-04";
-var CHANNEL_SPECS_HASH = "e48926c22737b5dfaabf5cb33916a50a5eccd4b93498c2059a1468bd963a0a86";
+var CHANNEL_SPECS_HASH = "0f12781634495af6af1b49845009f04810d75829cfb0088dbf903d136e330f25";
 var DESTINATIONS = [
   {
     id: "youtube-main-demo",
     channel: "youtube",
     asset: "main-demo",
     label: "YouTube demo",
-    kind: "video",
     ratio: "16:9",
     px: {
       w: 1920,
@@ -10295,14 +10300,7 @@ var DESTINATIONS = [
     maxSeconds: 120,
     format: "mp4",
     accepts: "mp4 (H.264+AAC)",
-    fit: "contain",
     text: "allowed",
-    safe: {
-      x: 0.05,
-      y: 0.08,
-      w: 0.9,
-      h: 0.84
-    },
     notes: "Captions burned in. The same public upload serves the Chrome Web Store promo video and Product Hunt video (both take YouTube URLs only)."
   },
   {
@@ -10310,7 +10308,6 @@ var DESTINATIONS = [
     channel: "x",
     asset: "feed-cut",
     label: "X feed cut",
-    kind: "video",
     ratio: "16:9",
     px: {
       w: 1920,
@@ -10321,14 +10318,7 @@ var DESTINATIONS = [
     maxBytes: 536870912,
     format: "mp4",
     accepts: "mp4 (H.264+AAC ONLY \u2014 HEVC/VP9/AV1 rejected)",
-    fit: "contain",
     text: "allowed",
-    safe: {
-      x: 0.05,
-      y: 0.08,
-      w: 0.9,
-      h: 0.84
-    },
     notes: "30\u201360s plays best; 140s/512MB is the free-tier ceiling. 1:1 also allowed. Native upload, never a link post."
   },
   {
@@ -10336,7 +10326,6 @@ var DESTINATIONS = [
     channel: "shorts-linkedin",
     asset: "vertical-cut",
     label: "Shorts / LinkedIn vertical cut",
-    kind: "video",
     ratio: "9:16",
     px: {
       w: 1080,
@@ -10346,14 +10335,7 @@ var DESTINATIONS = [
     maxSeconds: 90,
     format: "mp4",
     accepts: "mp4 (H.264+AAC)",
-    fit: "contain",
     text: "expected",
-    safe: {
-      x: 0.0833,
-      y: 0.1979,
-      w: 0.8333,
-      h: 0.6042
-    },
     notes: "Critical text inside a centered ~900\xD71160 safe zone \u2014 platform chrome covers the rest. Serves YouTube Shorts and LinkedIn native vertical."
   },
   {
@@ -10361,7 +10343,6 @@ var DESTINATIONS = [
     channel: "github",
     asset: "readme-loop",
     label: "GitHub README loop",
-    kind: "video",
     ratio: "16:9",
     px: {
       w: 1920,
@@ -10372,298 +10353,8 @@ var DESTINATIONS = [
     maxBytes: 10485760,
     format: "mp4",
     accepts: "mp4 (H.264)",
-    fit: "contain",
     text: "none",
-    safe: {
-      x: 0.05,
-      y: 0.08,
-      w: 0.9,
-      h: 0.84
-    },
     notes: "\u226410MB is the free-plan attachment ceiling; two-pass target bitrate from duration."
-  },
-  {
-    id: "youtube-thumbnail",
-    channel: "youtube",
-    asset: "thumbnail",
-    label: "YouTube thumbnail",
-    kind: "still",
-    ratio: "16:9",
-    px: {
-      w: 1280,
-      h: 720
-    },
-    genre: "card",
-    maxBytes: 2097152,
-    format: "png",
-    accepts: "png|jpg",
-    fit: "cover",
-    text: "expected",
-    safe: {
-      x: 0.05,
-      y: 0.08,
-      w: 0.9,
-      h: 0.84
-    },
-    template: "split-cover",
-    notes: ""
-  },
-  {
-    id: "cws-screenshot",
-    channel: "cws",
-    asset: "screenshot",
-    label: "Chrome Web Store screenshot",
-    kind: "still-set",
-    ratio: "8:5",
-    px: {
-      w: 1280,
-      h: 800
-    },
-    count: {
-      min: 1,
-      max: 5
-    },
-    genre: "screenshot",
-    format: "png",
-    accepts: "png|jpg",
-    fit: "cover",
-    text: "none",
-    safe: {
-      x: 0,
-      y: 0,
-      w: 1,
-      h: 1
-    },
-    notes: "Real UX only \u2014 misleading listing images are a removal-grade violation. Full bleed, square corners."
-  },
-  {
-    id: "cws-small-promo-tile",
-    channel: "cws",
-    asset: "small-promo-tile",
-    label: "Chrome Web Store small promo tile",
-    kind: "still",
-    ratio: "11:7",
-    px: {
-      w: 440,
-      h: 280
-    },
-    genre: "card",
-    format: "png",
-    accepts: "png|jpg",
-    fit: "cover",
-    text: "none",
-    safe: {
-      x: 0,
-      y: 0,
-      w: 1,
-      h: 1
-    },
-    template: "card-on-gradient",
-    notes: "Listings without one rank lower. No text; fill the region; subject centered."
-  },
-  {
-    id: "cws-marquee",
-    channel: "cws",
-    asset: "marquee",
-    label: "Chrome Web Store marquee",
-    kind: "still",
-    ratio: "5:2",
-    px: {
-      w: 1400,
-      h: 560
-    },
-    genre: "card",
-    format: "png",
-    accepts: "png|jpg",
-    fit: "cover",
-    text: "allowed",
-    safe: {
-      x: 0.05,
-      y: 0.08,
-      w: 0.9,
-      h: 0.84
-    },
-    template: "split-cover",
-    notes: "Carousel eligibility."
-  },
-  {
-    id: "cws-icon",
-    channel: "cws",
-    asset: "icon",
-    label: "Chrome Web Store icon",
-    kind: "still",
-    ratio: "1:1",
-    px: {
-      w: 128,
-      h: 128
-    },
-    format: "png",
-    accepts: "png",
-    fit: "cover",
-    text: "none",
-    safe: {
-      x: 0,
-      y: 0,
-      w: 1,
-      h: 1
-    },
-    notes: "96\xD796 art + 16px transparent padding."
-  },
-  {
-    id: "producthunt-thumbnail",
-    channel: "producthunt",
-    asset: "thumbnail",
-    label: "Product Hunt thumbnail",
-    kind: "still",
-    ratio: "1:1",
-    px: {
-      w: 240,
-      h: 240
-    },
-    genre: "card",
-    maxBytes: 3145728,
-    format: "png",
-    accepts: "gif|png",
-    fit: "cover",
-    text: "none",
-    safe: {
-      x: 0.06,
-      y: 0.06,
-      w: 0.88,
-      h: 0.88
-    },
-    template: "card-on-gradient",
-    notes: "GIF animates on hover only \u2014 the first frame must stand alone."
-  },
-  {
-    id: "producthunt-gallery",
-    channel: "producthunt",
-    asset: "gallery",
-    label: "Product Hunt gallery",
-    kind: "still-set",
-    ratio: "127:76",
-    px: {
-      w: 1270,
-      h: 760
-    },
-    count: {
-      min: 4,
-      max: 8
-    },
-    genre: "screenshot",
-    format: "png",
-    accepts: "png|jpg|gif",
-    fit: "cover",
-    text: "none",
-    safe: {
-      x: 0,
-      y: 0,
-      w: 1,
-      h: 1
-    },
-    notes: "First image is the hero."
-  },
-  {
-    id: "x-feed-image",
-    channel: "x",
-    asset: "feed-image",
-    label: "X feed image",
-    kind: "still",
-    ratio: "16:9",
-    px: {
-      w: 1200,
-      h: 675
-    },
-    genre: "card",
-    format: "png",
-    accepts: "png|jpg",
-    fit: "cover",
-    text: "allowed",
-    safe: {
-      x: 0.05,
-      y: 0.08,
-      w: 0.9,
-      h: 0.84
-    },
-    template: "split-cover",
-    notes: ""
-  },
-  {
-    id: "linkedin-feed-image",
-    channel: "linkedin",
-    asset: "feed-image",
-    label: "LinkedIn feed image",
-    kind: "still",
-    ratio: "400:209",
-    px: {
-      w: 1200,
-      h: 627
-    },
-    genre: "card",
-    format: "png",
-    accepts: "png|jpg",
-    fit: "cover",
-    text: "expected",
-    safe: {
-      x: 0.05,
-      y: 0.08,
-      w: 0.9,
-      h: 0.84
-    },
-    template: "split-cover",
-    notes: "1080\xD71350 vertical also performs in the mobile feed."
-  },
-  {
-    id: "og-card",
-    channel: "og",
-    asset: "card",
-    label: "OG card",
-    kind: "still",
-    ratio: "40:21",
-    px: {
-      w: 1200,
-      h: 630
-    },
-    genre: "card",
-    maxBytes: 1048576,
-    format: "png",
-    accepts: "png|jpg",
-    fit: "cover",
-    text: "expected",
-    safe: {
-      x: 0.05,
-      y: 0.0238,
-      w: 0.9,
-      h: 0.9524
-    },
-    template: "split-cover",
-    notes: "Text in the center ~1080\xD7600. Set twitter:card=summary_large_image explicitly \u2014 og:image alone gets the small card."
-  },
-  {
-    id: "github-social-preview",
-    channel: "github",
-    asset: "social-preview",
-    label: "GitHub social preview",
-    kind: "still",
-    ratio: "2:1",
-    px: {
-      w: 1280,
-      h: 640
-    },
-    genre: "card",
-    maxBytes: 1048576,
-    format: "png",
-    accepts: "png|jpg",
-    fit: "cover",
-    text: "expected",
-    safe: {
-      x: 0.0391,
-      y: 0.0781,
-      w: 0.9219,
-      h: 0.8438
-    },
-    template: "card-on-gradient",
-    notes: "Key text \u226550px from every edge."
   }
 ];
 function destinationById(id) {