@openscd/scl-lib 2.0.0

package/dist/tSampledValueControl/createSampledValueControl.js

@@ -0,0 +1,74 @@
+import { createElement } from "../foundation/utils.js";
+import { getReference } from "../tBaseElement/getReference.js";
+import { uniqueElementName } from "../foundation/uniqueElementName.js";
+import { connectedAp } from "../tControlWithIEDName/connctedAp.js";
+import { createSMV } from "../tSMV/createSMV.js";
+import { pathId } from "../tControl/pathId.js";
+import { canAddSampledValueControl } from "../tSampledValueControl/canAddSampledValueControl.js";
+function invalidSampledValueControl(ln0, name, datSet) {
+    const uniqueName = name
+        ? !ln0.querySelector(`:scope > SampledValueControl[name="${name}"]`)
+        : true;
+    const validDataSet = datSet
+        ? !!ln0.querySelector(`:scope > DataSet[name="${datSet}"]`)
+        : true;
+    return !(uniqueName && validDataSet && canAddSampledValueControl(ln0));
+}
+/** Utility function to create schema valid `SampledValueControl` and `SMV` elements
+ * @parent Parent element such as `LN0`, `LDevice`, `AccessPoint` and `IED`
+ * @options Configuration for SampledValueControl/SMV element
+ * @returns Edit inserting new `SampledValueControl` to [[`parent`]] element and when possible
+ *          `SMV` to connected `ConnectedAP`
+ * */
+export function createSampledValueControl(parent, options = {
+    smvControl: {},
+    smv: {},
+}) {
+    const ln0 = parent.tagName === "LN0" ? parent : parent.querySelector("LN0");
+    if (!ln0)
+        return [];
+    const name = options.smvControl?.name;
+    const datSet = options.smvControl?.datSet;
+    if (!options.skipCheck && invalidSampledValueControl(ln0, name, datSet))
+        return [];
+    const attributes = { ...options.smvControl };
+    const cbName = name ? name : uniqueElementName(ln0, "SampledValueControl");
+    if (!options.smvControl?.name)
+        attributes.name = cbName;
+    if (!options.smvControl?.multicast)
+        attributes.multicast = "true";
+    if (!options.smvControl?.smpRate)
+        attributes.smpRate = "80";
+    if (!options.smvControl?.nofASDU)
+        attributes.nofASDU = "1";
+    if (!options.smvControl?.smpMod)
+        attributes.smpMod = "SmpPerPeriod";
+    if (!options.smvControl?.smvID)
+        attributes.smvID = pathId(ln0, cbName);
+    const generatedConfRev = options.smvControl?.datSet ? "1" : "0";
+    const userConfRev = options.smvControl?.confRev;
+    attributes.confRev = userConfRev ? userConfRev : generatedConfRev;
+    const smvControl = createElement(ln0.ownerDocument, "SampledValueControl", attributes);
+    const smvOpts = createElement(ln0.ownerDocument, "SmvOpts", options.smvOpts ?? {});
+    smvControl.appendChild(smvOpts);
+    const edits = [];
+    edits.push({
+        parent: ln0,
+        node: smvControl,
+        reference: getReference(ln0, "SampledValueControl"),
+    });
+    const connAp = connectedAp(ln0, options.smv?.apName);
+    if (!connAp)
+        return edits;
+    const ldInst = ln0.closest("LDevice").getAttribute("inst");
+    if (!ldInst || !cbName)
+        return edits;
+    const smvCreateOptions = options.smv ?? {};
+    delete smvCreateOptions.apName;
+    const smvAttrs = { ldInst, cbName };
+    const smvEdit = createSMV(connAp, smvAttrs, smvCreateOptions);
+    if (smvEdit)
+        edits.push(smvEdit);
+    return edits;
+}
+//# sourceMappingURL=createSampledValueControl.js.map

package/dist/tSampledValueControl/createSampledValueControl.js.map

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

package/dist/tSampledValueControl/updateSampledValueControl.d.ts

