@dialecte/scl 0.4.2 → 0.6.0

package/dist/v2019C1/hooks/io/io-hooks.types.d.ts

@@ -1,11 +1,63 @@
-import { ImportWarning } from '@dialecte/core';
+import { ReferencePair } from '../../extensions/reference';
+import { ElementPath } from '../../extensions/reference/query/build';
+import { AnyRawRecord, ImportWarning } from '@dialecte/core';
+/**
+ * A reference written with a path: parsed and looked up once the whole file is read, when the
+ * naming of every LNode is known. `ancestry` is kept for the strategies whose names are local to
+ * the referrer (behaviour description, IED address, ancestor name).
+ */
 export type PendingResolution = {
     recordId: string;
     elementTag: string;
-    uuidAttributeName: string;
+    pair: ReferencePair;
     pathValue: string;
-    lookupKey: string;
-    fallbackLookupKey?: string;
+    referenceAttributes: readonly {
+        name: string;
+        value: string;
+    }[];
+    ancestry?: readonly AnyRawRecord[];
+    /** Its uuid when the file gives one: only a path in a former form is then written again. */
+    uuidValue?: string;
+    /**
+     * Written again in the standard form once resolved whatever form it had: a name local to a
+     * BehaviorDescription that names a signal, a ProcessResource named by its full path.
+     */
+    alwaysStandardize: boolean;
+};
+/** A target element of the file, indexed by its path once the whole file is read. */
+export type CollectedTarget = {
+    record: AnyRawRecord;
+    ancestry: readonly AnyRawRecord[];
+    uuid: string;
+};
+/** A target element of the file, indexed by its uuid. */
+export type IndexedTarget = {
+    tagName: string;
+    path: ElementPath;
+};
+/**
+ * A reference stored with its uuid and no path. Everything its path is composed from is kept
+ * from the first pass; the path is composed once every target is indexed.
+ */
+export type PendingPathFill = {
+    recordId: string;
+    pair: ReferencePair;
+    uuidValue: string;
+    referenceAttributes: readonly {
+        name: string;
+        value: string;
+    }[];
+    /** `behavior-description` pairs only: the referrer's ancestors, its BehaviorDescription among them. */
+    ancestry?: readonly AnyRawRecord[];
+};
+/**
+ * The path index of the file: the standard path of each target, and the paths an earlier version
+ * wrote for it (`legacyKeys`), which still resolve and are written again in the standard form.
+ */
+export type ImportPathIndex = {
+    byPath: Map<string, string>;
+    legacyKeys: Set<string>;
+    targetsByUuid: Map<string, IndexedTarget>;
 };
 export type UnresolvedReferenceWarning = ImportWarning & {
     type: 'unresolved-reference';
@@ -25,4 +77,30 @@ export type UnsupportedXPathWarning = ImportWarning & {
         pathValue: string;
     };
 };
+export type IncoherentReferenceWarning = ImportWarning & {
+    type: 'incoherent-reference';
+    details: {
+        elementTag: string;
+        pathAttribute: string;
+        pathValue: string | undefined;
+        uuidAttribute: string;
+        uuidValue: string | undefined;
+    };
+};
+/**
+ * An LNode bound to an IED had no `LNodeSpecNaming`: it was given one from the naming of the
+ * logical node it is bound to (prefix, class, instance), the IED and LD names left out.
+ */
+export type DerivedSpecificationNamingWarning = ImportWarning & {
+    type: 'derived-specification-naming';
+    details: {
+        iedName: string;
+        specifiedNaming: readonly {
+            name: string;
+            value: string;
+        }[];
+    };
+};
+/** Every warning the import of an SCL file reports: its `type` is a key of `SCL_IMPORT_WARNINGS`. */
+export type SclImportWarning = UnresolvedReferenceWarning | UnsupportedXPathWarning | IncoherentReferenceWarning | DerivedSpecificationNamingWarning;
 //# sourceMappingURL=io-hooks.types.d.ts.map

package/dist/v2019C1/hooks/io/io-hooks.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io-hooks.types.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/io/io-hooks.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,MAAM,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG,aAAa,GAAG;IACxD,IAAI,EAAE,sBAAsB,CAAA;IAC5B,OAAO,EAAE;QACR,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,MAAM,CAAA;QACrB,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,EAAE,CAAA;KACnB,CAAA;CACD,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG;IACrD,IAAI,EAAE,6BAA6B,CAAA;IACnC,OAAO,EAAE;QACR,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,MAAM,CAAA;QACrB,aAAa,EAAE,MAAM,CAAA;QACrB,SAAS,EAAE,MAAM,CAAA;KACjB,CAAA;CACD,CAAA"}
+{"version":3,"file":"io-hooks.types.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/io/io-hooks.types.ts"],"names":[],"mappings":"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"}

