@openscd/scl-lib 2.0.0

package/dist/tExtRef/extRefTypeRestrictions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This function returns the common data class `CDC` of the
+ * specified data object `pDO` and the basic type of the specified
+ * data attribute `pDA`.
+ * ```md
+ * The `CDC` of a given `pDO` is determined based on NSD files.
+ * This function therefore assumes the `pDO` to be a data object defined
+ * in the namespace of the IEC 61850-7-4 and IEC 61850-7-3
+ * ```
+ * @param extRef - The later binding type external reference
+ * @returns An object that contains the `cdc` and with existing `pDA`
+ * the `bType` or undefined if no valid specification can be returned
+ */
+export declare function extRefTypeRestrictions(extRef: Element): {
+    cdc: string;
+    bType?: string;
+} | undefined;

package/dist/tExtRef/extRefTypeRestrictions.js

@@ -0,0 +1,32 @@
+const dataObjects = await fetch(new URL("../foundation/nsd.json", import.meta.url)).then((res) => res.json());
+/**
+ * This function returns the common data class `CDC` of the
+ * specified data object `pDO` and the basic type of the specified
+ * data attribute `pDA`.
+ * ```md
+ * The `CDC` of a given `pDO` is determined based on NSD files.
+ * This function therefore assumes the `pDO` to be a data object defined
+ * in the namespace of the IEC 61850-7-4 and IEC 61850-7-3
+ * ```
+ * @param extRef - The later binding type external reference
+ * @returns An object that contains the `cdc` and with existing `pDA`
+ * the `bType` or undefined if no valid specification can be returned
+ */
+export function extRefTypeRestrictions(extRef) {
+    const [pDO, pDA] = ["pDO", "pDA"].map((attr) => extRef.getAttribute(attr));
+    if (!pDO)
+        return;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const dataObject = dataObjects[pDO];
+    const cdc = dataObject?.cdc ?? null;
+    if (!cdc)
+        return;
+    if (!pDA && cdc)
+        return { cdc };
+    const dataAttribute = dataObject.children[pDA];
+    const bType = dataAttribute?.bType ?? null;
+    if (!bType)
+        return;
+    return { cdc, bType };
+}
+//# sourceMappingURL=extRefTypeRestrictions.js.map

package/dist/tExtRef/extRefTypeRestrictions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extRefTypeRestrictions.js","sourceRoot":"","sources":["../../tExtRef/extRefTypeRestrictions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,MAAM,KAAK,CAC7B,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CACnD,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAE5B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAe;IAEf,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,GAAG;QAAE,OAAO;IAEjB,8DAA8D;IAC9D,MAAM,UAAU,GAAI,WAAmB,CAAC,GAAG,CAAC,CAAC;IAE7C,MAAM,GAAG,GAAG,UAAU,EAAE,GAAG,IAAI,IAAI,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,IAAI,CAAC,GAAG,IAAI,GAAG;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAEhC,MAAM,aAAa,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAI,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,aAAa,EAAE,KAAK,IAAI,IAAI,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACxB,CAAC"}

package/dist/tExtRef/isSubscribed.d.ts

@@ -0,0 +1,7 @@
+/** Whether a data attribute in a DataSet is subscribed to scope element.
+ * @param fcda - DataSet's data attribute
+ * @param scope - Scope within a subscriber IED or the IED itself.
+ *                E.g. IED, AccessPoint, Server, LN and other
+ * @returns - Whether a FCDA element is subscribed to a ExtRef within scope
+ */
+export declare function isSubscribed(fcda: Element, scope: Element): boolean;

package/dist/tExtRef/isSubscribed.js

@@ -0,0 +1,23 @@
+import { controlBlocks } from "../tControl/controlBlocks.js";
+import { matchDataAttributes } from "./matchDataAttributes.js";
+import { matchSrcAttributes } from "./matchSrcAttributes.js";
+function someControlMatch(extRef, controls) {
+    return controls.some((control) => matchSrcAttributes(extRef, control));
+}
+/** Whether a data attribute in a DataSet is subscribed to scope element.
+ * @param fcda - DataSet's data attribute
+ * @param scope - Scope within a subscriber IED or the IED itself.
+ *                E.g. IED, AccessPoint, Server, LN and other
+ * @returns - Whether a FCDA element is subscribed to a ExtRef within scope
+ */
+export function isSubscribed(fcda, scope) {
+    const controls = controlBlocks(fcda);
+    if (!controls.length)
+        return false;
+    return Array.from(scope.querySelectorAll("ExtRef")).some((extRef) => {
+        if (extRef.hasAttribute("serviceType"))
+            return (matchDataAttributes(extRef, fcda) && someControlMatch(extRef, controls));
+        return matchDataAttributes(extRef, fcda);
+    });
+}
+//# sourceMappingURL=isSubscribed.js.map

