@vibeframe/cli 0.115.8 → 0.115.9

package/dist/commands/_shared/lottie.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module _shared/lottie
+ *
+ * Pieces shared by the two places VibeFrame draws a Lottie animation in a
+ * Hyperframes page: `vibe edit motion-overlay --asset` (a standalone layer
+ * page) and `vibe scene add --lottie` (a canvas inside a scene).
+ *
+ * Both drive a dotLottie player frame by frame from the render's seek
+ * instead of letting it autoplay, so every captured frame is the frame for
+ * that time. Both load the runtime from files copied next to the page, not
+ * from a CDN, so a render works offline and never depends on the network.
+ */
+export type LottiePosition = "full" | "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export declare const LOTTIE_POSITIONS: readonly LottiePosition[];
+/** Reject files dotLottie cannot open before spending a browser render on them. */
+export declare function checkLottieAsset(path: string): Promise<string | undefined>;
+/** CSS box for the overlay canvas, in pixels of the layer. */
+export declare function overlayBox(layer: {
+    width: number;
+    height: number;
+}, position: LottiePosition, scale: number): {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+/** File names of the dotLottie runtime inside the vendor directory. */
+export declare const DOTLOTTIE_SCRIPT = "dotlottie-web.js";
+export declare const DOTLOTTIE_WASM = "dotlottie-player.wasm";
+/** Copy the dotLottie runtime (ESM build plus its WASM) into `dir`. */
+export declare function copyDotLottieRuntime(dir: string): Promise<void>;
+/**
+ * Browser-side JavaScript: `loadDotLottie(vendorDir)` imports the runtime
+ * from a directory relative to the page and points it at the WASM, and
+ * `setLottieTime(player, t, loop)` shows the frame for `t` seconds.
+ * The render server sends .wasm without application/wasm, which makes
+ * WebAssembly.instantiateStreaming reject it, so the WASM goes through a
+ * typed Blob URL.
+ */
+export declare const DOTLOTTIE_BROWSER_HELPERS = "async function loadDotLottie(vendorDir) {\n    const url = (file) => new URL(vendorDir + \"/\" + file, document.baseURI).href;\n    const { DotLottie } = await import(url(\"dotlottie-web.js\"));\n    const wasm = await (await fetch(url(\"dotlottie-player.wasm\"))).arrayBuffer();\n    DotLottie.setWasmUrl(URL.createObjectURL(new Blob([wasm], { type: \"application/wasm\" })));\n    return DotLottie;\n  }\n  function setLottieTime(player, t, loop) {\n    const length = player.duration;\n    const frames = player.totalFrames;\n    if (!(length > 0) || !(frames > 0)) return;\n    const local = Math.max(0, Number(t) || 0);\n    const at = loop ? local % length : Math.min(local, length);\n    player.setFrame(Math.min(frames - 1, (at / length) * frames));\n  }";

package/dist/commands/_shared/lottie.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/_shared/scene-html-emit.d.ts

@@ -15,6 +15,7 @@
  * Pure functions only — no I/O. The orchestrating command (`scene add`) wires
  * these to the filesystem.
  */
+import { LOTTIE_POSITIONS, type LottiePosition } from "./lottie.js";
 export type ScenePreset = "simple" | "announcement" | "explainer" | "kinetic-type" | "product-shot";
 export declare const SCENE_PRESETS: readonly ScenePreset[];
 /**
@@ -27,12 +28,9 @@ export interface SceneTranscriptWord {
     start: number;
     end: number;
 }
-/**
- * Position value for Lottie overlays. Mirrors the vocabulary used by
- * `vibe edit motion-overlay --position`.
- */
-export type LottiePosition = "full" | "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
-export declare const LOTTIE_POSITIONS: readonly LottiePosition[];
+export { LOTTIE_POSITIONS, type LottiePosition };
+/** Project-relative directory `vibe scene add --lottie` copies the dotLottie runtime into. */
+export declare const LOTTIE_RUNTIME_DIR = "assets/vendor/dotlottie";
 export interface LottieOverlayInput {
     /** Project-relative path to the `.json` or `.lottie` file (e.g. "assets/logo.lottie"). */
     src: string;
@@ -74,9 +72,10 @@ export interface EmitSceneInput {
      */
     transcript?: SceneTranscriptWord[];
     /**
-     * Optional Lottie animation overlay. When supplied, a `<dotlottie-wc>`
-     * element is layered on top of the preset's content. Uses the same
-     * position/scale/opacity vocabulary as `vibe edit motion-overlay`.
+     * Optional Lottie animation overlay, drawn on a canvas above the preset's
+     * content. Uses the same position/scale/opacity vocabulary as
+     * `vibe edit motion-overlay`. Needs the dotLottie runtime in
+     * {@link LOTTIE_RUNTIME_DIR}.
      */
     lottie?: LottieOverlayInput;
 }

package/dist/commands/_shared/scene-lottie.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/edit/lottie-overlay.d.ts

@@ -12,7 +12,8 @@
  *   2. FFmpeg overlays that layer onto the original video at `start`,
  *      keeping the source resolution, frame rate, and audio.
  */
-export type LottiePosition = "full" | "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+import { type LottiePosition } from "../_shared/lottie.js";
+export type { LottiePosition };
 export interface LottieOverlayOptions {
     videoPath: string;
     assetPath: string;
@@ -43,18 +44,6 @@ export interface VideoStreamInfo {
 }
 /** Probe the first video stream. Width/height are swapped for 90/270 degree rotations, as FFmpeg autorotates on decode. */
 export declare function probeVideoStream(path: string): Promise<VideoStreamInfo>;
-/** Reject files dotLottie cannot open before spending a browser render on them. */
-export declare function checkLottieAsset(path: string): Promise<string | undefined>;
-/** CSS box for the overlay canvas, in pixels of the layer. */
-export declare function overlayBox(layer: {
-    width: number;
-    height: number;
-}, position: LottiePosition, scale: number): {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-};
 /**
  * The layer page. `window.__hf` is published only after the animation has
  * loaded, because the producer starts capturing once `__hf.duration > 0`.