@dialecte/scl 0.2.21 → 0.2.23

package/dist/{extensions-DDF6FezI.js → extensions-DzEZ0dCq.js}

@@ -26305,92 +26305,33 @@ async function Y(e, t) {
 	}), await e.deepClone(a, d);
 }
 //#endregion
-//#region src/v2019C1/extensions/extraction/transaction/primitives/clone-referenced.ts
-async function on(e, t) {
-	let { sourceQuery: n, scopeRef: r, refTagName: i, targetTagName: a } = t, o = A[i][0].attribute.uuid, { [i]: s = [] } = await n.findDescendants(r, { collect: i }), c = /* @__PURE__ */ new Set();
-	for (let e of s) {
-		let t = e.attributes.find((e) => e.name === o)?.value;
-		t && c.add(t);
-	}
-	let l = [];
-	for (let t of c) {
-		let r = { uuid: t }, [i] = await e.findByAttributes({
-			tagName: a,
-			attributes: r
-		});
-		if (i) continue;
-		let [o] = await n.findByAttributes({
-			tagName: a,
-			attributes: r
-		});
-		o && l.push({
-			tagName: a,
-			id: o.id
-		});
-	}
-	return l;
-}
-async function sn(e, t) {
-	let { sourceQuery: n, scopeRef: r, refTagName: i, targetTagName: a, targetParent: o, omit: s } = t, c = await on(e, {
-		sourceQuery: n,
-		scopeRef: r,
-		refTagName: i,
-		targetTagName: a
-	});
-	for (let t of c) await Y(e, {
-		sourceQuery: n,
-		ref: t,
-		targetParent: o,
-		omit: s
-	});
-}
-async function cn(e, t) {
-	let { sourceQuery: n, scopeTagName: r, scopeRef: i, targetParent: a, skip: o = /* @__PURE__ */ new Set(), omit: s } = t, c = (d[r] ?? []).filter((e) => e in A && !o.has(e)), l = sn;
-	for (let t of c) for (let r of A[t]) for (let o of r.target) await l(e, {
-		sourceQuery: n,
-		scopeRef: i,
-		refTagName: t,
-		targetTagName: o,
-		targetParent: a,
-		omit: s
-	});
-}
-//#endregion
 //#region src/v2019C1/extensions/extraction/transaction/deep.ts
