layoutbridge-light 0.0.0-stage → 1.0.1

package/indesign/commands/89-toc-index.js

@@ -0,0 +1,1002 @@
+/*
+ * Sitzung 42 (A-41, E-97) – Inhaltsverzeichnis und Register:
+ * list_toc_styles, define_toc_style, create_toc; add_index_entry,
+ * list_index, generate_index.
+ *
+ * Adobe-DOM (gelesen 09.10.2026): TOCStyle (title, titleStyle,
+ * includeHidden, runIn, includeBookDocuments, createBookmarks,
+ * tocStyleEntries), TOCStyleEntry (name, level, formatStyle,
+ * pageNumberPosition, separator, pageNumberStyle, separatorStyle,
+ * sortAlphabet), Document.createTOC(using, replacing, fromBook, placePoint,
+ * includeOverset, destinationLayer); Index (topics, allTopics,
+ * generate(on, placePoint, destinationLayer, autoflowing, includeOverset)),
+ * Topic (name, sortOrder, topics, pageReferences, crossReferences),
+ * PageReference (sourceText, pageReferenceType, pageReferenceLimit,
+ * pageNumberStyleOverride), CrossReference (referencedTopic,
+ * crossReferenceType, customTypeString), Document.indexGenerationOptions
+ * (IndexOptions), Story.storyType (StoryTypes).
+ *
+ * Live-Probe 09.10.2026 (InDesign 21.6): createTOC und generate liefern ein
+ * Array mit einer Story; createTOC setzt auf die aktive Seite; replace
+ * behaelt die Story; ein Seitenverweis setzt ein Markierungszeichen in den
+ * Text.
+ */
+
+var IDC_PAGE_NUMBER_POSITIONS = [
+  ['after', 'AFTER_ENTRY'],
+  ['before', 'BEFORE_ENTRY'],
+  ['none', 'NONE']
+];
+
+var IDC_PAGE_REFERENCE_TYPES = [
+  ['current_page', 'CURRENT_PAGE'],
+  ['to_next_style_change', 'TO_NEXT_STYLE_CHANGE'],
+  ['to_next_use_of_style', 'TO_NEXT_USE_OF_STYLE'],
+  ['to_end_of_story', 'TO_END_OF_STORY'],
+  ['to_end_of_document', 'TO_END_OF_DOCUMENT'],
+  ['to_end_of_section', 'TO_END_OF_SECTION'],
+  ['for_next_paragraphs', 'FOR_NEXT_N_PARAGRAPHS'],
+  ['for_next_pages', 'FOR_NEXT_N_PAGES'],
+  ['suppress_page_numbers', 'SUPPRESS_PAGE_NUMBERS']
+];
+
+var IDC_CROSS_REFERENCE_TYPES = [
+  ['see', 'SEE'],
+  ['see_also', 'SEE_ALSO'],
+  ['see_or_see_also', 'SEE_OR_ALSO_BRACKET'],
+  ['see_herein', 'SEE_HEREIN'],
+  ['see_also_herein', 'SEE_ALSO_HEREIN'],
+  ['custom', 'CUSTOM_CROSS_REFERENCE'],
+  ['custom_before', 'CUSTOM_CROSS_REFERENCE_BEFORE'],
+  ['custom_after', 'CUSTOM_CROSS_REFERENCE_AFTER']
+];
+
+/* Name zu einem Enumerationswert (Tabelle [name, KONSTANTE]), sonst der Rohwert als Text. */
+function idcTocEnumName(table, enumObject, value) {
+  var i;
+  if (value === undefined || value === null) { return null; }
+  if (enumObject === undefined || enumObject === null) { return String(value); }
+  for (i = 0; i < table.length; i++) {
+    try { if (IDC.enumIs(value, enumObject[table[i][1]])) { return table[i][0]; } } catch (e) { /* naechster */ }
+  }
+  return String(value);
+}
+
+/* Enumerationswert zu einem Namen, sonst invalid_argument. */
+function idcTocEnumFor(table, enumObject, enumName, name, field) {
+  var i, value = null;
+  for (i = 0; i < table.length; i++) {
+    if (table[i][0] === name) {
+      if (enumObject === undefined || enumObject === null) { IDC.fail('invalid_state', 'This runtime has no ' + enumName + ' enumeration.', null); }
+      try { value = enumObject[table[i][1]]; } catch (e) { value = null; }
+      if (value === null || value === undefined) { IDC.fail('invalid_state', 'This InDesign has no ' + enumName + ' value ' + name + '.', null); }
+      return value;
+    }
+  }
+  IDC.fail('invalid_argument', field + ' must be one of ' + idcTableNames(table).join(', ') + '.', { value: name });
+  return null;
+}
+
+function idcPageNumberPositionsEnum() { return typeof PageNumberPosition === 'undefined' ? null : PageNumberPosition; }
+function idcPageReferenceTypesEnum() { return typeof PageReferenceType === 'undefined' ? null : PageReferenceType; }
+function idcCrossReferenceTypesEnum() { return typeof CrossReferenceType === 'undefined' ? null : CrossReferenceType; }
+
+/* Formatname aus einer Formateigenschaft (Format oder Text), sonst null. */
+function idcStyleNameOf(value) {
+  if (value === undefined || value === null) { return null; }
+  if (typeof value === 'string') { return value === '' ? null : value; }
+  try { if (value.isValid === false) { return null; } } catch (e0) { /* weiter */ }
+  try { return String(value.name); } catch (e1) { return null; }
+}
+
+/* Optionales Zeichenformat ueber den Namen; '' oder null = nicht gesetzt. */
+function idcOptionalCharacterStyle(doc, name, field) {
+  var style;
+  if (name === undefined || name === null) { return null; }
+  if (typeof name !== 'string' || name === '') { IDC.fail('invalid_argument', field + ' must be the name of a character style.', { field: field }); }
+  style = idcCharacterStyleByName(doc, name);
+  if (style === null) { IDC.fail('not_found', 'Character style "' + name + '" not found (' + field + ').', { style_name: name, field: field }); }
+  return style;
+}
+
+function idcOptionalParagraphStyle(doc, name, field) {
+  if (name === undefined || name === null) { return null; }
+  return idcParagraphStyleArg(doc, name, field);
+}
+
+function idcBoolArg(args, field) {
+  var value = args[field];
+  if (value === undefined || value === null) { return null; }
+  if (typeof value !== 'boolean') { IDC.fail('invalid_argument', field + ' must be true or false.', { field: field }); }
+  return value;
+}
+
+/* Erstes Element, wenn InDesign ein Array liefert (Live-Probe: createTOC, generate). */
+function idcFirstOf(result) {
+  if (result === undefined || result === null) { return null; }
+  if (IDC.isArray(result)) { return result.length > 0 ? result[0] : null; }
+  try {
+    if (result.id === undefined && result.length !== undefined && result.length > 0 && result[0] !== undefined) { return result[0]; }
+  } catch (e) { /* kein Array */ }
+  return result;
+}
+
+/* Stories eines Typs (TOC_STORY, INDEXING_STORY) als Array. */
+function idcStoriesOfType(doc, typeName) {
+  var out = [], i, story, wanted = null;
+  if (typeof StoryTypes === 'undefined') { return out; }
+  try { wanted = StoryTypes[typeName]; } catch (e0) { wanted = null; }
+  if (wanted === null || wanted === undefined) { return out; }
+  try {
+    for (i = 0; i < doc.stories.length; i++) {
+      story = doc.stories.item(i);
+      try { if (IDC.enumIs(story.storyType, wanted)) { out.push(story); } } catch (e1) { /* ohne Typ */ }
+    }
+  } catch (e2) { /* keine Stories */ }
+  return out;
+}
+
+function idcStoryIsGenerated(story) {
+  var type;
+  if (typeof StoryTypes === 'undefined') { return false; }
+  try { type = story.storyType; } catch (e) { return false; }
+  try { return IDC.enumIs(type, StoryTypes.TOC_STORY) || IDC.enumIs(type, StoryTypes.INDEXING_STORY); } catch (e2) { return false; }
+}
+
+/* Rahmen einer Story als Array konkreter Objekte. */
+function idcStoryAmong(story, stories) {
+  var i;
+  for (i = 0; i < stories.length; i++) {
+    try { if (Number(stories[i].id) === Number(story.id)) { return true; } } catch (e) { /* weiter */ }
+  }
+  return false;
+}
+
+function idcGeneratedFrames(story) {
+  var out = [], containers = null, i;
+  try { containers = story.textContainers; } catch (e) { containers = null; }
+  if (containers === null || containers === undefined) { return out; }
+  try {
+    for (i = 0; i < containers.length; i++) { out.push(IDC.concrete(containers[i])); }
+  } catch (e2) { /* leer */ }
+  return out;
+}
+
+function idcStoryOverflows(story, frames) {
+  if (frames.length > 0) { return idcOverflows(frames[frames.length - 1]); }
+  try { return story.overflows === true; } catch (e) { return null; }
+}
+
+/* Absatztext ohne Absatzende. */
+function idcParagraphText(paragraph) {
+  var text = '';
+  try { text = String(paragraph.contents); } catch (e) { return ''; }
+  if (text.length > 0 && (text.charAt(text.length - 1) === '\r' || text.charAt(text.length - 1) === '\n')) { text = text.substring(0, text.length - 1); }
+  return text;
+}
+
+/* Erzeugte Story (Verzeichnis oder Register) beschreiben. */
+function idcDescribeGeneratedStory(doc, story) {
+  var out = { story_id: null, frame_ids: [], page_ids: [], page_names: [], paragraph_count: null, length: null, overset: null };
+  var frames = idcGeneratedFrames(story), i, landing;
+  try { out.story_id = Number(story.id); } catch (e0) { /* null */ }
+  for (i = 0; i < frames.length; i++) {
+    out.frame_ids.push(Number(frames[i].id));
+    landing = IDC.landing(frames[i]);
+    out.page_ids.push(landing.page_id);
+    out.page_names.push(landing.page_name);
+  }
+  try { out.paragraph_count = Number(story.paragraphs.length); } catch (e1) { /* null */ }
+  try { out.length = Number(story.characters.length); } catch (e2) { /* null */ }
+  out.overset = idcStoryOverflows(story, frames);
+  return out;
+}
+
+/* Absaetze einer erzeugten Story: [{text, paragraph_style}], hoechstens max. */
+function idcStoryLines(story, max) {
+  var out = { lines: [], total: 0 }, i, p, count = 0;
+  try { count = Number(story.paragraphs.length); } catch (e) { count = 0; }
+  out.total = count;
+  for (i = 0; i < count && i < max; i++) {
+    p = story.paragraphs.item(i);
+    out.lines.push({ text: idcParagraphText(p), paragraph_style: idcParagraphStyleName(p) });
+  }
+  return out;
+}
+
+/* ------------------------------------------------------------ TOC-Formate */
+
+function idcTocStyleByName(doc, name) {
+  var i, style;
+  try {
+    for (i = 0; i < doc.tocStyles.length; i++) {
+      style = doc.tocStyles.item(i);
+      if (String(style.name) === String(name)) { return style; }
+    }
+  } catch (e) { /* keins */ }
+  return null;
+}
+
+function idcDescribeTocEntry(entry) {
+  var out = { paragraph_style: null, level: null, entry_style: null, page_number_position: null, separator: null, page_number_style: null, separator_style: null, sort_alphabetical: null };
+  try { out.paragraph_style = String(entry.name); } catch (e0) { /* null */ }
+  try { out.level = Number(entry.level); } catch (e1) { /* null */ }
+  try { out.entry_style = idcStyleNameOf(entry.formatStyle); } catch (e2) { /* null */ }
+  try { out.page_number_position = idcTocEnumName(IDC_PAGE_NUMBER_POSITIONS, idcPageNumberPositionsEnum(), entry.pageNumberPosition); } catch (e3) { /* null */ }
+  try { out.separator = String(entry.separator); } catch (e4) { /* null */ }
+  try { out.page_number_style = idcStyleNameOf(entry.pageNumberStyle); } catch (e5) { /* null */ }
+  try { out.separator_style = idcStyleNameOf(entry.separatorStyle); } catch (e6) { /* null */ }
+  try { out.sort_alphabetical = entry.sortAlphabet === true; } catch (e7) { /* null */ }
+  return out;
+}
+
+function idcDescribeTocStyle(style) {
+  var out = { name: null, title: null, title_style: null, include_hidden_layers: null, run_in: null, include_book_documents: null, create_bookmarks: null, entries: [] };
+  var i, entries = null;
+  try { out.name = String(style.name); } catch (e0) { /* null */ }
+  try { out.title = String(style.title); } catch (e1) { /* null */ }
+  try { out.title_style = idcStyleNameOf(style.titleStyle); } catch (e2) { /* null */ }
+  try { out.include_hidden_layers = style.includeHidden === true; } catch (e3) { /* null */ }
+  try { out.run_in = style.runIn === true; } catch (e4) { /* null */ }
+  try { out.include_book_documents = style.includeBookDocuments === true; } catch (e5) { /* null */ }
+  try { out.create_bookmarks = style.createBookmarks === true; } catch (e6) { /* null */ }
+  try { entries = style.tocStyleEntries; } catch (e7) { entries = null; }
+  if (entries !== null && entries !== undefined) {
+    try {
+      for (i = 0; i < entries.length; i++) { out.entries.push(idcDescribeTocEntry(entries.item(i))); }
+    } catch (e8) { /* leer */ }
+  }
+  return out;
+}
+
+/* entries[] pruefen und Eigenschaften je Eintrag vorbereiten (vor jeder Aenderung). */
+function idcTocEntriesArg(doc, entries) {
+  var out = [], i, spec, props, level;
+  if (!IDC.isArray(entries) || entries.length === 0) { IDC.fail('invalid_argument', 'entries must be a non-empty array.', null); }
+  for (i = 0; i < entries.length; i++) {
+    spec = entries[i];
+    if (!spec || typeof spec !== 'object') { IDC.fail('invalid_argument', 'entries[' + i + '] must be an object.', null); }
+    idcParagraphStyleArg(doc, spec.paragraph_style, 'entries[' + i + '].paragraph_style');
+    props = {};
+    level = spec.level === undefined || spec.level === null ? 1 : spec.level;
+    if (typeof level !== 'number' || Math.floor(level) !== level || level < 1 || level > 9) {
+      IDC.fail('invalid_argument', 'entries[' + i + '].level must be a whole number from 1 to 9.', { level: spec.level });
+    }
+    props.level = level;
+    if (spec.entry_style !== undefined && spec.entry_style !== null) { props.formatStyle = idcParagraphStyleArg(doc, spec.entry_style, 'entries[' + i + '].entry_style'); }
+    if (spec.page_number_position !== undefined && spec.page_number_position !== null) {
+      props.pageNumberPosition = idcTocEnumFor(IDC_PAGE_NUMBER_POSITIONS, idcPageNumberPositionsEnum(), 'PageNumberPosition', spec.page_number_position, 'entries[' + i + '].page_number_position');
+    }
+    if (spec.separator !== undefined && spec.separator !== null) {
+      if (typeof spec.separator !== 'string') { IDC.fail('invalid_argument', 'entries[' + i + '].separator must be a string.', null); }
+      props.separator = spec.separator;
+    }
+    if (spec.page_number_style !== undefined && spec.page_number_style !== null) { props.pageNumberStyle = idcOptionalCharacterStyle(doc, spec.page_number_style, 'entries[' + i + '].page_number_style'); }
+    if (spec.separator_style !== undefined && spec.separator_style !== null) { props.separatorStyle = idcOptionalCharacterStyle(doc, spec.separator_style, 'entries[' + i + '].separator_style'); }
+    if (spec.sort_alphabetical !== undefined && spec.sort_alphabetical !== null) {
+      if (typeof spec.sort_alphabetical !== 'boolean') { IDC.fail('invalid_argument', 'entries[' + i + '].sort_alphabetical must be true or false.', null); }
+      props.sortAlphabet = spec.sort_alphabetical;
+    }
+    out.push({ style_name: String(spec.paragraph_style), props: props });
+  }
+  return out;
+}
+
+IDC.register('list_toc_styles', { needs_document: true, read_only: true, ruler: 'none' },
+  function (ctx) {
+    var doc = ctx.doc;
+    var styles = [], stories = [], i, list;
+    try {
+      for (i = 0; i < doc.tocStyles.length; i++) { styles.push(idcDescribeTocStyle(doc.tocStyles.item(i))); }
+    } catch (e) { /* leer */ }
+    list = idcStoriesOfType(doc, 'TOC_STORY');
+    for (i = 0; i < list.length; i++) { stories.push(idcDescribeGeneratedStory(doc, list[i])); }
+    return { toc_styles: styles, count: styles.length, toc_stories: stories };
+  });
+
+IDC.register('define_toc_style', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var name = args.name;
+    var style, created = false, entries = null, titleStyle = null, props = {}, i, description, flag;
+    var flags = [['include_hidden_layers', 'includeHidden'], ['run_in', 'runIn'], ['create_bookmarks', 'createBookmarks']];
+
+    if (typeof name !== 'string' || name === '') { IDC.fail('invalid_argument', 'name is required.', null); }
+    style = idcTocStyleByName(doc, name);
+    if (args.remove === true) {
+      if (style === null) { IDC.fail('not_found', 'No TOC style named "' + name + '"; see list_toc_styles.', { name: name }); }
+      description = idcDescribeTocStyle(style);
+      try { style.remove(); } catch (e0) {
+        IDC.fail('script_error', 'InDesign could not remove the TOC style "' + name + '": ' + String(e0.message ? e0.message : e0), { name: name });
+      }
+      ctx.changes = { modified_document_ids: [Number(doc.id)] };
+      return { removed: true, created: false, updated: false, toc_style: description };
+    }
+    /* Erst alles pruefen, dann schreiben. */
+    if (args.entries !== undefined && args.entries !== null) { entries = idcTocEntriesArg(doc, args.entries); }
+    if (args.title !== undefined && args.title !== null) {
+      if (typeof args.title !== 'string') { IDC.fail('invalid_argument', 'title must be a string ("" for no title).', null); }
+      props.title = args.title;
+    }
+    if (args.title_style !== undefined && args.title_style !== null) { titleStyle = idcParagraphStyleArg(doc, args.title_style, 'title_style'); props.titleStyle = titleStyle; }
+    for (i = 0; i < flags.length; i++) {
+      flag = idcBoolArg(args, flags[i][0]);
+      if (flag !== null) { props[flags[i][1]] = flag; }
+    }
+    if (style === null) {
+      if (entries === null) { IDC.fail('invalid_argument', 'A new TOC style needs entries (at least one paragraph style).', { name: name }); }
+      try {
+        style = doc.tocStyles.add({ name: name });
+      } catch (e1) {
+        IDC.fail('script_error', 'InDesign could not create the TOC style "' + name + '": ' + String(e1.message ? e1.message : e1), { name: name });
+      }
+      created = true;
+    }
+    try {
+      for (var key in props) {
+        if (IDC.hasOwn(props, key)) { style[key] = props[key]; }
+      }
+      if (entries !== null) { idcReplaceTocEntries(style, entries); }
+    } catch (e2) {
+      if (created) { try { style.remove(); } catch (e3) { /* bleibt */ } }
+      IDC.fail('script_error', 'InDesign could not set the TOC style "' + name + '": ' + String(e2.message ? e2.message : e2), { name: name });
+    }
+    description = idcDescribeTocStyle(style);
+    ctx.changes = { modified_document_ids: [Number(doc.id)] };
+    return { removed: false, created: created, updated: !created, toc_style: description };
+  });
+
+/* ------------------------------------------------- Ziel fuer create/generate */
+
+/* Zielangaben pruefen: { page, rect (oder null), point [x, y] in Seitenkoordinaten }. */
+function idcPlacementArg(doc, args, needed) {
+  var out = { page: null, rect: null, point: null };
+  var found, margins = null;
+  if (args.page_id === undefined || args.page_id === null) {
+    if (needed) { IDC.fail('invalid_argument', 'page_id is required (the page that gets the new frame).', null); }
+    return out;
+  }
+  found = idcAnyPageById(doc, args.page_id);
+  if (found.is_parent_page) { IDC.fail('invalid_argument', 'page_id must be a document page, not a parent page.', { page_id: args.page_id }); }
+  out.page = found.page;
+  if (args.bounds_mm !== undefined && args.bounds_mm !== null) {
+    out.rect = idcBoundsArg(args.bounds_mm, 'bounds_mm');
+    out.point = [out.rect.x, out.rect.y];
+  } else if (args.position_mm !== undefined && args.position_mm !== null) {
+    var p = idcPointArg(args.position_mm, 'position_mm');
+    out.point = [p.x, p.y];
+  } else {
+    try { margins = out.page.marginPreferences; out.point = [Number(margins.left), Number(margins.top)]; } catch (e) { out.point = [0, 0]; }
+  }
+  return out;
+}
+
+/* Ebene ueber layer_name, sonst null. */
+function idcOptionalLayer(doc, args) {
+  if (args.layer_name === undefined || args.layer_name === null) { return null; }
+  return idcLayerArg(doc, { layer_name: args.layer_name }).layer;
+}
+
+/* Rahmen der neuen Story an Seite und Begrenzung bringen; Warnungen bei Abweichung. */
+function idcSettleGeneratedFrame(ctx, doc, story, placement) {
+  var frames = idcGeneratedFrames(story), frame, landing;
+  if (frames.length === 0) { ctx.warn('InDesign created the story without a frame.'); return; }
+  frame = frames[0];
+  landing = IDC.landing(frame);
+  if (landing.page_id !== Number(placement.page.id)) {
+    try { frame.move(placement.page); } catch (e0) { /* Landepruefung meldet es */ }
+  }
+  if (placement.rect !== null) {
+    try {
+      idcWriteSpreadBounds(doc, frame, idcToSpreadBounds(placement.page, idcRectToBounds(placement.rect), 'page'));
+    } catch (e1) {
+      ctx.warn('Could not set bounds_mm on the new frame: ' + String(e1.message ? e1.message : e1));
+    }
+  }
+  idcCheckLanding(ctx, frame, placement.page, 'frame');
+}
+
+/* Seite des ersten Rahmens einer erzeugten Story (fuer replace), sonst undefined. */
+function idcGeneratedStoryPage(story) {
+  var frames = idcGeneratedFrames(story), page = null;
+  if (frames.length === 0) { return undefined; }
+  try { page = frames[0].parentPage; } catch (e) { page = null; }
+  return page === null ? undefined : page;
+}
+
+/*
+ * Aenderungsangaben fuer create_toc/generate_index (A-43 Nebenbefund): Rahmen,
+ * die es vorher nicht gab, sind created_frame_ids, vorhandene (replace)
+ * modified_frame_ids. Bis 1.0.1 standen auch neue Rahmen unter modified.
+ */
+function idcGeneratedChanges(out, framesBefore, pagesBefore, doc) {
+  var created = [], modified = [], i, j, known, changes = {};
+  for (i = 0; i < out.frame_ids.length; i++) {
+    known = false;
+    for (j = 0; j < framesBefore.length; j++) { if (framesBefore[j] === out.frame_ids[i]) { known = true; break; } }
+    if (known) { modified.push(out.frame_ids[i]); } else { created.push(out.frame_ids[i]); }
+  }
+  if (created.length > 0) { changes.created_frame_ids = created; }
+  if (modified.length > 0) { changes.modified_frame_ids = modified; }
+  if (pagesBefore !== null) {
+    var pageIds = [], k, page;
+    try {
+      for (k = 0; k < doc.pages.length; k++) {
+        page = doc.pages.item(k);
+        known = false;
+        for (j = 0; j < pagesBefore.length; j++) { if (pagesBefore[j] === Number(page.id)) { known = true; break; } }
+        if (!known) { pageIds.push(Number(page.id)); }
+      }
+    } catch (e0) { pageIds = []; }
+    if (pageIds.length > 0) { changes.created_page_ids = pageIds; }
+  }
+  return changes;
+}
+
+/* Rahmen-IDs aller Storys einer Liste (vor dem Erzeugen). */
+function idcFrameIdsOfStories(stories) {
+  var out = [], i, frames, j;
+  for (i = 0; i < stories.length; i++) {
+    frames = idcGeneratedFrames(stories[i]);
+    for (j = 0; j < frames.length; j++) { try { out.push(Number(frames[j].id)); } catch (e) { /* ohne */ } }
+  }
+  return out;
+}
+
+/* Seiten-IDs des Dokuments. */
+function idcDocumentPageIds(doc) {
+  var out = [], i;
+  try { for (i = 0; i < doc.pages.length; i++) { out.push(Number(doc.pages.item(i).id)); } } catch (e) { /* ohne */ }
+  return out;
+}
+
+/* Gemeinsame Rueckgabe von create_toc und generate_index. */
+function idcGeneratedResult(doc, story, replaced, maxLines) {
+  var info = idcDescribeGeneratedStory(doc, story);
+  var lines = idcStoryLines(story, maxLines);
+  var frames = idcGeneratedFrames(story);
+  info.replaced = replaced;
+  info.frame_id = info.frame_ids.length > 0 ? info.frame_ids[0] : null;
+  info.page_id = info.page_ids.length > 0 ? info.page_ids[0] : null;
+  info.page_name = info.page_names.length > 0 ? info.page_names[0] : '';
+  info.bounds_mm = frames.length > 0 ? idcItemBounds(doc, frames[0]) : null;
+  info.lines = lines.lines;
+  info.lines_truncated = lines.total > lines.lines.length;
+  return info;
+}
+
+IDC.register('create_toc', { needs_document: true, read_only: false, ruler: 'page' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var style, existing, replace, placement, layer, view, win, result, story, out, includeOverset, title = '', entries = 0, i, lines;
+
+    if (typeof args.toc_style !== 'string' || args.toc_style === '') { IDC.fail('invalid_argument', 'toc_style is required (name from list_toc_styles).', null); }
+    style = idcTocStyleByName(doc, args.toc_style);
+    if (style === null) { IDC.fail('not_found', 'No TOC style named "' + args.toc_style + '"; see list_toc_styles or define_toc_style.', { toc_style: args.toc_style }); }
+    replace = idcBoolArg(args, 'replace') === true;
+    includeOverset = idcBoolArg(args, 'include_overset') === true;
+    existing = idcStoriesOfType(doc, 'TOC_STORY');
+    if (replace && existing.length === 0) {
+      ctx.warn('No table of contents to replace yet – a new one is created.');
+      replace = false;
+    }
+    placement = idcPlacementArg(doc, args, !replace);
+    if (replace && placement.page !== null) { ctx.warn('replace keeps the existing frame where it is; page_id, position_mm and bounds_mm are ignored.'); }
+    if (!replace && existing.length > 0) { ctx.warn('The document already has ' + existing.length + ' table(s) of contents; pass replace true to update instead of adding another.'); }
+    layer = replace ? null : idcOptionalLayer(doc, args);
+    var framesBefore = idcFrameIdsOfStories(existing);
+
+    /* createTOC setzt auf die aktive Seite (Live-Probe 09.10.2026). */
+    view = idcCaptureView(doc);
+    win = view.window;
+    try {
+      if (!replace && win !== null) {
+        try { win.activePage = placement.page; } catch (e0) { /* Rahmen wird danach verschoben */ }
+      }
+      try {
+        if (replace) {
+          result = doc.createTOC(style, true, undefined, undefined, includeOverset);
+        } else if (layer !== null) {
+          result = doc.createTOC(style, false, undefined, placement.point, includeOverset, layer);
+        } else {
+          result = doc.createTOC(style, false, undefined, placement.point, includeOverset);
+        }
+      } catch (e1) {
+        IDC.fail('script_error', 'InDesign could not create the table of contents: ' + String(e1.message ? e1.message : e1), { toc_style: args.toc_style });
+      }
+    } finally {
+      if (args.keep_view !== false) { idcRestoreView(view); }
+    }
+    story = idcFirstOf(result);
+    if (story === null) {
+      existing = idcStoriesOfType(doc, 'TOC_STORY');
+      story = existing.length > 0 ? existing[existing.length - 1] : null;
+    }
+    if (story === null) { IDC.fail('script_error', 'InDesign created no table of contents story.', { toc_style: args.toc_style }); }
+    if (!replace) { idcSettleGeneratedFrame(ctx, doc, story, placement); }
+    else if (!idcStoryAmong(story, existing)) { idcTocIntoOldPlace(ctx, doc, story, existing[0]); }
+
+    out = idcGeneratedResult(doc, story, replace, 500);
+    try { title = String(style.title); } catch (e2) { title = ''; }
+    /* Eintraege: Absaetze mit Text ausser dem Titel. */
+    lines = out.lines;
+    for (i = 0; i < lines.length; i++) {
+      if (i === 0 && title !== '' && lines[i].text === title) { continue; }
+      if (lines[i].text !== '') { entries += 1; }
+    }
+    if (out.lines_truncated) { entries = null; }
+    out.entry_count = entries;
+    out.toc_style = String(args.toc_style);
+    if (entries === 0) { ctx.warn('The table of contents has no entries – no paragraph uses the styles of "' + args.toc_style + '" (include_overset true also reads overset text).'); }
+    if (out.overset === true) { ctx.warn('The table of contents does not fit its frame (Übersatz); enlarge the frame or thread it.'); }
+    ctx.changes = idcGeneratedChanges(out, framesBefore, null, doc);
+    return out;
+  });
+
+/*
+ * A-68 (11), Sitzung 81: InDesign lehnt ein Inhaltsverzeichnisformat ohne
+ * Eintrag ab (live: „Jedes Inhaltsverzeichnisformat sollte mindestens einen
+ * Inhaltsverzeichniseintrag enthalten“), sobald der letzte Eintrag entfernt
+ * wird. Deshalb bleibt ein alter Eintrag stehen, bis die neuen angelegt
+ * sind; nennt die neue Liste sein Absatzformat, wird er weiterverwendet.
+ */
+function idcReplaceTocEntries(style, entries) {
+  var old = [], i, keep = null, first = null, firstName = null, key;
+  for (i = 0; i < style.tocStyleEntries.length; i++) { old.push(style.tocStyleEntries.item(i)); }
+  for (i = old.length - 1; i >= 1; i--) { old[i].remove(); }
+  if (old.length > 0) { first = old[0]; try { firstName = String(first.name); } catch (e0) { firstName = null; } }
+  for (i = 0; i < entries.length; i++) {
+    if (keep === null && first !== null && entries[i].style_name === firstName) {
+      for (key in entries[i].props) {
+        if (IDC.hasOwn(entries[i].props, key)) { first[key] = entries[i].props[key]; }
+      }
+      keep = first;
+    } else {
+      style.tocStyleEntries.add(entries[i].style_name, entries[i].props);
+    }
+  }
+  if (first !== null && keep === null) { first.remove(); }
+}
+
+/*
+ * A-68 (12), Sitzung 81: createTOC(replacing) ersetzt nur ein Verzeichnis
+ * desselben Formats; mit einem anderen Format legte InDesign ein zweites an
+ * (live auf Seite 1). Dann kommt das neue an Seite, Lage, Groesse und Ebene
+ * des ersten Rahmens des alten, und die Rahmen des alten werden entfernt.
+ */
+function idcTocIntoOldPlace(ctx, doc, story, oldStory) {
+  var oldFrames = idcGeneratedFrames(oldStory), first, page = null, rect = null, layer = null, frames, i;
+  if (oldFrames.length === 0) { return false; }
+  first = oldFrames[0];
+  try { page = first.parentPage; } catch (e0) { page = null; }
+  if (page === null || page === undefined) { return false; }
+  rect = idcItemBounds(doc, first);
+  try { layer = first.itemLayer; } catch (e1) { layer = null; }
+  idcSettleGeneratedFrame(ctx, doc, story, { page: page, rect: rect, point: rect === null ? null : [rect.x, rect.y] });
+  frames = idcGeneratedFrames(story);
+  if (layer !== null && layer !== undefined && frames.length > 0) {
+    try { frames[0].itemLayer = layer; } catch (e2) { /* bleibt auf der aktiven Ebene */ }
+  }
+  for (i = oldFrames.length - 1; i >= 0; i--) {
+    try { oldFrames[i].remove(); } catch (e3) { ctx.warn('A frame of the previous table of contents could not be removed: ' + String(e3.message ? e3.message : e3)); }
+  }
+  ctx.warn('The existing table of contents was made with another TOC style; InDesign added a new one, which now takes the place of the old frame (the old one was removed).');
+  return true;
+}
+
+/* ------------------------------------------------------------------ Register */
+
+function idcIndexOf(doc, create) {
+  var count = 0;
+  try { count = Number(doc.indexes.length); } catch (e0) { count = 0; }
+  if (count > 0) { return doc.indexes.item(0); }
+  if (!create) { return null; }
+  try { return doc.indexes.add(); } catch (e1) {
+    IDC.fail('script_error', 'InDesign could not create the index: ' + String(e1.message ? e1.message : e1), null);
+  }
+  return null;
+}
+
+/* Themenpfad: 1 bis 4 nicht leere Texte. */
+function idcTopicPathArg(path, field) {
+  var i;
+  if (!IDC.isArray(path) || path.length < 1 || path.length > 4) { IDC.fail('invalid_argument', field + ' must list 1 to 4 topic levels, e.g. ["Fruit", "Apples"].', null); }
+  for (i = 0; i < path.length; i++) {
+    if (typeof path[i] !== 'string' || path[i] === '') { IDC.fail('invalid_argument', field + '[' + i + '] must be a non-empty string.', null); }
+  }
+  return path;
+}
+
+function idcTopicIn(collection, name) {
+  var i, topic;
+  try {
+    for (i = 0; i < collection.length; i++) {
+      topic = collection.item(i);
+      if (String(topic.name) === String(name)) { return topic; }
+    }
+  } catch (e) { /* keins */ }
+  return null;
+}
+
+/* Thema am Pfad finden oder anlegen; created bekommt die neu angelegten Pfade. */
+function idcTopicAt(index, path, sortAs, created) {
+  var collection = index.topics, topic = null, i, sort;
+  for (i = 0; i < path.length; i++) {
+    topic = idcTopicIn(collection, path[i]);
+    sort = sortAs !== null && sortAs[i] !== undefined && sortAs[i] !== null && sortAs[i] !== '' ? String(sortAs[i]) : null;
+    if (topic === null) {
+      try {
+        topic = sort === null ? collection.add(path[i]) : collection.add(path[i], sort);
+      } catch (e0) {
+        IDC.fail('script_error', 'InDesign could not create the topic "' + path[i] + '": ' + String(e0.message ? e0.message : e0), { topic: path.slice(0, i + 1) });
+      }
+      created.push(path.slice(0, i + 1));
+    } else if (sort !== null) {
+      try { topic.sortOrder = sort; } catch (e1) { /* bleibt */ }
+    }
+    collection = topic.topics;
+  }
+  return topic;
+}
+
+/* Pfad eines Themas von der obersten Ebene bis zu ihm. */
+function idcTopicPath(topic) {
+  var path = [], current = topic, step;
+  for (step = 0; step < 6; step++) {
+    if (current === null || current === undefined) { break; }
+    if (IDC.className(current) !== 'Topic') { break; }
+    try { path.unshift(String(current.name)); } catch (e0) { break; }
+    try { current = current.parent; } catch (e1) { break; }
+  }
+  return path;
+}
+
+/* Seitenverweis beschreiben: Seite, Story, Index, Uebersatz. */
+function idcDescribePageReference(ref) {
+  var out = { page_reference_id: null, type: null, page_id: null, page_name: '', story_id: null, index: null, in_overset: null, frame_id: null };
+  var source = null, frames = null, frame, landing;
+  try { out.page_reference_id = Number(ref.id); } catch (e0) { /* null */ }
+  try { out.type = idcTocEnumName(IDC_PAGE_REFERENCE_TYPES, idcPageReferenceTypesEnum(), ref.pageReferenceType); } catch (e1) { /* null */ }
+  try { source = ref.sourceText; } catch (e2) { source = null; }
+  if (source !== null && source !== undefined) {
+    try { out.story_id = Number(source.parentStory.id); } catch (e3) { /* null */ }
+    try { out.index = Number(source.index); } catch (e4) { /* null */ }
+    try { frames = source.parentTextFrames; } catch (e5) { frames = null; }
+    if (frames !== null && frames !== undefined) {
+      try {
+        if (frames.length > 0) {
+          frame = IDC.concrete(frames[0]);
+          out.frame_id = Number(frame.id);
+          landing = IDC.landing(frame);
+          out.page_id = landing.page_id;
+          out.page_name = landing.page_name;
+          out.in_overset = false;
+        } else {
+          out.in_overset = true;
+        }
+      } catch (e6) { /* null */ }
+    }
+  }
+  return out;
+}
+
+/* Querverweis-Angabe pruefen: { type, topic (Pfad), custom_text }. */
+function idcCrossReferenceArg(spec) {
+  var type;
+  if (!spec || typeof spec !== 'object') { IDC.fail('invalid_argument', 'cross_reference must be an object { type, topic, custom_text }.', null); }
+  type = spec.type === undefined || spec.type === null ? 'see' : spec.type;
+  idcTocEnumFor(IDC_CROSS_REFERENCE_TYPES, idcCrossReferenceTypesEnum(), 'CrossReferenceType', type, 'cross_reference.type');
+  idcTopicPathArg(spec.topic, 'cross_reference.topic');
+  if (type.substring(0, 6) === 'custom' && (typeof spec.custom_text !== 'string' || spec.custom_text === '')) {
+    IDC.fail('invalid_argument', 'cross_reference.custom_text is required for type ' + type + '.', null);
+  }
+  return { type: type, topic: spec.topic, custom_text: typeof spec.custom_text === 'string' ? spec.custom_text : null };
+}
+
+IDC.register('add_index_entry', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var path = idcTopicPathArg(args.topic, 'topic');
+    var sortAs = null, refType = null, refTypeName, limit = undefined, numberStyle = null, cross = null, mode, sources = [], frame = null, story = null;
+    var start, end, length, found, split = { open: [], stories: [], skipped: [] }, i, maxMatches, index, indexCreated, created = [], topic, ref, refs = [], added = [], target, crossOut = null, matchesFound = 0, frameIds = [], seen = {}, info;
+
+    if (args.sort_as !== undefined && args.sort_as !== null) {
+      if (!IDC.isArray(args.sort_as) || args.sort_as.length > path.length) { IDC.fail('invalid_argument', 'sort_as must be an array with at most one entry per topic level.', null); }
+      sortAs = args.sort_as;
+    }
+    refTypeName = args.page_reference_type === undefined || args.page_reference_type === null ? 'current_page' : args.page_reference_type;
+    refType = idcTocEnumFor(IDC_PAGE_REFERENCE_TYPES, idcPageReferenceTypesEnum(), 'PageReferenceType', refTypeName, 'page_reference_type');
+    if (refTypeName === 'to_next_use_of_style') {
+      if (args.limit_paragraph_style !== undefined && args.limit_paragraph_style !== null) { limit = idcParagraphStyleArg(doc, args.limit_paragraph_style, 'limit_paragraph_style'); }
+    } else if (refTypeName === 'for_next_paragraphs' || refTypeName === 'for_next_pages') {
+      if (typeof args.limit_count !== 'number' || Math.floor(args.limit_count) !== args.limit_count || args.limit_count < 1) {
+        IDC.fail('invalid_argument', 'limit_count (a whole number of 1 or more) is required for ' + refTypeName + '.', null);
+      }
+      limit = args.limit_count;
+    }
+    numberStyle = idcOptionalCharacterStyle(doc, args.page_number_style, 'page_number_style');
+    if (args.cross_reference !== undefined && args.cross_reference !== null) { cross = idcCrossReferenceArg(args.cross_reference); }
+
+    /* Ziel: Textbereich, Suchtext oder keins (nur Thema bzw. Querverweis). */
+    if (typeof args.find_text === 'string' && args.find_text !== '') {
+      mode = 'find_text';
+      if (args.start_index !== undefined && args.start_index !== null) { IDC.fail('invalid_argument', 'Pass either find_text or start_index, not both.', null); }
+    } else if (args.start_index !== undefined && args.start_index !== null) {
+      mode = 'range';
+    } else {
+      mode = 'none';
+      if (cross === null && args.frame_id !== undefined && args.frame_id !== null) {
+        IDC.fail('invalid_argument', 'frame_id needs start_index (a text position) or find_text.', null);
+      }
+    }
+    if (mode === 'range') {
+      frame = idcTextFrameArg(doc, args, 'frame_id').item;
+      story = idcStoryOf(frame);
+      try { length = Number(story.characters.length); } catch (e0) { length = 0; }
+      start = args.start_index;
+      end = args.end_index === undefined || args.end_index === null ? start : args.end_index;
+      if (typeof start !== 'number' || Math.floor(start) !== start || start < 0 || start > length) {
+        IDC.fail('invalid_argument', 'start_index must be a whole number from 0 to the story length (' + length + ').', { start_index: start, story_length: length });
+      }
+      if (typeof end !== 'number' || Math.floor(end) !== end || end < start || end > length) {
+        IDC.fail('invalid_argument', 'end_index must be a whole number from start_index to the story length (' + length + ').', { end_index: end, story_length: length });
+      }
+      idcRejectStoryLocked(story, Number(frame.id), 'add_index_entry');
+      if (idcStoryIsGenerated(story)) { IDC.fail('invalid_state', 'Frame ' + args.frame_id + ' holds a generated table of contents or index; index entries belong in the body text.', { frame_id: args.frame_id }); }
+      try {
+        target = end > start ? story.characters.itemByRange(start, end - 1) : story.insertionPoints.item(start);
+      } catch (e1) {
+        IDC.fail('script_error', 'InDesign could not address the text range ' + start + '–' + end + '.', { start_index: start, end_index: end });
+      }
+      sources.push(target);
+    } else if (mode === 'find_text') {
+      maxMatches = args.max_matches === undefined || args.max_matches === null ? 100 : args.max_matches;
+      if (typeof maxMatches !== 'number' || Math.floor(maxMatches) !== maxMatches || maxMatches < 1 || maxMatches > 1000) {
+        IDC.fail('invalid_argument', 'max_matches must be a whole number from 1 to 1000.', { max_matches: args.max_matches });
+      }
+      if (args.frame_id !== undefined && args.frame_id !== null) {
+        frame = idcTextFrameArg(doc, args, 'frame_id').item;
+        story = idcStoryOf(frame);
+      }
+      try {
+        app.findTextPreferences = NothingEnum.NOTHING;
+        idcSetFindOptions(app.findChangeTextOptions, { case_sensitive: args.case_sensitive === true, whole_word: args.whole_word === true, include_master_pages: false, include_hidden_layers: false, include_locked_layers: true });
+        app.findTextPreferences.findWhat = args.find_text;
+        found = story === null ? doc.findText() : story.findText();
+      } catch (e2) {
+        IDC.fail('script_error', 'InDesign could not search for "' + args.find_text + '": ' + String(e2.message ? e2.message : e2), { find_text: args.find_text });
+      } finally {
+        try { app.findTextPreferences = NothingEnum.NOTHING; } catch (e3) { ctx.warn('Could not reset the find preferences.'); }
+      }
+      /* Verzeichnis- und Registertext nicht markieren; gesperrte Stories auslassen (A-23). */
+      var plain = [];
+      for (i = 0; i < found.length; i++) {
+        try { if (idcStoryIsGenerated(found[i].parentStory)) { continue; } } catch (e4) { /* weiter */ }
+        plain.push(found[i]);
+      }
+      split = idcSplitMatchesByLock(plain);
+      matchesFound = split.open.length;
+      if (matchesFound === 0 && cross === null) {
+        IDC.fail('not_found', 'No occurrence of "' + args.find_text + '" in ' + (story === null ? 'the document' : 'the story of frame ' + args.frame_id) +
+          (split.skipped.length > 0 ? ' outside locked stories (see details.skipped_locked)' : '') + '.', { find_text: args.find_text, skipped_locked: split.skipped });
+      }
+      if (matchesFound > maxMatches) { ctx.warn('Only the first ' + maxMatches + ' of ' + matchesFound + ' occurrences got a page reference (max_matches).'); }
+      for (i = 0; i < split.open.length && i < maxMatches; i++) { sources.push(split.open[i]); }
+      if (split.skipped.length > 0) { ctx.warn('Occurrences in ' + split.skipped.length + ' locked story/stories got no page reference (see skipped_locked).'); }
+    } else if (cross === null) {
+      IDC.fail('invalid_argument', 'Pass a text position (frame_id with start_index), find_text or a cross_reference.', null);
+    }
+
+    indexCreated = idcIndexOf(doc, false) === null;
+    index = idcIndexOf(doc, true);
+    topic = idcTopicAt(index, path, sortAs, created);
+
+    /* Von hinten nach vorn: jeder Verweis setzt ein Zeichen vor seine Quelle (Live-Probe). */
+    for (i = sources.length - 1; i >= 0; i--) {
+      try {
+        if (numberStyle !== null) { ref = topic.pageReferences.add(sources[i], refType, limit, numberStyle); }
+        else if (limit !== undefined) { ref = topic.pageReferences.add(sources[i], refType, limit); }
+        else { ref = topic.pageReferences.add(sources[i], refType); }
+      } catch (e5) {
+        IDC.fail('script_error', 'InDesign could not add the page reference: ' + String(e5.message ? e5.message : e5), { topic: path, added_before: added.length });
+      }
+      added.unshift(ref);
+    }
+    /* Erst nach allen Einfuegungen beschreiben: jede Marke verschiebt die Stellen hinter ihr. */
+    for (i = 0; i < added.length; i++) { refs.push(idcDescribePageReference(added[i])); }
+    for (i = 0; i < refs.length; i++) {
+      if (refs[i].frame_id !== null && !IDC.hasOwn(seen, String(refs[i].frame_id))) { seen[String(refs[i].frame_id)] = true; frameIds.push(refs[i].frame_id); }
+    }
+    if (cross !== null) {
+      var other = idcTopicAt(index, cross.topic, null, created);
+      var crossType = idcTocEnumFor(IDC_CROSS_REFERENCE_TYPES, idcCrossReferenceTypesEnum(), 'CrossReferenceType', cross.type, 'cross_reference.type');
+      try {
+        if (cross.custom_text !== null) { ref = topic.crossReferences.add(other, crossType, cross.custom_text); }
+        else { ref = topic.crossReferences.add(other, crossType); }
+      } catch (e6) {
+        IDC.fail('script_error', 'InDesign could not add the cross reference: ' + String(e6.message ? e6.message : e6), { topic: path, cross_reference: cross.topic });
+      }
+      crossOut = { cross_reference_id: null, type: cross.type, topic: idcTopicPath(other), custom_text: cross.custom_text };
+      try { crossOut.cross_reference_id = Number(ref.id); } catch (e7) { /* null */ }
+    }
+    for (i = 0; i < refs.length; i++) {
+      if (refs[i].in_overset === true) { ctx.warn('A page reference sits in overset text; generate_index lists it only with include_overset true.'); break; }
+    }
+    info = { modified_document_ids: [Number(doc.id)] };
+    if (frameIds.length > 0) { info.modified_frame_ids = frameIds; }
+    ctx.changes = info;
+    return {
+      topic: idcTopicPath(topic),
+      index_created: indexCreated,
+      created_topics: created,
+      page_references: refs,
+      page_reference_count: refs.length,
+      matches_found: mode === 'find_text' ? matchesFound : null,
+      skipped_locked: split.skipped,
+      cross_reference: crossOut
+    };
+  });
+
+/* Themen eines Bereichs depth-first in out schreiben. */
+function idcCollectTopics(collection, out, filter, withRefs, totals) {
+  var i, j, topic, path, entry, refs, crosses, match, k, cross, sortOrder;
+  var count = 0;
+  try { count = Number(collection.length); } catch (e0) { count = 0; }
+  for (i = 0; i < count; i++) {
+    topic = collection.item(i);
+    path = idcTopicPath(topic);
+    match = filter === null;
+    if (!match) {
+      for (k = 0; k < path.length; k++) { if (path[k].toLowerCase().indexOf(filter) >= 0) { match = true; break; } }
+    }
+    if (match) {
+      sortOrder = null;
+      try { sortOrder = String(topic.sortOrder); } catch (e1) { sortOrder = null; }
+      entry = { path: path, level: path.length, name: path[path.length - 1], sort_as: sortOrder === '' ? null : sortOrder, page_reference_count: 0, cross_reference_count: 0 };
+      refs = [];
+      try {
+        for (j = 0; j < topic.pageReferences.length; j++) { refs.push(idcDescribePageReference(topic.pageReferences.item(j))); }
+      } catch (e2) { /* keine */ }
+      crosses = [];
+      try {
+        for (j = 0; j < topic.crossReferences.length; j++) {
+          cross = topic.crossReferences.item(j);
+          var c = { cross_reference_id: null, type: null, topic: null, custom_text: null };
+          try { c.cross_reference_id = Number(cross.id); } catch (e3) { /* null */ }
+          try { c.type = idcTocEnumName(IDC_CROSS_REFERENCE_TYPES, idcCrossReferenceTypesEnum(), cross.crossReferenceType); } catch (e4) { /* null */ }
+          try { c.topic = idcTopicPath(cross.referencedTopic); } catch (e5) { /* null */ }
+          try { c.custom_text = String(cross.customTypeString) === '' ? null : String(cross.customTypeString); } catch (e6) { /* null */ }
+          crosses.push(c);
+        }
+      } catch (e7) { /* keine */ }
+      entry.page_reference_count = refs.length;
+      entry.cross_reference_count = crosses.length;
+      if (withRefs) { entry.page_references = refs; entry.cross_references = crosses; }
+      totals.page_references += refs.length;
+      totals.cross_references += crosses.length;
+      out.push(entry);
+    }
+    idcCollectTopics(topic.topics, out, filter, withRefs, totals);
+  }
+}
+
+IDC.register('list_index', { needs_document: true, read_only: true, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var index = idcIndexOf(doc, false);
+    var topics = [], totals = { page_references: 0, cross_references: 0 }, stories = [], list, i, filter = null;
+    if (args.topic_contains !== undefined && args.topic_contains !== null) {
+      if (typeof args.topic_contains !== 'string' || args.topic_contains === '') { IDC.fail('invalid_argument', 'topic_contains must be a non-empty string.', null); }
+      filter = args.topic_contains.toLowerCase();
+    }
+    if (index !== null) { idcCollectTopics(index.topics, topics, filter, args.include_references !== false, totals); }
+    list = idcStoriesOfType(doc, 'INDEXING_STORY');
+    for (i = 0; i < list.length; i++) { stories.push(idcDescribeGeneratedStory(doc, list[i])); }
+    return {
+      index_exists: index !== null,
+      topics: topics,
+      topic_count: topics.length,
+      page_reference_count: totals.page_references,
+      cross_reference_count: totals.cross_references,
+      index_stories: stories
+    };
+  });
+
+IDC.register('generate_index', { needs_document: true, read_only: false, ruler: 'page' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var index = idcIndexOf(doc, false);
+    var existing = idcStoriesOfType(doc, 'INDEXING_STORY');
+    var replace = idcBoolArg(args, 'replace') === true;
+    var placement, options, layer, sets = [], i, key, levels, sep, result, story, out, pagesBefore, flag;
+    var flags = [['include_section_headings', 'includeSectionHeadings'], ['include_empty_sections', 'includeEmptyIndexSections'], ['include_hidden_layers', 'includeHiddenEntries']];
+    var charStyles = [['page_number_style', 'pageNumberStyle'], ['cross_reference_style', 'crossReferenceStyle'], ['cross_reference_topic_style', 'crossReferenceTopicStyle']];
+    var separators = [['following_topic', 'followingTopicSeparator'], ['between_entries', 'betweenEntriesSeparator'], ['page_range', 'pageRangeSeparator'], ['between_page_numbers', 'betweenPageNumbersSeparator'], ['before_cross_reference', 'beforeCrossReferenceSeparator'], ['entry_end', 'entryEndSeparator']];
+
+    if (index === null) { IDC.fail('invalid_state', 'The document has no index entries yet; add them with add_index_entry first.', null); }
+    if (replace && existing.length === 0) {
+      ctx.warn('No index to replace yet – a new one is created.');
+      replace = false;
+    }
+    placement = idcPlacementArg(doc, args, !replace);
+    if (replace && placement.page !== null) { ctx.warn('replace keeps the existing frame where it is; page_id, position_mm and bounds_mm are ignored.'); }
+    if (!replace && existing.length > 0) { ctx.warn('The document already has ' + existing.length + ' generated index story/stories; pass replace true to update instead of adding another.'); }
+    layer = replace ? null : idcOptionalLayer(doc, args);
+
+    /* Einstellungen sammeln und pruefen, dann schreiben (Dokumenteinstellung, bleibt gespeichert). */
+    if (args.title !== undefined && args.title !== null) {
+      if (typeof args.title !== 'string') { IDC.fail('invalid_argument', 'title must be a string ("" for no title).', null); }
+      sets.push(['title', args.title]);
+    }
+    if (args.title_style !== undefined && args.title_style !== null) { sets.push(['titleStyle', idcParagraphStyleArg(doc, args.title_style, 'title_style')]); }
+    if (args.format !== undefined && args.format !== null) {
+      if (typeof IndexFormat === 'undefined') { IDC.fail('invalid_state', 'This runtime has no IndexFormat enumeration.', null); }
+      if (args.format === 'nested') { sets.push(['indexFormat', IndexFormat.NESTED_FORMAT]); }
+      else if (args.format === 'run_in') { sets.push(['indexFormat', IndexFormat.RUNIN_FORMAT]); }
+      else { IDC.fail('invalid_argument', 'format must be nested or run_in.', { format: args.format }); }
+    }
+    for (i = 0; i < flags.length; i++) {
+      flag = idcBoolArg(args, flags[i][0]);
+      if (flag !== null) { sets.push([flags[i][1], flag]); }
+    }
+    if (args.level_styles !== undefined && args.level_styles !== null) {
+      levels = args.level_styles;
+      if (!IDC.isArray(levels) || levels.length < 1 || levels.length > 4) { IDC.fail('invalid_argument', 'level_styles must list 1 to 4 paragraph style names (level 1 first).', null); }
+      for (i = 0; i < levels.length; i++) {
+        if (levels[i] !== null && levels[i] !== '') { sets.push(['level' + (i + 1) + 'Style', idcParagraphStyleArg(doc, levels[i], 'level_styles[' + i + ']')]); }
+      }
+    }
+    if (args.section_heading_style !== undefined && args.section_heading_style !== null) { sets.push(['sectionHeadingStyle', idcParagraphStyleArg(doc, args.section_heading_style, 'section_heading_style')]); }
+    for (i = 0; i < charStyles.length; i++) {
+      if (args[charStyles[i][0]] !== undefined && args[charStyles[i][0]] !== null) { sets.push([charStyles[i][1], idcOptionalCharacterStyle(doc, args[charStyles[i][0]], charStyles[i][0])]); }
+    }
+    if (args.separators !== undefined && args.separators !== null) {
+      if (typeof args.separators !== 'object') { IDC.fail('invalid_argument', 'separators must be an object.', null); }
+      for (i = 0; i < separators.length; i++) {
+        sep = args.separators[separators[i][0]];
+        if (sep !== undefined && sep !== null) {
+          if (typeof sep !== 'string') { IDC.fail('invalid_argument', 'separators.' + separators[i][0] + ' must be a string.', null); }
+          sets.push([separators[i][1], sep]);
+        }
+      }
+    }
+    sets.push(['replaceExistingIndex', replace]);
+    try {
+      options = doc.indexGenerationOptions;
+      for (i = 0; i < sets.length; i++) { key = sets[i][0]; options[key] = sets[i][1]; }
+    } catch (e0) {
+      IDC.fail('script_error', 'InDesign could not set the index options (' + key + '): ' + String(e0.message ? e0.message : e0), { option: key });
+    }
+
+    try { pagesBefore = Number(doc.pages.length); } catch (e1) { pagesBefore = null; }
+    var framesBefore = idcFrameIdsOfStories(idcStoriesOfType(doc, 'INDEXING_STORY'));
+    var pageIdsBefore = idcDocumentPageIds(doc);
+    try {
+      if (replace) {
+        result = index.generate(idcGeneratedStoryPage(existing[0]), undefined, undefined, args.autoflow === true, args.include_overset === true);
+      } else if (layer !== null) {
+        result = index.generate(placement.page, placement.point, layer, args.autoflow === true, args.include_overset === true);
+      } else {
+        result = index.generate(placement.page, placement.point, undefined, args.autoflow === true, args.include_overset === true);
+      }
+    } catch (e2) {
+      IDC.fail('script_error', 'InDesign could not generate the index: ' + String(e2.message ? e2.message : e2), null);
+    }
+    story = idcFirstOf(result);
+    if (story === null) {
+      existing = idcStoriesOfType(doc, 'INDEXING_STORY');
+      story = existing.length > 0 ? existing[existing.length - 1] : null;
+    }
+    if (story === null) { IDC.fail('script_error', 'InDesign created no index story.', null); }
+    if (!replace) { idcSettleGeneratedFrame(ctx, doc, story, placement); }
+    out = idcGeneratedResult(doc, story, replace, 500);
+    out.pages_added = pagesBefore === null ? null : Number(doc.pages.length) - pagesBefore;
+    if (out.overset === true) { ctx.warn('The index does not fit its frame(s) (Übersatz); enlarge the frame, thread it or pass autoflow true.'); }
+    ctx.changes = idcGeneratedChanges(out, framesBefore, pageIdsBefore, doc);
+    return out;
+  });