@vibeframe/cli 0.115.7 → 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/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-inspect.d.ts

@@ -54,4 +54,3 @@ export interface ProjectInspectResult {
     reportPath?: string;
 }
 export declare function inspectProject(opts: ProjectInspectOptions): Promise<ProjectInspectResult>;
-export declare function displayIssue(issue: ReviewIssue): string;

package/dist/commands/_shared/scene-render.d.ts

@@ -2,11 +2,8 @@
  * @module _shared/scene-render
  *
  * Render a VibeFrame scene project to MP4/WebM/MOV using the Hyperframes
- * producer directly. Unlike the FFmpeg-bridge backend in
- * `pipeline/renderers/hyperframes.ts` which has to convert a `TimelineState`
- * into a temp Hyperframes project, scene projects already ARE Hyperframes
- * projects — so we hand the producer the user's project dir and entry file
- * verbatim.
+ * producer directly. Scene projects already ARE Hyperframes projects, so
+ * we hand the producer the user's project dir and entry file verbatim.
  *
  * `executeSceneRender()` is decoupled from CLI flags so that the C6 agent
  * tool and the C5 `--format scenes` pipeline can call it the same way. It
@@ -126,10 +123,7 @@ export declare function buildRenderConfig(opts: {
 };
 export declare function buildMediaOpenCommand(action: RenderOpenAction, filePath: string, platform?: NodeJS.Platform): MediaOpenCommand;
 /**
- * Render a scene project. Mirrors the contract of the existing Hyperframes
- * backend (preflight → execute → structured result), but skips the
- * `TimelineState` → temp project conversion because the user's project is
- * already a valid Hyperframes project.
+ * Render a scene project: preflight → execute → structured result.
  */
 export declare function executeSceneRender(opts?: SceneRenderOptions): Promise<SceneRenderResult>;
 export interface BeatRenderRootResult {

package/dist/commands/ai-analyze.d.ts

@@ -3,7 +3,7 @@
  *
  * Media analysis execute functions using Gemini multimodal AI.
  *
- * CLI commands: gemini-video, analyze
+ * Powers `vibe inspect media` and the matching agent/MCP tools.
  *
  * Execute functions:
  *   executeGeminiVideo - Analyze video files or YouTube URLs with Gemini
@@ -11,7 +11,6 @@
  *
  * @dependencies Gemini (Google)
  */
-import { Command } from "commander";
 /** Options for {@link executeGeminiVideo}. */
 export interface GeminiVideoOptions {
     /** Video file path or YouTube URL */
@@ -102,4 +101,3 @@ export interface AnalyzeResult {
  * @returns Result with Gemini's response, detected source type, and token usage
  */
 export declare function executeAnalyze(options: AnalyzeOptions): Promise<AnalyzeResult>;
-export declare function registerAnalyzeCommands(aiCommand: Command): void;

package/dist/commands/ai-helpers.d.ts

@@ -12,14 +12,6 @@ import { Project } from "../engine/index.js";
  * `SuggestEditEntry`, which omits the optional `id`/`previewUrl`.
  */
 export type ApplicableSuggestion = Pick<EditSuggestion, "type" | "clipIds" | "params">;
-/**
- * Download a video from URL, handling Veo/Google API authentication.
- * Uses x-goog-api-key header (not query param) for Google API URLs.
- *
- * @param url - Video URL to download
- * @param apiKey - Google API key (caller should resolve from env/config)
- */
-export declare function downloadVideo(url: string, apiKey?: string): Promise<Buffer>;
 /** Format a duration in seconds to m:ss.s display format */
 export declare function formatTime(seconds: number): string;
 /** Apply a single AI edit suggestion to a project */

package/dist/commands/ai-image.d.ts

@@ -66,12 +66,6 @@ export interface ImageEditResult {
     errorKind?: ProviderErrorKind;
 }
 export declare function executeImageEdit(options: ImageEditOptions): Promise<ImageEditResult>;
-/** @deprecated Use `executeImageEdit`; kept for callers that predate other edit providers. */
-export type GeminiEditOptions = Omit<ImageEditOptions, "provider">;
-/** @deprecated Use `executeImageEdit`. */
-export type GeminiEditResult = ImageEditResult;
-/** @deprecated Use `executeImageEdit`. */
-export declare function executeGeminiEdit(options: GeminiEditOptions): Promise<ImageEditResult>;
 export interface ThumbnailBestFrameOptions {
     videoPath: string;
     outputPath: string;

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

@@ -0,0 +1,65 @@
+/**
+ * @module edit/lottie-overlay
+ *
+ * `vibe edit motion-overlay <video> --asset <file.lottie|file.json>`.
+ *
+ * Two passes, so the source video is never re-rendered through a browser:
+ *
+ *   1. Hyperframes renders only the Lottie layer, at the source's display
+ *      size, to ProRes 4444 with alpha. The page drives a dotLottie player
+ *      frame by frame from `window.__hf.seek`, so every frame is
+ *      deterministic and nothing depends on wall-clock playback.
+ *   2. FFmpeg overlays that layer onto the original video at `start`,
+ *      keeping the source resolution, frame rate, and audio.
+ */
+import { type LottiePosition } from "../_shared/lottie.js";
+export type { LottiePosition };
+export interface LottieOverlayOptions {
+    videoPath: string;
+    assetPath: string;
+    outputPath: string;
+    /** Seconds into the video where the overlay appears. */
+    start: number;
+    /** Seconds the overlay stays on screen. */
+    duration: number;
+    position: LottiePosition;
+    /** Fraction of the frame the overlay box spans (ignored for `full`). */
+    scale: number;
+    opacity: number;
+    loop: boolean;
+}
+export interface LottieOverlayResult {
+    success: boolean;
+    outputPath?: string;
+    error?: string;
+    /** How to fix a failure that retrying will not fix. */
+    suggestion?: string;
+}
+export interface VideoStreamInfo {
+    /** Display size, after any rotation metadata is applied. */
+    width: number;
+    height: number;
+    fps: number;
+    duration: number;
+}
+/** 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>;
+/**
+ * The layer page. `window.__hf` is published only after the animation has
+ * loaded, because the producer starts capturing once `__hf.duration > 0`.
+ */
+export declare function lottieLayerHtml(opts: {
+    width: number;
+    height: number;
+    duration: number;
+    assetUrl: string;
+    box: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    opacity: number;
+    loop: boolean;
+}): string;
+export declare function renderLottieOverlay(options: LottieOverlayOptions): Promise<LottieOverlayResult>;

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

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

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

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

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

@@ -1,7 +1,8 @@
 import { Command } from "commander";
 import { type MotionCommandOptions } from "../ai-motion.js";
+import { type LottiePosition } from "./lottie-overlay.js";
 export type MotionOverlayUnderstand = "auto" | "off" | "required";
-export type MotionOverlayPosition = "full" | "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export type MotionOverlayPosition = LottiePosition;
 export interface MotionOverlayOptions {
     videoPath: string;
     description?: string;
@@ -25,6 +26,10 @@ export interface MotionOverlayResult {
     renderedPath?: string;
     provider?: "remotion" | "lottie";
     error?: string;
+    /** How to fix a failure that a retry will not fix. */
+    suggestion?: string;
+    /** False for deterministic local failures (bad asset, missing Chrome/FFmpeg). */
+    retryable?: boolean;
 }
 export declare function executeMotionOverlay(options: MotionOverlayOptions): Promise<MotionOverlayResult>;
 export declare function registerMotionOverlayCommand(parent: Command): void;

package/dist/commands/generate.d.ts

@@ -18,8 +18,6 @@
 import { Command } from "commander";
 export { executeSoundEffect } from "./generate/sound-effect.js";
 export type { ExecuteSoundEffectOptions, ExecuteSoundEffectResult, } from "./generate/sound-effect.js";
-export { executeMusicStatus } from "./generate/music-status.js";
-export type { ExecuteMusicStatusOptions, ExecuteMusicStatusResult, } from "./generate/music-status.js";
 export { executeStoryboard } from "./generate/storyboard.js";
 export type { ExecuteStoryboardOptions, ExecuteStoryboardResult } from "./generate/storyboard.js";
 export { executeSpeech } from "./generate/speech.js";

package/dist/commands/output.d.ts

@@ -40,7 +40,6 @@ export declare function apiError(msg: string, retryable?: boolean): StructuredEr
  */
 export declare function providerFailure(message: string, kind?: string): StructuredError;
 export declare function notFoundError(path: string): StructuredError;
-export declare function networkError(msg: string): StructuredError;
 export declare function generalError(msg: string, suggestion?: string): StructuredError;
 /**
  * The `--max-cost` refusal. A command that declines to spend is a failure, so
@@ -114,8 +113,6 @@ export declare function outputResult(result: Record<string, unknown>): void;
 export declare function log(...args: unknown[]): void;
 /** Create a spinner that is silent in JSON/quiet mode */
 export declare function spinner(text: string): ReturnType<typeof ora>;
-/** Suggest next steps - only in human interactive mode */
-export declare function suggestNext(tip: string): void;
 export declare function emitDeprecationWarning(oldName: string, newName: string, removeIn: string): void;
 /** Test-only: reset deduplication memory between cases. */
 export declare function _resetDeprecationMemoryForTesting(): void;

package/dist/commands/sanitize.d.ts

@@ -8,11 +8,6 @@
  * fake system prompts, and markdown-disguised commands.
  */
 export declare function sanitizeLLMResponse(text: string): string;
-/**
- * Sanitize a file path returned by an AI model.
- * Prevents path traversal and null byte injection.
- */
-export declare function sanitizeFilePath(path: string): string;
 /**
  * Sanitize structured data from AI responses (e.g., JSON parsed results).
  * Recursively sanitizes all string values.

package/dist/commands/validate.d.ts

@@ -20,14 +20,3 @@ export declare function validateResourceId(id: string): string;
  * Prevents terminal injection and other control-char exploits.
  */
 export declare function rejectControlChars(input: string): string;
-/**
- * Validate a media file path and check its extension against an allowlist.
- */
-export declare function validateMediaFile(path: string, allowedExts: string[]): string;
-/** Common media file extensions */
-export declare const MEDIA_EXTS: {
-    video: string[];
-    audio: string[];
-    image: string[];
-    subtitle: string[];
-};

package/dist/config/index.d.ts

@@ -21,10 +21,6 @@ export type Scope = "user" | "project";
 export declare const USER_CONFIG_DIR: string;
 /** User-scope config file (~/.vibeframe/config.yaml by default). */
 export declare const USER_CONFIG_PATH: string;
-/** User data directory (~/.local/share/vibeframe by default). */
-export declare const USER_DATA_DIR: string;
-/** User cache directory (~/.vibeframe/cache by default). */
-export declare const USER_CACHE_DIR: string;
 /** Legacy user-scope config directory used by pre-XDG installs. */
 export declare const LEGACY_USER_CONFIG_DIR: string;
 /** Legacy user-scope config file used by pre-XDG installs. */
@@ -101,10 +97,5 @@ export declare function isConfigured(options?: Pick<LoadConfigOptions, "cwd">):
  * the provider's environment variable if neither config has it.
  */
 export declare function getApiKeyFromConfig(providerKey: string, options?: Pick<LoadConfigOptions, "cwd">): Promise<string | undefined>;
-/**
- * Update a provider key in the active scope (project if present, else user).
- * Pass `{scope}` to force a specific destination.
- */
-export declare function updateProviderKey(providerKey: string, apiKey: string, options?: SaveConfigOptions): Promise<void>;
 export type { VibeConfig, LLMProvider } from "./schema.js";
 export { createDefaultConfig, PROVIDER_NAMES, PROVIDER_ENV_ALIASES, PROVIDER_ENV_VARS, } from "./schema.js";