@openscd/scl-lib 2.0.0

package/dist/foundation/uniqueElementName.d.ts

@@ -0,0 +1,2 @@
+/** @returns Unique element name with  [[`tagName`]] within [[`parent`]] */
+export declare function uniqueElementName(parent: Element, tagName: string): string;

package/dist/foundation/uniqueElementName.js

@@ -0,0 +1,18 @@
+/** @returns Unique element name with  [[`tagName`]] within [[`parent`]] */
+export function uniqueElementName(parent, tagName) {
+    const nameCore = `new${tagName}`;
+    const siblingNames = Array.from(parent.querySelectorAll(`:scope > ${tagName}`)).map((child) => child.getAttribute("name") ?? child.tagName);
+    if (!siblingNames.length)
+        return `${nameCore}_001`;
+    let newName = "";
+    let i = 1;
+    newName = `${nameCore}_${i.toString().padStart(3, "0")}`;
+    while (i < siblingNames.length + 1) {
+        if (!siblingNames.includes(newName))
+            break;
+        i += 1;
+        newName = `${nameCore}_${i.toString().padStart(3, "0")}`;
+    }
+    return newName;
+}
+//# sourceMappingURL=uniqueElementName.js.map

package/dist/foundation/uniqueElementName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniqueElementName.js","sourceRoot":"","sources":["../../foundation/uniqueElementName.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,MAAe,EAAE,OAAe;IAChE,MAAM,QAAQ,GAAG,MAAM,OAAO,EAAE,CAAC;IAEjC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAC7B,MAAM,CAAC,gBAAgB,CAAC,YAAY,OAAO,EAAE,CAAC,CAC/C,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,CAAC,YAAY,CAAC,MAAM;QAAE,OAAO,GAAG,QAAQ,MAAM,CAAC;IAEnD,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,GAAG,GAAG,QAAQ,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACzD,OAAO,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;QAClC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,MAAM;QAE3C,CAAC,IAAI,CAAC,CAAC;QACP,OAAO,GAAG,GAAG,QAAQ,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;KAC1D;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/foundation/utils.d.ts

@@ -0,0 +1,20 @@
+/** User selection of a data structure
+ * @example
+ * user selects data object `Beh` to be enum `on` and `test`
+ * ```ts
+ * {
+ *   Beh: {
+ *      stVal: {on: {}, test: {}}
+ *      q: {}
+ *      t: {}
+ *   }
+ * }
+ * ```
+ */
+export type TreeSelection = {
+    [name: string]: TreeSelection;
+};
+/** Utility function to create element with `tagName` and its`attributes` */
+export declare function createElement(doc: XMLDocument, tag: string, attrs: Record<string, string | null | undefined>): Element;
+/** @returns the cartesian product of `arrays` */
+export declare function crossProduct<T>(...arrays: T[][]): T[][];

package/dist/foundation/utils.js

@@ -0,0 +1,14 @@
+/** Utility function to create element with `tagName` and its`attributes` */
+export function createElement(doc, tag, attrs) {
+    const element = doc.createElementNS(doc.documentElement.namespaceURI, tag);
+    Object.entries(attrs)
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        .filter(([_, value]) => typeof value === "string")
+        .forEach(([name, value]) => element.setAttribute(name, value));
+    return element;
+}
+/** @returns the cartesian product of `arrays` */
+export function crossProduct(...arrays) {
+    return arrays.reduce((a, b) => a.flatMap((d) => b.map((e) => [d, e].flat())), [[]]);
+}
+//# sourceMappingURL=utils.js.map

package/dist/foundation/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../foundation/utils.ts"],"names":[],"mappings":"AAiBA,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAC3B,GAAgB,EAChB,GAAW,EACX,KAAgD;IAEhD,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,eAAe,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAC3E,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QACnB,6DAA6D;SAC5D,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;SACjD,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,KAAM,CAAC,CAAC,CAAC;IAElE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAI,GAAG,MAAa;IAC9C,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAC9D,CAAC,EAAE,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/generator/appIdGenerator.d.ts