package/dist/tExtRef/isSubscribed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSubscribed.js","sourceRoot":"","sources":["../../tExtRef/isSubscribed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,SAAS,gBAAgB,CAAC,MAAe,EAAE,QAAmB;IAC5D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,KAAc;IACxD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAEnC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAClE,IAAI,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC;YACpC,OAAO,CACL,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CACxE,CAAC;QAEJ,OAAO,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tExtRef/matchDataAttributes.d.ts

@@ -0,0 +1,2 @@
+/** @returns Whether a ExtRef to FCDA reference match */
+export declare function matchDataAttributes(extRef: Element, fcda: Element): boolean;

package/dist/tExtRef/matchDataAttributes.js

@@ -0,0 +1,13 @@
+/** @returns Whether a ExtRef to FCDA reference match */
+export function matchDataAttributes(extRef, fcda) {
+    return (extRef.getAttribute("ldInst") === fcda.getAttribute("ldInst") &&
+        (extRef.getAttribute("prefix") ?? "") ===
+            (fcda.getAttribute("prefix") ?? "") &&
+        extRef.getAttribute("lnClass") === fcda.getAttribute("lnClass") &&
+        (extRef.getAttribute("lnInst") ?? "") ===
+            (fcda.getAttribute("lnInst") ?? "") &&
+        extRef.getAttribute("doName") === fcda.getAttribute("doName") &&
+        (extRef.getAttribute("daName") ?? "") ===
+            (fcda.getAttribute("daName") ?? ""));
+}
+//# sourceMappingURL=matchDataAttributes.js.map

package/dist/tExtRef/matchDataAttributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchDataAttributes.js","sourceRoot":"","sources":["../../tExtRef/matchDataAttributes.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,UAAU,mBAAmB,CAAC,MAAe,EAAE,IAAa;IAChE,OAAO,CACL,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;QAC7D,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;QAC/D,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;QAC7D,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CACtC,CAAC;AACJ,CAAC"}

package/dist/tExtRef/matchSrcAttributes.d.ts

@@ -0,0 +1,2 @@
+/** @returns Whether src... type ExtRef attributes match Control element*/
+export declare function matchSrcAttributes(extRef: Element, control: Element): boolean;

package/dist/tExtRef/matchSrcAttributes.js

@@ -0,0 +1,28 @@
+const serviceType = {
+    GSEControl: "GOOSE",
+    SampledValueControl: "SMV",
+    ReportControl: "Report",
+};
+/** @returns Whether src... type ExtRef attributes match Control element*/
+export function matchSrcAttributes(extRef, control) {
+    const cbName = control.getAttribute("name");
+    const srcLDInst = control.closest("LDevice")?.getAttribute("inst");
+    const srcPrefix = control.closest("LN0, LN")?.getAttribute("prefix") ?? "";
+    const srcLNClass = control.closest("LN0, LN")?.getAttribute("lnClass");
+    const srcLNInst = control.closest("LN0, LN")?.getAttribute("inst");
+    const extRefSrcLNClass = extRef.getAttribute("srcLNClass");
+    const srcLnClassCheck = !extRefSrcLNClass || extRefSrcLNClass === ""
+        ? "LLN0" === srcLNClass
+        : extRefSrcLNClass === srcLNClass;
+    const extRefSrcLDInst = extRef.getAttribute("srcLDInst");
+    const srcLdInstCheck = !extRefSrcLDInst || extRefSrcLDInst === ""
+        ? extRef.getAttribute("ldInst") === srcLDInst
+        : extRefSrcLDInst === srcLDInst;
+    return (extRef.getAttribute("srcCBName") === cbName &&
+        srcLdInstCheck &&
+        (extRef.getAttribute("srcPrefix") ?? "") === srcPrefix &&
+        (extRef.getAttribute("srcLNInst") ?? "") === srcLNInst &&
+        srcLnClassCheck &&
+        extRef.getAttribute("serviceType") === serviceType[control.tagName]);
+}
+//# sourceMappingURL=matchSrcAttributes.js.map

