vargai 0.4.0-alpha13 → 0.4.0-alpha14

package/package.json

@@ -64,7 +64,7 @@
     "replicate": "^1.4.0",
     "zod": "^4.2.1"
   },
-  "version": "0.4.0-alpha13",
+  "version": "0.4.0-alpha14",
   "exports": {
     ".": "./src/index.ts",
     "./ai": "./src/ai-sdk/index.ts",

package/src/cli/commands/render.ts

@@ -1,14 +1,32 @@
 import { existsSync, mkdirSync } from "node:fs";
-import { dirname, resolve } from "node:path";
+import { resolve } from "node:path";
 import { defineCommand } from "citty";
 import { render } from "../../react/render";
-import type { RenderMode, VargElement } from "../../react/types";
+import type { DefaultModels, RenderMode, VargElement } from "../../react/types";
 
 const AUTO_IMPORTS = `/** @jsxImportSource vargai */
 import { Animate, Captions, Clip, Image, Music, Overlay, Packshot, Render, Slider, Speech, Split, Subtitle, Swipe, TalkingHead, Title, Video, Grid, SplitLayout } from "vargai/react";
 import { fal, elevenlabs, replicate } from "vargai/ai";
 `;
 
+async function detectDefaultModels(): Promise<DefaultModels | undefined> {
+  const defaults: DefaultModels = {};
+
+  if (process.env.FAL_KEY) {
+    const { fal } = await import("../../ai-sdk/providers/fal");
+    defaults.image = fal.imageModel("flux-schnell");
+    defaults.video = fal.videoModel("wan-2.5");
+  }
+
+  if (process.env.ELEVENLABS_API_KEY) {
+    const { elevenlabs } = await import("../../ai-sdk/providers/elevenlabs");
+    defaults.speech = elevenlabs.speechModel("eleven_multilingual_v2");
+    defaults.music = elevenlabs.musicModel("music_v1");
+  }
+
+  return Object.keys(defaults).length > 0 ? defaults : undefined;
+}
+
 async function loadComponent(filePath: string): Promise<VargElement> {
   const resolvedPath = resolve(filePath);
   const source = await Bun.file(resolvedPath).text();
@@ -130,10 +148,13 @@ export const renderCmd = defineCommand({
 
     const useCache = !args["no-cache"] && mode !== "preview";
 
+    const defaults = await detectDefaultModels();
+
     const buffer = await render(component, {
       output: outputPath,
       cache: useCache ? args.cache : undefined,
       mode,
+      defaults,
     });
 
     if (!args.quiet) {

package/src/react/renderers/context.ts

@@ -1,6 +1,7 @@
 import type { generateImage } from "ai";
 import type { fileCache } from "../../ai-sdk/file-cache";
 import type { generateVideo } from "../../ai-sdk/generate-video";
+import type { DefaultModels } from "../types";
 import type { ProgressTracker } from "./progress";
 
 export interface RenderContext {
@@ -14,4 +15,6 @@ export interface RenderContext {
   progress?: ProgressTracker;
   /** In-memory deduplication for concurrent renders of the same element */
   pending: Map<string, Promise<string>>;
+  /** Default models for elements that don't specify one */
+  defaults?: DefaultModels;
 }

package/src/react/renderers/image.ts

@@ -54,9 +54,11 @@ export async function renderImage(
     throw new Error("Image element requires either 'prompt' or 'src'");
   }
 
-  const model = props.model;
+  const model = props.model ?? ctx.defaults?.image;
   if (!model) {
-    throw new Error("Image element requires 'model' prop when using prompt");
+    throw new Error(
+      "Image element requires 'model' prop (or set defaults.image in render options)",
+    );
   }
 
   // Compute cache key for deduplication

package/src/react/renderers/music.ts

@@ -10,9 +10,9 @@ export async function renderMusic(
   const props = element.props as MusicProps;
 
   const prompt = props.prompt;
-  const model = props.model;
+  const model = props.model ?? ctx.defaults?.music;
   if (!prompt || !model) {
-    throw new Error("Music generation requires both prompt and model");
+    throw new Error("Music requires prompt and model (or set defaults.music)");
   }
 
   const cacheKey = JSON.stringify({

package/src/react/renderers/render.ts

@@ -126,6 +126,7 @@ export async function renderRoot(
     tempFiles: [],
     progress,
     pending: new Map(),
+    defaults: options.defaults,
   };
 
   const clipElements: VargElement<"clip">[] = [];

package/src/react/renderers/speech.ts

@@ -21,9 +21,9 @@ export async function renderSpeech(
     throw new Error("Speech element requires text content");
   }
 
-  const model = props.model;
+  const model = props.model ?? ctx.defaults?.speech;
   if (!model) {
-    throw new Error("Speech element requires 'model' prop");
+    throw new Error("Speech requires 'model' prop (or set defaults.speech)");
   }
 
   const cacheKey = computeCacheKey(element);

package/src/react/renderers/video.ts

@@ -81,9 +81,11 @@ export async function renderVideo(
     throw new Error("Video element requires either 'prompt' or 'src'");
   }
 
-  const model = props.model;
+  const model = props.model ?? ctx.defaults?.video;
   if (!model) {
-    throw new Error("Video element requires 'model' prop when using prompt");
+    throw new Error(
+      "Video element requires 'model' prop (or set defaults.video in render options)",
+    );
   }
 
   // Compute cache key for deduplication

package/src/react/types.ts

@@ -212,11 +212,19 @@ export interface PackshotProps extends BaseProps {
 
 export type RenderMode = "strict" | "default" | "preview";
 
+export interface DefaultModels {
+  image?: ImageModelV3;
+  video?: VideoModelV3;
+  speech?: SpeechModelV3;
+  music?: MusicModelV3;
+}
+
 export interface RenderOptions {
   output?: string;
   cache?: string;
   quiet?: boolean;
   mode?: RenderMode;
+  defaults?: DefaultModels;
 }
 
 export interface ElementPropsMap {