sfdx-git-delta 6.41.2 → 6.43.0

package/lib/utils/metadataDiff/xmlWriter.js

@@ -0,0 +1,213 @@
+'use strict';
+import { once } from 'node:events';
+import { ATTRIBUTE_PREFIX } from '../xmlHelper.js';
+const INDENT = '    ';
+const NEWLINE = '\n';
+const COMMENT_KEY = '#comment';
+// Buffer threshold for batching frame chunks before flushing to the
+// underlying stream. ~8 KB matches a typical socket / pipe payload
+// without forcing the writer to round-trip the event loop on every
+// element. Picked to amortize the per-write overhead (Writable._write,
+// drain bookkeeping) across ~50-100 frames for medium Profiles.
+const FLUSH_THRESHOLD = 8 * 1024;
+// Pre-computed indent strings keyed by depth. XML is rarely deeper than
+// 4-6 levels in Salesforce metadata, so this stays tiny. Lazily extended
+// on first miss so deeper inputs still work without an upfront bound.
+const indentCache = [''];
+const indent = (depth) => {
+    let cached = indentCache[depth];
+    if (cached === undefined) {
+        for (let d = indentCache.length; d <= depth; d++) {
+            indentCache[d] = indentCache[d - 1] + INDENT;
+        }
+        cached = indentCache[depth];
+    }
+    return cached;
+};
+const renderAttrs = (attrs) => {
+    let out = '';
+    for (const key of Object.keys(attrs)) {
+        const bareName = key.slice(ATTRIBUTE_PREFIX.length);
+        out += ` ${bareName}="${attrs[key]}"`;
+    }
+    return out;
+};
+const splitAttributesAndChildren = (content) => {
+    const attributes = {};
+    const children = [];
+    for (const key of Object.keys(content)) {
+        const value = content[key];
+        if (key.startsWith(ATTRIBUTE_PREFIX)) {
+            attributes[key] = String(value);
+            continue;
+        }
+        children.push([key, value]);
+    }
+    return { attributes, children };
+};
+const isPrimitive = (value) => value === null || value === undefined || typeof value !== 'object';
+const toFrameForObjectChild = (key, value, depth) => {
+    const { attributes, children } = splitAttributesAndChildren(value);
+    if (children.length === 0) {
+        return {
+            kind: 'empty',
+            name: key,
+            attributes,
+            depth,
+            trailingNewline: true,
+        };
+    }
+    return {
+        kind: 'open',
+        name: key,
+        attributes,
+        children,
+        depth,
+        closeTrailingNewline: true,
+    };
+};
+const toFrameForPrimitiveChild = (key, value, depth) => ({
+    kind: 'leaf',
+    name: key,
+    attributes: {},
+    value: value === undefined || value === null ? '' : String(value),
+    depth,
+});
+const pushChildren = (stack, children, depth) => {
+    for (let i = children.length - 1; i >= 0; i--) {
+        const [key, value] = children[i];
+        if (key === COMMENT_KEY) {
+            if (Array.isArray(value)) {
+                for (let j = value.length - 1; j >= 0; j--) {
+                    stack.push({
+                        kind: 'comment',
+                        value: String(value[j]),
+                        depth,
+                    });
+                }
+            }
+            else {
+                stack.push({ kind: 'comment', value: String(value), depth });
+            }
+            continue;
+        }
+        if (Array.isArray(value)) {
+            for (let j = value.length - 1; j >= 0; j--) {
+                stack.push(frameForChild(key, value[j], depth));
+            }
+            continue;
+        }
+        stack.push(frameForChild(key, value, depth));
+    }
+};
+const frameForChild = (key, value, depth) => {
+    if (isPrimitive(value))
+        return toFrameForPrimitiveChild(key, value, depth);
+    return toFrameForObjectChild(key, value, depth);
+};
+// Buffered emitter: pushes frame fragments into a string until the
+// FLUSH_THRESHOLD is crossed, then writes a single chunk to the
+// underlying stream. Replaces the prior per-frame `out.write` which
+// fired ~3 stream writes per element on large outputs (~thousands of
+// writes per Profile prune). Backpressure is honoured at flush time:
+// if `out.write` returns false we await the next `drain` before
+// continuing — same semantics as before, just at coarser granularity.
+class ChunkBuffer {
+    out;
+    buffer = '';
+    constructor(out) {
+        this.out = out;
+    }
+    push(chunk) {
+        this.buffer += chunk;
+        if (this.buffer.length >= FLUSH_THRESHOLD) {
+            return this.flush();
+        }
+    }
+    flush() {
+        if (this.buffer.length === 0)
+            return;
+        const payload = this.buffer;
+        this.buffer = '';
+        if (this.out.write(payload))
+            return;
+        return once(this.out, 'drain').then(() => undefined);
+    }
+}
+const writeXmlDeclaration = async (buf, xmlHeader) => {
+    if (!xmlHeader)
+        return;
+    const decl = xmlHeader['?xml'];
+    if (!decl)
+        return;
+    const { attributes } = splitAttributesAndChildren(decl);
+    await buf.push(`<?xml${renderAttrs(attributes)}?>${NEWLINE}`);
+};
+/**
+ * Streams a generic XML document to `out`. Iterative depth-first traversal
+ * with an explicit LIFO frame stack — safe under unexpectedly-deep input,
+ * cancellation-friendly, back-pressure aware via drain-await per chunk.
+ *
+ * Output is byte-identical to `fast-xml-builder` when given the same
+ * attribute prefix, comment key, and entity-passthrough (processEntities:
+ * false) conventions as the rest of the project. See DESIGN.md \xc2\xa75.5.1.
+ */
+export const writeXmlDocument = async (out, rootCapture, rootChildren, options = {}) => {
+    const buf = new ChunkBuffer(out);
+    await writeXmlDeclaration(buf, rootCapture.xmlHeader);
+    const trailingNewline = options.trailingNewline !== false;
+    const rootFrame = rootChildren.length === 0
+        ? {
+            kind: 'empty',
+            name: rootCapture.rootKey,
+            attributes: rootCapture.rootAttributes,
+            depth: 0,
+            trailingNewline,
+        }
+        : {
+            kind: 'open',
+            name: rootCapture.rootKey,
+            attributes: rootCapture.rootAttributes,
+            children: rootChildren,
+            depth: 0,
+            closeTrailingNewline: trailingNewline,
+        };
+    const stack = [rootFrame];
+    while (stack.length > 0) {
+        const frame = stack.pop();
+        await emitFrame(buf, frame, stack);
+    }
+    // Final flush — anything still buffered at end-of-document goes out
+    // before the caller resolves.
+    await buf.flush();
+};
+const emitFrame = async (buf, frame, stack) => {
+    switch (frame.kind) {
+        case 'open':
+            await emitOpenFrame(buf, frame, stack);
+            break;
+        case 'close':
+            await buf.push(`${indent(frame.depth)}</${frame.name}>${frame.trailingNewline ? NEWLINE : ''}`);
+            break;
+        case 'comment':
+            await buf.push(`${indent(frame.depth)}<!--${frame.value}-->${NEWLINE}`);
+            break;
+        case 'leaf':
+            await buf.push(`${indent(frame.depth)}<${frame.name}${renderAttrs(frame.attributes)}>${frame.value}</${frame.name}>${NEWLINE}`);
+            break;
+        case 'empty':
+            await buf.push(`${indent(frame.depth)}<${frame.name}${renderAttrs(frame.attributes)}></${frame.name}>${frame.trailingNewline ? NEWLINE : ''}`);
+            break;
+    }
+};
+const emitOpenFrame = async (buf, frame, stack) => {
+    await buf.push(`${indent(frame.depth)}<${frame.name}${renderAttrs(frame.attributes)}>${NEWLINE}`);
+    stack.push({
+        kind: 'close',
+        name: frame.name,
+        depth: frame.depth,
+        trailingNewline: frame.closeTrailingNewline,
+    });
+    pushChildren(stack, frame.children, frame.depth + 1);
+};
+//# sourceMappingURL=xmlWriter.js.map

