@dialecte/scl 0.5.0 → 0.6.0

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

@@ -0,0 +1,204 @@
+import { Config, Scl } from '../../../config';
+import { MatchKey } from '../scenario';
+import { AnyRefOrRecord, AnyTrackedRecord } from '@dialecte/core';
+import type * as Core from '@dialecte/core';
+/** A read surface shared by the report (Query) and the apply (Transaction). */
+export type MappingReader = Core.Query<Config> | Core.Transaction<Config>;
+/**
+ * How a shared element of the project is recognised as the one a source element stands for.
+ * Declared by the layer that owns the element.
+ */
+export type MappingPolicy = {
+    tagName: Scl.ElementsOf;
+    /** The attribute a source element and a project element share when they are the same thing. */
+    key: 'name';
+    /** The consumer may choose another mapping than the one resolved. */
+    selectable: boolean;
+};
+/**
+ * Why a source element was mapped the way it was:
+ *  - `decision` — the consumer chose;
+ *  - `lineage` — the project already holds the element standing for it: the one this instance was
+ *    given by an earlier placement, or the one element created from it;
+ *  - `name` — exactly one project element shares its key;
+ *  - `anchor` — a level of the project the consumer started from;
+ *  - `only` — the only such level there is, below the one above;
+ *  - `none` — nothing to map onto, it is created.
+ */
+export type MappingReason = 'decision' | 'lineage' | 'name' | 'anchor' | 'only' | 'none';
+/** Where a shared source element lands in the project. */
+export type ResolvedMapping = {
+    /** The project element the source element maps onto. Absent: a new element is created. */
+    existing?: AnyTrackedRecord;
+    reason: MappingReason;
+    /**
+     * Nothing was picked although something qualified: several project elements qualified equally,
+     * or the instance being updated holds an element that could stand for this one and nothing
+     * tells whether it does.
+     */
+    ambiguous: boolean;
+    /** The instance being updated already carries this mapping: it is not the consumer's to change. */
+    locked: boolean;
+    /**
+     * The element mapped onto is the project's own (it does not carry the source element's lineage):
+     * it only receives what the source element contributes below it.
+     */
+    projectOwned: boolean;
+    /**
+     * Nothing is decided: several project elements qualify, or the instance holds an element that
+     * could stand for this one, and where it lands is the consumer's to choose. Nothing is written
+     * until it chose. Never set for an element whose mapping the consumer cannot choose.
+     */
+    undecided: boolean;
+};
+/** Where each shared source element of one instance lands, by the record id of the source element. */
+export type ResolvedMappings = ReadonlyMap<string, ResolvedMapping>;
+export type ResolveMappingParams = {
+    sourceQuery: Core.Query<Config>;
+    sourceRef: Scl.Ref<Scl.ElementsOf>;
+    policy: MappingPolicy;
+    /** The consumer's choice for this source element, when it made one. */
+    decision?: DecisionMapping;
+    /** How a project element carries the uuid of the source element it was created from. */
+    matchKey?: MatchKey;
+};
+export type ResolveSatelliteMappingsParams = {
+    sourceQuery: Core.Query<Config>;
+    /** The source elements carried with the source primary. */
+    satelliteRefs: readonly Scl.Ref<Scl.ElementsOf>[];
+    /** The project elements carried with the instance being updated — none on a first placement. */
+    instanceSatelliteRefs?: readonly Scl.Ref<Scl.ElementsOf>[];
+    /** The consumer's choices, by source record id. */
+    decisionMappings?: DecisionMappings;
+    matchKey?: MatchKey;
+};
+export type FindWithdrawnContributionsParams = {
+    /** The instance being updated. */
+    instancePrimaryRef: AnyRefOrRecord;
+    /** The project elements carried with the instance, as they were before the update. */
+    instanceSatelliteRefs: readonly Scl.Ref<Scl.ElementsOf>[];
+    /** Where the shared source elements of the template land for this instance. */
+    resolvedMappings: ResolvedMappings;
+    matchKey?: MatchKey;
+};
+/** A reference to a stored element: its record id is known. */
+export type StoredRef = Scl.Ref<Scl.ElementsOf> & {
+    id: string;
+};
+/** A shared source element and the policy its tag declares. */
+export type SourceSatellite = {
+    ref: StoredRef;
+    policy: MappingPolicy;
+};
+export type PairInstanceSatellitesParams = {
+    sourceQuery: Core.Query<Config>;
+    sourceSatellites: readonly SourceSatellite[];
+    instanceSatelliteRefs: readonly StoredRef[];
+    matchKey: MatchKey;
+};
+/** A project element an instance already holds for a shared source element. */
+export type InstanceSatellitePair = {
+    existing: AnyTrackedRecord;
+    projectOwned: boolean;
+};
+export type InstanceSatellitePairing = {
+    /** The project element the instance holds for each shared source element, by source record id. */
+    pairs: ReadonlyMap<string, InstanceSatellitePair>;
+    /**
+     * Record ids of the source elements left unpaired although the instance holds elements that
+     * could stand for them: nothing tells which.
+     */
+    undecidedSourceIds: ReadonlySet<string>;
+};
+/** A project element a shared source element may be mapped onto. */
+export type MappingCandidate = {
+    ref: Scl.Ref<Scl.ElementsOf>;
+    title: string;
+    /** Where the element sits in the project. */
+    path: string;
+};
+/**
+ * What one pass over a report shares between the elements it describes: the candidates already
+ * listed, by tag and anchor — every shared element of a kind is offered the same project elements.
+ */
+export type ReportPass = {
+    candidates: Map<string, MappingCandidate[]>;
+};
+/** Where one shared source element lands: an element of the project, or a new one. */
+export type DecisionMapping = {
+    existing: Scl.Ref<Scl.ElementsOf>;
+} | {
+    create: {
+        name?: string;
+    };
+};
+/** The consumer's choices, keyed by the record id of the source element. */
+export type DecisionMappings = ReadonlyMap<string, DecisionMapping>;
+/**
+ * What a mapping is about: a structural `level` of the template (where its content is placed), or
+ * a `shared` element the project holds once and the template refers to.
+ */
+export type MappingKind = 'level' | 'shared';
+/** What the report says about one source element that lands on an element of the project. */
+export type ReportMapping = {
+    /**
+     * The key of a choice made for it: the record id of the source element — or, for a mapping
+     * decided for one element of the project (`placedFor`), that element's id and the source
+     * element's (`<placedFor id>::<source id>`).
+     */
+    id: string;
+    /** Record id of the source element, when `id` is scoped to `placedFor`. */
+    sourceId?: string;
+    /**
+     * The element of the project this mapping is decided for, when the report lists it once per
+     * such element (a function an application gained, for one instance of the application).
+     */
+    placedFor?: AnyRefOrRecord;
+    tagName: string;
+    kind: MappingKind;
+    /**
+     * Where it lands. Absent: nothing is decided — several elements qualify and none is picked for
+     * the consumer, or it follows from a mapping that is not decided yet. The report then asks for
+     * a decision and `apply` refuses until the consumer chose.
+     */
+    mapping?: DecisionMapping;
+    /**
+     * Set when it lands on an element the project owns — reused, not an instance of the source
+     * element: that element keeps its own attributes and only gains what the source contributes.
+     */
+    projectOwned?: true;
+    /**
+     * For an element to create: the path of the element it is created under — an element of the
+     * project, or one this placement creates too.
+     */
+    parentPath?: string;
+    reason: MappingReason;
+    /**
+     * Nothing was picked although something qualified: several project elements qualified equally
+     * (`reason` tells how) or — with the reason `none` — the instance being updated holds an element
+     * that could stand for this one and nothing tells whether it does. When the consumer may choose
+     * (`selectable`), the mapping is then left undecided; otherwise a new element is created.
+     */
+    ambiguous: boolean;
+    /** The consumer may choose another mapping for an element of this kind. */
+    selectable: boolean;
+    /** The instance being updated already carries this mapping: shown, not the consumer's to change. */
+    locked: boolean;
+    /**
+     * Every project element this source element could be mapped onto — for a locked mapping, the one
+     * it is mapped onto.
+     */
+    candidates: MappingCandidate[];
+    /**
+     * The id of the mapping this one depends on — the level above, for a structural level: what it
+     * can be mapped onto follows from where that one lands.
+     */
+    dependsOn?: string;
+    /**
+     * The element this source element became in the APPLIED document, filled by `apply` on the
+     * report it returns (undefined on a pure `report`): the element created for it, or the one it is
+     * mapped onto. Lets a consumer show an element created for a mapping as new.
+     */
+    appliedRef?: AnyRefOrRecord;
+};
+//# sourceMappingURL=mapping.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.types.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/mapping/mapping.types.ts"],"names":[],"mappings":"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"}

