layoutbridge-light 0.0.0-stage → 1.0.1

package/indesign/commands/47-anchored.js

@@ -0,0 +1,473 @@
+/* Wunschliste J2 Nr. 17 (Sitzung 8) – verankerte Objekte: anchor_frame_in_text, unanchor_frame. */
+
+var IDC_ANCHOR_POSITIONS = [
+  ['inline', 'INLINE_POSITION'],
+  ['above_line', 'ABOVE_LINE'],
+  ['custom', 'ANCHORED']
+];
+var IDC_ANCHOR_POINTS = [
+  ['top_left', 'TOP_LEFT_ANCHOR'], ['top_center', 'TOP_CENTER_ANCHOR'], ['top_right', 'TOP_RIGHT_ANCHOR'],
+  ['left_center', 'LEFT_CENTER_ANCHOR'], ['center', 'CENTER_ANCHOR'], ['right_center', 'RIGHT_CENTER_ANCHOR'],
+  ['bottom_left', 'BOTTOM_LEFT_ANCHOR'], ['bottom_center', 'BOTTOM_CENTER_ANCHOR'], ['bottom_right', 'BOTTOM_RIGHT_ANCHOR']
+];
+var IDC_H_REFERENCES = [
+  ['anchor_location', 'ANCHOR_LOCATION'], ['column_edge', 'COLUMN_EDGE'], ['text_frame', 'TEXT_FRAME'],
+  ['page_margins', 'PAGE_MARGINS'], ['page_edge', 'PAGE_EDGE']
+];
+var IDC_V_REFERENCES = [
+  ['line_baseline', 'LINE_BASELINE'], ['line_xheight', 'LINE_XHEIGHT'], ['line_ascent', 'LINE_ASCENT'],
+  ['cap_height', 'CAPHEIGHT'], ['top_of_leading', 'TOP_OF_LEADING'], ['embox_top', 'EMBOX_TOP'],
+  ['embox_middle', 'EMBOX_MIDDLE'], ['embox_bottom', 'EMBOX_BOTTOM'], ['column_edge', 'COLUMN_EDGE'],
+  ['text_frame', 'TEXT_FRAME'], ['page_margins', 'PAGE_MARGINS'], ['page_edge', 'PAGE_EDGE']
+];
+var IDC_H_ALIGNMENTS = [['left', 'LEFT_ALIGN'], ['center', 'CENTER_ALIGN'], ['right', 'RIGHT_ALIGN'], ['text', 'TEXT_ALIGN']];
+var IDC_ANCHOR_SPACE_MAX_MM = 1000;
+var IDC_V_ALIGNMENTS = [['top', 'TOP_ALIGN'], ['center', 'CENTER_ALIGN'], ['bottom', 'BOTTOM_ALIGN']];
+
+/* Enumeratorwert zu einem Namen aus einer Tabelle; null, wenn die Laufzeit den Enumerator nicht kennt. */
+function idcEnumFor(table, enumObject, name, field) {
+  var i;
+  for (i = 0; i < table.length; i++) {
+    if (table[i][0] === name) {
+      if (enumObject === null || enumObject === undefined) { return null; }
+      try { return enumObject[table[i][1]]; } catch (e) { return null; }
+    }
+  }
+  IDC.fail('invalid_argument', field + ' must be one of ' + idcTableNames(table).join(', ') + '.', { field: field, value: name });
+  return null;
+}
+
+function idcTableNames(table) {
+  var out = [], i;
+  for (i = 0; i < table.length; i++) { out.push(table[i][0]); }
+  return out;
+}
+
+/* Name zu einem Enumeratorwert; String(value), wenn kein Name passt. */
+function idcEnumName(table, enumObject, value) {
+  var i;
+  if (value === undefined || value === null) { return null; }
+  if (enumObject === null || enumObject === undefined) { 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);
+}
+
+/* Enumerator-Objekt der Laufzeit ueber seinen Namen, null wenn unbekannt (kein eval). */
+function idcEnumObject(name) {
+  if (name === 'AnchorPosition') { return typeof AnchorPosition === 'undefined' ? null : AnchorPosition; }
+  if (name === 'AnchorPoint') { return typeof AnchorPoint === 'undefined' ? null : AnchorPoint; }
+  if (name === 'AnchoredRelativeTo') { return typeof AnchoredRelativeTo === 'undefined' ? null : AnchoredRelativeTo; }
+  if (name === 'VerticallyRelativeTo') { return typeof VerticallyRelativeTo === 'undefined' ? null : VerticallyRelativeTo; }
+  if (name === 'HorizontalAlignment') { return typeof HorizontalAlignment === 'undefined' ? null : HorizontalAlignment; }
+  if (name === 'VerticalAlignment') { return typeof VerticalAlignment === 'undefined' ? null : VerticalAlignment; }
+  return null;
+}
+
+/* Verankert? Der parent eines verankerten Objekts ist eine Textstelle. */
+function idcAnchorInfo(item) {
+  var parent = null, name = '', settings = null;
+  var out = { story_id: null, index: null, position: null };
+  try { parent = item.parent; } catch (e0) { return null; }
+  if (parent === null || parent === undefined) { return null; }
+  name = IDC.className(parent);
+  if (name !== 'Character' && name !== 'InsertionPoint' && name !== 'Text' && name !== 'Word' && name !== 'Line' && name !== 'Paragraph' && name !== 'TextStyleRange') {
+    return null;
+  }
+  try { out.story_id = Number(parent.parentStory.id); } catch (e1) { /* null */ }
+  try { out.index = Number(parent.index); } catch (e2) { /* null */ }
+  try { settings = item.anchoredObjectSettings; } catch (e3) { settings = null; }
+  if (settings !== null && settings !== undefined) {
+    try { out.position = idcEnumName(IDC_ANCHOR_POSITIONS, idcEnumObject('AnchorPosition'), settings.anchoredPosition); } catch (e4) { /* null */ }
+  }
+  return out;
+}
+
+function idcDescribeAnchoredSettings(item) {
+  var settings = null;
+  var out = { position: null, anchor_point: null, horizontal_reference: null, vertical_reference: null,
+    horizontal_alignment: null, vertical_alignment: null, offset_mm: { x: null, y: null }, keep_within_frame: null, lock_position: null,
+    space_before_mm: null, space_after_mm: null };
+  try { settings = item.anchoredObjectSettings; } catch (e0) { settings = null; }
+  if (settings === null || settings === undefined) { return out; }
+  try { out.position = idcEnumName(IDC_ANCHOR_POSITIONS, idcEnumObject('AnchorPosition'), settings.anchoredPosition); } catch (e1) { /* null */ }
+  try { out.anchor_point = idcEnumName(IDC_ANCHOR_POINTS, idcEnumObject('AnchorPoint'), settings.anchorPoint); } catch (e2) { /* null */ }
+  try { out.horizontal_reference = idcEnumName(IDC_H_REFERENCES, idcEnumObject('AnchoredRelativeTo'), settings.horizontalReferencePoint); } catch (e3) { /* null */ }
+  try { out.vertical_reference = idcEnumName(IDC_V_REFERENCES, idcEnumObject('VerticallyRelativeTo'), settings.verticalReferencePoint); } catch (e4) { /* null */ }
+  try { out.horizontal_alignment = idcEnumName(IDC_H_ALIGNMENTS, idcEnumObject('HorizontalAlignment'), settings.horizontalAlignment); } catch (e5) { /* null */ }
+  try { out.vertical_alignment = idcEnumName(IDC_V_ALIGNMENTS, idcEnumObject('VerticalAlignment'), settings.verticalAlignment); } catch (e6) { /* null */ }
+  try { out.offset_mm.x = IDC.round(Number(settings.anchorXoffset), 3); } catch (e7) { /* null */ }
+  try { out.offset_mm.y = IDC.round(Number(settings.anchorYoffset), 3); } catch (e8) { /* null */ }
+  try { out.keep_within_frame = settings.pinPosition === true; } catch (e9) { /* null */ }
+  try { out.lock_position = settings.lockPosition === true; } catch (e10) { /* null */ }
+  /* A-67 Punkt 4 (Sitzung 72): Abstand davor/danach beim Objekt ueber der Zeile; anchorYoffset ist dort der Abstand danach. */
+  if (out.position === 'above_line') {
+    try { out.space_before_mm = IDC.round(Number(settings.anchorSpaceAbove), 3); } catch (e11) { /* null */ }
+    try { out.space_after_mm = IDC.round(Number(settings.anchorYoffset), 3); } catch (e12) { /* null */ }
+  }
+  return out;
+}
+
+/* Abstand in mm fuer above_line; null ohne Angabe. */
+function idcAnchorSpaceArg(value, field) {
+  if (value === undefined || value === null) { return null; }
+  if (typeof value !== 'number' || !isFinite(value) || value < -IDC_ANCHOR_SPACE_MAX_MM || value > IDC_ANCHOR_SPACE_MAX_MM) {
+    IDC.fail('invalid_argument', field + ' must be a number from ' + (-IDC_ANCHOR_SPACE_MAX_MM) + ' to ' + IDC_ANCHOR_SPACE_MAX_MM + ' (mm).', { field: field, value: value });
+  }
+  return value;
+}
+
+function idcOffsetArg(value, field) {
+  var out = { x: 0, y: 0 };
+  if (value === undefined || value === null) { return out; }
+  if (typeof value !== 'object') {
+    IDC.fail('invalid_argument', field + ' must be an object {x, y} in mm.', { field: field });
+  }
+  if (value.x !== undefined && value.x !== null) {
+    if (typeof value.x !== 'number' || !isFinite(value.x)) { IDC.fail('invalid_argument', field + '.x must be a number (mm).', { field: field }); }
+    out.x = value.x;
+  }
+  if (value.y !== undefined && value.y !== null) {
+    if (typeof value.y !== 'number' || !isFinite(value.y)) { IDC.fail('invalid_argument', field + '.y must be a number (mm).', { field: field }); }
+    out.y = value.y;
+  }
+  return out;
+}
+
+IDC.register('anchor_frame_in_text', { needs_document: true, read_only: false, ruler: 'page' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var found = idcFrameArg(doc, args, 'frame_id');
+    var item = found.item;
+    var target = idcTextFrameArg(doc, args, 'target_frame_id');
+    var story = idcStoryOf(target.item);
+    var position = args.position === undefined || args.position === null ? 'inline' : args.position;
+    var offset = idcOffsetArg(args.offset_mm, 'offset_mm');
+    var length = 0, index, insertionPoint, settings, anchoredItem = null, result, existing, landing, boundsMm = null;
+    var positionValue, value, spaceBefore, spaceAfter, aboveAlignment = null;
+
+    idcRejectGroupMember(item, args.frame_id, 'anchor_frame_in_text');
+    if (Number(item.id) === Number(target.item.id)) {
+      IDC.fail('invalid_argument', 'frame_id and target_frame_id must differ.', { frame_id: args.frame_id });
+    }
+    existing = idcAnchorInfo(item);
+    if (existing !== null) {
+      IDC.fail('invalid_state', 'Object ' + args.frame_id + ' is already anchored (story ' + existing.story_id + ', index ' + existing.index + '); use unanchor_frame first.',
+        { frame_id: args.frame_id, anchored: existing });
+    }
+    if (IDC.isTextFrame(item)) {
+      try {
+        if (Number(item.parentStory.id) === Number(story.id)) {
+          IDC.fail('invalid_state', 'The object is a frame of the target story itself.', { frame_id: args.frame_id });
+        }
+      } catch (e0) { if (e0 && e0.isIdcError) { throw e0; } }
+    }
+    try { length = Number(story.characters.length); } catch (e1) { length = 0; }
+    if (args.index === undefined || args.index === null) {
+      index = length;
+    } else {
+      if (typeof args.index !== 'number' || Math.floor(args.index) !== args.index || args.index < 0 || args.index > length) {
+        IDC.fail('invalid_argument', 'index must be a whole number from 0 to the story length (' + length + ').', { index: args.index, story_length: length });
+      }
+      index = args.index;
+    }
+    spaceBefore = idcAnchorSpaceArg(args.space_before_mm, 'space_before_mm');
+    spaceAfter = idcAnchorSpaceArg(args.space_after_mm, 'space_after_mm');
+    if (position === 'above_line' && idcGiven(args.horizontal_alignment)) {
+      aboveAlignment = idcEnumFor(IDC_H_ALIGNMENTS, idcEnumObject('HorizontalAlignment'), args.horizontal_alignment, 'horizontal_alignment');
+    }
+    positionValue = idcEnumFor(IDC_ANCHOR_POSITIONS, idcEnumObject('AnchorPosition'), position, 'position');
+    if (positionValue === null) {
+      IDC.fail('invalid_state', 'This runtime has no AnchorPosition enumeration.', null);
+    }
+
+    try { insertionPoint = story.insertionPoints.item(index); } catch (e2) {
+      IDC.fail('script_error', 'InDesign could not address insertion point ' + index + '.', { index: index });
+    }
+    try {
+      settings = item.anchoredObjectSettings;
+      anchoredItem = settings.insertAnchoredObject(insertionPoint, positionValue);
+    } catch (e3) {
+      IDC.fail('script_error', 'InDesign could not anchor object ' + args.frame_id + ': ' + String(e3.message ? e3.message : e3),
+        { frame_id: args.frame_id, target_frame_id: args.target_frame_id, index: index });
+    }
+    if (anchoredItem === null || anchoredItem === undefined) { anchoredItem = item; }
+    anchoredItem = IDC.concrete(anchoredItem);
+    try { settings = anchoredItem.anchoredObjectSettings; } catch (e4) { settings = null; }
+
+    if (settings !== null && position === 'custom') {
+      try {
+        if (args.anchor_point !== undefined && args.anchor_point !== null) {
+          value = idcEnumFor(IDC_ANCHOR_POINTS, idcEnumObject('AnchorPoint'), args.anchor_point, 'anchor_point');
+          if (value !== null) { settings.anchorPoint = value; }
+        }
+        if (args.horizontal_reference !== undefined && args.horizontal_reference !== null) {
+          value = idcEnumFor(IDC_H_REFERENCES, idcEnumObject('AnchoredRelativeTo'), args.horizontal_reference, 'horizontal_reference');
+          if (value !== null) { settings.horizontalReferencePoint = value; }
+        }
+        if (args.vertical_reference !== undefined && args.vertical_reference !== null) {
+          value = idcEnumFor(IDC_V_REFERENCES, idcEnumObject('VerticallyRelativeTo'), args.vertical_reference, 'vertical_reference');
+          if (value !== null) { settings.verticalReferencePoint = value; }
+        }
+        if (args.horizontal_alignment !== undefined && args.horizontal_alignment !== null) {
+          value = idcEnumFor(IDC_H_ALIGNMENTS, idcEnumObject('HorizontalAlignment'), args.horizontal_alignment, 'horizontal_alignment');
+          if (value !== null) { settings.horizontalAlignment = value; }
+        }
+        if (args.vertical_alignment !== undefined && args.vertical_alignment !== null) {
+          value = idcEnumFor(IDC_V_ALIGNMENTS, idcEnumObject('VerticalAlignment'), args.vertical_alignment, 'vertical_alignment');
+          if (value !== null) { settings.verticalAlignment = value; }
+        }
+        settings.anchorXoffset = offset.x;
+        settings.anchorYoffset = offset.y;
+        if (args.keep_within_frame !== undefined && args.keep_within_frame !== null) { settings.pinPosition = args.keep_within_frame === true; }
+        if (args.lock_position !== undefined && args.lock_position !== null) { settings.lockPosition = args.lock_position === true; }
+      } catch (e5) {
+        if (e5 && e5.isIdcError) { throw e5; }
+        ctx.warn('Some anchored object settings could not be written: ' + String(e5.message ? e5.message : e5));
+      }
+    } else if (position !== 'custom' && (args.offset_mm !== undefined || args.anchor_point !== undefined || args.horizontal_reference !== undefined || args.vertical_reference !== undefined)) {
+      ctx.warn('offset_mm, anchor_point and the reference/alignment parameters apply to position "custom" only; ignored.');
+    }
+    /*
+     * A-67 Punkt 4 (Sitzung 72): ueber der Zeile richtet InDesign das Objekt
+     * am Textbereich aus (horizontalAlignment) und fuehrt Abstand davor
+     * (anchorSpaceAbove) und danach (anchorYoffset) – live 28.10.2026.
+     */
+    if (settings !== null && position === 'above_line') {
+      try {
+        if (aboveAlignment !== null) { settings.horizontalAlignment = aboveAlignment; }
+        if (spaceBefore !== null) { settings.anchorSpaceAbove = spaceBefore; }
+        if (spaceAfter !== null) { settings.anchorYoffset = spaceAfter; }
+      } catch (e5b) {
+        ctx.warn('Some above-line settings could not be written: ' + String(e5b.message ? e5b.message : e5b));
+      }
+    } else if (spaceBefore !== null || spaceAfter !== null) {
+      ctx.warn('space_before_mm and space_after_mm apply to position "above_line" only; ignored.');
+    }
+
+    /*
+     * A-67 Punkt 4 (Sitzung 72): direkt nach dem Verankern nennt InDesign
+     * als parentPage eine Seite nahe dem Ende der Story (Probelauf 361 statt
+     * 9; Probe 28.10.2026: 12 statt 2) – erst nach dem Neuumbruch die
+     * richtige. Deshalb erst umbrechen, dann Seite und Lage lesen.
+     */
+    try { story.recompose(); } catch (e5c) { /* Lesen wie bisher */ }
+    landing = IDC.landing(anchoredItem);
+    try { boundsMm = idcItemBounds(doc, anchoredItem); } catch (e6) { boundsMm = null; }
+    result = {
+      frame_id: Number(anchoredItem.id),
+      previous_frame_id: Number(args.frame_id),
+      type: IDC.itemType(anchoredItem),
+      story_id: Number(story.id),
+      target_frame_id: Number(target.item.id),
+      index: index,
+      story_length: length + 1,
+      settings: idcDescribeAnchoredSettings(anchoredItem),
+      bounds_mm: boundsMm,
+      page_id: landing.page_id,
+      page_name: landing.page_name,
+      story_overset: idcOverflows(target.item)
+    };
+    try { result.story_overset = story.overflows === true; } catch (e7) { /* Rahmenwert bleibt */ }
+    if (Number(anchoredItem.id) !== Number(args.frame_id)) {
+      ctx.warn('InDesign gave the anchored object a new id (' + Number(anchoredItem.id) + '); use it from now on.');
+    }
+    idcWarnAnchoredOutsideFrame(ctx, doc, anchoredItem);
+    if (result.story_overset === true) {
+      ctx.warn('The story overflows after anchoring (Übersatz) – the object may sit in the overset text.');
+    }
+    ctx.changes = { modified_frame_ids: [Number(anchoredItem.id), Number(target.item.id)] };
+    return result;
+  });
+
+/*
+ * A-68 Befund, Sitzung 81: Ein Objekt ueber der Zeile kann oben aus seinem
+ * Textrahmen ragen (live 11.11.2026: Rahmen oben 15 mm, Objekt bei 4,4 mm,
+ * ohne Warnung). Vergleich der Oberkanten auf derselben Seite.
+ */
+function idcWarnAnchoredOutsideFrame(ctx, doc, item) {
+  var parent = null, frames = null, frame, ib, fb, li, lf;
+  try { parent = item.parent; frames = parent.parentTextFrames; } catch (e0) { return; }
+  if (!frames || frames.length === 0) { return; }
+  frame = IDC.concrete(frames[0]);
+  ib = idcItemBounds(doc, item);
+  fb = idcItemBounds(doc, frame);
+  if (ib === null || fb === null) { return; }
+  li = IDC.landing(item);
+  lf = IDC.landing(frame);
+  if (li.page_id === null || li.page_id !== lf.page_id) { return; }
+  if (ib.y < fb.y - 0.05) {
+    ctx.warn('The anchored object reaches ' + IDC.round(fb.y - ib.y, 2) + ' mm above the top of its text frame ' + Number(frame.id) + ' – above the line at the start of a frame the space before and the object height do not fit; it may overlap the content above. Reduce space_before_mm or move the anchor.');
+  }
+}
+
+IDC.register('unanchor_frame', { needs_document: true, read_only: false, ruler: 'page' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var found = idcFrameArg(doc, args, 'frame_id');
+    var item = found.item;
+    var info = idcAnchorInfo(item);
+    var released = null, landing, boundsMm = null, result;
+
+    if (info === null) {
+      IDC.fail('invalid_state', 'Object ' + args.frame_id + ' is not anchored in text.', { frame_id: args.frame_id });
+    }
+    /*
+     * Live 05.09.2026: releaseAnchoredObject() laesst inline und above_line
+     * still unveraendert (im Menue gibt es „Loesen“ nur fuer benutzerdefinierte
+     * Position). Deshalb erst auf custom umstellen, dann loesen.
+     */
+    try {
+      if (info.position !== 'custom' && typeof AnchorPosition !== 'undefined') {
+        item.anchoredObjectSettings.anchoredPosition = AnchorPosition.ANCHORED;
+      }
+      released = item.anchoredObjectSettings.releaseAnchoredObject();
+    } catch (e0) {
+      IDC.fail('script_error', 'InDesign could not release object ' + args.frame_id + ': ' + String(e0.message ? e0.message : e0), { frame_id: args.frame_id });
+    }
+    if (released === null || released === undefined) { released = item; }
+    released = IDC.concrete(released);
+    if (idcAnchorInfo(released) !== null) {
+      IDC.fail('invalid_state', 'InDesign did not release object ' + args.frame_id + '; it is still anchored.', { frame_id: args.frame_id, anchored: idcAnchorInfo(released) });
+    }
+    landing = IDC.landing(released);
+    try { boundsMm = idcItemBounds(doc, released); } catch (e1) { boundsMm = null; }
+    result = {
+      frame_id: Number(released.id),
+      previous_frame_id: Number(args.frame_id),
+      type: IDC.itemType(released),
+      was_anchored: info,
+      bounds_mm: boundsMm,
+      page_id: landing.page_id,
+      page_name: landing.page_name,
+      on_pasteboard: landing.on_pasteboard
+    };
+    if (Number(released.id) !== Number(args.frame_id)) {
+      ctx.warn('InDesign gave the released object a new id (' + Number(released.id) + '); use it from now on.');
+    }
+    ctx.changes = { modified_frame_ids: [Number(released.id)] };
+    return result;
+  });
+
+/* ------------------------------------------------ set_anchored_object_options */
+
+/*
+ * A-68 (6), Sitzung 81: Ankeroptionen eines schon verankerten Objekts
+ * aendern, ohne es zu loesen und neu zu verankern (Probe InDesign 21.6 am
+ * 11.11.2026: anchoredPosition laesst sich am verankerten Objekt von inline
+ * auf above_line und custom umstellen, das Objekt bleibt im Text;
+ * horizontalAlignment und anchorSpaceAbove wirken sofort). Parameter wie
+ * anchor_frame_in_text; was fehlt, bleibt.
+ */
+var IDC_ANCHOR_OPTION_KEYS = ['position', 'offset_mm', 'anchor_point', 'horizontal_reference', 'vertical_reference', 'horizontal_alignment',
+  'vertical_alignment', 'keep_within_frame', 'lock_position', 'space_before_mm', 'space_after_mm'];
+
+IDC.register('set_anchored_object_options', { needs_document: true, read_only: false, ruler: 'page' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var found = idcFrameArg(doc, args, 'frame_id');
+    var item = IDC.concrete(found.item);
+    var info = idcAnchorInfo(item);
+    var settings = null, position, positionEnum = null, given = false, i, value, ignored = [], story = null, landing, boundsMm = null, result;
+    var spaceBefore, spaceAfter, aboveAlignment = null, set = [];
+
+    if (info === null) {
+      IDC.fail('invalid_state', 'Object ' + args.frame_id + ' is not anchored in text; anchor it with anchor_frame_in_text.', { frame_id: args.frame_id, code: 'not_anchored' });
+    }
+    for (i = 0; i < IDC_ANCHOR_OPTION_KEYS.length; i++) {
+      if (idcGiven(args[IDC_ANCHOR_OPTION_KEYS[i]])) { given = true; }
+    }
+    if (!given) {
+      IDC.fail('invalid_argument', 'Pass at least one option: ' + IDC_ANCHOR_OPTION_KEYS.join(', ') + '.', null);
+    }
+    position = idcGiven(args.position) ? String(args.position) : info.position;
+    if (idcGiven(args.position)) {
+      positionEnum = idcEnumFor(IDC_ANCHOR_POSITIONS, idcEnumObject('AnchorPosition'), args.position, 'position');
+      if (positionEnum === null) { IDC.fail('invalid_state', 'This runtime has no AnchorPosition enumeration.', null); }
+    }
+    /* Alles vorher pruefen (Aufzaehlungen, Zahlen), dann schreiben. */
+    spaceBefore = idcAnchorSpaceArg(args.space_before_mm, 'space_before_mm');
+    spaceAfter = idcAnchorSpaceArg(args.space_after_mm, 'space_after_mm');
+    if (idcGiven(args.offset_mm)) { idcOffsetArg(args.offset_mm, 'offset_mm'); }
+    if (idcGiven(args.anchor_point)) { idcEnumFor(IDC_ANCHOR_POINTS, idcEnumObject('AnchorPoint'), args.anchor_point, 'anchor_point'); }
+    if (idcGiven(args.horizontal_reference)) { idcEnumFor(IDC_H_REFERENCES, idcEnumObject('AnchoredRelativeTo'), args.horizontal_reference, 'horizontal_reference'); }
+    if (idcGiven(args.vertical_reference)) { idcEnumFor(IDC_V_REFERENCES, idcEnumObject('VerticallyRelativeTo'), args.vertical_reference, 'vertical_reference'); }
+    if (idcGiven(args.horizontal_alignment)) { aboveAlignment = idcEnumFor(IDC_H_ALIGNMENTS, idcEnumObject('HorizontalAlignment'), args.horizontal_alignment, 'horizontal_alignment'); }
+    if (idcGiven(args.vertical_alignment)) { idcEnumFor(IDC_V_ALIGNMENTS, idcEnumObject('VerticalAlignment'), args.vertical_alignment, 'vertical_alignment'); }
+    if (idcGiven(args.keep_within_frame) && typeof args.keep_within_frame !== 'boolean') { IDC.fail('invalid_argument', 'keep_within_frame must be true or false.', null); }
+    if (idcGiven(args.lock_position) && typeof args.lock_position !== 'boolean') { IDC.fail('invalid_argument', 'lock_position must be true or false.', null); }
+
+    try { settings = item.anchoredObjectSettings; } catch (e0) { settings = null; }
+    if (settings === null || settings === undefined) {
+      IDC.fail('invalid_state', 'InDesign gives no anchored object settings for object ' + args.frame_id + '.', { frame_id: args.frame_id });
+    }
+    try {
+      if (positionEnum !== null) { settings.anchoredPosition = positionEnum; set.push('position'); }
+      if (position === 'custom') {
+        if (idcGiven(args.anchor_point)) { settings.anchorPoint = idcEnumFor(IDC_ANCHOR_POINTS, idcEnumObject('AnchorPoint'), args.anchor_point, 'anchor_point'); set.push('anchor_point'); }
+        if (idcGiven(args.horizontal_reference)) { settings.horizontalReferencePoint = idcEnumFor(IDC_H_REFERENCES, idcEnumObject('AnchoredRelativeTo'), args.horizontal_reference, 'horizontal_reference'); set.push('horizontal_reference'); }
+        if (idcGiven(args.vertical_reference)) { settings.verticalReferencePoint = idcEnumFor(IDC_V_REFERENCES, idcEnumObject('VerticallyRelativeTo'), args.vertical_reference, 'vertical_reference'); set.push('vertical_reference'); }
+        if (aboveAlignment !== null) { settings.horizontalAlignment = aboveAlignment; set.push('horizontal_alignment'); }
+        if (idcGiven(args.vertical_alignment)) { settings.verticalAlignment = idcEnumFor(IDC_V_ALIGNMENTS, idcEnumObject('VerticalAlignment'), args.vertical_alignment, 'vertical_alignment'); set.push('vertical_alignment'); }
+        if (idcGiven(args.offset_mm)) {
+          if (idcGiven(args.offset_mm.x)) { settings.anchorXoffset = args.offset_mm.x; }
+          if (idcGiven(args.offset_mm.y)) { settings.anchorYoffset = args.offset_mm.y; }
+          set.push('offset_mm');
+        }
+        if (idcGiven(args.keep_within_frame)) { settings.pinPosition = args.keep_within_frame === true; set.push('keep_within_frame'); }
+        if (idcGiven(args.lock_position)) { settings.lockPosition = args.lock_position === true; set.push('lock_position'); }
+        if (spaceBefore !== null) { ignored.push('space_before_mm'); }
+        if (spaceAfter !== null) { ignored.push('space_after_mm'); }
+      } else if (position === 'above_line') {
+        if (aboveAlignment !== null) { settings.horizontalAlignment = aboveAlignment; set.push('horizontal_alignment'); }
+        if (spaceBefore !== null) { settings.anchorSpaceAbove = spaceBefore; set.push('space_before_mm'); }
+        if (spaceAfter !== null) { settings.anchorYoffset = spaceAfter; set.push('space_after_mm'); }
+        for (i = 0; i < IDC_ANCHOR_OPTION_KEYS.length; i++) {
+          value = IDC_ANCHOR_OPTION_KEYS[i];
+          if (value !== 'position' && value !== 'horizontal_alignment' && value !== 'space_before_mm' && value !== 'space_after_mm' && idcGiven(args[value])) { ignored.push(value); }
+        }
+      } else {
+        for (i = 0; i < IDC_ANCHOR_OPTION_KEYS.length; i++) {
+          value = IDC_ANCHOR_OPTION_KEYS[i];
+          if (value !== 'position' && idcGiven(args[value])) { ignored.push(value); }
+        }
+      }
+    } catch (e1) {
+      if (e1 && e1.isIdcError) { throw e1; }
+      IDC.fail('script_error', 'InDesign could not change the anchored object settings of object ' + args.frame_id + ': ' + String(e1.message ? e1.message : e1),
+        { frame_id: args.frame_id, done: set });
+    }
+    if (ignored.length > 0) {
+      ctx.warn(ignored.join(', ') + ' do not apply to position "' + position + '" and were ignored (custom: offset, reference points, alignment, keep_within_frame, lock_position; above_line: horizontal_alignment, space_before_mm, space_after_mm).');
+    }
+
+    /* Wie anchor_frame_in_text: erst umbrechen, dann Seite und Lage lesen (A-67 Punkt 4). */
+    try { story = item.parent.parentStory; } catch (e2) { story = null; }
+    try { if (story !== null) { story.recompose(); } } catch (e3) { /* Lesen wie bisher */ }
+    landing = IDC.landing(item);
+    try { boundsMm = idcItemBounds(doc, item); } catch (e4) { boundsMm = null; }
+    result = {
+      frame_id: Number(item.id),
+      type: IDC.itemType(item),
+      story_id: info.story_id,
+      index: info.index,
+      applied: set,
+      settings: idcDescribeAnchoredSettings(item),
+      previous_position: info.position,
+      bounds_mm: boundsMm,
+      page_id: landing.page_id,
+      page_name: landing.page_name,
+      story_overset: null
+    };
+    try { if (story !== null) { result.story_overset = story.overflows === true; } } catch (e5) { /* null */ }
+    idcWarnAnchoredOutsideFrame(ctx, doc, item);
+    if (result.story_overset === true) {
+      ctx.warn('The story overflows after the change (Übersatz) – the object may sit in the overset text; autoflow_story adds pages.');
+    }
+    ctx.changes = { modified_frame_ids: [Number(item.id)] };
+    return result;
+  });