package/lib/utils/metadataDiff/xmlWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmlWriter.js","sourceRoot":"","sources":["../../../src/utils/metadataDiff/xmlWriter.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAGlC,OAAO,EAAE,gBAAgB,EAAmB,MAAM,iBAAiB,CAAA;AAGnE,MAAM,MAAM,GAAG,MAAM,CAAA;AACrB,MAAM,OAAO,GAAG,IAAI,CAAA;AACpB,MAAM,WAAW,GAAG,UAAU,CAAA;AAC9B,oEAAoE;AACpE,mEAAmE;AACnE,mEAAmE;AACnE,uEAAuE;AACvE,gEAAgE;AAChE,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,CAAA;AAEhC,wEAAwE;AACxE,yEAAyE;AACzE,sEAAsE;AACtE,MAAM,WAAW,GAAa,CAAC,EAAE,CAAC,CAAA;AAClC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAU,EAAE;IACvC,IAAI,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;IAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAA;QAC9C,CAAC;QACD,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,MAAO,CAAA;AAChB,CAAC,CAAA;AA4CD,MAAM,WAAW,GAAG,CAAC,KAA6B,EAAU,EAAE;IAC5D,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;QACnD,GAAG,IAAI,IAAI,QAAQ,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAA;IACvC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,0BAA0B,GAAG,CACjC,OAAmB,EAC+C,EAAE;IACpE,MAAM,UAAU,GAA2B,EAAE,CAAA;IAC7C,MAAM,QAAQ,GAAmB,EAAE,CAAA;IACnC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrC,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;YAC/B,SAAQ;QACV,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,KAAc,EAAW,EAAE,CAC9C,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAA;AAEpE,MAAM,qBAAqB,GAAG,CAC5B,GAAW,EACX,KAAiB,EACjB,KAAa,EACN,EAAE;IACT,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAA;IAClE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,GAAG;YACT,UAAU;YACV,KAAK;YACL,eAAe,EAAE,IAAI;SACtB,CAAA;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,GAAG;QACT,UAAU;QACV,QAAQ;QACR,KAAK;QACL,oBAAoB,EAAE,IAAI;KAC3B,CAAA;AACH,CAAC,CAAA;AAED,MAAM,wBAAwB,GAAG,CAC/B,GAAW,EACX,KAAc,EACd,KAAa,EACF,EAAE,CAAC,CAAC;IACf,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,GAAG;IACT,UAAU,EAAE,EAAE;IACd,KAAK,EAAE,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IACjE,KAAK;CACN,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,CACnB,KAAc,EACd,QAAwB,EACxB,KAAa,EACP,EAAE;IACR,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QAChC,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC3C,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,SAAS;wBACf,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;wBACvB,KAAK;qBACN,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;YAC9D,CAAC;YACD,SAAQ;QACV,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;YACjD,CAAC;YACD,SAAQ;QACV,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,KAAa,EAAS,EAAE;IAC1E,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,wBAAwB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IAC1E,OAAO,qBAAqB,CAAC,GAAG,EAAE,KAAmB,EAAE,KAAK,CAAC,CAAA;AAC/D,CAAC,CAAA;AAED,mEAAmE;AACnE,gEAAgE;AAChE,oEAAoE;AACpE,qEAAqE;AACrE,qEAAqE;AACrE,gEAAgE;AAChE,sEAAsE;AACtE,MAAM,WAAW;IAEc;IADrB,MAAM,GAAG,EAAE,CAAA;IACnB,YAA6B,GAAa;QAAb,QAAG,GAAH,GAAG,CAAU;IAAG,CAAC;IAE9C,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAA;QACpB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAChB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,OAAM;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACtD,CAAC;CACF;AAED,MAAM,mBAAmB,GAAG,KAAK,EAC/B,GAAgB,EAChB,SAAiC,EAClB,EAAE;IACjB,IAAI,CAAC,SAAS;QAAE,OAAM;IACtB,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAA2B,CAAA;IACxD,IAAI,CAAC,IAAI;QAAE,OAAM;IACjB,MAAM,EAAE,UAAU,EAAE,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAA;IACvD,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,WAAW,CAAC,UAAU,CAAC,KAAK,OAAO,EAAE,CAAC,CAAA;AAC/D,CAAC,CAAA;AAMD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,GAAa,EACb,WAAwB,EACxB,YAA4B,EAC5B,UAAwB,EAAE,EACX,EAAE;IACjB,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAA;IAChC,MAAM,mBAAmB,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC,CAAA;IACrD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,KAAK,KAAK,CAAA;IACzD,MAAM,SAAS,GACb,YAAY,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,WAAW,CAAC,OAAO;YACzB,UAAU,EAAE,WAAW,CAAC,cAAc;YACtC,KAAK,EAAE,CAAC;YACR,eAAe;SAChB;QACH,CAAC,CAAC;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,WAAW,CAAC,OAAO;YACzB,UAAU,EAAE,WAAW,CAAC,cAAc;YACtC,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,CAAC;YACR,oBAAoB,EAAE,eAAe;SACtC,CAAA;IACP,MAAM,KAAK,GAAY,CAAC,SAAS,CAAC,CAAA;IAClC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAG,CAAA;QAC1B,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IACpC,CAAC;IACD,oEAAoE;IACpE,8BAA8B;IAC9B,MAAM,GAAG,CAAC,KAAK,EAAE,CAAA;AACnB,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,KAAK,EACrB,GAAgB,EAChB,KAAY,EACZ,KAAc,EACC,EAAE;IACjB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,MAAM,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;YACtC,MAAK;QACP,KAAK,OAAO;YACV,MAAM,GAAG,CAAC,IAAI,CACZ,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAChF,CAAA;YACD,MAAK;QACP,KAAK,SAAS;YACZ,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,KAAK,MAAM,OAAO,EAAE,CAAC,CAAA;YACvE,MAAK;QACP,KAAK,MAAM;YACT,MAAM,GAAG,CAAC,IAAI,CACZ,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,CAChH,CAAA;YACD,MAAK;QACP,KAAK,OAAO;YACV,MAAM,GAAG,CAAC,IAAI,CACZ,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/H,CAAA;YACD,MAAK;IACT,CAAC;AACH,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,KAAK,EACzB,GAAgB,EAChB,KAAgB,EAChB,KAAc,EACC,EAAE;IACjB,MAAM,GAAG,CAAC,IAAI,CACZ,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,OAAO,EAAE,CAClF,CAAA;IACD,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,eAAe,EAAE,KAAK,CAAC,oBAAoB;KAC5C,CAAC,CAAA;IACF,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;AACtD,CAAC,CAAA"}

