egaki 0.6.0 → 0.7.1

package/CHANGELOG.md

@@ -2,6 +2,142 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.7.1
+
+1. **Fixed `egaki/vite` import failing from npm** — the Vite plugin export was pointing to raw `.ts` source files, which Node cannot load from `node_modules`. Now correctly points to compiled JS. The `./cached-generate` export had the same issue.
+2. **Fixed path resolution in published package** — the Vite plugin resolves `app.tsx` and `motion-timing.ts` from the `src/vite/` directory. Previously it used `import.meta.url` directly, which broke when running from `dist/vite/`. Now resolves relative to the package root.
+
+## 0.7.0
+
+1. **MDX video framework** — write video scenes in MDX files, preview in a browser-based player, and export to MP4 via in-browser WebCodecs rendering. Each `#` heading becomes a timed section. Animation primitives (`Opacity`, `Scale`, `TranslateX`, `TranslateY`, `Blur`) handle motion with composable enter/exit animations:
+
+   ```mdx
+   ---
+   fps: 30
+   bpm: 120
+   ---
+
+   <Audio src="/soundtrack.mp3" />
+
+   # Intro duration=3s
+
+   <TranslateX from={-140} to={0} duration={0.7 * FPS}>
+     <div style={{ fontSize: 72, fontWeight: 900, color: 'white' }}>Hello</div>
+   </TranslateX>
+
+   # Scene Two duration=8beats
+
+   <Opacity from={0} to={1} duration={2 * BEAT}>
+     <div style={{ fontSize: 48 }}>Built with egaki</div>
+   </Opacity>
+   ```
+
+   Install the Vite plugin (`egaki/vite`), point it at your `.mdx` entry, and run `vite dev`. Heading durations support `s` (seconds), `beats` (from frontmatter `bpm`), and `frames` units. `FPS` and `BEAT` are available as scope variables in MDX expressions.
+
+2. **`egaki speech` command** — text-to-speech generation with OpenAI, ElevenLabs, and Cartesia providers:
+
+   ```bash
+   egaki speech "Hello, welcome to egaki!" -o hello.mp3
+   egaki speech "Breaking news" -m gpt-4o-mini-tts --instructions "News anchor tone"
+   egaki speech "Smooth narration" -m sonic-3.5 --voice <voice-id> --speed 0.8
+   cat script.txt | egaki speech --stdin -o narration.mp3
+   ```
+
+3. **`egaki transcribe` command** — speech-to-text with word-level timestamps from OpenAI, ElevenLabs, Deepgram, Groq, and Cartesia:
+
+   ```bash
+   egaki transcribe recording.mp3 -m whisper-1
+   egaki transcribe podcast.mp3 -m ink-whisper   # Cartesia, cheapest
+   egaki transcribe interview.wav --stdout
+   ```
+
+4. **`egaki demucs` command** — audio stem separation via fal.ai (no local torch needed):
+
+   ```bash
+   egaki demucs song.mp3 --stems vocals,drums,bass,other
+   egaki demucs song.mp3 --stems vocals -o stems/
+   ```
+
+5. **`egaki voice clone` command** — clone a voice from audio for use with `egaki speech`:
+
+   ```bash
+   egaki voice clone vocals.mp3 --name "Narrator"
+   egaki voice clone clip.mp3 --name "Speaker" --provider elevenlabs --remove-background-noise
+   egaki speech "Hello" --voice <voice-id>
+   ```
+
+6. **`<Server>` RSC slots in MDX** — mark subtrees as React Server Components with `<Server>`. Children render server-side (async, fs/API access) and stream into the client tree:
+
+   ```mdx
+   import { TextToSpeech } from 'egaki/text-to-speech'
+
+   # Narrated Scene duration=5s
+
+   <Server>
+     <TextToSpeech text="This narration is generated at dev time." />
+   </Server>
+   ```
+
+   Files with `.server.tsx` extension are auto-wrapped in `<Server>` when imported into MDX.
+
+7. **`GeneratedImage`, `GeneratedVideo`, `GeneratedSpeech` server components** — AI-generated media with filesystem caching and deduplication. Generate once, cache forever:
+
+   ```tsx
+   // hero.server.tsx
+   import { GeneratedImage } from 'egaki/generate-media'
+
+   export async function Hero() {
+     return <GeneratedImage prompt="magical forest" model="imagen-4.0-generate-001" />
+   }
+   ```
+
+8. **LayoutTransition FLIP animations** — elements animate from their position in the previous section to the new position using FLIP transforms. Supports cross-section and intra-scene transitions with `showFrom`/`showUpTo`:
+
+   ```mdx
+   # Scene 1 duration=3s
+   <LayoutTransition id="title">**Hello**</LayoutTransition>
+
+   # Scene 2 duration=3s
+   <LayoutTransition id="title" duration={25} bounce={0.2}>**Hello**</LayoutTransition>
+   ```
+
+9. **WebGL shader components** — `BandsShader`, `WaveGradientShader`, `LiquidGradientShader`, `DispersionRingsShader` ported from Framer with full tweakpane integration. All props are exposed as live sliders and color pickers.
+
+10. **Tweakpane integration** — `useTweakpane(label, schema)` registers live-editable parameters in a shared pane. Components show/hide their controls based on visibility. A "Copy changes" button exports all tweaked values as structured markdown.
+
+11. **Framer Motion (`motion/react`) integration** — auto-detected when installed. `motion.div`, springs, variants, and staggered children work inside MDX sections with frame-deterministic rendering and backward scrubbing support.
+
+12. **Easing curve engine** — ported from Jitter with 14 continuous preset functions (`smoothEasing`, `bounceEasing`, `overshootEasing`, `impulseOvershoot`, etc.) that accept any intensity 0-100. `cubicBezier()` from `egaki/video` attaches `BEZIER_POINTS` metadata for tweakpane editing:
+
+    ```tsx
+    import { EASE, smoothEasing, cubicBezier } from 'egaki/video'
+    const x = interpolate(frame, [0, 60], [0, 500], { easing: EASE.smooth })
+    ```
+
+13. **`CodeBlock` component** — syntax-highlighted code with shiki and ray.so themes, built into MDX scope.
+
+14. **`Fill` component** — full-frame layer like `AbsoluteFill` but children stretch horizontally and center vertically. Available in MDX without imports.
+
+15. **`inline` and `style` props on animation primitives** — `inline` wraps in a plain `<div>` instead of full-frame `<Fill>`, so animated elements participate in flex/grid layout. `style` adds CSS to the wrapper.
+
+16. **Auto-duration from media** — sections without explicit `duration` infer their length from the longest `<Audio>` or `<Video>` element inside them.
+
+17. **Player redesign** — right sidebar layout, floating toolbar with playback rate control, keyboard shortcuts (J/K/L scrub, space play/pause), video trim controls, and cubic bezier blade for easing editing.
+
+18. **Agent SDK (`window.egakiSDK`)** — programmatic control from Playwriter. Screenshot frames, export video segments, get composition info, filmstrip grid rendering, and element position mapping.
+
+19. **Programmatic `egaki/generate` API** — import `generateImage`, `generateVideo`, `generateSpeech` directly from TypeScript without the CLI.
+
+20. **Custom composition dimensions** — `width` and `height` in MDX frontmatter override the default 1920x1080. `scale` frontmatter field controls pixel density.
+
+21. **Multi-entry MDX** — all `.mdx` files in the project root are served as separate routes, not just the configured entry.
+
+22. **MDX LSP autocomplete** — built-in components get prop autocomplete in `.mdx` files via `@mdx-js/typescript-plugin` and auto-generated `egaki-env.d.ts`.
+
+23. **Breaking: animation primitives replaced** — the 8 previous animation wrappers (`FadeIn`, `SlideIn`, `ScaleIn`, `FadeOut`, etc.) are replaced by 5 composable primitives (`Opacity`, `Scale`, `TranslateX`, `TranslateY`, `Blur`). Enter vs exit is inferred from `startInFrames` sign. Nest them to compose animations.
+
+24. **Breaking: `gapBefore`/`gapAfter` replaced with `startInFrames`** — `<Audio>` and `<Video>` now use `startInFrames` (positive = delay from section start, negative = offset from section end).
+
 ## 0.6.0
 
 1. **xAI provider with Grok image and video generation** — generate images and videos using xAI's Aurora and Grok models. Two auth paths: direct API key via `XAI_API_KEY` or Grok Build OAuth browser flow:
@@ -14,10 +150,10 @@ All notable changes to this project will be documented in this file.
    egaki login --provider xai-oauth
 
    # Generate images
-   egaki image "cyberpunk cityscape at dusk" -m xai/grok-2-image -o city.png
+   egaki image "cyberpunk cityscape at dusk" -m grok-imagine-image -o city.png
 
    # Generate videos
-   egaki video "a cat playing piano" -m xai/grok-3-mini-video -o cat.mp4
+   egaki video "a cat playing piano" -m grok-imagine-video -o cat.mp4
    ```
 
    Auth priority: explicit `XAI_API_KEY` > xAI OAuth > stored xai key > egaki gateway.
@@ -26,17 +162,17 @@ All notable changes to this project will be documented in this file.
 
    ```bash
    # Quality and resolution (xAI)
-   egaki image "portrait" -m xai/grok-2-image --quality high --resolution 2k
+   egaki image "portrait" -m grok-imagine-image --quality high --resolution 2k
 
    # Output format
-   egaki image "logo" -m xai/grok-2-image --output-format png
+   egaki image "logo" -m grok-imagine-image --output-format png
 
    # Negative prompts (Fal models)
-   egaki image "landscape" -m fal/flux-pro/v1.1 --negative-prompt "blurry, low quality"
+   egaki image "landscape" -m fal-ai/flux-pro/v1.1 --negative-prompt "blurry, low quality"
 
    # Video modes (xAI): edit, extend, reference-to-video