package/dist/v2019C1/hooks/io/lnode-spec-naming-import.d.ts

@@ -0,0 +1,8 @@
+import { SpecNamingImport } from './lnode-spec-naming-import.types';
+/**
+ * Gives every imported LNode without `LNodeSpecNaming` its own, with the same rule as the record
+ * hooks (`specifiedNamingOf`, data-model naming). The import has no store access: the pass collects the LNodes, their
+ * `eIEC61850-6-100` Private and the LNodes that have one; the records are made at the end.
+ */
+export declare function createSpecNamingImport(): SpecNamingImport;
+//# sourceMappingURL=lnode-spec-naming-import.d.ts.map

package/dist/v2019C1/hooks/io/lnode-spec-naming-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lnode-spec-naming-import.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/io/lnode-spec-naming-import.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAGxE;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAsEzD"}

package/dist/v2019C1/hooks/io/lnode-spec-naming-import.types.d.ts

@@ -0,0 +1,21 @@
+import { DerivedSpecificationNamingWarning } from './io-hooks.types';
+import { AnyRawRecord, RecordPatch } from '@dialecte/core';
+export type SpecNamingImport = {
+    /** Record one standardized record of the import pass, with its still-open parents. */
+    collect(params: {
+        record: AnyRawRecord;
+        ancestry: readonly AnyRawRecord[];
+    }): void;
+    /**
+     * After the pass: the records giving every LNode without `LNodeSpecNaming` its own, and a
+     * warning for each one taken from the naming of the logical node the LNode is bound to.
+     */
+    resolve(): {
+        /** The `LNodeSpecNaming` of every LNode, by LNode id: the file's and the ones made here. */
+        namings: ReadonlyMap<string, AnyRawRecord>;
+        creates: AnyRawRecord[];
+        updates: RecordPatch[];
+        warnings: DerivedSpecificationNamingWarning[];
+    };
+};
+//# sourceMappingURL=lnode-spec-naming-import.types.d.ts.map

package/dist/v2019C1/hooks/io/lnode-spec-naming-import.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lnode-spec-naming-import.types.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/io/lnode-spec-naming-import.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE/D,MAAM,MAAM,gBAAgB,GAAG;IAC9B,sFAAsF;IACtF,OAAO,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;KAAE,GAAG,IAAI,CAAA;IAClF;;;OAGG;IACH,OAAO,IAAI;QACV,4FAA4F;QAC5F,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;QAC1C,OAAO,EAAE,YAAY,EAAE,CAAA;QACvB,OAAO,EAAE,WAAW,EAAE,CAAA;QACtB,QAAQ,EAAE,iCAAiC,EAAE,CAAA;KAC7C,CAAA;CACD,CAAA"}

package/dist/v2019C1/hooks/io/mapped-data-import.d.ts

@@ -0,0 +1,9 @@
+import { MappedDataImport } from './mapped-data-import.types';
+/**
+ * Stores every `DOS` / `SDS` / `DAS` of an imported file in canonical form, with the same rules
+ * as the record hooks: nothing when the record is implemented by its default, otherwise the
+ * path from the implementing logical node with that node's uuid. The import has no store
+ * access, so the pass collects what the rules need and resolves it at the end.
+ */
+export declare function createMappedDataImport(): MappedDataImport;
+//# sourceMappingURL=mapped-data-import.d.ts.map

package/dist/v2019C1/hooks/io/mapped-data-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapped-data-import.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/io/mapped-data-import.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGX,gBAAgB,EAChB,MAAM,4BAA4B,CAAA;AAMnC;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CA2HzD"}

package/dist/v2019C1/hooks/io/mapped-data-import.types.d.ts