package/dist/tExtRef/matchSrcAttributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchSrcAttributes.js","sourceRoot":"","sources":["../../tExtRef/matchSrcAttributes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAoC;IACnD,UAAU,EAAE,OAAO;IACnB,mBAAmB,EAAE,KAAK;IAC1B,aAAa,EAAE,QAAQ;CACxB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB,CAAC,MAAe,EAAE,OAAgB;IAClE,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAEnE,MAAM,gBAAgB,GAAG,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAC3D,MAAM,eAAe,GACnB,CAAC,gBAAgB,IAAI,gBAAgB,KAAK,EAAE;QAC1C,CAAC,CAAC,MAAM,KAAK,UAAU;QACvB,CAAC,CAAC,gBAAgB,KAAK,UAAU,CAAC;IAEtC,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,cAAc,GAClB,CAAC,eAAe,IAAI,eAAe,KAAK,EAAE;QACxC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,SAAS;QAC7C,CAAC,CAAC,eAAe,KAAK,SAAS,CAAC;IAEpC,OAAO,CACL,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,MAAM;QAC3C,cAAc;QACd,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS;QACtD,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS;QACtD,eAAe;QACf,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CACpE,CAAC;AACJ,CAAC"}

package/dist/tExtRef/sourceControlBlock.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Locates control block from an ExtRef element.
+ * NOTE: Only supports > Edition 2 using the srcXXX attributes.
+ * @param extRef - SCL ExtRef element.
+ * @returns Either ReportControl/GSEControl/SampledValueControl or null
+ * if not found.
+ */
+export declare function sourceControlBlock(extRef: Element): Element | null;

package/dist/tExtRef/sourceControlBlock.js

@@ -0,0 +1,52 @@
+import { crossProduct } from "../foundation/utils.js";
+/**
+ * Locates control block from an ExtRef element.
+ * NOTE: Only supports > Edition 2 using the srcXXX attributes.
+ * @param extRef - SCL ExtRef element.
+ * @returns Either ReportControl/GSEControl/SampledValueControl or null
+ * if not found.
+ */
+export function sourceControlBlock(extRef) {
+    const [iedName, srcPrefix, srcLNInst, srcCBName] = [
+        "iedName",
+        "srcPrefix",
+        "srcLNInst",
+        "srcCBName",
+    ].map((attr) => extRef.getAttribute(attr));
+    const doc = extRef.ownerDocument;
+    const srcLDInst = extRef.getAttribute("srcLDInst") ?? extRef.getAttribute("ldInst");
+    const srcLNClass = extRef.getAttribute("srcLNClass") ?? "LLN0";
+    const serviceType = extRef.getAttribute("serviceType") ?? extRef.getAttribute("pServT");
+    if (!iedName || !srcLDInst || !srcCBName || serviceType === "Poll")
+        return null;
+    const lDevice = `:root > IED[name="${iedName}"] > AccessPoint > Server > LDevice[inst="${srcLDInst}"]`;
+    const maybeReport = !serviceType || serviceType === "Report";
+    const maybeGSE = !serviceType || serviceType === "GOOSE";
+    const maybeSMV = !serviceType || serviceType === "SMV";
+    const anyLN = srcLNClass === "LLN0" ? "LN0" : "LN";
+    const lnClass = `[lnClass="${srcLNClass}"]`;
+    let lnPrefixQualifiers;
+    if (anyLN === "LN") {
+        lnPrefixQualifiers =
+            srcPrefix && srcPrefix !== ""
+                ? [`[prefix="${srcPrefix}"]`]
+                : [":not([prefix])", '[prefix=""]'];
+    }
+    else {
+        lnPrefixQualifiers = [":not([prefix])"];
+    }
+    // On LN0 srcLNInst missing on the ExtRef means an inst=""
+    // On LN inst must be a non-empty string and so srcLNInst
+    // must also be a non-empty string and be present
+    const lnInst = anyLN !== "LN0" && srcLNInst ? `[inst="${srcLNInst}"]` : '[inst=""]';
+    const cbName = `[name="${srcCBName}"]`;
+    const cbTypes = [
+        maybeReport ? `ReportControl${cbName}` : null,
+        maybeGSE ? `GSEControl${cbName}` : null,
+        maybeSMV ? `SampledValueControl${cbName}` : null,
+    ].filter((s) => !!s);
+    return doc.querySelector(crossProduct([`${lDevice}>${anyLN}${lnClass}${lnInst}`], lnPrefixQualifiers, [">"], cbTypes)
+        .map((strings) => strings.join(""))
+        .join(","));
+}
+//# sourceMappingURL=sourceControlBlock.js.map

