@mettascript/grapher 2.0.0

package/dist/node.d.ts

@@ -0,0 +1,37 @@
+import { MeTTa, Atom } from '@mettascript/hyperon';
+
+/** How to render the GIF. */
+interface GifOptions {
+    /** Output width in pixels (height follows the aspect ratio). Default 720. */
+    width?: number;
+    /** Morph frames per reduction step. Default `morphMs / stepMs`, reduced to keep under `maxFrames`. */
+    framesPerStep?: number;
+    /** Cap on the total number of frames. Default 180. */
+    maxFrames?: number;
+    /** Milliseconds to hold each settled state. Default 260. */
+    holdMs?: number;
+    /** Milliseconds per morph frame. Default 40. */
+    stepMs?: number;
+    /** Milliseconds one step's morph spans, the live view's trace duration. Sets the default frame count
+     *  per step so the export glides exactly like the screen; an explicit `framesPerStep` wins. The editor
+     *  export methods fill this in with their current trace duration. Default 550 (`DEFAULT_TRACE_MS`). */
+    morphMs?: number;
+    /** Canvas background color. Used by the graph GIF, which has no block palette to take it from. */
+    background?: string;
+}
+
+type NodeGifView = "blocks" | "graph" | "side-by-side";
+type ReductionGifInput = string | Atom | readonly Atom[];
+/** Options for a headless Node reduction GIF. */
+interface NodeGifOptions extends GifOptions {
+    /** Picture to render. Default `blocks`. */
+    view?: NodeGifView;
+    /** Existing engine whose space supplies rules, grounded operations, and facts. */
+    metta?: MeTTa;
+    /** Maximum evaluator steps while building the reduction trace. Default 300. */
+    maxSteps?: number;
+}
+/** Render a MeTTa reduction to animated GIF bytes in plain Node.js. */
+declare function renderReductionGif(input: ReductionGifInput, opts?: NodeGifOptions): Promise<Uint8Array>;
+
+export { type NodeGifOptions, type NodeGifView, type ReductionGifInput, renderReductionGif };