layoutbridge-light 0.0.0-stage → 1.0.0

package/indesign/commands/25-export.js

@@ -0,0 +1,448 @@
+/* Bereich A – Export und Preflight. */
+
+/* ------------------------------------------------------------ export_pdf */
+
+/*
+ * Vorgaben ohne Angabe im Aufruf: Hauptpreset = lokalisiertes "High Quality
+ * Print", kein zweiter Durchgang. Hauswerte (Preset-Namen, Groessenschwelle)
+ * kommen aus der Serverkonfiguration und stehen dann schon in den args
+ * (E-54, A-6.3).
+ */
+/* Lokalisierte Namen der mitgelieferten Vorgabe "High Quality Print". */
+var IDC_HQ_PRESET_PATTERN = /high quality print|qualitativ hochwertiger druck|hochwertiger druck/i;
+
+function idcPdfPresetByName(name) {
+  var preset;
+  if (typeof name !== 'string' || name.length === 0) { return null; }
+  try {
+    preset = app.pdfExportPresets.itemByName(name);
+    if (preset && preset.isValid === true) { return preset; }
+  } catch (e) { /* nicht vorhanden */ }
+  return null;
+}
+
+function idcPdfPresetNames() {
+  var names = [];
+  var i;
+  try {
+    for (i = 0; i < app.pdfExportPresets.length; i++) {
+      names.push(String(app.pdfExportPresets.item(i).name));
+    }
+  } catch (e) { /* leer */ }
+  return names;
+}
+
+function idcHighQualityPreset() {
+  var i, preset;
+  try {
+    for (i = 0; i < app.pdfExportPresets.length; i++) {
+      preset = app.pdfExportPresets.item(i);
+      if (IDC_HQ_PRESET_PATTERN.test(String(preset.name))) { return preset; }
+    }
+  } catch (e) { /* keine */ }
+  return null;
+}
+
+/* Seitenindex zu einem Namen aus einem Seitenbereich; "+3" = dritte Seite absolut. */
+function idcPageIndexByName(doc, text) {
+  var name = text;
+  var i, n;
+  if (name.charAt(0) === '+') {
+    n = Number(name.substr(1));
+    if (isNaN(n) || n < 1 || n > doc.pages.length) { return -1; }
+    return n - 1;
+  }
+  for (i = 0; i < doc.pages.length; i++) {
+    if (String(doc.pages.item(i).name) === name) { return i; }
+  }
+  return -1;
+}
+
+function idcTrim(text) {
+  return String(text).replace(/^\s+/, '').replace(/\s+$/, '');
+}
+
+/*
+ * Seitenbereich wie in InDesigns Exportdialog ("6-8", "1, 3-5", "+2-+4")
+ * gegen die angezeigten Seitennamen aufloesen. Liefert die Zahl der Seiten.
+ */
+function idcCountPagesInRange(doc, rangeText) {
+  var parts = String(rangeText).split(',');
+  var count = 0;
+  var p, part, single, from, to, cut, left, right, found;
+
+  for (p = 0; p < parts.length; p++) {
+    part = idcTrim(parts[p]);
+    if (part === '') { continue; }
+    single = idcPageIndexByName(doc, part);
+    if (single >= 0) { count += 1; continue; }
+
+    found = false;
+    for (cut = 1; cut < part.length; cut++) {
+      if (part.charAt(cut) !== '-') { continue; }
+      left = idcTrim(part.substr(0, cut));
+      right = idcTrim(part.substr(cut + 1));
+      from = idcPageIndexByName(doc, left);
+      to = idcPageIndexByName(doc, right);
+      if (from >= 0 && to >= 0) { found = true; break; }
+    }
+    if (!found) {
+      IDC.fail('invalid_argument',
+        'page_range "' + rangeText + '": "' + part + '" names no page of this document (page names are the printed page numbers; "+3" addresses the third page).',
+        { page_range: String(rangeText), part: part });
+    }
+    if (to < from) {
+      IDC.fail('invalid_argument', 'page_range "' + rangeText + '": "' + part + '" runs backwards.',
+        { page_range: String(rangeText), part: part });
+    }
+    count += to - from + 1;
+  }
+  if (count === 0) {
+    IDC.fail('invalid_argument', 'page_range "' + rangeText + '" selects no page.', { page_range: String(rangeText) });
+  }
+  return count;
+}
+
+/*
+ * Dokumentanschnitt nur fuer einen Aufruf (A-43 Nr. 1, KDP-Befund 1): Die
+ * mitgelieferten Vorgaben ([PDF/X-1a:2001] u. a.) exportieren ohne
+ * Anschnitt, und sie lassen sich nicht aendern (InDesign 21.6: "Die Datei kann
+ * nicht erstellt werden"). Deshalb wird die Vorgabe dupliziert
+ * (PDFExportPreset.duplicate(), Adobe-DOM), am Duplikat
+ * useDocumentBleedWithPDF gesetzt, damit exportiert und das Duplikat danach
+ * entfernt. Ohne Vorgabe (aktuelle Exporteinstellungen) wird
+ * app.pdfExportPreferences.useDocumentBleedWithPDF gesetzt und zurueckgestellt.
+ * bleed null = wie die Vorgabe.
+ */
+function idcExportPdfOnce(doc, file, preset, rangeText, bleed) {
+  var prefs = app.pdfExportPreferences;
+  var prevRange = null;
+  var prevView = null;
+  var prevBleed = null;
+  var rangeSet = false;
+  var viewSet = false;
+  var bleedSet = false;
+  var temp = null;
+  var used = preset;
+
+  try {
+    if (bleed !== null && preset !== null) {
+      try {
+        temp = preset.duplicate();
+        temp.useDocumentBleedWithPDF = bleed;
+        used = temp;
+      } catch (eDup) {
+        IDC.fail('script_error', 'Could not prepare the preset with use_document_bleed: ' + String(eDup.message ? eDup.message : eDup),
+          { preset: String(preset.name) });
+      }
+    } else if (bleed !== null) {
+      prevBleed = prefs.useDocumentBleedWithPDF;
+      prefs.useDocumentBleedWithPDF = bleed;
+      bleedSet = true;
+    }
+    try {
+      prevView = prefs.viewPDF;
+      prefs.viewPDF = false;
+      viewSet = true;
+    } catch (e0) { /* nicht jede Fassung kennt viewPDF */ }
+    prevRange = prefs.pageRange;
+    prefs.pageRange = rangeText === null ? PageRange.ALL_PAGES : rangeText;
+    rangeSet = true;
+    if (used !== null) { doc.exportFile(ExportFormat.PDF_TYPE, file, false, used); }
+    else { doc.exportFile(ExportFormat.PDF_TYPE, file, false); }
+  } catch (e) {
+    if (e && e.isIdcError) { throw e; }
+    IDC.fail('io_error', 'PDF export failed: ' + String(e.message ? e.message : e),
+      { path: IDC.fsPath(file), preset: preset === null ? null : String(preset.name) });
+  } finally {
+    if (rangeSet) { try { prefs.pageRange = prevRange; } catch (e1) { /* egal */ } }
+    if (viewSet) { try { prefs.viewPDF = prevView; } catch (e2) { /* egal */ } }
+    if (bleedSet) { try { prefs.useDocumentBleedWithPDF = prevBleed; } catch (e3) { /* egal */ } }
+    if (temp !== null) { try { temp.remove(); } catch (e4) { /* bleibt als Kopie stehen */ } }
+  }
+  /*
+   * Frisches File-Objekt: ExtendScript haelt length im Objekt fest, nach dem
+   * zweiten Export stand sonst noch die Groesse des ersten drin (am lebenden
+   * InDesign 21.5 am 04.09.2026 gesehen).
+   */
+  return IDC.fileSize(IDC.fileFor(IDC.fsPath(file)));
+}
+
+IDC.register('export_pdf', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var file, rangeText, exportedCount, preset, presetUsed, bytes, fallbackName, threshold, fallback;
+
+    if (typeof args.path !== 'string' || args.path.length === 0) {
+      IDC.fail('invalid_argument', 'path is required (the target file path, not output_path).', null);
+    }
+    file = IDC.fileFor(args.path);
+    if (!IDC.fileParentExists(file)) {
+      IDC.fail('io_error', 'The folder for the target path does not exist: ' + args.path, { path: args.path });
+    }
+
+    rangeText = null;
+    if (args.page_range !== undefined && args.page_range !== null && idcTrim(args.page_range) !== ''
+      && idcTrim(args.page_range).toLowerCase() !== 'all') {
+      rangeText = idcTrim(args.page_range);
+      exportedCount = idcCountPagesInRange(doc, rangeText);
+    } else {
+      exportedCount = doc.pages.length;
+    }
+
+    /* Preset-Kette: Wunschpreset, sonst High Quality Print, sonst aktuelle Vorgaben. */
+    var wanted = null;
+    if (args.preset !== undefined && args.preset !== null && String(args.preset) !== '') {
+      wanted = String(args.preset);
+    }
+    preset = wanted === null ? null : idcPdfPresetByName(wanted);
+    presetUsed = wanted;
+    if (preset === null) {
+      preset = idcHighQualityPreset();
+      if (preset !== null) {
+        presetUsed = String(preset.name);
+        if (wanted !== null) {
+          ctx.warn('PDF preset "' + wanted + '" not found; used "' + presetUsed + '" instead. Available: ' + idcPdfPresetNames().join(', '));
+        }
+      } else {
+        presetUsed = '[current export preferences]';
+        if (wanted !== null) {
+          ctx.warn('PDF preset "' + wanted + '" not found and no High Quality Print preset either; exported with the current export preferences. Available: ' + idcPdfPresetNames().join(', '));
+        } else {
+          ctx.warn('No High Quality Print preset found; exported with the current export preferences. Available: ' + idcPdfPresetNames().join(', '));
+        }
+      }
+    }
+
+    var bleed = null;
+    if (args.use_document_bleed !== undefined && args.use_document_bleed !== null) {
+      if (args.use_document_bleed !== true && args.use_document_bleed !== false) {
+        IDC.fail('invalid_argument', 'use_document_bleed must be true or false.', { use_document_bleed: args.use_document_bleed });
+      }
+      bleed = args.use_document_bleed;
+    }
+    var docBleed = idcDocumentBleedMm(doc);
+    if (bleed === true && docBleed !== null && docBleed.top === 0 && docBleed.bottom === 0 && docBleed.inside_or_left === 0 && docBleed.outside_or_right === 0) {
+      ctx.warn('use_document_bleed is true, but the document bleed (Anschnitt) is 0 mm on every edge – set_document_bleed first.');
+    }
+
+    bytes = idcExportPdfOnce(doc, file, preset, rangeText, bleed);
+
+    fallbackName = args.fallback_preset === undefined || args.fallback_preset === null
+      ? '' : String(args.fallback_preset);
+    threshold = args.fallback_over_bytes === undefined || args.fallback_over_bytes === null
+      ? 0 : Number(args.fallback_over_bytes);
+
+    if (fallbackName !== '' && threshold > 0 && bytes !== null && bytes > threshold) {
+      fallback = idcPdfPresetByName(fallbackName);
+      if (fallback === null) {
+        ctx.warn('PDF is ' + bytes + ' bytes (over ' + threshold + '), but fallback preset "' + fallbackName + '" was not found; first export kept.');
+      } else {
+        ctx.warn('PDF was ' + bytes + ' bytes (over ' + threshold + '); exported again with "' + fallbackName + '". A spread preset turns single pages into spreads (Doppelseiten) – check exported_page_count.');
+        bytes = idcExportPdfOnce(doc, file, fallback, rangeText, bleed);
+        preset = fallback;
+        presetUsed = fallbackName;
+        if (bytes !== null && bytes > threshold) {
+          ctx.warn('Still ' + bytes + ' bytes after the fallback export.');
+        }
+      }
+    }
+
+    ctx.changes = { exported_files: [IDC.fsPath(file)] };
+
+    return {
+      path: IDC.fsPath(file),
+      page_count: exportedCount,
+      exported_page_count: exportedCount,
+      document_page_count: doc.pages.length,
+      bytes: bytes,
+      preset_used: presetUsed,
+      page_range_used: rangeText === null ? 'all' : rangeText,
+      document_bleed_used: idcBleedInEffect(preset, bleed),
+      document_bleed_mm: docBleed
+    };
+  });
+
+/* Anschnitt des Dokuments in mm (innen/links, aussen/rechts wie InDesign). */
+function idcDocumentBleedMm(doc) {
+  var prefs = doc.documentPreferences;
+  try {
+    return {
+      top: IDC.round(Number(prefs.documentBleedTopOffset)),
+      bottom: IDC.round(Number(prefs.documentBleedBottomOffset)),
+      inside_or_left: IDC.round(Number(prefs.documentBleedInsideOrLeftOffset)),
+      outside_or_right: IDC.round(Number(prefs.documentBleedOutsideOrRightOffset))
+    };
+  } catch (e) { return null; }
+}
+
+/* Hat der Export den Dokumentanschnitt benutzt? Aufrufwert, sonst die Vorgabe; null = unbekannt. */
+function idcBleedInEffect(preset, bleed) {
+  if (bleed !== null) { return bleed; }
+  try {
+    if (preset !== null) { return preset.useDocumentBleedWithPDF === true; }
+    return app.pdfExportPreferences.useDocumentBleedWithPDF === true;
+  } catch (e) { return null; }
+}
+
+/* ---------------------------------------------------- preflight_document */
+
+function idcPreflightProfileNames() {
+  var names = [];
+  var i;
+  try {
+    for (i = 0; i < app.preflightProfiles.length; i++) {
+      names.push(String(app.preflightProfiles.item(i).name));
+    }
+  } catch (e) { /* leer */ }
+  return names;
+}
+
+function idcText(value) {
+  if (value === null || value === undefined) { return null; }
+  return String(value);
+}
+
+/*
+ * aggregatedResults ist [Dokumentname, Profilname, Eintraege[]]. Die Form
+ * eines Eintrags ist in Adobes Dokumentation nur als "Array of Strings or
+ * Numbers or Arrays" beschrieben; deshalb werden beide beobachtete Formen
+ * gelesen: [Kategorie, Beschreibung, Seite, Objekt] und
+ * [Kategorie, Beschreibung, [[Seite, Objekt], ...]].
+ */
+function idcParsePreflightFindings(raw) {
+  var out = [];
+  var list, i, entry, category, description, rest, j, sub;
+
+  if (!IDC.isArray(raw)) { return out; }
+  list = (raw.length >= 3 && IDC.isArray(raw[2])) ? raw[2] : raw;
+
+  for (i = 0; i < list.length; i++) {
+    entry = list[i];
+    if (!IDC.isArray(entry)) { continue; }
+    category = idcText(entry[0]);
+    description = idcText(entry[1]);
+    rest = entry.length > 2 ? entry[2] : undefined;
+
+    if (IDC.isArray(rest)) {
+      if (rest.length === 0) {
+        out.push({ category: category, description: description, page_name: null, item: null });
+      }
+      for (j = 0; j < rest.length; j++) {
+        sub = rest[j];
+        if (IDC.isArray(sub)) {
+          out.push({
+            category: category,
+            description: description,
+            page_name: sub.length > 0 ? idcText(sub[0]) : null,
+            item: sub.length > 1 ? idcText(sub[1]) : null
+          });
+        } else {
+          out.push({
+            category: category,
+            description: description,
+            page_name: idcText(sub),
+            item: entry.length > 3 ? idcText(entry[3]) : null
+          });
+        }
+      }
+    } else {
+      out.push({
+        category: category,
+        description: description,
+        page_name: rest === undefined ? null : idcText(rest),
+        item: entry.length > 3 ? idcText(entry[3]) : null
+      });
+    }
+  }
+  return out;
+}
+
+IDC.register('preflight_document', { needs_document: true, read_only: true, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var profiles = idcPreflightProfileNames();
+    var maxFindings, profile, working, process, waited, summary, raw, findings, capped;
+
+    if (args.list_profiles_only === true) {
+      return { profiles: profiles, profile_count: profiles.length };
+    }
+
+    maxFindings = args.max_findings === undefined || args.max_findings === null ? 100 : Number(args.max_findings);
+    if (isNaN(maxFindings) || maxFindings < 1 || maxFindings > 500) {
+      IDC.fail('invalid_argument', 'max_findings must be between 1 and 500.', { max_findings: args.max_findings });
+    }
+
+    profile = null;
+    if (args.profile_name !== undefined && args.profile_name !== null && String(args.profile_name) !== '') {
+      try {
+        profile = app.preflightProfiles.itemByName(String(args.profile_name));
+        if (!profile || profile.isValid !== true) { profile = null; }
+      } catch (e) { profile = null; }
+      if (profile === null) {
+        IDC.fail('not_found', 'Preflight profile "' + args.profile_name + '" not found.',
+          { profile_name: String(args.profile_name), available: profiles });
+      }
+    } else {
+      /*
+       * Das Arbeitsprofil des Dokuments kann ein ungueltiges Objekt sein –
+       * oder laut Adobes DOM auch nur ein Name (String). Beides abfangen.
+       */
+      try {
+        working = doc.preflightOptions.preflightWorkingProfile;
+        if (typeof working === 'string' && working !== '') {
+          working = app.preflightProfiles.itemByName(working);
+        }
+        if (working && working.isValid === true) { profile = working; }
+      } catch (e2) { profile = null; }
+      if (profile === null) {
+        if (app.preflightProfiles.length === 0) {
+          IDC.fail('invalid_state', 'InDesign has no preflight profile at all.', null);
+        }
+        profile = app.preflightProfiles.item(0);
+        ctx.warn('The document has no valid working profile; used the first available profile "' + String(profile.name) + '".');
+      }
+    }
+
+    try {
+      process = app.preflightProcesses.add(doc, profile);
+    } catch (e3) {
+      IDC.fail('script_error', 'Could not start the preflight process: ' + String(e3.message ? e3.message : e3), null);
+    }
+
+    try {
+      /*
+       * waitForProcess(sekunden) blockiert, bis der Prozess fertig ist oder
+       * die Zeit um ist. Adobes Dokumentation und alle bekannten Praxisskripte
+       * rufen es genau einmal auf und werten den Rueckgabewert nicht aus –
+       * am lebenden InDesign 21.5 kam er sofort und ohne true zurueck, eine
+       * Warteschleife darauf drehte leer (04.09.2026). Deshalb: einmal warten,
+       * dann lesen.
+       */
+      var startedAt = new Date().getTime();
+      try { process.waitForProcess(600); } catch (eWait) { /* dann eben ohne Warten lesen */ }
+      waited = Math.round((new Date().getTime() - startedAt) / 1000);
+      if (waited >= 600) {
+        IDC.fail('timeout', 'Preflight did not finish within ' + waited + ' seconds.', null);
+      }
+      summary = idcTrim(String(process.processResults));
+      raw = process.aggregatedResults;
+      findings = idcParsePreflightFindings(raw);
+    } finally {
+      try { process.remove(); } catch (e4) { /* Prozess bleibt dann stehen, stoert nicht */ }
+    }
+
+    capped = findings.length > maxFindings ? findings.slice(0, maxFindings) : findings;
+    if (findings.length > maxFindings) {
+      ctx.warn(findings.length + ' findings, only the first ' + maxFindings + ' returned (max_findings).');
+    }
+
+    return {
+      profile_used: String(profile.name),
+      summary: summary,
+      error_count: findings.length,
+      findings: capped
+    };
+  });

