layoutbridge-spm 0.0.1 → 1.0.0

package/indesign/commands/31-view.js

@@ -0,0 +1,210 @@
+/*
+ * Sitzung 10 (Demo-Heft-Befund 1, 05.09.2026) – Ansicht steuern.
+ *
+ * show_page stellt das Layoutfenster eines Dokuments auf eine Seite oder
+ * Musterseite und passt sie ein; die Helfer idcCaptureView/idcRestoreView
+ * merken die Ansicht vor einem Eingriff und stellen sie danach wieder her
+ * (keep_view in create_parent_page, add_page und place_text_file mit
+ * autoflow – InDesign springt beim Anlegen von Muster- und Dokumentseiten
+ * ungefragt dorthin).
+ *
+ * Adobe-DOM (geprueft 05.09.2026): LayoutWindow.activePage (Page),
+ * LayoutWindow.activeSpread (Spread oder MasterSpread), zoomPercentage
+ * (5 bis 4000), zoom(ZoomOptions) mit FIT_PAGE, FIT_SPREAD, SHOW_PASTEBOARD,
+ * ACTUAL_SIZE; Window.bringToFront(); Application.activeWindow;
+ * Document.layoutWindows. Ein mit show_window false geoeffnetes Dokument hat
+ * kein Layoutfenster.
+ */
+
+/* Layoutfenster eines Dokuments: das aktive, wenn es dazugehoert, sonst das erste; null ohne Fenster. */
+function idcLayoutWindowOf(doc) {
+  var win = null, wins = null, parent = null;
+  try {
+    win = app.activeWindow;
+    if (win && win.isValid === true && IDC.className(win) === 'LayoutWindow') {
+      try { parent = win.parent; } catch (e0) { parent = null; }
+      if (parent && Number(parent.id) === Number(doc.id)) { return win; }
+    }
+  } catch (e1) { /* kein aktives Fenster */ }
+  try { wins = doc.layoutWindows; } catch (e2) { wins = null; }
+  if (wins === null || wins === undefined) { return null; }
+  try {
+    if (wins.length > 0) { return wins.item(0); }
+  } catch (e3) { /* leer */ }
+  return null;
+}
+
+/* Liegt die Seite auf einem Musterbogen? */
+function idcPageIsParent(page) {
+  var parent = null;
+  try { parent = page.parent; } catch (e) { return false; }
+  return IDC.className(parent) === 'MasterSpread';
+}
+
+/* Ansicht eines Fensters als Datensatz fuer die Antwort. */
+function idcDescribeView(win) {
+  var out = { has_window: win !== null, active_page_id: null, active_page_name: null, active_spread_id: null, is_parent_page: null, zoom_percentage: null };
+  var page = null, spread = null;
+  if (win === null) { return out; }
+  try { page = win.activePage; } catch (e0) { page = null; }
+  if (page !== null && page !== undefined) {
+    try { out.active_page_id = Number(page.id); } catch (e1) { /* bleibt null */ }
+    try { out.active_page_name = String(page.name); } catch (e2) { /* bleibt null */ }
+    out.is_parent_page = idcPageIsParent(page);
+  }
+  try { spread = win.activeSpread; } catch (e3) { spread = null; }
+  if (spread !== null && spread !== undefined) {
+    try { out.active_spread_id = Number(spread.id); } catch (e4) { /* bleibt null */ }
+  }
+  try { out.zoom_percentage = IDC.round(Number(win.zoomPercentage), 2); } catch (e5) { /* bleibt null */ }
+  return out;
+}
+
+/* Ansicht merken (vor einem Eingriff, der die Ansicht verschiebt). */
+function idcCaptureView(doc) {
+  var view = { window: idcLayoutWindowOf(doc), page: null, spread: null, zoom: null };
+  if (view.window === null) { return view; }
+  try { view.page = view.window.activePage; } catch (e0) { view.page = null; }
+  try { view.spread = view.window.activeSpread; } catch (e1) { view.spread = null; }
+  try { view.zoom = Number(view.window.zoomPercentage); } catch (e2) { view.zoom = null; }
+  return view;
+}
+
+/* Gemerkte Ansicht wiederherstellen. Liefert true, wenn Seite oder Bogen zurueckgestellt wurden. */
+function idcRestoreView(view) {
+  var win, restored = false;
+  if (view === null || view === undefined || view.window === null) { return false; }
+  win = view.window;
+  try {
+    if (view.page !== null && view.page.isValid === true) { win.activePage = view.page; restored = true; }
+  } catch (e0) { restored = false; }
+  if (!restored) {
+    try {
+      if (view.spread !== null && view.spread.isValid === true) { win.activeSpread = view.spread; restored = true; }
+    } catch (e1) { restored = false; }
+  }
+  try {
+    if (view.zoom !== null && !isNaN(view.zoom) && view.zoom > 0) { win.zoomPercentage = view.zoom; }
+  } catch (e2) { /* Zoom bleibt */ }
+  return restored;
+}
+
+/* keep_view-Parameter lesen: Vorgabe true. */
+function idcKeepViewArg(args) {
+  if (args.keep_view === undefined || args.keep_view === null) { return true; }
+  if (typeof args.keep_view !== 'boolean') {
+    IDC.fail('invalid_argument', 'keep_view must be true or false.', { keep_view: args.keep_view });
+  }
+  return args.keep_view;
+}
+
+/* Seite eines Dokuments ueber ihren Namen (die gedruckte Seitenzahl), sonst null. */
+function idcDocumentPageByName(doc, name) {
+  var i, page, matches = [];
+  for (i = 0; i < doc.pages.length; i++) {
+    page = doc.pages.item(i);
+    try { if (String(page.name) === String(name)) { matches.push(page); } } catch (e) { /* weiter */ }
+  }
+  return matches;
+}
+
+/* -------------------------------------------------------------- show_page */
+
+IDC.register('show_page', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var hasId = args.page_id !== undefined && args.page_id !== null;
+    var hasName = args.page_name !== undefined && args.page_name !== null;
+    var fit = args.fit === undefined || args.fit === null ? 'page' : String(args.fit);
+    var zoom = args.zoom === undefined || args.zoom === null ? null : args.zoom;
+    var activate = args.activate === true;
+    var win, found, page, matches, isParent, before, spread, option, i, names;
+
+    if (hasId === hasName) {
+      IDC.fail('invalid_argument', 'Pass exactly one of page_id (from list_pages or list_parent_pages) and page_name (the printed page number).', null);
+    }
+    if (fit !== 'page' && fit !== 'spread' && fit !== 'pasteboard' && fit !== 'actual_size' && fit !== 'none') {
+      IDC.fail('invalid_argument', 'fit must be page (default), spread, pasteboard, actual_size or none.', { fit: fit });
+    }
+    if (zoom !== null) {
+      if (typeof zoom !== 'number' || isNaN(zoom) || zoom < 5 || zoom > 4000) {
+        IDC.fail('invalid_argument', 'zoom must be a percentage from 5 to 4000.', { zoom: zoom });
+      }
+    }
+
+    if (hasId) {
+      found = IDC.pageById(doc, args.page_id);
+      if (found === null) {
+        IDC.fail('not_found', 'No page with page_id ' + args.page_id + ' in this document.', { page_id: args.page_id });
+      }
+      page = found.page;
+      isParent = found.is_parent_page;
+    } else {
+      matches = idcDocumentPageByName(doc, args.page_name);
+      if (matches.length === 0) {
+        names = [];
+        for (i = 0; i < doc.pages.length; i++) { try { names.push(String(doc.pages.item(i).name)); } catch (e0) { /* weiter */ } }
+        IDC.fail('not_found', 'No document page named "' + args.page_name + '".', { page_name: String(args.page_name), available: names });
+      }
+      if (matches.length > 1) {
+        ctx.warn('Several pages are named "' + args.page_name + '" (sections restart the numbering); the first one is shown – use page_id to be exact.');
+      }
+      page = matches[0];
+      isParent = false;
+    }
+
+    win = idcLayoutWindowOf(doc);
+    if (win === null) {
+      IDC.fail('invalid_state', 'The document has no layout window (opened with show_window false, or InDesign shows no window for it) – nothing to show. Open it with a window to control the view.', null);
+    }
+    before = idcDescribeView(win);
+
+    try {
+      win.activePage = page;
+    } catch (e1) {
+      spread = null;
+      try { spread = page.parent; } catch (e2) { spread = null; }
+      try {
+        if (spread !== null) { win.activeSpread = spread; }
+        else { throw e1; }
+      } catch (e3) {
+        IDC.fail('script_error', 'InDesign could not show the page: ' + String(e3.message ? e3.message : e3), { page_id: Number(page.id) });
+      }
+    }
+
+    if (fit !== 'none') {
+      if (typeof ZoomOptions === 'undefined') {
+        IDC.fail('invalid_state', 'This runtime has no ZoomOptions enumeration – pass zoom instead of fit.', null);
+      }
+      option = ZoomOptions.FIT_PAGE;
+      if (fit === 'spread') { option = ZoomOptions.FIT_SPREAD; }
+      if (fit === 'pasteboard') { option = ZoomOptions.SHOW_PASTEBOARD; }
+      if (fit === 'actual_size') { option = ZoomOptions.ACTUAL_SIZE; }
+      try { win.zoom(option); } catch (e4) {
+        ctx.warn('The page is shown, but InDesign could not fit the view (' + fit + '): ' + String(e4.message ? e4.message : e4));
+      }
+    }
+    if (zoom !== null) {
+      try { win.zoomPercentage = zoom; } catch (e5) {
+        ctx.warn('The page is shown, but InDesign refused zoom ' + zoom + ': ' + String(e5.message ? e5.message : e5));
+      }
+    }
+    if (activate) {
+      try { win.bringToFront(); } catch (e6) {
+        try { app.activeWindow = win; } catch (e7) { ctx.warn('Could not bring the window to the front: ' + String(e7.message ? e7.message : e7)); }
+      }
+    }
+
+    var after = idcDescribeView(win);
+    return {
+      page_id: Number(page.id),
+      page_name: after.active_page_id === Number(page.id) ? after.active_page_name : String(page.name),
+      is_parent_page: isParent,
+      fit: fit,
+      zoom_percentage: after.zoom_percentage,
+      window_activated: activate,
+      view: after,
+      previous_view: { active_page_id: before.active_page_id, active_page_name: before.active_page_name, zoom_percentage: before.zoom_percentage }
+    };
+  });

