layoutbridge-spm 0.0.1 → 1.0.0

package/indesign/commands/62-embed.js

@@ -0,0 +1,120 @@
+/* Wunschliste J2 Nr. 26 (Sitzung 8) – Verknuepfung einbetten und loesen: embed_link, unembed_link. */
+
+/* Verknuepfungen zu link_ids oder frame_id (alle Grafiken des Rahmens) auflisten. */
+function idcLinksArg(doc, args, what) {
+  var out = [], i, link, graphics, found;
+  var hasIds = args.link_ids !== undefined && args.link_ids !== null;
+  var hasFrame = args.frame_id !== undefined && args.frame_id !== null;
+  if (hasIds === hasFrame) {
+    IDC.fail('invalid_argument', 'Pass either link_ids or frame_id.', null);
+  }
+  if (hasIds) {
+    if (!IDC.isArray(args.link_ids) || args.link_ids.length === 0 || args.link_ids.length > 500) {
+      IDC.fail('invalid_argument', 'link_ids must list 1 to 500 link ids.', null);
+    }
+    for (i = 0; i < args.link_ids.length; i++) {
+      link = idcLinkById(doc, args.link_ids[i]);
+      if (link === null) { IDC.fail('not_found', 'No link with link_id ' + args.link_ids[i] + '; see list_links.', { link_id: args.link_ids[i] }); }
+      out.push(link);
+    }
+    return out;
+  }
+  found = idcFrameArg(doc, args, 'frame_id');
+  graphics = idcGraphicsOf(found.item);
+  for (i = 0; i < graphics.length; i++) {
+    link = idcLinkOf(graphics[i]);
+    if (link !== null) { out.push(link); }
+  }
+  if (out.length === 0) {
+    IDC.fail('invalid_state', 'Object ' + args.frame_id + ' holds no linked graphic.', { frame_id: args.frame_id });
+  }
+  return out;
+}
+
+function idcIsEmbedded(link) {
+  try { return idcLinkStatusName(link.status, true) === 'EMBEDDED'; } catch (e) { return false; }
+}
+
+IDC.register('embed_link', { needs_document: true, read_only: false, ruler: 'page' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var links = idcLinksArg(doc, args, 'embed_link');
+    var done = [], skipped = [], i, link, entry, status, bytes;
+
+    for (i = 0; i < links.length; i++) {
+      link = links[i];
+      entry = idcDescribeLink(doc, link);
+      if (idcIsEmbedded(link)) { entry.reason = 'already embedded'; skipped.push(entry); continue; }
+      status = entry.status;
+      if (status === 'LINK_MISSING') { entry.reason = 'file missing'; skipped.push(entry); continue; }
+      try { bytes = Number(link.size); } catch (e0) { bytes = null; }
+      try {
+        link.unlink();
+      } catch (e1) {
+        IDC.fail('io_error', 'InDesign could not embed link ' + entry.file_name + ': ' + String(e1.message ? e1.message : e1),
+          { link_id: entry.link_id, embedded_so_far: done });
+      }
+      entry.status_before = status;
+      entry.bytes = bytes;
+      /* Die Verknuepfung wird beim Einbetten in InDesign zu einem neuen Link-Objekt; frisch lesen. */
+      try { entry.status = idcLinkStatusName(link.status, true); } catch (e2) { entry.status = 'EMBEDDED'; }
+      done.push(entry);
+    }
+    if (skipped.length > 0) {
+      ctx.warn(skipped.length + ' link(s) skipped: ' + idcSkipReasons(skipped));
+    }
+    if (done.length > 0) { ctx.changes = { modified_link_ids: idcLinkIds(done), modified_document_ids: [Number(doc.id)] }; }
+    return { embedded: done, embedded_count: done.length, skipped: skipped, skipped_count: skipped.length, links_after: idcAllLinksBrief(doc) };
+  });
+
+IDC.register('unembed_link', { needs_document: true, read_only: false, ruler: 'page' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var links = idcLinksArg(doc, args, 'unembed_link');
+    var folder = null, done = [], skipped = [], i, link, entry;
+
+    if (args.folder_path !== undefined && args.folder_path !== null) {
+      if (typeof args.folder_path !== 'string' || args.folder_path === '') { IDC.fail('invalid_argument', 'folder_path must be a folder path.', null); }
+      folder = IDC.folderFor(args.folder_path);
+      if (folder.exists !== true) { IDC.fail('io_error', 'folder_path does not exist: ' + args.folder_path, { folder_path: args.folder_path }); }
+    }
+    for (i = 0; i < links.length; i++) {
+      link = links[i];
+      entry = idcDescribeLink(doc, link);
+      if (!idcIsEmbedded(link)) { entry.reason = 'not embedded'; skipped.push(entry); continue; }
+      try {
+        if (folder !== null) { link.unembed(folder); } else { link.unembed(); }
+      } catch (e0) {
+        IDC.fail('io_error', 'InDesign could not unembed link ' + entry.file_name + ' (original file gone? pass folder_path to write it out): ' + String(e0.message ? e0.message : e0),
+          { link_id: entry.link_id, unembedded_so_far: done });
+      }
+      try { entry.status = idcLinkStatusName(link.status, true); } catch (e1) { /* bleibt */ }
+      try { entry.file_path = String(link.filePath); } catch (e2) { /* bleibt */ }
+      done.push(entry);
+    }
+    if (skipped.length > 0) { ctx.warn(skipped.length + ' link(s) skipped: ' + idcSkipReasons(skipped)); }
+    if (done.length > 0) { ctx.changes = { modified_link_ids: idcLinkIds(done), modified_document_ids: [Number(doc.id)] }; }
+    return { unembedded: done, unembedded_count: done.length, skipped: skipped, skipped_count: skipped.length, folder_path: folder === null ? null : IDC.fsPath(folder) || args.folder_path, links_after: idcAllLinksBrief(doc) };
+  });
+
+function idcSkipReasons(list) {
+  var parts = [], i;
+  for (i = 0; i < list.length; i++) { parts.push(String(list[i].file_name) + ' (' + list[i].reason + ')'); }
+  return parts.join(', ');
+}
+
+function idcLinkIds(list) {
+  var out = [], i;
+  for (i = 0; i < list.length; i++) { out.push(list[i].link_id); }
+  return out;
+}
+
+function idcAllLinksBrief(doc) {
+  var out = [], i;
+  try {
+    for (i = 0; i < doc.links.length; i++) { out.push(idcDescribeLink(doc, doc.links.item(i))); }
+  } catch (e) { /* leer */ }
+  return out;
+}