package/dist/tExtRef/sourceControlBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceControlBlock.js","sourceRoot":"","sources":["../../tExtRef/sourceControlBlock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAe;IAChD,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG;QACjD,SAAS;QACT,WAAW;QACX,WAAW;QACX,WAAW;KACZ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3C,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC;IACjC,MAAM,SAAS,GACb,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC;IAC/D,MAAM,WAAW,GACf,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEtE,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,WAAW,KAAK,MAAM;QAChE,OAAO,IAAI,CAAC;IAEd,MAAM,OAAO,GAAG,qBAAqB,OAAO,6CAA6C,SAAS,IAAI,CAAC;IAEvG,MAAM,WAAW,GAAG,CAAC,WAAW,IAAI,WAAW,KAAK,QAAQ,CAAC;IAC7D,MAAM,QAAQ,GAAG,CAAC,WAAW,IAAI,WAAW,KAAK,OAAO,CAAC;IACzD,MAAM,QAAQ,GAAG,CAAC,WAAW,IAAI,WAAW,KAAK,KAAK,CAAC;IAEvD,MAAM,KAAK,GAAG,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnD,MAAM,OAAO,GAAG,aAAa,UAAU,IAAI,CAAC;IAE5C,IAAI,kBAAkB,CAAC;IAEvB,IAAI,KAAK,KAAK,IAAI,EAAE;QAClB,kBAAkB;YAChB,SAAS,IAAI,SAAS,KAAK,EAAE;gBAC3B,CAAC,CAAC,CAAC,YAAY,SAAS,IAAI,CAAC;gBAC7B,CAAC,CAAC,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;KACzC;SAAM;QACL,kBAAkB,GAAG,CAAC,gBAAgB,CAAC,CAAC;KACzC;IAED,0DAA0D;IAC1D,yDAAyD;IACzD,iDAAiD;IACjD,MAAM,MAAM,GACV,KAAK,KAAK,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;IAEvE,MAAM,MAAM,GAAG,UAAU,SAAS,IAAI,CAAC;IAEvC,MAAM,OAAO,GAAG;QACd,WAAW,CAAC,CAAC,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;QAC7C,QAAQ,CAAC,CAAC,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;QACvC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;KACjD,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElC,OAAO,GAAG,CAAC,aAAa,CACtB,YAAY,CACV,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,EAC1C,kBAAkB,EAClB,CAAC,GAAG,CAAC,EACL,OAAO,CACR;SACE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SAClC,IAAI,CAAC,GAAG,CAAC,CACb,CAAC;AACJ,CAAC"}

package/dist/tExtRef/subscribe.d.ts

@@ -0,0 +1,47 @@
+import { Insert, SetAttributes } from "@openscd/oscd-api";
+export type SubscribeOptions = {
+    /** Disables checks before subscription. !!Use with care */
+    force: boolean;
+    /** Whether to ignore adding subscription supervision (LGOS / LSVS). Default false */
+    ignoreSupervision: boolean;
+    /** Whether to check only service type (pServT) and basic type (not pDO and pLN). Default false */
+    checkOnlyBType: boolean;
+};
+export type ValidSubscribeOptions = {
+    /** Whether to check only service type (pServT) and basic type (not pDO and pLN). Default false */
+    checkOnlyBType: boolean;
+};
+export type Connection = {
+    /** Can be `LN0`, `LN`, `Inputs` or `ExtRef` */
+    sink: Element;
+    source: {
+        /** `FCDA` element with or without `daName` */
+        fcda: Element;
+        /** `ReportControl`, `GSEControl`, `SampledValueControl` */
+        controlBlock?: Element;
+    };
+};
+/**
+ * A function to subscribe [[`source`]](s) to [[`sink`]](s).
+ * > Be aware that this function is producing a diff to the actual SCL.
+ * > It is therefore crucial to make sure that at the point of calling
+ * > this function the SCL is up to date.
+ * @example
+ * ```ts
+ * // do not do this
+ * const diff1 = subscribe(conn1);
+ * const diff2 = subscribe(conn2);
+ * .dispatch(editEvent([diff1, diff2]));
+ *
+ * // better do this
+ * const diff = subscribe([conn1, conn2]);
+ * .dispatch(editEvent(diff))
+ * ```
+ * @param sink - Can be `LN0`, `LN` and `Inputs`
+ * for non-later-binding type of subscription and `ExtRef` with `intAddr`
+ * for later binding type subscription.
+ * @param source.fcda - `FCDA` element
+ * @param source.controlBlock - The control block carrying the [[`source.fcda`]]
+ * @returns An array of edits to do a valid subscription
+ */
+export declare function subscribe(connectionOrConnections: Connection | Connection[], options?: SubscribeOptions): (Insert | SetAttributes)[];

