Issue with Image Shifting/Distortion when Embedding Linked Files via Scripting & Save Options

First of all, thank you very much for your support.

Later, I attempted a method where I first capture the object's layer hierarchy, coordinates, and dimensions, and insert a placeholder.

After embedding, I overwrite the new object's parameters with this saved data to ensure the artwork undergoes no unintended changes.

#target illustrator

function smartBatchEmbed() {
    if (app.documents.length === 0) {
        alert("Please open a document first.");
        return;
    }

    var doc = app.activeDocument;
    var links = doc.placedItems;
    var successCount = 0;
    var errorCount = 0;

    // Save the current interaction level to restore later
    // (Suppress alerts to speed up processing and prevent interruptions)
    var originalInteractionLevel = app.userInteractionLevel;
    app.userInteractionLevel = UserInteractionLevel.DONTDISPLAYALERTS;

    try {
        // =================================================
        // Reverse Loop Traversal
        // (Processing from the last item to the first to avoid index shifting)
        // =================================================
        for (var i = links.length - 1; i >= 0; i--) {
            var targetItem = links[i];
            
            try {
                // Check validity: If 'file' property is unreadable, it's likely not a standard linked file.
                // This also excludes already embedded objects.
                var fileRef = targetItem.file; 

                // -------------------------------------------------
                // Step 1: Snapshot State (Geometry & Hierarchy)
                // -------------------------------------------------
                var savedState = {
                    left: targetItem.left,
                    top: targetItem.top,
                    width: targetItem.width,
                    height: targetItem.height
                };

                // Create a placeholder to mark the exact hierarchy level and Z-Order
                var parentContainer = targetItem.parent;
                var placeholder = parentContainer.pathItems.add();
                placeholder.name = "Embed_Placeholder_" + i;
                placeholder.filled = false;
                placeholder.stroked = false;
                
                // Move the placeholder directly BEHIND the target object
                placeholder.move(targetItem, ElementPlacement.PLACEAFTER);

                // -------------------------------------------------
                // Step 2: Execute Embed
                // -------------------------------------------------
                // Select only the current object to avoid interference
                doc.selection = null;
                targetItem.selected = true;
                
                targetItem.embed();
                
                // -------------------------------------------------
                // Step 3: Group the Result
                // -------------------------------------------------
                // After embedding, the result might be a RasterItem or a Group of paths.
                // We force a "Group" command to wrap the result into a single container.
                app.executeMenuCommand('group');
                
                // Get the newly created group (it becomes the current selection)
                var fixedGroup = doc.selection[0];

                // -------------------------------------------------
                // Step 4: Force Restore (Hierarchy & Geometry)
                // -------------------------------------------------
                
                // 4.1 Restore Hierarchy: Move the group to "IN FRONT OF" the placeholder
                fixedGroup.move(placeholder, ElementPlacement.PLACEBEFORE);

                // 4.2 Restore Geometry: Force apply original dimensions
                // Setting dimensions first, then position is generally safer
                if (fixedGroup.width !== savedState.width || fixedGroup.height !== savedState.height) {
                    fixedGroup.width = savedState.width;
                    fixedGroup.height = savedState.height;
                }
                
                // Finally, restore coordinates (Top-Left alignment)
                fixedGroup.left = savedState.left;
                fixedGroup.top = savedState.top;

                // -------------------------------------------------
                // Step 5: Cleanup
                // -------------------------------------------------
                placeholder.remove();
                successCount++;

            } catch (e) {
                // Handle individual failure without stopping the loop
                errorCount++;
                // Attempt to clean up any residual placeholder
                try {
                    if (placeholder) placeholder.remove();
                } catch(err) {}
                
                // Uncomment below to debug specific errors
                // $.writeln("Process failed: " + e.message);
            }
        }

    } finally {
        // Restore user interaction level regardless of errors
        app.userInteractionLevel = originalInteractionLevel;
    }

    // Reporting
    if (successCount > 0 || errorCount > 0) {
        var report = "Batch Embed Completed!\n";
        report += "✅ Success: " + successCount + "\n";
        if (errorCount > 0) report += "❌ Failed/Skipped: " + errorCount;
        alert(report);
    }
}

smartBatchEmbed();