package/dist/v2019C1/extensions/lifecycle/mapping/pair-instance-satellites.d.ts

@@ -0,0 +1,16 @@
+import { InstanceSatellitePairing, MappingReader, PairInstanceSatellitesParams } from './mapping.types';
+/**
+ * Recognise, for one instance, the project element it already holds for each shared source
+ * element — the mapping an earlier placement made. Nothing in the file records it, so it is read
+ * from what that placement wrote, strongest evidence first:
+ *  1. the project element carries the source element's lineage (it was created from it);
+ *  2. it holds a reference to the element that stands, in the project, for one the source element
+ *     refers to (the references the mapping contributed to it);
+ *  3. it carries the same key (its name);
+ *  4. it is the only one left, for the only source element left.
+ * Each step pairs a source element with a project element only when neither has another
+ * possibility at that step. A source element left unpaired is new to the instance — or, when
+ * elements of the instance are left too, undecided: nothing tells which one stands for it.
+ */
+export declare function pairInstanceSatellites(reader: MappingReader, params: PairInstanceSatellitesParams): Promise<InstanceSatellitePairing>;
+//# sourceMappingURL=pair-instance-satellites.d.ts.map

package/dist/v2019C1/extensions/lifecycle/mapping/pair-instance-satellites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pair-instance-satellites.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/mapping/pair-instance-satellites.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEX,wBAAwB,EACxB,aAAa,EACb,4BAA4B,EAG5B,MAAM,iBAAiB,CAAA;AAMxB;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,4BAA4B,GAClC,OAAO,CAAC,wBAAwB,CAAC,CAoGnC"}

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