package/dist/tExtRef/subscribe.js

@@ -0,0 +1,187 @@
+import { createElement } from "../foundation/utils.js";
+import { getReference } from "../tBaseElement/getReference.js";
+import { insertSubscriptionSupervisions } from "../tLN/supervision/insertSubscriptionSupervisions.js";
+import { doesFcdaMeetExtRefRestrictions } from "./doesFcdaMeetExtRefRestrictions.js";
+const serviceTypes = {
+    ReportControl: "Report",
+    GSEControl: "GOOSE",
+    SampledValueControl: "SMV",
+};
+function srcAttributes(controlBlock) {
+    const srcLDInst = controlBlock?.closest("LDevice")?.getAttribute("inst") || null;
+    const srcPrefix = controlBlock?.closest("LN0,LN")?.getAttribute("prefix") || "";
+    const srcLNClass = controlBlock?.closest("LN0,LN")?.getAttribute("lnClass") || null;
+    const srcLNInst = controlBlock?.closest("LN0,LN")?.getAttribute("inst") || null;
+    const srcCBName = controlBlock?.getAttribute("name") || null;
+    if (!controlBlock ||
+        !serviceTypes[controlBlock.tagName] ||
+        !srcLDInst ||
+        !srcLNClass ||
+        !srcCBName)
+        return {
+            srcLDInst: null,
+            srcPrefix: null,
+            srcLNClass: null,
+            srcLNInst: null,
+            srcCBName: null,
+            serviceType: null,
+        };
+    return {
+        srcLDInst,
+        srcPrefix,
+        srcLNClass,
+        srcLNInst,
+        srcCBName,
+        serviceType: serviceTypes[controlBlock.tagName],
+    };
+}
+function getDataAttributes(fcda) {
+    const sourceIed = fcda.closest("IED");
+    const iedName = sourceIed?.getAttribute("name");
+    const [ldInst, prefix, lnClass, lnInst, doName, daName, fc] = [
+        "ldInst",
+        "prefix",
+        "lnClass",
+        "lnInst",
+        "doName",
+        "daName",
+        "fc",
+    ].map((attr) => fcda.getAttribute(attr));
+    if (!sourceIed || !iedName || !ldInst || !lnClass || !doName || !fc)
+        return null;
+    return {
+        iedName,
+        ldInst,
+        prefix,
+        lnClass,
+        lnInst,
+        doName,
+        daName,
+    };
+}
+function createSubscribeEdit(connection, parent) {
+    const doc = connection.sink.ownerDocument;
+    const fcda = connection.source.fcda;
+    const controlBlock = connection.source.controlBlock;
+    const isEd1 = !doc.querySelector("SCL")?.getAttribute("version");
+    const ed1Attributes = getDataAttributes(fcda);
+    if (!ed1Attributes)
+        return null;
+    const ed2Attributes = {
+        ...ed1Attributes,
+        ...srcAttributes(controlBlock),
+    };
+    if (connection.sink.tagName === "ExtRef" && isEd1)
+        return {
+            element: connection.sink,
+            attributes: ed1Attributes,
+        };
+    if (connection.sink.tagName === "ExtRef" && !isEd1)
+        return {
+            element: connection.sink,
+            attributes: ed2Attributes,
+        };
+    const reference = getReference(parent, "ExtRef");
+    if (connection.sink.tagName !== "ExtRef" && isEd1) {
+        const extRef = createElement(doc, "ExtRef", ed1Attributes);
+        return { parent, node: extRef, reference };
+    }
+    const extRef = createElement(doc, "ExtRef", ed2Attributes);
+    return { parent, node: extRef, reference };
+}
+function createSubscribeEdits(connections) {
+    const inputEdits = [];
+    const extRefEdits = connections
+        .map((option) => {
+        const parent = option.sink;
+        // no Inputs child yet in anyLN element
+        if ((parent.tagName === "LN" || parent.tagName === "LN0") &&
+            !inputEdits.some((insert) => insert.parent === parent)) {
+            const inputs = createElement(parent.ownerDocument, "Inputs", {});
+            const edit = createSubscribeEdit(option, inputs);
+            if (edit)
+                inputEdits.push({
+                    parent,
+                    node: inputs,
+                    reference: getReference(parent, "Inputs"),
+                });
+            return edit;
+        }
+        // there is an Input already in anyLn
+        if ((parent.tagName === "LN" || parent.tagName === "LN0") &&
+            inputEdits.some((insert) => insert.parent === parent)) {
+            const inputs = inputEdits.find((insert) => insert.parent === parent)
+                .node;
+            return createSubscribeEdit(option, inputs);
+        }
+        return createSubscribeEdit(option, parent);
+    })
+        .filter((edit) => edit);
+    return [...inputEdits, ...extRefEdits];
+}
+function invalidSink(sink) {
+    if (sink.tagName === "ExtRef")
+        return !sink.getAttribute("intAddr") || !!sink.getAttribute("iedName");
+    return !(sink.tagName === "LN" ||
+        sink.tagName === "LN0" ||
+        sink.tagName === "Inputs");
+}
+function validSubscribeConditions(connection, options = { checkOnlyBType: false }) {
+    if (invalidSink(connection.sink))
+        return false;
+    //TODO: check connection via Communication section
+    const fcda = connection.source.fcda;
+    const controlBlock = connection.source.controlBlock;
+    const serviceType = controlBlock
+        ? serviceTypes[controlBlock.tagName]
+        : "Poll";
+    if (connection.sink.tagName === "ExtRef" &&
+        !doesFcdaMeetExtRefRestrictions(connection.sink, fcda, {
+            controlBlockType: serviceType,
+            checkOnlyBType: options.checkOnlyBType,
+        }))
+        return false;
+    return true;
+}
+/**
+ * A function to subscribe [[`source`]](s) to [[`sink`]](s).
+ * > Be aware that this function is producing a diff to the actual SCL.
+ * > It is therefore crucial to make sure that at the point of calling
+ * > this function the SCL is up to date.
+ * @example
+ * ```ts
+ * // do not do this
+ * const diff1 = subscribe(conn1);
+ * const diff2 = subscribe(conn2);
+ * .dispatch(editEvent([diff1, diff2]));
+ *
+ * // better do this
+ * const diff = subscribe([conn1, conn2]);
+ * .dispatch(editEvent(diff))
+ * ```
+ * @param sink - Can be `LN0`, `LN` and `Inputs`
+ * for non-later-binding type of subscription and `ExtRef` with `intAddr`
+ * for later binding type subscription.
+ * @param source.fcda - `FCDA` element
+ * @param source.controlBlock - The control block carrying the [[`source.fcda`]]
+ * @returns An array of edits to do a valid subscription
+ */
+export function subscribe(connectionOrConnections, options = {
+    force: false,
+    ignoreSupervision: false,
+    checkOnlyBType: false,
+}) {
+    const connections = Array.isArray(connectionOrConnections)
+        ? connectionOrConnections
+        : [connectionOrConnections];
+    const validConnections = options.force
+        ? connections
+        : connections.filter((conn) => validSubscribeConditions(conn, {
+            checkOnlyBType: options.checkOnlyBType,
+        }));
+    const extRefEdits = createSubscribeEdits(validConnections);
+    if (options.ignoreSupervision)
+        return [...extRefEdits];
+    return [...extRefEdits, ...insertSubscriptionSupervisions(extRefEdits)];
+}
+//# sourceMappingURL=subscribe.js.map