@@ -0,0 +1,14 @@
+import { Insert, Remove, SetAttributes } from "@openscd/oscd-api";
+/**
+ * Utility function to update SampledValueControl element attributes.
+ * ```md
+ * These attributes trigger additional edits such as
+ * - name: also updates SMV.cbName and supervision references
+ * - datSet: update reference DataSet.name - when DataSet is single use
+ *
+ * >NOTE: confRev attribute is updated +10000 on each data set change
+ * ```
+ * @param setAttributes - diff holding the `SampledValueControl` as element
+ * @returns action array to update all `SampledValueControl` attributes
+ */
+export declare function updateSampledValueControl(setAttributes: SetAttributes): (SetAttributes | Remove | Insert)[];

package/dist/tSampledValueControl/updateSampledValueControl.js

@@ -0,0 +1,60 @@
+import { controlBlockGseOrSmv } from "../tControl/controlBlockGseOrSmv.js";
+import { controlBlockObjRef } from "../tControl/controlBlockObjRef.js";
+import { findControlBlockSubscription } from "../tControl/findControlSubscription.js";
+import { updatedConfRev } from "../tControl/updateConfRev.js";
+import { updateDatSet } from "../tControl/updateDatSet.js";
+/**
+ * Utility function to update SampledValueControl element attributes.
+ * ```md
+ * These attributes trigger additional edits such as
+ * - name: also updates SMV.cbName and supervision references
+ * - datSet: update reference DataSet.name - when DataSet is single use
+ *
+ * >NOTE: confRev attribute is updated +10000 on each data set change
+ * ```
+ * @param setAttributes - diff holding the `SampledValueControl` as element
+ * @returns action array to update all `SampledValueControl` attributes
+ */
+export function updateSampledValueControl(setAttributes) {
+    if (setAttributes.element.tagName !== "SampledValueControl")
+        return [];
+    const updates = [];
+    if (setAttributes.attributes?.name) {
+        const extRefUpdates = findControlBlockSubscription(setAttributes.element).map((extRef) => ({
+            element: extRef,
+            attributes: { srcCBName: setAttributes.attributes.name },
+        }));
+        const supervisionUpdates = Array.from(setAttributes.element.ownerDocument.querySelectorAll(':root > IED > AccessPoint > Server > LDevice > LN[lnClass="LSVS"] > DOI[name="SvCBRef"] > DAI[name="setSrcRef"] > Val'))
+            .filter((val) => val.textContent === controlBlockObjRef(setAttributes.element))
+            .flatMap((val) => {
+            const [path] = controlBlockObjRef(setAttributes.element).split(".");
+            const oldValContent = Array.from(val.childNodes).find((node) => node.nodeType === Node.TEXT_NODE);
+            const newValContent = setAttributes.element.ownerDocument.createTextNode(`${path}.${setAttributes.attributes.name}`);
+            return [
+                { node: oldValContent },
+                { parent: val, node: newValContent, reference: null },
+            ];
+        });
+        const smvUpdate = [];
+        const sMV = controlBlockGseOrSmv(setAttributes.element);
+        if (sMV) {
+            smvUpdate.push({
+                element: sMV,
+                attributes: { cbName: setAttributes.attributes.name },
+            });
+        }
+        updates.push(...extRefUpdates, ...supervisionUpdates, ...smvUpdate);
+    }
+    if (setAttributes.attributes.datSet) {
+        const updateDataSet = updateDatSet(setAttributes);
+        if (updateDataSet)
+            updates.push(updateDataSet);
+        // remove datSet from the update to avoid schema invalidity
+        else
+            delete setAttributes.attributes.datSet;
+        // +10000 for update
+        setAttributes.attributes.confRev = updatedConfRev(setAttributes.element);
+    }
+    return [setAttributes, ...updates];
+}
+//# sourceMappingURL=updateSampledValueControl.js.map

package/dist/tSampledValueControl/updateSampledValueControl.js.map

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

package/dist/tServices/tConfReportControl/maxReportControl.d.ts