-async function ln(e, t) {
-	let { sourceQuery: n, ref: r, targetParent: i, withTypes: a = !0, withReferences: o = !0, skipReferences: s, omit: c, strip: l = !1, promoteRoot: u } = t;
-	o && await cn(e, {
-		sourceQuery: n,
-		scopeTagName: r.tagName,
-		scopeRef: r,
-		targetParent: i,
-		skip: s,
-		omit: c
-	});
-	let d = await Y(e, {
+async function on(e, t) {
+	let { sourceQuery: n, ref: r, targetParent: i, withTypes: a = !0, omit: o, strip: s = !1, promoteRoot: c } = t, l = await Y(e, {
 		sourceQuery: n,
 		ref: r,
 		targetParent: i,
-		omit: c,
-		strip: l,
-		promoteRoot: u
+		omit: o,
+		strip: s,
+		promoteRoot: c
 	});
-	if (!d) throw Error(`extraction.deep: source element not found: ${r.tagName}#${r.id}`);
-	let f = /* @__PURE__ */ new Map();
+	if (!l) throw Error(`extraction.deep: source element not found: ${r.tagName}#${r.id}`);
+	let u = /* @__PURE__ */ new Map();
 	if (a) {
-		let t = await un(n, r);
-		t.length > 0 && (f = (await Jt(e, {
+		let t = await sn(n, r);
+		t.length > 0 && (u = (await Jt(e, {
 			sourceQuery: n,
 			records: t,
-			cloneMappings: d.mappings
+			cloneMappings: l.mappings
 		})).idRemap);
 	}
 	return {
-		record: d.record,
-		idRemap: f
+		record: l.record,
+		typeIdRemap: u,
+		recordMappings: l.mappings
 	};
 }
-async function un(e, t) {
+async function sn(e, t) {
 	let { LNode: n = [] } = await e.findDescendants(t, { collect: "LNode" }), { LN: r = [] } = await e.findDescendants(t, { collect: "LN" });
 	return [...n, ...r];
 }
@@ -26415,10 +26356,63 @@ async function X(e) {
 }
 //#endregion
 //#region src/v2019C1/extensions/extraction/transaction/recipes/shared/post-extraction-cleanup.ts
-async function dn(e) {
+async function cn(e) {
 	await W.transaction.orphanUuidRefs(e), await W.transaction.resetLNode(e), await W.transaction.pruneEmptyContainers(e);
 }
 //#endregion
+//#region src/v2019C1/extensions/extraction/transaction/primitives/clone-referenced.ts
+async function ln(e, t) {
+	let { sourceQuery: n, scopeRef: r, refTagName: i, targetTagName: a, alreadyCloned: o } = t, s = A[i][0].attribute.uuid, { [i]: c = [] } = await n.findDescendants(r, { collect: i }), l = /* @__PURE__ */ new Set();
+	for (let e of c) {
+		let t = e.attributes.find((e) => e.name === s)?.value;
+		t && l.add(t);
+	}
+	let u = [];
+	for (let t of l) {
+		let r = { uuid: t }, [i] = await n.findByAttributes({
+			tagName: a,
+			attributes: r
+		});
+		if (!i || o?.has(i.id)) continue;
+		let [s] = await e.findByAttributes({
+			tagName: a,
+			attributes: r
+		});
+		s || u.push({
+			tagName: a,
+			id: i.id
+		});
+	}
+	return u;
+}
+async function un(e, t) {
+	let { sourceQuery: n, scopeRef: r, refTagName: i, targetTagName: a, resolveTargetParent: o, alreadyCloned: s, omit: c } = t, l = await ln(e, {
+		sourceQuery: n,
+		scopeRef: r,
+		refTagName: i,
+		targetTagName: a,
+		alreadyCloned: s
+	});
+	for (let t of l) await Y(e, {
+		sourceQuery: n,
+		ref: t,
+		targetParent: await o(t),
+		omit: c
+	});
+}
+async function dn(e, t) {
+	let { sourceQuery: n, scopeTagName: r, scopeRef: i, resolveTargetParent: a, alreadyCloned: o, skip: s = /* @__PURE__ */ new Set(), omit: c } = t, l = (d[r] ?? []).filter((e) => e in A && !s.has(e)), u = un;
+	for (let t of l) for (let r of A[t]) for (let s of r.target) await u(e, {
+		sourceQuery: n,
+		scopeRef: i,
+		refTagName: t,
+		targetTagName: s,
+		resolveTargetParent: a,
+		alreadyCloned: o,
+		omit: c
+	});
+}
+//#endregion
 //#region src/v2019C1/extensions/extraction/transaction/recipes/shared/resolve-structure-ref.ts
 async function Z(e, t, n) {
 	let r = (await e.findAncestors(t, { stopAtTagName: "Substation" })).find((e) => e.tagName in n);
@@ -26432,11 +26426,31 @@ async function Z(e, t, n) {
 		id: i.id
 	};
 }
+function fn(e) {
+	let { sourceQuery: t, structure: n, cloneIndex: r } = e;
+	return async function(e) {
+		let i = await t.findAncestors(e, { stopAtTagName: "Substation" });
+		for (let e of i) {
+			let t = r.get(e.id);
+			if (t) return t;
+			if (e.tagName in n) {
+				let t = n[e.tagName];
+				return {
+					tagName: t.tagName,
+					id: t.id
+				};
+			}
+		}
+		a(!1, {
+			key: "ELEMENT_NOT_FOUND",
+			detail: `No clone-mapped or structural ancestor found for ${e.tagName}`
+		});
+	};
+}
 //#endregion
 //#region src/v2019C1/extensions/extraction/transaction/recipes/shared/clone-function.ts
-async function fn(e, t) {
-	let { sourceQuery: n, functionRef: r, targetParentRef: i, omit: a, stripRootAttributes: o } = t;
-	await ln(e, {
+async function pn(e, t) {
+	let { sourceQuery: n, functionRef: r, targetParentRef: i, omit: a, stripRootAttributes: o } = t, { recordMappings: s } = await on(e, {
 		sourceQuery: n,
 		ref: r,
 		targetParent: i,
@@ -26449,14 +26463,14 @@ async function fn(e, t) {
 			from: "SubFunction",
 			to: "Function"
 		},
-		withTypes: !0,
-		withReferences: !1
+		withTypes: !0
 	});
+	return s;
 }
-async function pn(e, t) {
-	let { sourceQuery: n, functionRef: r, structure: i, stripCategoriesUuid: a = !0 } = t, o = await mn(n, r);
+async function mn(e, t) {
+	let { sourceQuery: n, functionRef: r, structure: i, stripCategoriesUuid: a = !0 } = t, o = await hn(n, r);
 	for (let t of o) {
-		if (await gn(e, n, t)) continue;
+		if (await _n(e, n, t)) continue;
 		let r = {
 			tagName: "FunctionCategory",
 			id: t
@@ -26469,12 +26483,12 @@ async function pn(e, t) {
 		});
 	}
 }
-async function mn(e, t) {
-	let n = await hn(e, t), r = /* @__PURE__ */ new Set();
+async function hn(e, t) {
+	let n = await gn(e, t), r = /* @__PURE__ */ new Set();
 	for (let { container: e } of n) e && r.add(e.id);
 	return r;
 }
-async function hn(e, t) {
+async function gn(e, t) {
 	let n = await R.query.findRefsPointingTo(e, {
 		target: t,
 		containerTagName: "FunctionCategory"
@@ -26491,7 +26505,7 @@ async function hn(e, t) {
 	}
 	return n;
 }
-async function gn(e, t, n) {
+async function _n(e, t, n) {
 	let r = await t.getRecord({
 		tagName: "FunctionCategory",
 		id: n
@@ -26515,34 +26529,40 @@ var Q = [
 ];
 //#endregion
 //#region src/v2019C1/extensions/extraction/transaction/recipes/asd/clone-application.ts
-async function _n(e, t) {
-	let { sourceQuery: n, applicationRef: r, structure: i } = t, a = {
-		tagName: "Substation",
-		id: i.Substation.id
-	}, o = await on(e, {
+async function vn(e, t) {
+	let { sourceQuery: n, applicationRef: r, structure: i } = t, a = /* @__PURE__ */ new Map(), o = await ln(e, {
 		sourceQuery: n,
 		scopeRef: r,
 		refTagName: "FunctionRef",
 		targetTagName: "Function"
 	});
-	for (let t of o) await fn(e, {
-		sourceQuery: n,
-		functionRef: t,
-		targetParentRef: await Z(n, t, i),
-		omit: Q
-	});
-	for (let t of o) await pn(e, {
+	for (let t of o) {
+		let r = await pn(e, {
+			sourceQuery: n,
+			functionRef: t,
+			targetParentRef: await Z(n, t, i),
+			omit: Q
+		});
+		for (let e of r) e.source.id && a.set(e.source.id, e.target);
+	}
+	for (let t of o) await mn(e, {
 		sourceQuery: n,
 		functionRef: t,
 		structure: i,
 		stripCategoriesUuid: !1
 	});
-	await cn(e, {
+	let s = new Set(["FunctionRef", "FunctionCategoryRef"]);
+	await dn(e, {
 		sourceQuery: n,
 		scopeTagName: "Application",
 		scopeRef: r,
-		targetParent: a,
-		skip: new Set(["FunctionRef", "FunctionCategoryRef"]),
+		resolveTargetParent: fn({
+			sourceQuery: n,
+			structure: i,
+			cloneIndex: a
+		}),
+		alreadyCloned: new Set(a.keys()),
+		skip: s,
 		omit: Q
 	}), await Y(e, {
 		sourceQuery: n,
@@ -26553,7 +26573,7 @@ async function _n(e, t) {
 }
 //#endregion
 //#region src/v2019C1/extensions/history/query/get-sorted-hitem.ts
-async function vn(e) {
+async function yn(e) {
 	let t = await e.getRecord({ tagName: "History" });
 	if (!t) return [];
 	let { Hitem: n = [] } = await e.findDescendants(t, { collect: "Hitem" });
@@ -26567,18 +26587,18 @@ async function vn(e) {
 }
 //#endregion
 //#region src/v2019C1/extensions/history/query/get-latest-hitem.ts
-async function yn(e) {
-	return (await vn(e)).at(-1);
+async function bn(e) {
+	return (await yn(e)).at(-1);
 }
 //#endregion
 //#region src/v2019C1/extensions/history/query/index.ts
-var bn = /* @__PURE__ */ s({
-	getLatestHitem: () => yn,
-	getSortedHitems: () => vn
+var xn = /* @__PURE__ */ s({
+	getLatestHitem: () => bn,
+	getSortedHitems: () => yn
 });
 //#endregion
 //#region src/v2019C1/extensions/history/transaction/add-entry.ts
-async function xn(e, t) {
+async function Sn(e, t) {
 	let { filename: n, header: r, item: i } = t, { id: a, fileType: o, nameStructure: s, version: c, tool: l } = r, { who: u, what: d, why: f } = i, p = await e.getRoot(), m = await e.getRecord({ tagName: "Header" }) ?? await e.addChild(p, {
 		tagName: "Header",
 		attributes: {
@@ -26593,7 +26613,7 @@ async function xn(e, t) {
 	}), h = await e.getRecord({ tagName: "History" }) ?? await e.addChild(m, {
 		tagName: "History",
 		attributes: {}
-	}), g = await yn(e), _ = g?.attributes.find((e) => e.name === "version")?.value, v = g?.attributes.find((e) => e.name === "revision")?.value, y = c === "keep" ? _ ?? "0" : _ ? String(Number(_) + 1) : "0", b = v ? String(Number(v) + 1) : "1";
+	}), g = await bn(e), _ = g?.attributes.find((e) => e.name === "version")?.value, v = g?.attributes.find((e) => e.name === "revision")?.value, y = c === "keep" ? _ ?? "0" : _ ? String(Number(_) + 1) : "0", b = v ? String(Number(v) + 1) : "1";
 	await e.update(m, { attributes: {
 		version: y,
 		revision: b
@@ -26617,12 +26637,12 @@ async function xn(e, t) {
 //#endregion
 //#region src/v2019C1/extensions/history/index.ts
 var $ = {
-	query: bn,
-	transaction: /* @__PURE__ */ s({ addEntry: () => xn })
+	query: xn,
+	transaction: /* @__PURE__ */ s({ addEntry: () => Sn })
 };
 //#endregion
 //#region src/v2019C1/extensions/extraction/transaction/recipes/asd/to-asd.ts
-async function Sn(e, t) {
+async function Cn(e, t) {
 	let { sourceQuery: n, applicationRef: r, tool: i, who: a, nameStructure: o } = t, s = await X(e), c = await e.getAttribute(r, { name: "name" }) || "Unnamed Application";
 	await $.transaction.addEntry(e, {
 		filename: `ASD_${c.replace(/\s+/g, "_")}`,
@@ -26637,15 +26657,15 @@ async function Sn(e, t) {
 			what: "ASD initialization",
 			why: "Application was extracted from a previous file"
 		}
-	}), await _n(e, {
+	}), await vn(e, {
 		sourceQuery: n,
 		applicationRef: r,
 		structure: s
-	}), await dn(e);
+	}), await cn(e);
 }
 //#endregion
 //#region src/v2019C1/extensions/extraction/transaction/recipes/fsd/omit.ts
-var Cn = [
+var wn = [
 	...Q,
 	"DOS",
 	"Labels",
@@ -26658,7 +26678,7 @@ var Cn = [
 ];
 //#endregion
 //#region src/v2019C1/extensions/extraction/transaction/recipes/fsd/to-fsd.ts
-async function wn(e, t) {
+async function Tn(e, t) {
 	let { sourceQuery: n, functionRef: r, tool: i, who: a, nameStructure: o } = t, s = await X(e), c = {
 		tagName: s.Substation.tagName,
 		id: s.Substation.id
@@ -26676,26 +26696,26 @@ async function wn(e, t) {
 			what: "FSD initialization",
 			why: "Function was extracted from a previous file"
 		}
-	}), await fn(e, {
+	}), await pn(e, {
 		sourceQuery: n,
 		functionRef: r,
 		targetParentRef: c,
-		omit: Cn,
+		omit: wn,
 		stripRootAttributes: ["templateUuid"]
-	}), await pn(e, {
+	}), await mn(e, {
 		sourceQuery: n,
 		functionRef: r,
 		structure: s
-	}), await dn(e);
+	}), await cn(e);
 }
 //#endregion
 //#region src/v2019C1/extensions/extraction/index.ts
-var Tn = { transaction: /* @__PURE__ */ s({
-	deep: () => ln,
+var En = { transaction: /* @__PURE__ */ s({
+	deep: () => on,
 	ensureSubstationTemplateStructure: () => X,
-	toAsd: () => Sn,
-	toFsd: () => wn
-}) }, En = {
+	toAsd: () => Cn,
+	toFsd: () => Tn
+}) }, Dn = {
 	LNode: {
 		compact: [
 			"prefix",
@@ -26782,13 +26802,13 @@ var Tn = { transaction: /* @__PURE__ */ s({
 };
 //#endregion
 //#region src/v2019C1/extensions/presentation/query/extract-element-title.ts
-async function Dn(e, t, n = {}) {
+async function On(e, t, n = {}) {
 	let r = await e.getRecord(t);
 	if (!r) return n.withLabels ? {
 		title: "",
 		labels: {}
 	} : "";
-	let i = r.tagName, a = On({
+	let i = r.tagName, a = kn({
 		tag: i,
 		mode: n.mode ?? "compact",
 		attributes: await e.any.getAttributes(r),
@@ -26796,13 +26816,13 @@ async function Dn(e, t, n = {}) {
 	});
 	return n.withLabels ? {
 		title: a,
-		labels: await kn(e, r)
+		labels: await An(e, r)
 	} : a;
 }
-function On(e) {
-	let { tag: t, mode: n, attributes: r, value: i } = e, a = En[t];
+function kn(e) {
+	let { tag: t, mode: n, attributes: r, value: i } = e, a = Dn[t];
 	if (a) {
-		let e = Mn(a, r, n);
+		let e = Nn(a, r, n);
 		if (e) return e;
 	}
 	let o = (i ?? "").trim();
@@ -26810,10 +26830,10 @@ function On(e) {
 	let s = h[t]?.attributes?.identityFields, c = s?.find((e) => e === "name" || e === "id") ?? s?.[0];
 	return c && r[c] ? r[c] : r.name || t;
 }
-async function kn(e, t) {
-	return jn(await An(e, t));
-}
 async function An(e, t) {
+	return Mn(await jn(e, t));
+}
+async function jn(e, t) {
 	let n = [], r = await e.any.getChildren(t, "Labels");
 	for (let t of r) {
 		let r = await e.any.getChildren(t, "Label");
@@ -26828,30 +26848,30 @@ async function An(e, t) {
 	}
 	return n;
 }
-function jn(e) {
+function Mn(e) {
 	let t = {};
 	for (let { lang: n, id: r, text: i } of e) (t[n] ??= {})[r] = i;
 	return t;
 }
-function Mn(e, t, n) {
+function Nn(e, t, n) {
 	let r = n === "full" && e.full !== void 0, i = r ? e.full : e.compact, a = r ? e.fullSeparator ?? e.separator ?? "" : e.separator ?? "";
-	if (typeof i == "string") return Nn(i, t);
+	if (typeof i == "string") return Pn(i, t);
 	let o = i.map((e) => t[e]).filter(Boolean);
 	return o.length > 0 ? o.join(a) : "";
 }
-function Nn(e, t) {
+function Pn(e, t) {
 	return e.replace(/\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g, (e, n) => t[n] ?? "").replace(/\[\]/g, "").replace(/\(\)/g, "").split("/").map((e) => e.split(".").filter((e) => e !== "").join(".")).filter((e) => e !== "").join("/");
 }
 //#endregion
 //#region src/v2019C1/extensions/index.ts
-var Pn = {
+var Fn = {
 	cleanUp: W,
 	dataModel: rn,
-	extraction: Tn,
+	extraction: En,
 	history: $,
 	reference: R,
 	signature: { query: qt },
-	presentation: { query: /* @__PURE__ */ s({ extractElementTitle: () => Dn }) }
+	presentation: { query: /* @__PURE__ */ s({ extractElementTitle: () => On }) }
 };
 //#endregion
-export { S, Ie as _, Dt as a, k as b, Re as c, Fe as d, P as f, F as g, I as h, U as i, L as l, N as m, It as n, H as o, M as p, Ot as r, Et as s, Pn as t, Le as u, j as v, C as x, A as y };
+export { S, Ie as _, Dt as a, k as b, Re as c, Fe as d, P as f, F as g, I as h, U as i, L as l, N as m, It as n, H as o, M as p, Ot as r, Et as s, Fn as t, Le as u, j as v, C as x, A as y };

package/dist/v2019C1/extensions/extraction/transaction/deep.d.ts

@@ -2,18 +2,18 @@ import { ImportDeepParams, ImportDeepResult } from './deep.types';
 import { Config } from '../../../config';
 import type * as Core from '@dialecte/core';
 /**
- * Import an element subtree into a target document together with its closures:
+ * Import an element subtree into a target document together with its type closure:
  *
- * 1. `withReferences` (default `true`) — forward uuid-reference closure: clone
- *    referenced satellites that are missing in the target (create-if-missing).
- *    Done first so the cloned subtree's references remap onto the new satellites;
- * 2. clone the subtree under `targetParent` (with optional `omit` / `strip` /
+ * 1. clone the subtree under `targetParent` (with optional `omit` / `strip` /
  *    `promoteRoot`);
- * 3. `withTypes` (default `true`) — content-addressed **type** closure: reconcile
+ * 2. `withTypes` (default `true`) — content-addressed **type** closure: reconcile
  *    the LN/LNode type closure (reuse / preserve / fork) and repoint the cloned
  *    instances' `lnType` through the clone mappings.
  *
- * Uuid references inside the clone are remapped by the `afterDeepClone` hook.
+ * `deep` is a faithful subtree copy: it does **not** follow forward uuid references.
+ * Reference rewiring is the caller's responsibility (recipes place same-domain
+ * satellites by ancestry; cross-domain/lineage rewiring is plan-driven). Uuid
+ * references inside the clone are remapped by the `afterDeepClone` hook.
  */
 export declare function deep(tx: Core.Transaction<Config>, params: ImportDeepParams): Promise<ImportDeepResult>;
 //# sourceMappingURL=deep.d.ts.map

package/dist/v2019C1/extensions/extraction/transaction/deep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/extraction/transaction/deep.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,IAAI,CACzB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAqC3B"}
+{"version":3,"file":"deep.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/extraction/transaction/deep.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,IAAI,CACzB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAwB3B"}

package/dist/v2019C1/extensions/extraction/transaction/deep.types.d.ts

@@ -10,13 +10,6 @@ export type ImportDeepParams = {
     targetParent: Scl.Ref<Scl.ElementsOf>;
     /** Import the referenced **type** closure (content-addressed). Default `true`. */
     withTypes?: boolean;
-    /**
-     * Import the forward **uuid-reference** closure — clone referenced satellites
-     * that are missing in the target (create-if-missing). Default `true`.
-     */
-    withReferences?: boolean;
-    /** Ref tag names to skip while resolving the uuid-reference closure. */
-    skipReferences?: ReadonlySet<string>;
     /** Child element tag names to drop from the cloned subtree. */
     omit?: OmitEntry<Config>[];
     /**
@@ -30,7 +23,9 @@ export type ImportDeepParams = {
 export type ImportDeepResult = {
     /** The cloned root record in the target. */
     record: Scl.RawRecord<Scl.ElementsOf>;
-    /** source type id -> target type id, from the type reconciliation. */
-    idRemap: Map<string, string>;
+    /** source type id -> reconciled target type id, from the data-model type reconciliation. */
+    typeIdRemap: Map<string, string>;
+    /** Full source-record -> target-record structural mapping for the cloned subtree. */
+    recordMappings: Scl.CloneMapping[];
 };
 //# sourceMappingURL=deep.types.d.ts.map

package/dist/v2019C1/extensions/extraction/transaction/deep.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep.types.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/extraction/transaction/deep.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AACnF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,qCAAqC;IACrC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC5B,iDAAiD;IACjD,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,wEAAwE;IACxE,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACpC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;IAC3B,sFAAsF;IACtF,WAAW,CAAC,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,4CAA4C;IAC5C,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,sEAAsE;IACtE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5B,CAAA"}
+{"version":3,"file":"deep.types.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/extraction/transaction/deep.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AACnF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,qCAAqC;IACrC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC5B,iDAAiD;IACjD,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;IAC3B,sFAAsF;IACtF,WAAW,CAAC,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,4CAA4C;IAC5C,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,4FAA4F;IAC5F,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,qFAAqF;IACrF,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;CAClC,CAAA"}

package/dist/v2019C1/extensions/extraction/transaction/primitives/clone-referenced.d.ts

@@ -13,13 +13,23 @@ export declare function findMissingReferencedRecords<Ref extends RefTagName, Tar
     scopeRef: Scl.Ref<Scl.AncestorsOf<Ref>>;
     refTagName: Ref;
     targetTagName: Target;
+    /**
+     * Source record ids already cloned earlier in this extraction (e.g. as part of
+     * a function subtree). Their clones carry remapped uuids, so the source-uuid
+     * existence check below cannot see them — skip by source id to avoid cloning
+     * a misplaced duplicate.
+     */
+    alreadyCloned?: ReadonlySet<string>;
 }): Promise<Scl.Ref<Target>[]>;
+/** Resolves the target parent each missing satellite is cloned under. */
+export type ResolveTargetParent = (ref: Scl.Ref<Scl.ElementsOf>) => Promise<Scl.Ref<Scl.ElementsOf>>;
 /**
  * Generic satellite-clone helper.
  *
  * Scans `scopeRef` descendants for `refTagName` elements, collects unique uuid
  * values (derived from the UUID_REFERENCE_PAIRS constant), skips records
- * already present in the target, clones each missing one into `targetParent`.
+ * already present in the target, clones each missing one under the parent
+ * returned by `resolveTargetParent` (mirroring the source hierarchy).
  * UUID remapping is handled by afterDeepClone hook via cumulativeCloneMappings.
  */
 export declare function cloneReferencedRecords<Ref extends RefTagName, Target extends TargetOf<Ref>>(tx: Core.Transaction<Config>, params: {
@@ -27,13 +37,18 @@ export declare function cloneReferencedRecords<Ref extends RefTagName, Target ex
     scopeRef: Scl.Ref<Scl.AncestorsOf<Ref>>;
     refTagName: Ref;
     targetTagName: Target;
-    targetParent: Scl.Ref<Scl.ElementsOf>;
+    resolveTargetParent: ResolveTargetParent;
+    alreadyCloned?: ReadonlySet<string>;
     omit?: OmitEntry<Config>[];
 }): Promise<void>;
 /**
  * Clones all referenced targets for ref types derived from
  * `DESCENDANTS[scopeTagName] ∩ UUID_REFERENCE_PAIRS`, skipping those in `skip`.
  *
+ * Each missing target is cloned under the parent returned by `resolveTargetParent`,
+ * which mirrors the source hierarchy so satellites that live under a `Function` are
+ * not flattened to `Substation`.
+ *
  * Targets already present in the target tx are skipped (dedup via findMissingReferencedRecords).
  * UUID remapping is handled by afterDeepClone hook via cumulativeCloneMappings.
  */
@@ -41,7 +56,8 @@ export declare function cloneAllReferencedTargets(tx: Core.Transaction<Config>,
     sourceQuery: Core.Query<Config>;
     scopeTagName: Scl.ElementsOf;
     scopeRef: Scl.Ref<Scl.ElementsOf>;
-    targetParent: Scl.Ref<Scl.ElementsOf>;
+    resolveTargetParent: ResolveTargetParent;
+    alreadyCloned?: ReadonlySet<string>;
     skip?: ReadonlySet<string>;
     omit?: OmitEntry<Config>[];
 }): Promise<void>;

package/dist/v2019C1/extensions/extraction/transaction/primitives/clone-referenced.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clone-referenced.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/extraction/transaction/primitives/clone-referenced.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC1E,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI/C;;;;;GAKG;AACH,wBAAsB,4BAA4B,CACjD,GAAG,SAAS,UAAU,EACtB,MAAM,SAAS,QAAQ,CAAC,GAAG,CAAC,EAE5B,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;IACvC,UAAU,EAAE,GAAG,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;CACrB,GACC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAkC5B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,SAAS,UAAU,EAAE,MAAM,SAAS,QAAQ,CAAC,GAAG,CAAC,EAChG,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;IACvC,UAAU,EAAE,GAAG,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;CAC1B,GACC,OAAO,CAAC,IAAI,CAAC,CAaf;AAkBD;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC9C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,YAAY,EAAE,GAAG,CAAC,UAAU,CAAA;IAC5B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACjC,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1B,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;CAC1B,GACC,OAAO,CAAC,IAAI,CAAC,CAuBf"}
+{"version":3,"file":"clone-referenced.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/extraction/transaction/primitives/clone-referenced.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC1E,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI/C;;;;;GAKG;AACH,wBAAsB,4BAA4B,CACjD,GAAG,SAAS,UAAU,EACtB,MAAM,SAAS,QAAQ,CAAC,GAAG,CAAC,EAE5B,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;IACvC,UAAU,EAAE,GAAG,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACnC,GACC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAmC5B;AAED,yEAAyE;AACzE,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;AAEpG;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,SAAS,UAAU,EAAE,MAAM,SAAS,QAAQ,CAAC,GAAG,CAAC,EAChG,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;IACvC,UAAU,EAAE,GAAG,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACnC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;CAC1B,GACC,OAAO,CAAC,IAAI,CAAC,CAuBf;AAmBD;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC9C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,YAAY,EAAE,GAAG,CAAC,UAAU,CAAA;IAC5B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACjC,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACnC,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1B,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;CAC1B,GACC,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/v2019C1/extensions/extraction/transaction/recipes/asd/clone-application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clone-application.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/extraction/transaction/recipes/asd/clone-application.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC5C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,SAAS,EAAE,iBAAiB,CAAA;CAC5B,GACC,OAAO,CAAC,IAAI,CAAC,CAgDf"}
+{"version":3,"file":"clone-application.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/extraction/transaction/recipes/asd/clone-application.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC5C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,SAAS,EAAE,iBAAiB,CAAA;CAC5B,GACC,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/v2019C1/extensions/extraction/transaction/recipes/shared/clone-function.d.ts

@@ -17,7 +17,7 @@ export declare function cloneFunction(tx: Core.Transaction<Config>, params: {
     targetParentRef: Scl.Ref<'Substation'> | Scl.Ref<'VoltageLevel'> | Scl.Ref<'Bay'>;
     omit?: OmitEntry<Config>[];
     stripRootAttributes?: readonly string[];
-}): Promise<void>;
+}): Promise<Scl.CloneMapping[]>;
 /**
  * Clones FunctionCategory trees that reference the given function (or its SubFunctions).
  * Each category is placed at its source-side structural level in the TEMPLATE structure.

package/dist/v2019C1/extensions/extraction/transaction/recipes/shared/clone-function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clone-function.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/extraction/transaction/recipes/shared/clone-function.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI/C;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAClC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACzD,eAAe,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACjF,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1B,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC,GACC,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC5C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACzD,SAAS,EAAE,iBAAiB,CAAA;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC7B,GACC,OAAO,CAAC,IAAI,CAAC,CAmBf"}
+{"version":3,"file":"clone-function.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/extraction/transaction/recipes/shared/clone-function.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI/C;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAClC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACzD,eAAe,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACjF,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1B,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC,GACC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAsB7B;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC5C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACzD,SAAS,EAAE,iBAAiB,CAAA;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC7B,GACC,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/v2019C1/extensions/extraction/transaction/recipes/shared/resolve-structure-ref.d.ts

@@ -1,3 +1,4 @@
+import { ResolveTargetParent } from '../../primitives/clone-referenced';
 import { TemplateStructure } from './shared.types';
 import { Scl, Config } from '../../../../../config';
 import type * as Core from '@dialecte/core';
@@ -6,4 +7,19 @@ import type * as Core from '@dialecte/core';
  * and returns the matching target-side structural ref from the template structure.
  */
 export declare function resolveStructureRef(sourceQuery: Core.Query<Config>, ref: Scl.Ref<Scl.ElementsOf>, structure: TemplateStructure): Promise<Scl.Ref<'Substation'> | Scl.Ref<'VoltageLevel'> | Scl.Ref<'Bay'>>;
+/**
+ * Builds a {@link ResolveTargetParent} that places each satellite by **mirroring
+ * the source ancestor chain** into the target.
+ *
+ * The returned resolver walks the source ancestors nearest-first and returns the
+ * first that already exists in the target: a previously-cloned `Function`/`SubFunction`
+ * (via `cloneIndex`, keyed by source record id) takes precedence over the structural
+ * `Substation`/`VoltageLevel`/`Bay` levels — so a `ProcessResource` that lives under a
+ * `Function` is cloned back under that function's clone, not flat at `Substation`.
+ */
+export declare function createAncestryResolver(context: {
+    sourceQuery: Core.Query<Config>;
+    structure: TemplateStructure;
+    cloneIndex: ReadonlyMap<string, Scl.Ref<Scl.ElementsOf>>;
+}): ResolveTargetParent;
 //# sourceMappingURL=resolve-structure-ref.d.ts.map

package/dist/v2019C1/extensions/extraction/transaction/recipes/shared/resolve-structure-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-structure-ref.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/extraction/transaction/recipes/shared/resolve-structure-ref.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,wBAAsB,mBAAmB,CACxC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAC/B,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAC5B,SAAS,EAAE,iBAAiB,GAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAc3E"}
+{"version":3,"file":"resolve-structure-ref.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/extraction/transaction/recipes/shared/resolve-structure-ref.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,wBAAsB,mBAAmB,CACxC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAC/B,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAC5B,SAAS,EAAE,iBAAiB,GAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAc3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC/C,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,SAAS,EAAE,iBAAiB,CAAA;IAC5B,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;CACxD,GAAG,mBAAmB,CAqBtB"}

package/dist/v2019C1/index.js

@@ -1,4 +1,4 @@
-import { S as e, _ as t, a as n, b as r, c as i, d as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, o as p, p as m, r as h, s as g, t as _, u as v, v as y, x as b, y as x } from "../extensions-DDF6FezI.js";
+import { S as e, _ as t, a as n, b as r, c as i, d as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, o as p, p as m, r as h, s as g, t as _, u as v, v as y, x as b, y as x } from "../extensions-DzEZ0dCq.js";
 import { Project as S } from "@dialecte/core";
 //#region src/v2019C1/dialecte.ts
 function C(e) {

package/dist/v2019C1/test.js

@@ -1,4 +1,4 @@
-import { i as e, s as t, t as n } from "../extensions-DDF6FezI.js";
+import { i as e, s as t, t as n } from "../extensions-DzEZ0dCq.js";
 import { CUSTOM_RECORD_ID_ATTRIBUTE as r, CUSTOM_RECORD_ID_ATTRIBUTE_NAME as i, XMLNS_XSI_NAMESPACE as a } from "@dialecte/core/helpers";
 import { XMLNS_DEV_NAMESPACE as o, createTestProject as s, createTestRecordFactory as c, createTestRunner as l, createXmlAssertions as u } from "@dialecte/core/test";
 //#region src/v2019C1/test/hydrated-test.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dialecte/scl",
-	"version": "0.2.21",
+	"version": "0.2.23",
 	"description": "Dialecte - SCL (Substation Configuration Language) sdk",
 	"license": "MIT",
 	"repository": {
@@ -53,13 +53,13 @@
 		"prepare": "husky"
 	},
 	"dependencies": {
-		"@dialecte/core": "0.2.21"
+		"@dialecte/core": "0.2.22"
 	},
 	"devDependencies": {
 		"@dialecte/cli": "0.0.1",
 		"@tsconfig/node24": "^24.0.4",
 		"@types/node": "^24.12.4",
-		"@vitest/browser-playwright": "^4.1.8",
+		"@vitest/browser-playwright": "4.1.8",
 		"husky": "^9.1.7",
 		"jiti": "^2.4.2",
 		"npm-run-all2": "^8.0.4",
@@ -69,11 +69,11 @@
 		"playwright": "^1.60.0",
 		"tsx": "^4.22.4",
 		"typescript": "^6.0.3",
-		"vite": "^8.0.16",
+		"vite": "8.0.16",
 		"vite-plugin-dts": "^5.0.2",
 		"vitepress": "^2.0.0-alpha.17",
 		"vitepress-mermaid-renderer": "^1.1.21",
 		"vitepress-plugin-llms": "^1.13.1",
-		"vitest": "^4.1.8"
+		"vitest": "4.1.8"
 	}
 }