@openscd/scl-lib 2.0.0

package/dist/tLN/removeSubscriptionSupervision.js

@@ -0,0 +1,94 @@
+import { controlBlockObjRef } from "../tControl/controlBlockObjRef.js";
+import { sourceControlBlock } from "../tExtRef/sourceControlBlock.js";
+import { isSrcRefEditable } from "./supervision/foundation.js";
+/** @returns Element to remove the subscription supervision */
+function removableSupervisionElement(ctrlBlock, subscriberIed) {
+    const supervisionType = ctrlBlock.tagName === "GSEControl" ? "LGOS" : "LSVS";
+    const doiName = ctrlBlock.tagName === "GSEControl" ? "GoCBRef" : "SvCBRef";
+    const valElement = Array.from(subscriberIed.querySelectorAll(`LN[lnClass="${supervisionType}"] > DOI[name="${doiName}"] > DAI[name="setSrcRef"] > Val`)).find((val) => val.textContent === controlBlockObjRef(ctrlBlock));
+    if (!valElement)
+        return null;
+    const ln = valElement.closest("LN");
+    // do not remove logical nodes `LGOS`, `LSVS` unless privately tagged
+    const canRemoveLn = ln.querySelector(':scope > Private[type="OpenSCD.create"]');
+    if (canRemoveLn)
+        return ln;
+    return (Array.from(valElement.childNodes).find((child) => child.nodeType === Node.TEXT_NODE) ?? null);
+}
+/** @returns Whether `DA` with name `setSrcRef` can edited by SCL editor */
+function isSupervisionEditable(ctrlBlock, subscriberIed) {
+    const supervisionElement = removableSupervisionElement(ctrlBlock, subscriberIed);
+    if (!supervisionElement)
+        return false;
+    let supervisionLn = null;
+    if (supervisionElement.nodeType === Node.TEXT_NODE) {
+        supervisionLn = supervisionElement.parentElement?.closest("LN") ?? null;
+    }
+    else {
+        supervisionLn = supervisionElement.closest("LN") ?? null;
+    }
+    if (!supervisionLn)
+        return false;
+    return isSrcRefEditable(supervisionLn);
+}
+/** @returns Whether other subscribed ExtRef of the same control block exist */
+function isControlBlockSubscribed(extRefs) {
+    const [srcCBName, srcLDInst, srcLNClass, iedName, srcPrefix, srcLNInst, serviceType,] = [
+        "srcCBName",
+        "srcLDInst",
+        "srcLNClass",
+        "iedName",
+        "srcPrefix",
+        "srcLNInst",
+        "serviceType",
+    ].map((attr) => extRefs[0].getAttribute(attr));
+    const parentIed = extRefs[0].closest("IED");
+    return Array.from(parentIed.getElementsByTagName("ExtRef")).some((otherExtRef) => !extRefs.includes(otherExtRef) &&
+        (otherExtRef.getAttribute("srcPrefix") ?? "") === (srcPrefix ?? "") &&
+        (otherExtRef.getAttribute("srcLNInst") ?? "") === (srcLNInst ?? "") &&
+        otherExtRef.getAttribute("srcCBName") === srcCBName &&
+        otherExtRef.getAttribute("srcLDInst") === srcLDInst &&
+        otherExtRef.getAttribute("srcLNClass") === srcLNClass &&
+        otherExtRef.getAttribute("iedName") === iedName &&
+        otherExtRef.getAttribute("serviceType") === serviceType);
+}
+function cannotRemoveSupervision(extRefGroup) {
+    return (isControlBlockSubscribed(extRefGroup.extRefs) ||
+        !isSupervisionEditable(extRefGroup.ctrlBlock, extRefGroup.subscriberIed));
+}
+function groupPerControlBlock(extRefs) {
+    const groupedExtRefs = {};
+    extRefs.forEach((extRef) => {
+        const ctrlBlock = sourceControlBlock(extRef);
+        if (ctrlBlock) {
+            const ctrlBlockRef = controlBlockObjRef(ctrlBlock);
+            if (groupedExtRefs[ctrlBlockRef])
+                groupedExtRefs[ctrlBlockRef].extRefs.push(extRef);
+            else
+                groupedExtRefs[ctrlBlockRef] = {
+                    extRefs: [extRef],
+                    ctrlBlock,
+                    subscriberIed: extRef.closest("IED"),
+                };
+        }
+    });
+    return groupedExtRefs;
+}
+/** Removes subscription supervision - `LGOS` or `LSVS` - when no other data
+ * of a given `GSEControl` or `SampledValueControl`
+ * @param extRefs - An array of external reference elements
+ * @returns edits to remove subscription supervision `LGOS` or `LSVS`
+ */
+export function removeSubscriptionSupervision(extRefs) {
+    if (extRefs.length === 0)
+        return [];
+    const groupedExtRefs = groupPerControlBlock(extRefs);
+    return Object.values(groupedExtRefs)
+        .map((extRefGroup) => {
+        if (cannotRemoveSupervision(extRefGroup))
+            return null;
+        return removableSupervisionElement(extRefGroup.ctrlBlock, extRefGroup.subscriberIed);
+    })
+        .filter((element) => element).map((node) => ({ node }));
+}
+//# sourceMappingURL=removeSubscriptionSupervision.js.map