@@ -0,0 +1,34 @@
+import { AnyRawRecord, ImportWarning, RecordPatch } from '@dialecte/core';
+/** A `DOS` / `SDS` / `DAS` seen during the import pass. */
+export type ImportedMappedDataNode = {
+    tagName: 'DOS' | 'SDS' | 'DAS';
+    name?: string;
+    ix?: string;
+    mappedName?: string;
+    mappedLnUuid?: string;
+    /** Record id of the nearest `DOS` / `SDS` above it. */
+    parent?: string;
+    /** Record id of the `LNode` above it. */
+    lnodeId?: string;
+};
+/** The `LNode` attributes that tell which logical node it is mapped to. */
+export type ImportedLNode = Record<'lnUuid' | 'iedName' | 'ldInst' | 'prefix' | 'lnClass' | 'lnInst', string | undefined>;
+export type MappedDataImport = {
+    /** Record one standardized record of the import pass, with its still-open parents. */
+    collect(params: {
+        record: AnyRawRecord;
+        ancestry: readonly AnyRawRecord[];
+    }): void;
+    /**
+     * After the pass: the updates that store every `DOS` / `SDS` / `DAS` in canonical form,
+     * and a warning per record whose implementation cannot be found in the file.
+     * `pathIndex`: element path -> uuid, as built by the import pass.
+     */
+    resolve(params: {
+        pathIndex: ReadonlyMap<string, string>;
+    }): Promise<{
+        updates: RecordPatch[];
+        warnings: ImportWarning[];
+    }>;
+};
+//# sourceMappingURL=mapped-data-import.types.d.ts.map

package/dist/v2019C1/hooks/io/mapped-data-import.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapped-data-import.types.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/io/mapped-data-import.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE9E,2DAA2D;AAC3D,MAAM,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,MAAM,CACjC,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,EACjE,MAAM,GAAG,SAAS,CAClB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,sFAAsF;IACtF,OAAO,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;KAAE,GAAG,IAAI,CAAA;IAClF;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC;QACpE,OAAO,EAAE,WAAW,EAAE,CAAA;QACtB,QAAQ,EAAE,aAAa,EAAE,CAAA;KACzB,CAAC,CAAA;CACF,CAAA"}

package/dist/v2019C1/hooks/shared/index.d.ts

@@ -1,7 +1,11 @@
 export { updateRefsForEntry, getRefEntriesForTarget } from './ref-entry-ops';
-export { reconcileMappedName } from './mapped-name';
+export { reconcileMappedData } from './reconcile-mapped-data';
+export { reconcileMappedDataBelow } from './reconcile-mapped-data-below';
 export { reconcileReferrerRefPaths } from './ref-path-rebuild';
 export { reconcileLNodeBinding } from './lnode-binding';
 export { changedAttributeNames, hasAttributeChange, readSnapshotAttribute, updatedOperation, upsertAttribute, } from './record-ops';
 export * from './min-requested-scd-file';
+export { reconcileSignalSiblingPaths, signalName, signalNamingAttributes, } from './signal-sibling-paths';
+export { ensureLNodeSpecNaming, mirrorSpecifiedNaming, rebuildPathsOfNamedLNode, specifiedNamingChanged, } from './lnode-spec-naming';
+export { rebuildReferencesBelow, rebuildReferencesTo } from './references-through';
 //# sourceMappingURL=index.d.ts.map

package/dist/v2019C1/hooks/shared/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EACN,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GACf,MAAM,cAAc,CAAA;AACrB,cAAc,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EACN,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GACf,MAAM,cAAc,CAAA;AACrB,cAAc,0BAA0B,CAAA;AACxC,OAAO,EACN,2BAA2B,EAC3B,UAAU,EACV,sBAAsB,GACtB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/v2019C1/hooks/shared/lnode-binding.d.ts

@@ -12,12 +12,15 @@ import type * as Core from '@dialecte/core';
  * key used to locate the implementing ICD), which is owned by the instantiate
  * lifecycle, not by binding.
  *
+ * Before an identity is stamped, an LNode without `LNodeSpecNaming` gets one from the naming it
+ * still has, so the specified naming survives the binding.
+ *
  * Runs only when `lnUuid` actually changed, so ordinary edits and coherent imports
- * are untouched. Returns an update operation, or `null` when nothing changes.
+ * are untouched. Returns the operations, empty when nothing changes.
  */
 export declare function reconcileLNodeBinding(params: {
     oldRecord: Scl.RawRecord<Scl.ElementsOf>;
     newRecord: Scl.RawRecord<Scl.ElementsOf>;
     query: Core.Query<Config>;
-}): Promise<Scl.Operation | null>;
+}): Promise<Scl.Operation[]>;
 //# sourceMappingURL=lnode-binding.d.ts.map