@@ -0,0 +1,9 @@
+/** Retrieve the maximum allowed `ReportControl` elements acc. to the
+ * `Services` section of the `AccessPoint` or `IED`. -1 indicates no definition
+ * of maximum `ReportControl` in the `IED`.
+ * @param parent - SCL element within the `IED` or `AccessPoint`
+ * @returns `{max, maxBuf}  attributes of `ConfReportControl`  */
+export declare function maxReportControl(parent: Element): {
+    max: number;
+    maxBuf: number;
+};

package/dist/tServices/tConfReportControl/maxReportControl.js

@@ -0,0 +1,14 @@
+/** Retrieve the maximum allowed `ReportControl` elements acc. to the
+ * `Services` section of the `AccessPoint` or `IED`. -1 indicates no definition
+ * of maximum `ReportControl` in the `IED`.
+ * @param parent - SCL element within the `IED` or `AccessPoint`
+ * @returns `{max, maxBuf}  attributes of `ConfReportControl`  */
+export function maxReportControl(parent) {
+    const selector = `:scope > Services > ConfReportControl`;
+    const [bothMax, bothMaxBuf] = ["max", "maxBuf"].map((attr) => {
+        return ["IED", "AccessPoint"].map((root) => parseInt(parent.closest(root)?.querySelector(selector)?.getAttribute(attr) ??
+            "-1", 10));
+    });
+    return { max: Math.max(...bothMax), maxBuf: Math.max(...bothMaxBuf) };
+}
+//# sourceMappingURL=maxReportControl.js.map

package/dist/tServices/tConfReportControl/maxReportControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maxReportControl.js","sourceRoot":"","sources":["../../../tServices/tConfReportControl/maxReportControl.ts"],"names":[],"mappings":"AAAA;;;;iEAIiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAI9C,MAAM,QAAQ,GAAG,uCAAuC,CAAC;IAEzD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3D,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACzC,QAAQ,CACN,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC;YAC/D,IAAI,EACN,EAAE,CACH,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/dist/tSubstation/removeProcessElement.d.ts

@@ -0,0 +1,9 @@
+import { Remove } from "@openscd/oscd-api";
+/** Updates remove edit for process type element
+ * includes orphan Terminal's and orphan ConnectivityNode's
+ * > NOTE: Process type element potentially hold `ConnectivityNode` and
+ * > `Terminal`. Removing those can leave orphan elements
+ * @param remove - remove edit on precess level elements
+ * @return - enriched remove edit array
+ */
+export declare function removeProcessElement(remove: Remove): Remove[];

package/dist/tSubstation/removeProcessElement.js

@@ -0,0 +1,50 @@
+function isBusBasCNode(cNode) {
+    return cNode.parentElement?.children.length === 1;
+}
+function existOtherTerminalConnection(cNode, terminal) {
+    return !!Array.from(cNode.ownerDocument.querySelectorAll(`Terminal[connectivityNode="${cNode.getAttribute("pathName")}"]`)).filter((otherTerminal) => otherTerminal !== terminal).length;
+}
+function cNodesPerTerminal(terminal) {
+    return Array.from(terminal.ownerDocument.querySelectorAll(`ConnectivityNode[pathName="${terminal.getAttribute("connectivityNode")}"]`));
+}
+function terminalPerCNode(cNode) {
+    return Array.from(cNode.ownerDocument.querySelectorAll(`Terminal[connectivityNode="${cNode.getAttribute("pathName")}"]`));
+}
+function outOfScopeTerminal(root, terminal) {
+    return !Array.from(root.querySelectorAll("Terminal")).find((ancestorTerminal) => ancestorTerminal === terminal);
+}
+function outOfScopeCNode(root, cNode) {
+    return !Array.from(root.querySelectorAll("ConnectivityNode")).find((ancestorCNode) => ancestorCNode === cNode);
+}
+/** Updates remove edit for process type element
+ * includes orphan Terminal's and orphan ConnectivityNode's
+ * > NOTE: Process type element potentially hold `ConnectivityNode` and
+ * > `Terminal`. Removing those can leave orphan elements
+ * @param remove - remove edit on precess level elements
+ * @return - enriched remove edit array
+ */
+export function removeProcessElement(remove) {
+    const element = remove.node;
+    const cNodes = Array.from(element.querySelectorAll("ConnectivityNode"));
+    const removeTerminals = cNodes.flatMap((cNode) => {
+        return terminalPerCNode(cNode)
+            .filter((terminal) => outOfScopeTerminal(element, terminal))
+            .map((terminal) => {
+            return {
+                node: terminal,
+            };
+        });
+    });
+    const terminals = Array.from(element.querySelectorAll("Terminal"));
+    const removeCNodes = terminals.flatMap((terminal) => {
+        return cNodesPerTerminal(terminal)
+            .filter((cNode) => outOfScopeCNode(element, cNode))
+            .filter((cNode) => existOtherTerminalConnection(cNode, terminal))
+            .filter((cNode) => !isBusBasCNode(cNode))
+            .map((cNode) => {
+            return { node: cNode };
+        });
+    });
+    return [remove, ...removeTerminals, ...removeCNodes];
+}
+//# sourceMappingURL=removeProcessElement.js.map