package/dist/tLN/removeSubscriptionSupervision.js.map

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

package/dist/tLN/supervision/canInstantiateSubscriptionSupervision.d.ts

@@ -0,0 +1,13 @@
+import { Supervision, SupervisionOptions } from "./foundation.js";
+/** Whether subscription supervision instantiation can be performed.
+ * ```md
+ * - check if `valImport` and `valKind` allow to change subscriber logical node
+ * - check whether the control block is already supervised in the IED
+ * - check whether there is an available location for the control block
+ *   reference to be stored in the supervision source reference.
+ * - check whether `Service` element requirements are met
+ * - check whether the logical node has missing or empty `Val` content
+ *   (iedOrLn is LN)
+ * ```
+ * @returns Whether subscription supervision can be done */
+export declare function canInstantiateSubscriptionSupervision(supervision: Supervision, options?: SupervisionOptions): boolean;

package/dist/tLN/supervision/canInstantiateSubscriptionSupervision.js

@@ -0,0 +1,116 @@
+import { controlBlockObjRef } from "../../tControl/controlBlockObjRef.js";
+import { supervisionLnClass, type, } from "./foundation.js";
+/** @returns Whether a supervision LN holds a valid control block object ref */
+function holdsValidObjRef(ln, type) {
+    const objRef = ln.querySelector(`:scope > DOI[name="${type}"] > DAI[name="setSrcRef"] > Val`)?.textContent;
+    if (!objRef)
+        return false;
+    // IEDnameLDinst/prefixLnClassLnInst.CbName
+    const indexSlash = objRef.indexOf("/");
+    const indexDot = objRef.indexOf(".");
+    return (indexSlash !== 0 &&
+        indexSlash < indexDot + 1 &&
+        indexDot - 1 < objRef.length);
+}
+/** @returns Whether `Services` element requirement is met */
+function withinSupervisionLimits(supervision) {
+    const subscriberIed = supervision.subscriberIedOrLn.tagName === "IED"
+        ? supervision.subscriberIedOrLn
+        : supervision.subscriberIedOrLn.closest("IED");
+    const lnClass = supervisionLnClass(supervision);
+    const max = subscriberIed
+        ?.querySelector("Services > SupSubscription")
+        ?.getAttribute(`${lnClass === "LGOS" ? "maxGo" : "maxSv"}`);
+    if (!max || isNaN(parseInt(max, 10)))
+        return false;
+    const existingSupervisionLNs = Array.from(subscriberIed.querySelectorAll(`LN[lnClass="${lnClass}"]`));
+    if (existingSupervisionLNs.length < parseInt(max, 10))
+        return true;
+    const availableSupervisorSpots = existingSupervisionLNs.filter((ln) => !holdsValidObjRef(ln, type(supervision)));
+    return (existingSupervisionLNs.length === parseInt(max, 10) &&
+        availableSupervisorSpots.length > 0);
+}
+/** @returns Whether `DA`|`DAI` with name `setSrcRef` is editable */
+function isSrcRefEditable(supervision) {
+    const lnClass = supervisionLnClass(supervision);
+    const ln = supervision.subscriberIedOrLn.tagName === "LN"
+        ? supervision.subscriberIedOrLn
+        : supervision.subscriberIedOrLn.querySelector(`LN[lnClass="${lnClass}"]`);
+    const doiName = type(supervision);
+    if (ln.querySelector(`:scope > DOI[name="${doiName}"] > 
+        DAI[name="setSrcRef"][valImport="true"][valKind="RO"],
+       :scope > DOI[name="${doiName}"] > 
+        DAI[name="setSrcRef"][valImport="true"][valKind="Conf"]`))
+        return true;
+    const rootNode = ln.ownerDocument;
+    const lnType = ln.getAttribute("lnType");
+    const goOrSvCBRef = rootNode.querySelector(`DataTypeTemplates > 
+            LNodeType[id="${lnType}"][lnClass="${lnClass}"] > DO[name="${type(supervision)}"]`);
+    const cbRefId = goOrSvCBRef?.getAttribute("type");
+    const setSrcRef = rootNode.querySelector(`DataTypeTemplates > DOType[id="${cbRefId}"] > DA[name="setSrcRef"]`);
+    return ((setSrcRef?.getAttribute("valKind") === "Conf" ||
+        setSrcRef?.getAttribute("valKind") === "RO") &&
+        setSrcRef.getAttribute("valImport") === "true");
+}
+/**
+ * A pre requirement for a subscription supervision is an already existing
+ * LN of the class `LGOS` or `LSVS` in the subscriber IED.
+ * @returns Whether there is a logical node element `LN` with the class `LGOS`, `LSVS`
+ */
+function existFirstSupervisionOfType(supervision) {
+    const lnClass = supervision.sourceControlBlock.tagName === "GSEControl" ? "LGOS" : "LSVS";
+    const firstSupervisionOfType = supervision.subscriberIedOrLn.querySelector(`:scope > AccessPoint > Server > LDevice > LN[lnClass="${lnClass}"]`);
+    return firstSupervisionOfType ? true : false;
+}
+/** @returns Whether [[`controlBlock`]] is supervised in [[`subscriberIed`]] */
+function isControlBlockSupervised(supervision) {
+    const subscriberIed = supervision.subscriberIedOrLn.tagName === "IED"
+        ? supervision.subscriberIedOrLn
+        : supervision.subscriberIedOrLn.closest("IED");
+    const lnClass = supervision.sourceControlBlock.tagName === "GSEControl" ? "LGOS" : "LSVS";
+    const refType = supervision.sourceControlBlock.tagName === "GSEControl"
+        ? "GoCBRef"
+        : "SvCBRef";
+    return Array.from(subscriberIed?.querySelectorAll(`:scope > AccessPoint > Server > LDevice > LN[lnClass="${lnClass}"] 
+      > DOI[name="${refType}"] > DAI[name="setSrcRef"] > Val`)).some((val) => val.textContent === controlBlockObjRef(supervision.sourceControlBlock));
+}
+/** Whether subscription supervision instantiation can be performed.
+ * ```md
+ * - check if `valImport` and `valKind` allow to change subscriber logical node
+ * - check whether the control block is already supervised in the IED
+ * - check whether there is an available location for the control block
+ *   reference to be stored in the supervision source reference.
+ * - check whether `Service` element requirements are met
+ * - check whether the logical node has missing or empty `Val` content
+ *   (iedOrLn is LN)
+ * ```
+ * @returns Whether subscription supervision can be done */
+export function canInstantiateSubscriptionSupervision(supervision, options = {
+    newSupervisionLn: false,
+    fixedLnInst: -1,
+    checkEditableSrcRef: true,
+    checkDuplicateSupervisions: true,
+    checkMaxSupervisionLimits: true,
+}) {
+    if (options.checkDuplicateSupervisions &&
+        isControlBlockSupervised(supervision))
+        return false;
+    if (supervision.subscriberIedOrLn.tagName === "LN") {
+        const type = supervision.sourceControlBlock.tagName === "GSEControl"
+            ? "GoCBRef"
+            : "SvCBRef";
+        if (holdsValidObjRef(supervision.subscriberIedOrLn, type))
+            return false;
+    }
+    else {
+        if (!existFirstSupervisionOfType(supervision))
+            return false;
+    }
+    if (options.checkMaxSupervisionLimits &&
+        !withinSupervisionLimits(supervision))
+        return false;
+    if (options.checkEditableSrcRef && !isSrcRefEditable(supervision))
+        return false;
+    return true;
+}
+//# sourceMappingURL=canInstantiateSubscriptionSupervision.js.map