package/dist/v2019C1/hooks/shared/lnode-binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lnode-binding.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/lnode-binding.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAI3C;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IACnD,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;CACzB,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAchC"}
+{"version":3,"file":"lnode-binding.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/lnode-binding.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IACnD,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;CACzB,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAsB3B"}

package/dist/v2019C1/hooks/shared/lnode-spec-naming.d.ts

@@ -0,0 +1,34 @@
+import { Scl, Config } from '../../config';
+import type * as Core from '@dialecte/core';
+/**
+ * The operations giving an LNode its `LNodeSpecNaming` when it has none, placed in its
+ * `eIEC61850-6-100` Private (created when the LNode has none). Empty when it has one.
+ */
+export declare function ensureLNodeSpecNaming(query: Core.Query<Config>, params: {
+    lnode: Scl.Ref<'LNode'>;
+}): Promise<Scl.Operation[]>;
+/** Whether an update of an `LNodeSpecNaming` changes the name it gives its LNode in paths. */
+export declare function specifiedNamingChanged(params: {
+    oldRecord: Scl.RawRecord<Scl.ElementsOf>;
+    newRecord: Scl.RawRecord<Scl.ElementsOf>;
+}): boolean;
+/**
+ * The LNode is named in paths by its `LNodeSpecNaming`: when one is created, changed or removed,
+ * the paths of the references to the LNode and to everything below it are rebuilt. `holder` is the
+ * record the naming sits in when it is no longer readable (removed): its Private, or the LNode.
+ */
+export declare function rebuildPathsOfNamedLNode(query: Core.Query<Config>, params: {
+    specNaming: Scl.RawRecord<Scl.ElementsOf>;
+    holder?: Scl.RawRecord<Scl.ElementsOf>;
+}): Promise<Scl.Operation[]>;
+/**
+ * While no IED is assigned to an LNode, its naming is the naming it is specified with: an edit of
+ * it (prefix, class, instance, LD) is written to its `LNodeSpecNaming` too, so an unbinding later
+ * restores what was specified. Only for an LNode assigned to no IED before and after the edit, and
+ * not for a binding change (`lnUuid`, see `reconcileLNodeBinding`).
+ */
+export declare function mirrorSpecifiedNaming(query: Core.Query<Config>, params: {
+    oldRecord: Scl.RawRecord<Scl.ElementsOf>;
+    newRecord: Scl.RawRecord<Scl.ElementsOf>;
+}): Promise<Scl.Operation[]>;
+//# sourceMappingURL=lnode-spec-naming.d.ts.map

package/dist/v2019C1/hooks/shared/lnode-spec-naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lnode-spec-naming.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/lnode-spec-naming.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;GAGG;AACH,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;CAAE,GACjC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAkD1B;AAgBD,8FAA8F;AAC9F,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC9C,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACxC,GAAG,OAAO,CAQV;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC7C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IAAE,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CAAE,GAC3F,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAS1B;AAgBD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IAAE,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAAC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CAAE,GAC5F,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAqB1B"}

package/dist/v2019C1/hooks/shared/reconcile-mapped-data-below.d.ts

@@ -0,0 +1,11 @@
+import { ReconcileMappedDataParams } from './reconcile-mapped-data.types';
+import { Config, Scl } from '../../config';
+import type * as Core from '@dialecte/core';
+/**
+ * After a change to an `LNode` or a `DOS` / `SDS` that moves the default of the data below it,
+ * re-store every `DOS` / `SDS` / `DAS` below that names its implementation: an implementation
+ * that became the default loses its attributes. Records that name nothing follow the new
+ * default by themselves.
+ */
+export declare function reconcileMappedDataBelow(query: Core.Query<Config>, params: ReconcileMappedDataParams): Promise<Scl.Operation[]>;
+//# sourceMappingURL=reconcile-mapped-data-below.d.ts.map

package/dist/v2019C1/hooks/shared/reconcile-mapped-data-below.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-mapped-data-below.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/reconcile-mapped-data-below.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC7C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE,yBAAyB,GAC/B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAsB1B"}

package/dist/v2019C1/hooks/shared/reconcile-mapped-data.d.ts