package/lib/utils/packageHelper.d.ts

@@ -1,8 +1,15 @@
+import type { Writable } from 'node:stream';
 import type { Config } from '../types/config.js';
 import type { Manifest } from '../types/work.js';
+type TypeBlock = {
+    members: string[];
+    name: string;
+};
 export default class PackageBuilder {
     protected readonly config: Config;
     constructor(config: Config);
-    buildPackage(strucDiffPerType: Manifest): string;
+    buildPackageStream(strucDiffPerType: Manifest, out: Writable): Promise<void>;
+    protected _buildTypesBlocks(strucDiffPerType: Manifest): TypeBlock[];
     _sortTypesWithMetadata: (x: string, y: string) => number;
 }
+export {};

package/lib/utils/packageHelper.js

@@ -1,46 +1,43 @@
 'use strict';
 import { __decorate } from "tslib";
-import XMLBuilder from 'fast-xml-builder';
 import { OBJECT_TYPE } from '../constant/metadataConstants.js';
 import { log } from './LoggingDecorator.js';
-import { ATTRIBUTE_PREFIX, XML_HEADER_ATTRIBUTE_KEY } from './xmlHelper.js';
+import { writeXmlDocument } from './metadataDiff/xmlWriter.js';
 const frLocale = 'fr';
 const collator = new Intl.Collator(frLocale);