package/dist/tLN/supervision/canInstantiateSubscriptionSupervision.js.map

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

package/dist/tLN/supervision/createSupervisionEdit.d.ts

@@ -0,0 +1,20 @@
+import { Insert } from "@openscd/oscd-api";
+import { Supervision } from "./foundation.js";
+type SupervisionWithDynamicInst = {
+    usedSupervisions?: Set<Element>;
+    instGenerator: (supervision: Supervision) => string | undefined;
+};
+type SupervisionWithFixedInst = {
+    usedSupervisions?: Set<Element>;
+    fixedInst: string;
+};
+type NewSupervisionLN = {
+    usedSupervisions?: Set<Element>;
+    newSupervisionLn: boolean;
+    fixedInst?: string;
+    instGenerator: (supervision: Supervision) => string | undefined;
+};
+type CreateSupervisionOptions = NewSupervisionLN | SupervisionWithFixedInst | SupervisionWithDynamicInst;
+/** @returns Insert edit on unused supervision logical node or new supervision logical node */
+export declare function createSupervisionEdit(supervision: Supervision, options: CreateSupervisionOptions): Insert | null;
+export {};

package/dist/tLN/supervision/createSupervisionEdit.js

@@ -0,0 +1,129 @@
+import { createElement } from "../../foundation/utils.js";
+import { getReference } from "../../tBaseElement/getReference.js";
+import { controlBlockObjRef } from "../../tControl/controlBlockObjRef.js";
+import { supervisionLnClass, type } from "./foundation.js";
+function isFixedInst(options) {
+    return "fixedInst" in options;
+}
+function isNewSupervisionLn(options) {
+    return "newSupervisionLn" in options;
+}
+function createSupervisionDaiElement(input) {
+    const dai = createElement(input.doc, "DAI", { name: "setSrcRef" });
+    const val = createElement(input.doc, "Val", {});
+    dai.appendChild(val);
+    val.textContent = input.controlBlockReference;
+    return dai;
+}
+function createSupervisionDoiElement(input) {
+    const doi = createElement(input.doc, "DOI", { name: input.cbRefType });
+    const dai = createElement(input.doc, "DAI", { name: "setSrcRef" });
+    const val = createElement(input.doc, "Val", {});
+    doi.appendChild(dai);
+    dai.appendChild(val);
+    val.textContent = input.controlBlockReference;
+    return doi;
+}
+function cdRefType(logicalNode) {
+    const lnClass = logicalNode.getAttribute("lnClass");
+    const cbRefType = lnClass === "LGOS" ? "GoCBRef" : "SvCBRef";
+    return cbRefType;
+}
+function availableSupervisionLn(supervision, usedSupervisions) {
+    const lnClass = supervisionLnClass(supervision);
+    const cbRefType = type(supervision);
+    return (Array.from(supervision.subscriberIedOrLn.querySelectorAll(`:scope > AccessPoint > Server > LDevice > LN[lnClass="${lnClass}"]`))
+        // filter already used available logical nodes
+        .filter((ln) => !usedSupervisions?.has(ln))
+        .find((ln) => {
+        return (ln.querySelector(`:scope > DOI[name="${cbRefType}"] > DAI[name="setSrcRef"] > Val`) === null ||
+            ln.querySelector(`:scope > DOI[name="${cbRefType}"] > DAI[name="setSrcRef"] > Val`)?.textContent === "");
+    }) ?? null);
+}
+function createSupervisionLogicalNode(supervision, controlBlockReference, inst) {
+    const subscriberIed = supervision.subscriberIedOrLn;
+    const lnClass = supervisionLnClass(supervision);
+    const formLn = subscriberIed.querySelector(`LN[lnClass="${lnClass}"]`);
+    const parent = formLn.parentElement;
+    const lnType = formLn.getAttribute("lnType");
+    const prefix = formLn.getAttribute("prefix");
+    const ln = createElement(subscriberIed.ownerDocument, "LN", {
+        prefix,
+        lnClass,
+        lnType,
+        inst,
+    });
+    const openScdTag = createElement(subscriberIed.ownerDocument, "Private", {
+        type: "OpenSCD.create",
+    });
+    ln.appendChild(openScdTag);
+    const lastSupervisionLn = parent.querySelector(`:scope > LN[lnClass="${lnClass}"]:last-child`);
+    const reference = lastSupervisionLn
+        ? lastSupervisionLn.nextElementSibling
+        : getReference(parent, "LN");
+    const doc = ln.ownerDocument;
+    const cbRefType = cdRefType(ln);
+    ln.appendChild(createSupervisionDoiElement({
+        doc,
+        cbRefType,
+        controlBlockReference,
+    }));
+    return { parent, node: ln, reference };
+}
+function updateSupervisionLogicalNode(controlBlockReference, logicalNode) {
+    const doc = logicalNode.ownerDocument;
+    const cbRefType = cdRefType(logicalNode);
+    const createSupervisionElementInput = {
+        doc,
+        cbRefType,
+        controlBlockReference,
+    };
+    const doi = logicalNode.querySelector(`:scope > DOI[name="${cbRefType}"]`);
+    if (!doi)
+        return {
+            parent: logicalNode,
+            node: createSupervisionDoiElement(createSupervisionElementInput),
+            reference: getReference(logicalNode, "DOI"),
+        };
+    const dai = logicalNode.querySelector(`:scope > DOI[name="${cbRefType}"] > DAI[name="setSrcRef"]`);
+    if (!dai)
+        return {
+            parent: doi,
+            node: createSupervisionDaiElement(createSupervisionElementInput),
+            reference: getReference(doi, "DAI"),
+        };
+    const val = logicalNode.querySelector(`:scope > DOI[name="${cbRefType}"] > DAI[name="setSrcRef"] > Val`);
+    if (!val) {
+        const newVal = createElement(doc, "Val", {});
+        dai.appendChild(newVal);
+        newVal.textContent = controlBlockReference;
+        return { parent: dai, node: newVal, reference: getReference(dai, "Val") };
+    }
+    const cbRef = document.createTextNode(controlBlockReference);
+    return { parent: val, node: cbRef, reference: null };
+}
+/** @returns Insert edit on unused supervision logical node or new supervision logical node */
+export function createSupervisionEdit(supervision, options) {
+    const sourceControlBlock = supervision.sourceControlBlock;
+    const controlBlockReference = controlBlockObjRef(sourceControlBlock);
+    if (!controlBlockReference)
+        return null;
+    if (supervision.subscriberIedOrLn.tagName === "LN")
+        return updateSupervisionLogicalNode(controlBlockReference, supervision.subscriberIedOrLn);
+    if (isNewSupervisionLn(options) && options.newSupervisionLn) {
+        const inst = options.fixedInst
+            ? options.fixedInst
+            : options.instGenerator(supervision);
+        return createSupervisionLogicalNode(supervision, controlBlockReference, inst);
+    }
+    const unusedSupervisionLogicalNode = availableSupervisionLn(supervision, options?.usedSupervisions);
+    if (!unusedSupervisionLogicalNode) {
+        const inst = isFixedInst(options)
+            ? options.fixedInst
+            : options.instGenerator(supervision);
+        return createSupervisionLogicalNode(supervision, controlBlockReference, inst);
+    }
+    options.usedSupervisions?.add(unusedSupervisionLogicalNode);
+    return updateSupervisionLogicalNode(controlBlockReference, unusedSupervisionLogicalNode);
+}
+//# sourceMappingURL=createSupervisionEdit.js.map