@@ -0,0 +1,15 @@
+import { MappingReader, ResolveMappingParams, ResolvedMapping } from './mapping.types';
+/**
+ * Decide where a shared source element lands in the project — the ONE answer the report and the
+ * apply both read, so the review shows what is applied.
+ *
+ * The first of these that answers wins:
+ *  1. the consumer's choice;
+ *  2. the one project element created from this source element (it carries its lineage);
+ *  3. the one project element carrying the same key (its name).
+ * With nothing to map onto, a new element is created. Where several elements qualify equally,
+ * none is picked: the mapping is left `undecided` for the consumer to choose — or, for an element
+ * whose mapping cannot be chosen, a new one is created too.
+ */
+export declare function resolveMapping(reader: MappingReader, params: ResolveMappingParams): Promise<ResolvedMapping>;
+//# sourceMappingURL=resolve-mapping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-mapping.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/mapping/resolve-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAG3F;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAiE1B"}

package/dist/v2019C1/extensions/lifecycle/mapping/resolve-satellite-mappings.d.ts

@@ -0,0 +1,26 @@
+import { MappingReader, ResolvedMappings, ResolveSatelliteMappingsParams } from './mapping.types';
+import { Config, Scl } from '../../../config';
+import { RedirectMapping } from '../../reference/transaction/apply-uuid-remap.types';
+import type * as Core from '@dialecte/core';
+/**
+ * Where each shared element carried with a source primary lands in the project — read by the
+ * report and by the apply alike, for a first placement and for an update.
+ *
+ * A shared element the instance being updated already holds an element for keeps that mapping
+ * (`locked`, see {@link pairInstanceSatellites}). Any other — every one of them on a first
+ * placement — is resolved by {@link resolveMapping}; where the instance holds an element that
+ * could stand for it and nothing tells whether it does, it is flagged `ambiguous` until the
+ * consumer's choices settle it. Elements whose tag declares no mapping
+ * policy are not shared elements and are left out.
+ */
+export declare function resolveSatelliteMappings(reader: MappingReader, params: ResolveSatelliteMappingsParams): Promise<ResolvedMappings>;
+/**
+ * The redirect mappings of the shared elements that landed on an element of the project: a
+ * reference to such a source element is a reference to that project element.
+ */
+export declare function toRedirectMappings(params: {
+    sourceQuery: Core.Query<Config>;
+    satelliteRefs: readonly Scl.Ref<Scl.ElementsOf>[];
+    resolvedMappings: ResolvedMappings;
+}): Promise<RedirectMapping[]>;
+//# sourceMappingURL=resolve-satellite-mappings.d.ts.map

