@vosjs/studio-core 0.40.2 → 0.41.0

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

@@ -7766,6 +7766,45 @@ var ON_FRAME = `(ctx, content, dt) => {
   if (bg.texture) bg.texture.needsUpdate = true
   }
 
+  // The two painters every pass shares, and the overlay layer after the
+  // loop too (the cam bubble, the dot across a boundary). They stand OUTSIDE
+  // the loop on purpose: the program runs as a module, so it is strict, and
+  // in strict code a function declared in a block exists only in that block.
+  function rr(x, y, w, h, rd, cx) {
+    var cc = cx || c
+    if (cc.roundRect) { cc.beginPath(); cc.roundRect(x, y, w, h, rd) }
+    else { cc.beginPath(); cc.rect(x, y, w, h) }
+  }
+
+  // The pointer's shape: an OS-style arrow (tip on the recorded point, a
+  // black body with a white edge, the shape of the pointer on the viewer's
+  // own screen) or the white dot every earlier take was cut with. One
+  // painter for both draw sites (in the card, and the ghost across a
+  // boundary); r is the dot's radius, so an arrow stands 2r tall.
+  var curArrow = !!(d.cursorStyle && d.cursorStyle.style === 'arrow')
+  function drawCur(cc, x, y, r, a, lw) {
+    cc.save()
+    if (curArrow) {
+      var h = 2 * r
+      var P = [[0, 0], [0, 0.72], [0.19, 0.55], [0.31, 0.83], [0.43, 0.78], [0.31, 0.5], [0.55, 0.5]]
+      cc.beginPath()
+      cc.moveTo(x, y)
+      for (var pi = 1; pi < P.length; pi++) cc.lineTo(x + P[pi][0] * h, y + P[pi][1] * h)
+      cc.closePath()
+      cc.lineJoin = 'round'
+      cc.fillStyle = 'rgba(0,0,0,' + (0.92 * a) + ')'
+      cc.strokeStyle = 'rgba(255,255,255,' + (0.95 * a) + ')'
+      cc.lineWidth = Math.max(1, lw * 0.75)
+      cc.fill(); cc.stroke()
+    } else {
+      cc.fillStyle = 'rgba(255,255,255,' + (0.95 * a) + ')'
+      cc.strokeStyle = 'rgba(0,0,0,' + (0.4 * a) + ')'
+      cc.lineWidth = lw
+      cc.beginPath(); cc.arc(x, y, r, 0, Math.PI * 2); cc.fill(); cc.stroke()
+    }
+    cc.restore()
+  }
+
   // The card paints in PASSES: the ghost first (the outgoing clip's last
   // frame on its own canvas, while a boundary is crossing), then the live
   // card. A pass swaps the canvas, the element, the media, the source
@@ -7880,12 +7919,6 @@ var ON_FRAME = `(ctx, content, dt) => {
     shRgb = parseInt(shHex.slice(1, 3), 16) + ',' + parseInt(shHex.slice(3, 5), 16) + ',' + parseInt(shHex.slice(5, 7), 16)
   }
 
-  function rr(x, y, w, h, rd, cx) {
-    var cc = cx || c
-    if (cc.roundRect) { cc.beginPath(); cc.roundRect(x, y, w, h, rd) }
-    else { cc.beginPath(); cc.rect(x, y, w, h) }
-  }
-
   c.save()
   // d.zoomSuppressed = editor aiming mode: the host merges it into ctx.data
   // while the focus overlay is up so the full frame renders. Never persisted.
@@ -8062,35 +8095,6 @@ var ON_FRAME = `(ctx, content, dt) => {
   // cursor coordinate space + drawn radius (shared by click effects + the dot)
   var space = (actM ? actM.cursorSpace : d.cursorSpace) || { w: vw, h: vh }
   var curSize = ((d.cursorStyle && d.cursorStyle.size) || 24) * s2 * 0.5
-  // The pointer's shape: an OS-style arrow (tip on the recorded point, a
-  // black body with a white edge, the shape of the pointer on the viewer's
-  // own screen) or the white dot every earlier take was cut with. One
-  // painter for both draw sites (in the card, and the ghost across a
-  // boundary); r is the dot's radius, so an arrow stands 2r tall.
-  var curArrow = !!(d.cursorStyle && d.cursorStyle.style === 'arrow')
-  function drawCur(cc, x, y, r, a, lw) {
-    cc.save()
-    if (curArrow) {
-      var h = 2 * r
-      var P = [[0, 0], [0, 0.72], [0.19, 0.55], [0.31, 0.83], [0.43, 0.78], [0.31, 0.5], [0.55, 0.5]]
-      cc.beginPath()
-      cc.moveTo(x, y)
-      for (var pi = 1; pi < P.length; pi++) cc.lineTo(x + P[pi][0] * h, y + P[pi][1] * h)
-      cc.closePath()
-      cc.lineJoin = 'round'
-      cc.fillStyle = 'rgba(0,0,0,' + (0.92 * a) + ')'
-      cc.strokeStyle = 'rgba(255,255,255,' + (0.95 * a) + ')'
-      cc.lineWidth = Math.max(1, lw * 0.75)
-      cc.fill(); cc.stroke()
-    } else {
-      cc.fillStyle = 'rgba(255,255,255,' + (0.95 * a) + ')'
-      cc.strokeStyle = 'rgba(0,0,0,' + (0.4 * a) + ')'
-      cc.lineWidth = lw
-      cc.beginPath(); cc.arc(x, y, r, 0, Math.PI * 2); cc.fill(); cc.stroke()
-    }
-    cc.restore()
-  }
-
   // click effects \u2014 pure f(t): d.clicks are
   // OUTPUT-anchored records baked at lowering (sorted by ot; re-baked on every
   // edit, so they can't go stale), drawn UNDER the cursor and inside the zoom
@@ -10274,14 +10278,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,
@@ -10291,14 +10294,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)."
   },
   {
@@ -10306,7 +10302,6 @@ var DESTINATIONS = [
     channel: "x",
     asset: "feed-cut",
     label: "X feed cut",
-    kind: "video",
     ratio: "16:9",
     px: {
       w: 1920,
@@ -10317,14 +10312,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."
   },
   {
@@ -10332,7 +10320,6 @@ var DESTINATIONS = [
     channel: "shorts-linkedin",
     asset: "vertical-cut",
     label: "Shorts / LinkedIn vertical cut",
-    kind: "video",
     ratio: "9:16",
     px: {
       w: 1080,
@@ -10342,14 +10329,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."
   },
   {
@@ -10357,7 +10337,6 @@ var DESTINATIONS = [
     channel: "github",
     asset: "readme-loop",
     label: "GitHub README loop",
-    kind: "video",
     ratio: "16:9",
     px: {
       w: 1920,
@@ -10368,298 +10347,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) {