@@ -0,0 +1,14 @@
+import { ReconcileMappedDataParams } from './reconcile-mapped-data.types';
+import { Config, Scl } from '../../config';
+import type * as Core from '@dialecte/core';
+/**
+ * Store a `DOS` / `SDS` / `DAS` implementation in its canonical form: nothing when the record
+ * is implemented by its default, otherwise the data path from the implementing logical node
+ * (`mappedDoName` / `mappedDaName`) together with that logical node's uuid (`mappedLnUuid`).
+ *
+ * Acts only on a record that names its implementation; leaves it untouched when the
+ * implementation cannot be resolved or the schema has no value for its data path.
+ * Returns an update operation, or `null` when the record is already canonical.
+ */
+export declare function reconcileMappedData(query: Core.Query<Config>, params: ReconcileMappedDataParams): Promise<Scl.Operation | null>;
+//# sourceMappingURL=reconcile-mapped-data.d.ts.map

package/dist/v2019C1/hooks/shared/reconcile-mapped-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-mapped-data.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/reconcile-mapped-data.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE,yBAAyB,GAC/B,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAuC/B"}

package/dist/v2019C1/hooks/shared/reconcile-mapped-data.types.d.ts

@@ -0,0 +1,6 @@
+import { Scl } from '../../config';
+export type ReconcileMappedDataParams = {
+    /** A `DOS` / `SDS` / `DAS` as it is now staged. Other tags are ignored. */
+    record: Scl.RawRecord<Scl.ElementsOf>;
+};
+//# sourceMappingURL=reconcile-mapped-data.types.d.ts.map

package/dist/v2019C1/hooks/shared/reconcile-mapped-data.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-mapped-data.types.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/reconcile-mapped-data.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAE3C,MAAM,MAAM,yBAAyB,GAAG;IACvC,2EAA2E;IAC3E,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACrC,CAAA"}

package/dist/v2019C1/hooks/shared/ref-entry-ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ref-entry-ops.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/ref-entry-ops.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAuB,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAOnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,QAAQ,CAAA;IACf,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;CACzB,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAmC3B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAUlE"}
+{"version":3,"file":"ref-entry-ops.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/ref-entry-ops.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAuB,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAQnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,QAAQ,CAAA;IACf,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;CACzB,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CA8B3B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAUlE"}

package/dist/v2019C1/hooks/shared/references-through.d.ts

@@ -0,0 +1,14 @@
+import { Scl, Config } from '../../config';
+import type * as Core from '@dialecte/core';
+/** Rebuild the paths of the references to `target`, found by its uuid. */
+export declare function rebuildReferencesTo(query: Core.Query<Config>, params: {
+    target: Scl.Ref<Scl.ElementsOf>;
+}): Promise<Scl.Operation[]>;
+/**
+ * Rebuild the paths of the references to every element below `record`: a change to its own
+ * segment changes theirs.
+ */
+export declare function rebuildReferencesBelow(query: Core.Query<Config>, params: {
+    record: Scl.Ref<Scl.ElementsOf>;
+}): Promise<Scl.Operation[]>;
+//# sourceMappingURL=references-through.d.ts.map

package/dist/v2019C1/hooks/shared/references-through.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references-through.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/references-through.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,0EAA0E;AAC1E,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IAAE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CAAE,GACzC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAW1B;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC3C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IAAE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CAAE,GACzC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAe1B"}

package/dist/v2019C1/hooks/shared/signal-sibling-paths.d.ts

@@ -0,0 +1,17 @@
+import { Scl, Config } from '../../config';
+import type * as Core from '@dialecte/core';
+/**
+ * A signal's name depends on the siblings that share it. When a signal of
+ * `parent` is added, changed or removed, rebuild the paths of the references to its siblings
+ * whose name is one of `names` (the name it had and the name it has).
+ */
+export declare function reconcileSignalSiblingPaths(query: Core.Query<Config>, params: {
+    parent: Scl.Ref<Scl.ElementsOf>;
+    tagName: string;
+    names: readonly string[];
+}): Promise<Scl.Operation[]>;
+/** The attributes a signal's name is built from (name, instance, data), empty for another tag. */
+export declare function signalNamingAttributes(tagName: string): string[];
+/** The name a signal record carries, or `undefined` when the record is not a signal. */
+export declare function signalName(record: Scl.RawRecord<Scl.ElementsOf>): string | undefined;
+//# sourceMappingURL=signal-sibling-paths.d.ts.map

package/dist/v2019C1/hooks/shared/signal-sibling-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-sibling-paths.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/hooks/shared/signal-sibling-paths.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;GAIG;AACH,wBAAsB,2BAA2B,CAChD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CACxB,GACC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CA6B1B;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAIhE;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CAIpF"}

package/dist/v2019C1/index.d.ts