package/dist/v2019C1/extensions/lifecycle/mapping/resolve-satellite-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-satellite-mappings.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/mapping/resolve-satellite-mappings.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGX,aAAa,EAGb,gBAAgB,EAChB,8BAA8B,EAG9B,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mEAAmE,CAAA;AACxG,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,8BAA8B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAyD3B;AAgDD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAChD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,aAAa,EAAE,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACjD,gBAAgB,EAAE,gBAAgB,CAAA;CAClC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAY7B"}

package/dist/v2019C1/extensions/lifecycle/public.d.ts

@@ -1,9 +1,11 @@
-export type { AttributeChange, DecisionGroup, DecisionMap, DiffChange, DiffNode, DiffReport, DiffSummary, GroupConflict, GroupDecision, } from './engine/public';
-export type { AttributeEditability, EditableAttribute } from './constraints/public';
-export type { LifecycleApplyParams, LifecycleScenario, LifecycleTarget, LifecycleVerb, } from './contract.types';
+export type { AttributeChange, DecisionGroup, DecisionMap, DiffChange, DiffNode, DiffReport, DiffSummary, GroupDecision, } from './engine/public';
+export type { AttributeEditability, ConstraintViolation, EditableAttribute, MakeUniqueParams, PlacementResolution, } from './constraints/public';
+export type { AfterApplyHook, LifecycleApplyParams, LifecycleReportParams, Resolution, LifecycleScenario, LifecycleTarget, LifecycleVerb, } from './contract.types';
 export type { AppliedInstances, ApplyResult } from './apply';
+export type { DecisionMapping, MappingCandidate, MappingKind, DecisionMappings, MappingReason, ReportMapping, } from './mapping';
 export { presentationScope } from './report/public';
 export type { PresentationScope } from './report/public';
 export { TEMPLATE_UUID_WARNING_INFO } from './validate';
 export type { TemplateUuidWarning, TemplateUuidWarningCode, TemplateUuidWarningInfo, } from './validate';
+export type { IedClassification, IedClassificationBasis, IedKind } from './ied/public';
 //# sourceMappingURL=public.d.ts.map

package/dist/v2019C1/extensions/lifecycle/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/extensions/lifecycle/public.ts"],"names":[],"mappings":"AAMA,YAAY,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,GACb,MAAM,iBAAiB,CAAA;AAExB,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAEnF,YAAY,EACX,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,aAAa,GACb,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AACvD,YAAY,EACX,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,GACvB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../../src/v2019C1/extensions/lifecycle/public.ts"],"names":[],"mappings":"AAMA,YAAY,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,aAAa,GACb,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACX,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACnB,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EACX,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,aAAa,GACb,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE5D,YAAY,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,aAAa,GACb,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AACvD,YAAY,EACX,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,GACvB,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

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

@@ -1,4 +1,3 @@
 export { report } from './report';
-export { markPlacementConflicts } from './mark-placement-conflicts';
 export { presentationScope } from './presentation-scope';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/report/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/report/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/v2019C1/extensions/lifecycle/report/query/cross-cutting-satellites.d.ts

@@ -1,5 +1,8 @@
 import { Config, Scl } from '../../../../config';
 import { InstanceDiff } from '../../engine/diff.types';
+import { ResolveForeignScope } from '../../instance';
+import { ReportPass } from '../../mapping';
+import { MatchKey } from '../../scenario';
 import type * as Core from '@dialecte/core';
 /**
  * Fold the CROSS-CUTTING satellites (Variable / BehaviorDescription) that apply
@@ -19,5 +22,13 @@ export declare function foldCrossCuttingSatellites(query: Core.Query<Config>, pa
     report: InstanceDiff;
     /** INSTANTIATE: force satellite reference children to `added` (new per-instance refs). */
     refsAlwaysAdded?: boolean;
