layoutbridge-spm 0.0.1 → 1.0.0

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

@@ -0,0 +1,197 @@
+/* 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. */
+function idcPagesForExport(doc, args) {
+  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 (out.length > 48) { IDC.fail('invalid_argument', 'At most 48 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
+    };
+  });

package/indesign/commands/27-textdefaults.js

@@ -0,0 +1,151 @@
+/* Bereich A – Textvorgaben des Dokuments. */
+
+/* Schriftfamilie und Schnitt der Vorgabe lesen; appliedFont kann Objekt oder "Familie\tSchnitt" sein. */
+function idcReadDefaultFont(defaults) {
+  var family = null;
+  var style = null;
+  var applied, text, tab;
+
+  try {
+    applied = defaults.appliedFont;
+    if (applied && typeof applied === 'object') {
+      try { family = String(applied.fontFamily); } catch (e1) { family = null; }
+      try { style = String(applied.fontStyleName); } catch (e2) { style = null; }
+      if (family === null) {
+        text = String(applied.name);
+        tab = text.indexOf('\t');
+        family = tab >= 0 ? text.substr(0, tab) : text;
+      }
+    } else if (applied !== undefined && applied !== null) {
+      text = String(applied);
+      tab = text.indexOf('\t');
+      family = tab >= 0 ? text.substr(0, tab) : text;
+      if (tab >= 0) { style = text.substr(tab + 1); }
+    }
+  } catch (e) { /* bleibt null */ }
+
+  if (style === null) {
+    try { style = String(defaults.fontStyle); } catch (e3) { style = null; }
+  }
+  return { family: family, style: style };
+}
+
+function idcStyleName(styleObject) {
+  try {
+    if (styleObject && styleObject.isValid !== false) { return String(styleObject.name); }
+  } catch (e) { /* null */ }
+  return null;
+}
+
+function idcReadTextDefaults(defaults) {
+  var font = idcReadDefaultFont(defaults);
+  var size = null;
+  /*
+   * pointSize kommt in der aktuellen Skript-Masseinheit zurueck – unter der
+   * Millimeter-Klammer des Interpreters also als 4.233 statt 12. Deshalb auch
+   * das Lesen unter Punkt (am lebenden InDesign 21.5 am 04.09.2026 gesehen).
+   */
+  try {
+    size = IDC.inPoints(function () { return IDC.round(defaults.pointSize, 3); });
+  } catch (e) { size = null; }
+  return {
+    font: font.family,
+    font_style: font.style,
+    point_size: size,
+    paragraph_style: idcStyleName(defaults.appliedParagraphStyle),
+    character_style: idcStyleName(defaults.appliedCharacterStyle)
+  };
+}
+
+IDC.register('document_text_defaults', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var defaults = doc.textDefaults;
+    var changed = [];
+    var problems = [];
+    var wantsChange = false;
+    var style, fontObject, fontText, after, current;
+
+    function problem(field, message) {
+      problems.push({ field: field, message: String(message) });
+    }
+
+    /* Erst das Absatzformat, dann die Schrift: so bleibt eine ausdrueckliche Schrift Vorrang. */
+    if (args.paragraph_style !== undefined && args.paragraph_style !== null) {
+      wantsChange = true;
+      style = IDC.paragraphStyleByName(doc, String(args.paragraph_style));
+      if (style === null) {
+        problem('paragraph_style', 'Paragraph style "' + args.paragraph_style + '" not found.');
+      } else {
+        try {
+          defaults.appliedParagraphStyle = style;
+          changed.push('paragraph_style');
+        } catch (e1) {
+          problem('paragraph_style', e1.message ? e1.message : e1);
+        }
+      }
+    }
+
+    if (args.font !== undefined && args.font !== null) {
+      wantsChange = true;
+      fontText = String(args.font);
+      try {
+        if (fontText.indexOf('\t') >= 0) {
+          fontObject = app.fonts.itemByName(fontText);
+          if (!fontObject || fontObject.isValid !== true) {
+            problem('font', 'Font "' + fontText.replace(/\t/g, ' / ') + '" is not installed.');
+          } else {
+            defaults.appliedFont = fontObject;
+            changed.push('font');
+          }
+        } else {
+          defaults.appliedFont = fontText;
+          current = idcReadDefaultFont(defaults);
+          if (current.family !== fontText) {
+            problem('font', 'Font family "' + fontText + '" is not installed; InDesign kept "' + current.family + '".');
+          } else {
+            changed.push('font');
+          }
+        }
+      } catch (e2) {
+        problem('font', e2.message ? e2.message : e2);
+      }
+    }
+
+    if (args.font_style !== undefined && args.font_style !== null) {
+      wantsChange = true;
+      try {
+        defaults.fontStyle = String(args.font_style);
+        current = idcReadDefaultFont(defaults);
+        if (current.style !== String(args.font_style)) {
+          problem('font_style', 'Font style "' + args.font_style + '" is not available for "' + current.family + '"; InDesign kept "' + current.style + '".');
+        } else {
+          changed.push('font_style');
+        }
+      } catch (e3) {
+        problem('font_style', e3.message ? e3.message : e3);
+      }
+    }
+
+    if (args.point_size !== undefined && args.point_size !== null) {
+      wantsChange = true;
+      if (typeof args.point_size !== 'number' || !(args.point_size > 0) || args.point_size > 1296) {
+        problem('point_size', 'point_size must be a number above 0 and up to 1296.');
+      } else {
+        try {
+          IDC.inPoints(function () { defaults.pointSize = args.point_size; });
+          changed.push('point_size');
+        } catch (e4) {
+          problem('point_size', e4.message ? e4.message : e4);
+        }
+      }
+    }
+
+    after = idcReadTextDefaults(defaults);
+    after.changed_fields = changed;
+    after.problems = problems;
+    after.read_only = !wantsChange;
+    if (changed.length > 0) { ctx.changes = { modified_document_ids: [Number(doc.id)] }; }
+    return after;
+  });