package/dist/tLN/supervision/createSupervisionEdit.js.map

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

package/dist/tLN/supervision/findControlBlockOnSrcAttributes.d.ts

@@ -0,0 +1,10 @@
+export type ExtRefSource = {
+    iedName: string;
+    ldInst: string;
+    prefix: string;
+    lnClass: string;
+    lnInst: string;
+    cbName: string;
+};
+/** @returns control block or null for a set of ExtRef attributes */
+export declare function findControlBlockBySrcAttributes(doc: XMLDocument, extRefSrc: ExtRefSource): Element | null;

package/dist/tLN/supervision/findControlBlockOnSrcAttributes.js

@@ -0,0 +1,13 @@
+/** @returns control block or null for a set of ExtRef attributes */
+export function findControlBlockBySrcAttributes(doc, extRefSrc) {
+    return (Array.from(doc.querySelectorAll(`:root > IED[name="${extRefSrc.iedName}"] ReportControl, 
+            :root > IED[name="${extRefSrc.iedName}"] GSEControl, 
+            :root > IED[name="${extRefSrc.iedName}"] SampledValueControl`)).find((cBlock) => cBlock.closest("LDevice").getAttribute("inst") === extRefSrc.ldInst &&
+        (cBlock.closest("LN, LN0").getAttribute("prefix") ?? "") ===
+            extRefSrc.prefix &&
+        cBlock.closest("LN, LN0").getAttribute("lnClass") ===
+            extRefSrc.lnClass &&
+        cBlock.closest("LN, LN0").getAttribute("inst") === extRefSrc.lnInst &&
+        cBlock.getAttribute("name") === extRefSrc.cbName) ?? null);
+}
+//# sourceMappingURL=findControlBlockOnSrcAttributes.js.map

