@vosjs/cli 0.55.1 → 0.56.0

package/dist/cli.js

@@ -730,7 +730,7 @@ async function cmdCheck(argv) {
   return result.ok ? EXIT_OK : EXIT_ERROR;
 }
 async function delegate(argv, viaAlias = false) {
-  const { run } = await import("./run-QREATZCN.js");
+  const { run } = await import("./run-OIZ7NQPU.js");
   if (viaAlias && argv[0]) {
     process.stderr.write(
       `note: "vos voila ${argv[0]}" is now "vos ${argv[0]}".
@@ -770,7 +770,7 @@ async function main() {
     const engine = HELP_ENGINE.split("\n").filter(
       (l) => l.startsWith(`  vos ${cmd} `)
     );
-    const { verbHelp } = await import("./run-QREATZCN.js");
+    const { verbHelp } = await import("./run-OIZ7NQPU.js");
     const take = verbHelp(cmd);
     process.stdout.write(
       `${engine.join("\n")}
@@ -802,7 +802,7 @@ ${take.includes("no such verb") ? "" : take}`
 main().then(async (code) => {
   if (code === EXIT_OK) {
     const verb = process.argv[2] ?? "";
-    const { HELP } = await import("./run-QREATZCN.js");
+    const { HELP } = await import("./run-OIZ7NQPU.js");
     const documented = [
       ...helpFlagsFor(HELP_ENGINE, verb),
       ...helpFlagsFor(HELP, verb)

package/dist/index.js

@@ -18,7 +18,7 @@ import {
   takePaths,
   validateActions,
   waitForPageDone
-} from "./chunk-FQA7LFXG.js";
+} from "./chunk-XXAY42XS.js";
 import {
   BrowserUnavailableError,
   apiError,

package/dist/{run-QREATZCN.js → run-OIZ7NQPU.js}

@@ -6,7 +6,7 @@ import {
   takeBackdrop,
   takeBrowserArgs,
   verbHelp
-} from "./chunk-FQA7LFXG.js";
+} from "./chunk-XXAY42XS.js";
 import "./chunk-JX2YEL3M.js";
 import "./chunk-6XPFWQKP.js";
 export {
@@ -17,4 +17,4 @@ export {
   takeBrowserArgs,
   verbHelp
 };
-//# sourceMappingURL=run-QREATZCN.js.map
+//# sourceMappingURL=run-OIZ7NQPU.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.55.1",
+  "version": "0.56.0",
   "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",
@@ -51,10 +51,10 @@
     "acorn-walk": "^8.3.5",
     "mediabunny": "^1.55.7",
     "playwright": "^1.49.0",
-    "@vosjs/editor": "^1.4.0",
-    "@vosjs/elements": "^0.10.0",
     "@vosjs/core": "^0.25.5",
+    "@vosjs/editor": "^1.4.0",
     "@vosjs/shared": "^0.6.0",
+    "@vosjs/elements": "^0.10.0",
     "@vosjs/render-core": "^0.3.11",
     "@vosjs/studio-core": "^0.33.2",
     "@vosjs/timeline": "^0.4.1",

package/skills/VERSION

@@ -1 +1 @@
-0.15.0
+0.16.0

package/skills/vos-port/SKILL.md

@@ -169,7 +169,11 @@ approximation.
 3. **Scaffold**: `npx vos port scaffold` writes `port/program/program.mjs`
    (every word a bound element, every colour a key, the knobs, a label and a
    TODO per scene, each scene's words shown in its window, a painter only
-   when the inventory needs one), `doc.json` with the score as a track, and
+   when the inventory needs one, and the PAINTER STARTER as
+   `content.refs.lib` when the piece needs a painter or springs: Remotion's
+   `spring` to the frame, `springTo` for the timeline, `interpolate`,
+   `bezier`, seeded noise; never read another engine's source for these),
+   `doc.json` with the score as a track, and
    `port/REPORT.md` (substituted faces, gaps). Read the report first. On an
    older CLI, scaffold from `references/intro-port.mjs` by hand.
 4. **Translate scene by scene** with the tables, replacing each TODO. One
@@ -202,8 +206,8 @@ stated approximation:
 | a colour per split unit (`charStyle` making one letter red) | segments carry x/y/opacity/scale/rotation only: a separate element, or paint it |
 | `mixBlendMode` | no blend modes on elements: paint it |
 | a shape's colour as a knob | an svg's colours are compiled in (static `colors`): paint the shape if its colour must change live |
-| `spring()` | no spring ease in the dialect: a `back.out(n)` of the same shape, checked by eye |
-| `@remotion/noise`, SVG `feTurbulence` | the painter |
+| `spring()` | no spring EASE in the dialect; the scaffold's painter starter (cli 0.56+) has `lib.springTo`, Remotion's spring on the timeline a step per frame, exact. Older: `back.out(n)`, by eye |
+| `@remotion/noise`, SVG `feTurbulence` | the painter, on the starter's `lib.noise2D/noise3D` (the same character, not the same values) |
 | a group transform (scale the whole scene) | no element groups: tween each element the same way |
 
 Colours render as authored from `@vosjs/elements` 0.8.2 (older versions

package/skills/vos-port/references/remotion.md

@@ -16,7 +16,7 @@ rows name what has no element equivalent yet.
 | `useCurrentFrame()` | nothing in a tween (the timeline is the clock); `ctx.time * fps` inside `onFrame` |
 | `interpolate(f, [a, b], [x, y], { easing, extrapolate: 'clamp' })` | `tl.fromTo(props, { p: x }, { p: y, duration: (b - a) / fps, ease }, a / fps)` |
 | `Easing.bezier(x1, y1, x2, y2)` | `ease: 'css-bezier(x1, y1, x2, y2)'` (exact) |
-| `spring({ frame, fps, config })` | GAP: no spring ease; `back.out(n)` of a similar overshoot, checked by eye |
+| `spring({ frame, fps, config })` | the painter starter (cli 0.56+): `content.refs.lib.springTo(tl, props, { y: [from, to] }, at, { fps, config })` puts Remotion's own spring on the timeline, a step per frame, exact to the frame; `lib.spring({ frame, fps, config })` is the value (`durationInFrames`, `delay`, `overshootClamping` as Remotion's). On an older CLI: `back.out(n)` of a similar overshoot, by eye |
 | `<Sequence from durationInFrames>` | `tl.addLabel(name, from / fps)` and the scene's elements tweened in and out inside that window |
 | `<TransitionSeries>` + `fade()` | opacity tweens across the overlap window |
 | `<AbsoluteFill>` + flex centring | `position: 'center'`; offsets in `transform: { translateX, translateY }` (design px) |
@@ -31,7 +31,7 @@ rows name what has no element equivalent yet.
 | `<Audio src={staticFile('s.mp3')} />` | `doc.json` `audio: [{ key: 's.mp3', start, in, out, duration, gain, fadeIn, fadeOut }]` |
 | `<Video>` / `<OffthreadVideo>` | a `video` element, windowed by opacity; a source in-point is not supported yet |
 | `@remotion/google-fonts` `loadFont()` | `fonts: [{ family, weight, url }]` from `https://vos.so/api/fonts`; a face the catalog lacks is substituted and said |
-| `@remotion/noise` `noise3D`, SVG `feTurbulence` grain | the painter, reading its seed and amounts from `data` |
+| `@remotion/noise` `noise3D`, SVG `feTurbulence` grain | the painter, with `content.refs.lib.noise2D/noise3D(seed, …)` (cli 0.56+: seeded simplex, the character of `@remotion/noise`, not its values, so match by eye), reading its seed and amounts from `data` |
 | `mixBlendMode` | GAP: the painter |
 | an inline `<svg>` shape | an `svg` element (`src` is the markup); its colours are static, so a shape colour that must be a knob is painted |
 | a solid background | `ctx.scene.background = new ctx.THREE.Color(ctx.data.ink)` in `createContent`, `.set(ctx.data.ink)` in `onFrame` |