@artifact-kit/deckkit-pro 0.1.1 → 0.1.2

package/dist/cli.cjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 "use strict";
-const node_fs = require("node:fs");
+const fs = require("node:fs");
 const promises = require("node:fs/promises");
-const node_path = require("node:path");
+const path = require("node:path");
 const image = require("./image.cjs");
 const svgToPng = require("./svg-to-png.cjs");
 const FIT_VALUES = /* @__PURE__ */ new Set(["cover", "contain", "fill", "inside", "outside"]);
@@ -133,7 +133,7 @@ function normalizeOptionName(name) {
   }
 }
 async function readSvgInput(input) {
-  if (node_fs.existsSync(input)) {
+  if (fs.existsSync(input)) {
     return promises.readFile(input, "utf8");
   }
   return input;
@@ -178,7 +178,7 @@ function readValue(args, index, option) {
   return value;
 }
 function printUsage() {
-  const command = node_path.basename(process.argv[1] ?? "cli.js", node_path.extname(process.argv[1] ?? ""));
+  const command = path.basename(process.argv[1] ?? "cli.js", path.extname(process.argv[1] ?? ""));
   console.log(`Usage:
   node ${command}.js image-info <image>
   node ${command}.js crop <image> --x <px> --y <px> --w <px> --h <px> -o <png>

package/dist/image.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const promises = require("node:fs/promises");
-const node_path = require("node:path");
+const path = require("node:path");
 const sharp = require("sharp");
 async function getImageInfo(input) {
   const metadata = await sharp(input).metadata();
@@ -90,7 +90,7 @@ async function withOpacity(input, opacity) {
   }).png().toBuffer();
 }
 async function writeImage(buffer, output) {
-  await promises.mkdir(node_path.dirname(output), { recursive: true });
+  await promises.mkdir(path.dirname(output), { recursive: true });
   await sharp(buffer).toFile(output);
 }
 exports.compareImages = compareImages;

package/dist/index.cjs

@@ -5,6 +5,7 @@ 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 replicaRuntime = require("./replica-runtime.cjs");
 const image = require("./image.cjs");
 function deckkitPro(options = {}) {
   if (options.DeckKit) lifecycle.installDeckKitLifecyclePatch(options.DeckKit);
@@ -28,6 +29,7 @@ exports.prepareSvgPngFallbacks = svgFallback.prepareSvgPngFallbacks;
 exports.setupSvgPngFallback = svgFallback.setupSvgPngFallback;
 exports.renderSvgToPng = svgToPng.renderSvgToPng;
 exports.writeSvgToPng = svgToPng.writeSvgToPng;
+exports.createReplicaRuntime = replicaRuntime.createReplicaRuntime;
 exports.compareImages = image.compareImages;
 exports.cropImage = image.cropImage;
 exports.getImageInfo = image.getImageInfo;

package/dist/index.js

@@ -7,6 +7,7 @@ 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 { createReplicaRuntime } from "./replica-runtime.js";
 import { compareImages, cropImage, getImageInfo, overlayImages, resizeImage, sampleColor, writeImage } from "./image.js";
 function deckkitPro(options = {}) {
   if (options.DeckKit) installDeckKitLifecyclePatch(options.DeckKit);
@@ -22,6 +23,7 @@ function deckkitPro(options = {}) {
 export {
   addBeforeWriteHook,
   compareImages,
+  createReplicaRuntime,
   cropImage,
   deckkitPro,
   deckkitPro as default,

package/dist/replica-runtime.cjs

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const fs = require("node:fs");
+const path = require("node:path");
+const node_url = require("node:url");
+const DEFAULT_TASK_MANIFEST = "manifests/tasks/native-elements.json";
+const DEFAULT_CROPS_MANIFEST = "manifests/source-raster-cutouts.json";
+const DEFAULT_SVG_ASSETS_MANIFEST = "manifests/svg-assets.json";
+const DEFAULT_NATIVE_ELEMENTS_MANIFEST = "manifests/native-elements.json";
+const DEFAULT_NATIVE_ELEMENTS_SCRIPT = "scripts/regions/native-elements.mjs";
+const DEFAULT_SLIDE_WIDTH = 13.333;
+const SVG_ROUTES = /* @__PURE__ */ new Set(["svg-image", "editable-vector", "drawio-svg"]);
+function workspaceFromImportMeta(importMetaUrl) {
+  const filePath = node_url.fileURLToPath(importMetaUrl);
+  return path.resolve(path.dirname(filePath), "../..");
+}
+function readJson(workspacePath, relPath) {
+  return JSON.parse(fs.readFileSync(path.join(workspacePath, relPath), "utf8"));
+}
+function readOptionalJson(workspacePath, relPath) {
+  try {
+    const filePath = path.join(workspacePath, relPath);
+    if (!fs.existsSync(filePath)) return null;
+    const text = fs.readFileSync(filePath, "utf8").trim();
+    return text ? JSON.parse(text) : null;
+  } catch {
+    return null;
+  }
+}
+function assertFiniteBBox(bbox, label) {
+  for (const key of ["x", "y", "w", "h"]) {
+    if (!Number.isFinite(bbox[key])) throw new Error(`${label} bbox has non-finite ${key}`);
+  }
+}
+function unique(items) {
+  return [...new Set(items)];
+}
+function createReplicaRuntime(options) {
+  const workspacePath = path.resolve(options.workspacePath ?? workspaceFromImportMeta(options.importMetaUrl));
+  const taskManifestPath = options.taskManifestPath ?? DEFAULT_TASK_MANIFEST;
+  const sourceRasterCutoutsManifestPath = options.sourceRasterCutoutsManifestPath ?? DEFAULT_CROPS_MANIFEST;
+  const svgAssetsManifestPath = options.svgAssetsManifestPath ?? DEFAULT_SVG_ASSETS_MANIFEST;
+  const nativeElementsManifestPath = options.nativeElementsManifestPath ?? DEFAULT_NATIVE_ELEMENTS_MANIFEST;
+  const nativeElementsScriptPath = options.nativeElementsScriptPath ?? DEFAULT_NATIVE_ELEMENTS_SCRIPT;
+  const slideWidth = options.slideWidth ?? DEFAULT_SLIDE_WIDTH;
+  const slideHeight = options.slideHeight ?? options.sourceSize.h / options.sourceSize.w * slideWidth;
+  const taskManifest = readJson(workspacePath, taskManifestPath);
+  const cropManifest = readJson(workspacePath, sourceRasterCutoutsManifestPath);
+  const taskElements = new Map(taskManifest.elements.map((element) => [element.id, element]));
+  const cropElements = new Map(cropManifest.crops.map((crop) => [crop.elementId, crop]));
+  function pbox(bbox) {
+    assertFiniteBBox(bbox, "source");
+    return {
+      x: bbox.x / options.sourceSize.w * slideWidth,
+      y: bbox.y / options.sourceSize.h * slideHeight,
+      w: bbox.w / options.sourceSize.w * slideWidth,
+      h: bbox.h / options.sourceSize.h * slideHeight
+    };
+  }
+  function getElement(id) {
+    const element = taskElements.get(id);
+    if (!element) throw new Error(`Missing native element: ${id}`);
+    return element;
+  }
+  function getCrop(id) {
+    const crop = cropElements.get(id);
+    if (!crop) throw new Error(`Missing crop slot: ${id}`);
+    return crop;
+  }
+  function cropPath(id) {
+    return path.join(workspacePath, getCrop(id).path);
+  }
+  function assetPath(elementId, fallbackPath = cropPath(elementId)) {
+    const crop = cropElements.get(elementId);
+    if (!crop || !SVG_ROUTES.has(crop.route ?? "")) return fallbackPath;
+    const svgAssets = readOptionalJson(workspacePath, svgAssetsManifestPath);
+    const asset = svgAssets?.assets?.find((candidate) => candidate.elementId === elementId);
+    if (!asset || asset.status === "gap" || typeof asset.svgPath !== "string") return fallbackPath;
+    const svgPath = path.isAbsolute(asset.svgPath) ? asset.svgPath : path.join(workspacePath, asset.svgPath);
+    return fs.existsSync(svgPath) ? svgPath : fallbackPath;
+  }
+  function assertCoverage(ids, expectedIds, label) {
+    const duplicates = ids.filter((id, index) => ids.indexOf(id) !== index);
+    if (duplicates.length) throw new Error(`${label} duplicate ids: ${unique(duplicates).join(", ")}`);
+    const missing = expectedIds.filter((id) => !ids.includes(id));
+    const extra = ids.filter((id) => !expectedIds.includes(id));
+    if (missing.length || extra.length) {
+      throw new Error(`${label} coverage mismatch. Missing: ${missing.join(", ") || "none"} Extra: ${extra.join(", ") || "none"}`);
+    }
+  }
+  function replacementOwner(route) {
+    if (route === "source-raster") return "source-raster-cutouts";
+    if (SVG_ROUTES.has(route)) return "svg-assets";
+    if (route === "imagegen") return "imagegen-assets";
+    throw new Error(`Unexpected raster route: ${route}`);
+  }
+  function statusFor(route) {
+    return route === "source-raster" ? "final" : "placeholder";
+  }
+  function createRasterSlots(cropIds) {
+    const selectedIds = cropIds ?? cropManifest.crops.map((crop) => crop.elementId);
+    assertCoverage(selectedIds, cropManifest.crops.map((crop) => crop.elementId), "Raster slots");
+    return selectedIds.map((id) => {
+      const crop = getCrop(id);
+      const route = crop.route ?? "source-raster";
+      return {
+        elementId: crop.elementId,
+        route,
+        cropPath: crop.path,
+        bbox: crop.bbox,
+        status: statusFor(route),
+        replacementOwner: replacementOwner(route)
+      };
+    });
+  }
+  function writeNativeElementsManifest(input) {
+    const manifest = {
+      taskId: "native-elements",
+      generatedAt: input.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+      codexThreadId: input.codexThreadId,
+      scriptPath: nativeElementsScriptPath,
+      taskManifest: taskManifestPath,
+      sourceRasterCutoutsManifest: sourceRasterCutoutsManifestPath,
+      nativeElements: input.nativeElements,
+      rasterSlots: input.rasterSlots ?? createRasterSlots(),
+      outputPaths: input.outputPaths ?? [],
+      validationGaps: input.validationGaps ?? []
+    };
+    if (!manifest.codexThreadId) delete manifest.codexThreadId;
+    fs.writeFileSync(path.join(workspacePath, nativeElementsManifestPath), `${JSON.stringify(manifest, null, 2)}
+`);
+    return manifest;
+  }
+  function setupDeck(deck, input = {}) {
+    const layoutName = input.layoutName ?? "SOURCE";
+    deck.title = input.title ?? deck.title;
+    deck.author = input.author ?? "Artifact Kit";
+    deck.company = input.company ?? "Artifact Kit";
+    deck.subject = input.subject ?? deck.subject;
+    deck.defineLayout({ name: layoutName, width: slideWidth, height: slideHeight });
+    deck.layout = layoutName;
+    deck.theme = input.theme ?? {
+      headFontFace: "Microsoft YaHei",
+      bodyFontFace: "Microsoft YaHei",
+      lang: "zh-CN"
+    };
+    return deck;
+  }
+  return {
+    workspacePath,
+    slideSize: { w: slideWidth, h: slideHeight },
+    taskManifest,
+    cropManifest,
+    pbox,
+    getElement,
+    box: (id) => pbox(getElement(id).bbox),
+    getCrop,
+    cropBox: (id) => pbox(getCrop(id).bbox),
+    cropPath,
+    assetPath,
+    lineBox: (id) => {
+      const b = pbox(getElement(id).bbox);
+      return { x: b.x, y: b.y + b.h / 2, w: b.w, h: 0 };
+    },
+    assertCoverage,
+    assertNativeCoverage: (ids, label = "Native elements") => assertCoverage(ids, taskManifest.elements.map((element) => element.id), label),
+    assertRasterCoverage: (ids, label = "Raster slots") => assertCoverage(ids, cropManifest.crops.map((crop) => crop.elementId), label),
+    replacementOwner,
+    statusFor,
+    createRasterSlots,
+    writeNativeElementsManifest,
+    setupDeck
+  };
+}
+exports.createReplicaRuntime = createReplicaRuntime;

package/dist/replica-runtime.js

@@ -0,0 +1,175 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const DEFAULT_TASK_MANIFEST = "manifests/tasks/native-elements.json";
+const DEFAULT_CROPS_MANIFEST = "manifests/source-raster-cutouts.json";
+const DEFAULT_SVG_ASSETS_MANIFEST = "manifests/svg-assets.json";
+const DEFAULT_NATIVE_ELEMENTS_MANIFEST = "manifests/native-elements.json";
+const DEFAULT_NATIVE_ELEMENTS_SCRIPT = "scripts/regions/native-elements.mjs";
+const DEFAULT_SLIDE_WIDTH = 13.333;
+const SVG_ROUTES = /* @__PURE__ */ new Set(["svg-image", "editable-vector", "drawio-svg"]);
+function workspaceFromImportMeta(importMetaUrl) {
+  const filePath = fileURLToPath(importMetaUrl);
+  return path.resolve(path.dirname(filePath), "../..");
+}
+function readJson(workspacePath, relPath) {
+  return JSON.parse(fs.readFileSync(path.join(workspacePath, relPath), "utf8"));
+}
+function readOptionalJson(workspacePath, relPath) {
+  try {
+    const filePath = path.join(workspacePath, relPath);
+    if (!fs.existsSync(filePath)) return null;
+    const text = fs.readFileSync(filePath, "utf8").trim();
+    return text ? JSON.parse(text) : null;
+  } catch {
+    return null;
+  }
+}
+function assertFiniteBBox(bbox, label) {
+  for (const key of ["x", "y", "w", "h"]) {
+    if (!Number.isFinite(bbox[key])) throw new Error(`${label} bbox has non-finite ${key}`);
+  }
+}
+function unique(items) {
+  return [...new Set(items)];
+}
+function createReplicaRuntime(options) {
+  const workspacePath = path.resolve(options.workspacePath ?? workspaceFromImportMeta(options.importMetaUrl));
+  const taskManifestPath = options.taskManifestPath ?? DEFAULT_TASK_MANIFEST;
+  const sourceRasterCutoutsManifestPath = options.sourceRasterCutoutsManifestPath ?? DEFAULT_CROPS_MANIFEST;
+  const svgAssetsManifestPath = options.svgAssetsManifestPath ?? DEFAULT_SVG_ASSETS_MANIFEST;
+  const nativeElementsManifestPath = options.nativeElementsManifestPath ?? DEFAULT_NATIVE_ELEMENTS_MANIFEST;
+  const nativeElementsScriptPath = options.nativeElementsScriptPath ?? DEFAULT_NATIVE_ELEMENTS_SCRIPT;
+  const slideWidth = options.slideWidth ?? DEFAULT_SLIDE_WIDTH;
+  const slideHeight = options.slideHeight ?? options.sourceSize.h / options.sourceSize.w * slideWidth;
+  const taskManifest = readJson(workspacePath, taskManifestPath);
+  const cropManifest = readJson(workspacePath, sourceRasterCutoutsManifestPath);
+  const taskElements = new Map(taskManifest.elements.map((element) => [element.id, element]));
+  const cropElements = new Map(cropManifest.crops.map((crop) => [crop.elementId, crop]));
+  function pbox(bbox) {
+    assertFiniteBBox(bbox, "source");
+    return {
+      x: bbox.x / options.sourceSize.w * slideWidth,
+      y: bbox.y / options.sourceSize.h * slideHeight,
+      w: bbox.w / options.sourceSize.w * slideWidth,
+      h: bbox.h / options.sourceSize.h * slideHeight
+    };
+  }
+  function getElement(id) {
+    const element = taskElements.get(id);
+    if (!element) throw new Error(`Missing native element: ${id}`);
+    return element;
+  }
+  function getCrop(id) {
+    const crop = cropElements.get(id);
+    if (!crop) throw new Error(`Missing crop slot: ${id}`);
+    return crop;
+  }
+  function cropPath(id) {
+    return path.join(workspacePath, getCrop(id).path);
+  }
+  function assetPath(elementId, fallbackPath = cropPath(elementId)) {
+    const crop = cropElements.get(elementId);
+    if (!crop || !SVG_ROUTES.has(crop.route ?? "")) return fallbackPath;
+    const svgAssets = readOptionalJson(workspacePath, svgAssetsManifestPath);
+    const asset = svgAssets?.assets?.find((candidate) => candidate.elementId === elementId);
+    if (!asset || asset.status === "gap" || typeof asset.svgPath !== "string") return fallbackPath;
+    const svgPath = path.isAbsolute(asset.svgPath) ? asset.svgPath : path.join(workspacePath, asset.svgPath);
+    return fs.existsSync(svgPath) ? svgPath : fallbackPath;
+  }
+  function assertCoverage(ids, expectedIds, label) {
+    const duplicates = ids.filter((id, index) => ids.indexOf(id) !== index);
+    if (duplicates.length) throw new Error(`${label} duplicate ids: ${unique(duplicates).join(", ")}`);
+    const missing = expectedIds.filter((id) => !ids.includes(id));
+    const extra = ids.filter((id) => !expectedIds.includes(id));
+    if (missing.length || extra.length) {
+      throw new Error(`${label} coverage mismatch. Missing: ${missing.join(", ") || "none"} Extra: ${extra.join(", ") || "none"}`);
+    }
+  }
+  function replacementOwner(route) {
+    if (route === "source-raster") return "source-raster-cutouts";
+    if (SVG_ROUTES.has(route)) return "svg-assets";
+    if (route === "imagegen") return "imagegen-assets";
+    throw new Error(`Unexpected raster route: ${route}`);
+  }
+  function statusFor(route) {
+    return route === "source-raster" ? "final" : "placeholder";
+  }
+  function createRasterSlots(cropIds) {
+    const selectedIds = cropIds ?? cropManifest.crops.map((crop) => crop.elementId);
+    assertCoverage(selectedIds, cropManifest.crops.map((crop) => crop.elementId), "Raster slots");
+    return selectedIds.map((id) => {
+      const crop = getCrop(id);
+      const route = crop.route ?? "source-raster";
+      return {
+        elementId: crop.elementId,
+        route,
+        cropPath: crop.path,
+        bbox: crop.bbox,
+        status: statusFor(route),
+        replacementOwner: replacementOwner(route)
+      };
+    });
+  }
+  function writeNativeElementsManifest(input) {
+    const manifest = {
+      taskId: "native-elements",
+      generatedAt: input.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+      codexThreadId: input.codexThreadId,
+      scriptPath: nativeElementsScriptPath,
+      taskManifest: taskManifestPath,
+      sourceRasterCutoutsManifest: sourceRasterCutoutsManifestPath,
+      nativeElements: input.nativeElements,
+      rasterSlots: input.rasterSlots ?? createRasterSlots(),
+      outputPaths: input.outputPaths ?? [],
+      validationGaps: input.validationGaps ?? []
+    };
+    if (!manifest.codexThreadId) delete manifest.codexThreadId;
+    fs.writeFileSync(path.join(workspacePath, nativeElementsManifestPath), `${JSON.stringify(manifest, null, 2)}
+`);
+    return manifest;
+  }
+  function setupDeck(deck, input = {}) {
+    const layoutName = input.layoutName ?? "SOURCE";
+    deck.title = input.title ?? deck.title;
+    deck.author = input.author ?? "Artifact Kit";
+    deck.company = input.company ?? "Artifact Kit";
+    deck.subject = input.subject ?? deck.subject;
+    deck.defineLayout({ name: layoutName, width: slideWidth, height: slideHeight });
+    deck.layout = layoutName;
+    deck.theme = input.theme ?? {
+      headFontFace: "Microsoft YaHei",
+      bodyFontFace: "Microsoft YaHei",
+      lang: "zh-CN"
+    };
+    return deck;
+  }
+  return {
+    workspacePath,
+    slideSize: { w: slideWidth, h: slideHeight },
+    taskManifest,
+    cropManifest,
+    pbox,
+    getElement,
+    box: (id) => pbox(getElement(id).bbox),
+    getCrop,
+    cropBox: (id) => pbox(getCrop(id).bbox),
+    cropPath,
+    assetPath,
+    lineBox: (id) => {
+      const b = pbox(getElement(id).bbox);
+      return { x: b.x, y: b.y + b.h / 2, w: b.w, h: 0 };
+    },
+    assertCoverage,
+    assertNativeCoverage: (ids, label = "Native elements") => assertCoverage(ids, taskManifest.elements.map((element) => element.id), label),
+    assertRasterCoverage: (ids, label = "Raster slots") => assertCoverage(ids, cropManifest.crops.map((crop) => crop.elementId), label),
+    replacementOwner,
+    statusFor,
+    createRasterSlots,
+    writeNativeElementsManifest,
+    setupDeck
+  };
+}
+export {
+  createReplicaRuntime
+};

package/dist/svg-to-png-cli.cjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 "use strict";
-const node_fs = require("node:fs");
+const fs = require("node:fs");
 const promises = require("node:fs/promises");
-const node_path = require("node:path");
+const path = require("node:path");
 const svgToPng = require("./svg-to-png.cjs");
 const FIT_VALUES = /* @__PURE__ */ new Set(["cover", "contain", "fill", "inside", "outside"]);
 async function main(args) {
@@ -68,7 +68,7 @@ function parseArgs(args) {
   return result;
 }
 async function readSvgInput(input) {
-  if (node_fs.existsSync(input)) {
+  if (fs.existsSync(input)) {
     return promises.readFile(input, "utf8");
   }
   return input;
@@ -88,7 +88,7 @@ function readNumber(args, index, option) {
   return value;
 }
 function printUsage() {
-  const command = node_path.basename(process.argv[1] ?? "svg-to-png-cli.js", node_path.extname(process.argv[1] ?? ""));
+  const command = path.basename(process.argv[1] ?? "svg-to-png-cli.js", path.extname(process.argv[1] ?? ""));
   console.log(`Usage:
   node ${command}.js "<svg ...>" -o output.png
   node ${command}.js input.svg -o output.png

package/dist/types/index.d.ts

@@ -17,6 +17,8 @@ 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 { ReplicaBBox, ReplicaCropManifest, ReplicaCropRecord, ReplicaDeckSetupOptions, ReplicaManifestWriteOptions, ReplicaNativeElementRecord, ReplicaNativeElementsManifest, ReplicaRasterReplacementOwner, ReplicaRasterSlotRecord, ReplicaRasterSlotStatus, ReplicaRuntime, ReplicaRuntimeOptions, ReplicaSourceSize, ReplicaSvgAssetRecord, ReplicaSvgAssetsManifest, ReplicaTaskElement, ReplicaTaskManifest, } from './replica-runtime';
+export { createReplicaRuntime } from './replica-runtime';
 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';

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;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"}
+{"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,EACX,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,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/replica-runtime.d.ts

@@ -0,0 +1,150 @@
+export interface ReplicaBBox {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface ReplicaSourceSize {
+    w: number;
+    h: number;
+}
+export interface ReplicaTaskElement {
+    id: string;
+    route?: string;
+    bbox: ReplicaBBox;
+    [key: string]: unknown;
+}
+export interface ReplicaCropRecord {
+    elementId: string;
+    path: string;
+    route?: string;
+    bbox: ReplicaBBox;
+    [key: string]: unknown;
+}
+export interface ReplicaTaskManifest {
+    elements: ReplicaTaskElement[];
+    [key: string]: unknown;
+}
+export interface ReplicaCropManifest {
+    crops: ReplicaCropRecord[];
+    [key: string]: unknown;
+}
+export interface ReplicaSvgAssetRecord {
+    elementId: string;
+    svgPath?: string;
+    status?: string;
+    [key: string]: unknown;
+}
+export interface ReplicaSvgAssetsManifest {
+    assets?: ReplicaSvgAssetRecord[];
+    [key: string]: unknown;
+}
+export interface ReplicaNativeElementRecord {
+    elementId: string;
+    route: 'native-text' | 'native-shape';
+    implementation: 'deckkit-text' | 'deckkit-shape';
+    bbox: ReplicaBBox;
+    editable: true;
+    [key: string]: unknown;
+}
+export type ReplicaRasterReplacementOwner = 'source-raster-cutouts' | 'svg-assets' | 'imagegen-assets';
+export type ReplicaRasterSlotStatus = 'final' | 'placeholder';
+export interface ReplicaRasterSlotRecord {
+    elementId: string;
+    route: string;
+    cropPath: string;
+    bbox: ReplicaBBox;
+    status: ReplicaRasterSlotStatus;
+    replacementOwner: ReplicaRasterReplacementOwner;
+}
+export interface ReplicaNativeElementsManifest {
+    taskId: 'native-elements';
+    generatedAt: string;
+    codexThreadId?: string;
+    scriptPath: string;
+    taskManifest: string;
+    sourceRasterCutoutsManifest: string;
+    nativeElements: ReplicaNativeElementRecord[];
+    rasterSlots: ReplicaRasterSlotRecord[];
+    outputPaths: string[];
+    validationGaps: string[];
+}
+export interface ReplicaRuntimeOptions {
+    importMetaUrl: string;
+    sourceSize: ReplicaSourceSize;
+    slideWidth?: number;
+    slideHeight?: number;
+    workspacePath?: string;
+    taskManifestPath?: string;
+    sourceRasterCutoutsManifestPath?: string;
+    svgAssetsManifestPath?: string;
+    nativeElementsManifestPath?: string;
+    nativeElementsScriptPath?: string;
+}
+export interface ReplicaDeckSetupOptions {
+    title?: string;
+    author?: string;
+    company?: string;
+    subject?: string;
+    layoutName?: string;
+    theme?: {
+        headFontFace?: string;
+        bodyFontFace?: string;
+        lang?: string;
+        [key: string]: unknown;
+    };
+}
+export interface ReplicaManifestWriteOptions {
+    nativeElements: ReplicaNativeElementRecord[];
+    rasterSlots?: ReplicaRasterSlotRecord[];
+    outputPaths?: string[];
+    validationGaps?: string[];
+    generatedAt?: string;
+    codexThreadId?: string;
+}
+export interface ReplicaRuntime {
+    workspacePath: string;
+    slideSize: {
+        w: number;
+        h: number;
+    };
+    taskManifest: ReplicaTaskManifest;
+    cropManifest: ReplicaCropManifest;
+    pbox(bbox: ReplicaBBox): ReplicaBBox;
+    getElement(id: string): ReplicaTaskElement;
+    box(id: string): ReplicaBBox;
+    getCrop(id: string): ReplicaCropRecord;
+    cropBox(id: string): ReplicaBBox;
+    cropPath(id: string): string;
+    assetPath(elementId: string, fallbackPath?: string): string;
+    lineBox(id: string): {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    assertCoverage(ids: string[], expectedIds: string[], label: string): void;
+    assertNativeCoverage(ids: string[], label?: string): void;
+    assertRasterCoverage(ids: string[], label?: string): void;
+    replacementOwner(route: string): ReplicaRasterReplacementOwner;
+    statusFor(route: string): ReplicaRasterSlotStatus;
+    createRasterSlots(cropIds?: string[]): ReplicaRasterSlotRecord[];
+    writeNativeElementsManifest(options: ReplicaManifestWriteOptions): ReplicaNativeElementsManifest;
+    setupDeck<TDeck extends ReplicaDeckLike>(deck: TDeck, options?: ReplicaDeckSetupOptions): TDeck;
+}
+interface ReplicaDeckLike {
+    title?: string;
+    author?: string;
+    company?: string;
+    subject?: string;
+    layout?: string;
+    theme?: unknown;
+    defineLayout(layout: {
+        name: string;
+        width: number;
+        height: number;
+    }): unknown;
+}
+export declare function createReplicaRuntime(options: ReplicaRuntimeOptions): ReplicaRuntime;
+export {};
+//# sourceMappingURL=replica-runtime.d.ts.map

package/dist/types/replica-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replica-runtime.d.ts","sourceRoot":"","sources":["../../src/replica-runtime.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artifact-kit/deckkit-pro",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Commercial DeckKit plugin bundle.",
   "license": "SEE LICENSE IN COMMERCIAL-LICENSE.md",
   "type": "module",
@@ -48,6 +48,11 @@
       "import": "./dist/lifecycle.js",
       "require": "./dist/lifecycle.cjs"
     },
+    "./replica-runtime": {
+      "types": "./dist/types/replica-runtime.d.ts",
+      "import": "./dist/replica-runtime.js",
+      "require": "./dist/replica-runtime.cjs"
+    },
     "./svg-to-custom-geometry": {
       "types": "./dist/types/svg-to-custom-geometry.d.ts",
       "import": "./dist/svg-to-custom-geometry.js",