package/indesign/commands/28-selection.js

@@ -0,0 +1,174 @@
+/* Wunschliste J2 Nr. 25 (Sitzung 8) – Auswahl lesen und setzen: get_selection, set_selection. */
+
+var IDC_TEXT_CLASSES = ['Text', 'InsertionPoint', 'Character', 'Word', 'Line', 'Paragraph', 'TextStyleRange', 'TextColumn'];
+
+function idcIsTextClass(name) {
+  var i;
+  for (i = 0; i < IDC_TEXT_CLASSES.length; i++) { if (IDC_TEXT_CLASSES[i] === name) { return true; } }
+  return false;
+}
+
+function idcDescribeTextSelection(doc, textObject) {
+  var out = { story_id: null, start_index: null, end_index: null, length: null, frame_id: null, text: '' };
+  var story = null, first = null, count = 0;
+  try { story = textObject.parentStory; out.story_id = Number(story.id); } catch (e0) { story = null; }
+  try { count = Number(textObject.characters.length); } catch (e1) { count = 0; }
+  out.length = count;
+  try {
+    if (count > 0) {
+      first = textObject.characters.item(0);
+      out.start_index = Number(first.index);
+      out.end_index = out.start_index + count;
+    } else {
+      out.start_index = Number(textObject.index);
+      out.end_index = out.start_index;
+    }
+  } catch (e2) { /* null */ }
+  try {
+    if (textObject.parentTextFrames && textObject.parentTextFrames.length > 0) { out.frame_id = Number(IDC.concrete(textObject.parentTextFrames[0]).id); }
+  } catch (e3) { /* null */ }
+  try { out.text = idcSnippet(textObject.contents, 200); } catch (e4) { out.text = ''; }
+  return out;
+}
+
+function idcDescribeSelectedItem(doc, item) {
+  var concrete = IDC.concrete(item);
+  var landing = IDC.landing(concrete);
+  var out = { frame_id: null, type: IDC.itemType(concrete), class_name: IDC.className(concrete), page_id: landing.page_id, page_name: landing.page_name,
+    on_parent_page: IDC.isOnParentSpread(concrete), coordinate_space: idcBoundsSpace(concrete), bounds_mm: null,
+    layer_name: idcLayerName(concrete), parent_group_id: null };
+  try { out.frame_id = Number(concrete.id); } catch (e0) { /* null */ }
+  try { out.bounds_mm = idcItemBounds(doc, concrete); } catch (e1) { out.bounds_mm = null; }
+  try { if (IDC.className(concrete.parent) === 'Group') { out.parent_group_id = Number(concrete.parent.id); } } catch (e2) { /* null */ }
+  return out;
+}
+
+function idcReadSelection(doc) {
+  var selection = null, i, entry, name, items = [], text = null, other = [];
+  try { selection = doc.selection; } catch (e0) { selection = null; }
+  if (selection === null || selection === undefined) { return { items: items, text: text, other: other }; }
+  /* Live 05.09.2026: doc.selection ist in ExtendScript ein Array, das IDC.isArray nicht erkennt (eigener Array-Typ) – ueber length/Klassennamen pruefen. */
+  if (!IDC.isArray(selection) && IDC.className(selection) !== 'Array') {
+    try { if (typeof selection.length !== 'number') { selection = [selection]; } } catch (e0b) { selection = [selection]; }
+  }
+  for (i = 0; i < selection.length; i++) {
+    entry = selection[i];
+    if (entry === null || entry === undefined) { continue; }
+    name = IDC.className(entry);
+    if (idcIsTextClass(name)) {
+      if (text === null) { text = idcDescribeTextSelection(doc, entry); text.class_name = name; }
+      continue;
+    }
+    try {
+      if (entry.id !== undefined && entry.geometricBounds !== undefined) { items.push(idcDescribeSelectedItem(doc, entry)); continue; }
+    } catch (e1) { /* kein Seitenobjekt */ }
+    other.push(name);
+  }
+  return { items: items, text: text, other: other };
+}
+
+IDC.register('get_selection', { needs_document: true, read_only: true, ruler: 'page' },
+  function (ctx) {
+    var doc = ctx.doc;
+    var active = false, read = idcReadSelection(doc), ids = [], i;
+    try { active = app.activeDocument !== null && Number(app.activeDocument.id) === Number(doc.id); } catch (e0) { active = false; }
+    for (i = 0; i < read.items.length; i++) { ids.push(read.items[i].frame_id); }
+    if (!active) { ctx.warn('This document is not the active one; the selection belongs to the document window and may be empty here.'); }
+    return {
+      count: read.items.length + (read.text === null ? 0 : 1) + read.other.length,
+      frame_ids: ids,
+      items: read.items,
+      text: read.text,
+      other: read.other,
+      is_active_document: active
+    };
+  });
+
+IDC.register('set_selection', { needs_document: true, read_only: false, ruler: 'page' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var ids = args.frame_ids, items = [], i, found, read, option = null, target = null;
+
+    if (args.clear === true) {
+      if (ids !== undefined && ids !== null) { IDC.fail('invalid_argument', 'clear true cannot be combined with frame_ids.', null); }
+      try {
+        if (typeof NothingEnum !== 'undefined') { doc.select(NothingEnum.NOTHING); }
+        else { doc.select([]); }
+      } catch (e0) {
+        IDC.fail('script_error', 'InDesign could not clear the selection: ' + String(e0.message ? e0.message : e0), null);
+      }
+      return { count: 0, frame_ids: [], items: [], text: null, cleared: true };
+    }
+    /* Sitzung 10 (Kleinigkeit aus Sitzung 9): Textbereich waehlen. */
+    if (args.text_range !== undefined && args.text_range !== null) {
+      if (ids !== undefined && ids !== null) { IDC.fail('invalid_argument', 'text_range cannot be combined with frame_ids.', null); }
+      return idcSelectTextRange(ctx, doc, args.text_range);
+    }
+    if (!IDC.isArray(ids) || ids.length === 0) { IDC.fail('invalid_argument', 'frame_ids must list at least one object id, or text_range {frame_id, start_index, end_index}, or clear true.', null); }
+    if (ids.length > 500) { IDC.fail('invalid_argument', 'frame_ids may list at most 500 objects.', { count: ids.length }); }
+    for (i = 0; i < ids.length; i++) {
+      if (typeof ids[i] !== 'number' || Math.floor(ids[i]) !== ids[i]) { IDC.fail('invalid_argument', 'frame_ids must contain whole numbers.', { frame_ids: ids }); }
+      found = IDC.itemById(doc, ids[i], 'any');
+      if (found === null) { IDC.fail('not_found', 'No object with frame_id ' + ids[i] + ' in this document.', { frame_id: ids[i] }); }
+      items.push(found.item);
+    }
+    try { if (typeof SelectionOptions !== 'undefined') { option = SelectionOptions.REPLACE_WITH; } } catch (e1) { option = null; }
+    target = items.length === 1 ? items[0] : items;
+    try {
+      if (option !== null) { doc.select(target, option); } else { doc.select(target); }
+    } catch (e2) {
+      IDC.fail('script_error', 'InDesign could not select the objects (hidden or locked layer? window not open?): ' + String(e2.message ? e2.message : e2), { frame_ids: ids });
+    }
+    read = idcReadSelection(doc);
+    if (read.items.length !== items.length) {
+      ctx.warn('InDesign reports ' + read.items.length + ' selected object(s) instead of ' + items.length + ' (objects on hidden or locked layers cannot be selected).');
+    }
+    ids = [];
+    for (i = 0; i < read.items.length; i++) { ids.push(read.items[i].frame_id); }
+    return { count: read.items.length, frame_ids: ids, items: read.items, text: read.text, cleared: false };
+  });
+
+/*
+ * Textbereich (oder Einfuegemarke bei start_index == end_index) in der Story
+ * eines Rahmens waehlen: doc.select(text) bringt InDesign in den
+ * Textmodus und zeigt die Stelle. Rueckgabe wie get_selection.
+ */
+function idcSelectTextRange(ctx, doc, spec) {
+  var found, frame, story, range, target, option = null, read, length = 0;
+  if (typeof spec !== 'object' || IDC.isArray(spec)) {
+    IDC.fail('invalid_argument', 'text_range must be an object {frame_id, start_index, end_index}.', null);
+  }
+  found = idcTextFrameArg(doc, spec, 'frame_id');
+  frame = found.item;
+  story = idcStoryOf(frame);
+  try { length = Number(story.characters.length); } catch (e0) { length = 0; }
+  if (typeof spec.start_index === 'number' && spec.start_index === spec.end_index) {
+    /* Einfuegemarke: itemByRange(start, start - 1) waere ein leerer Bereich, den InDesign ablehnt. */
+    if (Math.floor(spec.start_index) !== spec.start_index || spec.start_index < 0 || spec.start_index > length) {
+      IDC.fail('invalid_argument', 'start_index must be a whole number from 0 to the story length ' + length + '.', { start_index: spec.start_index, story_length: length });
+    }
+    range = { start: spec.start_index, end: spec.start_index, text: null };
+  } else {
+    range = idcRangeArg(story, spec, false);
+  }
+  if (range.start === range.end) {
+    try { target = story.insertionPoints.item(range.start); } catch (e1) {
+      IDC.fail('script_error', 'InDesign could not address insertion point ' + range.start + ': ' + String(e1.message ? e1.message : e1), { start_index: range.start });
+    }
+  } else {
+    target = range.text;
+  }
+  try { if (typeof SelectionOptions !== 'undefined') { option = SelectionOptions.REPLACE_WITH; } } catch (e2) { option = null; }
+  try {
+    if (option !== null) { doc.select(target, option); } else { doc.select(target); }
+  } catch (e3) {
+    IDC.fail('script_error', 'InDesign could not select the text (hidden or locked layer? window not open?): ' + String(e3.message ? e3.message : e3),
+      { frame_id: spec.frame_id, start_index: range.start, end_index: range.end });
+  }
+  read = idcReadSelection(doc);
+  if (read.text === null) {
+    read.text = { story_id: Number(story.id), start_index: range.start, end_index: range.end, length: range.end - range.start, frame_id: Number(frame.id), text: '', class_name: 'InsertionPoint' };
+  }
+  return { count: 1, frame_ids: [], items: [], text: read.text, cleared: false, story_length: length };
+}