package/dist/tSubstation/removeProcessElement.js.map

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

package/dist/tSubstation/updateLnType.d.ts

@@ -0,0 +1,8 @@
+import { Remove } from "@openscd/oscd-api";
+/**
+ * Removes LNode children DOS, SDS or DAS when missing in the corresponding data type LNodeType
+ * @param lNodeType the data structure for the LNode instance
+ * @param targetDoc the target XML document where the LNode instance is located
+ * @returns an array of Remove edits for the missing elements
+ */
+export declare function updateLnType(lNodeType: Element, targetDoc: XMLDocument): Remove[];

package/dist/tSubstation/updateLnType.js

@@ -0,0 +1,96 @@
+function getDataType(data) {
+    const dataTypeTemplates = data.closest("DataTypeTemplates");
+    if (!dataTypeTemplates)
+        return null;
+    const type = data.getAttribute("type");
+    return dataTypeTemplates.querySelector(`DAType[id="${type}"], DOType[id="${type}"]`);
+}
+function removeMissingSdsOrDas(dataType, dosOrSds) {
+    const removes = [];
+    dosOrSds.querySelectorAll(":scope > SDS, :scope > DAS").forEach((sdsOrDas) => {
+        const name = sdsOrDas.getAttribute("name");
+        const childData = dataType.querySelector(`:scope > DA[name="${name}"], :scope > BDA[name="${name}"], :scope > SDO[name="${name}"]`);
+        if (!childData)
+            removes.push({ node: sdsOrDas });
+        else {
+            const childDataType = getDataType(childData);
+            if (childDataType)
+                removes.push(...removeMissingSdsOrDas(childDataType, sdsOrDas));
+        }
+    });
+    return removes;
+}
+function removeMissingDos(lNodeType, lNode) {
+    const removes = [];
+    lNode.querySelectorAll(":scope > Private > DOS").forEach((dos) => {
+        const doElement = lNodeType.querySelector(`:scope > DO[name="${dos.getAttribute("name")}"]`);
+        if (!doElement)
+            removes.push({ node: dos });
+        else {
+            const dataType = getDataType(doElement);
+            if (dataType)
+                removes.push(...removeMissingSdsOrDas(dataType, dos));
+        }
+    });
+    return removes;
+}
+function lNodeReference(lNode) {
+    let reference = "";
+    const lNodeTag = `${lNode.getAttribute("prefix") || ""}${lNode.getAttribute("lnClass") || ""}${lNode.getAttribute("lnInst") || ""}`;
+    reference = lNodeTag;
+    let child = lNode;
+    while (child.parentElement !== null) {
+        if (child.parentElement.tagName === "SCL")
+            break;
+        const name = child.parentElement.getAttribute("name");
+        // refix the name to the existing prefix seperated by /
+        if (name)
+            reference = `${name}/${reference}`;
+        child = child.parentElement;
+    }
+    return reference;
+}
+function invalidPath(path, dataType, index = 0) {
+    const dataName = path[index];
+    const doElement = dataType.querySelector(`:scope > DO[name="${dataName}"], :scope > SDO[name="${dataName}"], :scope > DA[name="${dataName}"], :scope > BDA[name="${dataName}"]`);
+    if (!doElement)
+        return true;
+    const childDataType = getDataType(doElement);
+    if (!childDataType)
+        return false;
+    if (index + 1 < path.length)
+        return invalidPath(path, childDataType, index + 1);
+    return false;
+}
+function removeInvalidSourceRef(lNodeType, lNode) {
+    const removes = [];
+    const lNodeRef = lNodeReference(lNode);
+    const srcRefs = Array.from(lNode.ownerDocument.querySelectorAll(":root Private SourceRef")).filter(srcRef => srcRef.getAttribute("source")?.startsWith(lNodeRef));
+    srcRefs.forEach((srcRef) => {
+        // source without the starting lNodeRef
+        const srcRefPath = srcRef.getAttribute("source").substring(lNodeRef.length + 1);
+        const path = srcRefPath.split('.');
+        if (invalidPath(path, lNodeType))
+            removes.push({ node: srcRef });
+    });
+    return removes;
+}
+/**
+ * Removes LNode children DOS, SDS or DAS when missing in the corresponding data type LNodeType
+ * @param lNodeType the data structure for the LNode instance
+ * @param targetDoc the target XML document where the LNode instance is located
+ * @returns an array of Remove edits for the missing elements
+ */
+export function updateLnType(lNodeType, targetDoc) {
+    // find all LNode instances in targetDoc with the same lnType
+    const lnType = lNodeType.getAttribute("id");
+    const lNodes = Array.from(targetDoc.querySelectorAll(`:root > Substation LNode[lnType="${lnType}"], :root > Substation > LNode[lnType="${lnType}"]`));
+    if (lNodes.length === 0)
+        return [];
+    // for each LNode instance remove missing DOS, SDS or DAS
+    const removeInstanceData = lNodes.flatMap((lNode) => removeMissingDos(lNodeType, lNode));
+    // remove SourceRef when reference is invalid
+    const removeSrcRef = lNodes.flatMap(lNode => removeInvalidSourceRef(lNodeType, lNode));
+    return [...removeInstanceData, ...removeSrcRef];
+}
+//# sourceMappingURL=updateLnType.js.map

