@artifact-kit/deckkit-pro 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -2,14 +2,18 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
 const gradientFill = require("./gradient-fill.cjs");
 const svgToCustomGeometry = require("./svg-to-custom-geometry.cjs");
+const lifecycle = require("./lifecycle.cjs");
+const svgFallback = require("./svg-fallback.cjs");
 const svgToPng = require("./svg-to-png.cjs");
 const image = require("./image.cjs");
-function deckkitPro() {
+function deckkitPro(options = {}) {
+  if (options.DeckKit) lifecycle.installDeckKitLifecyclePatch(options.DeckKit);
   return {
     name: "@artifact-kit/deckkit-pro",
     setup(context) {
       gradientFill.setupGradientFill(context);
       svgToCustomGeometry.setupSvgCustomGeometry(context);
+      svgFallback.setupSvgPngFallback(context, options.DeckKit);
     }
   };
 }
@@ -18,6 +22,10 @@ exports.setupGradientFill = gradientFill.setupGradientFill;
 exports.handleSvgCustomGeometry = svgToCustomGeometry.handleSvgCustomGeometry;
 exports.setupSvgCustomGeometry = svgToCustomGeometry.setupSvgCustomGeometry;
 exports.svgToCustomGeometry = svgToCustomGeometry.svgToCustomGeometry;
+exports.addBeforeWriteHook = lifecycle.addBeforeWriteHook;
+exports.installDeckKitLifecyclePatch = lifecycle.installDeckKitLifecyclePatch;
+exports.prepareSvgPngFallbacks = svgFallback.prepareSvgPngFallbacks;
+exports.setupSvgPngFallback = svgFallback.setupSvgPngFallback;
 exports.renderSvgToPng = svgToPng.renderSvgToPng;
 exports.writeSvgToPng = svgToPng.writeSvgToPng;
 exports.compareImages = image.compareImages;

package/dist/index.js

@@ -2,31 +2,41 @@ import { setupGradientFill } from "./gradient-fill.js";
 import { renderGradientFill } from "./gradient-fill.js";
 import { setupSvgCustomGeometry } from "./svg-to-custom-geometry.js";
 import { handleSvgCustomGeometry, svgToCustomGeometry } from "./svg-to-custom-geometry.js";
+import { installDeckKitLifecyclePatch } from "./lifecycle.js";
+import { addBeforeWriteHook } from "./lifecycle.js";
+import { setupSvgPngFallback } from "./svg-fallback.js";
+import { prepareSvgPngFallbacks } from "./svg-fallback.js";
 import { renderSvgToPng, writeSvgToPng } from "./svg-to-png.js";
 import { compareImages, cropImage, getImageInfo, overlayImages, resizeImage, sampleColor, writeImage } from "./image.js";
-function deckkitPro() {
+function deckkitPro(options = {}) {
+  if (options.DeckKit) installDeckKitLifecyclePatch(options.DeckKit);
   return {
     name: "@artifact-kit/deckkit-pro",
     setup(context) {
       setupGradientFill(context);
       setupSvgCustomGeometry(context);
+      setupSvgPngFallback(context, options.DeckKit);
     }
   };
 }
 export {
+  addBeforeWriteHook,
   compareImages,
   cropImage,
   deckkitPro,
   deckkitPro as default,
   getImageInfo,
   handleSvgCustomGeometry,
+  installDeckKitLifecyclePatch,
   overlayImages,
+  prepareSvgPngFallbacks,
   renderGradientFill,
   renderSvgToPng,
   resizeImage,
   sampleColor,
   setupGradientFill,
   setupSvgCustomGeometry,
+  setupSvgPngFallback,
   svgToCustomGeometry,
   writeImage,
   writeSvgToPng

package/dist/lifecycle.cjs

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DeckKit = require("@artifact-kit/deckkit");
+const LIFECYCLE_PATCHED = Symbol.for("@artifact-kit/deckkit-pro:lifecycle-patched");
+const setupDecks = /* @__PURE__ */ new WeakMap();
+const beforeWriteHooks = /* @__PURE__ */ new WeakMap();
+const prototypeBeforeWriteHooks = /* @__PURE__ */ new WeakMap();
+function addBeforeWriteHook(context, id, hook, deckKit) {
+  const deck = setupDecks.get(context);
+  if (!deck) {
+    const proto = deckKit?.prototype;
+    if (proto) {
+      addPrototypeBeforeWriteHook(proto, id, hook);
+      return;
+    }
+    throw new Error(
+      `DeckKit Pro lifecycle hook "${id}" could not find the active DeckKit instance. This usually means @artifact-kit/deckkit-pro and @artifact-kit/deckkit resolved different @artifact-kit/deckkit copies. Use matching package imports, or pass the caller constructor with deckkitPro({ DeckKit }).`
+    );
+  }
+  let hooks = beforeWriteHooks.get(deck);
+  if (!hooks) {
+    hooks = /* @__PURE__ */ new Map();
+    beforeWriteHooks.set(deck, hooks);
+  }
+  hooks.set(id, hook);
+}
+function installDeckKitLifecyclePatch(deckKit = DeckKit) {
+  const proto = deckKit.prototype;
+  if (!proto || proto[LIFECYCLE_PATCHED]) return;
+  const originalUse = proto.use;
+  const originalWrite = proto.write;
+  const originalWriteFile = proto.writeFile;
+  if (typeof originalUse === "function") {
+    proto.use = function patchedUse(plugin, options) {
+      const pluginWithLifecycleContext = {
+        ...plugin,
+        setup: (context, setupOptions) => {
+          setupDecks.set(context, this);
+          try {
+            plugin.setup(context, setupOptions);
+          } finally {
+            setupDecks.delete(context);
+          }
+        }
+      };
+      return originalUse.call(this, pluginWithLifecycleContext, options);
+    };
+  }
+  if (typeof originalWrite === "function") {
+    proto.write = async function patchedWrite(...args) {
+      await runBeforeWriteHooks(this);
+      return await originalWrite.apply(this, args);
+    };
+  }
+  if (typeof originalWriteFile === "function") {
+    proto.writeFile = async function patchedWriteFile(...args) {
+      await runBeforeWriteHooks(this);
+      return await originalWriteFile.apply(this, args);
+    };
+  }
+  proto[LIFECYCLE_PATCHED] = true;
+}
+async function runBeforeWriteHooks(deck) {
+  const proto = Object.getPrototypeOf(deck);
+  const prototypeHooks = proto ? prototypeBeforeWriteHooks.get(proto) : void 0;
+  if (prototypeHooks) {
+    for (const hook of prototypeHooks.values()) {
+      await hook(deck);
+    }
+  }
+  const hooks = beforeWriteHooks.get(deck);
+  if (!hooks) return;
+  for (const hook of hooks.values()) {
+    await hook(deck);
+  }
+}
+function addPrototypeBeforeWriteHook(proto, id, hook) {
+  let hooks = prototypeBeforeWriteHooks.get(proto);
+  if (!hooks) {
+    hooks = /* @__PURE__ */ new Map();
+    prototypeBeforeWriteHooks.set(proto, hooks);
+  }
+  hooks.set(id, hook);
+}
+installDeckKitLifecyclePatch();
+exports.addBeforeWriteHook = addBeforeWriteHook;
+exports.installDeckKitLifecyclePatch = installDeckKitLifecyclePatch;

package/dist/lifecycle.js

@@ -0,0 +1,87 @@
+import DeckKit from "@artifact-kit/deckkit";
+const LIFECYCLE_PATCHED = Symbol.for("@artifact-kit/deckkit-pro:lifecycle-patched");
+const setupDecks = /* @__PURE__ */ new WeakMap();
+const beforeWriteHooks = /* @__PURE__ */ new WeakMap();
+const prototypeBeforeWriteHooks = /* @__PURE__ */ new WeakMap();
+function addBeforeWriteHook(context, id, hook, deckKit) {
+  const deck = setupDecks.get(context);
+  if (!deck) {
+    const proto = deckKit?.prototype;
+    if (proto) {
+      addPrototypeBeforeWriteHook(proto, id, hook);
+      return;
+    }
+    throw new Error(
+      `DeckKit Pro lifecycle hook "${id}" could not find the active DeckKit instance. This usually means @artifact-kit/deckkit-pro and @artifact-kit/deckkit resolved different @artifact-kit/deckkit copies. Use matching package imports, or pass the caller constructor with deckkitPro({ DeckKit }).`
+    );
+  }
+  let hooks = beforeWriteHooks.get(deck);
+  if (!hooks) {
+    hooks = /* @__PURE__ */ new Map();
+    beforeWriteHooks.set(deck, hooks);
+  }
+  hooks.set(id, hook);
+}
+function installDeckKitLifecyclePatch(deckKit = DeckKit) {
+  const proto = deckKit.prototype;
+  if (!proto || proto[LIFECYCLE_PATCHED]) return;
+  const originalUse = proto.use;
+  const originalWrite = proto.write;
+  const originalWriteFile = proto.writeFile;
+  if (typeof originalUse === "function") {
+    proto.use = function patchedUse(plugin, options) {
+      const pluginWithLifecycleContext = {
+        ...plugin,
+        setup: (context, setupOptions) => {
+          setupDecks.set(context, this);
+          try {
+            plugin.setup(context, setupOptions);
+          } finally {
+            setupDecks.delete(context);
+          }
+        }
+      };
+      return originalUse.call(this, pluginWithLifecycleContext, options);
+    };
+  }
+  if (typeof originalWrite === "function") {
+    proto.write = async function patchedWrite(...args) {
+      await runBeforeWriteHooks(this);
+      return await originalWrite.apply(this, args);
+    };
+  }
+  if (typeof originalWriteFile === "function") {
+    proto.writeFile = async function patchedWriteFile(...args) {
+      await runBeforeWriteHooks(this);
+      return await originalWriteFile.apply(this, args);
+    };
+  }
+  proto[LIFECYCLE_PATCHED] = true;
+}
+async function runBeforeWriteHooks(deck) {
+  const proto = Object.getPrototypeOf(deck);
+  const prototypeHooks = proto ? prototypeBeforeWriteHooks.get(proto) : void 0;
+  if (prototypeHooks) {
+    for (const hook of prototypeHooks.values()) {
+      await hook(deck);
+    }
+  }
+  const hooks = beforeWriteHooks.get(deck);
+  if (!hooks) return;
+  for (const hook of hooks.values()) {
+    await hook(deck);
+  }
+}
+function addPrototypeBeforeWriteHook(proto, id, hook) {
+  let hooks = prototypeBeforeWriteHooks.get(proto);
+  if (!hooks) {
+    hooks = /* @__PURE__ */ new Map();
+    prototypeBeforeWriteHooks.set(proto, hooks);
+  }
+  hooks.set(id, hook);
+}
+installDeckKitLifecyclePatch();
+export {
+  addBeforeWriteHook,
+  installDeckKitLifecyclePatch
+};

package/dist/svg-fallback.cjs

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const promises = require("node:fs/promises");
+const node_buffer = require("node:buffer");
+const lifecycle = require("./lifecycle.cjs");
+const svgToPng = require("./svg-to-png.cjs");
+const EMU_PER_INCH = 914400;
+const FALLBACK_DPI = 96;
+async function prepareSvgPngFallbacks(deck) {
+  for (const rel of collectSvgPngFallbackRels(deck)) {
+    if (hasPngData(rel.data)) continue;
+    const svg = await readSvgForFallback(rel);
+    const png = await svgToPng.renderSvgToPng(svg, {
+      width: emuToPixels(rel.svgSize?.w),
+      height: emuToPixels(rel.svgSize?.h),
+      fit: "contain"
+    });
+    rel.type = "image/png";
+    rel.extn = "png";
+    rel.data = png.toString("base64");
+    rel.isSvgPng = false;
+  }
+}
+function setupSvgPngFallback(context, deckKit) {
+  lifecycle.addBeforeWriteHook(context, "svg-png-fallback", prepareSvgPngFallbacks, deckKit);
+}
+function collectSvgPngFallbackRels(deck) {
+  const containers = [
+    ...deck.slides ?? [],
+    ...deck.slideLayouts ?? [],
+    deck.masterSlide
+  ].filter(Boolean);
+  return containers.flatMap(
+    (container) => (container._relsMedia ?? []).filter((rel) => rel.isSvgPng && rel.type === "image/png")
+  );
+}
+async function readSvgForFallback(rel) {
+  if (typeof rel.data === "string" && looksLikeSvgData(rel.data)) return decodeSvgData(rel.data);
+  if (typeof rel.path === "string" && rel.path.length > 0) {
+    if (/^https?:\/\//i.test(rel.path)) {
+      const response = await fetch(rel.path);
+      if (!response.ok) throw new Error(`Unable to fetch SVG PNG fallback source ${rel.path}: ${response.status} ${response.statusText}`);
+      return await response.text();
+    }
+    return await promises.readFile(rel.path, "utf8");
+  }
+  throw new Error(`Unable to render SVG PNG fallback for ${rel.Target ?? "unknown media"}: missing SVG data or path.`);
+}
+function looksLikeSvgData(data) {
+  const trimmed = data.trimStart();
+  return trimmed.startsWith("<svg") || trimmed.startsWith("data:image/svg+xml");
+}
+function decodeSvgData(data) {
+  if (data.trimStart().startsWith("<svg")) return data;
+  const [, meta = "", payload = ""] = /^data:image\/svg\+xml([^,]*),(.*)$/i.exec(data) ?? [];
+  if (!payload) return data;
+  if (meta.includes(";base64")) return node_buffer.Buffer.from(payload, "base64").toString("utf8");
+  return decodeURIComponent(payload);
+}
+function hasPngData(data) {
+  if (typeof data !== "string") return false;
+  return data.startsWith("data:image/png") || data.startsWith("iVBORw0KGgo");
+}
+function emuToPixels(value) {
+  if (!value || value <= 0) return void 0;
+  return Math.max(1, Math.round(value / EMU_PER_INCH * FALLBACK_DPI));
+}
+exports.prepareSvgPngFallbacks = prepareSvgPngFallbacks;
+exports.setupSvgPngFallback = setupSvgPngFallback;

package/dist/svg-fallback.js

@@ -0,0 +1,69 @@
+import { readFile } from "node:fs/promises";
+import { Buffer } from "node:buffer";
+import { addBeforeWriteHook } from "./lifecycle.js";
+import { renderSvgToPng } from "./svg-to-png.js";
+const EMU_PER_INCH = 914400;
+const FALLBACK_DPI = 96;
+async function prepareSvgPngFallbacks(deck) {
+  for (const rel of collectSvgPngFallbackRels(deck)) {
+    if (hasPngData(rel.data)) continue;
+    const svg = await readSvgForFallback(rel);
+    const png = await renderSvgToPng(svg, {
+      width: emuToPixels(rel.svgSize?.w),
+      height: emuToPixels(rel.svgSize?.h),
+      fit: "contain"
+    });
+    rel.type = "image/png";
+    rel.extn = "png";
+    rel.data = png.toString("base64");
+    rel.isSvgPng = false;
+  }
+}
+function setupSvgPngFallback(context, deckKit) {
+  addBeforeWriteHook(context, "svg-png-fallback", prepareSvgPngFallbacks, deckKit);
+}
+function collectSvgPngFallbackRels(deck) {
+  const containers = [
+    ...deck.slides ?? [],
+    ...deck.slideLayouts ?? [],
+    deck.masterSlide
+  ].filter(Boolean);
+  return containers.flatMap(
+    (container) => (container._relsMedia ?? []).filter((rel) => rel.isSvgPng && rel.type === "image/png")
+  );
+}
+async function readSvgForFallback(rel) {
+  if (typeof rel.data === "string" && looksLikeSvgData(rel.data)) return decodeSvgData(rel.data);
+  if (typeof rel.path === "string" && rel.path.length > 0) {
+    if (/^https?:\/\//i.test(rel.path)) {
+      const response = await fetch(rel.path);
+      if (!response.ok) throw new Error(`Unable to fetch SVG PNG fallback source ${rel.path}: ${response.status} ${response.statusText}`);
+      return await response.text();
+    }
+    return await readFile(rel.path, "utf8");
+  }
+  throw new Error(`Unable to render SVG PNG fallback for ${rel.Target ?? "unknown media"}: missing SVG data or path.`);
+}
+function looksLikeSvgData(data) {
+  const trimmed = data.trimStart();
+  return trimmed.startsWith("<svg") || trimmed.startsWith("data:image/svg+xml");
+}
+function decodeSvgData(data) {
+  if (data.trimStart().startsWith("<svg")) return data;
+  const [, meta = "", payload = ""] = /^data:image\/svg\+xml([^,]*),(.*)$/i.exec(data) ?? [];
+  if (!payload) return data;
+  if (meta.includes(";base64")) return Buffer.from(payload, "base64").toString("utf8");
+  return decodeURIComponent(payload);
+}
+function hasPngData(data) {
+  if (typeof data !== "string") return false;
+  return data.startsWith("data:image/png") || data.startsWith("iVBORw0KGgo");
+}
+function emuToPixels(value) {
+  if (!value || value <= 0) return void 0;
+  return Math.max(1, Math.round(value / EMU_PER_INCH * FALLBACK_DPI));
+}
+export {
+  prepareSvgPngFallbacks,
+  setupSvgPngFallback
+};

package/dist/svg-to-png.cjs

@@ -10,7 +10,8 @@ async function renderSvgToPng(svg, options = {}) {
     image.resize({
       width: options.width,
       height: options.height,
-      fit: options.fit ?? "contain"
+      fit: options.fit ?? "contain",
+      background: options.background ?? { r: 0, g: 0, b: 0, alpha: 0 }
     });
   }
   if (options.background !== void 0) {

package/dist/svg-to-png.js

@@ -8,7 +8,8 @@ async function renderSvgToPng(svg, options = {}) {
     image.resize({
       width: options.width,
       height: options.height,
-      fit: options.fit ?? "contain"
+      fit: options.fit ?? "contain",
+      background: options.background ?? { r: 0, g: 0, b: 0, alpha: 0 }
     });
   }
   if (options.background !== void 0) {

package/dist/types/index.d.ts

@@ -1,14 +1,26 @@
 import type { DeckKitPlugin } from '@artifact-kit/deckkit';
 import './gradient-fill';
 import './svg-to-custom-geometry';
+import './lifecycle';
+import { type DeckKitConstructor } from './lifecycle';
+export interface DeckKitProOptions {
+    /**
+     * DeckKit constructor to patch when deckkit-pro is loaded from a different
+     * package location than the caller's @artifact-kit/deckkit import.
+     */
+    DeckKit?: DeckKitConstructor;
+}
 export type { GradientFillProps, GradientFillStop } from './gradient-fill';
 export { renderGradientFill, setupGradientFill } from './gradient-fill';
 export type { SvgToPngFit, SvgToPngOptions } from './svg-to-png';
 export { renderSvgToPng, writeSvgToPng } from './svg-to-png';
+export { setupSvgPngFallback, prepareSvgPngFallbacks } from './svg-fallback';
+export { addBeforeWriteHook, installDeckKitLifecyclePatch } from './lifecycle';
+export type { DeckKitBeforeWriteHook, DeckKitConstructor } from './lifecycle';
 export type { SvgCustomGeometryPath, SvgToCustomGeometryOptions, SvgToCustomGeometryResult } from './svg-to-custom-geometry';
 export { handleSvgCustomGeometry, setupSvgCustomGeometry, svgToCustomGeometry } from './svg-to-custom-geometry';
 export type { CompareImagesOptions, CropImageOptions, ImageInfo, OverlayImagesOptions, ResizeImageOptions, SampleColorResult, } from './image';
 export { compareImages, cropImage, getImageInfo, overlayImages, resizeImage, sampleColor, writeImage } from './image';
-export declare function deckkitPro(): DeckKitPlugin;
+export declare function deckkitPro(options?: DeckKitProOptions): DeckKitPlugin;
 export default deckkitPro;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,iBAAiB,CAAA;AACxB,OAAO,0BAA0B,CAAA;AAIjC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACvE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5D,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAC5H,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC/G,YAAY,EACX,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAErH,wBAAgB,UAAU,IAAI,aAAa,CAQ1C;AAED,eAAe,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,iBAAiB,CAAA;AACxB,OAAO,0BAA0B,CAAA;AACjC,OAAO,aAAa,CAAA;AAIpB,OAAO,EAAgC,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEnF,MAAM,WAAW,iBAAiB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAC5B;AAED,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACvE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAC5E,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAC9E,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC7E,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAC5H,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC/G,YAAY,EACX,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAErH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,aAAa,CAWzE;AAED,eAAe,UAAU,CAAA"}

package/dist/types/lifecycle.d.ts

@@ -0,0 +1,8 @@
+import type { DeckKitPluginContext } from '@artifact-kit/deckkit';
+export type DeckKitBeforeWriteHook = (deck: unknown) => void | Promise<void>;
+export type DeckKitConstructor = {
+    prototype?: Record<PropertyKey, unknown>;
+};
+export declare function addBeforeWriteHook(context: DeckKitPluginContext, id: string, hook: DeckKitBeforeWriteHook, deckKit?: DeckKitConstructor): void;
+export declare function installDeckKitLifecyclePatch(deckKit?: DeckKitConstructor): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/types/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAIhF,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAC5E,MAAM,MAAM,kBAAkB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAa7E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAsB9I;AAED,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,kBAA6D,GAAG,IAAI,CAyCzH"}

package/dist/types/svg-fallback.d.ts

@@ -0,0 +1,5 @@
+import type { DeckKitPluginContext } from '@artifact-kit/deckkit';
+import { type DeckKitConstructor } from './lifecycle';
+export declare function prepareSvgPngFallbacks(deck: unknown): Promise<void>;
+export declare function setupSvgPngFallback(context: DeckKitPluginContext, deckKit?: DeckKitConstructor): void;
+//# sourceMappingURL=svg-fallback.d.ts.map

package/dist/types/svg-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-fallback.d.ts","sourceRoot":"","sources":["../../src/svg-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAGjE,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AA0BzE,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBzE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAErG"}

package/dist/types/svg-to-png.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"svg-to-png.d.ts","sourceRoot":"","sources":["../../src/svg-to-png.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE7E,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBhG;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/G"}
+{"version":3,"file":"svg-to-png.d.ts","sourceRoot":"","sources":["../../src/svg-to-png.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE7E,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBhG;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/G"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artifact-kit/deckkit-pro",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Commercial DeckKit plugin bundle.",
   "license": "SEE LICENSE IN COMMERCIAL-LICENSE.md",
   "type": "module",
@@ -43,11 +43,21 @@
       "import": "./dist/image.js",
       "require": "./dist/image.cjs"
     },
+    "./lifecycle": {
+      "types": "./dist/types/lifecycle.d.ts",
+      "import": "./dist/lifecycle.js",
+      "require": "./dist/lifecycle.cjs"
+    },
     "./svg-to-custom-geometry": {
       "types": "./dist/types/svg-to-custom-geometry.d.ts",
       "import": "./dist/svg-to-custom-geometry.js",
       "require": "./dist/svg-to-custom-geometry.cjs"
     },
+    "./svg-fallback": {
+      "types": "./dist/types/svg-fallback.d.ts",
+      "import": "./dist/svg-fallback.js",
+      "require": "./dist/svg-fallback.cjs"
+    },
     "./svg-to-png": {
       "types": "./dist/types/svg-to-png.d.ts",
       "import": "./dist/svg-to-png.js",
@@ -78,7 +88,7 @@
     "test": "tsc -p tsconfig.test.json && node test/paper-svg-path.test.cjs"
   },
   "peerDependencies": {
-    "@artifact-kit/deckkit": "^0.1.0"
+    "@artifact-kit/deckkit": "^0.1.2"
   },
   "dependencies": {
     "paper-jsdom": "^0.12.18",