@@ -0,0 +1,21 @@
+/** Generator function returning unique `APPID` within `doc`. Defined once it
+ * can generate unique `APPID`s without the need to update the `doc` in-between
+ * ```md
+ * GSE:         0x0000 - 0x3FFF
+ * GSE Type1A:  0x8000 - 0xBFFF
+ * SMV:         0x4000 - 0x7FFF
+ * ```
+ * @example
+ * ```ts
+ * const appIdGen = appIdGenerator(doc,"GSE");
+ * const appId1 = appIdGen();        //0001
+ * const appId2 = appIdGen();        //000A
+ * ```
+ * @param doc - Project SCL as XMLDocument
+ * @param serviceType - SampledValueControl (SMV) or GSEControl (GSE)
+ * @param type1A - Whether the GOOSE is a Trip GOOSE resulting
+ *                 in different APPID range - default false
+ * @returns A function generating increasing unused `APPID` within `doc`
+ *          on subsequent invocations
+ */
+export declare function appIdGenerator(doc: XMLDocument, serviceType: "SMV" | "GSE", type1A?: boolean): () => string | null;

package/dist/generator/appIdGenerator.js

@@ -0,0 +1,53 @@
+const maxGseAppId = 0x3fff;
+const minGseAppId = 0x0000;
+// APPID range for Type1A(Trip) GOOSE acc. IEC 61850-8-1
+const maxGseTripAppId = 0xbfff;
+const minGseTripAppId = 0x8000;
+const maxSmvAppId = 0x7fff;
+const minSmvAppId = 0x4000;
+const gseAppIdRange = Array(maxGseAppId - minGseAppId)
+    .fill(1)
+    .map((_, i) => (minGseAppId + i).toString(16).toUpperCase().padStart(4, "0"));
+const gseTripAppIdRange = Array(maxGseTripAppId - minGseTripAppId)
+    .fill(1)
+    .map((_, i) => (minGseTripAppId + i).toString(16).toUpperCase().padStart(4, "0"));
+const smvAppIdRange = Array(maxSmvAppId - minSmvAppId)
+    .fill(1)
+    .map((_, i) => (minSmvAppId + i).toString(16).toUpperCase().padStart(4, "0"));
+/** Generator function returning unique `APPID` within `doc`. Defined once it
+ * can generate unique `APPID`s without the need to update the `doc` in-between
+ * ```md
+ * GSE:         0x0000 - 0x3FFF
+ * GSE Type1A:  0x8000 - 0xBFFF
+ * SMV:         0x4000 - 0x7FFF
+ * ```
+ * @example
+ * ```ts
+ * const appIdGen = appIdGenerator(doc,"GSE");
+ * const appId1 = appIdGen();        //0001
+ * const appId2 = appIdGen();        //000A
+ * ```
+ * @param doc - Project SCL as XMLDocument
+ * @param serviceType - SampledValueControl (SMV) or GSEControl (GSE)
+ * @param type1A - Whether the GOOSE is a Trip GOOSE resulting
+ *                 in different APPID range - default false
+ * @returns A function generating increasing unused `APPID` within `doc`
+ *          on subsequent invocations
+ */
+export function appIdGenerator(doc, serviceType, type1A = false) {
+    const appIds = new Set(Array.from(doc.querySelectorAll(`${serviceType} > Address > P[type="APPID"]`)).map((appId) => appId.textContent));
+    const range = 
+    // eslint-disable-next-line no-nested-ternary
+    serviceType === "SMV"
+        ? smvAppIdRange
+        : type1A
+            ? gseTripAppIdRange
+            : gseAppIdRange;
+    return () => {
+        const uniqueAppId = range.find((appId) => !appIds.has(appId));
+        if (uniqueAppId)
+            appIds.add(uniqueAppId);
+        return uniqueAppId ?? null;
+    };
+}
+//# sourceMappingURL=appIdGenerator.js.map