-   egaki video "slow zoom out" -m xai/grok-3-mini-video --mode extend-video --input clip.mp4
-   egaki video "a person walking" -m xai/grok-3-mini-video --mode reference-to-video --reference-images ref1.png ref2.png
+   egaki video "slow zoom out" -m grok-imagine-video --mode extend-video --input clip.mp4
+   egaki video "a person walking" -m grok-imagine-video --mode reference-to-video --reference-images ref1.png ref2.png
    ```
 
    Flag descriptions are auto-derived from the model catalog so `--help` shows valid values per provider.
@@ -45,10 +181,10 @@ All notable changes to this project will be documented in this file.
 
    ```bash
    # Edit a local video file
-   egaki video "add lens flare" -m xai/grok-3-mini-video --mode edit-video --input local-clip.mp4
+   egaki video "add lens flare" -m grok-imagine-video --mode edit-video --input local-clip.mp4
 
    # Reference images from disk
-   egaki video "person walking in park" -m xai/grok-3-mini-video --mode reference-to-video --reference-images photo1.jpg photo2.jpg
+   egaki video "person walking in park" -m grok-imagine-video --mode reference-to-video --reference-images photo1.jpg photo2.jpg
    ```
 
    The `--video-url` flag was removed; `--input` now handles both local files and URLs depending on the mode.

package/dist/cli/cache-utils.d.ts

@@ -0,0 +1,33 @@
+/** Set the project root directory. Called by the Vite plugin on startup. */
+export declare function setProjectRoot(root: string): void;
+/** Get the project root directory. Falls back to cwd if not set. */
+export declare function getProjectRoot(): string;
+/** Deterministic JSON from a value: keys sorted recursively, undefined
+ *  values stripped. Safe for nested objects and arrays. */
+export declare function stableJsonKey(value: unknown): string;
+/** First 8 hex chars of sha256. */
+export declare function hashKey(input: string | Uint8Array): string;
+/** First ~40 chars of text, kebab-cased, filesystem-safe. */
+export declare function promptPrefix(text: string): string;
+export declare function extensionFromMediaType(mediaType: string): string;
+/** Returns the generated files directory for a given namespace.
+ *  Creates the directory if it doesn't exist. */
+export declare function generatedDir(namespace: string): string;
+/** Find an existing cached file by hash in the generated directory.
+ *  Also checks the stale/ subfolder — if found there, restores it. */
+export declare function findCachedFile(dir: string, hash: string): string | undefined;
+/** Find a previous generation with the same prompt prefix (different hash)
+ *  that can serve as fallback while a new generation is in progress. */
+export declare function findFallbackFile(dir: string, prefix: string, currentHash: string): {
+    filename: string;
+    inStale: boolean;
+} | undefined;
+/** Move a specific file into the stale/ subfolder of its directory. */
+export declare function moveFileToStale(dir: string, fallback: {
+    filename: string;
+    inStale: boolean;
+}): void;
+export declare const generationQueue: Map<string, Promise<any>>;
+/** Format key params for logging, omitting undefined values and the _type field. */
+export declare function formatKeyParams(params: Record<string, unknown>): string;
+//# sourceMappingURL=cache-utils.d.ts.map

package/dist/cli/cache-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-utils.d.ts","sourceRoot":"","sources":["../../src/cli/cache-utils.ts"],"names":[],"mappings":"AAoBA,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,QAE1C;AAED,oEAAoE;AACpE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAMD;2DAC2D;AAC3D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAaD,mCAAmC;AACnC,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAE1D;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAehE;AAMD;iDACiD;AACjD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKtD;AAMD;sEACsE;AACtE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAe5E;AAED;wEACwE;AACxE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAYrI;AAMD,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,QAU5F;AAOD,eAAO,MAAM,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAC0B,CAAA;AAEhF,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAKvE"}

package/dist/cli/cache-utils.js

@@ -0,0 +1,157 @@
+// Shared caching utilities for egaki generate functions.
+//
+// Provides deterministic cache keys, file lookup, deduplication queues,
+// and stale file management. Used by the cached variants of generateImage,
+// generateSpeech, generateVideo, and transcribeAudio.
+//
+// The project root (for locating public/generated/) is set via setProjectRoot()
+// at startup. In Vite context, server-components.tsx sets it from the virtual
+// module. Falls back to process.cwd() if not set.
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// Project root
+// ---------------------------------------------------------------------------
+let _projectRoot;
+/** Set the project root directory. Called by the Vite plugin on startup. */
+export function setProjectRoot(root) {
+    _projectRoot = root;
+}
+/** Get the project root directory. Falls back to cwd if not set. */
+export function getProjectRoot() {
+    return _projectRoot ?? process.cwd();
+}
+// ---------------------------------------------------------------------------
+// Deterministic cache keys
+// ---------------------------------------------------------------------------
+/** Deterministic JSON from a value: keys sorted recursively, undefined
+ *  values stripped. Safe for nested objects and arrays. */
+export function stableJsonKey(value) {
+    return JSON.stringify(sortValue(value));
+}
+function sortValue(value) {
+    if (Array.isArray(value))
+        return value.map(sortValue);
+    if (!value || typeof value !== 'object')
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([k, v]) => [k, sortValue(v)]));
+}
+/** First 8 hex chars of sha256. */
+export function hashKey(input) {
+    return createHash('sha256').update(input).digest('hex').slice(0, 8);
+}
+/** First ~40 chars of text, kebab-cased, filesystem-safe. */
+export function promptPrefix(text) {
+    const slug = text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-')
+        .slice(0, 40)
+        .replace(/-$/, '');
+    return slug || 'generated';
+}
+export function extensionFromMediaType(mediaType) {
+    const map = {
+        'image/png': '.png',
+        'image/jpeg': '.jpg',
+        'image/webp': '.webp',
+        'video/mp4': '.mp4',
+        'video/webm': '.webm',
+        'audio/mpeg': '.mp3',
+        'audio/wav': '.wav',
+        'audio/opus': '.opus',
+        'audio/ogg': '.ogg',
+        'audio/aac': '.aac',
+        'audio/flac': '.flac',
+    };
+    return map[mediaType] || '.bin';
+}
+// ---------------------------------------------------------------------------
+// Generated directory management
+// ---------------------------------------------------------------------------
+/** Returns the generated files directory for a given namespace.
+ *  Creates the directory if it doesn't exist. */
+export function generatedDir(namespace) {
+    const root = getProjectRoot();
+    const dir = path.join(root, 'public', 'generated', namespace);
+    fs.mkdirSync(dir, { recursive: true });
+    return dir;
+}
+// ---------------------------------------------------------------------------
+// File lookup
+// ---------------------------------------------------------------------------
+/** Find an existing cached file by hash in the generated directory.
+ *  Also checks the stale/ subfolder — if found there, restores it. */
+export function findCachedFile(dir, hash) {
+    try {
+        const found = fs.readdirSync(dir).find((f) => f.includes(hash));
+        if (found)
+            return found;
+    }
+    catch { /* empty */ }
+    try {
+        const staleDir = path.join(dir, 'stale');
+        const inStale = fs.readdirSync(staleDir).find((f) => f.includes(hash));
+        if (inStale) {
+            fs.renameSync(path.join(staleDir, inStale), path.join(dir, inStale));
+            console.log(`[egaki] restored from stale: ${inStale}`);
+            return inStale;
+        }
+    }
+    catch { /* empty */ }
+    return undefined;
+}
+/** Find a previous generation with the same prompt prefix (different hash)
+ *  that can serve as fallback while a new generation is in progress. */
+export function findFallbackFile(dir, prefix, currentHash) {
+    const match = (f) => f.startsWith(prefix + '-') && !f.includes(currentHash);
+    try {
+        const inDir = fs.readdirSync(dir).find(match);
+        if (inDir)
+            return { filename: inDir, inStale: false };
+    }
+    catch { /* empty */ }
+    try {
+        const staleDir = path.join(dir, 'stale');
+        const inStale = fs.readdirSync(staleDir).find(match);
+        if (inStale)
+            return { filename: inStale, inStale: true };
+    }
+    catch { /* empty */ }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Stale file management
+// ---------------------------------------------------------------------------
+/** Move a specific file into the stale/ subfolder of its directory. */
+export function moveFileToStale(dir, fallback) {
+    if (fallback.inStale)
+        return;
+    const src = path.join(dir, fallback.filename);
+    const staleDir = path.join(dir, 'stale');
+    try {
+        if (!fs.existsSync(src))
+            return;
+        fs.mkdirSync(staleDir, { recursive: true });
+        fs.renameSync(src, path.join(staleDir, fallback.filename));
+        console.log(`[egaki] moved stale: ${fallback.filename} → stale/`);
+    }
+    catch { /* race with another rename, safe to ignore */ }
+}
+// ---------------------------------------------------------------------------
+// Generation queue — deduplicates concurrent calls with the same cache key.
+// Stored on globalThis so in-flight promises survive Vite HMR module reloads.
+// ---------------------------------------------------------------------------
+export const generationQueue = globalThis.__egakiGenerationQueue ??= new Map();
+/** Format key params for logging, omitting undefined values and the _type field. */
+export function formatKeyParams(params) {
+    const entries = Object.entries(params)
+        .filter(([k, v]) => v !== undefined && k !== '_type')
+        .map(([k, v]) => `${k}=${typeof v === 'string' ? v : JSON.stringify(v)}`);
+    return entries.join(', ');
+}

package/dist/cli/cached-generate.d.ts

@@ -0,0 +1,105 @@
+export interface GenerationEntry {
+    namespace: string;
+    label: string;
+    model?: string;
+    startedAt: number;
+    params: Record<string, unknown>;
+    /** URL path to the in-progress file. Set by onPartial writes during streaming
+     *  generation (e.g. accumulated audio written every ~2s). Cleared when
+     *  generation completes. Flows through the progress SSE to the client. */
+    partialSrc?: string;
+}
+type ProgressListener = () => void;
+/** Subscribe to generation progress changes. Returns an unsubscribe function. */
+export declare function onProgressChange(listener: ProgressListener): () => void;
+export interface GenerationProgressSummary {
+    counts: Record<string, number>;
+    total: number;
+}
+export interface GenerationProgressEntry extends GenerationEntry {
+    key: string;
+    elapsedMs: number;
+}
+export interface GenerationError {
+    key: string;
+    namespace: string;
+    label: string;
+    model?: string;
+    error: string;
+    durationMs: number;
+}
+export interface GenerationProgressEvent {
+    generations: GenerationProgressEntry[];
+    errors: GenerationError[];
+    summary: GenerationProgressSummary;
+    done: boolean;
+}
+/** Get a snapshot of all active generations with elapsed time computed.
+ *  Drains the error queue so each call returns only new errors since last read. */
+export declare function getGenerationProgress(): GenerationProgressEvent;
+type SerializeResult = {
+    bytes: Uint8Array;
+    extension: string;
+    prefix?: string;
+} | {
+    json: unknown;
+    extension: '.json';
+    prefix?: string;
+};
+export interface CachedGenerateConfig<TParams, TGenerated, TResult> {
+    /** Filesystem namespace: files go to `public/generated/{namespace}/` */
+    namespace: string;
+    /** Human-readable filename prefix derived from params */
+    prefixFrom: (params: TParams) => string;
+    /** Extract the cache-relevant subset of params. Use this to exclude fields
+     *  that affect naming but not identity (e.g. `filename` in transcription).
+     *  Defaults to using all params. Uint8Array values are auto-hashed regardless. */
+    cacheKey?: (params: TParams) => Record<string, unknown>;
+    /** The actual generation function. Throw on error. */
+    generate: (params: TParams) => Promise<TGenerated>;
+    /** How to persist the result to disk.
+     *  Return { bytes, extension } for binary files or { json, extension: '.json' } for data.
+     *  Optionally return { prefix } to override the filename prefix (e.g. when
+     *  the readable name comes from the result, not the params). */
+    serialize: (result: TGenerated, params: TParams) => SerializeResult;
+    /** How to read a cached result back.
+     *  For binary: receives { urlPath, filePath }, defaults to { src: urlPath }.
+     *  For JSON: filePath contains the JSON data. */
+    deserialize?: (cached: {
+        urlPath: string;
+        filePath: string;
+    }) => TResult;
+    /** Model ID key in params, used for progress tracking display. */
+    modelFrom?: (params: TParams) => string | undefined;
+    /** Called after the main file is written to disk. Use this to write
+     *  sidecar files (e.g. timestamps JSON alongside audio).
+     *  Receives the generated result so it can extract extra data to persist. */
+    postWrite?: (filePath: string, result: TGenerated, params: TParams) => void;
+}
+/** Result of getCacheInfo — used by server components for sync cache checks
+ *  and fallback lookup before starting async generation. */
+export interface CacheInfo {
+    hash: string;
+    prefix: string;
+    dir: string;
+    key: string;
+    cached: string | undefined;
+    fallback: {
+        filename: string;
+        inStale: boolean;
+    } | undefined;
+    fallbackSrc: string | undefined;
+}
+/** Compute cache info for a given namespace and params without starting generation.
+ *  Used by server components to check cache and find fallback synchronously. */
+export declare function getCacheInfo(namespace: string, params: Record<string, unknown>, prefixText: string): CacheInfo;
+export type CachedGenerateFn<TParams, TResult> = {
+    (params: TParams): Promise<Error | TResult>;
+    /** Sync cache check using the same config as the cached function. */
+    getCacheInfo(params: TParams): CacheInfo;
+};
+export declare function cachedGenerate<TParams, TGenerated, TResult = {
+    src: string;
+}>(config: CachedGenerateConfig<TParams, TGenerated, TResult>): CachedGenerateFn<TParams, TResult>;
+export {};
+//# sourceMappingURL=cached-generate.d.ts.map

package/dist/cli/cached-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-generate.d.ts","sourceRoot":"","sources":["../../src/cli/cached-generate.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B;;8EAE0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAKD,KAAK,gBAAgB,GAAG,MAAM,IAAI,CAAA;AAUlC,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAGvE;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,uBAAuB,EAAE,CAAA;IACtC,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,OAAO,EAAE,yBAAyB,CAAA;IAClC,IAAI,EAAE,OAAO,CAAA;CACd;AAOD;mFACmF;AACnF,wBAAgB,qBAAqB,IAAI,uBAAuB,CAgB/D;AAkDD,KAAK,eAAe,GAChB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1D,MAAM,WAAW,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO;IAChE,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAA;IAEjB,yDAAyD;IACzD,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAA;IAEvC;;sFAEkF;IAClF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEvD,sDAAsD;IACtD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAElD;;;oEAGgE;IAChE,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,KAAK,eAAe,CAAA;IAEnE;;qDAEiD;IACjD,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAA;IAExE,kEAAkE;IAClE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAA;IAEnD;;iFAE6E;IAC7E,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5E;AAED;4DAC4D;AAC5D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAA;IAC5D,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC;AAED;gFACgF;AAChF,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,GACjB,SAAS,CAgBX;AAED,MAAM,MAAM,gBAAgB,CAAC,OAAO,EAAE,OAAO,IAAI;IAC/C,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,CAAA;IAC3C,qEAAqE;IACrE,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;CACzC,CAAA;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAC3E,MAAM,EAAE,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,GACzD,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAoGpC"}