package/dist/tLN/supervision/findControlBlockOnSrcAttributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findControlBlockOnSrcAttributes.js","sourceRoot":"","sources":["../../../tLN/supervision/findControlBlockOnSrcAttributes.ts"],"names":[],"mappings":"AASA,oEAAoE;AACpE,MAAM,UAAU,+BAA+B,CAC7C,GAAgB,EAChB,SAAuB;IAEvB,OAAO,CACL,KAAK,CAAC,IAAI,CACR,GAAG,CAAC,gBAAgB,CAClB,qBAAqB,SAAS,CAAC,OAAO;gCACd,SAAS,CAAC,OAAO;gCACjB,SAAS,CAAC,OAAO,wBAAwB,CAClE,CACF,CAAC,IAAI,CACJ,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,OAAO,CAAC,SAAS,CAAE,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,MAAM;QACpE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACvD,SAAS,CAAC,MAAM;QAClB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAE,CAAC,YAAY,CAAC,SAAS,CAAC;YAChD,SAAS,CAAC,OAAO;QACnB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAE,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,MAAM;QACpE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,MAAM,CACnD,IAAI,IAAI,CACV,CAAC;AACJ,CAAC"}

package/dist/tLN/supervision/foundation.d.ts

@@ -0,0 +1,37 @@
+export type Supervision = {
+    /**
+     * Reference to the supervision location either as the subscriber IED
+     * or the logical node of the class `LGOS`/`LSVS` itself
+     */
+    subscriberIedOrLn: Element;
+    /** The control block to be supervised */
+    sourceControlBlock: Element;
+};
+export type SupervisionOptions = {
+    /** Whether supervision instantiation shall be with new logical node instance */
+    newSupervisionLn: boolean;
+    /**
+     * A fixed `inst` attribute for a new logical node (LGOS/LSVS) instance
+     * otherwise ignored. The default -1 sets the `inst` attribute automatically.
+     */
+    fixedLnInst: number;
+    /** Whether to check for `valKind`/`valImport`. Defaulting to true */
+    checkEditableSrcRef: boolean;
+    /**
+     * Whether the given control block is already supervised in the subscriber
+     * IED. Defaulting to true.
+     */
+    checkDuplicateSupervisions: boolean;
+    /**
+     * Whether a new supervision would exceed the limits set in the `Services`
+     * section or whether an existing supervision LN control block reference is
+     * empty or invalid and can be used. Defaulting to true.
+     */
+    checkMaxSupervisionLimits: boolean;
+};
+export declare function type(supervision: Supervision): "GoCBRef" | "SvCBRef";
+export declare function supervisionLnClass(supervision: Supervision): "LGOS" | "LSVS";
+/** @returns Unique attribute `inst` for supervision logical nodes. */
+export declare function globalLnInstGenerator(): (supervision: Supervision) => string | undefined;
+/** @returns Whether child `DA` with name `setSrcRef` can edited by SCL editor */
+export declare function isSrcRefEditable(supervisionLn: Element): boolean;