package/dist/generator/appIdGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appIdGenerator.js","sourceRoot":"","sources":["../../generator/appIdGenerator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B,wDAAwD;AACxD,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;KACnD,IAAI,CAAC,CAAC,CAAC;KACP,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AAEhF,MAAM,iBAAiB,GAAG,KAAK,CAAC,eAAe,GAAG,eAAe,CAAC;KAC/D,IAAI,CAAC,CAAC,CAAC;KACP,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACZ,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAClE,CAAC;AAEJ,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;KACnD,IAAI,CAAC,CAAC,CAAC;KACP,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAgB,EAChB,WAA0B,EAC1B,MAAM,GAAG,KAAK;IAEd,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,KAAK,CAAC,IAAI,CACR,GAAG,CAAC,gBAAgB,CAAC,GAAG,WAAW,8BAA8B,CAAC,CACnE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAY,CAAC,CACrC,CAAC;IAEF,MAAM,KAAK;IACT,6CAA6C;IAC7C,WAAW,KAAK,KAAK;QACnB,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,MAAM;YACN,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,aAAa,CAAC;IAEtB,OAAO,GAAG,EAAE;QACV,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9D,IAAI,WAAW;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzC,OAAO,WAAW,IAAI,IAAI,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC"}

package/dist/generator/lnInstGenerator.d.ts

@@ -0,0 +1,16 @@
+export declare function getChildElementsByTagName(element: Element, tag: string): Element[];
+/**
+ * Generator function returning unique `inst` or `lnInst` attribute for element
+ * [[`tagName`]] within [[`parent`]].
+ * ```md
+ * Valid range for both `inst` and `lnInst` is between 1 and 99
+ * ```
+ * @param parent - The parent element to be scanned for `inst` or `lnInst`
+ * values already in use. Be sure to create a new generator every time the
+ * children of this element change in SCL.
+ * @param tagName - Tag name of the child elements containing the
+ * `lnInst` or `inst` attribute
+ * @returns a function generating increasing unused `inst` or `lnInst` values
+ * element with [[`tagName`]] within [[`parent`]] on subsequent invocations
+ */
+export declare function lnInstGenerator(parent: Element, tagName: "LN" | "LNode"): (lnClass: string) => string | undefined;

package/dist/generator/lnInstGenerator.js

@@ -0,0 +1,41 @@
+export function getChildElementsByTagName(element, tag) {
+    return Array.from(element.children).filter((element) => element.tagName === tag);
+}
+/** maximum value for `lnInst` attribute */
+const maxLnInst = 99;
+const lnInstRange = Array(maxLnInst)
+    .fill(1)
+    .map((_, i) => `${i + 1}`);
+/**
+ * Generator function returning unique `inst` or `lnInst` attribute for element
+ * [[`tagName`]] within [[`parent`]].
+ * ```md
+ * Valid range for both `inst` and `lnInst` is between 1 and 99
+ * ```
+ * @param parent - The parent element to be scanned for `inst` or `lnInst`
+ * values already in use. Be sure to create a new generator every time the
+ * children of this element change in SCL.
+ * @param tagName - Tag name of the child elements containing the
+ * `lnInst` or `inst` attribute
+ * @returns a function generating increasing unused `inst` or `lnInst` values
+ * element with [[`tagName`]] within [[`parent`]] on subsequent invocations
+ */
+export function lnInstGenerator(parent, tagName) {
+    const generators = new Map();
+    const generatedAttribute = tagName === "LN" ? "inst" : "lnInst";
+    return (lnClass) => {
+        if (!generators.has(lnClass)) {
+            const lnInstOrInst = new Set(getChildElementsByTagName(parent, tagName)
+                .filter((element) => element.getAttribute("lnClass") === lnClass)
+                .map((element) => element.getAttribute(generatedAttribute)));
+            generators.set(lnClass, () => {
+                const uniqueLnInstOrInst = lnInstRange.find((lnInst) => !lnInstOrInst.has(lnInst));
+                if (uniqueLnInstOrInst)
+                    lnInstOrInst.add(uniqueLnInstOrInst);
+                return uniqueLnInstOrInst;
+            });
+        }
+        return generators.get(lnClass)();
+    };
+}
+//# sourceMappingURL=lnInstGenerator.js.map