-// processEntities is false to mirror xmlHelper: values flowing through this
-// builder are metadata type/member strings that never contain XML entities,
-// so re-encoding is a no-op at best and a double-encode risk at worst.
-const xmlBuilder = new XMLBuilder({
-    ignoreAttributes: false,
-    format: true,
-    indentBy: '    ',
-    suppressEmptyNode: false,
-    suppressBooleanAttributes: false,
-    processEntities: false,
-});
+const ROOT_ATTRIBUTES = {
+    '@_xmlns': 'http://soap.sforce.com/2006/04/metadata',
+};
+const XML_HEADER = {
+    '?xml': { '@_version': '1.0', '@_encoding': 'UTF-8' },
+};
 export default class PackageBuilder {
     config;
     constructor(config) {
         this.config = config;
     }
-    buildPackage(strucDiffPerType) {
-        const types = Array.from(strucDiffPerType.keys())
+    async buildPackageStream(strucDiffPerType, out) {
+        const typesBlocks = this._buildTypesBlocks(strucDiffPerType);
+        const rootChildren = [
+            ...typesBlocks.map(block => ['types', block]),
+            ['version', `${this.config.apiVersion}.0`],
+        ];
+        const capture = {
+            xmlHeader: XML_HEADER,
+            rootKey: 'Package',
+            rootAttributes: ROOT_ATTRIBUTES,
+        };
+        await writeXmlDocument(out, capture, rootChildren, {
+            trailingNewline: false,
+        });
+    }
+    _buildTypesBlocks(strucDiffPerType) {
+        return Array.from(strucDiffPerType.keys())
             .sort(this._sortTypesWithMetadata)
             .map(metadataType => ({
             members: [...strucDiffPerType.get(metadataType)].sort(collator.compare),
             name: metadataType,
         }));
-        const jsonObj = {
-            [XML_HEADER_ATTRIBUTE_KEY]: {
-                [`${ATTRIBUTE_PREFIX}version`]: '1.0',
-                [`${ATTRIBUTE_PREFIX}encoding`]: 'UTF-8',
-            },
-            Package: {
-                [`${ATTRIBUTE_PREFIX}xmlns`]: 'http://soap.sforce.com/2006/04/metadata',
-                types,
-                version: `${this.config.apiVersion}.0`,
-            },
-        };
-        return xmlBuilder.build(jsonObj).trimEnd();
     }
     _sortTypesWithMetadata = (x, y) => {
         // RATIONALE: Why must CustomObject be ordered first in package.xml?
@@ -53,5 +50,5 @@ export default class PackageBuilder {
 }
 __decorate([
     log
-], PackageBuilder.prototype, "buildPackage", null);
+], PackageBuilder.prototype, "buildPackageStream", null);
 //# sourceMappingURL=packageHelper.js.map

package/lib/utils/packageHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"packageHelper.js","sourceRoot":"","sources":["../../src/utils/packageHelper.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AACZ,OAAO,UAAU,MAAM,kBAAkB,CAAA;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAG9D,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAE3E,MAAM,QAAQ,GAAG,IAAI,CAAA;AACrB,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC5C,4EAA4E;AAC5E,4EAA4E;AAC5E,uEAAuE;AACvE,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC;IAChC,gBAAgB,EAAE,KAAK;IACvB,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,MAAM;IAChB,iBAAiB,EAAE,KAAK;IACxB,yBAAyB,EAAE,KAAK;IAChC,eAAe,EAAE,KAAK;CACvB,CAAC,CAAA;AAEF,MAAM,CAAC,OAAO,OAAO,cAAc;IACF;IAA/B,YAA+B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAG1C,YAAY,CAAC,gBAA0B;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;aAC9C,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC;aACjC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC,CAAC,IAAI,CACpD,QAAQ,CAAC,OAAO,CACjB;YACD,IAAI,EAAE,YAAY;SACnB,CAAC,CAAC,CAAA;QAEL,MAAM,OAAO,GAAG;YACd,CAAC,wBAAwB,CAAC,EAAE;gBAC1B,CAAC,GAAG,gBAAgB,SAAS,CAAC,EAAE,KAAK;gBACrC,CAAC,GAAG,gBAAgB,UAAU,CAAC,EAAE,OAAO;aACzC;YACD,OAAO,EAAE;gBACP,CAAC,GAAG,gBAAgB,OAAO,CAAC,EAAE,yCAAyC;gBACvE,KAAK;gBACL,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI;aACvC;SACF,CAAA;QAED,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAA;IAC5C,CAAC;IAED,sBAAsB,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE;QAChD,oEAAoE;QACpE,+EAA+E;QAC/E,qGAAqG;QACrG,IAAI,CAAC,KAAK,WAAW;YAAE,OAAO,CAAC,CAAC,CAAA,CAAC,oFAAoF;QACrH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/B,CAAC,CAAA;CACF;AAhCQ;IADN,GAAG;kDAwBH"}
+{"version":3,"file":"packageHelper.js","sourceRoot":"","sources":["../../src/utils/packageHelper.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAGZ,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAG9D,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAE9D,MAAM,QAAQ,GAAG,IAAI,CAAA;AACrB,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC5C,MAAM,eAAe,GAAG;IACtB,SAAS,EAAE,yCAAyC;CACrD,CAAA;AACD,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE;CACtD,CAAA;AAID,MAAM,CAAC,OAAO,OAAO,cAAc;IACF;IAA/B,YAA+B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAGpC,AAAN,KAAK,CAAC,kBAAkB,CAC7B,gBAA0B,EAC1B,GAAa;QAEb,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAA;QAC5D,MAAM,YAAY,GAAwB;YACxC,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAsB,CAAC;YAClE,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAsB;SAChE,CAAA;QACD,MAAM,OAAO,GAAgB;YAC3B,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE,SAAS;YAClB,cAAc,EAAE,eAAe;SAChC,CAAA;QACD,MAAM,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE;YACjD,eAAe,EAAE,KAAK;SACvB,CAAC,CAAA;IACJ,CAAC;IAES,iBAAiB,CAAC,gBAA0B;QACpD,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;aACvC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC;aACjC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC,CAAC,IAAI,CACpD,QAAQ,CAAC,OAAO,CACjB;YACD,IAAI,EAAE,YAAY;SACnB,CAAC,CAAC,CAAA;IACP,CAAC;IAED,sBAAsB,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE;QAChD,oEAAoE;QACpE,+EAA+E;QAC/E,qGAAqG;QACrG,IAAI,CAAC,KAAK,WAAW;YAAE,OAAO,CAAC,CAAC,CAAA,CAAC,oFAAoF;QACrH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/B,CAAC,CAAA;CACF;AArCc;IADZ,GAAG;wDAkBH"}

package/lib/utils/renameResolver.d.ts

@@ -0,0 +1,19 @@
+import type { MetadataRepository } from '../metadata/MetadataRepository.js';
+import type { Work } from '../types/work.js';
+import type ChangeSet from './changeSet.js';
+import type { RenamePathPair } from './repoGitDiff.js';
+/**
+ * Turns the `{ fromPath, toPath }` pairs git emitted for `-M` renames into
+ * `ChangeSet.recordRename(type, from, to)` calls by re-using the handler
+ * machinery to resolve each side to its Salesforce (type, member).
+ *
+ * Pairs where metadata resolution fails (ignored path, unknown type) or where
+ * the from/to side land on the same component are skipped — those reduce to
+ * normal add/delete or no-ops already covered by the handler pipeline.
+ */
+export default class RenameResolver {
+    private readonly factory;
+    constructor(work: Work, metadata: MetadataRepository);
+    apply(changes: ChangeSet, pairs: readonly RenamePathPair[]): Promise<void>;
+    private _resolve;
+}

package/lib/utils/renameResolver.js

@@ -0,0 +1,52 @@
+'use strict';
+import { __decorate } from "tslib";
+import { TAB } from '../constant/cliConstants.js';
+import { ADDITION, DELETION } from '../constant/gitConstants.js';
+import TypeHandlerFactory from '../service/typeHandlerFactory.js';
+import { getErrorMessage } from './errorUtils.js';
+import { log } from './LoggingDecorator.js';
+import { Logger, lazy } from './LoggingService.js';
+/**
+ * Turns the `{ fromPath, toPath }` pairs git emitted for `-M` renames into
+ * `ChangeSet.recordRename(type, from, to)` calls by re-using the handler
+ * machinery to resolve each side to its Salesforce (type, member).
+ *
+ * Pairs where metadata resolution fails (ignored path, unknown type) or where
+ * the from/to side land on the same component are skipped — those reduce to
+ * normal add/delete or no-ops already covered by the handler pipeline.
+ */
+export default class RenameResolver {
+    factory;
+    constructor(work, metadata) {
+        this.factory = new TypeHandlerFactory(work, metadata);
+    }
+    async apply(changes, pairs) {
+        for (const pair of pairs) {
+            const resolved = await this._resolve(pair);
+            if (resolved) {
+                changes.recordRename(resolved.type, resolved.from, resolved.to);
+            }
+        }
+    }
+    async _resolve(pair) {
+        try {
+            const fromHandler = await this.factory.getTypeHandler(`${DELETION}${TAB}${pair.fromPath}`);
+            const toHandler = await this.factory.getTypeHandler(`${ADDITION}${TAB}${pair.toPath}`);
+            const from = fromHandler.getElementDescriptor();
+            const to = toHandler.getElementDescriptor();
+            if (from.type !== to.type)
+                return null;
+            if (from.member === to.member)
+                return null;
+            return { type: from.type, from: from.member, to: to.member };
+        }
+        catch (error) {
+            Logger.warn(lazy `RenameResolver._resolve: skipping ${pair.fromPath} -> ${pair.toPath}: ${() => getErrorMessage(error)}`);
+            return null;
+        }
+    }
+}
+__decorate([
+    log
+], RenameResolver.prototype, "apply", null);
+//# sourceMappingURL=renameResolver.js.map

package/lib/utils/renameResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renameResolver.js","sourceRoot":"","sources":["../../src/utils/renameResolver.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAEhE,OAAO,kBAAkB,MAAM,kCAAkC,CAAA;AAGjE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAGlD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IAChB,OAAO,CAAoB;IAE5C,YAAY,IAAU,EAAE,QAA4B;QAClD,IAAI,CAAC,OAAO,GAAG,IAAI,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACvD,CAAC;IAGY,AAAN,KAAK,CAAC,KAAK,CAChB,OAAkB,EAClB,KAAgC;QAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC1C,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAA;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,IAAoB;QAEpB,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CACnD,GAAG,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CACpC,CAAA;YACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CACjD,GAAG,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAClC,CAAA;YACD,MAAM,IAAI,GAAG,WAAW,CAAC,oBAAoB,EAAE,CAAA;YAC/C,MAAM,EAAE,GAAG,SAAS,CAAC,oBAAoB,EAAE,CAAA;YAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAA;YACtC,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAA;YAC1C,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAA;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,IAAI,CAAA,qCAAqC,IAAI,CAAC,QAAQ,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAC5G,CAAA;YACD,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;CACF;AAlCc;IADZ,GAAG;2CAWH"}

package/lib/utils/repoGitDiff.d.ts

@@ -1,15 +1,28 @@
 import GitAdapter from '../adapter/GitAdapter.js';
 import { MetadataRepository } from '../metadata/MetadataRepository.js';
 import type { Config } from '../types/config.js';
+export type RenamePathPair = Readonly<{
+    fromPath: string;
+    toPath: string;
+}>;
 export default class RepoGitDiff {
     protected readonly config: Config;
     protected readonly metadata: MetadataRepository;
     protected readonly gitAdapter: GitAdapter;
+    private renamePairs;
     constructor(config: Config, metadata: MetadataRepository);
-    getLines(): Promise<string[]>;
-    protected _treatResult(lines: string[]): Promise<string[]>;
-    protected _getRenamedElements(lines: string[]): Set<string>;
-    protected _spreadLinePerDiffType(lines: string[]): Map<any, any>;
-    protected _filterInternal(line: string, deletedRenamed: Set<string>): boolean;
+    /**
+     * Streams the filtered, rename-expanded diff lines. Yields A/M lines as
+     * they arrive from git so handlers can start working immediately; D
+     * lines are buffered until upstream EOF because the deleted-renamed
+     * cancellation rule needs the full A-name set before any D line can
+     * be classified.
+     *
+     * Rename pairs are captured along the way and exposed via
+     * getRenamePairs() once iteration completes.
+     */
+    getLines(): AsyncGenerator<string>;
+    getRenamePairs(): readonly RenamePathPair[];
+    protected _expandRename(line: string): Iterable<string>;
     protected _extractComparisonName(line: string): string;
 }

package/lib/utils/repoGitDiff.js

@@ -1,51 +1,84 @@
 'use strict';
 import GitAdapter from '../adapter/GitAdapter.js';
-import { ADDITION, DELETION } from '../constant/gitConstants.js';
+import { TAB } from '../constant/cliConstants.js';
+import { ADDITION, DELETION, RENAMED } from '../constant/gitConstants.js';
 import { buildIgnoreHelper } from './ignoreHelper.js';
 export default class RepoGitDiff {
     config;
     metadata;
     gitAdapter;
+    renamePairs = [];
     constructor(config, metadata) {
         this.config = config;
         this.metadata = metadata;
         this.gitAdapter = GitAdapter.getInstance(this.config);
     }
-    async getLines() {
-        const lines = await this.gitAdapter.getDiffLines();
-        const treatedLines = await this._treatResult(lines);
-        return treatedLines;
-    }
-    async _treatResult(lines) {
-        const renamedElements = this._getRenamedElements(lines);
+    /**
+     * Streams the filtered, rename-expanded diff lines. Yields A/M lines as
+     * they arrive from git so handlers can start working immediately; D
+     * lines are buffered until upstream EOF because the deleted-renamed
+     * cancellation rule needs the full A-name set before any D line can
+     * be classified.
+     *
+     * Rename pairs are captured along the way and exposed via
+     * getRenamePairs() once iteration completes.
+     */
+    async *getLines() {
+        this.renamePairs = [];
         const ignoreHelper = await buildIgnoreHelper(this.config);
-        return lines.filter((line) => Boolean(line) &&
-            this._filterInternal(line, renamedElements) &&
-            ignoreHelper.keep(line));
-    }
-    _getRenamedElements(lines) {
-        const linesPerDiffType = this._spreadLinePerDiffType(lines);
-        const AfileNames = new Set(linesPerDiffType
-            .get(ADDITION)
-            ?.map(line => this._extractComparisonName(line)) ?? []);
-        const deletedRenamed = (linesPerDiffType.get(DELETION) ?? []).filter((line) => {
-            const dEl = this._extractComparisonName(line);
-            return AfileNames.has(dEl);
-        });
-        return new Set(deletedRenamed);
-    }
-    _spreadLinePerDiffType(lines) {
-        return lines.reduce((acc, line) => {
-            const idx = line.charAt(0);
-            if (!acc.has(idx)) {
-                acc.set(idx, []);
+        const additionNames = new Set();
+        const deferredDeletions = [];
+        for await (const rawLine of this.gitAdapter.streamDiffLines()) {
+            for (const expanded of this._expandRename(rawLine)) {
+                if (!expanded)
+                    continue;
+                /* v8 ignore next -- defensive: upstream RepoGitDiff already filters non-metadata paths via _expandRename, but kept as safety net */
+                if (!this.metadata.has(expanded))
+                    continue;
+                if (!ignoreHelper.keep(expanded))
+                    continue;
+                if (expanded.startsWith(ADDITION)) {
+                    additionNames.add(this._extractComparisonName(expanded));
+                    yield expanded;
+                }
+                else if (expanded.startsWith(DELETION)) {
+                    // Defer: the D line might cancel against an A line we haven't
+                    // seen yet (rename-collapse case).
+                    deferredDeletions.push(expanded);
+                }
+                else {
+                    yield expanded;
+                }
             }
-            acc.get(idx).push(line);
-            return acc;
-        }, new Map());
+        }
+        for (const dLine of deferredDeletions) {
+            if (!additionNames.has(this._extractComparisonName(dLine))) {
+                yield dLine;
+            }
+        }
+    }
+    getRenamePairs() {
+        return this.renamePairs;
     }
-    _filterInternal(line, deletedRenamed) {
-        return !deletedRenamed.has(line) && this.metadata.has(line);
+    // git emits `R<score>\tfrom\tto` when -M detects a rename. Each rename is
+    // expanded into the equivalent D/A pair so every downstream handler keeps
+    // operating on a (status, path) tuple; the rename pair is captured for
+    // ChangeSet to re-group into its Rename bucket.
+    *_expandRename(line) {
+        if (!line.startsWith(RENAMED)) {
+            yield line;
+            return;
+        }
+        const parts = line.split(TAB);
+        if (parts.length < 3) {
+            yield line;
+            return;
+        }
+        const fromPath = parts[1];
+        const toPath = parts[2];
+        this.renamePairs.push({ fromPath, toPath });
+        yield `${DELETION}${TAB}${fromPath}`;
+        yield `${ADDITION}${TAB}${toPath}`;
     }
     _extractComparisonName(line) {
         return this.metadata.getFullyQualifiedName(line).toLocaleLowerCase();

package/lib/utils/repoGitDiff.js.map

@@ -1 +1 @@
-{"version":3,"file":"repoGitDiff.js","sourceRoot":"","sources":["../../src/utils/repoGitDiff.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"repoGitDiff.js","sourceRoot":"","sources":["../../src/utils/repoGitDiff.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,UAAU,MAAM,0BAA0B,CAAA;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAIzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAIrD,MAAM,CAAC,OAAO,OAAO,WAAW;IAKT;IACA;IALF,UAAU,CAAY;IACjC,WAAW,GAAqB,EAAE,CAAA;IAE1C,YACqB,MAAc,EACd,QAA4B;QAD5B,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAoB;QAE/C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACvD,CAAC;IAED;;;;;;;;;OASG;IACI,KAAK,CAAC,CAAC,QAAQ;QACpB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAA;QACrB,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACzD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAA;QACvC,MAAM,iBAAiB,GAAa,EAAE,CAAA;QAEtC,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,EAAE,CAAC;YAC9D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,IAAI,CAAC,QAAQ;oBAAE,SAAQ;gBACvB,oIAAoI;gBACpI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAAE,SAAQ;gBAC1C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;oBAAE,SAAQ;gBAE1C,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAClC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAA;oBACxD,MAAM,QAAQ,CAAA;gBAChB,CAAC;qBAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACzC,8DAA8D;oBAC9D,mCAAmC;oBACnC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;gBAClC,CAAC;qBAAM,CAAC;oBACN,MAAM,QAAQ,CAAA;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;YACtC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC3D,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;IACH,CAAC;IAEM,cAAc;QACnB,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAED,0EAA0E;IAC1E,0EAA0E;IAC1E,uEAAuE;IACvE,gDAAgD;IACtC,CAAC,aAAa,CAAC,IAAY;QACnC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAA;YACV,OAAM;QACR,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC7B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,CAAA;YACV,OAAM;QACR,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QACxB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;QAC3C,MAAM,GAAG,QAAQ,GAAG,GAAG,GAAG,QAAQ,EAAE,CAAA;QACpC,MAAM,GAAG,QAAQ,GAAG,GAAG,GAAG,MAAM,EAAE,CAAA;IACpC,CAAC;IAES,sBAAsB,CAAC,IAAY;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAA;IACtE,CAAC;CACF"}

package/lib/utils/treeIndexScope.d.ts

@@ -1,2 +1,2 @@
 import type { MetadataRepository } from '../metadata/MetadataRepository.js';
-export declare const computeTreeIndexScope: (lines: string[], metadata: MetadataRepository) => Set<string>;
+export declare const computeTreeIndexScope: (lines: Iterable<string>, metadata: MetadataRepository) => Set<string>;

package/lib/utils/treeIndexScope.js.map

@@ -1 +1 @@
-{"version":3,"file":"treeIndexScope.js","sourceRoot":"","sources":["../../src/utils/treeIndexScope.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"treeIndexScope.js","sourceRoot":"","sources":["../../src/utils/treeIndexScope.ts"],"names":[],"mappings":"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"}

package/lib/utils/txmlAdapter.d.ts

@@ -0,0 +1,30 @@
+import { type XmlContent } from './xmlHelper.js';
+/**
+ * Adapter from txml's flat AST (`(tNode | string)[]`) to our compact
+ * `XmlContent` shape:
+ *   { '@_attr': value, child: <content>, '#comment': string|string[] }
+ *
+ * Conventions matched against the previous FlexXMLParser configuration
+ * so existing handlers and `xmlWriter.ts` keep round-tripping unchanged:
+ *   - attributes are prefixed `@_` (ATTRIBUTE_PREFIX)
+ *   - boolean attributes (no value) are emitted as `true`
+ *   - element text is trimmed; whitespace-only text between elements is
+ *     dropped (txml default)
+ *   - comments are collapsed under the `#comment` key (string or string[]
+ *     when more than one comment lives at the same depth)
+ *   - the XML declaration `<?xml ...?>` is collapsed to a `?xml` key
+ *   - elements with the same tagName at the same depth collapse to an array
+ */
+export type TxmlNode = {
+    tagName: string;
+    attributes: Record<string, string | null>;
+    children: TxmlChild[];
+};
+export type TxmlChild = TxmlNode | string;
+export declare const tNodeToXmlContent: (node: TxmlNode) => unknown;
+/**
+ * Parses XML text into our compact JSON shape. Empty input short-circuits
+ * to `{}`; malformed input (parse throws) is swallowed and also yields
+ * `{}` — preserving the existing `xml2Json` contract.
+ */
+export declare const parseXml: (xmlContent: string) => XmlContent;