+    /** The project element the primary is placed under. */
+    anchor?: Scl.Ref<Scl.ElementsOf>;
+    /** How an instance element carries its source element's uuid. Default `templateUuid`. */
+    matchKey?: MatchKey;
+    /** What belongs to the other instances of the primary's template. */
+    resolveForeignScope?: ResolveForeignScope;
+    /** What the whole report already listed and named. */
+    pass?: ReportPass;
 }): Promise<InstanceDiff>;
 //# sourceMappingURL=cross-cutting-satellites.d.ts.map

package/dist/v2019C1/extensions/lifecycle/report/query/cross-cutting-satellites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cross-cutting-satellites.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/cross-cutting-satellites.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAA;AACpF,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC/C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACnC,kBAAkB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC5C,MAAM,EAAE,YAAY,CAAA;IACpB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB,GACC,OAAO,CAAC,YAAY,CAAC,CAiBvB"}
+{"version":3,"file":"cross-cutting-satellites.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/cross-cutting-satellites.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAA;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC/C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACnC,kBAAkB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC5C,MAAM,EAAE,YAAY,CAAA;IACpB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,uDAAuD;IACvD,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChC,yFAAyF;IACzF,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;IACzC,sDAAsD;IACtD,IAAI,CAAC,EAAE,UAAU,CAAA;CACjB,GACC,OAAO,CAAC,YAAY,CAAC,CAsBvB"}

package/dist/v2019C1/extensions/lifecycle/report/query/report-asd.d.ts

@@ -1,6 +1,7 @@
 import { Scl, Config } from '../../../../config';
 import { LifecycleScenario } from '../../contract.types';
 import { DiffReport } from '../../engine/diff.types';
+import { DecisionMappings, ReportPass } from '../../mapping';
 import type * as Core from '@dialecte/core';
 /**
  * Report (read-only) what `update.fromAsd` would change: the **application
@@ -19,5 +20,18 @@ export declare function reportAsd(query: Core.Query<Config>, params: {
     applicationRef: Scl.Ref<'Application'>;
     scenario?: LifecycleScenario;
     targetInstance?: Scl.Ref<Scl.ElementsOf>;
+    /** The consumer's choices for the shared elements the application refers to. */
+    decisionMappings?: DecisionMappings;
+    /** The project element the application is placed under. */
+    anchor?: Scl.Ref<Scl.ElementsOf>;
+    /**
+     * The application is placed by this operation alone (an ASD): started above a level the
+     * application or one of its functions was made for, each lands on the level its template says.
+     * Left out when the caller already resolved where they land (a topology scope placing its own
+     * applications).
+     */
+    resolvePlacement?: boolean;
+    /** What the whole report already listed and named. */
+    pass?: ReportPass;
 }): Promise<DiffReport>;
 //# sourceMappingURL=report-asd.d.ts.map

package/dist/v2019C1/extensions/lifecycle/report/query/report-asd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report-asd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-asd.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EACX,UAAU,EAGV,MAAM,kDAAkD,CAAA;AAEzD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAG3C;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC9B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACxC,GACC,OAAO,CAAC,UAAU,CAAC,CA4DrB"}
+{"version":3,"file":"report-asd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-asd.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EACX,UAAU,EAGV,MAAM,kDAAkD,CAAA;AAEzD,OAAO,KAAK,EACX,gBAAgB,EAEhB,UAAU,EACV,MAAM,wCAAwC,CAAA;AAE/C,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAG3C;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC9B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,sDAAsD;IACtD,IAAI,CAAC,EAAE,UAAU,CAAA;CACjB,GACC,OAAO,CAAC,UAAU,CAAC,CA2HrB"}

package/dist/v2019C1/extensions/lifecycle/report/query/report-fsd.d.ts

@@ -1,6 +1,7 @@
 import { Scl, Config } from '../../../../config';
-import { LifecycleScenario } from '../../contract.types';
+import { FsdFunctionRef, LifecycleScenario } from '../../contract.types';
 import { DiffReport } from '../../engine/diff.types';