package/dist/tLN/supervision/foundation.js

@@ -0,0 +1,43 @@
+import { lnInstGenerator } from "../../generator/lnInstGenerator.js";
+export function type(supervision) {
+    const serviceType = supervision.sourceControlBlock.tagName;
+    return serviceType === "GSEControl" ? "GoCBRef" : "SvCBRef";
+}
+export function supervisionLnClass(supervision) {
+    const serviceType = supervision.sourceControlBlock.tagName;
+    return serviceType === "GSEControl" ? "LGOS" : "LSVS";
+}
+/** @returns Unique attribute `inst` for supervision logical nodes. */
+export function globalLnInstGenerator() {
+    const lnInstGenerators = new Map();
+    return (supervision) => {
+        const ied = supervision.subscriberIedOrLn;
+        const lnClass = supervisionLnClass(supervision);
+        const formLn = ied.querySelector(`LN[lnClass="${lnClass}"]`);
+        const lDevice = formLn.parentElement;
+        const iedName = `${ied.getAttribute("name")}`;
+        if (!lnInstGenerators.has(iedName))
+            lnInstGenerators.set(iedName, lnInstGenerator(lDevice, "LN"));
+        return lnInstGenerators.get(iedName)(lnClass);
+    };
+}
+/** @returns Whether child `DA` with name `setSrcRef` can edited by SCL editor */
+export function isSrcRefEditable(supervisionLn) {
+    const lnClass = supervisionLn.getAttribute("lnClass");
+    const cbRefType = lnClass === "LGOS" ? "GoCBRef" : "SvCBRef";
+    if (supervisionLn.querySelector(`:scope > DOI[name="${cbRefType}"] > 
+        DAI[name="setSrcRef"][valImport="true"][valKind="RO"],
+       :scope > DOI[name="${cbRefType}"] > 
+        DAI[name="setSrcRef"][valImport="true"][valKind="Conf"]`))
+        return true;
+    const rootNode = supervisionLn.ownerDocument;
+    const lnType = supervisionLn.getAttribute("lnType");
+    const goOrSvCBRef = rootNode.querySelector(`DataTypeTemplates > 
+        LNodeType[id="${lnType}"][lnClass="${lnClass}"] > DO[name="${cbRefType}"]`);
+    const cbRefId = goOrSvCBRef?.getAttribute("type");
+    const setSrcRef = rootNode.querySelector(`DataTypeTemplates > DOType[id="${cbRefId}"] > DA[name="setSrcRef"]`);
+    return ((setSrcRef?.getAttribute("valKind") === "Conf" ||
+        setSrcRef?.getAttribute("valKind") === "RO") &&
+        setSrcRef.getAttribute("valImport") === "true");
+}
+//# sourceMappingURL=foundation.js.map

