@shotstack/shotstack-canvas 1.1.0 → 1.1.2

package/dist/entry.web.js

@@ -132,23 +132,32 @@ var RichTextAssetSchema = Joi.object({
 var hbSingleton = null;
 async function initHB(wasmBaseURL) {
   if (hbSingleton) return hbSingleton;
-  const harfbuzzjs = await import("harfbuzzjs");
-  const hbPromise = harfbuzzjs.default;
-  if (typeof hbPromise === "function") {
-    hbSingleton = await hbPromise();
-  } else if (hbPromise && typeof hbPromise.then === "function") {
-    hbSingleton = await hbPromise;
-  } else {
-    hbSingleton = hbPromise;
-  }
-  if (!hbSingleton || typeof hbSingleton.createBuffer !== "function") {
-    throw new Error("Failed to initialize HarfBuzz: invalid API");
+  try {
+    const mod = await import("harfbuzzjs");
+    const candidate = mod.default;
+    let hb;
+    if (typeof candidate === "function") {
+      hb = await candidate();
+    } else if (candidate && typeof candidate.then === "function") {
+      hb = await candidate;
+    } else {
+      hb = candidate;
+    }
+    if (!hb || typeof hb.createBuffer !== "function" || typeof hb.createFont !== "function") {
+      throw new Error("Failed to initialize HarfBuzz: unexpected export shape from 'harfbuzzjs'.");
+    }
+    void wasmBaseURL;
+    hbSingleton = hb;
+    return hbSingleton;
+  } catch (err) {
+    throw new Error(
+      `Failed to initialize HarfBuzz: ${err instanceof Error ? err.message : String(err)}`
+    );
   }
-  return hbSingleton;
 }
 
 // src/core/font-registry.ts
-var FontRegistry = class {
+var _FontRegistry = class _FontRegistry {
   constructor(wasmBaseURL) {
     __publicField(this, "hb");
     __publicField(this, "faces", /* @__PURE__ */ new Map());
@@ -158,16 +167,23 @@ var FontRegistry = class {
     __publicField(this, "initPromise");
     this.wasmBaseURL = wasmBaseURL;
   }
+  static setFallbackLoader(loader) {
+    _FontRegistry.fallbackLoader = loader;
+  }
   async init() {
     if (this.initPromise) {
       await this.initPromise;
       return;
     }
-    if (this.hb) {
-      return;
-    }
+    if (this.hb) return;
     this.initPromise = this._doInit();
-    await this.initPromise;
+    try {
+      await this.initPromise;
+    } catch (err) {
+      throw new Error(
+        `Failed to initialize FontRegistry: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
   }
   async _doInit() {
     try {
@@ -179,7 +195,13 @@ var FontRegistry = class {
   }
   async getHB() {
     if (!this.hb) {
-      await this.init();
+      try {
+        await this.init();
+      } catch (err) {
+        throw new Error(
+          `Failed to get HarfBuzz instance: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
     }
     return this.hb;
   }
@@ -187,50 +209,144 @@ var FontRegistry = class {
     return `${desc.family}__${desc.weight ?? "400"}__${desc.style ?? "normal"}`;
   }
   async registerFromBytes(bytes, desc) {
-    if (!this.hb) await this.init();
-    const k = this.key(desc);
-    if (this.fonts.has(k)) return;
-    const blob = this.hb.createBlob(bytes);
-    const face = this.hb.createFace(blob, 0);
-    const font = this.hb.createFont(face);
-    const upem = face.upem || 1e3;
-    font.setScale(upem, upem);
-    this.blobs.set(k, blob);
-    this.faces.set(k, face);
-    this.fonts.set(k, font);
+    try {
+      if (!this.hb) await this.init();
+      const k = this.key(desc);
+      if (this.fonts.has(k)) return;
+      const blob = this.hb.createBlob(bytes);
+      const face = this.hb.createFace(blob, 0);
+      const font = this.hb.createFont(face);
+      const upem = face.upem || 1e3;
+      font.setScale(upem, upem);
+      this.blobs.set(k, blob);
+      this.faces.set(k, face);
+      this.fonts.set(k, font);
+    } catch (err) {
+      throw new Error(
+        `Failed to register font "${desc.family}": ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  async tryFallbackInstall(desc) {
+    const loader = _FontRegistry.fallbackLoader;
+    if (!loader) return false;
+    try {
+      const bytes = await loader({
+        family: desc.family,
+        weight: desc.weight ?? "400",
+        style: desc.style ?? "normal"
+      });
+      if (!bytes) return false;
+      await this.registerFromBytes(bytes, {
+        family: desc.family,
+        weight: desc.weight ?? "400",
+        style: desc.style ?? "normal"
+      });
+      return true;
+    } catch {
+      return false;
+    }
   }
   async getFont(desc) {
-    if (!this.hb) await this.init();
-    const k = this.key(desc);
-    const f = this.fonts.get(k);
-    if (!f) throw new Error(`Font not registered for ${k}`);
-    return f;
+    try {
+      if (!this.hb) await this.init();
+      const k = this.key(desc);
+      let f = this.fonts.get(k);
+      if (!f) {
+        const installed = await this.tryFallbackInstall(desc);
+        f = installed ? this.fonts.get(k) : void 0;
+      }
+      if (!f) throw new Error(`Font not registered for ${k}`);
+      return f;
+    } catch (err) {
+      if (err instanceof Error && err.message.includes("Font not registered")) {
+        throw err;
+      }
+      throw new Error(
+        `Failed to get font "${desc.family}": ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
   }
   async getFace(desc) {
-    if (!this.hb) await this.init();
-    const k = this.key(desc);
-    return this.faces.get(k);
+    try {
+      if (!this.hb) await this.init();
+      const k = this.key(desc);
+      let face = this.faces.get(k);
+      if (!face) {
+        const installed = await this.tryFallbackInstall(desc);
+        face = installed ? this.faces.get(k) : void 0;
+      }
+      return face;
+    } catch (err) {
+      throw new Error(
+        `Failed to get face for "${desc.family}": ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
   }
   async getUnitsPerEm(desc) {
-    const face = await this.getFace(desc);
-    return face?.upem || 1e3;
+    try {
+      const face = await this.getFace(desc);
+      return face?.upem || 1e3;
+    } catch (err) {
+      throw new Error(
+        `Failed to get units per em for "${desc.family}": ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
   }
   async glyphPath(desc, glyphId) {
-    const font = await this.getFont(desc);
-    const path = font.glyphToPath(glyphId);
-    return path && path !== "" ? path : "M 0 0";
+    try {
+      const font = await this.getFont(desc);
+      const path = font.glyphToPath(glyphId);
+      return path && path !== "" ? path : "M 0 0";
+    } catch (err) {
+      throw new Error(
+        `Failed to get glyph path for glyph ${glyphId} in font "${desc.family}": ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
   }
   destroy() {
-    for (const [, f] of this.fonts) f.destroy?.();
-    for (const [, f] of this.faces) f.destroy?.();
-    for (const [, b] of this.blobs) b.destroy?.();
-    this.fonts.clear();
-    this.faces.clear();
-    this.blobs.clear();
-    this.hb = void 0;
-    this.initPromise = void 0;
+    try {
+      for (const [, f] of this.fonts) {
+        try {
+          f.destroy();
+        } catch (err) {
+          console.error(
+            `Error destroying font: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+      }
+      for (const [, f] of this.faces) {
+        try {
+          f.destroy();
+        } catch (err) {
+          console.error(
+            `Error destroying face: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+      }
+      for (const [, b] of this.blobs) {
+        try {
+          b.destroy();
+        } catch (err) {
+          console.error(
+            `Error destroying blob: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+      }
+      this.fonts.clear();
+      this.faces.clear();
+      this.blobs.clear();
+      this.hb = void 0;
+      this.initPromise = void 0;
+    } catch (err) {
+      console.error(
+        `Error during FontRegistry cleanup: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
   }
 };
+__publicField(_FontRegistry, "fallbackLoader");
+var FontRegistry = _FontRegistry;
 
 // src/core/layout.ts
 var LayoutEngine = class {
@@ -250,112 +366,145 @@ var LayoutEngine = class {
     }
   }
   async shapeFull(text, desc) {
-    const hb = await this.fonts.getHB();
-    const buffer = hb.createBuffer();
-    buffer.addText(text);
-    buffer.guessSegmentProperties();
-    const font = await this.fonts.getFont(desc);
-    const face = await this.fonts.getFace(desc);
-    const upem = face?.upem || 1e3;
-    font.setScale(upem, upem);
-    hb.shape(font, buffer);
-    const result = buffer.json();
-    buffer.destroy();
-    return result;
+    try {
+      const hb = await this.fonts.getHB();
+      const buffer = hb.createBuffer();
+      try {
+        buffer.addText(text);
+        buffer.guessSegmentProperties();
+        const font = await this.fonts.getFont(desc);
+        const face = await this.fonts.getFace(desc);
+        const upem = face?.upem || 1e3;
+        font.setScale(upem, upem);
+        hb.shape(font, buffer);
+        const result = buffer.json();
+        return result;
+      } finally {
+        try {
+          buffer.destroy();
+        } catch (err) {
+          console.error(
+            `Error destroying HarfBuzz buffer: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+      }
+    } catch (err) {
+      throw new Error(
+        `Failed to shape text with font "${desc.family}": ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
   }
   async layout(params) {
-    const { textTransform, desc, fontSize, letterSpacing, width } = params;
-    const input = this.transformText(params.text, textTransform);
-    if (!input || input.length === 0) {
-      return [];
-    }
-    const shaped = await this.shapeFull(input, desc);
-    const face = await this.fonts.getFace(desc);
-    const upem = face?.upem || 1e3;
-    const scale = fontSize / upem;
-    const glyphs = shaped.map((g) => {
-      const charIndex = g.cl;
-      let char;
-      if (charIndex >= 0 && charIndex < input.length) {
-        char = input[charIndex];
+    try {
+      const { textTransform, desc, fontSize, letterSpacing, width } = params;
+      const input = this.transformText(params.text, textTransform);
+      if (!input || input.length === 0) {
+        return [];
       }
-      return {
-        id: g.g,
-        xAdvance: g.ax * scale + letterSpacing,
-        xOffset: g.dx * scale,
-        yOffset: -g.dy * scale,
-        cluster: g.cl,
-        char
-        // This now correctly maps to the original character
-      };
-    });
-    const lines = [];
-    let currentLine = [];
-    let currentWidth = 0;
-    const spaceIndices = /* @__PURE__ */ new Set();
-    for (let i = 0; i < input.length; i++) {
-      if (input[i] === " ") {
-        spaceIndices.add(i);
+      let shaped;
+      try {
+        shaped = await this.shapeFull(input, desc);
+      } catch (err) {
+        throw new Error(`Text shaping failed: ${err instanceof Error ? err.message : String(err)}`);
       }
-    }
-    let lastBreakIndex = -1;
-    for (let i = 0; i < glyphs.length; i++) {
-      const glyph = glyphs[i];
-      const glyphWidth = glyph.xAdvance;
-      if (glyph.char === "\n") {
-        if (currentLine.length > 0) {
-          lines.push({
-            glyphs: currentLine,
-            width: currentWidth,
-            y: 0
-          });
+      let upem;
+      try {
+        const face = await this.fonts.getFace(desc);
+        upem = face?.upem || 1e3;
+      } catch (err) {
+        throw new Error(
+          `Failed to get font metrics: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+      const scale = fontSize / upem;
+      const glyphs = shaped.map((g) => {
+        const charIndex = g.cl;
+        let char;
+        if (charIndex >= 0 && charIndex < input.length) {
+          char = input[charIndex];
+        }
+        return {
+          id: g.g,
+          xAdvance: g.ax * scale + letterSpacing,
+          xOffset: g.dx * scale,
+          yOffset: -g.dy * scale,
+          cluster: g.cl,
+          char
+        };
+      });
+      const lines = [];
+      let currentLine = [];
+      let currentWidth = 0;
+      const spaceIndices = /* @__PURE__ */ new Set();
+      for (let i = 0; i < input.length; i++) {
+        if (input[i] === " ") {
+          spaceIndices.add(i);
         }
-        currentLine = [];
-        currentWidth = 0;
-        lastBreakIndex = i;
-        continue;
       }
-      if (currentWidth + glyphWidth > width && currentLine.length > 0) {
-        if (lastBreakIndex > -1) {
-          const breakPoint = lastBreakIndex - (i - currentLine.length) + 1;
-          const nextLine = currentLine.splice(breakPoint);
-          const lineWidth = currentLine.reduce((sum, g) => sum + g.xAdvance, 0);
-          lines.push({
-            glyphs: currentLine,
-            width: lineWidth,
-            y: 0
-          });
-          currentLine = nextLine;
-          currentWidth = nextLine.reduce((sum, g) => sum + g.xAdvance, 0);
-        } else {
-          lines.push({
-            glyphs: currentLine,
-            width: currentWidth,
-            y: 0
-          });
+      let lastBreakIndex = -1;
+      for (let i = 0; i < glyphs.length; i++) {
+        const glyph = glyphs[i];
+        const glyphWidth = glyph.xAdvance;
+        if (glyph.char === "\n") {
+          if (currentLine.length > 0) {
+            lines.push({
+              glyphs: currentLine,
+              width: currentWidth,
+              y: 0
+            });
+          }
           currentLine = [];
           currentWidth = 0;
+          lastBreakIndex = i;
+          continue;
+        }
+        if (currentWidth + glyphWidth > width && currentLine.length > 0) {
+          if (lastBreakIndex > -1) {
+            const breakPoint = lastBreakIndex - (i - currentLine.length) + 1;
+            const nextLine = currentLine.splice(breakPoint);
+            const lineWidth = currentLine.reduce((sum, g) => sum + g.xAdvance, 0);
+            lines.push({
+              glyphs: currentLine,
+              width: lineWidth,
+              y: 0
+            });
+            currentLine = nextLine;
+            currentWidth = nextLine.reduce((sum, g) => sum + g.xAdvance, 0);
+          } else {
+            lines.push({
+              glyphs: currentLine,
+              width: currentWidth,
+              y: 0
+            });
+            currentLine = [];
+            currentWidth = 0;
+          }
+          lastBreakIndex = -1;
+        }
+        currentLine.push(glyph);
+        currentWidth += glyphWidth;
+        if (spaceIndices.has(glyph.cluster)) {
+          lastBreakIndex = i;
         }
-        lastBreakIndex = -1;
       }
-      currentLine.push(glyph);
-      currentWidth += glyphWidth;
-      if (spaceIndices.has(glyph.cluster)) {
-        lastBreakIndex = i;
+      if (currentLine.length > 0) {
+        lines.push({
+          glyphs: currentLine,
+          width: currentWidth,
+          y: 0
+        });
       }
+      const lineHeight = params.lineHeight * fontSize;
+      for (let i = 0; i < lines.length; i++) {
+        lines[i].y = (i + 1) * lineHeight;
+      }
+      return lines;
+    } catch (err) {
+      if (err instanceof Error) {
+        throw err;
+      }
+      throw new Error(`Layout failed: ${String(err)}`);
     }
-    if (currentLine.length > 0) {
-      lines.push({
-        glyphs: currentLine,
-        width: currentWidth,
-        y: 0
-      });
-    }
-    const lineHeight = params.lineHeight * fontSize;
-    for (let i = 0; i < lines.length; i++) {
-      lines[i].y = (i + 1) * lineHeight;
-    }
-    return lines;
   }
 };
 
@@ -447,7 +596,6 @@ async function buildDrawOps(p) {
           path,
           x: glyphX + p.shadow.offsetX,
           y: glyphY + p.shadow.offsetY,
-          // @ts-ignore scale propagated to painters
           scale,
           fill: { kind: "solid", color: p.shadow.color, opacity: p.shadow.opacity }
         });
@@ -458,7 +606,6 @@ async function buildDrawOps(p) {
           path,
           x: glyphX,
           y: glyphY,
-          // @ts-ignore scale propagated to painters
           scale,
           width: p.stroke.width,
           color: p.stroke.color,
@@ -470,7 +617,6 @@ async function buildDrawOps(p) {
         path,
         x: glyphX,
         y: glyphY,
-        // @ts-ignore scale propagated to painters
         scale,
         fill
       });
@@ -1013,11 +1159,16 @@ function createWebPainter(canvas) {
       for (const op of ops) {
         if (op.op === "BeginFrame") {
           const dpr = op.pixelRatio;
-          const w = op.width, h = op.height;
+          const w = op.width;
+          const h = op.height;
           if ("width" in canvas && "height" in canvas) {
             canvas.width = Math.floor(w * dpr);
             canvas.height = Math.floor(h * dpr);
           }
+          if ("style" in canvas) {
+            canvas.style.width = `${w}px`;
+            canvas.style.height = `${h}px`;
+          }
           ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
           if (op.clear) ctx.clearRect(0, 0, w, h);
           if (op.bg) {
@@ -1036,28 +1187,30 @@ function createWebPainter(canvas) {
           continue;
         }
         if (op.op === "FillPath") {
-          const p = new Path2D(op.path);
+          const fillOp = op;
+          const p = new Path2D(fillOp.path);
           ctx.save();
-          ctx.translate(op.x, op.y);
-          const s = op.scale ?? 1;
+          ctx.translate(fillOp.x, fillOp.y);
+          const s = fillOp.scale ?? 1;
           ctx.scale(s, -s);
-          const bbox = op.gradientBBox ?? globalBox;
-          const fill = makeGradientFromBBox(ctx, op.fill, bbox);
+          const bbox = fillOp.gradientBBox ?? globalBox;
+          const fill = makeGradientFromBBox(ctx, fillOp.fill, bbox);
           ctx.fillStyle = fill;
           ctx.fill(p);
           ctx.restore();
           continue;
         }
         if (op.op === "StrokePath") {
-          const p = new Path2D(op.path);
+          const strokeOp = op;
+          const p = new Path2D(strokeOp.path);
           ctx.save();
-          ctx.translate(op.x, op.y);
-          const s = op.scale ?? 1;
+          ctx.translate(strokeOp.x, strokeOp.y);
+          const s = strokeOp.scale ?? 1;
           ctx.scale(s, -s);
           const invAbs = 1 / Math.abs(s);
-          const c = parseHex6(op.color, op.opacity);
+          const c = parseHex6(strokeOp.color, strokeOp.opacity);
           ctx.strokeStyle = `rgba(${c.r},${c.g},${c.b},${c.a})`;
-          ctx.lineWidth = op.width * invAbs;
+          ctx.lineWidth = strokeOp.width * invAbs;
           ctx.lineJoin = "round";
           ctx.lineCap = "round";
           ctx.stroke(p);
@@ -1097,17 +1250,20 @@ function makeGradientFromBBox(ctx, spec, box) {
     const c = parseHex6(spec.color, spec.opacity);
     return `rgba(${c.r},${c.g},${c.b},${c.a})`;
   }
-  const cx = box.x + box.w / 2, cy = box.y + box.h / 2, r = Math.max(box.w, box.h) / 2;
+  const cx = box.x + box.w / 2;
+  const cy = box.y + box.h / 2;
+  const r = Math.max(box.w, box.h) / 2;
   const addStops = (g) => {
-    const op = spec.opacity ?? 1;
-    for (const s of spec.stops) {
-      const c = parseHex6(s.color, op);
+    const opacity = spec.kind === "linear" || spec.kind === "radial" ? spec.opacity : 1;
+    const stops = spec.kind === "linear" || spec.kind === "radial" ? spec.stops : [];
+    for (const s of stops) {
+      const c = parseHex6(s.color, opacity);
       g.addColorStop(s.offset, `rgba(${c.r},${c.g},${c.b},${c.a})`);
     }
     return g;
   };
   if (spec.kind === "linear") {
-    const rad = (spec.angle || 0) * Math.PI / 180;
+    const rad = spec.angle * Math.PI / 180;
     const x1 = cx + Math.cos(rad + Math.PI) * r;
     const y1 = cy + Math.sin(rad + Math.PI) * r;
     const x2 = cx + Math.cos(rad) * r;
@@ -1118,27 +1274,42 @@ function makeGradientFromBBox(ctx, spec, box) {
   }
 }
 function computeGlobalTextBounds(ops) {
-  let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+  let minX = Infinity;
+  let minY = Infinity;
+  let maxX = -Infinity;
+  let maxY = -Infinity;
   for (const op of ops) {
-    if (op.op !== "FillPath" || op.isShadow) continue;
-    const b = computePathBounds2(op.path);
-    const s = op.scale ?? 1;
-    const x1 = op.x + s * b.x;
-    const x2 = op.x + s * (b.x + b.w);
-    const y1 = op.y - s * (b.y + b.h);
-    const y2 = op.y - s * b.y;
+    if (op.op !== "FillPath") continue;
+    const fillOp = op;
+    if (fillOp.isShadow) continue;
+    const b = computePathBounds2(fillOp.path);
+    const s = fillOp.scale ?? 1;
+    const x1 = fillOp.x + s * b.x;
+    const x2 = fillOp.x + s * (b.x + b.w);
+    const y1 = fillOp.y - s * (b.y + b.h);
+    const y2 = fillOp.y - s * b.y;
     if (x1 < minX) minX = x1;
     if (y1 < minY) minY = y1;
     if (x2 > maxX) maxX = x2;
     if (y2 > maxY) maxY = y2;
   }
-  if (minX === Infinity) return { x: 0, y: 0, w: 1, h: 1 };
-  return { x: minX, y: minY, w: Math.max(1, maxX - minX), h: Math.max(1, maxY - minY) };
+  if (minX === Infinity) {
+    return { x: 0, y: 0, w: 1, h: 1 };
+  }
+  return {
+    x: minX,
+    y: minY,
+    w: Math.max(1, maxX - minX),
+    h: Math.max(1, maxY - minY)
+  };
 }
 function computePathBounds2(d) {
   const tokens = tokenizePath2(d);
   let i = 0;
-  let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+  let minX = Infinity;
+  let minY = Infinity;
+  let maxX = -Infinity;
+  let maxY = -Infinity;
   const touch = (x, y) => {
     if (x < minX) minX = x;
     if (y < minY) minY = y;
@@ -1178,10 +1349,19 @@ function computePathBounds2(d) {
       }
       case "Z":
         break;
+      default:
+        break;
     }
   }
-  if (minX === Infinity) return { x: 0, y: 0, w: 0, h: 0 };
-  return { x: minX, y: minY, w: maxX - minX, h: maxY - minY };
+  if (minX === Infinity) {
+    return { x: 0, y: 0, w: 0, h: 0 };
+  }
+  return {
+    x: minX,
+    y: minY,
+    w: maxX - minX,
+    h: maxY - minY
+  };
 }
 function tokenizePath2(d) {
   return d.match(/[MLCQZ]|-?\d*\.?\d+(?:e[-+]?\d+)?/gi) ?? [];
@@ -1189,12 +1369,39 @@ function tokenizePath2(d) {
 
 // src/io/web.ts
 async function fetchToArrayBuffer(url) {
-  const res = await fetch(url);
-  if (!res.ok) throw new Error(`Failed to fetch ${url}: ${res.status}`);
-  return await res.arrayBuffer();
+  try {
+    const res = await fetch(url);
+    if (!res.ok) {
+      throw new Error(`Failed to fetch ${url}: ${res.status} ${res.statusText}`);
+    }
+    try {
+      return await res.arrayBuffer();
+    } catch (err) {
+      throw new Error(
+        `Failed to read response body as ArrayBuffer from ${url}: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  } catch (err) {
+    if (err instanceof Error) {
+      if (err.message.includes("Failed to fetch") || err.message.includes("Failed to read")) {
+        throw err;
+      }
+      throw new Error(`Failed to fetch ${url}: ${err.message}`);
+    }
+    throw new Error(`Failed to fetch ${url}: ${String(err)}`);
+  }
 }
 
+// src/types.ts
+var isShadowFill2 = (op) => {
+  return op.op === "FillPath" && op.isShadow === true;
+};
+var isGlyphFill2 = (op) => {
+  return op.op === "FillPath" && op.isShadow !== true;
+};
+
 // src/env/entry.web.ts
+var DEFAULT_ROBOTO_URL = "https://fonts.gstatic.com/s/roboto/v30/KFOmCnqEu92Fr1Mu4mxP.ttf";
 async function createTextEngine(opts = {}) {
   const width = opts.width ?? CANVAS_CONFIG.DEFAULTS.width;
   const height = opts.height ?? CANVAS_CONFIG.DEFAULTS.height;
@@ -1202,109 +1409,237 @@ async function createTextEngine(opts = {}) {
   const wasmBaseURL = opts.wasmBaseURL;
   const fonts = new FontRegistry(wasmBaseURL);
   const layout = new LayoutEngine(fonts);
-  await fonts.init();
+  try {
+    FontRegistry.setFallbackLoader(async (desc) => {
+      const family = (desc.family ?? "Roboto").toLowerCase();
+      const weight = `${desc.weight ?? "400"}`;
+      const style = desc.style ?? "normal";
+      if (family === "roboto" && weight === "400" && style === "normal") {
+        return fetchToArrayBuffer(DEFAULT_ROBOTO_URL);
+      }
+      return void 0;
+    });
+    await fonts.init();
+  } catch (err) {
+    throw new Error(
+      `Failed to initialize font registry: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
   async function ensureFonts(asset) {
-    if (asset.customFonts) {
-      for (const cf of asset.customFonts) {
-        const bytes = await fetchToArrayBuffer(cf.src);
-        await fonts.registerFromBytes(bytes, {
-          family: cf.family,
-          weight: cf.weight ?? "400",
-          style: cf.style ?? "normal"
-        });
+    try {
+      if (asset.customFonts) {
+        for (const cf of asset.customFonts) {
+          try {
+            const bytes = await fetchToArrayBuffer(cf.src);
+            await fonts.registerFromBytes(bytes, {
+              family: cf.family,
+              weight: cf.weight ?? "400",
+              style: cf.style ?? "normal"
+            });
+          } catch (err) {
+            throw new Error(
+              `Failed to load custom font "${cf.family}" from ${cf.src}: ${err instanceof Error ? err.message : String(err)}`
+            );
+          }
+        }
       }
+      const main = asset.font ?? {
+        family: "Roboto",
+        weight: "400",
+        style: "normal",
+        size: 48,
+        color: "#000000",
+        opacity: 1
+      };
+      const desc = { family: main.family, weight: `${main.weight}`, style: main.style };
+      const ensureFace = async () => {
+        try {
+          await fonts.getFace(desc);
+        } catch {
+          const wantsDefaultRoboto = (main.family || "Roboto").toLowerCase() === "roboto" && `${main.weight}` === "400" && main.style === "normal";
+          if (wantsDefaultRoboto) {
+            const bytes = await fetchToArrayBuffer(DEFAULT_ROBOTO_URL);
+            await fonts.registerFromBytes(bytes, {
+              family: "Roboto",
+              weight: "400",
+              style: "normal"
+            });
+          } else {
+            throw new Error(
+              `Font not registered for ${desc.family}__${desc.weight}__${desc.style}`
+            );
+          }
+        }
+      };
+      await ensureFace();
+      return main;
+    } catch (err) {
+      if (err instanceof Error) throw err;
+      throw new Error(`Failed to ensure fonts: ${String(err)}`);
     }
-    const main = asset.font ?? {
-      family: "Roboto",
-      weight: "400",
-      style: "normal",
-      size: 48,
-      color: "#000000",
-      opacity: 1
-    };
-    return main;
   }
   return {
     validate(input) {
-      const { value, error } = RichTextAssetSchema.validate(input, {
-        abortEarly: false,
-        convert: true
-      });
-      if (error) throw error;
-      return { value };
+      try {
+        const { value, error } = RichTextAssetSchema.validate(input, {
+          abortEarly: false,
+          convert: true
+        });
+        if (error) throw error;
+        return { value };
+      } catch (err) {
+        if (err instanceof Error) {
+          throw new Error(`Validation failed: ${err.message}`);
+        }
+        throw new Error(`Validation failed: ${String(err)}`);
+      }
     },
     async registerFontFromUrl(url, desc) {
-      const bytes = await fetchToArrayBuffer(url);
-      await fonts.registerFromBytes(bytes, desc);
+      try {
+        const bytes = await fetchToArrayBuffer(url);
+        await fonts.registerFromBytes(bytes, desc);
+      } catch (err) {
+        throw new Error(
+          `Failed to register font "${desc.family}" from URL ${url}: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
     },
     async registerFontFromFile(source, desc) {
-      let bytes;
-      if (typeof source === "string") {
-        bytes = await fetchToArrayBuffer(source);
-      } else {
-        bytes = await source.arrayBuffer();
+      try {
+        let bytes;
+        if (typeof source === "string") {
+          try {
+            bytes = await fetchToArrayBuffer(source);
+          } catch (err) {
+            throw new Error(
+              `Failed to fetch font from ${source}: ${err instanceof Error ? err.message : String(err)}`
+            );
+          }
+        } else {
+          try {
+            bytes = await source.arrayBuffer();
+          } catch (err) {
+            throw new Error(
+              `Failed to read Blob as ArrayBuffer: ${err instanceof Error ? err.message : String(err)}`
+            );
+          }
+        }
+        await fonts.registerFromBytes(bytes, desc);
+      } catch (err) {
+        if (err instanceof Error) {
+          throw err;
+        }
+        throw new Error(
+          `Failed to register font "${desc.family}" from ${typeof source === "string" ? source : "Blob"}: ${String(err)}`
+        );
       }
-      await fonts.registerFromBytes(bytes, desc);
     },
     async renderFrame(asset, tSeconds) {
-      const main = await ensureFonts(asset);
-      const desc = { family: main.family, weight: `${main.weight}`, style: main.style };
-      const lines = await layout.layout({
-        text: asset.text,
-        width: asset.width ?? width,
-        letterSpacing: asset.style?.letterSpacing ?? 0,
-        fontSize: main.size,
-        lineHeight: asset.style?.lineHeight ?? 1.2,
-        desc,
-        textTransform: asset.style?.textTransform ?? "none"
-      });
-      const textRect = { x: 0, y: 0, width: asset.width ?? width, height: asset.height ?? height };
-      const ops0 = await buildDrawOps({
-        canvas: { width, height, pixelRatio },
-        textRect,
-        lines,
-        font: {
-          family: main.family,
-          size: main.size,
-          weight: `${main.weight}`,
-          style: main.style,
-          color: main.color,
-          opacity: main.opacity
-        },
-        style: {
-          lineHeight: asset.style?.lineHeight ?? 1.2,
-          textDecoration: asset.style?.textDecoration ?? "none",
-          gradient: asset.style?.gradient
-        },
-        stroke: asset.stroke,
-        shadow: asset.shadow,
-        align: asset.align ?? { horizontal: "left", vertical: "middle" },
-        background: asset.background,
-        glyphPathProvider: (gid) => fonts.glyphPath(desc, gid),
-        getUnitsPerEm: () => fonts.getUnitsPerEm(desc)
-      });
-      const ops = applyAnimation(ops0, lines, {
-        t: tSeconds,
-        fontSize: main.size,
-        anim: asset.animation ? {
-          preset: asset.animation.preset,
-          speed: asset.animation.speed,
-          duration: asset.animation.duration,
-          style: asset.animation.style,
-          direction: asset.animation.direction
-        } : void 0
-      });
-      return ops;
+      try {
+        const main = await ensureFonts(asset);
+        const desc = { family: main.family, weight: `${main.weight}`, style: main.style };
+        let lines;
+        try {
+          lines = await layout.layout({
+            text: asset.text,
+            width: asset.width ?? width,
+            letterSpacing: asset.style?.letterSpacing ?? 0,
+            fontSize: main.size,
+            lineHeight: asset.style?.lineHeight ?? 1.2,
+            desc,
+            textTransform: asset.style?.textTransform ?? "none"
+          });
+        } catch (err) {
+          throw new Error(
+            `Failed to layout text: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+        const textRect = {
+          x: 0,
+          y: 0,
+          width: asset.width ?? width,
+          height: asset.height ?? height
+        };
+        const canvasW = asset.width ?? width;
+        const canvasH = asset.height ?? height;
+        const canvasPR = asset.pixelRatio ?? pixelRatio;
+        let ops0;
+        try {
+          ops0 = await buildDrawOps({
+            canvas: { width: canvasW, height: canvasH, pixelRatio: canvasPR },
+            textRect,
+            lines,
+            font: {
+              family: main.family,
+              size: main.size,
+              weight: `${main.weight}`,
+              style: main.style,
+              color: main.color,
+              opacity: main.opacity
+            },
+            style: {
+              lineHeight: asset.style?.lineHeight ?? 1.2,
+              textDecoration: asset.style?.textDecoration ?? "none",
+              gradient: asset.style?.gradient
+            },
+            stroke: asset.stroke,
+            shadow: asset.shadow,
+            align: asset.align ?? { horizontal: "center", vertical: "middle" },
+            background: asset.background,
+            glyphPathProvider: (gid) => fonts.glyphPath(desc, gid),
+            getUnitsPerEm: () => fonts.getUnitsPerEm(desc)
+          });
+        } catch (err) {
+          throw new Error(
+            `Failed to build draw operations: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+        try {
+          const ops = applyAnimation(ops0, lines, {
+            t: tSeconds,
+            fontSize: main.size,
+            anim: asset.animation ? {
+              preset: asset.animation.preset,
+              speed: asset.animation.speed,
+              duration: asset.animation.duration,
+              style: asset.animation.style,
+              direction: asset.animation.direction
+            } : void 0
+          });
+          return ops;
+        } catch (err) {
+          throw new Error(
+            `Failed to apply animation: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+      } catch (err) {
+        if (err instanceof Error) {
+          throw err;
+        }
+        throw new Error(`Failed to render frame at time ${tSeconds}s: ${String(err)}`);
+      }
     },
     createRenderer(canvas) {
-      return createWebPainter(canvas);
+      try {
+        return createWebPainter(canvas);
+      } catch (err) {
+        throw new Error(
+          `Failed to create renderer: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
     },
     destroy() {
-      fonts.destroy();
+      try {
+        fonts.destroy();
+      } catch (err) {
+        console.error(`Error during cleanup: ${err instanceof Error ? err.message : String(err)}`);
+      }
     }
   };
 }
 export {
-  createTextEngine
+  createTextEngine,
+  isGlyphFill2 as isGlyphFill,
+  isShadowFill2 as isShadowFill
 };
 //# sourceMappingURL=entry.web.js.map