@markdy/renderer-dom 0.8.27 → 0.8.28

package/dist/index.d.ts

@@ -33,6 +33,7 @@ interface DiagramOptions {
     onWarning?: (warning: Diagnostic) => void;
     onTimeUpdate?: (seconds: number, durationSeconds: number) => void;
     onPlayStateChange?: (playing: boolean) => void;
+    onEnded?: () => void;
 }
 interface Diagram {
     play(): void;
@@ -81,6 +82,21 @@ interface SvgExportOptions {
 }
 declare function exportDiagramAsVectorSvg(containerEl: HTMLElement, options?: SvgExportOptions): string;
 
+interface TimelineController {
+    seek(seconds: number): void;
+    currentTime(): number;
+    duration(): number;
+    isPlaying(): boolean;
+    play(): void;
+    pause(): void;
+}
+interface GifDiagramExportOptions extends SvgExportOptions {
+    fps?: number;
+    pixelRatio?: number;
+    loop?: boolean;
+}
+declare function exportDiagramAsGif(container: HTMLElement, timeline: TimelineController, options?: GifDiagramExportOptions): Promise<Blob>;
+
 /**
  * packages/renderer-dom/src/export/png-exporter.ts
  * High-DPI raster PNG export with 2x retina scaling.
@@ -119,4 +135,4 @@ declare class DiagramPresentationController {
     destroy(): void;
 }
 
-export { type AnimationRecordFrame, type ControllerOptions, type Diagram, type DiagramOptions, DiagramPresentationController, type GifExportOptions, ICON_REGISTRY, type IconSpec, type PngExportOptions, type SvgExportOptions, createDiagram, encodeGifSequence, exportDiagramAsPng, exportDiagramAsVectorSvg };
+export { type AnimationRecordFrame, type ControllerOptions, type Diagram, type DiagramOptions, DiagramPresentationController, type GifDiagramExportOptions, type GifExportOptions, ICON_REGISTRY, type IconSpec, type PngExportOptions, type SvgExportOptions, type TimelineController, createDiagram, encodeGifSequence, exportDiagramAsGif, exportDiagramAsPng, exportDiagramAsVectorSvg };

package/dist/index.js

@@ -2091,7 +2091,8 @@ function createDiagram(opts) {
     copyright: explicitCopyright,
     onWarning = (w) => console.warn(`[markdy] line ${w.line}: ${w.message}`),
     onTimeUpdate,
-    onPlayStateChange
+    onPlayStateChange,
+    onEnded
   } = opts;
   const { ast, plan } = parseAndCompile(code);
   for (const w of ast.diagnostics) {
@@ -2503,6 +2504,7 @@ function createDiagram(opts) {
         emitPlayStateChange(false);
         lastRafTs = null;
         rafId = null;
+        onEnded?.();
         return;
       }
     }
@@ -2861,6 +2863,19 @@ function encodeGifSequence(frames, options = {}) {
 }
 
 // src/export/svg-exporter.ts
+function copyRenderedStyles(source, clone) {
+  if (typeof window === "undefined" || typeof window.getComputedStyle !== "function") return;
+  const sourceElements = [source, ...Array.from(source.querySelectorAll("*"))];
+  const cloneElements = [clone, ...Array.from(clone.querySelectorAll("*"))];
+  for (let index = 0; index < Math.min(sourceElements.length, cloneElements.length); index++) {
+    const computed = window.getComputedStyle(sourceElements[index]);
+    const target = cloneElements[index].style;
+    for (let propertyIndex = 0; propertyIndex < computed.length; propertyIndex++) {
+      const property = computed.item(propertyIndex);
+      target.setProperty(property, computed.getPropertyValue(property), computed.getPropertyPriority(property));
+    }
+  }
+}
 function exportDiagramAsVectorSvg(containerEl, options = {}) {
   const sceneEl = containerEl.classList?.contains("markdy-scene-root") ? containerEl : containerEl.querySelector(".markdy-scene-root") || containerEl.querySelector("svg") || (containerEl.tagName?.toLowerCase() === "svg" ? containerEl : null);
   if (!sceneEl) throw new Error("No Markdy scene element found in container");
@@ -2874,6 +2889,7 @@ function exportDiagramAsVectorSvg(containerEl, options = {}) {
 ${serializer2.serializeToString(clonedSvg)}`;
   }
   const clonedScene = sceneEl.cloneNode(true);
+  copyRenderedStyles(sceneEl, clonedScene);
   const widthStr = clonedScene.style.width || String(sceneEl.clientWidth || 800);
   const heightStr = clonedScene.style.height || String(sceneEl.clientHeight || 400);
   let width = parseFloat(widthStr);
@@ -2923,6 +2939,60 @@ ${serializer2.serializeToString(clonedSvg)}`;
 ` + serializer.serializeToString(svg);
 }
 
+// src/export/gif-exporter.ts
+var nextFrame = () => new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(() => resolve())));
+async function rasterizeFrame(container, pixelRatio, options) {
+  const svg = exportDiagramAsVectorSvg(container, options);
+  const url = URL.createObjectURL(new Blob([svg], { type: "image/svg+xml;charset=utf-8" }));
+  try {
+    const image = new Image();
+    await new Promise((resolve, reject) => {
+      image.onload = () => resolve();
+      image.onerror = () => reject(new Error("Failed to rasterize GIF frame"));
+      image.src = url;
+    });
+    const canvas = document.createElement("canvas");
+    canvas.width = image.naturalWidth * pixelRatio;
+    canvas.height = image.naturalHeight * pixelRatio;
+    const context = canvas.getContext("2d");
+    if (!context) throw new Error("Could not create GIF canvas context");
+    context.drawImage(image, 0, 0, canvas.width, canvas.height);
+    return context.getImageData(0, 0, canvas.width, canvas.height);
+  } finally {
+    URL.revokeObjectURL(url);
+  }
+}
+async function exportDiagramAsGif(container, timeline, options = {}) {
+  const fps = Math.min(24, Math.max(1, Math.round(options.fps ?? 12)));
+  const duration = timeline.duration();
+  const frameCount = Math.max(1, Math.ceil(duration * fps));
+  const delayMs = Math.max(20, Math.round(1e3 / fps));
+  const priorTime = timeline.currentTime();
+  const wasPlaying = timeline.isPlaying();
+  timeline.pause();
+  try {
+    const frames = [];
+    for (let frame = 0; frame < frameCount; frame++) {
+      timeline.seek(Math.min(duration, frame / fps));
+      await nextFrame();
+      frames.push({
+        imageData: await rasterizeFrame(container, options.pixelRatio ?? 1, options),
+        delayMs
+      });
+    }
+    timeline.seek(duration);
+    await nextFrame();
+    frames.push({ imageData: await rasterizeFrame(container, options.pixelRatio ?? 1, options), delayMs: Math.max(delayMs, 800) });
+    const encoded = encodeGifSequence(frames, { dither: true, loop: options.loop ?? true });
+    const bytes = new Uint8Array(encoded.byteLength);
+    bytes.set(encoded);
+    return new Blob([bytes.buffer], { type: "image/gif" });
+  } finally {
+    timeline.seek(priorTime);
+    if (wasPlaying) timeline.play();
+  }
+}
+
 // src/export/png-exporter.ts
 async function exportDiagramAsPng(containerEl, options = {}) {
   const svgXml = exportDiagramAsVectorSvg(containerEl, options);
@@ -3044,6 +3114,7 @@ export {
   ICON_REGISTRY,
   createDiagram,
   encodeGifSequence,
+  exportDiagramAsGif,
   exportDiagramAsPng,
   exportDiagramAsVectorSvg
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markdy/renderer-dom",
-  "version": "0.8.27",
+  "version": "0.8.28",
   "description": "Browser renderer for diagram-native animated MarkdyScript architecture diagrams, built on the Web Animations API.",
   "license": "MIT",
   "type": "module",
@@ -44,14 +44,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@markdy/core": "0.8.27"
+    "@markdy/core": "0.8.28"
   },
   "devDependencies": {
     "jsdom": "^29.1.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.7",
-    "@markdy/stdlib-systems": "0.8.27"
+    "@markdy/stdlib-systems": "0.8.28"
   },
   "scripts": {
     "build": "tsup",