@@ -1,5 +1,6 @@
 export * from './dialecte';
 export * from './config';
 export * from './constants';
+export * from './errors';
 export * from './extensions/public';
 //# sourceMappingURL=index.d.ts.map

package/dist/v2019C1/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v2019C1/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v2019C1/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,qBAAqB,CAAA"}

package/dist/v2019C1/index.js

@@ -1,40 +1,40 @@
-import { A as e, B as t, C as n, D as r, E as i, F as a, H as o, I as s, L as c, M as l, N as u, O as d, P as f, R as p, S as m, T as h, V as g, _, a as v, b as y, c as b, d as x, f as S, g as C, h as w, i as T, j as E, k as D, l as O, m as k, n as A, o as j, p as M, r as N, s as P, t as F, u as I, v as L, w as R, x as z, y as B, z as V } from "../hooks-CcSN4iH9.js";
-import { Project as H } from "@dialecte/core";
+import { A as e, B as t, C as n, D as r, E as i, F as a, G as o, H as s, I as c, J as l, K as u, L as d, M as f, N as p, O as m, P as h, Q as g, R as _, S as v, T as y, U as b, V as x, W as S, X as C, Y as w, Z as T, _ as E, a as D, b as O, c as k, d as A, f as j, g as M, h as N, i as P, j as F, k as I, l as L, m as R, n as z, o as B, p as V, q as H, r as U, s as W, t as G, u as K, v as q, x as J, y as Y, z as X } from "../hooks-CHS8tY1i.js";
+import { Project as Z } from "@dialecte/core";
 //#region src/v2019C1/extensions/lifecycle/validate/template-uuid-check.info.ts
