@dialecte/scl 0.5.0 → 0.6.0

package/dist/v2019C1/extensions/lifecycle/layers/topology/reconcile-topology-frame.d.ts

@@ -1,15 +1,19 @@
+import { FrameReconciliation } from './reconcile-topology-frame.types';
 import { Config, Scl } from '../../../../config';
 import { TopologyStructuralTag } from '../../../../constants';
 import { IdentityMode } from '../../../identity/transaction/write-identity.types';
 import { DecisionMap, DiffReport } from '../../engine/diff.types';
+import { DecisionMappings } from '../../mapping';
 import { MatchKey } from '../../scenario';
 import type * as Core from '@dialecte/core';
 /**
  * Reconcile a topology scope's OWN structural content (Substation/VoltageLevel/Bay attributes +
  * BayType + equipment) against a newer source, matched by identity.
  *
- * Finds the scope instances by `templateUuid` (stamp) / `uuid` (keep) - rename-robust, since the
- * frame carries stamped lineage - then runs the shared engine `reconcile` over each matched
+ * Finds the levels the scope instances sit on ({@link findFrameInstances}): by `templateUuid`
+ * (stamp) / `uuid` (keep) for a level created from the scope root - rename-robust, since the frame
+ * carries stamped lineage - or, for a level of the project the scope root was mapped onto, as the
+ * one holding what the placement put there (it then only receives contributions). Then runs the shared engine `reconcile` over each matched
  * instance's structural subtree with the fn/app tags as a BOUNDARY, so the delegated
  * Applications/Functions are left to the fn/app cascade. Several bays may share one `templateUuid`
  * (a bay-typical instantiated more than once): EACH is reconciled, gated by ONLY its own report
@@ -25,5 +29,7 @@ export declare function reconcileTopologyFrame(tx: Core.Transaction<Config>, par
     decisions?: DecisionMap;
     /** Multi-instance anchor: reconcile only the frame instance that IS the target (or under it). */
     targetInstance?: Scl.Ref<Scl.ElementsOf>;
-}): Promise<void>;
+    /** The consumer's choices, among them where a level the template gained lands per instance. */
+    decisionMappings?: DecisionMappings;
+}): Promise<FrameReconciliation>;
 //# sourceMappingURL=reconcile-topology-frame.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/reconcile-topology-frame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconcile-topology-frame.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/reconcile-topology-frame.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAA;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAA;AAC/F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAC3C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IACxC,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,EAAE,YAAY,CAAA;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,iGAAiG;IACjG,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACxC,GACC,OAAO,CAAC,IAAI,CAAC,CAkCf"}