package/indesign/commands/32-sections.js

@@ -0,0 +1,203 @@
+/* Wunschliste J2 Nr. 20 (Sitzung 8) – Abschnitte und Seitennummerierung: list_sections, set_section. */
+
+var IDC_PAGE_NUMBER_STYLES = [
+  ['arabic', 'ARABIC'], ['upper_roman', 'UPPER_ROMAN'], ['lower_roman', 'LOWER_ROMAN'],
+  ['upper_letters', 'UPPER_LETTERS'], ['lower_letters', 'LOWER_LETTERS']
+];
+
+function idcPageNumberStyleEnum() {
+  return typeof PageNumberStyle === 'undefined' ? null : PageNumberStyle;
+}
+
+function idcPageNumberStyleName(value) {
+  var i, enumObject = idcPageNumberStyleEnum();
+  if (value === undefined || value === null) { return null; }
+  if (typeof value === 'string') { return value; }
+  if (enumObject === null) { return String(value); }
+  for (i = 0; i < IDC_PAGE_NUMBER_STYLES.length; i++) {
+    try { if (IDC.enumIs(value, enumObject[IDC_PAGE_NUMBER_STYLES[i][1]])) { return IDC_PAGE_NUMBER_STYLES[i][0]; } } catch (e) { /* naechster */ }
+  }
+  return String(value);
+}
+
+function idcPageNumberStyleFor(name) {
+  var i, enumObject = idcPageNumberStyleEnum(), value = null;
+  for (i = 0; i < IDC_PAGE_NUMBER_STYLES.length; i++) {
+    if (IDC_PAGE_NUMBER_STYLES[i][0] === name) {
+      if (enumObject === null) { IDC.fail('invalid_state', 'This runtime has no PageNumberStyle enumeration.', null); }
+      try { value = enumObject[IDC_PAGE_NUMBER_STYLES[i][1]]; } catch (e) { value = null; }
+      if (value === null || value === undefined) {
+        IDC.fail('invalid_state', 'This InDesign has no page number style ' + name + '.', { page_number_style: name });
+      }
+      return value;
+    }
+  }
+  IDC.fail('invalid_argument', 'page_number_style must be one of arabic, upper_roman, lower_roman, upper_letters, lower_letters.', { page_number_style: name });
+  return null;
+}
+
+function idcDescribeSection(doc, section) {
+  var out = {
+    section_id: null, name: null, start_page_id: null, start_page_name: '', start_page_index: null, length: null,
+    continue_numbering: null, page_number_start: null, page_number_style: null,
+    section_prefix: null, include_section_prefix: null, marker: null
+  };
+  var page = null;
+  try { out.section_id = Number(section.id); } catch (e0) { /* null */ }
+  try { out.name = String(section.name); } catch (e1) { /* null */ }
+  try { page = section.pageStart; } catch (e2) { page = null; }
+  if (page !== null && page !== undefined) {
+    try { out.start_page_id = Number(page.id); } catch (e3) { /* null */ }
+    try { out.start_page_name = String(page.name); } catch (e4) { /* leer */ }
+    try { out.start_page_index = Number(page.documentOffset); } catch (e5) { /* null */ }
+  }
+  try { out.length = Number(section.length); } catch (e6) { /* null */ }
+  out.continue_numbering = idcReadBool(section, 'continueNumbering');
+  try { out.page_number_start = Number(section.pageNumberStart); } catch (e7) { /* null */ }
+  try { out.page_number_style = idcPageNumberStyleName(section.pageNumberStyle); } catch (e8) { /* null */ }
+  try { out.section_prefix = String(section.sectionPrefix); } catch (e9) { /* null */ }
+  out.include_section_prefix = idcReadBool(section, 'includeSectionPrefix');
+  try { out.marker = String(section.marker); } catch (e10) { /* null */ }
+  return out;
+}
+
+function idcAllSections(doc) {
+  var out = [], i;
+  try {
+    for (i = 0; i < doc.sections.length; i++) { out.push(idcDescribeSection(doc, doc.sections.item(i))); }
+  } catch (e) { /* leer */ }
+  return out;
+}
+
+function idcPageNames(doc) {
+  var out = [], i, page;
+  try {
+    for (i = 0; i < doc.pages.length; i++) {
+      page = doc.pages.item(i);
+      out.push({ page_id: Number(page.id), name: String(page.name) });
+    }
+  } catch (e) { /* leer */ }
+  return out;
+}
+
+function idcSectionStartingAt(doc, pageId) {
+  var i, section, page;
+  try {
+    for (i = 0; i < doc.sections.length; i++) {
+      section = doc.sections.item(i);
+      page = section.pageStart;
+      if (page && Number(page.id) === Number(pageId)) { return section; }
+    }
+  } catch (e) { /* keiner */ }
+  return null;
+}
+
+IDC.register('list_sections', { needs_document: true, read_only: true, ruler: 'none' },
+  function (ctx) {
+    var doc = ctx.doc;
+    var sections = idcAllSections(doc);
+    return { sections: sections, count: sections.length, pages: idcPageNames(doc) };
+  });
+
+IDC.register('set_section', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var found, page, section, created = false, removed = false, given = 0, before, styleValue, description, i, wanted;
+    var fields = ['continue_numbering', 'page_number_start', 'page_number_style', 'section_prefix', 'include_section_prefix', 'marker', 'name'];
+
+    if (args.page_id === undefined || args.page_id === null) {
+      IDC.fail('invalid_argument', 'page_id is required (the page on which the section starts).', null);
+    }
+    found = IDC.pageById(doc, args.page_id);
+    if (found === null) {
+      IDC.fail('not_found', 'No page with page_id ' + args.page_id + ' in this document.', { page_id: args.page_id });
+    }
+    if (found.is_parent_page) {
+      IDC.fail('invalid_argument', 'Sections start on document pages, not on parent pages.', { page_id: args.page_id });
+    }
+    page = found.page;
+    for (i = 0; i < fields.length; i++) { if (args[fields[i]] !== undefined && args[fields[i]] !== null) { given += 1; } }
+    if (args.remove === true) {
+      if (given > 0) { IDC.fail('invalid_argument', 'remove true cannot be combined with other settings.', null); }
+    } else if (given === 0) {
+      IDC.fail('invalid_argument', 'Pass at least one of continue_numbering, page_number_start, page_number_style, section_prefix, include_section_prefix, marker, name – or remove true.', null);
+    }
+    if (args.page_number_start !== undefined && args.page_number_start !== null) {
+      if (typeof args.page_number_start !== 'number' || Math.floor(args.page_number_start) !== args.page_number_start || args.page_number_start < 1 || args.page_number_start > 999999) {
+        IDC.fail('invalid_argument', 'page_number_start must be a whole number of 1 or more.', { page_number_start: args.page_number_start });
+      }
+      if (args.continue_numbering === true) {
+        IDC.fail('invalid_argument', 'page_number_start and continue_numbering true contradict each other.', null);
+      }
+    }
+    if (args.section_prefix !== undefined && args.section_prefix !== null) {
+      if (typeof args.section_prefix !== 'string' || args.section_prefix.length > 8) {
+        IDC.fail('invalid_argument', 'section_prefix must be a string of at most 8 characters.', { section_prefix: args.section_prefix });
+      }
+    }
+    styleValue = null;
+    if (args.page_number_style !== undefined && args.page_number_style !== null) {
+      styleValue = idcPageNumberStyleFor(args.page_number_style);
+    }
+
+    section = idcSectionStartingAt(doc, args.page_id);
+    if (args.remove === true) {
+      if (section === null) {
+        IDC.fail('not_found', 'No section starts on page ' + args.page_id + '.', { page_id: args.page_id });
+      }
+      try { if (Number(page.documentOffset) === 0) { IDC.fail('invalid_state', 'The section on the first page cannot be removed.', { page_id: args.page_id }); } } catch (e0) { if (e0 && e0.isIdcError) { throw e0; } }
+      before = idcDescribeSection(doc, section);
+      try { section.remove(); } catch (e1) {
+        IDC.fail('script_error', 'InDesign could not remove the section: ' + String(e1.message ? e1.message : e1), { page_id: args.page_id });
+      }
+      removed = true;
+      ctx.changes = { modified_document_ids: [Number(doc.id)] };
+      return { removed: true, section: before, sections: idcAllSections(doc), pages: idcPageNames(doc) };
+    }
+
+    if (section === null) {
+      try { section = doc.sections.add(page); } catch (e2) {
+        IDC.fail('script_error', 'InDesign could not start a section on page ' + args.page_id + ': ' + String(e2.message ? e2.message : e2), { page_id: args.page_id });
+      }
+      created = true;
+    }
+    before = idcDescribeSection(doc, section);
+    try {
+      if (args.page_number_start !== undefined && args.page_number_start !== null) {
+        section.continueNumbering = false;
+        section.pageNumberStart = args.page_number_start;
+      }
+      if (args.continue_numbering !== undefined && args.continue_numbering !== null) {
+        if (args.continue_numbering !== true && args.continue_numbering !== false) { IDC.fail('invalid_argument', 'continue_numbering must be true or false.', null); }
+        section.continueNumbering = args.continue_numbering;
+      }
+      if (styleValue !== null) { section.pageNumberStyle = styleValue; }
+      if (args.section_prefix !== undefined && args.section_prefix !== null) { section.sectionPrefix = args.section_prefix; }
+      if (args.include_section_prefix !== undefined && args.include_section_prefix !== null) {
+        if (args.include_section_prefix !== true && args.include_section_prefix !== false) { IDC.fail('invalid_argument', 'include_section_prefix must be true or false.', null); }
+        section.includeSectionPrefix = args.include_section_prefix;
+      }
+      if (args.marker !== undefined && args.marker !== null) {
+        if (typeof args.marker !== 'string') { IDC.fail('invalid_argument', 'marker must be a string.', null); }
+        section.marker = args.marker;
+      }
+      if (args.name !== undefined && args.name !== null) {
+        if (typeof args.name !== 'string') { IDC.fail('invalid_argument', 'name must be a string.', null); }
+        section.name = args.name;
+      }
+    } catch (e3) {
+      if (e3 && e3.isIdcError) { throw e3; }
+      IDC.fail('script_error', 'InDesign could not change the section: ' + String(e3.message ? e3.message : e3), { page_id: args.page_id });
+    }
+    description = idcDescribeSection(doc, section);
+    for (i = 0; i < fields.length; i++) {
+      wanted = args[fields[i]];
+      if (wanted === undefined || wanted === null) { continue; }
+      if (fields[i] === 'page_number_start' && description.page_number_start !== wanted) { ctx.warn('InDesign reports page_number_start ' + description.page_number_start + '.'); }
+      if (fields[i] === 'page_number_style' && description.page_number_style !== wanted) { ctx.warn('InDesign reports page_number_style ' + description.page_number_style + '.'); }
+    }
+    if (created) { ctx.warn('A new section was started on page ' + description.start_page_name + '; page names after it may have changed – read list_pages again.'); }
+    ctx.changes = { modified_document_ids: [Number(doc.id)] };
+    return { created: created, removed: removed, section: description, previous: before, sections: idcAllSections(doc), pages: idcPageNames(doc) };
+  });