layoutbridge-spm 0.0.1 → 1.0.0

package/indesign/commands/50-modify.js

@@ -0,0 +1,781 @@
+/* Bereich E – Rahmen und Objekte veraendern. */
+
+/* Objekt, das kein Gruppenmitglied ist; sonst invalid_state. */
+function idcRejectGroupMember(item, frameId, what) {
+  var parentName = '';
+  try { parentName = IDC.className(item.parent); } catch (e) { parentName = ''; }
+  if (parentName === 'Group') {
+    IDC.fail('invalid_state', 'Object ' + frameId + ' is inside a group; ' + what + ' works on the group as a whole (its parent group id is ' +
+      String(item.parent.id) + ').', { frame_id: frameId, parent_group_id: Number(item.parent.id) });
+  }
+}
+
+/* Textrahmen verlangen, sonst invalid_state. */
+function idcTextFrameArg(doc, args, field) {
+  var found = idcFrameArg(doc, args, field);
+  if (!IDC.isTextFrame(found.item)) {
+    IDC.fail('invalid_state', 'Object ' + args[field] + ' is not a text frame (it is a ' + IDC.itemType(found.item) + ').',
+      { frame_id: args[field], type: IDC.itemType(found.item) });
+  }
+  return found;
+}
+
+function idcRotationOf(item) {
+  try { return IDC.round(Number(item.rotationAngle), 3); } catch (e) { return null; }
+}
+
+/* Seite, auf der ein Objekt liegt (Dokument- oder Musterseite), sonst null. */
+function idcPageOfItem(doc, item) {
+  var landing = IDC.landing(item);
+  var found;
+  if (landing.on_pasteboard) { return null; }
+  found = IDC.pageById(doc, landing.page_id);
+  return found === null ? null : found.page;
+}
+
+/* Begrenzung unter Bogen-Nullpunkt schreiben (E-28). Nur der Rahmen – eine platzierte Grafik bleibt liegen. */
+function idcWriteSpreadBounds(doc, item, spreadBounds) {
+  IDC.withRulerOrigin(doc, RulerOrigin.SPREAD_ORIGIN, function () {
+    item.geometricBounds = spreadBounds;
+  });
+}
+
+/*
+ * Objekt um dx/dy mm verschieben – ueber move(), damit eine platzierte
+ * Grafik mitwandert. geometricBounds allein verschiebt nur den Rahmen und
+ * beschneidet das Bild neu (Live-Fund 04.09.2026, Integrationssuite).
+ */
+function idcMoveBy(doc, item, dx, dy) {
+  if (Math.abs(dx) < 0.0005 && Math.abs(dy) < 0.0005) { return; }
+  IDC.withRulerOrigin(doc, RulerOrigin.SPREAD_ORIGIN, function () {
+    item.move(undefined, [dx, dy]);
+  });
+}
+
+/*
+ * Zielbegrenzung (Bogenkoordinaten [y1, x1, y2, x2]) setzen: erst die Lage
+ * per move() (Inhalt geht mit), dann bei geaenderter Groesse die Begrenzung.
+ */
+function idcPlaceSpreadBounds(doc, item, spreadBounds) {
+  var current = IDC.withRulerOrigin(doc, RulerOrigin.SPREAD_ORIGIN, function () { return item.geometricBounds; });
+  var dx = spreadBounds[1] - current[1];
+  var dy = spreadBounds[0] - current[0];
+  var resized = Math.abs((spreadBounds[3] - spreadBounds[1]) - (current[3] - current[1])) > 0.0005
+    || Math.abs((spreadBounds[2] - spreadBounds[0]) - (current[2] - current[0])) > 0.0005;
+  idcMoveBy(doc, item, dx, dy);
+  if (resized) { idcWriteSpreadBounds(doc, item, spreadBounds); }
+  return resized;
+}
+
+/* --------------------------------------------------------- set_frame_bounds */
+
+IDC.register('set_frame_bounds', { 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 rect = idcBoundsArg(args.bounds_mm, 'bounds_mm');
+    var type = IDC.itemType(item);
+    var page = null, pageFound, itemSpread, pageSpread, rotation, landing, bounds;
+
+    if (type === 'group') {
+      IDC.fail('invalid_state', 'Object ' + args.frame_id + ' is a group; set_frame_bounds would move the frames without their graphics. Use move_frame_to_page (also for a position on the same page) or address the members.',
+        { frame_id: args.frame_id, type: 'group' });
+    }
+    idcRejectGroupMember(item, args.frame_id, 'set_frame_bounds');
+
+    if (args.page_id !== undefined && args.page_id !== null) {
+      pageFound = idcAnyPageById(doc, args.page_id);
+      page = pageFound.page;
+      itemSpread = IDC.spreadOfItem(item);
+      try { pageSpread = page.parent; } catch (e0) { pageSpread = null; }
+      if (itemSpread !== null && pageSpread !== null && Number(itemSpread.id) !== Number(pageSpread.id)) {
+        IDC.fail('invalid_argument', 'page_id ' + args.page_id + ' lies on another spread (Druckbogen) than object ' + args.frame_id +
+          '. set_frame_bounds never changes the spread – use move_frame_to_page.', { frame_id: args.frame_id, page_id: args.page_id });
+      }
+    }
+
+    rotation = idcRotationOf(item);
+    if (rotation !== null && rotation !== 0) {
+      ctx.warn('Object ' + args.frame_id + ' is rotated by ' + rotation + ' degrees; the bounds apply in its rotated space. Set set_frame_rotation 0 first for page-aligned values.');
+    }
+
+    /* Stand vor dem Eingriff: Seite und Uebersatz (Vermerk E-63). */
+    var pageBefore = IDC.landing(item);
+    var recBefore = idcRecomposeBefore(doc, item);
+    var resized = false;
+    try {
+      resized = idcPlaceSpreadBounds(doc, item, idcToSpreadBounds(page, idcRectToBounds(rect), page === null ? 'spread' : 'page'));
+    } catch (e) {
+      IDC.fail('script_error', 'InDesign could not set the bounds of object ' + args.frame_id + ': ' + String(e.message ? e.message : e),
+        { frame_id: args.frame_id, bounds_mm: rect });
+    }
+
+    var rec = idcRecomposeAfter(ctx, doc, recBefore);
+    landing = IDC.landing(item);
+    /*
+     * Ohne page_id sind die Werte Bogenkoordinaten. Wer seitenrelativ gelesene
+     * Werte unveraendert zurueckgibt, verschiebt den Rahmen auf die Nachbarseite
+     * - deshalb eine Warnung, sobald der Rahmen dabei die Seite wechselt (E-63).
+     */
+    if (page === null && pageBefore.on_pasteboard !== true && landing.on_pasteboard !== true
+      && landing.page_id !== pageBefore.page_id) {
+      ctx.warn('Object ' + args.frame_id + ' moved from page ' + pageBefore.page_name + ' to page ' + landing.page_name +
+        '; without page_id bounds_mm are spread coordinates (Druckbogen). Values from get_page_state, get_frame_options, get_selection or get_image_link_info are page coordinates (coordinate_space "page") - pass page_id to use them unchanged.');
+    }
+    if (page !== null) {
+      idcCheckLanding(ctx, item, page, IDC.itemType(item) === 'text' ? 'text frame' : 'object');
+      bounds = IDC.boundsOnPage(doc, item, page);
+    } else {
+      bounds = IDC.boundsOnPage(doc, item, null);
+    }
+    if (type === 'image' && resized) {
+      ctx.warn('The frame holds a graphic and was resized; the graphic keeps its position and scale (new crop) – place it again or run scale_image_in_frame / get_image_link_info to check.');
+    }
+
+    ctx.changes = { modified_frame_ids: [Number(item.id)] };
+    return {
+      frame_id: Number(item.id),
+      type: type,
+      bounds_mm: bounds,
+      coordinate_space: page === null ? 'spread' : 'page',
+      page_id: page === null ? null : Number(page.id),
+      rotation_deg: rotation,
+      resized: resized,
+      landed_on_page_id: landing.page_id,
+      landed_on_page_name: landing.page_name,
+      on_parent_page: found.on_parent,
+      recomposed: rec.recomposed,
+      overset_stories_before: rec.overset_stories_before,
+      overset_stories_after: rec.overset_stories_after,
+      overset_changed: rec.overset_changed
+    };
+  });
+
+/* ------------------------------------------------------- move_frame_to_page */
+
+/*
+ * Sitzung 24 (Befund aus dem Praxiseinsatz, E-79): Ziel Montageflaeche neben dem
+ * Bogen der Zielseite – pasteboard {side, gap_mm, y_mm}. side left: links
+ * von der linken Seite des Bogens, right: rechts von der rechten; gap_mm ist
+ * der Abstand zwischen Objekt und Seitenkante.
+ */
+function idcPasteboardTargetArg(spec) {
+  if (!spec || typeof spec !== 'object') {
+    IDC.fail('invalid_argument', 'pasteboard must be an object { side, gap_mm, y_mm }.', null);
+  }
+  if (spec.side !== 'left' && spec.side !== 'right') {
+    IDC.fail('invalid_argument', 'pasteboard.side must be "left" or "right".', { side: spec.side });
+  }
+  if (typeof spec.gap_mm !== 'number' || !isFinite(spec.gap_mm) || spec.gap_mm < 0) {
+    IDC.fail('invalid_argument', 'pasteboard.gap_mm must be a number of 0 or more (mm).', { gap_mm: spec.gap_mm });
+  }
+  if (spec.y_mm !== undefined && spec.y_mm !== null && (typeof spec.y_mm !== 'number' || !isFinite(spec.y_mm))) {
+    IDC.fail('invalid_argument', 'pasteboard.y_mm must be a number (mm from the top of the page).', { y_mm: spec.y_mm });
+  }
+  return { side: spec.side, gap_mm: spec.gap_mm, y_mm: spec.y_mm === undefined ? null : spec.y_mm };
+}
+
+/* Breite aller Seiten des Bogens einer Seite in mm. */
+function idcSpreadWidthOfPage(page) {
+  var spread = page.parent;
+  var i, width = 0;
+  for (i = 0; i < spread.pages.length; i++) { width += IDC.pageSize(spread.pages.item(i)).width; }
+  return width;
+}
+
+IDC.register('move_frame_to_page', { 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 pageFound = idcAnyPageById(doc, args.page_id);
+    var page = pageFound.page;
+    var oldId = Number(item.id);
+    var idPreserved = true;
+    var position = null;
+    var pasteboard = null;
+    var before, rotation, moved, copy, landing, bounds, target;
+
+    idcRejectGroupMember(item, args.frame_id, 'move_frame_to_page');
+    if (args.position_mm !== undefined && args.position_mm !== null) { position = idcPointArg(args.position_mm, 'position_mm'); }
+    if (args.pasteboard !== undefined && args.pasteboard !== null) {
+      pasteboard = idcPasteboardTargetArg(args.pasteboard);
+      if (position !== null) {
+        IDC.fail('invalid_argument', 'Pass either position_mm or pasteboard, not both (pasteboard.y_mm sets the height).', null);
+      }
+    }
+
+    rotation = idcRotationOf(item);
+    if (rotation !== null && rotation !== 0) {
+      ctx.warn('Object ' + args.frame_id + ' is rotated by ' + rotation + ' degrees; set set_frame_rotation 0 before moving for predictable coordinates.');
+    }
+
+    var recBeforeMove = idcRecomposeBefore(doc, item);
+    /* Position wie auf der alten Seite: relativ zur Seite, auf der InDesign das Objekt fuehrt (Montageflaeche: Bogen). */
+    before = IDC.boundsOnOwnPage(doc, item);
+    target = position === null ? { x: before.x, y: before.y } : position;
+
+    /* Erst die DOM-Methode move() – nur so gehen die Grafiken einer Gruppe mit. */
+    try {
+      moved = item.move(page);
+      if (IDC.isArray(moved)) { moved = moved[0]; }
+      if (moved !== undefined && moved !== null) { moved = IDC.concrete(moved); }
+      else { moved = item; }
+    } catch (e) {
+      /* Rueckfall: Duplizieren auf die Seite und Original loeschen – neue ID. */
+      try {
+        copy = item.duplicate(page);
+        if (IDC.isArray(copy)) { copy = copy[0]; }
+        copy = IDC.concrete(copy);
+        item.remove();
+        moved = copy;
+        idPreserved = false;
+        ctx.warn('InDesign could not move object ' + args.frame_id + ' directly (' + String(e.message ? e.message : e) +
+          '); it was duplicated onto page ' + String(page.name) + ' and the original removed – the object has a new id.');
+      } catch (e2) {
+        IDC.fail('script_error', 'InDesign could not move object ' + args.frame_id + ' to page ' + String(page.name) + ': ' +
+          String(e.message ? e.message : e) + ' / fallback: ' + String(e2.message ? e2.message : e2), { frame_id: args.frame_id, page_id: args.page_id });
+      }
+    }
+    item = moved;
+    try { if (Number(item.id) !== oldId) { idPreserved = false; } } catch (e3) { /* egal */ }
+
+    /* Zielposition seitenrelativ setzen: Groesse bleibt, x/y unter Bogen-Nullpunkt (E-28). */
+    try {
+      bounds = IDC.boundsOnPage(doc, item, page);
+      if (pasteboard !== null) {
+        /* Neben dem Bogen: links von dessen linker Seite oder rechts von dessen rechter (Werte relativ zu page). */
+        if (pasteboard.side === 'left') { target.x = -IDC.spreadOffsetOfPage(page) - pasteboard.gap_mm - bounds.width; }
+        else { target.x = idcSpreadWidthOfPage(page) - IDC.spreadOffsetOfPage(page) + pasteboard.gap_mm; }
+        if (pasteboard.y_mm !== null) { target.y = pasteboard.y_mm; }
+      }
+      /* Per move(): nur so wandert eine platzierte Grafik mit (Live-Fund 04.09.2026). */
+      idcMoveBy(doc, item, target.x - bounds.x, target.y - bounds.y);
+    } catch (e4) {
+      ctx.warn('The object was moved to page ' + String(page.name) + ' but could not be positioned at ' + target.x + '/' + target.y + ' mm: ' +
+        String(e4.message ? e4.message : e4));
+    }
+
+    var recMove = idcRecomposeAfter(ctx, doc, recBeforeMove);
+    if (pasteboard !== null) {
+      landing = IDC.landing(item);
+      if (!landing.on_pasteboard) {
+        ctx.warn('The object was meant for the pasteboard (Montageflaeche) but InDesign assigns it to page ' + landing.page_name +
+          ' – its centre lies on that page. Check the size of the object and gap_mm.');
+      }
+    } else {
+      landing = idcCheckLanding(ctx, item, page, IDC.itemType(item) === 'text' ? 'text frame' : 'object');
+      if (landing.on_pasteboard || landing.page_id !== Number(page.id)) {
+        ctx.warn('InDesign assigns an object to the page holding its centre; for a half-page bleed object set the bounds in spread coordinates with set_frame_bounds without page_id.');
+      }
+    }
+
+    ctx.changes = idPreserved
+      ? { modified_frame_ids: [Number(item.id)] }
+      : { removed_frame_ids: [oldId], created_frame_ids: [Number(item.id)], modified_frame_ids: [] };
+    return {
+      frame_id: Number(item.id),
+      previous_frame_id: oldId,
+      id_preserved: idPreserved,
+      type: IDC.itemType(item),
+      page_id: Number(page.id),
+      bounds_mm: IDC.boundsOnPage(doc, item, page),
+      landed_on_page_id: landing.page_id,
+      landed_on_page_name: landing.page_name,
+      on_pasteboard: landing.on_pasteboard,
+      pasteboard_side: pasteboard === null ? null : pasteboard.side,
+      on_parent_page: pageFound.is_parent_page,
+      coordinate_space: 'page',
+      recomposed: recMove.recomposed,
+      overset_stories_before: recMove.overset_stories_before,
+      overset_stories_after: recMove.overset_stories_after,
+      overset_changed: recMove.overset_changed
+    };
+  });
+
+/* ------------------------------------------------------- set_frame_rotation */
+
+IDC.register('set_frame_rotation', { 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 wanted = args.angle_deg;
+    var current, delta, matrix, after;
+
+    if (typeof wanted !== 'number' || !isFinite(wanted) || wanted < -360 || wanted > 360) {
+      IDC.fail('invalid_argument', 'angle_deg must be a number between -360 and 360 (absolute, positive = counterclockwise).', { angle_deg: wanted });
+    }
+    current = idcRotationOf(item);
+    if (current === null) {
+      IDC.fail('invalid_state', 'Object ' + args.frame_id + ' has no rotation angle.', { frame_id: args.frame_id });
+    }
+    delta = wanted - current;
+
+    /*
+     * Um den Mittelpunkt drehen: transform() mit dem Anker CENTER_ANCHOR und
+     * einer Drehmatrix um die Differenz. rotationAngle allein dreht um den
+     * Bezugspunkt der Palette, nicht sicher um die Mitte.
+     */
+    try {
+      if (Math.abs(delta) > 0.0005) {
+        matrix = app.transformationMatrices.add({ counterclockwiseRotationAngle: delta });
+        item.transform(CoordinateSpaces.PASTEBOARD_COORDINATES, AnchorPoint.CENTER_ANCHOR, matrix);
+      }
+    } catch (e) {
+      try {
+        item.rotationAngle = wanted;
+        ctx.warn('transform() failed (' + String(e.message ? e.message : e) + '); rotationAngle was set directly, which may rotate around the reference point instead of the centre.');
+      } catch (e2) {
+        IDC.fail('script_error', 'InDesign could not rotate object ' + args.frame_id + ': ' + String(e2.message ? e2.message : e2), { frame_id: args.frame_id });
+      }
+    }
+
+    after = idcRotationOf(item);
+    if (after !== null && Math.abs(((after - wanted) % 360 + 360) % 360) > 0.01 && Math.abs(((after - wanted) % 360 + 360) % 360 - 360) > 0.01) {
+      ctx.warn('The rotation reads ' + after + ' degrees after setting ' + wanted + '.');
+    }
+    var landing = IDC.landing(item);
+    ctx.changes = { modified_frame_ids: [Number(item.id)] };
+    return {
+      frame_id: Number(item.id),
+      angle_deg: after,
+      previous_angle_deg: current,
+      bounds_mm: idcItemBounds(doc, item),
+      landed_on_page_id: landing.page_id,
+      landed_on_page_name: landing.page_name
+    };
+  });
+
+/* ------------------------------------------------------- set_frame_stacking */
+
+IDC.register('set_frame_stacking', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var found = idcFrameArg(doc, args, 'frame_id');
+    var item = found.item;
+    var action = args.action;
+    var actions = { bring_to_front: 1, send_to_back: 1, bring_forward: 1, send_backward: 1 };
+
+    if (typeof action !== 'string' || !IDC.hasOwn(actions, action)) {
+      IDC.fail('invalid_argument', 'action must be bring_to_front, send_to_back, bring_forward or send_backward.', { action: action });
+    }
+    try {
+      if (action === 'bring_to_front') { item.bringToFront(); }
+      else if (action === 'send_to_back') { item.sendToBack(); }
+      else if (action === 'bring_forward') { item.bringForward(); }
+      else { item.sendBackward(); }
+    } catch (e) {
+      IDC.fail('script_error', 'InDesign could not change the stacking of object ' + args.frame_id + ': ' + String(e.message ? e.message : e),
+        { frame_id: args.frame_id, action: action });
+    }
+    var layerName = null;
+    try { layerName = String(item.itemLayer.name); } catch (e2) { layerName = null; }
+    /*
+     * Die Stapelfolge ist ueber die Sammlungen nicht ablesbar: pageItems
+     * liefert nach Objektart gruppiert, index zaehlt je Art. Geprueft am
+     * 04.09.2026 ueber den PDF-Export (rot vor blau nach bring_to_front).
+     */
+    ctx.changes = { modified_frame_ids: [Number(item.id)] };
+    return { frame_id: Number(item.id), action: action, layer: layerName };
+  });
+
+/* ----------------------------------------------------- set_frame_appearance */
+
+/* "#RRGGBB" | "none" pruefen; Farbfeldnamen wie "Paper" werden abgewiesen. */
+function idcColourArg(value, field) {
+  var text;
+  if (value === undefined || value === null) { return null; }
+  text = String(value);
+  if (text.toLowerCase() === 'none') { return 'none'; }
+  if (!/^#?[0-9a-fA-F]{6}$/.test(text)) {
+    IDC.fail('invalid_argument', field + ' must be a hex colour like "#1A2B3C" or "none"; swatch names such as "' + text + '" are not accepted.', { value: text });
+  }
+  return text;
+}
+
+IDC.register('set_frame_appearance', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var found = idcFrameArg(doc, args, 'frame_id');
+    var item = found.item;
+    var fill = idcColourArg(args.fill, 'fill');
+    var stroke = idcColourArg(args.stroke, 'stroke');
+    var weight = null;
+    var swatchIds = [];
+    var none, fillSwatch = null, strokeSwatch = null, look;
+    var fillName = args.fill_swatch_name, strokeName = args.stroke_swatch_name;
+
+    idcBothGiven(args, 'fill', 'fill_swatch_name');
+    idcBothGiven(args, 'stroke', 'stroke_swatch_name');
+    if (fillName !== undefined && fillName !== null) { fillSwatch = idcSwatchArg(doc, fillName, 'fill_swatch_name'); fill = 'swatch'; }
+    if (strokeName !== undefined && strokeName !== null) { strokeSwatch = idcSwatchArg(doc, strokeName, 'stroke_swatch_name'); stroke = 'swatch'; }
+
+    if (args.stroke_weight_pt !== undefined && args.stroke_weight_pt !== null) {
+      if (typeof args.stroke_weight_pt !== 'number' || !isFinite(args.stroke_weight_pt) || args.stroke_weight_pt < 0) {
+        IDC.fail('invalid_argument', 'stroke_weight_pt must be a number of 0 or more (points).', { stroke_weight_pt: args.stroke_weight_pt });
+      }
+      weight = args.stroke_weight_pt;
+    }
+    /* A-8.5: Farbton und Verlaufswinkel. */
+    var fillTint = idcTintArg(args.fill_tint_percent, 'fill_tint_percent');
+    var strokeTint = idcTintArg(args.stroke_tint_percent, 'stroke_tint_percent');
+    var fillAngle = idcAngleArg(args.gradient_fill_angle_deg, 'gradient_fill_angle_deg');
+    var strokeAngle = idcAngleArg(args.gradient_stroke_angle_deg, 'gradient_stroke_angle_deg');
+    if (fill === null && stroke === null && weight === null && fillTint === null && strokeTint === null && fillAngle === null && strokeAngle === null) {
+      IDC.fail('invalid_argument', 'Pass at least one of fill, fill_swatch_name, stroke, stroke_swatch_name, stroke_weight_pt, fill_tint_percent, stroke_tint_percent, gradient_fill_angle_deg or gradient_stroke_angle_deg.', null);
+    }
+    if (IDC.itemType(item) === 'group') {
+      IDC.fail('invalid_state', 'Object ' + args.frame_id + ' is a group; set fill and stroke on its members.', { frame_id: args.frame_id, type: 'group' });
+    }
+
+    none = idcNoneSwatch(doc);
+    if (fill !== null && fill !== 'none' && fill !== 'swatch') { fillSwatch = idcSwatchForHex(doc, fill, 'fill', swatchIds); }
+    if (stroke !== null && stroke !== 'none' && stroke !== 'swatch') { strokeSwatch = idcSwatchForHex(doc, stroke, 'stroke', swatchIds); }
+
+    /* stroke "none" setzt zusaetzlich die Staerke 0 – nur die Staerke entfernt die Kontur sicher im Export. */
+    if (stroke === 'none') {
+      if (weight !== null && weight > 0) {
+        ctx.warn('stroke "none" forces stroke_weight_pt 0; the given ' + weight + ' pt was not applied.');
+      }
+      weight = 0;
+    }
+    if (strokeSwatch !== null && weight === null) {
+      try {
+        var currentWeight = IDC.inPoints(function () { return Number(item.strokeWeight); });
+        if (!(currentWeight > 0)) {
+          weight = 1;
+          ctx.warn('The object had no stroke weight; stroke_weight_pt 1 was applied together with the stroke colour.');
+        }
+      } catch (ew) { /* Staerke bleibt */ }
+    }
+
+    /* Reihenfolge: Staerke, Konturfarbe, Flaeche (Live-Fund Sitzung 3). */
+    try {
+      if (weight !== null) { idcSetStrokeWeightPt(item, weight); }
+      if (stroke === 'none' && none !== null) { item.strokeColor = none; }
+      else if (strokeSwatch !== null) { item.strokeColor = strokeSwatch; }
+      if (fill === 'none' && none !== null) { item.fillColor = none; }
+      else if (fillSwatch !== null) { item.fillColor = fillSwatch; }
+      idcApplyTintsAndAngles(ctx, item, fillTint, strokeTint, fillAngle, strokeAngle);
+    } catch (e) {
+      if (e && e.isIdcError) { throw e; }
+      IDC.fail('script_error', 'InDesign could not change the appearance of object ' + args.frame_id + ': ' + String(e.message ? e.message : e),
+        { frame_id: args.frame_id });
+    }
+
+    look = idcAppearanceFull(item);
+    if (weight === 0 && look.stroke_weight_pt !== null && look.stroke_weight_pt > 0) {
+      ctx.warn('The stroke weight still reads ' + look.stroke_weight_pt + ' pt; check the export.');
+    }
+    ctx.changes = { modified_frame_ids: [Number(item.id)], created_swatch_ids: swatchIds };
+    return {
+      frame_id: Number(item.id),
+      applied_fill: look.fill_color,
+      applied_stroke: look.stroke_color,
+      applied_stroke_weight_pt: look.stroke_weight_pt,
+      swatch_ids: swatchIds,
+      fill_kind: look.fill_kind,
+      stroke_kind: look.stroke_kind,
+      fill_tint_percent: look.fill_tint_percent,
+      stroke_tint_percent: look.stroke_tint_percent,
+      gradient_fill_angle_deg: look.gradient_fill_angle_deg,
+      gradient_stroke_angle_deg: look.gradient_stroke_angle_deg,
+      gradient_fill_start_mm: look.gradient_fill_start_mm,
+      gradient_fill_length_mm: look.gradient_fill_length_mm
+    };
+  });
+
+/* -------------------------------------------------------- set_frame_columns */
+
+IDC.register('set_frame_columns', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var found = idcTextFrameArg(doc, args, 'frame_id');
+    var frame = found.item;
+    var count = args.count;
+    /* Ohne gutter_mm bleibt der Steg des Rahmens (G-2); InDesigns eigene Vorgabe fuer neue Rahmen ist 1 Pica. */
+    var gutter = args.gutter_mm === undefined || args.gutter_mm === null ? null : args.gutter_mm;
+    var prefs;
+
+    if (args.column_count !== undefined) {
+      IDC.fail('invalid_argument', 'The parameter is called count, not column_count.', { column_count: args.column_count });
+    }
+    if (typeof count !== 'number' || count < 1 || Math.floor(count) !== count) {
+      IDC.fail('invalid_argument', 'count must be a whole number of 1 or more.', { count: count });
+    }
+    if (gutter !== null && (typeof gutter !== 'number' || !isFinite(gutter) || gutter < 0)) {
+      IDC.fail('invalid_argument', 'gutter_mm must be a number of 0 or more.', { gutter_mm: gutter });
+    }
+    try {
+      prefs = frame.textFramePreferences;
+      /* Feste Spaltenzahl: beide Breitenschalter aus (Adobe-DOM: useFixedColumnWidth, useFlexibleColumnWidth). */
+      try { prefs.useFlexibleColumnWidth = false; } catch (e0a) { /* kennt die Laufzeit nicht */ }
+      try { prefs.useFixedColumnWidth = false; } catch (e0b) { /* kennt die Laufzeit nicht */ }
+      prefs.textColumnCount = count;
+      if (gutter !== null) { prefs.textColumnGutter = gutter; }
+    } catch (e) {
+      IDC.fail('script_error', 'InDesign could not set the columns of text frame ' + args.frame_id + ': ' + String(e.message ? e.message : e),
+        { frame_id: args.frame_id });
+    }
+    var countBack = null, gutterBack = null;
+    try { countBack = Number(prefs.textColumnCount); } catch (e1) { countBack = null; }
+    try { gutterBack = IDC.round(Number(prefs.textColumnGutter)); } catch (e2) { gutterBack = null; }
+    ctx.changes = { modified_frame_ids: [Number(frame.id)] };
+    return { frame_id: Number(frame.id), count: countBack, gutter_mm: gutterBack };
+  });
+
+/* ---------------------------------------------------------- set_frame_inset */
+
+function idcEdgeObjectArg(spec, field, allowMissing) {
+  var keys = ['top', 'left', 'bottom', 'right'];
+  var out = {};
+  var i, v;
+  if (!spec || typeof spec !== 'object') {
+    IDC.fail('invalid_argument', field + ' must be an object { top, left, bottom, right }.', null);
+  }
+  for (i = 0; i < keys.length; i++) {
+    v = spec[keys[i]];
+    if (v === undefined || v === null) {
+      if (allowMissing) { out[keys[i]] = null; continue; }
+      IDC.fail('invalid_argument', field + '.' + keys[i] + ' is required.', spec);
+    }
+    if (typeof v !== 'number' || !isFinite(v) || v < 0) {
+      IDC.fail('invalid_argument', field + '.' + keys[i] + ' must be a number of 0 or more.', spec);
+    }
+    out[keys[i]] = v;
+  }
+  return out;
+}
+
+/* insetSpacing / textWrapOffset: [oben, links, unten, rechts] – ein Wert, wenn InDesign nur einen fuehrt. */
+function idcEdgesFromArray(value) {
+  if (IDC.isArray(value)) {
+    if (value.length >= 4) {
+      return { top: IDC.round(value[0]), left: IDC.round(value[1]), bottom: IDC.round(value[2]), right: IDC.round(value[3]) };
+    }
+    if (value.length > 0) {
+      return { top: IDC.round(value[0]), left: IDC.round(value[0]), bottom: IDC.round(value[0]), right: IDC.round(value[0]) };
+    }
+    return null;
+  }
+  if (typeof value === 'number') {
+    return { top: IDC.round(value), left: IDC.round(value), bottom: IDC.round(value), right: IDC.round(value) };
+  }
+  return null;
+}
+
+IDC.register('set_frame_inset', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var found = idcTextFrameArg(doc, args, 'frame_id');
+    var frame = found.item;
+    var hasInset = args.inset_mm !== undefined && args.inset_mm !== null;
+    var vj = args.vertical_justification;
+    var hasVj = vj !== undefined && vj !== null;
+    var inset = null, vjEnum = null, back = null, vjBack = null;
+
+    /* Sitzung 24 (E-79): vertikale Ausrichtung als optionaler Parameter; dann darf inset_mm fehlen. */
+    if (!hasInset && !hasVj) {
+      IDC.fail('invalid_argument', 'Pass inset_mm, vertical_justification or both.', null);
+    }
+    if (hasInset) { inset = idcEdgeObjectArg(args.inset_mm, 'inset_mm', false); }
+    if (hasVj) {
+      vjEnum = idcVerticalJustificationFor(vj);
+      if (vjEnum === null) {
+        IDC.fail('invalid_argument', 'vertical_justification must be top, center, bottom or justify.', { vertical_justification: vj });
+      }
+    }
+
+    try {
+      if (inset !== null) { frame.textFramePreferences.insetSpacing = [inset.top, inset.left, inset.bottom, inset.right]; }
+    } catch (e) {
+      IDC.fail('script_error', 'InDesign could not set the inset (Innenabstand) of text frame ' + args.frame_id + ': ' + String(e.message ? e.message : e),
+        { frame_id: args.frame_id });
+    }
+    try {
+      if (vjEnum !== null) { frame.textFramePreferences.verticalJustification = vjEnum; }
+    } catch (e1) {
+      IDC.fail('script_error', 'InDesign could not set the vertical justification (vertikale Ausrichtung) of text frame ' + args.frame_id + ': ' + String(e1.message ? e1.message : e1),
+        { frame_id: args.frame_id });
+    }
+    try { back = idcEdgesFromArray(frame.textFramePreferences.insetSpacing); } catch (e2) { back = null; }
+    try { vjBack = idcVerticalJustificationName(frame.textFramePreferences.verticalJustification); } catch (e3) { vjBack = null; }
+    ctx.changes = { modified_frame_ids: [Number(frame.id)] };
+    return { frame_id: Number(frame.id), inset_mm: back, vertical_justification: vjBack };
+  });
+
+/* ------------------------------------------------------------ set_text_wrap */
+
+function idcTextWrapModeFor(name) {
+  if (name === 'none') { return TextWrapModes.NONE; }
+  if (name === 'bounding_box') { return TextWrapModes.BOUNDING_BOX_TEXT_WRAP; }
+  if (name === 'object_shape') { return TextWrapModes.CONTOUR; }
+  if (name === 'jump_object') { return TextWrapModes.JUMP_OBJECT_TEXT_WRAP; }
+  if (name === 'next_column') { return TextWrapModes.NEXT_COLUMN_TEXT_WRAP; }
+  return null;
+}
+
+IDC.register('set_text_wrap', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var found = idcFrameArg(doc, args, 'frame_id');
+    var item = found.item;
+    var mode = args.mode;
+    var enumValue, offset = null, unit = 'mm', prefs, modeBack, offsetBack = null;
+
+    if (typeof TextWrapModes === 'undefined') {
+      IDC.fail('invalid_state', 'This InDesign runtime has no TextWrapModes.', null);
+    }
+    enumValue = typeof mode === 'string' ? idcTextWrapModeFor(mode) : null;
+    if (enumValue === null) {
+      IDC.fail('invalid_argument', 'mode must be none, bounding_box, object_shape, jump_object or next_column.', { mode: mode });
+    }
+    if (args.offset_mm !== undefined && args.offset_mm !== null && args.offset_pt !== undefined && args.offset_pt !== null) {
+      IDC.fail('invalid_argument', 'Pass either offset_mm or offset_pt, not both.', null);
+    }
+    if (args.offset_mm !== undefined && args.offset_mm !== null) { offset = idcEdgeObjectArg(args.offset_mm, 'offset_mm', false); unit = 'mm'; }
+    else if (args.offset_pt !== undefined && args.offset_pt !== null) { offset = idcEdgeObjectArg(args.offset_pt, 'offset_pt', false); unit = 'pt'; }
+
+    try { prefs = item.textWrapPreferences; } catch (e0) { prefs = null; }
+    if (prefs === null || prefs === undefined) {
+      IDC.fail('invalid_state', 'Object ' + args.frame_id + ' has no text wrap preferences (Textumfluss).', { frame_id: args.frame_id });
+    }
+
+    /* Vermerk E-63: der Umbruch muss nach jeder Aenderung am Textumfluss erzwungen werden. */
+    var recBeforeWrap = idcOversetBefore(doc);
+
+    try {
+      prefs.textWrapMode = enumValue;
+    } catch (e) {
+      IDC.fail('script_error', 'InDesign could not set the text wrap mode of object ' + args.frame_id + ': ' + String(e.message ? e.message : e),
+        { frame_id: args.frame_id, mode: mode });
+    }
+
+    if (offset !== null) {
+      if (mode === 'none') {
+        ctx.warn('mode "none" ignores the offset.');
+      } else {
+        /* Als ganzes Array zuweisen – die alte Fassung scheiterte an der Zuweisung einzelner Elemente. */
+        var values = [offset.top, offset.left, offset.bottom, offset.right];
+        var assign = function () {
+          if (mode === 'object_shape') {
+            /* Konturumfluss fuehrt nur einen Abstand. */
+            try { prefs.textWrapOffset = values[0]; } catch (e0) { prefs.textWrapOffset = values; }
+            return;
+          }
+          try {
+            prefs.textWrapOffset = values;
+          } catch (e1) {
+            prefs.textWrapOffset = values[0];
+          }
+        };
+        try {
+          if (unit === 'pt') { IDC.inPoints(assign); } else { assign(); }
+        } catch (e2) {
+          IDC.fail('script_error', 'The text wrap mode was set, but InDesign could not set the offset of object ' + args.frame_id + ': ' +
+            String(e2.message ? e2.message : e2), { frame_id: args.frame_id, offset: offset, unit: unit });
+        }
+      }
+    }
+
+    modeBack = idcTextWrapName(item);
+    if (modeBack === 'contour') { modeBack = 'object_shape'; }
+    var rawOffset = null;
+    try { rawOffset = prefs.textWrapOffset; offsetBack = idcEdgesFromArray(rawOffset); } catch (e3) { offsetBack = null; }
+    var recWrap = idcRecomposeAfter(ctx, doc, recBeforeWrap);
+    var out = { frame_id: Number(item.id), mode: modeBack, offset_mm: offsetBack,
+      recomposed: recWrap.recomposed, overset_stories_before: recWrap.overset_stories_before,
+      overset_stories_after: recWrap.overset_stories_after, overset_changed: recWrap.overset_changed };
+    if (offsetBack === null) {
+      try { out.offset_raw = String(rawOffset) + ' (' + typeof rawOffset + ')'; } catch (e5) { out.offset_raw = null; }
+      if (mode === 'object_shape' && offset !== null) {
+        /* Live-Fund 04.09.2026: bei Konturumfluss liest InDesign textWrapOffset als NOTHING zurueck. */
+        ctx.warn('InDesign does not report the offset for object_shape wrap (reads NOTHING); the value ' + offset.top + ' was assigned – check visually.');
+      }
+    }
+    ctx.changes = { modified_frame_ids: [Number(item.id)] };
+    return out;
+  });
+
+/* ------------------------------------------------------- thread_text_frames */
+
+function idcStoryLength(frame) {
+  try { return Number(frame.parentStory.characters.length); } catch (e) { return null; }
+}
+
+function idcStoryId(frame) {
+  try { return Number(frame.parentStory.id); } catch (e) { return null; }
+}
+
+function idcSameObject(a, b) {
+  try { return Number(a.id) === Number(b.id); } catch (e) { return false; }
+}
+
+IDC.register('thread_text_frames', { needs_document: true, read_only: false, ruler: 'none' },
+  function (ctx) {
+    var args = ctx.args;
+    var doc = ctx.doc;
+    var source = idcTextFrameArg(doc, args, 'source_frame_id').item;
+    var target = idcTextFrameArg(doc, args, 'target_frame_id').item;
+    var already = false;
+    var next = null, prev = null, targetChars = 0;
+
+    if (idcSameObject(source, target)) {
+      IDC.fail('invalid_argument', 'source_frame_id and target_frame_id must differ.', { frame_id: args.source_frame_id });
+    }
+    try { next = source.nextTextFrame; } catch (e0) { next = null; }
+    if (next !== null && next !== undefined) {
+      try { already = next.isValid === true && idcSameObject(next, target); } catch (e1) { already = false; }
+      if (!already) {
+        try {
+          if (next.isValid === true) {
+            IDC.fail('invalid_state', 'Text frame ' + args.source_frame_id + ' is already threaded to frame ' + Number(next.id) + '.',
+              { source_frame_id: args.source_frame_id, next_frame_id: Number(next.id) });
+          }
+        } catch (e2) { if (e2 && e2.isIdcError) { throw e2; } }
+      }
+    }
+    if (!already) {
+      try { prev = target.previousTextFrame; } catch (e3) { prev = null; }
+      try {
+        if (prev !== null && prev !== undefined && prev.isValid === true) {
+          IDC.fail('invalid_state', 'Text frame ' + args.target_frame_id + ' already continues frame ' + Number(prev.id) + '.',
+            { target_frame_id: args.target_frame_id, previous_frame_id: Number(prev.id) });
+        }
+      } catch (e4) { if (e4 && e4.isIdcError) { throw e4; } }
+      if (idcStoryId(source) !== null && idcStoryId(source) === idcStoryId(target)) {
+        IDC.fail('invalid_state', 'Both frames already belong to the same story.', { story_id: idcStoryId(source) });
+      }
+      try { targetChars = Number(target.parentStory.characters.length); } catch (e5) { targetChars = 0; }
+      try {
+        source.nextTextFrame = target;
+      } catch (e) {
+        IDC.fail('script_error', 'InDesign could not thread frame ' + args.source_frame_id + ' to frame ' + args.target_frame_id + ': ' +
+          String(e.message ? e.message : e), { source_frame_id: args.source_frame_id, target_frame_id: args.target_frame_id });
+      }
+      if (targetChars > 0) {
+        ctx.warn('The target frame held ' + targetChars + ' characters; they were merged into the story after the source text.');
+      }
+      ctx.changes = { modified_frame_ids: [Number(source.id), Number(target.id)] };
+    }
+    var overflows = false;
+    try { overflows = target.overflows === true; } catch (e6) { overflows = false; }
+    return {
+      source_frame_id: Number(source.id),
+      target_frame_id: Number(target.id),
+      story_id: idcStoryId(source),
+      story_character_count: idcStoryLength(source),
+      already_threaded: already,
+      target_overflows: overflows
+    };
+  });