+{"version":3,"file":"reconcile-topology-frame.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/reconcile-topology-frame.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAE3E,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAA;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAA;AAE/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC3C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IACxC,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,EAAE,YAAY,CAAA;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,iGAAiG;IACjG,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACnC,GACC,OAAO,CAAC,mBAAmB,CAAC,CA4E9B"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/reconcile-topology-frame.types.d.ts

@@ -0,0 +1,13 @@
+import { InstanceLevels } from './resolve-instance-levels.types';
+import { InstanceAdditions } from '../../engine/repoint-added-references.types';
+/** What reconciling the frame of each instance of a unit wrote, and where its levels now stand. */
+export type FrameReconciliation = {
+    /** What was added to each frame instance: its references are repointed once the fn/app cascade ran. */
+    additions: InstanceAdditions[];
+    /**
+     * Where each level of the unit stands for each instance once reconciled — the levels it created
+     * included: where the primaries the template gained are placed.
+     */
+    instanceLevelsList: InstanceLevels[];
+};
+//# sourceMappingURL=reconcile-topology-frame.types.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/reconcile-topology-frame.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-topology-frame.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/reconcile-topology-frame.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sEAAsE,CAAA;AAE7G,mGAAmG;AACnG,MAAM,MAAM,mBAAmB,GAAG;IACjC,uGAAuG;IACvG,SAAS,EAAE,iBAAiB,EAAE,CAAA;IAC9B;;;OAGG;IACH,kBAAkB,EAAE,cAAc,EAAE,CAAA;CACpC,CAAA"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-held-levels.d.ts

@@ -0,0 +1,18 @@
+import { FindHeldLevelParams, HeldLevels, ResolveHeldLevelsParams } from './resolve-held-levels.types';
+import { Config, Scl } from '../../../../config';
+import { MappingReader } from '../../mapping/mapping.types';
+import type * as Core from '@dialecte/core';
+/**
+ * The levels of the project one instance of a template lives on, read from where its elements
+ * sit: a level an element of the template sits under stands for the level of the same kind the
+ * element of the instance sits under. Several instances of one template each have their own.
+ * The first counterpart to tell a level settles it.
+ */
+export declare function resolveHeldLevels(reader: MappingReader, params: ResolveHeldLevelsParams): Promise<HeldLevels>;
+/**
+ * The level of the project an element of the template belongs on for one instance: the level the
+ * instance holds for the nearest level the element sits under. None when the instance holds no
+ * level the element sits under.
+ */
+export declare function findHeldLevel(sourceQuery: Core.Query<Config>, params: FindHeldLevelParams): Promise<Scl.Ref<Scl.ElementsOf> | undefined>;
+//# sourceMappingURL=resolve-held-levels.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-held-levels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-held-levels.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/resolve-held-levels.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,mBAAmB,EACnB,UAAU,EACV,uBAAuB,EACvB,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAA;AACzF,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAI3C;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,uBAAuB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAmBrB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAC/B,MAAM,EAAE,mBAAmB,GACzB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,CAQ9C"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-held-levels.types.d.ts

@@ -0,0 +1,23 @@
+import { Config, Scl } from '../../../../config';
+import type * as Core from '@dialecte/core';
+/** An element of the template and the element of the project that stands for it in one instance. */
+export type InstanceCounterpart = {
+    source: Scl.Ref<Scl.ElementsOf>;
+    instance: Scl.Ref<Scl.ElementsOf>;
+};
+export type ResolveHeldLevelsParams = {
+    sourceQuery: Core.Query<Config>;
+    /** What the instance holds of the template, the most telling first. */
+    counterparts: readonly InstanceCounterpart[];
+};
+/**
+ * The level of the project that stands for a level of the template, for one instance — by the
+ * record id of the source level.
+ */
+export type HeldLevels = ReadonlyMap<string, Scl.Ref<Scl.ElementsOf>>;
+export type FindHeldLevelParams = {
+    /** The element of the template to find the level of. */
+    sourceRef: Scl.Ref<Scl.ElementsOf>;
+    heldLevels: HeldLevels;
+};
+//# sourceMappingURL=resolve-held-levels.types.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-held-levels.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-held-levels.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/resolve-held-levels.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,oGAAoG;AACpG,MAAM,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACrC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,uEAAuE;IACvE,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAA;CAC5C,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;AAErE,MAAM,MAAM,mBAAmB,GAAG;IACjC,wDAAwD;IACxD,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAClC,UAAU,EAAE,UAAU,CAAA;CACtB,CAAA"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-instance-levels.d.ts

@@ -0,0 +1,28 @@
+import { InstanceLevels, InstancePlacement, ResolveInstanceLevelsParams, TemplateFrame } from './resolve-instance-levels.types';
+import { Config, Scl } from '../../../../config';
+import { MappingReader } from '../../mapping/mapping.types';
+import type * as Core from '@dialecte/core';
+/**
+ * For one instance of a template's unit, where each level of the unit stands in the project — read
+ * once, for everything that needs it (the frame diff, the levels listed as held, the levels the
+ * template gained, the parents of a gained primary):
+ *  - the unit itself on the level the instance sits on, and each level below it on the level,
+ *    below its parent's, that an earlier placement created from it or mapped it onto
+ *    ({@link findFrameInstances}), and the levels above the unit — `held`, top-down;
+ *  - a level the instance holds nothing for, below a level it holds, was gained by the template
+ *    since: listed in `gained`, and it stands on the level of the project the consumer mapped it onto
+ *    for this instance, else it is new to it (`undefined`).
+ */
+export declare function resolveInstanceLevels(reader: MappingReader, params: ResolveInstanceLevelsParams): Promise<InstancePlacement>;
+/**
+ * The structural levels of a template's unit — the levels above it, the unit, the levels below it,
+ * top-down — each with its ancestors and uuid: what every instance of the unit is read against,
+ * read once.
+ */
+export declare function resolveTemplateFrame(sourceQuery: Core.Query<Config>, unitRef: Scl.Ref<Scl.ElementsOf>): Promise<TemplateFrame>;
+/** The levels below the unit, as the matcher reads them: each lands on its level, or is new. */
+export declare function toPinnedMatches(params: {
+    instanceLevels: InstanceLevels;
+    scopeRef: Scl.Ref<Scl.ElementsOf>;
+}): Map<string, string | undefined>;
+//# sourceMappingURL=resolve-instance-levels.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-instance-levels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-instance-levels.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/resolve-instance-levels.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAGX,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,aAAa,EAEb,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAA;AACzF,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,2BAA2B,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAuE5B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACzC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAC/B,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC,CAexB;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACvC,cAAc,EAAE,cAAc,CAAA;IAC9B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACjC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CASlC"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-instance-levels.types.d.ts

@@ -0,0 +1,78 @@
+import { Config, Scl } from '../../../../config';
+import { DecisionMapping, DecisionMappings } from '../../mapping';
+import { MatchKey } from '../../scenario';
+import type * as Core from '@dialecte/core';
+/** A structural level of the template, as every instance reads it. */
+export type TemplateFrameElement = {
+    ref: Scl.Ref<Scl.ElementsOf> & {
+        id: string;
+    };
+    /** Its structural ancestors' record ids, nearest first. */
+    ancestorIds: readonly string[];
+    uuid: string | undefined;
+    /** A level above the unit: the project's context, which the template gives nothing to. */
+    context: boolean;
+};
+/** The structural levels of a template's unit, top-down, read once for all its instances. */
+export type TemplateFrame = {
+    /** The unit of the template: the first named level. */
+    scopeRef: Scl.Ref<Scl.ElementsOf> & {
+        id: string;
+    };
+    elements: readonly TemplateFrameElement[];
+};
+export type ResolveInstanceLevelsParams = {
+    sourceQuery: Core.Query<Config>;
+    /** The template's levels, read once (`resolveTemplateFrame`). */
+    templateFrame: TemplateFrame;
+    /** The level of the project the instance of the unit sits on. */
+    frameInstance: Scl.Ref<Scl.ElementsOf>;
+    matchKey?: MatchKey;
+    /**
+     * The consumer's choices: a level the template gained, mapped onto a level of the project for
+     * this instance (keyed by `standingChoiceKey` of the instance and the source level), stands on it.
+     */
+    decisionMappings?: DecisionMappings;
+};
+/**
+ * A level of the unit the instance holds nothing for, below a level it does hold: the template gained
+ * it since the instance was placed. Where it lands, for that instance, is the consumer's call
+ * (created by default).
+ */
+export type GainedLevel = {
+    sourceRef: Scl.Ref<Scl.ElementsOf> & {
+        id: string;
+    };
+    /** The level of the project it lands under: the one the instance holds for the level above. */
+    parentLevel: Scl.Ref<Scl.ElementsOf>;
+    /** The key of the consumer's choice for it, for this instance. */
+    choiceKey: string;
+    /** The consumer's choice, when made. */
+    decision?: DecisionMapping;
+};
+/** A level of the template the instance already stands on, as an earlier placement left it. */
+export type HeldLevel = {
+    sourceRef: Scl.Ref<Scl.ElementsOf> & {
+        id: string;
+    };
+    /** The level of the project it stands on. */
+    level: Scl.Ref<Scl.ElementsOf>;
+    /** The held level above it, by its source record id — none for the topmost. */
+    parentSourceId?: string;
+    /** The level is the project's own (reused), not one created from the template's level. */
+    projectOwned: boolean;
+};
+/** Where each level of the unit stands for one instance, and what the template gained since. */
+export type InstancePlacement = {
+    /** By source record id: the level each stands on, `undefined` when new to the instance. */
+    levels: InstanceLevels;
+    /** The levels the instance stands on, top-down — the levels above the unit included. */
+    held: HeldLevel[];
+    gained: GainedLevel[];
+};
+/**
+ * The level of the project each level of a template's unit stands on, for one instance — by the
+ * record id of the source level. `undefined`: the instance holds no level for it.
+ */
+export type InstanceLevels = ReadonlyMap<string, Scl.Ref<Scl.ElementsOf> | undefined>;
+//# sourceMappingURL=resolve-instance-levels.types.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-instance-levels.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-instance-levels.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/resolve-instance-levels.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC/F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG;IAClC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,2DAA2D;IAC3D,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,0FAA0F;IAC1F,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,6FAA6F;AAC7F,MAAM,MAAM,aAAa,GAAG;IAC3B,uDAAuD;IACvD,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IAClD,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACzC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,iEAAiE;IACjE,aAAa,EAAE,aAAa,CAAA;IAC5B,iEAAiE;IACjE,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACtC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACnC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,+FAA+F;IAC/F,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACpC,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC1B,CAAA;AAED,+FAA+F;AAC/F,MAAM,MAAM,SAAS,GAAG;IACvB,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,6CAA6C;IAC7C,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC9B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0FAA0F;IAC1F,YAAY,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,gGAAgG;AAChG,MAAM,MAAM,iBAAiB,GAAG;IAC/B,2FAA2F;IAC3F,MAAM,EAAE,cAAc,CAAA;IACtB,wFAAwF;IACxF,IAAI,EAAE,SAAS,EAAE,CAAA;IACjB,MAAM,EAAE,WAAW,EAAE,CAAA;CACrB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,CAAA"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-placement-mappings.d.ts

@@ -0,0 +1,20 @@
+import { PlacementLevel, ResolvePlacementMappingsParams } from './resolve-placement-mappings.types';
+import { MappingReader } from '../../mapping/mapping.types';
+/**
+ * Decide where each structural level of a template lands in the project — the ONE answer the
+ * report and the apply both read. Levels are resolved top-down, each below the element the level
+ * above lands on.
+ *
+ * A level ABOVE the unit to instantiate is the project's own context. The first of these that
+ * answers wins: the consumer's choice; the level of the element the consumer started from; the
+ * only such level there is below the one above. With none it is created; with several, none is
+ * picked: it is the consumer's to choose, and every level below waits for that choice.
+ *
+ * The unit to instantiate and the levels below it are created, under a name free where they
+ * land, unless the consumer chose an element of the project.
+ *
+ * The scope may also be a primary sitting below the levels (the function of an FSD): the levels
+ * above it are then all context, and it is no level itself.
+ */
+export declare function resolvePlacementMappings(reader: MappingReader, params: ResolvePlacementMappingsParams): Promise<PlacementLevel[]>;
+//# sourceMappingURL=resolve-placement-mappings.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-placement-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-placement-mappings.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/resolve-placement-mappings.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,cAAc,EACd,8BAA8B,EAC9B,MAAM,oCAAoC,CAAA;AAE3C,OAAO,KAAK,EAEX,aAAa,EAGb,MAAM,sDAAsD,CAAA;AAkB7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,8BAA8B,GACpC,OAAO,CAAC,cAAc,EAAE,CAAC,CA0C3B"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-placement-mappings.types.d.ts

@@ -0,0 +1,31 @@
+import { Config, Scl } from '../../../../config';
+import { DecisionMappings, ResolvedMapping, StoredRef } from '../../mapping/mapping.types';
+import type * as Core from '@dialecte/core';
+export type ResolvePlacementMappingsParams = {
+    sourceQuery: Core.Query<Config>;
+    /** The unit to instantiate: the first named level of the template. */
+    scopeRef: Scl.Ref<Scl.ElementsOf>;
+    /** The project element the consumer started from. */
+    anchor: Scl.Ref<Scl.ElementsOf>;
+    /** The consumer's choices, by source record id. */
+    decisionMappings?: DecisionMappings;
+};
+/** Where one structural level of a template lands in the project. */
+export type PlacementLevel = {
+    sourceRef: StoredRef;
+    /** Record id of the template level above this one — none for the top level. */
+    parentSourceId?: string;
+    /** The project element the level above lands on — none when that one is created. */
+    parentTarget?: Scl.Ref<Scl.ElementsOf>;
+    /** A level above the unit to instantiate: the project's own context, which the template gives nothing to. */
+    context: boolean;
+    resolved: ResolvedMapping;
+    /** The name asked for the level, when it is created: apply makes it free where it lands. */
+    createName?: string;
+    /**
+     * Nothing is decided for the level: several levels of the project qualify and the consumer has to
+     * choose, or the level above is itself not decided. Nothing can be placed until it is.
+     */
+    undecided: boolean;
+};
+//# sourceMappingURL=resolve-placement-mappings.types.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-placement-mappings.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-placement-mappings.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/resolve-placement-mappings.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EACX,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,MAAM,sDAAsD,CAAA;AAC7D,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,MAAM,MAAM,8BAA8B,GAAG;IAC5C,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,sEAAsE;IACtE,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACjC,qDAAqD;IACrD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACnC,CAAA;AAED,qEAAqE;AACrE,MAAM,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,SAAS,CAAA;IACpB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,oFAAoF;IACpF,YAAY,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACtC,6GAA6G;IAC7G,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,eAAe,CAAA;IACzB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAA;CAClB,CAAA"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-parents.d.ts

@@ -0,0 +1,16 @@
+import { PrimaryParents, ResolvePrimaryParentsParams } from './resolve-primary-parents.types';
+import { Config } from '../../../../config';
+import type * as Core from '@dialecte/core';
+/**
+ * Where a primary of the scope is updated, and whether the template gained it (no instance of it
+ * yet).
+ *
+ * A primary the project already holds an instance of is reconciled where its instances are: under
+ * the element the consumer started from. A primary the template GAINED has none: it is placed once
+ * per instance of the unit — for that instance (`placedFor`, the level it sits on), on the level the
+ * instance holds for the level the primary sits on in the template, in the bay the instance lives
+ * in, not under the element the update was started from. With no instance of the unit to tell, it
+ * falls back on that element.
+ */
+export declare function resolvePrimaryParents(query: Core.Query<Config>, params: ResolvePrimaryParentsParams): Promise<PrimaryParents>;
+//# sourceMappingURL=resolve-primary-parents.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-parents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-primary-parents.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-parents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,cAAc,EAEd,2BAA2B,EAC3B,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE,2BAA2B,GACjC,OAAO,CAAC,cAAc,CAAC,CAuBzB"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-parents.types.d.ts

@@ -0,0 +1,36 @@
+import { InstanceLevels } from './resolve-instance-levels.types';
+import { Config, Scl } from '../../../../config';
+import { MatchKey } from '../../scenario';
+import type * as Core from '@dialecte/core';
+export type ResolvePrimaryParentsParams = {
+    sourceQuery: Core.Query<Config>;
+    primaryRef: Scl.Ref<'Application'> | Scl.Ref<'Function'>;
+    /** The element of the project the consumer started from. */
+    anchor: Scl.Ref<Scl.ElementsOf>;
+    /** The record id of the template's unit: each instance's levels name the level it sits on by it. */
+    unitId: string;
+    /** Where each instance of the unit lives, level by level. */
+    instanceLevelsList: readonly InstanceLevels[];
+    matchKey: MatchKey;
+};
+/** One place a primary of a topology unit is placed or reconciled under. */
+export type PrimaryPlace = {
+    /**
+     * The level of the project it lands under. Undefined while that level is not written: the
+     * template gained it and this update creates it, or the consumer left it out.
+     */
+    parent?: Scl.Ref<Scl.ElementsOf>;
+    /**
+     * For a primary the template gained, the instance of the unit it is placed in — the level that
+     * instance sits on, the same before and after the write: what the report lists it for.
+     */
+    placedFor?: Scl.Ref<Scl.ElementsOf>;
+};
+/** Where a primary of a topology unit is placed or reconciled. */
+export type PrimaryParents = {
+    /** One per instance of the unit when gained; else the element the consumer started from. */
+    places: PrimaryPlace[];
+    /** The template gained it: the project holds no instance of it yet. */
+    gained: boolean;
+};
+//# sourceMappingURL=resolve-primary-parents.types.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-parents.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-primary-parents.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-parents.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,MAAM,MAAM,2BAA2B,GAAG;IACzC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxD,4DAA4D;IAC5D,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,oGAAoG;IACpG,MAAM,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,kBAAkB,EAAE,SAAS,cAAc,EAAE,CAAA;IAC7C,QAAQ,EAAE,QAAQ,CAAA;CAClB,CAAA;AAED,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACnC,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG;IAC5B,4FAA4F;IAC5F,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAA;CACf,CAAA"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-placement.d.ts

@@ -0,0 +1,15 @@
+import { PrimaryPlacement, ResolvePrimaryPlacementParams } from './resolve-primary-placement.types';
+import { MappingReader } from '../../mapping/mapping.types';
+/**
+ * Decide where the primaries of a function or application template land.
+ *
+ * The level a primary sits at in the template is the HIGHEST level it may be placed at. Started at
+ * that level or below it, the template lands where the consumer started: nothing to map. Started
+ * ABOVE it, the content cannot stay there: each level of the template is resolved top-down
+ * ({@link resolvePlacementMappings}) and the primaries land on the level their template says —
+ * and the placement is said to be off-level, so the consumer is told.
+ *
+ * A primary with no level in the template (a function template) may be placed anywhere.
+ */
+export declare function resolvePrimaryPlacement(reader: MappingReader, params: ResolvePrimaryPlacementParams): Promise<PrimaryPlacement>;
+//# sourceMappingURL=resolve-primary-placement.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-primary-placement.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-placement.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,gBAAgB,EAChB,6BAA6B,EAC7B,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAA;AAIzF;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,6BAA6B,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAiC3B"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-placement.types.d.ts

@@ -0,0 +1,30 @@
+import { PlacementLevel } from './resolve-placement-mappings.types';
+import { Config, Scl } from '../../../../config';
+import { DecisionMappings } from '../../mapping/mapping.types';
+import type * as Core from '@dialecte/core';
+export type ResolvePrimaryPlacementParams = {
+    sourceQuery: Core.Query<Config>;
+    /** The primaries of the template being placed: a function, or an application and its functions. */
+    primaryRefs: readonly Scl.Ref<Scl.ElementsOf>[];
+    /** The project element the consumer started from. */
+    anchor: Scl.Ref<Scl.ElementsOf>;
+    /** The consumer's choices, by source record id. */
+    decisionMappings?: DecisionMappings;
+};
+/** The consumer started above the level a template was made for: its content lands below. */
+export type OffLevel = {
+    /** The kind of level the template was made for. */
+    templateLevel: string;
+    /** The kind of level the consumer started from. */
+    startedFrom: string;
+};
+/** Where the primaries of a template land, when it is not simply where the consumer started. */
+export type PrimaryPlacement = {
+    /**
+     * Where each level of the template lands — none when the consumer started at or below the level
+     * the template was made for: the primaries then land where the consumer started.
+     */
+    levels: PlacementLevel[];
+    offLevel?: OffLevel;
+};
+//# sourceMappingURL=resolve-primary-placement.types.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-placement.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-primary-placement.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/resolve-primary-placement.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,MAAM,MAAM,6BAA6B,GAAG;IAC3C,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,mGAAmG;IACnG,WAAW,EAAE,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IAC/C,qDAAqD;IACrD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACnC,CAAA;AAED,6FAA6F;AAC7F,MAAM,MAAM,QAAQ,GAAG;IACtB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAA;IACrB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,gGAAgG;AAChG,MAAM,MAAM,gBAAgB,GAAG;IAC9B;;;OAGG;IACH,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB,CAAA"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/scope-content.d.ts

@@ -1,6 +1,7 @@
 import { TopologyReconcilables } from './scope-content.types';
 import { Config, Scl } from '../../../../config';
 import { TopologyStructuralTag } from '../../../../constants';
+import { MatchKey } from '../../scenario';
 import type * as Core from '@dialecte/core';
 /** Applications whose structural ancestry includes `scopeRef` (Substation / VoltageLevel / Bay). */
 export declare function applicationsUnderScope(query: Core.Query<Config>, scopeRef: Scl.Ref<TopologyStructuralTag>): Promise<Scl.Ref<'Application'>[]>;
@@ -12,4 +13,14 @@ export declare function functionsUnderScope(query: Core.Query<Config>, scopeRef:
  * Shared by `report.ssd` and `update.ssd` so both walk the same primary set.
  */
 export declare function resolveTopologyReconcilables(query: Core.Query<Config>, scopeRef: Scl.Ref<TopologyStructuralTag>): Promise<TopologyReconcilables>;
+/**
+ * Whether the project already holds an instance of any primary of a topology scope (by lineage).
+ * With none, reconciling the scope is a first placement, whatever operation was asked for.
+ */
+export declare function hasScopeInstance(reader: Core.Query<Config> | Core.Transaction<Config>, params: {
+    sourceQuery: Core.Query<Config>;
+    applicationRefs: readonly Scl.Ref<'Application'>[];
+    standaloneFunctions: readonly Scl.Ref<'Function'>[];
+    matchKey: MatchKey;
+}): Promise<boolean>;
 //# sourceMappingURL=scope-content.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/scope-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope-content.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/scope-content.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,oGAAoG;AACpG,wBAAsB,sBAAsB,CAC3C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,GACtC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAWnC;AAED,yEAAyE;AACzE,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,GACtC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAWhC;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CACjD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,GACtC,OAAO,CAAC,qBAAqB,CAAC,CAkBhC"}
+{"version":3,"file":"scope-content.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/scope-content.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,oGAAoG;AACpG,wBAAsB,sBAAsB,CAC3C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,GACtC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAWnC;AAED,yEAAyE;AACzE,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,GACtC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAWhC;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CACjD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,GACtC,OAAO,CAAC,qBAAqB,CAAC,CAkBhC;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EACrD,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,eAAe,EAAE,SAAS,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAA;IAClD,mBAAmB,EAAE,SAAS,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACnD,QAAQ,EAAE,QAAQ,CAAA;CAClB,GACC,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/v2019C1/extensions/lifecycle/mapping/assert-mapping-decided.d.ts

@@ -0,0 +1,17 @@
+import { ResolvedMapping, ResolvedMappings, StoredRef } from './mapping.types';
+import { Scl } from '../../../config';
+/**
+ * Refuse to write while where a shared element lands is the consumer's to choose: several
+ * elements of the project qualify, and neither picking one nor creating another is the engine's
+ * call.
+ */
+export declare function assertMappingDecided(params: {
+    sourceRef: StoredRef;
+    resolved: ResolvedMapping;
+}): void;
+/** {@link assertMappingDecided} for every shared element carried with a source primary. */
+export declare function assertMappingsDecided(params: {
+    satelliteRefs: readonly Scl.Ref<Scl.ElementsOf>[];
+    resolvedMappings: ResolvedMappings;
+}): void;
+//# sourceMappingURL=assert-mapping-decided.d.ts.map

package/dist/v2019C1/extensions/lifecycle/mapping/assert-mapping-decided.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-mapping-decided.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/mapping/assert-mapping-decided.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACnF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAE3C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC5C,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,eAAe,CAAA;CACzB,GAAG,IAAI,CAQP;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC7C,aAAa,EAAE,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACjD,gBAAgB,EAAE,gBAAgB,CAAA;CAClC,GAAG,IAAI,CASP"}

package/dist/v2019C1/extensions/lifecycle/mapping/assert-mappings-coherent.d.ts

@@ -0,0 +1,10 @@
+import { DecisionMappings, ReportMapping } from './mapping.types';
+/**
+ * Reject a set of mapping choices the report cannot honour. Runs on the report (the choices it
+ * was derived from) and before any write.
+ */
+export declare function assertMappingsCoherent(params: {
+    reportMappings: readonly ReportMapping[];
+    decisionMappings: DecisionMappings;
+}): void;
+//# sourceMappingURL=assert-mappings-coherent.d.ts.map

package/dist/v2019C1/extensions/lifecycle/mapping/assert-mappings-coherent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-mappings-coherent.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/mapping/assert-mappings-coherent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEtE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC9C,cAAc,EAAE,SAAS,aAAa,EAAE,CAAA;IACxC,gBAAgB,EAAE,gBAAgB,CAAA;CAClC,GAAG,IAAI,CAmCP"}

package/dist/v2019C1/extensions/lifecycle/mapping/describe-mapping.d.ts

@@ -0,0 +1,28 @@
+import { DecisionMapping, MappingCandidate, MappingPolicy, ReportMapping, ReportPass, ResolvedMapping } from './mapping.types';
+import { Config, Scl } from '../../../config';
+import type * as Core from '@dialecte/core';
+/** What one pass over a report shares between the elements it describes — empty to start with. */
+export declare function createReportPass(): ReportPass;
+/**
+ * What the report says about one shared source element: where it lands (as resolved), why,
+ * and every project element it could be mapped onto instead. For an element to create, the
+ * name is the one asked for — the consumer's, else the template's: apply makes it free where the
+ * element lands, and what it wrote is read at the mapping's `appliedRef`.
+ */
+export declare function describeMapping(query: Core.Query<Config>, params: {
+    sourceQuery: Core.Query<Config>;
+    sourceRef: Scl.Ref<Scl.ElementsOf> & {
+        id: string;
+    };
+    policy: MappingPolicy;
+    resolved: ResolvedMapping;
+    /** The consumer's choice for this source element, when it made one. */
+    decision?: DecisionMapping;
+    /** The project element the template is placed under. */
+    anchor?: Scl.Ref<Scl.ElementsOf>;
+    /** What the report already listed and named — its own when the caller describes one element. */
+    pass?: ReportPass;
+}): Promise<ReportMapping>;
+/** A project element as the report lists it: its title and where it sits. */
+export declare function describeCandidate(query: Core.Query<Config>, ref: Scl.Ref<Scl.ElementsOf>): Promise<MappingCandidate>;
+//# sourceMappingURL=describe-mapping.d.ts.map

package/dist/v2019C1/extensions/lifecycle/mapping/describe-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-mapping.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/mapping/describe-mapping.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,kGAAkG;AAClG,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACpC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,eAAe,CAAA;IACzB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChC,gGAAgG;IAChG,IAAI,CAAC,EAAE,UAAU,CAAA;CACjB,GACC,OAAO,CAAC,aAAa,CAAC,CAyCxB;AAwDD,6EAA6E;AAC7E,wBAAsB,iBAAiB,CACtC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAI3B"}

package/dist/v2019C1/extensions/lifecycle/mapping/find-withdrawn-contributions.d.ts

@@ -0,0 +1,16 @@
+import { FindWithdrawnContributionsParams, MappingReader } from './mapping.types';
+import { AnyTreeRecord } from '@dialecte/core';
+/**
+ * What an instance gave to project elements the template no longer brings anything for.
+ *
+ * A shared source element mapped onto an element of the project contributes references to it (an
+ * `AllocationRole`'s function references). When the template drops that source element, the
+ * project element stays — it is the project's — but the references this instance gave it now
+ * stand for nothing: they are the ones pointing at an element of the instance.
+ *
+ * Read by the report (announced as removed) and by the apply (removed when accepted) alike.
+ * Elements created from the template are not concerned: they carry its lineage and are removed
+ * as a whole when their source element is.
+ */
+export declare function findWithdrawnContributions(reader: MappingReader, params: FindWithdrawnContributionsParams): Promise<AnyTreeRecord[]>;
+//# sourceMappingURL=find-withdrawn-contributions.d.ts.map

package/dist/v2019C1/extensions/lifecycle/mapping/find-withdrawn-contributions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-withdrawn-contributions.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/mapping/find-withdrawn-contributions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gCAAgC,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAC/C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,gCAAgC,GACtC,OAAO,CAAC,aAAa,EAAE,CAAC,CA4B1B"}

package/dist/v2019C1/extensions/lifecycle/mapping/index.d.ts

@@ -0,0 +1,9 @@
+export { assertMappingDecided, assertMappingsDecided } from './assert-mapping-decided';
+export { assertMappingsCoherent } from './assert-mappings-coherent';
+export { createReportPass, describeMapping } from './describe-mapping';
+export { findMappingPolicy } from './mapping-policies';
+export { findWithdrawnContributions } from './find-withdrawn-contributions';
+export { resolveMapping } from './resolve-mapping';
+export { resolveSatelliteMappings, toRedirectMappings } from './resolve-satellite-mappings';
+export type { DecisionMapping, DecisionMappings, MappingCandidate, MappingKind, MappingPolicy, MappingReason, ReportMapping, ReportPass, ResolvedMapping, ResolvedMappings, } from './mapping.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/v2019C1/extensions/lifecycle/mapping/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/mapping/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAA;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAC3F,YAAY,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,gBAAgB,GAChB,MAAM,iBAAiB,CAAA"}

package/dist/v2019C1/extensions/lifecycle/mapping/mapping-policies.d.ts

@@ -0,0 +1,4 @@
+import { MappingPolicy } from './mapping.types';
+/** The mapping policy of a shared element, as declared by its layer — `undefined` for any other tag. */
+export declare function findMappingPolicy(tagName: string): MappingPolicy | undefined;
+//# sourceMappingURL=mapping-policies.d.ts.map

package/dist/v2019C1/extensions/lifecycle/mapping/mapping-policies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-policies.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/mapping/mapping-policies.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAQpD,wGAAwG;AACxG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE5E"}