package/dist/tExtRef/subscribe.js.map

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

package/dist/tExtRef/unsubscribe.d.ts

@@ -0,0 +1,27 @@
+import { Remove, SetAttributes } from "@openscd/oscd-api";
+/** Optional setting to configure un-subscription */
+export type UnsubscribeOptions = {
+    /** Whether to ignore removing subscription supervision (LGOS / LSVS).
+     * CAUTION: This might be resulting in a invalid SCL file.
+     */
+    ignoreSupervision: boolean;
+};
+/**
+ * Remove link between sending IED data to receiving IED external
+ * references - unsubscribing.
+ * ```md
+ * 1. Unsubscribes external references itself:
+ * -Update `ExtRef` in case later binding is used (existing `intAddr` attribute)
+ * -Remove `ExtRef` in case `intAddr` is missing
+ *
+ * 2. Removes leaf `Input` elements as well
+ * 3. Removes subscription supervision (can be disabled through options.ignoreSupervision)
+ * - when all external references of one control block are unsubscribed
+ * - when `valKind` RO|Conf and `valImport` true
+ * ```
+ * In case the external reference
+ * @param extRefs - Array of external references
+ * @returns An array of update and/or remove edit representing changes required
+ * to unsubscribe.
+ */
+export declare function unsubscribe(extRefs: Element[], options?: UnsubscribeOptions): (SetAttributes | Remove)[];

