@elucim/dsl 0.7.0 → 0.8.1

package/dist/index.d.ts

@@ -577,12 +577,47 @@ export declare function renderRoot(node: SceneNode | PlayerNode | PresentationNo
 export declare interface RenderRootOverrides {
     frame?: number;
     playerRef?: default_2.RefObject<PlayerRef | null>;
+    /** CSS color-scheme to pass to Scene/Player. When set, overrides browser prefers-color-scheme. */
+    colorScheme?: 'light' | 'dark' | 'light dark';
 }
 
 export declare function renderScene(node: SceneNode, overrides?: RenderRootOverrides): default_2.ReactNode;
 
 export declare function renderSlide(node: SlideNode, key: number): default_2.ReactNode;
 
+/**
+ * Render a DSL document at a specific frame directly to PNG bytes.
+ *
+ * Goes from DSL JSON → SVG string → PNG without requiring a mounted DOM
+ * element, blob URLs, or manual Image loading. Uses data URIs internally
+ * to avoid CSP issues in restricted webview contexts (e.g. Tauri).
+ *
+ * Works in any browser environment. Does NOT work in Node.js (needs
+ * canvas + Image APIs).
+ *
+ * @example
+ * ```ts
+ * import { renderToPng } from '@elucim/dsl';
+ *
+ * const png = await renderToPng(myDocument, 0);
+ * // png is a Uint8Array of PNG bytes
+ *
+ * // Save as file download:
+ * const blob = new Blob([png], { type: 'image/png' });
+ * const url = URL.createObjectURL(blob);
+ * ```
+ */
+export declare function renderToPng(dsl: ElucimDocument, frame: number, options?: RenderToPngOptions): Promise<Uint8Array>;
+
+export declare interface RenderToPngOptions {
+    /** Output width in pixels (default: document width) */
+    width?: number;
+    /** Output height in pixels (default: document height) */
+    height?: number;
+    /** Device pixel ratio for retina output (default: 2) */
+    scale?: number;
+}
+
 /**
  * Render a DSL document to an SVG string at a specific frame, without mounting to the DOM.
  * Uses react-dom/server's renderToStaticMarkup.
@@ -1002,6 +1037,7 @@ export declare interface ValidationResult {
 
 export declare interface VectorFieldNode {
     type: 'vectorField';
+    id?: string;
     /** Vector expression string, e.g. "[-y, x]" */
     fn: string;
     domain?: [number, number];