package/dist/tLN/supervision/foundation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation.js","sourceRoot":"","sources":["../../../tLN/supervision/foundation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAmCrE,MAAM,UAAU,IAAI,CAAC,WAAwB;IAC3C,MAAM,WAAW,GAAG,WAAW,CAAC,kBAAkB,CAAC,OAAO,CAAC;IAC3D,OAAO,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAwB;IACzD,MAAM,WAAW,GAAG,WAAW,CAAC,kBAAkB,CAAC,OAAO,CAAC;IAC3D,OAAO,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AACxD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,qBAAqB;IAGnC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAG7B,CAAC;IAEJ,OAAO,CAAC,WAAW,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,WAAW,CAAC,iBAAiB,CAAC;QAC1C,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,eAAe,OAAO,IAAI,CAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,aAAc,CAAC;QAEtC,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;YAChC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAEhE,OAAO,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,aAAsB;IACrD,MAAM,OAAO,GAAG,aAAa,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7D,IACE,aAAa,CAAC,aAAa,CACzB,sBAAsB,SAAS;;4BAET,SAAS;gEAC2B,CAC3D;QAED,OAAO,IAAI,CAAC;IAEd,MAAM,QAAQ,GAAG,aAAa,CAAC,aAAa,CAAC;IAC7C,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEpD,MAAM,WAAW,GAAG,QAAQ,CAAC,aAAa,CACxC;wBACoB,MAAM,eAAe,OAAO,iBAAiB,SAAS,IAAI,CAC/E,CAAC;IAEF,MAAM,OAAO,GAAG,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CACtC,kCAAkC,OAAO,2BAA2B,CACrE,CAAC;IAEF,OAAO,CACL,CAAC,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,KAAK,MAAM;QAC5C,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;QAC9C,SAAS,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,MAAM,CAC/C,CAAC;AACJ,CAAC"}

package/dist/tLN/supervision/insertSubscriptionSupervisions.d.ts

@@ -0,0 +1,11 @@
+import { Insert, SetAttributes } from "@openscd/oscd-api";
+/**
+ * Insert supervisions triggered by an array of subscribe edits. Subscribe edits
+ * are:
+ * 1. SetAttributes edit with element key being `ExtRef` element
+ * 2. Insert edit with node key being `ExtRef` element
+ * All other edits are not taking into consideration
+ * @param edits - Subscribe edit array
+ * @returns Edit array adding supervision on top of the subscription
+ */
+export declare function insertSubscriptionSupervisions(edits: (SetAttributes | Insert)[]): Insert[];

package/dist/tLN/supervision/insertSubscriptionSupervisions.js