package/dist/tSubstation/updateLnType.js.map

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

package/dist/tSubstation/updateSubstation.d.ts

@@ -0,0 +1,5 @@
+import { SetAttributes } from "@openscd/oscd-api";
+/** Updates `Substation` attributes and cross-referenced elements
+ * @param update - update edit on `Substation` attributes
+ * @returns Completed update edit array */
+export declare function updateSubstation(update: SetAttributes): SetAttributes[];

package/dist/tSubstation/updateSubstation.js

@@ -0,0 +1,75 @@
+function updateSourceRef(element, { oldSubstation, newSubstation, }) {
+    const sourceRefs = Array.from(element.ownerDocument.querySelectorAll('Private[type="eIEC61850-6-100"]>LNodeInputs>SourceRef'));
+    const updates = [];
+    sourceRefs.forEach((srcRef) => {
+        const source = srcRef.getAttribute("source");
+        if (!source)
+            return;
+        const oldPath = `${oldSubstation}`;
+        if (!source.startsWith(oldPath))
+            return;
+        const newPath = `${newSubstation}`;
+        updates.push({
+            element: srcRef,
+            attributes: { source: source.replace(oldPath, newPath) },
+        });
+    });
+    return updates.filter((update) => update);
+}
+function updateConnectivityNodes(substation, substationName) {
+    const cNodes = Array.from(substation.getElementsByTagName("ConnectivityNode"));
+    const updates = [];
+    cNodes.forEach((cNode) => {
+        const cNodeName = cNode.getAttribute("name");
+        const bayName = cNode.parentElement?.getAttribute("name");
+        const voltageLevelName = cNode.parentElement?.parentElement?.getAttribute("name");
+        if (!cNodeName || !bayName || !voltageLevelName)
+            return;
+        const connectivityNode = `${substationName}/${voltageLevelName}/${bayName}/${cNodeName}`;
+        updates.push({
+            element: cNode,
+            attributes: { pathName: connectivityNode },
+        });
+        const oldConnectivityNode = cNode.getAttribute("pathName");
+        if (!oldConnectivityNode)
+            return;
+        updates.push(...updateTerminals(substation, {
+            oldConnectivityNode,
+            connectivityNode,
+            substationName,
+        }));
+    });
+    return updates.filter((update) => update);
+}
+function updateTerminals(element, { oldConnectivityNode, connectivityNode, substationName, }) {
+    const terminals = Array.from(element.closest("Substation").querySelectorAll(`Terminal[connectivityNode="${oldConnectivityNode}"],
+       NeutralPoint[connectivityNode="${oldConnectivityNode}"]`));
+    const updates = terminals.map((terminal) => ({
+        element: terminal,
+        attributes: {
+            connectivityNode,
+            substationName,
+        },
+    }));
+    return updates;
+}
+/** Updates `Substation` attributes and cross-referenced elements
+ * @param update - update edit on `Substation` attributes
+ * @returns Completed update edit array */
+export function updateSubstation(update) {
+    if (update.element.tagName !== "Substation")
+        return [update];
+    const substation = update.element;
+    const attributes = update.attributes;
+    if (!attributes?.name)
+        return [update];
+    const oldName = substation.getAttribute("name");
+    const newName = attributes.name;
+    if (!oldName || oldName === newName)
+        return [update];
+    return [update].concat(...updateConnectivityNodes(substation, newName), ...updateSourceRef(substation, {
+        oldSubstation: oldName,
+        newSubstation: newName,
+    }));
+}
+//# sourceMappingURL=updateSubstation.js.map

