@vosjs/cli 0.53.2 → 0.53.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.53.2",
+  "version": "0.53.3",
   "description": "The vos CLI: record the real product from a scripted browser flow, auto-zoom from the cursor track, cut as data in doc.json, render deterministic video and stills, deliver a release's media per destination spec, and sync with vos.so. One binary, every verb, MIT.",
   "type": "module",
   "license": "MIT",

package/skills/VERSION

@@ -1 +1 @@
-0.9.0
+0.9.1

package/skills/vos-port/SKILL.md

@@ -60,8 +60,11 @@ not in `node_modules`.
    (`@vosjs/cli` 0.52+). Never a `data:` URI in an audio element.
 8. **Faces from the catalog.** `fonts: [{ family, weight, url }]` with
    `https://assets.vos.so/fonts/<slug>/<weight>.woff2` (`GET
-   https://vos.so/api/fonts`). A face the catalog lacks is SUBSTITUTED and
-   the substitution is said in the push note.
+   https://vos.so/api/fonts`). An italic the catalog hosts is in the
+   family's `italicFiles` (`<weight>-italic.woff2`): declare it as its own
+   entry with `style: 'italic'` and set `font.style: 'italic'` on the
+   element. A face the catalog lacks is SUBSTITUTED and the substitution is
+   said in the push note.
 
 ## The coordinates, measured (these cost the reference port three rounds)
 
@@ -73,15 +76,17 @@ not in `node_modules`.
 - **`rotation` is degrees, counter-clockwise**: CSS `rotate(12deg)` is
   `rotation: -12`.
 - **A static offset goes in the config**, `transform: { translateX,
-  translateY }` in design pixels, never a `tl.set` on `props.x/y`, for any
-  text whose content or colour changes live: every re-raster lays the
-  element out again from its config and drops a tweened position.
-- **Text that `onFrame` writes is missing from a still.** A scramble or a
-  counter written into `props.content` each frame shows in `vos render`
-  output (a frame late) and is BLANK in `vos still` and in the vos.so
-  thumbnail. Check it in a rendered frame, and set the program's cover
-  (`vos push --still <t>`, cli 0.53+) at a moment where that text is not the
-  point.
+  translateY }` in design pixels, and motion on `props.x/y`. A re-raster
+  (new words, a new colour) keeps the offset a tween added from
+  `@vosjs/elements` 0.8.3; before it the element snapped back to its
+  config position.
+- **Text that `onFrame` writes is in its own frame** from `@vosjs/core`
+  0.25.2: a scramble or a counter written into `props.content` shows in
+  `vos still`, the vos.so thumbnail and every exported frame. Before it the
+  text landed a frame late in video and a still showed another frame's
+  words, so a program compiled earlier gains the fix on its next push.
+  Still choose the program's cover (`vos push --still <t>`, cli 0.53+) at
+  the moment that sells it.
 - **Transform origin is the centre.** Remotion's `transformOrigin: 'right
   center'` with `scaleX` becomes a centre scale plus an `x` tween that keeps
   the right edge still: `{ scaleX: 0, x: x0 + (width / 2) * k }`.
@@ -166,9 +171,8 @@ approximation.
    ```
 
    A number does not catch a missing element: look at every side-by-side.
-   Stills are for layout; text that `onFrame` writes shows in `vos render`
-   output, not in `vos still` (a known capture gap), so check it in a
-   rendered frame.
+   Text that `onFrame` writes is in the still too (core 0.25.2+); on an
+   older CLI check it in a rendered frame.
 6. **Knob honesty**: one `--set data.<key>=<value>` still per param.
 7. **Push** with the score: `vos push config.json --folder <slug> --label
    "port of <source>" --note "<what was substituted, what is a painter>"

package/skills/vos-port/references/elements-and-context.md

@@ -1,4 +1,4 @@
-<!-- Generated by scripts/build-element-reference.mjs from @vosjs/core 0.25.1, @vosjs/elements 0.8.2 and @vosjs/timeline 0.4.1. Do not edit by hand: re-run the script. -->
+<!-- Generated by scripts/build-element-reference.mjs from @vosjs/core 0.25.2, @vosjs/elements 0.8.3 and @vosjs/timeline 0.4.1. Do not edit by hand: re-run the script. -->
 
 # Elements, the context and eases: the declarations
 
@@ -327,13 +327,20 @@ elements.
  * GSAP-animatable properties exposed on each element instance
  */
 interface ElementProps {
+    /**
+     * RENDER pixels from the frame centre, x right, y DOWN. Unlike every config
+     * number (design px of a 1080-high frame), so an offset authored in design
+     * px is scaled: `x0 + dx * (ctx.resolution.height / 1080)`.
+     */
     x: number;
+    /** RENDER pixels from the frame centre, y DOWN (see `x`). */
     y: number;
     z: number;
     opacity: number;
     scale: number;
     scaleX: number;
     scaleY: number;
+    /** Degrees, counter-clockwise (CSS `rotate(12deg)` is `rotation: -12`). */
     rotation: number;
     rotationX: number;
     rotationY: number;
@@ -389,6 +396,12 @@ interface ElementInstance {
      * face landing after first paint re-draws over the fallback stack).
      */
     refreshRaster?: () => boolean;
+    /**
+     * Apply queued raster writes now. The engine's frame calls it for every
+     * element after onFrame and before the draw, so text written in a frame is
+     * in that frame (stills included). A no-op when nothing is queued.
+     */
+    flushRaster?: () => void;
     /** Re-rasterize canvas-backed textures for a new output resolution */
     updateResolution?: (resolution: unknown) => boolean;
     /** Remove element from scene */

package/skills/vos-port/references/intro-port.mjs

@@ -110,8 +110,8 @@ const config = {
     {
       id: 'subtitle',
       type: 'text',
-      // Bound to the full words: onFrame writes each frame's string, and a
-      // still capture, which misses onFrame's writes, shows these words.
+      // Bound to the full words: onFrame writes each frame's string over
+      // them, and a knob on `subtitle` changes what the scramble resolves to.
       content: { $data: 'subtitle' },
       font: { family: 'JetBrains Mono', size: 26, weight: 500, color: { $data: 'paper' }, letterSpacing: 6 },
       position: 'center',