package/dist/generator/lnInstGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lnInstGenerator.js","sourceRoot":"","sources":["../../generator/lnInstGenerator.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,yBAAyB,CACvC,OAAgB,EAChB,GAAW;IAEX,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CACxC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,GAAG,CACrC,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC;KACjC,IAAI,CAAC,CAAC,CAAC;KACP,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAE7B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAe,EACf,OAAuB;IAEvB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC/D,MAAM,kBAAkB,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEhE,OAAO,CAAC,OAAe,EAAE,EAAE;QACzB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;YAC5B,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC;iBACvC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC;iBAChE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAE,CAAC,CAC/D,CAAC;YAEF,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC3B,MAAM,kBAAkB,GAAG,WAAW,CAAC,IAAI,CACzC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CACtC,CAAC;gBACF,IAAI,kBAAkB;oBAAE,YAAY,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBAC7D,OAAO,kBAAkB,CAAC;YAC5B,CAAC,CAAC,CAAC;SACJ;QAED,OAAO,UAAU,CAAC,GAAG,CAAC,OAAO,CAAE,EAAE,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}

package/dist/generator/macAddressGenerator.d.ts

@@ -0,0 +1,14 @@
+/** Generator function returning `MAC-Address` within `doc`. Defined once it can
+ * generate unique `MAC-address` without the need to update the `doc` in-between:
+ * @example
+ * ```ts
+ * const macGenerator = macAddressGenerator(doc,"GSE");
+ * const mac1 = macGenerator();        //01-0C-CD-01-00-09
+ * const mac2 = macGenerator();        //01-0C-CD-01-00-0A
+ * ```
+ * @param doc - Project SCL as XMLDocument
+ * @param serviceType - SampledValueControl (SMV) or GSEControl (GSE)
+ * @returns A function generating increasing unused `MAC-Address` within `doc`
+ *          on subsequent invocations
+ */
+export declare function macAddressGenerator(doc: XMLDocument, serviceType: "SMV" | "GSE"): () => string | null;

package/dist/generator/macAddressGenerator.js

@@ -0,0 +1,39 @@
+const maxGseMacAddress = 0x010ccd0101ff;
+const minGseMacAddress = 0x010ccd010000;
+const maxSmvMacAddress = 0x010ccd0401ff;
+const minSmvMacAddress = 0x010ccd040000;
+function convertToMac(mac) {
+    const str = 0 + mac.toString(16).toUpperCase();
+    const arr = str.match(/.{1,2}/g);
+    return arr.join("-");
+}
+const gseMacRange = Array(maxGseMacAddress - minGseMacAddress)
+    .fill(1)
+    .map((_, i) => convertToMac(minGseMacAddress + i));
+const smvMacRange = Array(maxSmvMacAddress - minSmvMacAddress)
+    .fill(1)
+    .map((_, i) => convertToMac(minSmvMacAddress + i));
+/** Generator function returning `MAC-Address` within `doc`. Defined once it can
+ * generate unique `MAC-address` without the need to update the `doc` in-between:
+ * @example
+ * ```ts
+ * const macGenerator = macAddressGenerator(doc,"GSE");
+ * const mac1 = macGenerator();        //01-0C-CD-01-00-09
+ * const mac2 = macGenerator();        //01-0C-CD-01-00-0A
+ * ```
+ * @param doc - Project SCL as XMLDocument
+ * @param serviceType - SampledValueControl (SMV) or GSEControl (GSE)
+ * @returns A function generating increasing unused `MAC-Address` within `doc`
+ *          on subsequent invocations
+ */
+export function macAddressGenerator(doc, serviceType) {
+    const macs = new Set(Array.from(doc.querySelectorAll(`${serviceType} > Address > P[type="MAC-Address"]`)).map((mac) => mac.textContent));
+    const range = serviceType === "SMV" ? smvMacRange : gseMacRange;
+    return () => {
+        const uniqueMAC = range.find((mac) => !macs.has(mac));
+        if (uniqueMAC)
+            macs.add(uniqueMAC);
+        return uniqueMAC ?? null;
+    };
+}
+//# sourceMappingURL=macAddressGenerator.js.map