package/dist/tSubstation/updateSubstation.js.map

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

package/dist/tVoltageLevel/updateVoltageLevel.d.ts

@@ -0,0 +1,5 @@
+import { SetAttributes } from "@openscd/oscd-api";
+/** Updates `VoltageLevel` attributes and cross-referenced elements
+ * @param setAttributes - update edit on `VoltageLevel` attributes
+ * @returns Completed update edit array */
+export declare function updateVoltageLevel(setAttributes: SetAttributes): SetAttributes[];

package/dist/tVoltageLevel/updateVoltageLevel.js

@@ -0,0 +1,83 @@
+function updateSourceRef(element, { oldSubstation, oldVoltageLevel, newVoltageLevel, }) {
+    const sourceRefs = Array.from(element.ownerDocument.querySelectorAll('Private[type="eIEC61850-6-100"]>LNodeInputs>SourceRef'));
+    const updates = [];
+    sourceRefs.forEach((srcRef) => {
+        const source = srcRef.getAttribute("source");
+        if (!source)
+            return;
+        const oldPath = `${oldSubstation}/${oldVoltageLevel}`;
+        if (!source.startsWith(oldPath))
+            return;
+        const newPath = `${oldSubstation}/${newVoltageLevel}`;
+        updates.push({
+            element: srcRef,
+            attributes: { source: source.replace(oldPath, newPath) },
+        });
+    });
+    return updates.filter((update) => update);
+}
+function updateConnectivityNodes(element, { substation, voltageLevelName, }) {
+    const cNodes = Array.from(element.getElementsByTagName("ConnectivityNode"));
+    const updates = [];
+    cNodes.forEach((cNode) => {
+        const cNodeName = cNode.getAttribute("name");
+        const bayName = cNode.parentElement?.getAttribute("name");
+        if (!cNodeName || !bayName)
+            return;
+        const connectivityNode = `${substation}/${voltageLevelName}/${bayName}/${cNodeName}`;
+        updates.push({
+            element: cNode,
+            attributes: { pathName: connectivityNode },
+        });
+        const oldConnectivityNode = cNode.getAttribute("pathName");
+        if (!oldConnectivityNode)
+            return;
+        updates.push(...updateTerminals(element, {
+            oldConnectivityNode,
+            connectivityNode,
+            voltageLevelName,
+        }));
+    });
+    return updates;
+}
+function updateTerminals(element, { oldConnectivityNode, connectivityNode, voltageLevelName, }) {
+    const terminals = Array.from(element.closest("Substation").querySelectorAll(`Terminal[connectivityNode="${oldConnectivityNode}"],
+       NeutralPoint[connectivityNode="${oldConnectivityNode}"]`));
+    const updates = terminals.map((terminal) => {
+        return {
+            element: terminal,
+            attributes: {
+                connectivityNode,
+                voltageLevelName,
+            },
+        };
+    });
+    return updates;
+}
+/** Updates `VoltageLevel` attributes and cross-referenced elements
+ * @param setAttributes - update edit on `VoltageLevel` attributes
+ * @returns Completed update edit array */
+export function updateVoltageLevel(setAttributes) {
+    if (setAttributes.element.tagName !== "VoltageLevel")
+        return [setAttributes];
+    const voltageLevel = setAttributes.element;
+    const attributes = setAttributes.attributes;
+    if (!attributes?.name)
+        return [setAttributes];
+    const oldName = voltageLevel.getAttribute("name");
+    const substationName = voltageLevel
+        .closest("Substation")
+        ?.getAttribute("name");
+    const newName = attributes.name;
+    if (!substationName || !oldName || oldName === newName)
+        return [setAttributes];
+    return [setAttributes].concat(...updateConnectivityNodes(voltageLevel, {
+        substation: substationName,
+        voltageLevelName: newName,
+    }), ...updateSourceRef(voltageLevel, {
+        oldSubstation: substationName,
+        oldVoltageLevel: oldName,
+        newVoltageLevel: newName,
+    }));
+}
+//# sourceMappingURL=updateVoltageLevel.js.map