+import { DecisionMappings, ReportPass } from '../../mapping';
 import type * as Core from '@dialecte/core';
 /**
  * Report (read-only) what `update.fromFsd` would change: a {@link DiffReport}
@@ -16,9 +17,19 @@ import type * as Core from '@dialecte/core';
  */
 export declare function reportFsd(query: Core.Query<Config>, params: {
     sourceQuery: Core.Query<Config>;
-    functionRef: Scl.Ref<'Function'>;
+    functionRef: FsdFunctionRef;
     targetParent: Scl.Ref<Scl.ElementsOf>;
     scenario?: LifecycleScenario;
     targetInstance?: Scl.Ref<Scl.ElementsOf>;
+    /** The consumer's choices for the shared elements the function is classified by. */
+    decisionMappings?: DecisionMappings;
+    /**
+     * The function is placed by this operation alone (an FSD): started above the level it was made
+     * for, it lands on the level its template says. Left out when the caller already resolved
+     * where it lands (an application or a topology scope placing its own functions).
+     */
+    resolvePlacement?: boolean;
+    /** What the whole report already listed and named. */
+    pass?: ReportPass;
 }): Promise<DiffReport>;
 //# sourceMappingURL=report-fsd.d.ts.map

package/dist/v2019C1/extensions/lifecycle/report/query/report-fsd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report-fsd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-fsd.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,kDAAkD,CAAA;AAClG,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC9B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChC,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACxC,GACC,OAAO,CAAC,UAAU,CAAC,CAiDrB"}
+{"version":3,"file":"report-fsd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-fsd.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAA;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,kDAAkD,CAAA;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAA;AAC1F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC9B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,cAAc,CAAA;IAC3B,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,sDAAsD;IACtD,IAAI,CAAC,EAAE,UAAU,CAAA;CACjB,GACC,OAAO,CAAC,UAAU,CAAC,CAoFrB"}

package/dist/v2019C1/extensions/lifecycle/report/query/report-function-satellites.d.ts

@@ -1,5 +1,9 @@
 import { Config, Scl } from '../../../../config';
+import { FsdFunctionRef } from '../../contract.types';
 import { InstanceDiff } from '../../engine/diff.types';
+import { ResolveForeignScope } from '../../instance';
+import { DecisionMappings, ReportPass } from '../../mapping';
+import { MatchKey } from '../../scenario';
 import { AnyRefOrRecord } from '@dialecte/core';
 import type * as Core from '@dialecte/core';
 /**
@@ -14,10 +18,20 @@ import type * as Core from '@dialecte/core';
  */
 export declare function foldCarriedSatellites(query: Core.Query<Config>, params: {
     sourceQuery: Core.Query<Config>;
-    functionRef: Scl.Ref<'Function'>;
+    functionRef: FsdFunctionRef;
     instance: AnyRefOrRecord | undefined;
     report: InstanceDiff;
     /** INSTANTIATE: force satellite reference children to `added` (new per-instance refs). */
     refsAlwaysAdded?: boolean;
+    /** The consumer's choices for the shared elements the function is classified by. */
+    decisionMappings?: DecisionMappings;
+    /** The project element the function is placed under. */
+    anchor?: Scl.Ref<Scl.ElementsOf>;
+    /** How an instance element carries its source element's uuid. Default `templateUuid`. */
+    matchKey?: MatchKey;
+    /** What belongs to the other instances of the function. */
+    resolveForeignScope?: ResolveForeignScope;
+    /** What the whole report already listed and named. */
+    pass?: ReportPass;
 }): Promise<InstanceDiff>;
 //# sourceMappingURL=report-function-satellites.d.ts.map

package/dist/v2019C1/extensions/lifecycle/report/query/report-function-satellites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report-function-satellites.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-function-satellites.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAA;AACpF,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,MAAM,EAAE,YAAY,CAAA;IACpB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB,GACC,OAAO,CAAC,YAAY,CAAC,CAiBvB"}
+{"version":3,"file":"report-function-satellites.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-function-satellites.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAA;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAA;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAA;AAC1F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,cAAc,CAAA;IAC3B,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,MAAM,EAAE,YAAY,CAAA;IACpB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChC,yFAAyF;IACzF,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;IACzC,sDAAsD;IACtD,IAAI,CAAC,EAAE,UAAU,CAAA;CACjB,GACC,OAAO,CAAC,YAAY,CAAC,CAyBvB"}

