@vibeframe/cli 0.115.8 → 0.115.10

package/dist/commands/_shared/image-cost.d.ts

@@ -3,13 +3,13 @@
  *
  * Without these, real runs reported `costUsd: 0`, which reads as "free" to
  * agents that gate spend on the JSON envelope. Values are upper bounds from
- * provider list prices (checked 2026-10-04, see
+ * provider list prices (checked 2026-10-17, see
  * `.agents/references/providers/`), not metered billing:
  * - OpenAI: high quality at 1024x1024 (we default to medium).
- * - Gemini: 1K output, Nano Banana Pro at 1K-2K.
+ * - Gemini: the requested size's price (1K when none is asked for).
  * - Grok: grok-imagine-image-2.0 at its 2K medium price.
  */
-export declare function estimateImageCostUsd(provider: string, model: string | undefined, count: number): {
+export declare function estimateImageCostUsd(provider: string, model: string | undefined, count: number, resolution?: string): {
     costUsd: number;
     warnings: string[];
 };

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/_shared/storyboard-draft.d.ts

@@ -1,3 +1,17 @@
+/**
+ * @module _shared/storyboard-draft
+ *
+ * The offline storyboard skeleton `vibe init --from "<brief>"` writes.
+ *
+ * Without a model this cannot know what the video says, so it does not
+ * pretend to: beats come from the brief's own outline when it has one
+ * ("hook, buoyancy, folding tip"), each beat gets a backdrop prompt from
+ * its topic and the brief, and narration is left for the composer
+ * (`storyboard revise`), the host agent, or the user to write. A skeleton
+ * that renders silently is better than one that narrates someone else's
+ * script. When a composer key is set, `init` hands this skeleton to the
+ * composer, which writes the real draft.
+ */
 import type { VisualStyle } from "./visual-styles.js";
 export interface StoryboardDraft {
     storyboardMd: string;

package/dist/commands/_shared/storyboard-revise.d.ts

@@ -1,14 +1,19 @@
-import type { AgentMessage } from "../../agent/types.js";
+import { type TextGenerator } from "@vibeframe/ai-providers";
 import { type ComposerProvider } from "./composer-resolve.js";
 import { type StoryboardValidationResult } from "./storyboard-edit.js";
-export type StoryboardRevisionChat = (messages: AgentMessage[]) => Promise<string>;
 export interface StoryboardRevisionOptions {
     projectDir: string;
     request: string;
     durationSec?: number;
     composer?: ComposerProvider;
     dryRun?: boolean;
-    chat?: StoryboardRevisionChat;
+    /**
+     * "draft" writes a storyboard for `request` (a brief) on top of the
+     * skeleton `vibe init --from` scaffolds, instead of editing an authored one.
+     */
+    mode?: "revise" | "draft";
+    /** Overrides the composer's text generator (tests). */
+    generator?: TextGenerator;
 }
 export interface StoryboardRevisionResult {
     schemaVersion: "1";

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`.