package/dist/tVoltageLevel/updateVoltageLevel.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@openscd/scl-lib",
+  "description": "Function library supporting SCL editing",
+  "license": "Apache-2.0",
+  "author": "Jakob Vogelsang",
+  "version": "2.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "/dist/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openscd/scl-lib.git"
+  },
+  "scripts": {
+    "lint": "eslint --ext .ts,.html . --ignore-path .gitignore && prettier \"**/*.ts\" --check --ignore-path .gitignore",
+    "format": "eslint --ext .ts,.html . --fix --ignore-path .gitignore && prettier \"**/*.ts\" --write --ignore-path .gitignore",
+    "test": "wtr --coverage",
+    "test:watch": "wtr --watch --coverage",
+    "doc": "npx rimraf doc && typedoc --out doc index.ts",
+    "deploy": "npm run doc && gh-pages --dist 'doc'",
+    "build": "npx rimraf dist && tsc"
+  },
+  "dependencies": {
+    "@openscd/oscd-api": "0.1.5"
+  },
+  "devDependencies": {
+    "@types/mocha": "^10.0.1",
+    "@typescript-eslint/eslint-plugin": "^5.59.5",
+    "@typescript-eslint/parser": "^5.59.5",
+    "@web/dev-server-esbuild": "^1.0.4",
+    "@web/test-runner": "^0.20.2",
+    "chai": "npm:@esm-bundle/chai@^4.3.4-fix.0",
+    "concurrently": "^8.0.1",
+    "eslint": "^8.40.0",
+    "gh-pages": "^5.0.0",
+    "prettier": "^3.1.0",
+    "typedoc": "^0.24.7",
+    "typescript": "^5.0.4"
+  }
+}