package/dist/v2019C1/extensions/lifecycle/report/query/report-function.d.ts

@@ -1,5 +1,7 @@
 import { Config, Scl } from '../../../../config';
+import { FsdFunctionRef } from '../../contract.types';
 import { InstanceDiff } from '../../engine/diff.types';
+import { DecisionMappings, ReportPass } from '../../mapping';
 import { MatchKey } from '../../scenario';
 import { AnyRefOrRecord } from '@dialecte/core';
 import type * as Core from '@dialecte/core';
@@ -16,11 +18,17 @@ import type * as Core from '@dialecte/core';
  */
 export declare function reportFunction(query: Core.Query<Config>, params: {
     sourceQuery: Core.Query<Config>;
-    functionRef: Scl.Ref<'Function'>;
+    functionRef: FsdFunctionRef;
     instance: AnyRefOrRecord | undefined;
     /** INSTANTIATE: force satellite reference children to `added` (new per-instance refs). */
     refsAlwaysAdded?: boolean;
     /** How the instance matches source. `templateUuid` (default) or `uuid` (fork). */
     matchKey?: MatchKey;
+    /** The consumer's choices for the shared elements the function is classified by. */
+    decisionMappings?: DecisionMappings;
+    /** The project element the function is placed under. */
+    anchor?: Scl.Ref<Scl.ElementsOf>;
+    /** What the whole report already listed and named. */
+    pass?: ReportPass;
 }): Promise<InstanceDiff>;
 //# sourceMappingURL=report-function.d.ts.map

package/dist/v2019C1/extensions/lifecycle/report/query/report-function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report-function.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-function.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAA;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CACnC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,0FAA0F;IAC1F,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB,GACC,OAAO,CAAC,YAAY,CAAC,CA+BvB"}
+{"version":3,"file":"report-function.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-function.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAA;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAA;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAA;AAC1F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CACnC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,cAAc,CAAA;IAC3B,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,0FAA0F;IAC1F,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChC,sDAAsD;IACtD,IAAI,CAAC,EAAE,UAAU,CAAA;CACjB,GACC,OAAO,CAAC,YAAY,CAAC,CAgDvB"}

package/dist/v2019C1/extensions/lifecycle/report/query/report-instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report-instance.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-instance.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAA;AACpG,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,YAAY,EAAE,YAAY,CAAA;IAC1B,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,SAAS,EAAE,cAAc,CAAA;CACzB,GACC,OAAO,CAAC,cAAc,CAAC,CA0BzB"}
+{"version":3,"file":"report-instance.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-instance.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAA;AACpG,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,YAAY,EAAE,YAAY,CAAA;IAC1B,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,SAAS,EAAE,cAAc,CAAA;CACzB,GACC,OAAO,CAAC,cAAc,CAAC,CA4BzB"}

package/dist/v2019C1/extensions/lifecycle/report/query/report-ssd.d.ts

@@ -2,6 +2,7 @@ import { Scl, Config } from '../../../../config';
 import { TopologyStructuralTag } from '../../../../constants';
 import { LifecycleScenario } from '../../contract.types';
 import { DiffReport } from '../../engine/diff.types';
+import { DecisionMappings, ReportPass } from '../../mapping';
 import type * as Core from '@dialecte/core';
 /**
  * Report (read-only) what instantiating / updating an SSD would change: the union of the
@@ -18,5 +19,9 @@ export declare function reportSsd(query: Core.Query<Config>, params: {
     targetParent: Scl.Ref<Scl.ElementsOf>;
     scenario?: LifecycleScenario;
     targetInstance?: Scl.Ref<Scl.ElementsOf>;
+    /** The consumer's choices for the shared elements the applications refer to. */
+    decisionMappings?: DecisionMappings;
+    /** What the whole report already listed and named. */
+    pass?: ReportPass;
 }): Promise<DiffReport>;
 //# sourceMappingURL=report-ssd.d.ts.map