@@ -0,0 +1,98 @@
+import { isInsert, isSetAttributes } from "@openscd/oscd-api/utils.js";
+import { findControlBlockBySrcAttributes, } from "./findControlBlockOnSrcAttributes.js";
+import { controlBlockObjRef } from "../../tControl/controlBlockObjRef.js";
+import { globalLnInstGenerator } from "./foundation.js";
+import { canInstantiateSubscriptionSupervision } from "./canInstantiateSubscriptionSupervision.js";
+import { createSupervisionEdit } from "./createSupervisionEdit.js";
+/** In case a new ExtRef is added to inputs-less LN/LN0
+ * ExtRef does not have parent IED yet.
+ * @returns A sink IED for a given ExtRef insert or `null`*/
+function findIED(edit, previousEdits) {
+    // case 1: Input is already in the SCL and ExtRef is added to it
+    const inputs = edit.parent;
+    const inputsParent = inputs.parentElement;
+    if (inputsParent)
+        return inputs.closest("IED");
+    // case 2: Input element is added as part of the subscription as well.
+    const inputsInsertEdit = previousEdits.find((otherEdit) => isInsert(otherEdit) && otherEdit.node === edit.parent);
+    if (inputsInsertEdit)
+        return inputsInsertEdit.parent.closest("IED");
+    // fallback for invalid files
+    return null;
+}
+function uniqueSupervisions(edits) {
+    const uniqueSupervisions = {};
+    edits.forEach((edit) => {
+        let sink = null;
+        let source;
+        let sinkIED = null;
+        const isExtRefUpdate = isSetAttributes(edit) && edit.element.tagName === "ExtRef";
+        const newExtRefInsert = isInsert(edit) && edit.node.tagName === "ExtRef";
+        if (isExtRefUpdate) {
+            source = {
+                iedName: edit.attributes?.["iedName"] ?? "",
+                ldInst: edit.attributes?.["srcLDInst"] ?? "",
+                prefix: edit.attributes?.["srcPrefix"] ?? "",
+                lnClass: edit.attributes?.["srcLNClass"] ?? "",
+                lnInst: edit.attributes?.["srcLNInst"] ?? "",
+                cbName: edit.attributes?.["srcCBName"] ?? "",
+            };
+            sink = edit.element;
+            sinkIED = sink.closest("IED");
+        }
+        else if (newExtRefInsert) {
+            const extRef = edit.node;
+            source = {
+                iedName: extRef.getAttribute("iedName") ?? "",
+                ldInst: extRef.getAttribute("srcLDInst") ?? "",
+                prefix: extRef.getAttribute("srcPrefix") ?? "",
+                lnClass: extRef.getAttribute("srcLNClass") ?? "",
+                lnInst: extRef.getAttribute("srcLNInst") ?? "",
+                cbName: extRef.getAttribute("srcCBName") ?? "",
+            };
+            sink = edit.parent;
+            sinkIED = findIED(edit, edits);
+        }
+        else
+            return;
+        const controlBlock = findControlBlockBySrcAttributes(sink.ownerDocument, source);
+        if (!controlBlock)
+            return;
+        const controlBlockReference = controlBlockObjRef(controlBlock);
+        if (!sinkIED)
+            return;
+        const iedName = sinkIED.getAttribute("name");
+        const id = `${controlBlockReference}-${iedName}`;
+        if (!uniqueSupervisions[id])
+            uniqueSupervisions[id] = {
+                sourceControlBlock: controlBlock,
+                subscriberIedOrLn: sinkIED,
+            };
+    });
+    return uniqueSupervisions;
+}
+/**
+ * Insert supervisions triggered by an array of subscribe edits. Subscribe edits
+ * are:
+ * 1. SetAttributes edit with element key being `ExtRef` element
+ * 2. Insert edit with node key being `ExtRef` element
+ * All other edits are not taking into consideration
+ * @param edits - Subscribe edit array
+ * @returns Edit array adding supervision on top of the subscription
+ */
+export function insertSubscriptionSupervisions(edits) {
+    /** Global as multiple subscription could be defined for different subscriber IEDs */
+    const instGenerator = globalLnInstGenerator();
+    const usedSupervisions = new Set();
+    return Object.values(uniqueSupervisions(edits))
+        .map((supervision) => {
+        if (!canInstantiateSubscriptionSupervision(supervision))
+            return null;
+        return createSupervisionEdit(supervision, {
+            usedSupervisions,
+            instGenerator,
+        });
+    })
+        .filter((action) => action);
+}
+//# sourceMappingURL=insertSubscriptionSupervisions.js.map