package/indesign/commands/26-export-image.js

@@ -0,0 +1,202 @@
+/* Wunschliste J Nr. 5 (Sitzung 7) – Seiten als Bild: export_page_image. */
+
+function idcImageQualityFor(format, name) {
+  var table = format === 'jpeg' ? (typeof JPEGOptionsQuality === 'undefined' ? null : JPEGOptionsQuality)
+    : (typeof PNGQualityEnum === 'undefined' ? null : PNGQualityEnum);
+  if (table === null) { return null; }
+  if (name === 'low') { return table.LOW; }
+  if (name === 'medium') { return table.MEDIUM; }
+  if (name === 'high') { return table.HIGH; }
+  return table.MAXIMUM;
+}
+
+function idcImageColorSpaceFor(format, name) {
+  var table = format === 'jpeg' ? (typeof JpegColorSpaceEnum === 'undefined' ? null : JpegColorSpaceEnum)
+    : (typeof PNGColorSpaceEnum === 'undefined' ? null : PNGColorSpaceEnum);
+  if (table === null) { return null; }
+  if (name === 'gray') { return table.GRAY; }
+  if (name === 'cmyk') { return table.CMYK; }
+  return table.RGB;
+}
+
+/*
+ * Seiten aus page_ids oder page_range: [{ page, name }] in Dokumentreihenfolge.
+ * Hoechstens 48 Seiten (eine Bilddatei je Seite); maxPages 0 = ohne Grenze
+ * (check_typography, A-69 Teil 2: dort liest page_range nur, schreibt nichts).
+ */
+function idcPagesForExport(doc, args, maxPages) {
+  var out = [];
+  var i, j, found, parts, part, single, cut, left, right, from, to;
+  var wanted = {};
+  if (args.page_ids !== undefined && args.page_ids !== null) {
+    if (!IDC.isArray(args.page_ids) || args.page_ids.length === 0) {
+      IDC.fail('invalid_argument', 'page_ids must be a non-empty list of page ids.', { page_ids: args.page_ids });
+    }
+    for (i = 0; i < args.page_ids.length; i++) {
+      found = IDC.pageById(doc, args.page_ids[i]);
+      if (found === null || found.is_parent_page) {
+        IDC.fail('not_found', 'No document page with page_id ' + args.page_ids[i] + ' (master pages cannot be exported as images).', { page_id: args.page_ids[i] });
+      }
+      wanted[Number(found.page.id)] = true;
+    }
+  } else if (args.page_range !== undefined && args.page_range !== null) {
+    parts = String(args.page_range).split(',');
+    for (i = 0; i < parts.length; i++) {
+      part = idcTrim(parts[i]);
+      if (part === '') { continue; }
+      single = idcPageIndexByName(doc, part);
+      if (single >= 0) { wanted[Number(doc.pages.item(single).id)] = true; continue; }
+      from = -1; to = -1;
+      for (cut = 1; cut < part.length; cut++) {
+        if (part.charAt(cut) !== '-') { continue; }
+        left = idcTrim(part.substr(0, cut));
+        right = idcTrim(part.substr(cut + 1));
+        from = idcPageIndexByName(doc, left);
+        to = idcPageIndexByName(doc, right);
+        if (from >= 0 && to >= 0) { break; }
+        from = -1; to = -1;
+      }
+      if (from < 0 || to < 0) {
+        IDC.fail('invalid_argument', 'page_range "' + args.page_range + '": "' + part + '" names no page of this document (page names are the printed page numbers; "+3" addresses the third page).',
+          { page_range: String(args.page_range), part: part });
+      }
+      if (to < from) {
+        IDC.fail('invalid_argument', 'page_range "' + args.page_range + '": "' + part + '" runs backwards.', { page_range: String(args.page_range), part: part });
+      }
+      for (j = from; j <= to; j++) { wanted[Number(doc.pages.item(j).id)] = true; }
+    }
+  } else {
+    IDC.fail('invalid_argument', 'Pass page_ids or page_range.', null);
+  }
+  for (i = 0; i < doc.pages.length; i++) {
+    if (wanted[Number(doc.pages.item(i).id)]) { out.push({ page: doc.pages.item(i), name: String(doc.pages.item(i).name) }); }
+  }
+  if (out.length === 0) { IDC.fail('invalid_argument', 'No page selected.', null); }
+  if (maxPages === undefined || maxPages === null) { maxPages = 48; }
+  if (maxPages > 0 && out.length > maxPages) { IDC.fail('invalid_argument', 'At most ' + maxPages + ' pages per call.', { count: out.length }); }
+  return out;
+}
+
+/* Dateiname mit Seitenname vor der Endung: Seite.png + "8" -> Seite_8.png. */
+function idcPageFileName(path, pageName, single) {
+  var dot = path.lastIndexOf('.');
+  var slash = Math.max(path.lastIndexOf('/'), path.lastIndexOf('\\'));
+  var safe = String(pageName).replace(/[^A-Za-z0-9_.+-]/g, '_');
+  if (single) { return path; }
+  if (dot > slash) { return path.substr(0, dot) + '_' + safe + path.substr(dot); }
+  return path + '_' + safe;
+}
+
+IDC.register('export_page_image', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var format = args.format === undefined || args.format === null ? 'png' : args.format;
+    var dpi = args.dpi === undefined || args.dpi === null ? 150 : args.dpi;
+    var quality = args.quality === undefined || args.quality === null ? 'high' : args.quality;
+    var colorSpace = args.color_space === undefined || args.color_space === null ? 'rgb' : args.color_space;
+    var transparent = args.transparent_background === true;
+    var useBleed = args.use_bleed === true;
+    var antiAlias = args.anti_alias !== false;
+    var path = args.path;
+    var pages, prefs, saved = {}, keys, k, file, files = [], i, target, sizeAfter, exportFormat, ext, prevExportFormatOk;
+
+    if (typeof path !== 'string' || path === '') {
+      IDC.fail('invalid_argument', 'path is required: the target file (for several pages the page name is inserted before the extension).', null);
+    }
+    if (format !== 'png' && format !== 'jpeg') {
+      IDC.fail('invalid_argument', 'format must be png or jpeg.', { format: format });
+    }
+    if (typeof dpi !== 'number' || !isFinite(dpi) || dpi < 36 || dpi > 600) {
+      IDC.fail('invalid_argument', 'dpi must be between 36 and 600.', { dpi: dpi });
+    }
+    if (quality !== 'low' && quality !== 'medium' && quality !== 'high' && quality !== 'maximum') {
+      IDC.fail('invalid_argument', 'quality must be low, medium, high or maximum.', { quality: quality });
+    }
+    if (colorSpace !== 'rgb' && colorSpace !== 'gray' && !(colorSpace === 'cmyk' && format === 'jpeg')) {
+      IDC.fail('invalid_argument', 'color_space must be rgb or gray (jpeg also cmyk).', { color_space: colorSpace, format: format });
+    }
+    ext = format === 'png' ? '.png' : '.jpg';
+    if (!(new RegExp('\\.(' + (format === 'png' ? 'png' : 'jpe?g') + ')$', 'i')).test(path)) {
+      ctx.warn('path does not end in ' + ext + '; InDesign writes ' + format.toUpperCase() + ' data regardless.');
+    }
+    pages = idcPagesForExport(doc, args);
+    file = IDC.fileFor(path);
+    if (!IDC.fileParentExists(file)) {
+      IDC.fail('io_error', 'The folder for ' + path + ' does not exist.', { path: path });
+    }
+
+    prefs = format === 'png' ? app.pngExportPreferences : app.jpegExportPreferences;
+    if (prefs === undefined || prefs === null) {
+      IDC.fail('invalid_state', 'This InDesign runtime has no ' + format.toUpperCase() + ' export preferences.', null);
+    }
+    exportFormat = format === 'png' ? ExportFormat.PNG_FORMAT : ExportFormat.JPG;
+
+    /* Vorgaben merken, setzen, am Ende zurueckstellen. */
+    keys = format === 'png'
+      ? ['exportResolution', 'pngQuality', 'pngColorSpace', 'transparentBackground', 'antiAlias', 'useDocumentBleeds', 'pngExportRange', 'pageString', 'exportingSpread', 'simulateOverprint']
+      : ['exportResolution', 'jpegQuality', 'jpegColorSpace', 'antiAlias', 'useDocumentBleeds', 'jpegExportRange', 'pageString', 'exportingSpread', 'simulateOverprint', 'jpegRenderingStyle'];
+    for (k = 0; k < keys.length; k++) {
+      try { saved[keys[k]] = prefs[keys[k]]; } catch (e0) { /* Eigenschaft fehlt */ }
+    }
+    var setPref = function (key, value) {
+      if (value === null || value === undefined) { return; }
+      try { prefs[key] = value; } catch (e1) { ctx.warn('Could not set export preference ' + key + ': ' + String(e1.message ? e1.message : e1)); }
+    };
+    try {
+      setPref('exportResolution', dpi);
+      setPref('antiAlias', antiAlias);
+      setPref('useDocumentBleeds', useBleed);
+      setPref('simulateOverprint', false);
+      setPref('exportingSpread', false);
+      if (format === 'png') {
+        setPref('pngQuality', idcImageQualityFor('png', quality));
+        setPref('pngColorSpace', idcImageColorSpaceFor('png', colorSpace));
+        setPref('transparentBackground', transparent);
+        if (typeof ExportRangeOrAllPages !== 'undefined') { setPref('pngExportRange', ExportRangeOrAllPages.EXPORT_RANGE); }
+      } else {
+        setPref('jpegQuality', idcImageQualityFor('jpeg', quality));
+        setPref('jpegColorSpace', idcImageColorSpaceFor('jpeg', colorSpace));
+        if (typeof JPEGOptionsFormat !== 'undefined') { setPref('jpegRenderingStyle', JPEGOptionsFormat.BASELINE_ENCODING); }
+        if (typeof ExportRangeOrAllPages !== 'undefined') { setPref('jpegExportRange', ExportRangeOrAllPages.EXPORT_RANGE); }
+      }
+
+      for (i = 0; i < pages.length; i++) {
+        target = idcPageFileName(path, pages[i].name, pages.length === 1);
+        setPref('pageString', pages[i].name);
+        try {
+          doc.exportFile(exportFormat, IDC.fileFor(target), false);
+        } catch (e2) {
+          IDC.fail('io_error', 'Image export of page ' + pages[i].name + ' failed: ' + String(e2.message ? e2.message : e2) +
+            (files.length > 0 ? ' (' + files.length + ' page(s) exported before)' : ''), { path: target, page_name: pages[i].name, exported: files });
+        }
+        sizeAfter = IDC.fileSize(IDC.fileFor(target));
+        if (sizeAfter === null || sizeAfter === 0) {
+          /* InDesign haengt bei Bedarf selbst den Seitennamen an – dann dort nachsehen. */
+          var alt = idcPageFileName(path, pages[i].name, false);
+          var alt2 = alt.replace('_' + String(pages[i].name).replace(/[^A-Za-z0-9_.+-]/g, '_'), String(pages[i].name));
+          if (IDC.fileSize(IDC.fileFor(alt)) > 0) { target = alt; sizeAfter = IDC.fileSize(IDC.fileFor(alt)); }
+          else if (IDC.fileSize(IDC.fileFor(alt2)) > 0) { target = alt2; sizeAfter = IDC.fileSize(IDC.fileFor(alt2)); }
+          else { ctx.warn('Page ' + pages[i].name + ': no file found at ' + target + ' after the export.'); }
+        }
+        files.push({ page_id: Number(pages[i].page.id), page_name: pages[i].name, path: target, bytes: sizeAfter });
+      }
+    } finally {
+      for (k = 0; k < keys.length; k++) {
+        if (saved[keys[k]] !== undefined) {
+          try { prefs[keys[k]] = saved[keys[k]]; } catch (e3) { ctx.warn('Could not restore export preference ' + keys[k] + '.'); }
+        }
+      }
+    }
+
+    return {
+      format: format,
+      dpi: dpi,
+      quality: quality,
+      color_space: colorSpace,
+      transparent_background: format === 'png' ? transparent : null,
+      use_bleed: useBleed,
+      count: files.length,
+      files: files
+    };
+  });