package/dist/tExtRef/unsubscribe.js

@@ -0,0 +1,55 @@
+import { removeInputs } from "../tInputs/removeInputs.js";
+import { removeSubscriptionSupervision } from "../tLN/removeSubscriptionSupervision.js";
+/**
+ * Remove link between sending IED data to receiving IED external
+ * references - unsubscribing.
+ * ```md
+ * 1. Unsubscribes external references itself:
+ * -Update `ExtRef` in case later binding is used (existing `intAddr` attribute)
+ * -Remove `ExtRef` in case `intAddr` is missing
+ *
+ * 2. Removes leaf `Input` elements as well
+ * 3. Removes subscription supervision (can be disabled through options.ignoreSupervision)
+ * - when all external references of one control block are unsubscribed
+ * - when `valKind` RO|Conf and `valImport` true
+ * ```
+ * In case the external reference
+ * @param extRefs - Array of external references
+ * @returns An array of update and/or remove edit representing changes required
+ * to unsubscribe.
+ */
+export function unsubscribe(extRefs, options = { ignoreSupervision: false }) {
+    const SetAttributesEdits = [];
+    const removeEdits = [];
+    extRefs.map((extRef) => {
+        if (extRef.getAttribute("intAddr"))
+            SetAttributesEdits.push({
+                element: extRef,
+                attributes: {
+                    iedName: null,
+                    ldInst: null,
+                    prefix: null,
+                    lnClass: null,
+                    lnInst: null,
+                    doName: null,
+                    daName: null,
+                    srcLDInst: null,
+                    srcPrefix: null,
+                    srcLNClass: null,
+                    srcLNInst: null,
+                    srcCBName: null,
+                    ...(extRef.getAttribute("pServT") && { serviceType: null }),
+                },
+            });
+        else
+            removeEdits.push({ node: extRef });
+    });
+    return [
+        ...removeInputs(removeEdits),
+        ...SetAttributesEdits,
+        ...(options.ignoreSupervision
+            ? []
+            : removeSubscriptionSupervision(extRefs)),
+    ];
+}
+//# sourceMappingURL=unsubscribe.js.map

package/dist/tExtRef/unsubscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsubscribe.js","sourceRoot":"","sources":["../../tExtRef/unsubscribe.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AAUxF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CACzB,OAAkB,EAClB,UAA8B,EAAE,iBAAiB,EAAE,KAAK,EAAE;IAE1D,MAAM,kBAAkB,GAAoB,EAAE,CAAC;IAC/C,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACrB,IAAI,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC;YAChC,kBAAkB,CAAC,IAAI,CAAC;gBACtB,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE;oBACV,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,IAAI;oBACZ,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,IAAI;oBACZ,SAAS,EAAE,IAAI;oBACf,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI;oBAChB,SAAS,EAAE,IAAI;oBACf,SAAS,EAAE,IAAI;oBACf,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;iBAC5D;aACF,CAAC,CAAC;;YACA,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,YAAY,CAAC,WAAW,CAAC;QAC5B,GAAG,kBAAkB;QACrB,GAAG,CAAC,OAAO,CAAC,iBAAiB;YAC3B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/tFCDA/canAddFCDA.d.ts