-var U = {
+var Q = {
 	"cross-type-template-uuid": {
 		title: "Placeholder templateUuid reused across element types",
 		description: "One templateUuid is carried by elements of several different types, so it cannot identify a single template element — it is an authoring placeholder, not real lineage.",
-		fallback: "Template lineage is ignored for these elements; each instance is recognised by its name within its parent instead, so the merge still proceeds."
+		fallback: "Template lineage is ignored for these elements: none is recognised as an instance of a template element. A report then lists the template element as new and the existing element as an addition of the project."
 	},
 	"duplicate-instance-uuid": {
 		title: "Duplicate instance uuid",
 		description: "The same uuid is used by more than one element. Every instance uuid in an SCL must be unique, so uuid-based identity is ambiguous for the affected elements.",
-		fallback: "The affected elements are matched by name and position rather than uuid, so the merge still proceeds — resolve the duplication to restore reliable identity."
+		fallback: "Identity by uuid is ambiguous for the affected elements: which of them a reference or a template element resolves to is not defined."
 	},
 	"template-uuid-type-mismatch": {
 		title: "templateUuid resolves to a different element type",
 		description: "A templateUuid points in-file to an element of a different type than the one carrying it. An instance cannot derive from a template of another type, so the lineage is inconsistent.",
-		fallback: "The mismatched lineage is ignored and the element is recognised by name, so the merge still proceeds."
+		fallback: "The mismatched lineage is ignored: the element is not recognised as an instance of a template element. A report then lists the template element as new and the existing element as an addition of the project."
 	}
 };
 //#endregion
 //#region src/v2019C1/dialecte.ts
-function W(e) {
-	let { storage: n = { type: "local" }, extensions: r } = e ?? {};
-	return new H({
-		configs: { scl: t },
+function $(e) {
+	let { storage: t = { type: "local" }, extensions: n } = e ?? {};
+	return new Z({
+		configs: { scl: C },
 		defaultConfigKey: "scl",
-		storage: n,
+		storage: t,
 		extensions: {
-			base: N,
-			custom: r
+			base: U,
+			custom: n
 		},
 		hooks: {
-			...A(),
-			...F
+			...z(),
+			...G
 		}
 	});
 }
 //#endregion
-export { b as ALL_REF_UUID_ATTRIBUTES, O as ALL_RESOLUTIONS, v as DEFAULT_IGNORED_ATTRIBUTES, d as FRAME_OMIT_CHILD_TAGS, l as KEEP_ON_ORPHAN_REFS, I as LOCKED_LNODE_ATTRIBUTES, x as MAPPED_NAME_REFS, y as MIN_REQUESTED_SCD_CONNECTED_AP_TRIGGER_TAGS, z as MIN_REQUESTED_SCD_DESCRIPTIVE_ATTRIBUTES, m as MIN_REQUESTED_SCD_DESCRIPTIVE_TAGS, n as MIN_REQUESTED_SCD_FILE_USER_ATTRIBUTES, R as MIN_REQUESTED_SCD_IED_IGNORED_ATTRIBUTES, h as MIN_REQUESTED_SCD_IED_TRIGGER_ROOTS, i as MIN_REQUESTED_SCD_IED_TRIGGER_TAGS, r as MIN_REQUESTED_SCD_SUBNETWORK_TRIGGER_TAGS, S as PAIRS_BY_REF, c as PATH_CONTRIBUTING_ATTRIBUTES, p as PATH_EXTRACTION_CONFIG, u as REFERENCE_TAGS, f as REFERENCE_TAG_NAMES, P as REF_CONTAINERS, M as RESOLUTION_TARGET_REFS, B as RESOLUTION_TYPE, k as RESOLVABLE_RESOLUTIONS, V as SCL_DATABASE_CONFIG, t as SCL_DIALECTE_CONFIG, g as SCL_IO_CONFIG, o as SCL_NAMESPACES, a as TARGET_ELEMENT_TYPES, E as TEMPLATE_NAME, U as TEMPLATE_UUID_WARNING_INFO, D as TOPOLOGY_EQUIPMENT_TAGS, e as TOPOLOGY_STRUCTURAL_TAGS, L as TYPE_ID_REFERENCE_PAIRS, w as TYPE_ID_REFERRERS_BY_TARGET, C as TYPE_ID_REF_ATTRIBUTES, _ as TYPE_ID_TARGET_TAGS, s as UUID_REFERENCE_PAIRS, W as createSclProject, j as isTypeIdTarget, T as presentationScope };
+export { K as ALL_REF_UUID_ATTRIBUTES, A as ALL_RESOLUTIONS, D as DEFAULT_IGNORED_ATTRIBUTES, _ as FRAME_OMIT_CHILD_TAGS, b as FUNCTION_SCOPE_TAGS, S as KEEP_ON_ORPHAN_REFS, m as LNODE_NAMING_ATTRIBUTES, j as LOCKED_LNODE_ATTRIBUTES, V as MAPPED_DATA_DEFAULT_ATTRIBUTES, R as MAPPED_NAME_PATTERNS, N as MAPPED_NAME_REFS, e as MIN_REQUESTED_SCD_CONNECTED_AP_TRIGGER_TAGS, F as MIN_REQUESTED_SCD_DESCRIPTIVE_ATTRIBUTES, f as MIN_REQUESTED_SCD_DESCRIPTIVE_TAGS, p as MIN_REQUESTED_SCD_FILE_USER_ATTRIBUTES, h as MIN_REQUESTED_SCD_IED_IGNORED_ATTRIBUTES, a as MIN_REQUESTED_SCD_IED_TRIGGER_ROOTS, c as MIN_REQUESTED_SCD_IED_TRIGGER_TAGS, d as MIN_REQUESTED_SCD_SUBNETWORK_TRIGGER_TAGS, M as PAIRS_BY_REF, i as PATH_CONTRIBUTING_ATTRIBUTES, r as PATH_EXTRACTION_CONFIG, o as REFERENCE_TAGS, u as REFERENCE_TAG_NAMES, L as REF_CONTAINERS, E as RESOLUTION_TARGET_REFS, n as RESOLUTION_TYPE, q as RESOLVABLE_RESOLUTIONS, w as SCL_DATABASE_CONFIG, C as SCL_DIALECTE_CONFIG, W as SCL_ERRORS, B as SCL_IMPORT_WARNINGS, T as SCL_IO_CONFIG, g as SCL_NAMESPACES, I as SPECIFIED_NAMING_ATTRIBUTES, H as TARGET_ELEMENT_TYPES, x as TEMPLATE_NAME, Q as TEMPLATE_UUID_WARNING_INFO, X as TOPOLOGY_EQUIPMENT_TAGS, t as TOPOLOGY_STRUCTURAL_TAGS, v as TYPE_ID_REFERENCE_PAIRS, Y as TYPE_ID_REFERRERS_BY_TARGET, O as TYPE_ID_REF_ATTRIBUTES, J as TYPE_ID_TARGET_TAGS, s as UNALLOCATED_IED_NAME, l as UUID_REFERENCE_PAIRS, $ as createSclProject, y as getPathSegment, k as isTypeIdTarget, P as presentationScope };

package/dist/v2019C1/test/assert-coherent-scl-references.d.ts

@@ -0,0 +1,19 @@
+import { AssertCoherentSclReferencesParams, AssertCoherentSclReferencesTestCasesParams, CollectReferenceViolationsParams, ReferenceViolation } from './assert-coherent-scl-references.types';
+/**
+ * Every reference of a test XML document that a real file could not contain: a uuid that
+ * points at nothing, or at an element the reference cannot target, or a written path that
+ * is not the path of the element the uuid points at.
+ */
+export declare function collectReferenceViolations(params: CollectReferenceViolationsParams): ReferenceViolation[];
+/**
+ * Assert every reference of a test XML document is coherent. Throws with every violation
+ * when one is not.
+ */
+export declare function assertCoherentSclReferences(params: AssertCoherentSclReferencesParams): void;
+/**
+ * Check every case's `sourceXml`/`targetXml` and throw ONCE with the violations of all
+ * incoherent cases, each attributed to its case name. A case that sets
+ * `allowIncoherentReferences` is left unchecked.
+ */
+export declare function assertCoherentSclReferencesTestCases(params: AssertCoherentSclReferencesTestCasesParams): void;
+//# sourceMappingURL=assert-coherent-scl-references.d.ts.map

package/dist/v2019C1/test/assert-coherent-scl-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-coherent-scl-references.d.ts","sourceRoot":"","sources":["../../../src/v2019C1/test/assert-coherent-scl-references.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,iCAAiC,EACjC,0CAA0C,EAC1C,gCAAgC,EAChC,kBAAkB,EAClB,MAAM,wCAAwC,CAAA;AAQ/C;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,gCAAgC,GACtC,kBAAkB,EAAE,CAQtB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,iCAAiC,GAAG,IAAI,CAI3F;AAED;;;;GAIG;AACH,wBAAgB,oCAAoC,CACnD,MAAM,EAAE,0CAA0C,GAChD,IAAI,CAcN"}

package/dist/v2019C1/test/assert-coherent-scl-references.types.d.ts

@@ -0,0 +1,50 @@
+/** One incoherent reference found in a test XML document. */
+export type ReferenceViolation = {
+    kind: 'path';
+    referenceTagName: string;
+    pathAttribute: string;
+    uuidAttribute: string;
+    uuid: string;
+    /** The path written in the document. */
+    written: string;
+    /** The path of the element the uuid points at. */
+    expected: string;
+} | {
+    kind: 'dangling';
+    referenceTagName: string;
+    uuidAttribute: string;
+    uuid: string;
+} | {
+    kind: 'wrong-target';
+    referenceTagName: string;
+    uuidAttribute: string;
+    uuid: string;
+    /** The tag of the element carrying that uuid, which the reference cannot point at. */
+    targetTagName: string;
+} | {
+    kind: 'empty';
+    referenceTagName: string;
+    uuidAttribute: string;
+};
+export type CollectReferenceViolationsParams = {
+    xml: string;
+};
+export type AssertCoherentSclReferencesParams = {
+    xml: string;
+    /** Names the document in the failure message. */
+    label?: string;
+};
+/** A test case as the reference check reads it. */
+export type ReferenceCoherenceTestCase = {
+    sourceXml: string;
+    targetXml?: string;
+    /**
+     * Set when the case NEEDS an incoherent reference (an orphan to clean up, a path to
+     * repair): the reason it does. The case's documents are then left unchecked.
+     */
+    allowIncoherentReferences?: string;
+};
+export type AssertCoherentSclReferencesTestCasesParams = {
+    testCases: Record<string, ReferenceCoherenceTestCase>;
+};
+//# sourceMappingURL=assert-coherent-scl-references.types.d.ts.map

package/dist/v2019C1/test/assert-coherent-scl-references.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-coherent-scl-references.types.d.ts","sourceRoot":"","sources":["../../../src/v2019C1/test/assert-coherent-scl-references.types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAC3B;IACA,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAA;CACf,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnF;IACA,IAAI,EAAE,cAAc,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAA;CACpB,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAA;AAErE,MAAM,MAAM,gCAAgC,GAAG;IAC9C,GAAG,EAAE,MAAM,CAAA;CACX,CAAA;AAED,MAAM,MAAM,iCAAiC,GAAG;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,mDAAmD;AACnD,MAAM,MAAM,0BAA0B,GAAG;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,0CAA0C,GAAG;IACxD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAA;CACrD,CAAA"}