@markdy/renderer-dom 0.8.27 → 1.0.0

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,10 +82,30 @@ 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.
  * Zero external dependencies.
+ *
+ * Fix: Inline all external resources (images, fonts) as base64 data URIs
+ * before drawing the SVG to canvas. A foreignObject-wrapped SVG taints the
+ * canvas whenever it references any external URL, so every resource must be
+ * inlined first.
  */
 
 interface PngExportOptions extends SvgExportOptions {
@@ -119,4 +140,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,10 +2939,130 @@ ${serializer2.serializeToString(clonedSvg)}`;
 ` + serializer.serializeToString(svg);
 }
 
+// src/export/inline-resources.ts
+async function toDataUri(url) {
+  try {
+    const resp = await fetch(url, { mode: "cors", credentials: "same-origin" });
+    if (!resp.ok) return null;
+    const arrayBuffer = await resp.arrayBuffer();
+    const mimeType = resp.headers.get("Content-Type") || "application/octet-stream";
+    const base64 = btoa(
+      new Uint8Array(arrayBuffer).reduce((data, byte) => data + String.fromCharCode(byte), "")
+    );
+    return `data:${mimeType};base64,${base64}`;
+  } catch {
+    return null;
+  }
+}
+async function inlineCssUrls(cssValue) {
+  const urlPattern = /url\(["']?([^"')]+)["']?\)/g;
+  const matches = [];
+  let m;
+  while ((m = urlPattern.exec(cssValue)) !== null) {
+    const src = m[1];
+    if (!src.startsWith("data:")) {
+      matches.push({ full: m[0], src });
+    }
+  }
+  let result = cssValue;
+  await Promise.all(
+    matches.map(async ({ full, src }) => {
+      const absoluteSrc = new URL(src, document.baseURI).href;
+      const dataUri = await toDataUri(absoluteSrc);
+      if (dataUri) result = result.split(full).join(`url("${dataUri}")`);
+    })
+  );
+  return result;
+}
+async function inlineExternalResources(root) {
+  const tasks = [];
+  root.querySelectorAll("img").forEach((img) => {
+    const src = img.getAttribute("src");
+    if (src && !src.startsWith("data:")) {
+      const absoluteSrc = new URL(src, document.baseURI).href;
+      tasks.push(
+        toDataUri(absoluteSrc).then((dataUri) => {
+          if (dataUri) img.setAttribute("src", dataUri);
+        })
+      );
+    }
+  });
+  const allEls = [root, ...Array.from(root.querySelectorAll("*"))];
+  allEls.forEach((el) => {
+    const style = el.getAttribute("style");
+    if (style && style.includes("url(")) {
+      tasks.push(
+        inlineCssUrls(style).then((inlined) => {
+          if (inlined !== style) el.setAttribute("style", inlined);
+        })
+      );
+    }
+  });
+  await Promise.all(tasks);
+}
+
+// src/export/gif-exporter.ts
+var nextFrame = () => new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(() => resolve())));
+async function rasterizeFrame(container, pixelRatio, options) {
+  const cloned = container.cloneNode(true);
+  await inlineExternalResources(cloned);
+  const svg = exportDiagramAsVectorSvg(cloned, 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);
   const pixelRatio = options.pixelRatio || 2;
+  const clonedContainer = containerEl.cloneNode(true);
+  await inlineExternalResources(clonedContainer);
+  const svgXml = exportDiagramAsVectorSvg(clonedContainer, options);
   const blob = new Blob([svgXml], { type: "image/svg+xml;charset=utf-8" });
   const url = URL.createObjectURL(blob);
   const img = new Image();
@@ -3044,6 +3180,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": "1.0.0",
   "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": "1.0.0"
   },
   "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": "1.0.0"
   },
   "scripts": {
     "build": "tsup",