@@ -0,0 +1,10 @@
+/** @returns ConfDataSet.maxAttributes number as `max` and the scope. */
+export declare function maxAttributes(fcda: Element): {
+    max: number;
+    scope: string;
+};
+/** Checks Services>ConfDataSet.maxAttributes on AccessPoint or
+ * on IED if the first is not present.
+ * @param dataSet - parent [[`DataSet`]] element
+ * @returns Whether new `FCDA` is exceeding ConfDataSet.maxAttributes attribute */
+export declare function canAddFCDA(dataSet: Element): boolean;

package/dist/tFCDA/canAddFCDA.js

@@ -0,0 +1,42 @@
+/** @returns ConfDataSet.maxAttributes number as `max` and the scope. */
+export function maxAttributes(fcda) {
+    {
+        const validRoot = !!fcda.closest("AccessPoint") || !!fcda.closest("IED");
+        if (!validRoot)
+            return { max: -1, scope: "IED" };
+        const selector = `:scope > Services > ConfDataSet`;
+        const apMaxAllowed = fcda
+            .closest("AccessPoint")
+            ?.querySelector(selector)
+            ?.getAttribute("maxAttributes");
+        if (apMaxAllowed)
+            return {
+                max: parseInt(apMaxAllowed, 10),
+                scope: "AccessPoint",
+            };
+        const iedMaxAllowed = fcda
+            .closest("IED")
+            ?.querySelector(selector)
+            ?.getAttribute("maxAttributes");
+        if (iedMaxAllowed)
+            return {
+                max: parseInt(iedMaxAllowed, 10),
+                scope: "IED",
+            };
+        const existing = fcda.querySelectorAll(":scope > FCDA").length;
+        return {
+            max: existing,
+            scope: "DataSet",
+        };
+    }
+}
+/** Checks Services>ConfDataSet.maxAttributes on AccessPoint or
+ * on IED if the first is not present.
+ * @param dataSet - parent [[`DataSet`]] element
+ * @returns Whether new `FCDA` is exceeding ConfDataSet.maxAttributes attribute */
+export function canAddFCDA(dataSet) {
+    const { max } = maxAttributes(dataSet);
+    const existingDataSets = dataSet.querySelectorAll(":scope > FCDA").length;
+    return max > existingDataSets;
+}
+//# sourceMappingURL=canAddFCDA.js.map

package/dist/tFCDA/canAddFCDA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canAddFCDA.js","sourceRoot":"","sources":["../../tFCDA/canAddFCDA.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC;QACE,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzE,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAEjD,MAAM,QAAQ,GAAG,iCAAiC,CAAC;QACnD,MAAM,YAAY,GAAG,IAAI;aACtB,OAAO,CAAC,aAAa,CAAC;YACvB,EAAE,aAAa,CAAC,QAAQ,CAAC;YACzB,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;QAElC,IAAI,YAAY;YACd,OAAO;gBACL,GAAG,EAAE,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC;gBAC/B,KAAK,EAAE,aAAa;aACrB,CAAC;QAEJ,MAAM,aAAa,GAAG,IAAI;aACvB,OAAO,CAAC,KAAK,CAAC;YACf,EAAE,aAAa,CAAC,QAAQ,CAAC;YACzB,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;QAElC,IAAI,aAAa;YACf,OAAO;gBACL,GAAG,EAAE,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC;gBAChC,KAAK,EAAE,KAAK;aACb,CAAC;QAEJ,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;QAE/D,OAAO;YACL,GAAG,EAAE,QAAQ;YACb,KAAK,EAAE,SAAS;SACjB,CAAC;KACH;AACH,CAAC;AAED;;;kFAGkF;AAClF,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,MAAM,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEvC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;IAE1E,OAAO,GAAG,GAAG,gBAAgB,CAAC;AAChC,CAAC"}

package/dist/tFCDA/fcdaBaseTypes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Determines common data class (CDC) of a given `doName` and with present
+ * `daName` its `bType`.
+ * @param fcda - The `FCDA` element to determine the `cdc` and `bType` for
+ * @returns An object that contains the `cdc` and `bType` with given `daName`
+ * or undefined if one of them cannot be determined
+ */
+export declare function fcdaBaseTypes(fcda: Element): {
+    cdc: string;
+    bType?: string;
+} | undefined;