package/dist/v2019C1/extensions/lifecycle/report/query/report-ssd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report-ssd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-ssd.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,kDAAkD,CAAA;AAClG,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC9B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,QAAQ,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IACzC,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACxC,GACC,OAAO,CAAC,UAAU,CAAC,CAuCrB"}
+{"version":3,"file":"report-ssd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-ssd.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,kDAAkD,CAAA;AAKlG,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAA;AAC1F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC9B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,QAAQ,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IACzC,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,sDAAsD;IACtD,IAAI,CAAC,EAAE,UAAU,CAAA;CACjB,GACC,OAAO,CAAC,UAAU,CAAC,CAiIrB"}

package/dist/v2019C1/extensions/lifecycle/report/query/report-topology-frame.d.ts

@@ -2,22 +2,42 @@ import { Config, Scl } from '../../../../config';
 import { TopologyStructuralTag } from '../../../../constants';
 import { LifecycleScenario } from '../../contract.types';
 import { ReportInstance } from '../../engine/diff.types';
+import { PinnedMatches } from '../../engine/match-child';
+import { InstanceLevels } from '../../layers/topology';
+import { DecisionMappings } from '../../mapping';
 import type * as Core from '@dialecte/core';
 /**
  * Report (read-only) what `update.ssd` would change in the topology scope's OWN structural content
  * (Substation/VoltageLevel/Bay attributes + BayType + equipment), matched by the stamped
- * `templateUuid` lineage. The fn/app tags are a BOUNDARY: their changes are covered by the per-primary
+ * `templateUuid` lineage — on each level an instance sits on ({@link findFrameInstances}): one
+ * created from the scope root, or one of the project the scope root was mapped onto, which only
+ * receives what the template contributes below it. The fn/app tags are a BOUNDARY: their changes are covered by the per-primary
  * Application/Function reports, so this diff excludes them.
  *
  * Several bays may share one `templateUuid` (a bay-typical instantiated more than once), so EVERY
  * matching instance is diffed and returned as its own {@link ReportInstance}; each owns its groups so
- * the decision layer can target a subset. Returns `[]` for a first-time instantiate (the frame is the
- * added fn/app primaries on the fast track) — the added scope-root group is emitted separately.
+ * the decision layer can target a subset. On a first placement the frame is reported as one added
+ * instance, or against the element of the project its root is mapped onto.
+ *
+ * On an update, where each level of the unit stands is read once per instance and serves the diff,
+ * the levels listed as held, the levels the template gained (each the consumer's choice), and is
+ * returned for the primaries the template gained (`instanceLevelsList`).
  */
 export declare function reportTopologyFrame(query: Core.Query<Config>, params: {
     sourceQuery: Core.Query<Config>;
     scopeRef: Scl.Ref<TopologyStructuralTag>;
     scenario?: LifecycleScenario;
+    /** The project holds no instance of the scope yet, or a new one was asked for. */
+    firstPlacement?: boolean;
     targetInstance?: Scl.Ref<Scl.ElementsOf>;
-}): Promise<ReportInstance[]>;
+    /** The element of the project the scope root is mapped onto, on a first placement. */
+    mappedOnto?: Scl.Ref<Scl.ElementsOf>;
+    /** Where each level below the scope root lands, on a first placement. */
+    pinnedMatches?: PinnedMatches;
+    /** The consumer's choices, among them where a level the template gained lands per instance. */
+    decisionMappings?: DecisionMappings;
+}): Promise<{
+    instances: ReportInstance[];
+    instanceLevelsList: InstanceLevels[];
+}>;
 //# sourceMappingURL=report-topology-frame.d.ts.map

package/dist/v2019C1/extensions/lifecycle/report/query/report-topology-frame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report-topology-frame.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-topology-frame.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAA;AACtF,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,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,CAAC,EAAE,iBAAiB,CAAA;IAC5B,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACxC,GACC,OAAO,CAAC,cAAc,EAAE,CAAC,CAuD3B"}
+{"version":3,"file":"report-topology-frame.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/report-topology-frame.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAA;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mDAAmD,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAA;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,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,CAAC,EAAE,iBAAiB,CAAA;IAC5B,kFAAkF;IAClF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,sFAAsF;IACtF,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACpC,yEAAyE;IACzE,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACnC,GACC,OAAO,CAAC;IAAE,SAAS,EAAE,cAAc,EAAE,CAAC;IAAC,kBAAkB,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAgFhF"}