@enslo/sd-metadata 1.7.0 → 1.8.0

package/dist/index.js

@@ -96,8 +96,7 @@ function parseSettings(settings) {
   const result = /* @__PURE__ */ new Map();
   if (!settings) return result;
   const regex = /([A-Za-z][A-Za-z0-9 ]*?):\s*([^,]+?)(?=,\s*[A-Za-z][A-Za-z0-9 ]*?:|$)/g;
-  const matches = Array.from(settings.matchAll(regex));
-  for (const match of matches) {
+  for (const match of settings.matchAll(regex)) {
     const key = (match[1] ?? "").trim();
     const value = (match[2] ?? "").trim();
     result.set(key, value);
@@ -162,83 +161,45 @@ function toJsonResult(value) {
   }
 }
 
-// src/parsers/comfyui-civitai.ts
-function extractExtraMetadata(prompt, entryRecord) {
-  const extraMetaField = prompt.extraMetadata;
-  if (typeof extraMetaField === "string") {
-    const parsed = parseJson(extraMetaField);
-    if (parsed.ok && parsed.type === "object") return parsed.value;
-  }
-  if (entryRecord?.extraMetadata) {
-    const parsed = parseJson(entryRecord.extraMetadata);
-    if (parsed.ok && parsed.type === "object") return parsed.value;
-  }
-  return void 0;
-}
-function extractCivitaiMetadata(extraMeta) {
-  if (!extraMeta) return void 0;
-  const upscale = buildCivitaiUpscale(extraMeta);
-  const sampling = buildCivitaiSampling(extraMeta);
-  return trimObject({
-    prompt: extraMeta.prompt,
-    negativePrompt: extraMeta.negativePrompt,
-    width: extraMeta.width,
-    height: extraMeta.height,
-    model: extraMeta.baseModel ? { name: extraMeta.baseModel } : void 0,
-    ...sampling,
-    ...upscale
-  });
-}
-function calculateScale(targetWidth, baseWidth) {
-  if (baseWidth <= 0 || targetWidth <= 0) return void 0;
-  return Math.round(targetWidth / baseWidth * 100) / 100;
-}
-function buildCivitaiUpscale(extraMeta) {
-  if (!extraMeta.transformations) return {};
-  const upscaleTransform = extraMeta.transformations.find(
-    (t) => t.type === "upscale"
-  );
-  if (!upscaleTransform?.upscaleWidth) return {};
-  const scale = calculateScale(
-    upscaleTransform.upscaleWidth,
-    extraMeta.width ?? 0
-  );
-  if (scale === void 0) return {};
-  return {
-    upscale: { scale }
-  };
-}
-function buildCivitaiSampling(extraMeta) {
-  if (extraMeta.seed === void 0 && extraMeta.steps === void 0 && extraMeta.cfgScale === void 0 && extraMeta.sampler === void 0) {
-    return {};
-  }
-  return {
-    sampling: {
-      seed: extraMeta.seed,
-      steps: extraMeta.steps,
-      cfg: extraMeta.cfgScale,
-      sampler: extraMeta.sampler
+// src/parsers/comfyui-nodes.ts
+var SAMPLER_TYPES = ["KSampler", "KSamplerAdvanced", "SamplerCustomAdvanced"];
+var LATENT_IMAGE_TYPES = ["EmptyLatentImage"];
+var LATENT_IMAGE_RGTHREE_TYPES = ["SDXL Empty Latent Image (rgthree)"];
+var CHECKPOINT_TYPES = ["CheckpointLoaderSimple", "CheckpointLoader"];
+var UNET_LOADER_TYPES = ["UNETLoader"];
+var HIRES_MODEL_UPSCALE_TYPES = ["UpscaleModelLoader"];
+var HIRES_IMAGE_SCALE_TYPES = ["ImageScale", "ImageScaleBy"];
+var LATENT_UPSCALE_TYPES = ["LatentUpscale", "LatentUpscaleBy"];
+var VAE_ENCODE_TYPES = ["VAEEncode", "VAEEncodeTiled"];
+function classifyNodes(nodes) {
+  const result = {};
+  for (const node of Object.values(nodes)) {
+    const ct = node.class_type;
+    if (!result.sampler && SAMPLER_TYPES.includes(ct)) {
+      result.sampler = node;
+    } else if (!result.latentImage && LATENT_IMAGE_TYPES.includes(ct)) {
+      result.latentImage = node;
+    } else if (!result.latentImageRgthree && LATENT_IMAGE_RGTHREE_TYPES.includes(ct)) {
+      result.latentImageRgthree = node;
+    } else if (!result.checkpoint && CHECKPOINT_TYPES.includes(ct)) {
+      result.checkpoint = node;
+    } else if (!result.unetLoader && UNET_LOADER_TYPES.includes(ct)) {
+      result.unetLoader = node;
+    } else if (!result.hiresModelUpscale && HIRES_MODEL_UPSCALE_TYPES.includes(ct)) {
+      result.hiresModelUpscale = node;
+    } else if (!result.hiresImageScale && HIRES_IMAGE_SCALE_TYPES.includes(ct)) {
+      result.hiresImageScale = node;
+    } else if (!result.latentUpscale && LATENT_UPSCALE_TYPES.includes(ct)) {
+      result.latentUpscale = node;
+    } else if (!result.vaeEncode && VAE_ENCODE_TYPES.includes(ct)) {
+      result.vaeEncode = node;
     }
-  };
+  }
+  return result;
 }
-
-// src/parsers/comfyui-nodes.ts
-var CLASS_TYPES = {
-  sampler: ["KSampler", "KSamplerAdvanced", "SamplerCustomAdvanced"],
-  // Standard latent image nodes with width/height properties
-  latentImage: ["EmptyLatentImage"],
-  // rgthree latent image nodes with "dimensions" string property
-  latentImageRgthree: ["SDXL Empty Latent Image (rgthree)"],
-  checkpoint: ["CheckpointLoaderSimple", "CheckpointLoader"],
-  hiresModelUpscale: ["UpscaleModelLoader"],
-  hiresImageScale: ["ImageScale", "ImageScaleBy"],
-  latentUpscale: ["LatentUpscale", "LatentUpscaleBy"],
-  vaeEncode: ["VAEEncode", "VAEEncodeTiled"]
-};
-function findNode(nodes, classTypes) {
-  return Object.values(nodes).find(
-    (node) => classTypes.includes(node.class_type)
-  );
+function resolveNode(nodes, ref) {
+  if (!isNodeReference(ref)) return void 0;
+  return nodes[String(ref[0])];
 }
 function isNodeReference(value) {
   return Array.isArray(value) && value.length === 2 && (typeof value[0] === "string" || typeof value[0] === "number") && typeof value[1] === "number";
@@ -256,28 +217,31 @@ function extractText(nodes, nodeId, maxDepth = 10) {
   }
   return "";
 }
-function extractPromptTexts(nodes) {
-  const sampler = findNode(nodes, CLASS_TYPES.sampler);
+function resolveConditioningSource(nodes, sampler) {
+  const guiderNode = resolveNode(nodes, sampler.inputs.guider);
+  if (guiderNode) return guiderNode;
+  return sampler;
+}
+function extractPromptTexts(nodes, sampler) {
   if (!sampler) {
     return { promptText: "", negativeText: "" };
   }
-  const positiveRef = sampler.inputs.positive;
-  const negativeRef = sampler.inputs.negative;
+  const conditioningSource = resolveConditioningSource(nodes, sampler);
+  const positiveRef = conditioningSource.inputs.positive;
+  const negativeRef = conditioningSource.inputs.negative;
   return {
     promptText: isNodeReference(positiveRef) ? extractText(nodes, String(positiveRef[0])) : "",
     negativeText: isNodeReference(negativeRef) ? extractText(nodes, String(negativeRef[0])) : ""
   };
 }
-function extractDimensions(nodes) {
-  const standardLatent = findNode(nodes, CLASS_TYPES.latentImage);
-  if (standardLatent) {
-    const width = Number(standardLatent.inputs.width) || 0;
-    const height = Number(standardLatent.inputs.height) || 0;
+function extractDimensions(latentImage, latentImageRgthree) {
+  if (latentImage) {
+    const width = Number(latentImage.inputs.width) || 0;
+    const height = Number(latentImage.inputs.height) || 0;
     if (width > 0 && height > 0) return { width, height };
   }
-  const rgthreeLatent = findNode(nodes, CLASS_TYPES.latentImageRgthree);
-  if (rgthreeLatent && typeof rgthreeLatent.inputs.dimensions === "string") {
-    const match = rgthreeLatent.inputs.dimensions.match(/^(\d+)\s*x\s*(\d+)/);
+  if (latentImageRgthree && typeof latentImageRgthree.inputs.dimensions === "string") {
+    const match = latentImageRgthree.inputs.dimensions.match(/^(\d+)\s*x\s*(\d+)/);
     if (match?.[1] && match[2]) {
       return {
         width: Number.parseInt(match[1], 10),
@@ -287,9 +251,11 @@ function extractDimensions(nodes) {
   }
   return { width: 0, height: 0 };
 }
-function extractSampling(nodes) {
-  const sampler = findNode(nodes, CLASS_TYPES.sampler);
+function extractSampling(nodes, sampler) {
   if (!sampler) return void 0;
+  if (sampler.class_type === "SamplerCustomAdvanced") {
+    return extractAdvancedSampling(nodes, sampler);
+  }
   let seed = sampler.inputs.seed;
   if (isNodeReference(seed)) {
     const seedNode = nodes[String(seed[0])];
@@ -306,36 +272,112 @@ function extractSampling(nodes) {
     denoise
   };
 }
-function extractModel(nodes) {
-  const checkpoint = findNode(nodes, CLASS_TYPES.checkpoint);
-  if (!checkpoint?.inputs?.ckpt_name) return void 0;
-  return { name: String(checkpoint.inputs.ckpt_name) };
+function extractAdvancedSampling(nodes, sampler) {
+  const noiseNode = resolveNode(nodes, sampler.inputs.noise);
+  const guiderNode = resolveNode(nodes, sampler.inputs.guider);
+  const samplerSelectNode = resolveNode(nodes, sampler.inputs.sampler);
+  const schedulerNode = resolveNode(nodes, sampler.inputs.sigmas);
+  const rawDenoise = schedulerNode?.inputs.denoise;
+  const denoise = typeof rawDenoise === "number" && rawDenoise < 1 ? rawDenoise : void 0;
+  return {
+    seed: noiseNode?.inputs.noise_seed,
+    steps: schedulerNode?.inputs.steps,
+    cfg: guiderNode?.inputs.cfg,
+    sampler: samplerSelectNode?.inputs.sampler_name,
+    scheduler: schedulerNode?.inputs.scheduler,
+    denoise
+  };
+}
+function extractModel(checkpoint, unetLoader) {
+  if (checkpoint?.inputs?.ckpt_name) {
+    return { name: String(checkpoint.inputs.ckpt_name) };
+  }
+  if (unetLoader?.inputs?.unet_name) {
+    return { name: String(unetLoader.inputs.unet_name) };
+  }
+  return void 0;
+}
+function calculateScale(targetWidth, baseWidth) {
+  if (baseWidth <= 0 || targetWidth <= 0) return void 0;
+  return Math.round(targetWidth / baseWidth * 100) / 100;
 }
 function isHiresSampler(nodes, sampler) {
   const latentImageRef = sampler.inputs.latent_image;
   if (!isNodeReference(latentImageRef)) return false;
   const inputNode = nodes[String(latentImageRef[0])];
   if (!inputNode) return false;
-  const latentUpscaleTypes = CLASS_TYPES.latentUpscale;
-  if (latentUpscaleTypes.includes(inputNode.class_type)) {
+  if (LATENT_UPSCALE_TYPES.includes(inputNode.class_type)) {
     return true;
   }
-  const vaeTypes = CLASS_TYPES.vaeEncode;
-  if (!vaeTypes.includes(inputNode.class_type)) return false;
+  if (!VAE_ENCODE_TYPES.includes(inputNode.class_type)) return false;
   const pixelsRef = inputNode.inputs.pixels;
   if (!isNodeReference(pixelsRef)) return false;
   const upscaleNode = nodes[String(pixelsRef[0])];
   if (!upscaleNode) return false;
-  const imageScaleTypes = CLASS_TYPES.hiresImageScale;
-  return imageScaleTypes.includes(upscaleNode.class_type);
+  return HIRES_IMAGE_SCALE_TYPES.includes(upscaleNode.class_type);
 }
 function findHiresSampler(nodes) {
-  const samplerTypes = CLASS_TYPES.sampler;
   return Object.values(nodes).find(
-    (node) => samplerTypes.includes(node.class_type) && isHiresSampler(nodes, node)
+    (node) => SAMPLER_TYPES.includes(node.class_type) && isHiresSampler(nodes, node)
   );
 }
 
+// src/parsers/comfyui-civitai.ts
+function extractExtraMetadata(prompt, entryRecord) {
+  const extraMetaField = prompt.extraMetadata;
+  if (typeof extraMetaField === "string") {
+    const parsed = parseJson(extraMetaField);
+    if (parsed.ok && parsed.type === "object") return parsed.value;
+  }
+  if (entryRecord?.extraMetadata) {
+    const parsed = parseJson(entryRecord.extraMetadata);
+    if (parsed.ok && parsed.type === "object") return parsed.value;
+  }
+  return void 0;
+}
+function extractCivitaiMetadata(extraMeta) {
+  if (!extraMeta) return void 0;
+  const upscale = buildCivitaiUpscale(extraMeta);
+  const sampling = buildCivitaiSampling(extraMeta);
+  return trimObject({
+    prompt: extraMeta.prompt,
+    negativePrompt: extraMeta.negativePrompt,
+    width: extraMeta.width,
+    height: extraMeta.height,
+    model: extraMeta.baseModel ? { name: extraMeta.baseModel } : void 0,
+    ...sampling,
+    ...upscale
+  });
+}
+function buildCivitaiUpscale(extraMeta) {
+  if (!extraMeta.transformations) return {};
+  const upscaleTransform = extraMeta.transformations.find(
+    (t) => t.type === "upscale"
+  );
+  if (!upscaleTransform?.upscaleWidth) return {};
+  const scale = calculateScale(
+    upscaleTransform.upscaleWidth,
+    extraMeta.width ?? 0
+  );
+  if (scale === void 0) return {};
+  return {
+    upscale: { scale }
+  };
+}
+function buildCivitaiSampling(extraMeta) {
+  if (extraMeta.seed === void 0 && extraMeta.steps === void 0 && extraMeta.cfgScale === void 0 && extraMeta.sampler === void 0) {
+    return {};
+  }
+  return {
+    sampling: {
+      seed: extraMeta.seed,
+      steps: extraMeta.steps,
+      cfg: extraMeta.cfgScale,
+      sampler: extraMeta.sampler
+    }
+  };
+}
+
 // src/parsers/comfyui.ts
 var CIVITAI_EXTENSION_KEYS = ["extra", "extraMetadata", "resource-stack"];
 function parseComfyUI(entries) {
@@ -373,10 +415,6 @@ function parseComfyUI(entries) {
 function cleanJsonString(json) {
   return json.replace(/\0+$/, "").replace(/:\s*NaN\b/g, ": null");
 }
-function calculateScale2(targetWidth, baseWidth) {
-  if (baseWidth <= 0 || targetWidth <= 0) return void 0;
-  return Math.round(targetWidth / baseWidth * 100) / 100;
-}
 function findPromptJson(entryRecord) {
   if (entryRecord.prompt) {
     return cleanJsonString(entryRecord.prompt);
@@ -408,51 +446,61 @@ function findPromptJson(entryRecord) {
   return void 0;
 }
 function extractComfyUIMetadata(nodes) {
-  const { promptText, negativeText } = extractPromptTexts(nodes);
-  const { width, height } = extractDimensions(nodes);
-  const hiresModel = findNode(nodes, CLASS_TYPES.hiresModelUpscale)?.inputs;
-  const hiresImageScale = findNode(nodes, CLASS_TYPES.hiresImageScale)?.inputs;
-  const latentUpscale = findNode(nodes, CLASS_TYPES.latentUpscale)?.inputs;
-  const hiresSampler = findHiresSampler(nodes)?.inputs;
+  const c = classifyNodes(nodes);
+  const { promptText, negativeText } = extractPromptTexts(nodes, c.sampler);
+  const { width, height } = extractDimensions(
+    c.latentImage,
+    c.latentImageRgthree
+  );
+  const hiresSamplerNode = findHiresSampler(nodes);
+  const hiresSampling = hiresSamplerNode ? extractSampling(nodes, hiresSamplerNode) : void 0;
+  const hiresScale = resolveHiresScale(nodes, c, width);
+  const upscalerName = c.hiresModelUpscale?.inputs.model_name;
   return trimObject({
     prompt: promptText || void 0,
     negativePrompt: negativeText || void 0,
     width: width > 0 ? width : void 0,
     height: height > 0 ? height : void 0,
-    model: extractModel(nodes),
-    sampling: extractSampling(nodes),
-    ...buildHiresOrUpscale(
-      hiresModel,
-      hiresImageScale,
-      latentUpscale,
-      hiresSampler,
-      width
-    )
+    model: extractModel(c.checkpoint, c.unetLoader),
+    sampling: extractSampling(nodes, c.sampler),
+    ...buildHiresOrUpscale(upscalerName, hiresScale, hiresSampling)
   });
 }
-function buildHiresOrUpscale(hiresModel, hiresImageScale, latentUpscale, hiresSampler, baseWidth) {
-  if (!hiresModel && !hiresImageScale && !latentUpscale) return {};
-  let scale;
+function resolveHiresScale(nodes, c, baseWidth) {
+  const latentUpscale = c.latentUpscale?.inputs;
   if (latentUpscale?.scale_by !== void 0) {
-    scale = latentUpscale.scale_by;
-  } else if (hiresImageScale?.width !== void 0) {
-    scale = calculateScale2(hiresImageScale.width, baseWidth);
+    return latentUpscale.scale_by;
+  }
+  const widthInput = c.hiresImageScale?.inputs.width;
+  if (widthInput === void 0) return void 0;
+  if (isNodeReference(widthInput)) {
+    const sourceNode = nodes[String(widthInput[0])];
+    if (typeof sourceNode?.inputs.clip_scale === "number") {
+      return sourceNode.inputs.clip_scale;
+    }
+    return void 0;
+  }
+  if (typeof widthInput === "number") {
+    return calculateScale(widthInput, baseWidth);
   }
-  const upscaler = hiresModel?.model_name;
-  if (hiresSampler) {
+  return void 0;
+}
+function buildHiresOrUpscale(upscalerName, scale, hiresSampling) {
+  if (!upscalerName && scale === void 0 && !hiresSampling) return {};
+  if (hiresSampling) {
     return {
       hires: {
-        upscaler,
+        upscaler: upscalerName,
         scale,
-        steps: hiresSampler.steps,
-        denoise: hiresSampler.denoise
+        steps: hiresSampling.steps,
+        denoise: hiresSampling.denoise
       }
     };
   }
-  if (!upscaler) return {};
+  if (!upscalerName) return {};
   return {
     upscale: {
-      upscaler,
+      upscaler: upscalerName,
       scale
     }
   };
@@ -460,14 +508,10 @@ function buildHiresOrUpscale(hiresModel, hiresImageScale, latentUpscale, hiresSa
 function mergeObjects(base, override) {
   if (!base && !override) return void 0;
   const merged = {};
-  if (base) {
-    for (const [key, value] of Object.entries(base)) {
-      if (value !== void 0) merged[key] = value;
-    }
-  }
-  if (override) {
-    for (const [key, value] of Object.entries(override)) {
-      if (value !== void 0) merged[key] = value;
+  for (const obj of [base, override]) {
+    if (!obj) continue;
+    for (const [k, v] of Object.entries(obj)) {
+      if (v !== void 0) merged[k] = v;
     }
   }
   return Object.keys(merged).length > 0 ? merged : void 0;
@@ -492,27 +536,23 @@ function mergeMetadata(base, override) {
 }
 
 // src/parsers/detect.ts
-var MARKERS = {
-  // Unique chunk keywords
-  INVOKEAI: "invokeai_metadata",
-  TENSORART: "generation_data",
-  STABILITY_MATRIX: "smproj",
-  EASYDIFFUSION: "use_stable_diffusion_model",
-  CIVITAI_EXTRA: "extraMetadata",
-  // Content patterns
-  SWARMUI: "sui_image_params",
-  SWARM_VERSION: "swarm_version",
-  COMFYUI_NODE: "class_type",
-  NOVELAI_SCHEDULE: "noise_schedule",
-  NOVELAI_V4: "v4_prompt",
-  NOVELAI_UNCOND: "uncond_scale",
-  CIVITAI_NS: "civitai:",
-  CIVITAI_RESOURCES: "Civitai resources:",
-  RUINED_FOOOCUS: "RuinedFooocus",
-  HF_MODEL: '"Model"',
-  HF_RESOLUTION: '"resolution"',
-  FOOOCUS_BASE: '"base_model"'
-};
+var M_INVOKEAI = "invokeai_metadata";
+var M_TENSORART = "generation_data";
+var M_STABILITY_MATRIX = "smproj";
+var M_CIVITAI_EXTRA = "extraMetadata";
+var M_SWARMUI = "sui_image_params";
+var M_SWARM_VERSION = "swarm_version";
+var M_COMFYUI_NODE = "class_type";
+var M_NOVELAI_SCHEDULE = "noise_schedule";
+var M_NOVELAI_V4 = "v4_prompt";
+var M_NOVELAI_UNCOND = "uncond_scale";
+var M_CIVITAI_NS = "civitai:";
+var M_CIVITAI_RESOURCES = "Civitai resources:";
+var M_RUINED_FOOOCUS = "RuinedFooocus";
+var M_EASYDIFFUSION = "use_stable_diffusion_model";
+var M_HF_MODEL = '"Model"';
+var M_HF_RESOLUTION = '"resolution"';
+var M_FOOOCUS_BASE = '"base_model"';
 function detectSoftware(entries) {
   const uniqueResult = detectUniqueKeywords(entries);
   if (uniqueResult) return uniqueResult;
@@ -524,27 +564,24 @@ function detectSoftware(entries) {
   }
   return null;
 }
+function detectByUniqueKey(record) {
+  if (M_INVOKEAI in record) return "invokeai";
+  if (M_TENSORART in record) return "tensorart";
+  if (M_STABILITY_MATRIX in record) return "stability-matrix";
+  if (M_CIVITAI_EXTRA in record) return "civitai";
+  return null;
+}
 function detectUniqueKeywords(entryRecord) {
   if (entryRecord.Software?.startsWith("NovelAI")) {
     return "novelai";
   }
-  if (MARKERS.INVOKEAI in entryRecord) {
-    return "invokeai";
-  }
-  if (MARKERS.TENSORART in entryRecord) {
-    return "tensorart";
-  }
-  if (MARKERS.STABILITY_MATRIX in entryRecord) {
-    return "stability-matrix";
-  }
+  const keyResult = detectByUniqueKey(entryRecord);
+  if (keyResult) return keyResult;
   if ("negative_prompt" in entryRecord || "Negative Prompt" in entryRecord) {
     return "easydiffusion";
   }
-  if (MARKERS.CIVITAI_EXTRA in entryRecord) {
-    return "civitai";
-  }
   const parameters = entryRecord.parameters;
-  if (parameters?.includes(MARKERS.SWARMUI)) {
+  if (parameters?.includes(M_SWARMUI)) {
     return "swarmui";
   }
   const comment = entryRecord.UserComment ?? entryRecord.Comment;
@@ -556,18 +593,8 @@ function detectUniqueKeywords(entryRecord) {
 function detectFromCommentJson(comment) {
   try {
     const parsed = JSON.parse(comment);
-    if (MARKERS.INVOKEAI in parsed) {
-      return "invokeai";
-    }
-    if (MARKERS.TENSORART in parsed) {
-      return "tensorart";
-    }
-    if (MARKERS.STABILITY_MATRIX in parsed) {
-      return "stability-matrix";
-    }
-    if (MARKERS.CIVITAI_EXTRA in parsed) {
-      return "civitai";
-    }
+    const keyResult = detectByUniqueKey(parsed);
+    if (keyResult) return keyResult;
     if ("prompt" in parsed && "workflow" in parsed) {
       const workflow = parsed.workflow;
       const prompt = parsed.prompt;
@@ -577,12 +604,12 @@ function detectFromCommentJson(comment) {
         return "comfyui";
       }
     }
-    if (MARKERS.SWARMUI in parsed) {
+    if (M_SWARMUI in parsed) {
       return "swarmui";
     }
     if ("prompt" in parsed && "parameters" in parsed) {
       const params = String(parsed.parameters || "");
-      if (params.includes(MARKERS.SWARMUI) || params.includes(MARKERS.SWARM_VERSION)) {
+      if (params.includes(M_SWARMUI) || params.includes(M_SWARM_VERSION)) {
         return "swarmui";
       }
     }
@@ -600,13 +627,13 @@ function detectComfyUIEntries(entryRecord) {
   if ("prompt" in entryRecord) {
     const promptText = entryRecord.prompt;
     if (promptText?.startsWith("{")) {
-      if (promptText.includes(MARKERS.SWARMUI)) {
+      if (promptText.includes(M_SWARMUI)) {
         return "swarmui";
       }
-      if (promptText.includes(`"${MARKERS.CIVITAI_EXTRA}"`)) {
+      if (promptText.includes(`"${M_CIVITAI_EXTRA}"`)) {
         return "civitai";
       }
-      if (promptText.includes(MARKERS.COMFYUI_NODE)) {
+      if (promptText.includes(M_COMFYUI_NODE)) {
         return "comfyui";
       }
     }
@@ -620,25 +647,25 @@ function detectFromTextContent(text) {
   return detectFromA1111Format(text);
 }
 function detectFromJsonFormat(json) {
-  if (json.includes(MARKERS.SWARMUI)) {
+  if (json.includes(M_SWARMUI)) {
     return "swarmui";
   }
-  if (json.includes(`"software":"${MARKERS.RUINED_FOOOCUS}"`) || json.includes(`"software": "${MARKERS.RUINED_FOOOCUS}"`)) {
+  if (json.includes(`"software":"${M_RUINED_FOOOCUS}"`) || json.includes(`"software": "${M_RUINED_FOOOCUS}"`)) {
     return "ruined-fooocus";
   }
-  if (json.includes(`"${MARKERS.EASYDIFFUSION}"`)) {
+  if (json.includes(`"${M_EASYDIFFUSION}"`)) {
     return "easydiffusion";
   }
-  if (json.includes(MARKERS.CIVITAI_NS) || json.includes(`"${MARKERS.CIVITAI_EXTRA}"`)) {
+  if (json.includes(M_CIVITAI_NS) || json.includes(`"${M_CIVITAI_EXTRA}"`)) {
     return "civitai";
   }
-  if (json.includes(`"${MARKERS.NOVELAI_V4}"`) || json.includes(`"${MARKERS.NOVELAI_SCHEDULE}"`) || json.includes(`"${MARKERS.NOVELAI_UNCOND}"`) || json.includes('"Software":"NovelAI"') || json.includes(`\\"${MARKERS.NOVELAI_SCHEDULE}\\"`) || json.includes(`\\"${MARKERS.NOVELAI_V4}\\"`)) {
+  if (json.includes(`"${M_NOVELAI_V4}"`) || json.includes(`"${M_NOVELAI_SCHEDULE}"`) || json.includes(`"${M_NOVELAI_UNCOND}"`) || json.includes('"Software":"NovelAI"') || json.includes(`\\"${M_NOVELAI_SCHEDULE}\\"`) || json.includes(`\\"${M_NOVELAI_V4}\\"`)) {
     return "novelai";
   }
-  if (json.includes(MARKERS.HF_MODEL) && json.includes(MARKERS.HF_RESOLUTION)) {
+  if (json.includes(M_HF_MODEL) && json.includes(M_HF_RESOLUTION)) {
     return "hf-space";
   }
-  if (json.includes('"prompt"') && json.includes(MARKERS.FOOOCUS_BASE)) {
+  if (json.includes('"prompt"') && json.includes(M_FOOOCUS_BASE)) {
     return "fooocus";
   }
   if (json.includes('"prompt"') || json.includes('"nodes"')) {
@@ -647,7 +674,7 @@ function detectFromJsonFormat(json) {
   return null;
 }
 function detectFromA1111Format(text) {
-  if (text.includes(MARKERS.SWARMUI) || text.includes(MARKERS.SWARM_VERSION)) {
+  if (text.includes(M_SWARMUI) || text.includes(M_SWARM_VERSION)) {
     return "swarmui";
   }
   const versionMatch = text.match(/Version:\s*([^\s,]+)/);
@@ -666,7 +693,7 @@ function detectFromA1111Format(text) {
   if (text.includes("App: SD.Next") || text.includes("App:SD.Next")) {
     return "sd-next";
   }
-  if (text.includes(MARKERS.CIVITAI_RESOURCES)) {
+  if (text.includes(M_CIVITAI_RESOURCES)) {
     return "civitai";
   }
   if (text.includes("Steps:") && text.includes("Sampler:")) {
@@ -676,9 +703,6 @@ function detectFromA1111Format(text) {
 }
 
 // src/parsers/easydiffusion.ts
-function getValue(json, keyA, keyB) {
-  return json[keyA] ?? json[keyB];
-}
 function extractModelName(path) {
   if (!path) return void 0;
   const parts = path.replace(/\\/g, "/").split("/");
@@ -686,7 +710,7 @@ function extractModelName(path) {
 }
 function parseEasyDiffusion(entries) {
   if (entries.negative_prompt || entries["Negative Prompt"]) {
-    return parseFromEntries(entries);
+    return buildMetadata(entries);
   }
   const jsonText = entries.parameters?.startsWith("{") ? entries.parameters : entries.UserComment?.startsWith("{") && entries.UserComment;
   if (!jsonText) {
@@ -699,63 +723,38 @@ function parseEasyDiffusion(entries) {
       message: "Invalid JSON in Easy Diffusion metadata"
     });
   }
-  return parseFromJson(parsed.value);
+  return buildMetadata(parsed.value);
 }
-function parseFromEntries(entryRecord) {
-  const prompt = entryRecord.prompt ?? entryRecord.Prompt ?? "";
-  const negativePrompt = entryRecord.negative_prompt ?? entryRecord["Negative Prompt"] ?? entryRecord.negative_prompt ?? "";
-  const modelPath = entryRecord.use_stable_diffusion_model ?? entryRecord["Stable Diffusion model"];
-  const width = Number(entryRecord.width ?? entryRecord.Width) || 0;
-  const height = Number(entryRecord.height ?? entryRecord.Height) || 0;
-  const metadata = {
-    software: "easydiffusion",
-    prompt: prompt.trim(),
-    negativePrompt: negativePrompt.trim(),
-    width,
-    height,
-    model: {
-      name: extractModelName(modelPath),
-      vae: entryRecord.use_vae_model ?? entryRecord["VAE model"]
-    },
-    sampling: {
-      sampler: entryRecord.sampler_name ?? entryRecord.Sampler,
-      steps: Number(entryRecord.num_inference_steps ?? entryRecord.Steps) || void 0,
-      cfg: Number(entryRecord.guidance_scale ?? entryRecord["Guidance Scale"]) || void 0,
-      seed: Number(entryRecord.seed ?? entryRecord.Seed) || void 0,
-      clipSkip: Number(entryRecord.clip_skip ?? entryRecord["Clip Skip"]) || void 0
-    }
+function buildMetadata(data) {
+  const str = (keyA, keyB) => {
+    const v = data[keyA] ?? data[keyB];
+    return typeof v === "string" ? v : void 0;
   };
-  return Result.ok(metadata);
-}
-function parseFromJson(json) {
-  const prompt = getValue(json, "prompt", "Prompt") ?? "";
-  const negativePrompt = getValue(json, "negative_prompt", "Negative Prompt") ?? "";
-  const modelPath = getValue(
-    json,
-    "use_stable_diffusion_model",
-    "Stable Diffusion model"
-  );
-  const width = getValue(json, "width", "Width") ?? 0;
-  const height = getValue(json, "height", "Height") ?? 0;
-  const metadata = {
+  const num = (keyA, keyB) => {
+    const v = Number(data[keyA] ?? data[keyB]);
+    return v || void 0;
+  };
+  const prompt = (str("prompt", "Prompt") ?? "").trim();
+  const negativePrompt = (str("negative_prompt", "Negative Prompt") ?? "").trim();
+  const modelPath = str("use_stable_diffusion_model", "Stable Diffusion model");
+  return Result.ok({
     software: "easydiffusion",
-    prompt: prompt.trim(),
-    negativePrompt: negativePrompt.trim(),
-    width,
-    height,
+    prompt,
+    negativePrompt,
+    width: num("width", "Width") ?? 0,
+    height: num("height", "Height") ?? 0,
     model: {
       name: extractModelName(modelPath),
-      vae: getValue(json, "use_vae_model", "VAE model")
+      vae: str("use_vae_model", "VAE model")
     },
     sampling: {
-      sampler: getValue(json, "sampler_name", "Sampler"),
-      steps: getValue(json, "num_inference_steps", "Steps"),
-      cfg: getValue(json, "guidance_scale", "Guidance Scale"),
-      seed: getValue(json, "seed", "Seed"),
-      clipSkip: getValue(json, "clip_skip", "Clip Skip")
+      sampler: str("sampler_name", "Sampler"),
+      steps: num("num_inference_steps", "Steps"),
+      cfg: num("guidance_scale", "Guidance Scale"),
+      seed: num("seed", "Seed"),
+      clipSkip: num("clip_skip", "Clip Skip")
     }
-  };
-  return Result.ok(metadata);
+  });
 }
 
 // src/parsers/fooocus.ts
@@ -832,7 +831,13 @@ function parseHfSpace(entries) {
       steps: json.num_inference_steps,
       cfg: json.guidance_scale,
       seed: json.seed
-    })
+    }),
+    hires: json.use_upscaler ? trimObject({
+      upscaler: json.use_upscaler.upscale_method,
+      denoise: json.use_upscaler.upscaler_strength,
+      scale: json.use_upscaler.upscale_by,
+      steps: json.use_upscaler.upscale_steps
+    }) : void 0
   };
   return Result.ok(metadata);
 }
@@ -1294,6 +1299,80 @@ function detectFormat(data) {
   return null;
 }
 
+// src/readers/dimensions.ts
+function readImageDimensions(data, format) {
+  if (format === "png") return readPngDimensions(data);
+  if (format === "jpeg") return readJpegDimensions(data);
+  return readWebpDimensions(data);
+}
+function readPngDimensions(data) {
+  const PNG_SIGNATURE_LENGTH2 = 8;
+  if (data.length < 24) return null;
+  return {
+    width: readUint32BE(data, PNG_SIGNATURE_LENGTH2 + 8),
+    height: readUint32BE(data, PNG_SIGNATURE_LENGTH2 + 12)
+  };
+}
+function readJpegDimensions(data) {
+  let offset = 2;
+  while (offset < data.length - 4) {
+    if (data[offset] !== 255) {
+      offset++;
+      continue;
+    }
+    const marker = data[offset + 1] ?? 0;
+    if (marker === 255) {
+      offset++;
+      continue;
+    }
+    const length = (data[offset + 2] ?? 0) << 8 | (data[offset + 3] ?? 0);
+    if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) {
+      const height = (data[offset + 5] ?? 0) << 8 | (data[offset + 6] ?? 0);
+      const width = (data[offset + 7] ?? 0) << 8 | (data[offset + 8] ?? 0);
+      return { width, height };
+    }
+    offset += 2 + length;
+    if (marker === 218) break;
+  }
+  return null;
+}
+function readWebpDimensions(data) {
+  let offset = 12;
+  while (offset < data.length) {
+    if (offset + 8 > data.length) break;
+    const chunkType = readChunkType(data, offset);
+    const chunkSize = readUint32LE(data, offset + 4);
+    const paddedSize = chunkSize + chunkSize % 2;
+    if (chunkType === "VP8X") {
+      const wMinus1 = readUint24LE(data, offset + 12);
+      const hMinus1 = readUint24LE(data, offset + 15);
+      return { width: wMinus1 + 1, height: hMinus1 + 1 };
+    }
+    if (chunkType === "VP8 ") {
+      const start = offset + 8;
+      const tag = (data[start] ?? 0) | (data[start + 1] ?? 0) << 8 | (data[start + 2] ?? 0) << 16;
+      const keyFrame = !(tag & 1);
+      if (keyFrame) {
+        if (data[start + 3] === 157 && data[start + 4] === 1 && data[start + 5] === 42) {
+          const wRaw = (data[start + 6] ?? 0) | (data[start + 7] ?? 0) << 8;
+          const hRaw = (data[start + 8] ?? 0) | (data[start + 9] ?? 0) << 8;
+          return { width: wRaw & 16383, height: hRaw & 16383 };
+        }
+      }
+    }
+    if (chunkType === "VP8L") {
+      if (data[offset + 8] === 47) {
+        const bits = readUint32LE(data, offset + 9);
+        const width = (bits & 16383) + 1;
+        const height = (bits >> 14 & 16383) + 1;
+        return { width, height };
+      }
+    }
+    offset += 8 + paddedSize;
+  }
+  return null;
+}
+
 // src/utils/exif-constants.ts
 var USER_COMMENT_TAG = 37510;
 var IMAGE_DESCRIPTION_TAG = 270;
@@ -1758,9 +1837,7 @@ function findExifChunk(data) {
 
 // src/utils/convert.ts
 function pngChunksToRecord(chunks) {
-  return Object.freeze(
-    Object.fromEntries(chunks.map((c) => [c.keyword, c.text]))
-  );
+  return Object.fromEntries(chunks.map((c) => [c.keyword, c.text]));
 }
 function segmentsToRecord(segments) {
   const record = {};
@@ -1776,7 +1853,7 @@ function segmentsToRecord(segments) {
     }
     record[keyword] = text;
   }
-  return Object.freeze(record);
+  return record;
 }
 function tryExpandNovelAIWebpFormat(text) {
   const outerParsed = parseJson(text);
@@ -1788,10 +1865,10 @@ function tryExpandNovelAIWebpFormat(text) {
     return null;
   }
   const innerParsed = parseJson(outer.Comment);
-  return Object.freeze({
+  return {
     Software: typeof outer.Software === "string" ? outer.Software : "NovelAI",
     Comment: innerParsed.ok ? JSON.stringify(innerParsed.value) : outer.Comment
-  });
+  };
 }
 function sourceToKeyword(source) {
   switch (source.type) {
@@ -1825,7 +1902,7 @@ function read(input, options) {
   }
   const metadata = parseResult.value;
   if (!options?.strict && (metadata.width === 0 || metadata.height === 0)) {
-    const dims = HELPERS[format].readDimensions(data);
+    const dims = readImageDimensions(data, format);
     if (dims) {
       metadata.width = metadata.width || dims.width;
       metadata.height = metadata.height || dims.height;
@@ -1833,31 +1910,8 @@ function read(input, options) {
   }
   return { status: "success", metadata, raw };
 }
-var HELPERS = {
-  png: {
-    readMetadata: readPngMetadata,
-    readDimensions: readPngDimensions,
-    createRaw: (chunks) => ({ format: "png", chunks })
-  },
-  jpeg: {
-    readMetadata: readJpegMetadata,
-    readDimensions: readJpegDimensions,
-    createRaw: (segments) => ({
-      format: "jpeg",
-      segments
-    })
-  },
-  webp: {
-    readMetadata: readWebpMetadata,
-    readDimensions: readWebpDimensions,
-    createRaw: (segments) => ({
-      format: "webp",
-      segments
-    })
-  }
-};
 function readRawMetadata(data, format) {
-  const result = HELPERS[format].readMetadata(data);
+  const result = format === "png" ? readPngMetadata(data) : format === "jpeg" ? readJpegMetadata(data) : readWebpMetadata(data);
   if (!result.ok) {
     const message = result.error.type === "invalidSignature" ? `Invalid ${format.toUpperCase()} signature` : result.error.message;
     return { status: "invalid", message };
@@ -1866,81 +1920,14 @@ function readRawMetadata(data, format) {
   if (format === "png") {
     return {
       status: "success",
-      raw: HELPERS.png.createRaw(result.value)
+      raw: { format: "png", chunks: result.value }
     };
   }
   return {
     status: "success",
-    raw: HELPERS[format].createRaw(result.value)
+    raw: { format, segments: result.value }
   };
 }
-function readPngDimensions(data) {
-  const PNG_SIGNATURE_LENGTH2 = 8;
-  if (data.length < 24) return null;
-  return {
-    width: readUint32BE(data, PNG_SIGNATURE_LENGTH2 + 8),
-    height: readUint32BE(data, PNG_SIGNATURE_LENGTH2 + 12)
-  };
-}
-function readJpegDimensions(data) {
-  let offset = 2;
-  while (offset < data.length - 4) {
-    if (data[offset] !== 255) {
-      offset++;
-      continue;
-    }
-    const marker = data[offset + 1] ?? 0;
-    if (marker === 255) {
-      offset++;
-      continue;
-    }
-    const length = (data[offset + 2] ?? 0) << 8 | (data[offset + 3] ?? 0);
-    if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) {
-      const height = (data[offset + 5] ?? 0) << 8 | (data[offset + 6] ?? 0);
-      const width = (data[offset + 7] ?? 0) << 8 | (data[offset + 8] ?? 0);
-      return { width, height };
-    }
-    offset += 2 + length;
-    if (marker === 218) break;
-  }
-  return null;
-}
-function readWebpDimensions(data) {
-  let offset = 12;
-  while (offset < data.length) {
-    if (offset + 8 > data.length) break;
-    const chunkType = readChunkType(data, offset);
-    const chunkSize = readUint32LE(data, offset + 4);
-    const paddedSize = chunkSize + chunkSize % 2;
-    if (chunkType === "VP8X") {
-      const wMinus1 = readUint24LE(data, offset + 12);
-      const hMinus1 = readUint24LE(data, offset + 15);
-      return { width: wMinus1 + 1, height: hMinus1 + 1 };
-    }
-    if (chunkType === "VP8 ") {
-      const start = offset + 8;
-      const tag = (data[start] ?? 0) | (data[start + 1] ?? 0) << 8 | (data[start + 2] ?? 0) << 16;
-      const keyFrame = !(tag & 1);
-      if (keyFrame) {
-        if (data[start + 3] === 157 && data[start + 4] === 1 && data[start + 5] === 42) {
-          const wRaw = (data[start + 6] ?? 0) | (data[start + 7] ?? 0) << 8;
-          const hRaw = (data[start + 8] ?? 0) | (data[start + 9] ?? 0) << 8;
-          return { width: wRaw & 16383, height: hRaw & 16383 };
-        }
-      }
-    }
-    if (chunkType === "VP8L") {
-      if (data[offset + 8] === 47) {
-        const bits = readUint32LE(data, offset + 9);
-        const width = (bits & 16383) + 1;
-        const height = (bits >> 14 & 16383) + 1;
-        return { width, height };
-      }
-    }
-    offset += 8 + paddedSize;
-  }
-  return null;
-}
 
 // src/converters/utils.ts
 var createTextChunk = (keyword, text) => text !== void 0 ? [{ type: "tEXt", keyword, text }] : [];
@@ -1993,6 +1980,12 @@ function createEncodedChunk(keyword, text, strategy) {
     }
   }
 }
+function createEncodedChunks(entries, encodingMap) {
+  return entries.flatMap(([keyword, text]) => {
+    const strategy = encodingMap[keyword] ?? encodingMap.default;
+    return createEncodedChunk(keyword, text, strategy);
+  });
+}
 
 // src/converters/a1111.ts
 function convertA1111PngToSegments(chunks) {
@@ -2049,7 +2042,7 @@ function convertCivitaiSegmentsToPng(segments) {
   if (!isJson) {
     return convertA1111SegmentsToPng(segments);
   }
-  return createEncodedChunk("prompt", userComment.data, "text-utf8-raw");
+  return createEncodedChunk("prompt", userComment.data, "text-unicode-escape");
 }
 
 // src/converters/base-json.ts
@@ -2109,7 +2102,7 @@ var tryParseExtendedFormat = (segments) => {
   ];
 };
 var tryParseSaveImagePlusFormat = (segments) => {
-  const chunks = convertKvSegmentsToPng(segments, "text-utf8-raw");
+  const chunks = convertKvSegmentsToPng(segments, "text-unicode-escape");
   return chunks.length > 0 ? chunks : null;
 };
 function convertComfyUISegmentsToPng(segments) {
@@ -2249,6 +2242,39 @@ function createSegmentsToPng(keyword, encodingStrategy) {
   };
 }
 
+// src/converters/stability-matrix.ts
+var STABILITY_MATRIX_ENCODING = {
+  parameters: "text-utf8-raw",
+  default: "text-unicode-escape"
+};
+function convertStabilityMatrixPngToSegments(chunks) {
+  const data = {};
+  for (const chunk of chunks) {
+    const parsed = parseJson(chunk.text);
+    data[chunk.keyword] = parsed.ok ? parsed.value : chunk.text;
+  }
+  return [
+    {
+      source: { type: "exifUserComment" },
+      data: JSON.stringify(data)
+    }
+  ];
+}
+function convertStabilityMatrixSegmentsToPng(segments) {
+  const userComment = findSegment(segments, "exifUserComment");
+  if (!userComment) return [];
+  const parsed = parseJson(userComment.data);
+  if (!parsed.ok || parsed.type !== "object") return [];
+  const value = parsed.value;
+  const entries = Object.entries(value).map(
+    ([key, val]) => {
+      const text = stringify(val);
+      return [key, text !== void 0 ? unescapeUnicode(text) : void 0];
+    }
+  );
+  return createEncodedChunks(entries, STABILITY_MATRIX_ENCODING);
+}
+
 // src/converters/swarmui.ts
 function convertSwarmUIPngToSegments(chunks) {
   const parametersChunk = chunks.find((c) => c.keyword === "parameters");
@@ -2283,6 +2309,39 @@ function convertSwarmUISegmentsToPng(segments) {
   return chunks;
 }
 
+// src/converters/tensorart.ts
+var TENSORART_ENCODING = {
+  generation_data: "text-utf8-raw",
+  default: "text-unicode-escape"
+};
+function convertTensorArtPngToSegments(chunks) {
+  const data = {};
+  for (const chunk of chunks) {
+    const parsed = parseJson(chunk.text);
+    data[chunk.keyword] = parsed.ok ? parsed.value : chunk.text;
+  }
+  return [
+    {
+      source: { type: "exifUserComment" },
+      data: JSON.stringify(data)
+    }
+  ];
+}
+function convertTensorArtSegmentsToPng(segments) {
+  const userComment = findSegment(segments, "exifUserComment");
+  if (!userComment) return [];
+  const parsed = parseJson(userComment.data);
+  if (!parsed.ok || parsed.type !== "object") return [];
+  const value = parsed.value;
+  const entries = Object.entries(value).map(
+    ([key, val]) => {
+      const text = stringify(val);
+      return [key, text !== void 0 ? unescapeUnicode(text) : void 0];
+    }
+  );
+  return createEncodedChunks(entries, TENSORART_ENCODING);
+}
+
 // src/converters/index.ts
 function convertMetadata(parseResult, targetFormat) {
   if (parseResult.status === "empty") {
@@ -2370,6 +2429,14 @@ var convertCivitai = createFormatConverter(
   convertCivitaiPngToSegments,
   convertCivitaiSegmentsToPng
 );
+var convertStabilityMatrix = createFormatConverter(
+  convertStabilityMatrixPngToSegments,
+  convertStabilityMatrixSegmentsToPng
+);
+var convertTensorArt = createFormatConverter(
+  convertTensorArtPngToSegments,
+  convertTensorArtSegmentsToPng
+);
 var softwareConverters = {
   // NovelAI
   novelai: convertNovelai,
@@ -2380,10 +2447,12 @@ var softwareConverters = {
   "forge-neo": convertA1111,
   // CivitAI Orchestration format
   civitai: convertCivitai,
-  // ComfyUI-format (comfyui, tensorart, stability-matrix)
+  // ComfyUI-format
   comfyui: convertComfyUI,
-  tensorart: convertComfyUI,
-  "stability-matrix": convertComfyUI,
+  // TensorArt (per-chunk encoding: generation_data uses raw UTF-8)
+  tensorart: convertTensorArt,
+  // Stability Matrix (per-chunk encoding: parameters uses raw UTF-8)
+  "stability-matrix": convertStabilityMatrix,
   // Easy Diffusion
   easydiffusion: convertEasyDiffusion,
   // Fooocus variants
@@ -2931,7 +3000,7 @@ function write(input, metadata) {
     return { ok: false, error: { type: "unsupportedFormat" } };
   }
   if (metadata.status === "empty") {
-    const result = HELPERS2[targetFormat].writeEmpty(data, []);
+    const result = HELPERS[targetFormat].writeEmpty(data, []);
     if (!result.ok) {
       return {
         ok: false,
@@ -2951,7 +3020,7 @@ function write(input, metadata) {
     if (sourceFormat === targetFormat) {
       return writeRaw(data, targetFormat, metadata.raw);
     }
-    const result = HELPERS2[targetFormat].writeEmpty(data, []);
+    const result = HELPERS[targetFormat].writeEmpty(data, []);
     if (!result.ok) {
       return {
         ok: false,
@@ -3015,7 +3084,7 @@ function writeRaw(data, targetFormat, raw) {
     }
   };
 }
-var HELPERS2 = {
+var HELPERS = {
   png: {
     writeEmpty: writePngMetadata
   },