package/indesign/commands/69-placeholders.js

@@ -0,0 +1,127 @@
+/*
+ * Auftrag A-8.8 (Sitzung 9) – benannte Sonderzeichen im Text
+ * (Wunschliste J Nr. 8): Platzhalter {{name}} in set_text,
+ * set_text_in_range und create_text_frame.initial_text werden zu
+ * InDesign-Sonderzeichen; get_frame_text zeigt sie mit show_placeholders
+ * wieder als Platzhalter. Jeder Platzhalter steht fuer genau ein Zeichen,
+ * damit Story-Indizes und Sichtbarkeit zusammenpassen.
+ *
+ * Zeichen (Unicode; Umbruchzeichen als die Codes, die InDesign in contents
+ * fuehrt – 0x0E Spalte, 0x0F Rahmen, 0x10 Seite; live bestaetigt, Journal):
+ */
+var IDC_PLACEHOLDERS = [
+  ['line_break', '\n'],
+  ['nbsp', '\u00A0'],
+  ['nbsp_fixed', '\u202F'],
+  ['thin_space', '\u2009'],
+  ['hair_space', '\u200A'],
+  ['soft_hyphen', '\u00AD'],
+  ['nb_hyphen', '\u2011'],
+  ['en_dash', '\u2013'],
+  ['em_dash', '\u2014'],
+  ['tab', '\t'],
+  ['column_break', '\u000E'],
+  ['frame_break', '\u000F'],
+  ['page_break', '\u0010']
+];
+
+function idcPlaceholderChar(name) {
+  var i;
+  for (i = 0; i < IDC_PLACEHOLDERS.length; i++) {
+    if (IDC_PLACEHOLDERS[i][0] === name) { return IDC_PLACEHOLDERS[i][1]; }
+  }
+  return null;
+}
+
+/*
+ * Platzhalter im Text ersetzen. Liefert { text, replaced {name: n},
+ * unknown [] }. Unbekannte {{...}} bleiben woertlich. enabled false:
+ * nichts wird ersetzt.
+ */
+function idcExpandPlaceholders(text, enabled) {
+  var out = { text: String(text), replaced: {}, unknown: [] };
+  var s = String(text), result = '', i = 0, open, close, name, ch;
+  if (enabled === false) { return out; }
+  while (i < s.length) {
+    open = s.indexOf('{{', i);
+    if (open < 0) { result += s.substr(i); break; }
+    close = s.indexOf('}}', open + 2);
+    if (close < 0) { result += s.substr(i); break; }
+    name = s.substring(open + 2, close);
+    ch = /^[a-z_]+$/.test(name) ? idcPlaceholderChar(name) : null;
+    result += s.substring(i, open);
+    if (ch === null) {
+      result += s.substring(open, close + 2);
+      if (!idcInList(out.unknown, name)) { out.unknown.push(name); }
+    } else {
+      result += ch;
+      out.replaced[name] = (out.replaced[name] || 0) + 1;
+    }
+    i = close + 2;
+  }
+  out.text = result;
+  return out;
+}
+
+/* Sonderzeichen im gelesenen Text als Platzhalter zeigen (get_frame_text show_placeholders). */
+function idcShowPlaceholders(text) {
+  var s = String(text), result = '', i, ch, j, name;
+  for (i = 0; i < s.length; i++) {
+    ch = s.charAt(i);
+    name = null;
+    for (j = 0; j < IDC_PLACEHOLDERS.length; j++) {
+      if (IDC_PLACEHOLDERS[j][1] === ch && ch !== '\r') { name = IDC_PLACEHOLDERS[j][0]; break; }
+    }
+    result += name === null ? ch : '{{' + name + '}}';
+  }
+  return result;
+}
+
+function idcPlaceholderWarnings(ctx, expansion) {
+  if (expansion.unknown.length > 0) {
+    ctx.warn('Unknown placeholder(s) left as written: {{' + expansion.unknown.join('}}, {{') + '}}. Known: ' + idcPlaceholderNames() + '.');
+  }
+}
+
+function idcPlaceholderNames() {
+  var names = [], i;
+  for (i = 0; i < IDC_PLACEHOLDERS.length; i++) { names.push(IDC_PLACEHOLDERS[i][0]); }
+  return names.join(', ');
+}
+
+/*
+ * Umbruchzeichen (Spalte 0x0E, Rahmen 0x0F, Seite 0x10) verwirft InDesign,
+ * wenn sie ueber contents geschrieben werden (Live-Fund 05.09.2026: 110
+ * geschrieben, 107 gelesen). Sie werden deshalb aus dem Text genommen und
+ * nach dem Schreiben ueber insertionPoints als SpecialCharacters
+ * eingefuegt.
+ */
+var IDC_BREAK_ENUMS = {};
+IDC_BREAK_ENUMS['\u000E'] = 'COLUMN_BREAK';
+IDC_BREAK_ENUMS['\u000F'] = 'FRAME_BREAK';
+IDC_BREAK_ENUMS['\u0010'] = 'PAGE_BREAK';
+
+/* Text ohne Umbruchzeichen plus Liste {offset, name}; offset = Stelle im bereinigten Text. */
+function idcSplitBreaks(text) {
+  var s = String(text), plain = '', breaks = [], i, ch;
+  for (i = 0; i < s.length; i++) {
+    ch = s.charAt(i);
+    if (IDC.hasOwn(IDC_BREAK_ENUMS, ch)) { breaks.push({ offset: plain.length, name: IDC_BREAK_ENUMS[ch] }); }
+    else { plain += ch; }
+  }
+  return { plain: plain, breaks: breaks };
+}
+
+/* Umbruchzeichen an den gemerkten Stellen einfuegen (base = Story-Index des Textanfangs). */
+function idcInsertBreaks(textObject, base, breaks) {
+  var i, point;
+  if (breaks.length === 0) { return 0; }
+  if (typeof SpecialCharacters === 'undefined') {
+    IDC.fail('invalid_state', 'This runtime has no SpecialCharacters enumeration; column, frame and page breaks cannot be inserted.', null);
+  }
+  for (i = 0; i < breaks.length; i++) {
+    point = textObject.insertionPoints.item(base + breaks[i].offset + i);
+    point.contents = SpecialCharacters[breaks[i].name];
+  }
+  return breaks.length;
+}