package/dist/generator/macAddressGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"macAddressGenerator.js","sourceRoot":"","sources":["../../generator/macAddressGenerator.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,cAAc,CAAC;AACxC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAExC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AACxC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAExC,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAE,CAAC;IAClC,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,WAAW,GAAG,KAAK,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;KAC3D,IAAI,CAAC,CAAC,CAAC;KACP,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC;AAErD,MAAM,WAAW,GAAG,KAAK,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;KAC3D,IAAI,CAAC,CAAC,CAAC;KACP,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAgB,EAChB,WAA0B;IAE1B,MAAM,IAAI,GAAG,IAAI,GAAG,CAClB,KAAK,CAAC,IAAI,CACR,GAAG,CAAC,gBAAgB,CAAC,GAAG,WAAW,oCAAoC,CAAC,CACzE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAY,CAAC,CACjC,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;IAEhE,OAAO,GAAG,EAAE;QACV,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,IAAI,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnC,OAAO,SAAS,IAAI,IAAI,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+export { TreeSelection, } from "./foundation/utils.js";
+export { updateBay } from "./tBay/updateBay.js";
+export { updateVoltageLevel } from "./tVoltageLevel/updateVoltageLevel.js";
+export { updateSubstation } from "./tSubstation/updateSubstation.js";
+export { removeProcessElement } from "./tSubstation/removeProcessElement.js";
+export { updateLnType } from "./tSubstation/updateLnType.js";
+export { InsertIedOptions, insertIed } from "./tIED/insertIED.js";
+export { updateIED } from "./tIED/updateIED.js";
+export { removeIED } from "./tIED/removeIED.js";
+export { findControlBlockSubscription } from "./tControl/findControlSubscription.js";
+export { controlBlockObjRef } from "./tControl/controlBlockObjRef.js";
+export { controlBlockGseOrSmv } from "./tControl/controlBlockGseOrSmv.js";
+export { removeControlBlock } from "./tControl/removeControlBlock.js";
+export { CreateReportControlOptions } from "./tReportControl/createReportControl.js";
+export { updateReportControl } from "./tReportControl/updateReportControl.js";
+export { createReportControl } from "./tReportControl/createReportControl.js";
+export { createGSEControl } from "./tGSEControl/createGSEControl.js";
+export { updateGSEControl } from "./tGSEControl/updateGSEControl.js";
+export { changeGSEContent, ChangeGSEContentOptions, } from "./tGSE/changeGSEContent.js";
+export { createGSE } from "./tGSE/createGSE.js";
+export { CreateSampledValueControlOptions, createSampledValueControl, } from "./tSampledValueControl/createSampledValueControl.js";
+export { updateSampledValueControl } from "./tSampledValueControl/updateSampledValueControl.js";
+export { ChangeGseOrSmvAddressOptions } from "./tAddress/changeGseOrSmvAddress.js";
+export { changeSMVContent } from "./tSMV/changeSMVContent.js";
+export { createSMV } from "./tSMV/createSMV.js";
+export { CreateDataSetOptions, createDataSet, } from "./tDataSet/createDataSet.js";
+export { removeDataSet } from "./tDataSet/removeDataSet.js";
+export { updateDataSet } from "./tDataSet/updateDataSet.js";
+export { removeFCDA } from "./tFCDA/removeFCDA.js";
+export { macAddressGenerator } from "./generator/macAddressGenerator.js";
+export { appIdGenerator } from "./generator/appIdGenerator.js";
+export { lnInstGenerator } from "./generator/lnInstGenerator.js";
+export { matchDataAttributes } from "./tExtRef/matchDataAttributes.js";
+export { matchSrcAttributes } from "./tExtRef/matchSrcAttributes.js";
+export { UnsubscribeOptions } from "./tExtRef/unsubscribe.js";
+export { unsubscribe } from "./tExtRef/unsubscribe.js";
+export { Connection } from "./tExtRef/subscribe.js";
+export { SubscribeOptions } from "./tExtRef/subscribe.js";
+export { subscribe } from "./tExtRef/subscribe.js";
+export { extRefTypeRestrictions } from "./tExtRef/extRefTypeRestrictions.js";
+export { DoesFcdaMeetExtRefRestrictionsOptions, doesFcdaMeetExtRefRestrictions, } from "./tExtRef/doesFcdaMeetExtRefRestrictions.js";
+export { sourceControlBlock } from "./tExtRef/sourceControlBlock.js";
+export { isSubscribed } from "./tExtRef/isSubscribed.js";
+export { LNodeDescription, NameSpaceDescription, nsdToJson, } from "./tDataTypeTemplates/nsdToJson.js";
+export { insertSelectedLNodeType } from "./tDataTypeTemplates/insertSelectedLNodeType.js";
+export { removeDataType, RemoveDataTypeOptions } from "./tDataTypeTemplates/removeDataType.js";
+export { importLNodeType } from "./tDataTypeTemplates/importLNodeType.js";
+export { updateLNodeType } from "./tDataTypeTemplates/updateLNodeType.js";
+export { lNodeTypeToSelection } from "./tDataTypeTemplates/lNodeTypeToSelection.js";
+export { Supervision, SupervisionOptions, } from "./tLN/supervision/foundation.js";
+export { canInstantiateSubscriptionSupervision } from "./tLN/supervision/canInstantiateSubscriptionSupervision.js";
+export { instantiateSubscriptionSupervision } from "./tLN/supervision/instantiateSubscriptionSupervision.js";
+export { insertSubscriptionSupervisions } from "./tLN/supervision/insertSubscriptionSupervisions.js";
+export { removeSupervisionOptions, removeSupervision, } from "./tLN/supervision/removeSupervision.js";
+export { maxAttributes, canAddFCDA } from "./tFCDA/canAddFCDA.js";
+export { fcdaBaseTypes } from "./tFCDA/fcdaBaseTypes.js";
+export { find } from "./tBaseElement/find.js";
+export { getReference } from "./tBaseElement/getReference.js";
+export { getChildren } from "./tBaseElement/getChildren.js";
+export { identity } from "./tBaseElement/identity.js";
+export { isPublic } from "./tBaseElement/isPublic.js";

package/dist/index.js

@@ -0,0 +1,55 @@
+export { updateBay } from "./tBay/updateBay.js";
+export { updateVoltageLevel } from "./tVoltageLevel/updateVoltageLevel.js";
+export { updateSubstation } from "./tSubstation/updateSubstation.js";
+export { removeProcessElement } from "./tSubstation/removeProcessElement.js";
+export { updateLnType } from "./tSubstation/updateLnType.js";
+export { insertIed } from "./tIED/insertIED.js";
+export { updateIED } from "./tIED/updateIED.js";
+export { removeIED } from "./tIED/removeIED.js";
+export { findControlBlockSubscription } from "./tControl/findControlSubscription.js";
+export { controlBlockObjRef } from "./tControl/controlBlockObjRef.js";
+export { controlBlockGseOrSmv } from "./tControl/controlBlockGseOrSmv.js";
+export { removeControlBlock } from "./tControl/removeControlBlock.js";
+export { updateReportControl } from "./tReportControl/updateReportControl.js";
+export { createReportControl } from "./tReportControl/createReportControl.js";
+export { createGSEControl } from "./tGSEControl/createGSEControl.js";
+export { updateGSEControl } from "./tGSEControl/updateGSEControl.js";
+export { changeGSEContent, } from "./tGSE/changeGSEContent.js";
+export { createGSE } from "./tGSE/createGSE.js";
+export { createSampledValueControl, } from "./tSampledValueControl/createSampledValueControl.js";
+export { updateSampledValueControl } from "./tSampledValueControl/updateSampledValueControl.js";
+export { changeSMVContent } from "./tSMV/changeSMVContent.js";
+export { createSMV } from "./tSMV/createSMV.js";
+export { createDataSet, } from "./tDataSet/createDataSet.js";
+export { removeDataSet } from "./tDataSet/removeDataSet.js";
+export { updateDataSet } from "./tDataSet/updateDataSet.js";
+export { removeFCDA } from "./tFCDA/removeFCDA.js";
+export { macAddressGenerator } from "./generator/macAddressGenerator.js";
+export { appIdGenerator } from "./generator/appIdGenerator.js";
+export { lnInstGenerator } from "./generator/lnInstGenerator.js";
+export { matchDataAttributes } from "./tExtRef/matchDataAttributes.js";
+export { matchSrcAttributes } from "./tExtRef/matchSrcAttributes.js";
+export { unsubscribe } from "./tExtRef/unsubscribe.js";
+export { subscribe } from "./tExtRef/subscribe.js";
+export { extRefTypeRestrictions } from "./tExtRef/extRefTypeRestrictions.js";
+export { doesFcdaMeetExtRefRestrictions, } from "./tExtRef/doesFcdaMeetExtRefRestrictions.js";
+export { sourceControlBlock } from "./tExtRef/sourceControlBlock.js";
+export { isSubscribed } from "./tExtRef/isSubscribed.js";
+export { nsdToJson, } from "./tDataTypeTemplates/nsdToJson.js";
+export { insertSelectedLNodeType } from "./tDataTypeTemplates/insertSelectedLNodeType.js";
+export { removeDataType } from "./tDataTypeTemplates/removeDataType.js";
+export { importLNodeType } from "./tDataTypeTemplates/importLNodeType.js";
+export { updateLNodeType } from "./tDataTypeTemplates/updateLNodeType.js";
+export { lNodeTypeToSelection } from "./tDataTypeTemplates/lNodeTypeToSelection.js";
+export { canInstantiateSubscriptionSupervision } from "./tLN/supervision/canInstantiateSubscriptionSupervision.js";
+export { instantiateSubscriptionSupervision } from "./tLN/supervision/instantiateSubscriptionSupervision.js";
+export { insertSubscriptionSupervisions } from "./tLN/supervision/insertSubscriptionSupervisions.js";
+export { removeSupervision, } from "./tLN/supervision/removeSupervision.js";
+export { maxAttributes, canAddFCDA } from "./tFCDA/canAddFCDA.js";
+export { fcdaBaseTypes } from "./tFCDA/fcdaBaseTypes.js";
+export { find } from "./tBaseElement/find.js";
+export { getReference } from "./tBaseElement/getReference.js";
+export { getChildren } from "./tBaseElement/getChildren.js";
+export { identity } from "./tBaseElement/identity.js";
+export { isPublic } from "./tBaseElement/isPublic.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAoB,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,OAAO,EACL,gBAAgB,GAEjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAEL,yBAAyB,GAC1B,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AAGhG,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAEL,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAEL,8BAA8B,GAC/B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAIzD,OAAO,EAGL,SAAS,GACV,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAE1F,OAAO,EAAE,cAAc,EAAyB,MAAM,wCAAwC,CAAA;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAMpF,OAAO,EAAE,qCAAqC,EAAE,MAAM,4DAA4D,CAAC;AACnH,OAAO,EAAE,kCAAkC,EAAE,MAAM,yDAAyD,CAAC;AAC7G,OAAO,EAAE,8BAA8B,EAAE,MAAM,qDAAqD,CAAC;AACrG,OAAO,EAEL,iBAAiB,GAClB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/tAddress/changeGseOrSmvAddress.d.ts

@@ -0,0 +1,14 @@
+import { Insert, Remove } from "@openscd/oscd-api";
+export type ChangeGseOrSmvAddressOptions = {
+    /** MAC-Address within `P` element in the `GSE` or `SMV` element */
+    mac?: string;
+    /** APPID within `P` element in the `GSE` or `SMV` element */
+    appId?: string;
+    /** VLAN-ID within `P` element in the `GSE` or `SMV` element */
+    vlanId?: string;
+    /** VLAN-PRIORITY within `P` element in the `GSE` or `SMV` element */
+    vlanPriority?: string;
+    /** Whether xsi:type attributes shall be set */
+    instType?: boolean;
+};
+export declare function changeGseOrSmvAddress(gseOrSmv: Element, options: ChangeGseOrSmvAddressOptions): (Insert | Remove)[];

package/dist/tAddress/changeGseOrSmvAddress.js

@@ -0,0 +1,43 @@
+import { createElement } from "../foundation/utils.js";
+import { getReference } from "../tBaseElement/getReference.js";
+export function changeGseOrSmvAddress(gseOrSmv, options) {
+    const edits = [];
+    const newAddress = createElement(gseOrSmv.ownerDocument, "Address", {});
+    const attributes = {};
+    if (options.mac)
+        attributes["MAC-Address"] = options.mac;
+    if (options.appId)
+        attributes.APPID = options.appId;
+    if (options.vlanId)
+        attributes["VLAN-ID"] = options.vlanId;
+    if (options.vlanPriority)
+        attributes["VLAN-PRIORITY"] = options.vlanPriority;
+    Object.entries(attributes)
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        .filter(([_, value]) => value !== null)
+        .forEach(([type, value]) => {
+        const child = createElement(gseOrSmv.ownerDocument, "P", { type });
+        if (options.instType === undefined) {
+            // take over old xsi:type
+            const existXsiType = gseOrSmv
+                .querySelector(`:scope > Address > P[type="${type}"]`)
+                ?.hasAttribute("xsi:type");
+            if (existXsiType)
+                child.setAttributeNS("http://www.w3.org/2001/XMLSchema-instance", "xsi:type", `tP_${type}`);
+        }
+        else if (options.instType)
+            child.setAttributeNS("http://www.w3.org/2001/XMLSchema-instance", "xsi:type", `tP_${type}`);
+        child.textContent = value;
+        newAddress.appendChild(child);
+    });
+    edits.push({
+        parent: gseOrSmv,
+        node: newAddress,
+        reference: getReference(gseOrSmv, "Address"),
+    });
+    const oldAddress = gseOrSmv.querySelector("Address");
+    if (oldAddress)
+        edits.push({ node: oldAddress });
+    return edits;
+}
+//# sourceMappingURL=changeGseOrSmvAddress.js.map

package/dist/tAddress/changeGseOrSmvAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeGseOrSmvAddress.js","sourceRoot":"","sources":["../../tAddress/changeGseOrSmvAddress.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAe/D,MAAM,UAAU,qBAAqB,CACnC,QAAiB,EACjB,OAAqC;IAErC,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAExE,MAAM,UAAU,GAAkC,EAAE,CAAC;IACrD,IAAI,OAAO,CAAC,GAAG;QAAE,UAAU,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IACzD,IAAI,OAAO,CAAC,KAAK;QAAE,UAAU,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACpD,IAAI,OAAO,CAAC,MAAM;QAAE,UAAU,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3D,IAAI,OAAO,CAAC,YAAY;QAAE,UAAU,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAE7E,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;QACxB,6DAA6D;SAC5D,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;SACtC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE;YAClC,yBAAyB;YACzB,MAAM,YAAY,GAAG,QAAQ;iBAC1B,aAAa,CAAC,8BAA8B,IAAI,IAAI,CAAC;gBACtD,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;YAE7B,IAAI,YAAY;gBACd,KAAK,CAAC,cAAc,CAClB,2CAA2C,EAC3C,UAAU,EACV,MAAM,IAAI,EAAE,CACb,CAAC;SACL;aAAM,IAAI,OAAO,CAAC,QAAQ;YACzB,KAAK,CAAC,cAAc,CAClB,2CAA2C,EAC3C,UAAU,EACV,MAAM,IAAI,EAAE,CACb,CAAC;QAEJ,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;QAC1B,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEL,KAAK,CAAC,IAAI,CAAC;QACT,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC;KAC7C,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACrD,IAAI,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAEjD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tBaseElement/find.d.ts

@@ -0,0 +1,6 @@
+import { SCLTag } from "./tags.js";
+export declare const voidSelector = ":not(*)";
+type SelectorFunction = (tagName: SCLTag, identity: string) => string;
+export declare const selectorTags: Record<SCLTag, SelectorFunction>;
+export declare function find(root: XMLDocument | Element | DocumentFragment, tagName: string, identity: string | number): Element | null;
+export {};