@dialecte/scl 0.5.0 → 0.7.0

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

@@ -1,5 +1,8 @@
 import { Config, Scl } from '../../../../config';
 import { InstanceDiff } from '../../engine/diff.types';
+import { ResolveForeignScope } from '../../instance';
+import { DecisionMappings, ReportPass, ResolvedMappings } from '../../mapping';
+import { MatchKey } from '../../scenario';
 import type * as Core from '@dialecte/core';
 /**
  * Fold each satellite's changes into the primary's decision group as read-only
@@ -11,8 +14,10 @@ import type * as Core from '@dialecte/core';
  *
  * Three companion kinds, all riding the primary's group (coupling invariant - never
  * independently decidable):
- *  - added / modified: a source satellite diffed against its instance (matched by
- *    `templateUuid`); a not-yet-instantiated one surfaces all-added;
+ *  - added / modified: a source satellite diffed against the project element it lands on — for a
+ *    shared element, the one its mapping resolves to (`resolveSatelliteMappings`, the answer the
+ *    apply reads too); for any other, its instance (matched by `templateUuid`). One with nothing
+ *    to land on surfaces all-added;
  *  - removed: a TARGET instance satellite whose `templateUuid` the source no longer
  *    references -> folded as a `removed` companion so accepting the primary deletes it.
  *
@@ -29,5 +34,25 @@ export declare function foldSatelliteCompanions(query: Core.Query<Config>, param
     instanceScopeId?: string;
     /** INSTANTIATE: force satellite reference children to `added` (new per-instance refs). */
     refsAlwaysAdded?: boolean;
+    /** The consumer's choices for shared satellites, by source record id. */
+    decisionMappings?: DecisionMappings;
+    /** The project element the template is placed under. */
+    anchor?: Scl.Ref<Scl.ElementsOf>;
+    /** How an instance element carries its source element's uuid. Default `templateUuid`. */
+    matchKey?: MatchKey;
+    /** Where the shared satellites land, when the caller already resolved it. */
+    resolvedMappings?: ResolvedMappings;
+    /**
+     * The instance being updated, for the layer that owns shared satellites: what the instance
+     * gave to a project element the template no longer brings anything for is then announced.
+     */
+    instancePrimaryRef?: Scl.Ref<Scl.ElementsOf>;
+    /**
+     * What belongs to the other instances of the template the satellites are folded for: a shared
+     * satellite's references to it are theirs, not this instance's.
+     */
+    resolveForeignScope?: ResolveForeignScope;
+    /** What the whole report already listed and named, shared by every fold of that report. */
+    pass?: ReportPass;
 }): Promise<InstanceDiff>;
 //# sourceMappingURL=satellite-companions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"satellite-companions.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/satellite-companions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAA;AACpF,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAG3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,uBAAuB,CAC5C,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,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACxC,qBAAqB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACjD,MAAM,EAAE,YAAY,CAAA;IACpB,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB,GACC,OAAO,CAAC,YAAY,CAAC,CA0EvB"}
+{"version":3,"file":"satellite-companions.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/report/query/satellite-companions.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,kDAAkD,CAAA;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAClF,OAAO,KAAK,EACX,gBAAgB,EAEhB,UAAU,EAEV,gBAAgB,EAChB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAG3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,uBAAuB,CAC5C,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,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACxC,qBAAqB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACjD,MAAM,EAAE,YAAY,CAAA;IACpB,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,yEAAyE;IACzE,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,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC5C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;IACzC,2FAA2F;IAC3F,IAAI,CAAC,EAAE,UAAU,CAAA;CACjB,GACC,OAAO,CAAC,YAAY,CAAC,CAwIvB"}

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

@@ -1,5 +1,5 @@
 import { Config } from '../../../config';
-import { LifecycleTarget } from '../contract.types';
+import { LifecycleReportParams } from '../contract.types';
 import { DiffReport } from '../engine/diff.types';
 import type * as Core from '@dialecte/core';
 /**
@@ -13,5 +13,5 @@ import type * as Core from '@dialecte/core';
  * Tags each decision group with its primary's editable attributes (schema-derived)
  * so the UI renders inputs straight from the report without re-deriving them.
  */
-export declare function report(query: Core.Query<Config>, target: LifecycleTarget): Promise<DiffReport>;
+export declare function report(query: Core.Query<Config>, target: LifecycleReportParams): Promise<DiffReport>;
 //# sourceMappingURL=report.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/report/report.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAA;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAA;AAClF,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE,eAAe,GACrB,OAAO,CAAC,UAAU,CAAC,CAkCrB"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/report/report.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAA;AAC1F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAA;AAClF,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE,qBAAqB,GAC3B,OAAO,CAAC,UAAU,CAAC,CA2DrB"}

package/dist/v2019C1/extensions/lifecycle/transplant/transaction/deep.d.ts

@@ -20,7 +20,7 @@ import type * as Core from '@dialecte/core';
  * Reference rewiring is the caller's responsibility (recipes place same-domain
  * satellites by ancestry; cross-domain/lineage rewiring is plan-driven). Uuid
  * references inside the clone are repointed by the caller via `reference.applyUuidRemap`
- * over the returned `recordMappings`.
+ * over the returned `cloneMappings`.
  */
 export declare function deep(tx: Core.Transaction<Config>, params: ImportDeepParams): Promise<ImportDeepResult>;
 //# sourceMappingURL=deep.d.ts.map

package/dist/v2019C1/extensions/lifecycle/transplant/transaction/deep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/transplant/transaction/deep.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,IAAI,CACzB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAsD3B"}
+{"version":3,"file":"deep.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/transplant/transaction/deep.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,IAAI,CACzB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA+D3B"}

package/dist/v2019C1/extensions/lifecycle/transplant/transaction/deep.types.d.ts

@@ -35,7 +35,7 @@ export type ImportDeepResult = {
     record: Scl.RawRecord<Scl.ElementsOf>;
     /** source type id -> reconciled target type id, from the data-model type reconciliation. */
     typeIdRemap: Map<string, string>;
-    /** Full source-record -> target-record structural mapping for the cloned subtree. */
-    recordMappings: Scl.CloneMapping[];
+    /** Each source record and the copy made of it, for the whole cloned subtree. */
+    cloneMappings: Scl.CloneMapping[];
 };
 //# sourceMappingURL=deep.types.d.ts.map

package/dist/v2019C1/extensions/lifecycle/transplant/transaction/deep.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/transplant/transaction/deep.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AACjF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,qCAAqC;IACrC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC5B,iDAAiD;IACjD,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG;QAAE,YAAY,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAA;IAC1D,+DAA+D;IAC/D,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;IAC3B,sFAAsF;IACtF,SAAS,CAAC,EAAE,eAAe,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,4CAA4C;IAC5C,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,4FAA4F;IAC5F,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,qFAAqF;IACrF,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;CAClC,CAAA"}
+{"version":3,"file":"deep.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/transplant/transaction/deep.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AACjF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,qCAAqC;IACrC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC5B,iDAAiD;IACjD,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG;QAAE,YAAY,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAA;IAC1D,+DAA+D;IAC/D,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;IAC3B,sFAAsF;IACtF,SAAS,CAAC,EAAE,eAAe,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,4CAA4C;IAC5C,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,4FAA4F;IAC5F,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,gFAAgF;IAChF,aAAa,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;CACjC,CAAA"}

package/dist/v2019C1/extensions/lifecycle/transplant/transaction/primitives/clone-tree.d.ts

@@ -3,7 +3,8 @@ import { Scl, Config } from '../../../../../config';
 import { OmitEntry } from '@dialecte/core';
 import type * as Core from '@dialecte/core';
 /**
- * Clone pipeline: getTree -> optional retag root tagName -> strip -> deepClone.
+ * Clone pipeline: getTree -> template-only elements as what they are instantiated as -> optional
+ * retag root tagName -> strip -> deepClone.
  * UUID remapping is the caller's responsibility via `reference.applyUuidRemap` over the returned mappings.
  *
  * By default strips `templateUuid` and `originUuid` from the entire tree.

package/dist/v2019C1/extensions/lifecycle/transplant/transaction/primitives/clone-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clone-tree.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/lifecycle/transplant/transaction/primitives/clone-tree.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAO/C;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC9B,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC5B,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1B,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;CAC3B,GACC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,CA2B/E"}
+{"version":3,"file":"clone-tree.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/lifecycle/transplant/transaction/primitives/clone-tree.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAO/C;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC9B,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC5B,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1B,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;CAC3B,GACC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,CAmC/E"}

package/dist/v2019C1/extensions/lifecycle/transplant/transaction/primitives/merge-children-into.d.ts

@@ -1,4 +1,5 @@
 import { StripConfig } from './clone-tree.types';
+import { MergeChildrenResult } from './merge-children-into.types';
 import { Config, Scl } from '../../../../../config';
 import { OmitEntry } from '@dialecte/core';
 import type * as Core from '@dialecte/core';
@@ -8,12 +9,19 @@ import type * as Core from '@dialecte/core';
  *
  * Generic, element-agnostic counterpart of {@link addChildrenTo}: where `addChildrenTo` pours every
  * source child in as a fresh clone, this walks name-keyed containers (e.g. `FunctionCategory` ->
- * `SubCategory`) and, when a same-tag/same-name child already exists under the target, recurses into
- * it - so only the genuinely new leaves (references, unnamed content) are cloned. A source child with
- * no `name`, or with no matching twin, is cloned whole.
+ * `SubCategory`) and, when the target already holds the twin of a source child, recurses into it -
+ * so only the genuinely new leaves (references, unnamed content) are cloned. The twin is the
+ * same-tag child created from that source child (it carries its uuid as `templateUuid`, whatever
+ * it is named now), else the same-tag child of the same name - the rule the lifecycle matcher
+ * (`matchChild`) applies inside an element the source is mapped onto, so the report and the write
+ * pair containers alike. A source child with no twin is cloned whole.
  *
  * `omit` (tag names) drops matching source children from the merge AND from the clones of new leaves,
  * so a caller can merge an element's own content while leaving delegated children to another pass.
+ * `leftOut` names the new children the consumer left out: they are not cloned.
+ *
+ * Returns the clone mappings of what was cloned, and a redirect mapping for every source container
+ * that landed on a twin: a reference to that source container is a reference to its twin.
  */
 export declare function mergeChildrenInto(tx: Core.Transaction<Config>, params: {
     sourceQuery: Core.Query<Config>;
@@ -23,5 +31,7 @@ export declare function mergeChildrenInto(tx: Core.Transaction<Config>, params:
     target: Scl.Ref<Scl.ElementsOf>;
     strip?: StripConfig | false;
     omit?: OmitEntry<Config>[];
-}): Promise<Scl.CloneMapping[]>;
+    /** The source elements the consumer left out (record ids): such a child is not cloned. */
+    leftOut?: ReadonlySet<string>;
+}): Promise<MergeChildrenResult>;
 //# sourceMappingURL=merge-children-into.d.ts.map

package/dist/v2019C1/extensions/lifecycle/transplant/transaction/primitives/merge-children-into.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-children-into.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/lifecycle/transplant/transaction/primitives/merge-children-into.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACtC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,yDAAyD;IACzD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,iEAAiE;IACjE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;CAC1B,GACC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CA2C7B"}
+{"version":3,"file":"merge-children-into.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/lifecycle/transplant/transaction/primitives/merge-children-into.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CACtC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,yDAAyD;IACzD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,iEAAiE;IACjE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC7B,GACC,OAAO,CAAC,mBAAmB,CAAC,CAkD9B"}

package/dist/v2019C1/extensions/lifecycle/transplant/transaction/primitives/merge-children-into.types.d.ts

@@ -0,0 +1,9 @@
+import { Scl } from '../../../../../config';
+import { RedirectMapping } from '../../../../reference/transaction/apply-uuid-remap.types';
+export type MergeChildrenResult = {
+    /** Each source record that was cloned and the copy made of it. */
+    cloneMappings: Scl.CloneMapping[];
+    /** The source containers that landed on a container the target already holds. */
+    redirectMappings: RedirectMapping[];
+};
+//# sourceMappingURL=merge-children-into.types.d.ts.map

package/dist/v2019C1/extensions/lifecycle/transplant/transaction/primitives/merge-children-into.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-children-into.types.d.ts","sourceRoot":"","sources":["../../../../../../../src/v2019C1/extensions/lifecycle/transplant/transaction/primitives/merge-children-into.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mEAAmE,CAAA;AAExG,MAAM,MAAM,mBAAmB,GAAG;IACjC,kEAAkE;IAClE,aAAa,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;IACjC,iFAAiF;IACjF,gBAAgB,EAAE,eAAe,EAAE,CAAA;CACnC,CAAA"}

package/dist/v2019C1/extensions/lifecycle/update/transaction/asd.d.ts

@@ -2,6 +2,7 @@ import { Scl, Config } from '../../../../config';
 import { KeepNameTypesFrom } from '../../../data-model/transaction';
 import { LifecycleScenario } from '../../contract.types';
 import { DecisionMap, DiffReport } from '../../engine/diff.types';
+import { DecisionMappings } from '../../mapping';
 import type * as Core from '@dialecte/core';
 /**
  * `update.fromAsd` — reconcile a project against a (possibly newer) ASD.
@@ -16,9 +17,9 @@ import type * as Core from '@dialecte/core';
  *     refs, attributes);
  *  2. function-layer cascade — treat every composed Function the ASD
  *     references as an FSD to update and delegate to `update.fromFsd`
- *     (instantiate-or-reconcile), which fans out per composed-function instance.
- *     Verbs compose verbs: a function added by the newer ASD is instantiated, an
- *     existing one is reconciled.
+ *     (instantiate-or-reconcile), per instance of the application
+ *     ({@link cascadeComposedFunctions}). Verbs compose verbs: a function added by
+ *     the newer ASD is instantiated for each instance, an existing one is reconciled.
  *
  * `report` + `decisions` gate every write: each Application instance is gated by
  * ONLY its own groups (partitioned by `instanceScopeId`) so the user can update a
@@ -36,6 +37,18 @@ export declare function asd(tx: Core.Transaction<Config>, params: {
     keepNameTypesFrom?: KeepNameTypesFrom;
     /** Multi-instance anchor: scope to ONE target instance (or its subtree). Absent = all. */
     targetInstance?: Scl.Ref<Scl.ElementsOf>;
+    /** The consumer's choices for the shared elements the application refers to. */
+    decisionMappings?: DecisionMappings;
+    /** The application is placed by this operation alone (an ASD): see `instantiate.asd`. */
+    resolvePlacement?: boolean;
+    /** Placed as part of a larger template: see `instantiate.asd`. */
+    partOfTemplate?: boolean;
+    /**
+     * What a first placement is made for, when the report lists it once per instance of the unit
+     * of a larger template: that instance (the level it sits on) — the same before and after the
+     * write. Default: `targetParent`.
+     */
+    placedFor?: Scl.Ref<Scl.ElementsOf>;
 }): Promise<{
     applications: Scl.Ref<'Application'>[];
     functions: (Scl.Ref<'Function'> | Scl.Ref<'SubFunction'>)[];

package/dist/v2019C1/extensions/lifecycle/update/transaction/asd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/asd.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAA;AAC/F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,GAAG,CACxB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,0FAA0F;IAC1F,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACxC,GACC,OAAO,CAAC;IACV,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAA;IACtC,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAA;CAC3D,CAAC,CA2ID"}
+{"version":3,"file":"asd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/asd.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAA;AAE/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,GAAG,CACxB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,0FAA0F;IAC1F,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,yFAAyF;IACzF,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,kEAAkE;IAClE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACnC,GACC,OAAO,CAAC;IACV,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAA;IACtC,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAA;CAC3D,CAAC,CAmOD"}

package/dist/v2019C1/extensions/lifecycle/update/transaction/cascade-composed-functions.d.ts

@@ -0,0 +1,22 @@
+import { CascadeComposedFunctionsParams, ComposedFunctionsCascade } from './cascade-composed-functions.types';
+import { Config } from '../../../../config';
+import type * as Core from '@dialecte/core';
+/**
+ * Function-layer cascade of an application update: every function the template composes is
+ * reconciled where the project holds it, and placed where it does not.
+ *
+ * Several instances of the application may exist, each with its own functions, each in its own
+ * bay. A function is therefore handled per instance:
+ *  - the functions an instance refers to are its own: each is reconciled where it sits;
+ *  - a function the template gained is new to every instance: each instance the update writes to
+ *    gets its own, on the level that instance lives on — in the bay of its other functions, not
+ *    under the element the update was started from. A function of that lineage already there that
+ *    belongs to no instance is taken instead of a new one; with several, the consumer chose;
+ *  - a function that belongs to no instance is reconciled when it sits where the consumer started.
+ *
+ * What stands for each function, per instance, is {@link resolveComposedFunctions}: the answer the
+ * report announced. The references an instance gained to such a function are repointed by the
+ * caller, from the redirect mappings returned for that instance.
+ */
+export declare function cascadeComposedFunctions(tx: Core.Transaction<Config>, params: CascadeComposedFunctionsParams): Promise<ComposedFunctionsCascade>;
+//# sourceMappingURL=cascade-composed-functions.d.ts.map

package/dist/v2019C1/extensions/lifecycle/update/transaction/cascade-composed-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-composed-functions.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/cascade-composed-functions.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACX,8BAA8B,EAC9B,wBAAwB,EACxB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAO,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAG3C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,wBAAwB,CAC7C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE,8BAA8B,GACpC,OAAO,CAAC,wBAAwB,CAAC,CA2EnC"}

package/dist/v2019C1/extensions/lifecycle/update/transaction/cascade-composed-functions.types.d.ts

@@ -0,0 +1,38 @@
+import { Config, Scl } from '../../../../config';
+import { KeepNameTypesFrom } from '../../../data-model/transaction';
+import { LifecycleScenario } from '../../contract.types';
+import { DecisionMap, DiffReport } from '../../engine/diff.types';
+import { DecisionMappings } from '../../mapping';
+import { RedirectMapping } from '../../../reference/transaction/apply-uuid-remap.types';
+import { AnyTrackedRecord } from '@dialecte/core';
+import type * as Core from '@dialecte/core';
+/** One instance of the application the update goes through. */
+export type ApplicationInstance = {
+    instance: AnyTrackedRecord;
+    /** The update wrote to it: an instance whose every group was skipped is left as it is. */
+    written: boolean;
+};
+export type CascadeComposedFunctionsParams = {
+    sourceQuery: Core.Query<Config>;
+    applicationRef: Scl.Ref<'Application'>;
+    /** The element of the project the consumer started from. */
+    targetParent: Scl.Ref<Scl.ElementsOf>;
+    /** The instances of the application, each with the functions it composes. */
+    applicationInstances: readonly ApplicationInstance[];
+    scenario?: LifecycleScenario;
+    report?: DiffReport;
+    decisions?: DecisionMap;
+    keepNameTypesFrom?: KeepNameTypesFrom;
+    targetInstance?: Scl.Ref<Scl.ElementsOf>;
+    decisionMappings?: DecisionMappings;
+};
+export type ComposedFunctionsCascade = {
+    /** The functions reconciled or placed. */
+    functions: (Scl.Ref<'Function'> | Scl.Ref<'SubFunction'>)[];
+    /**
+     * For each instance of the application, by its record id: the function that stands, for that
+     * instance, for a function the template gained.
+     */
+    redirectMappings: Map<string, RedirectMapping[]>;
+};
+//# sourceMappingURL=cascade-composed-functions.types.d.ts.map

package/dist/v2019C1/extensions/lifecycle/update/transaction/cascade-composed-functions.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-composed-functions.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/cascade-composed-functions.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAA;AAC/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mEAAmE,CAAA;AACxG,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,0FAA0F;IAC1F,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC5C,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,4DAA4D;IAC5D,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,6EAA6E;IAC7E,oBAAoB,EAAE,SAAS,mBAAmB,EAAE,CAAA;IACpD,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACtC,0CAA0C;IAC1C,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAA;IAC3D;;;OAGG;IACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;CAChD,CAAA"}

package/dist/v2019C1/extensions/lifecycle/update/transaction/cross-cutting-satellites.d.ts

@@ -1,9 +1,10 @@
+import { ReconcileCrossCuttingSatellitesResult } from './cross-cutting-satellites.types';
 import { Config, Scl } from '../../../../config';
 import { IdentityMode } from '../../../identity/transaction/write-identity.types';
 import { AcceptedIds } from '../../engine/decide.types';
+import { ResolveForeignScope } from '../../instance';
 import { MatchKey } from '../../scenario';
 import { TargetStructure } from '../../transplant/transaction';
-import { AnyRefOrRecord } from '@dialecte/core';
 import type * as Core from '@dialecte/core';
 /**
  * Carry the CROSS-CUTTING satellites (Variable / BehaviorDescription) that apply
@@ -12,9 +13,14 @@ import type * as Core from '@dialecte/core';
  * `primaryRef` (function, application, and future IED / topology) so the 3-way
  * add / reconcile-in-place / delete is uniform and impossible to forget.
  *
- * `instancePrimaryRef` is the target-side primary (for removal detection); pass it
- * when an instance exists. Layer-owned satellites (FunctionCategory, AllocationRole)
- * are reconciled separately by their own layer finder.
+ * These are SHARED elements: where each source one lands for this instance is resolved first
+ * (`resolveSatelliteMappings`, the answer the report read too) — the one the instance already
+ * holds, by lineage or because it was mapped onto an element of the project, else the element its
+ * mapping resolves to. What the instance gave to a project element the template no longer brings
+ * anything for is removed with the removal the report announced.
+ *
+ * `instancePrimaryRef` is the target-side primary; pass it when an instance exists. Layer-owned
+ * satellites (FunctionCategory, AllocationRole) are reconciled separately by their own layer finder.
  */
 export declare function reconcileCrossCuttingSatellites(tx: Core.Transaction<Config>, params: {
     sourceQuery: Core.Query<Config>;
@@ -24,5 +30,7 @@ export declare function reconcileCrossCuttingSatellites(tx: Core.Transaction<Con
     accepted?: AcceptedIds;
     matchKey?: MatchKey;
     identityMode?: IdentityMode;
-}): Promise<Map<string, AnyRefOrRecord>>;
+    /** What belongs to the other instances of the primary's template. */
+    resolveForeignScope?: ResolveForeignScope;
+}): Promise<ReconcileCrossCuttingSatellitesResult>;
 //# sourceMappingURL=cross-cutting-satellites.d.ts.map

package/dist/v2019C1/extensions/lifecycle/update/transaction/cross-cutting-satellites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cross-cutting-satellites.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/cross-cutting-satellites.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAA;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAA;AACrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;;GAUG;AACH,wBAAsB,+BAA+B,CACpD,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,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,SAAS,EAAE,eAAe,CAAA;IAC1B,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,YAAY,CAAC,EAAE,YAAY,CAAA;CAC3B,GACC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAyBtC"}
+{"version":3,"file":"cross-cutting-satellites.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/cross-cutting-satellites.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,kCAAkC,CAAA;AAC7F,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAA;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAA;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,+BAA+B,CACpD,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,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,SAAS,EAAE,eAAe,CAAA;IAC1B,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;CACzC,GACC,OAAO,CAAC,qCAAqC,CAAC,CAwDhD"}

package/dist/v2019C1/extensions/lifecycle/update/transaction/cross-cutting-satellites.types.d.ts

@@ -0,0 +1,9 @@
+import { Scl } from '../../../../config';
+import { RedirectMapping } from '../../../reference/transaction/apply-uuid-remap.types';
+export type ReconcileCrossCuttingSatellitesResult = {
+    /** Each source record the reconcile added and the copy made of it. */
+    cloneMappings: Scl.CloneMapping[];
+    /** The source satellites that stand for an element the project already holds. */
+    redirectMappings: RedirectMapping[];
+};
+//# sourceMappingURL=cross-cutting-satellites.types.d.ts.map

package/dist/v2019C1/extensions/lifecycle/update/transaction/cross-cutting-satellites.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-cutting-satellites.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/cross-cutting-satellites.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mEAAmE,CAAA;AAExG,MAAM,MAAM,qCAAqC,GAAG;IACnD,sEAAsE;IACtE,aAAa,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;IACjC,iFAAiF;IACjF,gBAAgB,EAAE,eAAe,EAAE,CAAA;CACnC,CAAA"}

package/dist/v2019C1/extensions/lifecycle/update/transaction/fsd.d.ts

@@ -1,7 +1,8 @@
 import { Scl, Config } from '../../../../config';
 import { KeepNameTypesFrom } from '../../../data-model/transaction';
-import { LifecycleScenario } from '../../contract.types';
+import { FsdFunctionRef, LifecycleScenario } from '../../contract.types';
 import { DecisionMap, DiffReport } from '../../engine/diff.types';
+import { DecisionMappings } from '../../mapping';
 import type * as Core from '@dialecte/core';
 /**
  * `update.fromFsd` — reconcile a project against a (possibly newer) FSD.
@@ -18,7 +19,7 @@ import type * as Core from '@dialecte/core';
  */
 export declare function fsd(tx: Core.Transaction<Config>, params: {
     sourceQuery: Core.Query<Config>;
-    functionRef: Scl.Ref<'Function'>;
+    functionRef: FsdFunctionRef;
     targetParent: Scl.Ref<Scl.ElementsOf>;
     /** `instantiate` forces a fresh instance; `template` (default) reconciles. */
     scenario?: LifecycleScenario;
@@ -29,5 +30,17 @@ export declare function fsd(tx: Core.Transaction<Config>, params: {
     keepNameTypesFrom?: KeepNameTypesFrom;
     /** Multi-instance anchor: scope to ONE target instance (or its subtree). Absent = all. */
     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): see `instantiate.fsd`. */
+    resolvePlacement?: boolean;
+    /** Placed as part of a larger template: see `instantiate.fsd`. */
+    partOfTemplate?: boolean;
+    /**
+     * What a first placement is made for, when the report lists it once per instance: the instance
+     * of the application that gained it, or the instance of the unit of a larger template (the
+     * level it sits on) — the same before and after the write. Default: `targetParent`.
+     */
+    placedFor?: Scl.Ref<Scl.ElementsOf>;
 }): Promise<(Scl.Ref<'Function'> | Scl.Ref<'SubFunction'>)[]>;
 //# sourceMappingURL=fsd.d.ts.map

package/dist/v2019C1/extensions/lifecycle/update/transaction/fsd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fsd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/fsd.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AAKtF,OAAO,KAAK,EAEX,WAAW,EACX,UAAU,EACV,MAAM,kDAAkD,CAAA;AACzD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;GAYG;AACH,wBAAsB,GAAG,CACxB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,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,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,0FAA0F;IAC1F,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACxC,GACC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CA+F3D"}
+{"version":3,"file":"fsd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/fsd.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAA;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AAKtF,OAAO,KAAK,EAEX,WAAW,EACX,UAAU,EACV,MAAM,kDAAkD,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;GAYG;AACH,wBAAsB,GAAG,CACxB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,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,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,0FAA0F;IAC1F,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,kEAAkE;IAClE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACnC,GACC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CA2H3D"}

package/dist/v2019C1/extensions/lifecycle/update/transaction/function-satellites.d.ts

@@ -1,33 +1,30 @@
 import { Config, Scl } from '../../../../config';
 import { IdentityMode } from '../../../identity/transaction/write-identity.types';
+import { FsdFunctionRef } from '../../contract.types';
 import { AcceptedIds } from '../../engine/decide.types';
+import { ResolveForeignScope } from '../../instance';
+import { DecisionMappings } from '../../mapping';
 import { MatchKey } from '../../scenario';
 import { AnyRefOrRecord } from '@dialecte/core';
 import type * as Core from '@dialecte/core';
 /**
- * Reconcile each carried satellite (e.g. a `FunctionCategory`) of a function ONTO
- * its existing instance, gated by `accepted`. The satellite lives
- * OUTSIDE the function subtree, so the function reconcile never reaches it; here
- * it is matched globally by `templateUuid` and reconciled in place. The write is
- * gated exactly like the function's: `reconcile` only touches records whose source
- * id is in `accepted`, so the satellite travels iff its function group is accepted
- * (its report companion contributed that id).
+ * Reconcile the satellites carried by a function (its `FunctionCategory` classification) for one
+ * instance of it, gated by `accepted`. They live OUTSIDE the function subtree, so the function
+ * reconcile never reaches them.
  *
- * A satellite the updated template ADDS (no instance yet — a newly-classified
- * function) is added via the clone path (`cloneFunctionCategories` +
- * `writeIdentity`, mirroring `instantiate.fsd`), gated by the function group's
- * acceptance.
+ * The function layer finds its satellites on both sides — in the source, and those the instance is
+ * classified by — and resolves where each source one lands (`resolveSatelliteMappings`, the answer
+ * the report read too). The generic satellite reconcile then does the rest: reconcile in place
+ * (only the contributed children when the category is the project's own), add a category the
+ * updated template newly classifies the function by, delete one the template retired (guarded by
+ * a last-referrer check, so a category still classifying another function is kept).
  *
- * A satellite the template RETIRED (its element no longer in the source, matched
- * against the `instance`'s satellites) is DELETED — the coupling invariant: it
- * rides the function group (gated by `accepted.instanceIds`), guarded by a
- * whole-target-doc last-referrer check so a category still referenced by ANOTHER
- * function is kept (shared-satellite safety). Catalog persistence:
- * the trigger is source-element non-existence, NOT a dropped link.
+ * What the instance gave to a project category the template no longer classifies it by is removed
+ * with the removal the report announced.
  */
 export declare function reconcileCarriedSatellites(tx: Core.Transaction<Config>, params: {
     sourceQuery: Core.Query<Config>;
-    functionRef: Scl.Ref<'Function'>;
+    functionRef: FsdFunctionRef;
     instanceRef: AnyRefOrRecord;
     targetParent: Scl.Ref<Scl.ElementsOf>;
     accepted?: AcceptedIds;
@@ -35,5 +32,9 @@ export declare function reconcileCarriedSatellites(tx: Core.Transaction<Config>,
     matchKey?: MatchKey;
     /** `stamp-template` (default) or `keep` (fork) identity for an added satellite. */
     identityMode?: IdentityMode;
-}): Promise<Map<string, AnyRefOrRecord>>;
+    /** The consumer's choices for the shared elements the function is classified by. */
+    decisionMappings?: DecisionMappings;
+    /** What belongs to the other instances of the function. */
+    resolveForeignScope?: ResolveForeignScope;
+}): Promise<Scl.CloneMapping[]>;
 //# sourceMappingURL=function-satellites.d.ts.map

package/dist/v2019C1/extensions/lifecycle/update/transaction/function-satellites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"function-satellites.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/function-satellites.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAA;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAA;AACrF,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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,0BAA0B,CAC/C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAChC,WAAW,EAAE,cAAc,CAAA;IAC3B,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,mFAAmF;IACnF,YAAY,CAAC,EAAE,YAAY,CAAA;CAC3B,GACC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAoFtC"}
+{"version":3,"file":"function-satellites.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/function-satellites.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAA;AAClG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAA;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAA;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAClF,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;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,0BAA0B,CAC/C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,cAAc,CAAA;IAC3B,WAAW,EAAE,cAAc,CAAA;IAC3B,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,mFAAmF;IACnF,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;CACzC,GACC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CA6D7B"}

package/dist/v2019C1/extensions/lifecycle/update/transaction/satellite-reconcile.d.ts

@@ -1,18 +1,22 @@
 import { Config, Scl } from '../../../../config';
 import { IdentityMode } from '../../../identity/transaction/write-identity.types';
 import { AcceptedIds } from '../../engine/decide.types';
+import { ResolveForeignScope } from '../../instance';
+import { DecisionMappings, ResolvedMappings } from '../../mapping';
 import { MatchKey } from '../../scenario';
 import { TargetStructure } from '../../transplant/transaction';
-import { AnyRefOrRecord } from '@dialecte/core';
 import type * as Core from '@dialecte/core';
 /**
  * Reconcile each satellite against the target, gated by `accepted`. Generic over
  * the layer: the caller resolves the SOURCE satellite refs and, for removal
  * detection, the TARGET instance refs (`instanceSatelliteRefs`, resolved with the
  * same finder against the instance primary BEFORE the primary reconcile runs, since
- * that reconcile may drop the referring ref). Three cases, matched by `templateUuid`:
- *  - an EXISTING instance -> reconcile-in-place (`engine.reconcile`);
- *  - NO instance yet -> ADD it (clone at source structural level + stamp lineage),
+ * that reconcile may drop the referring ref). A shared element lands where its mapping resolved
+ * (`resolvedMappings`, the answer the report read too); any other satellite is matched by
+ * `templateUuid`. Three cases:
+ *  - an EXISTING element -> reconcile-in-place (`engine.reconcile`); when it is the project's
+ *    own (a shared element mapped onto it), only what the source contributes below it;
+ *  - NOTHING yet -> ADD it (clone at source structural level + stamp lineage),
  *    so a newly-referenced satellite travels on update, not only first-time instantiate;
  *  - a TARGET instance the source no longer references -> DELETE it (the coupling
  *    invariant: it rides the primary group), guarded by a whole-target-doc
@@ -32,5 +36,14 @@ export declare function reconcileSatellites(tx: Core.Transaction<Config>, params
     matchKey?: MatchKey;
     /** `stamp-template` (default) or `keep` (fork) identity for an added satellite. */
     identityMode?: IdentityMode;
-}): Promise<Map<string, AnyRefOrRecord>>;
+    /** Where the shared satellites land, by source record id. */
+    resolvedMappings?: ResolvedMappings;
+    /** The consumer's choices for the shared satellites, by source record id. */
+    decisionMappings?: DecisionMappings;
+    /**
+     * What belongs to the other instances of the template the satellites are reconciled for: a
+     * shared satellite's references to it are theirs, not this instance's.
+     */
+    resolveForeignScope?: ResolveForeignScope;
+}): Promise<Scl.CloneMapping[]>;
 //# sourceMappingURL=satellite-reconcile.d.ts.map

package/dist/v2019C1/extensions/lifecycle/update/transaction/satellite-reconcile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"satellite-reconcile.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/satellite-reconcile.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAA;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAA;AACrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACxC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACxC,qBAAqB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACjD,SAAS,EAAE,eAAe,CAAA;IAC1B,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,mFAAmF;IACnF,YAAY,CAAC,EAAE,YAAY,CAAA;CAC3B,GACC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAiFtC"}
+{"version":3,"file":"satellite-reconcile.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/satellite-reconcile.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAA;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAA;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CACxC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACxC,qBAAqB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACjD,SAAS,EAAE,eAAe,CAAA;IAC1B,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,mFAAmF;IACnF,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;CACzC,GACC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CA6G7B"}

package/dist/v2019C1/extensions/lifecycle/update/transaction/ssd.d.ts

@@ -3,6 +3,7 @@ import { TopologyStructuralTag } from '../../../../constants';
 import { KeepNameTypesFrom } from '../../../data-model/transaction';
 import { LifecycleScenario } from '../../contract.types';
 import { DecisionMap, DiffReport } from '../../engine/diff.types';
+import { DecisionMappings } from '../../mapping';
 import type * as Core from '@dialecte/core';
 type UpdateSsdResult = {
     applications: Scl.Ref<'Application'>[];
@@ -31,6 +32,8 @@ export declare function ssd(tx: Core.Transaction<Config>, params: {
     keepNameTypesFrom?: KeepNameTypesFrom;
     /** Multi-instance anchor: scope to ONE placed Bay (frame + fn/app under it). Absent = all. */
     targetInstance?: Scl.Ref<Scl.ElementsOf>;
+    /** The consumer's choices for the shared elements the applications refer to. */
+    decisionMappings?: DecisionMappings;
 }): Promise<UpdateSsdResult>;
 export {};
 //# sourceMappingURL=ssd.d.ts.map

package/dist/v2019C1/extensions/lifecycle/update/transaction/ssd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/ssd.ts"],"names":[],"mappings":"AAqBA,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,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAA;AAE/F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,KAAK,eAAe,GAAG;IACtB,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAA;IACtC,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAA;CAC3D,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,GAAG,CACxB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,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,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,8FAA8F;IAC9F,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;CACxC,GACC,OAAO,CAAC,eAAe,CAAC,CA2F1B"}
+{"version":3,"file":"ssd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/update/transaction/ssd.ts"],"names":[],"mappings":"AAuBA,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,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAA;AAC/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,KAAK,eAAe,GAAG;IACtB,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAA;IACtC,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAA;CAC3D,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,GAAG,CACxB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,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,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,8FAA8F;IAC9F,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACxC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACnC,GACC,OAAO,CAAC,eAAe,CAAC,CAyI1B"}

package/dist/v2019C1/extensions/lifecycle/validate/template-uuid-check.info.d.ts

@@ -4,7 +4,8 @@ import { TemplateUuidWarningCode, TemplateUuidWarningInfo } from './template-uui
  * consumer UI renders (title / description / fallback) so the explanation never drifts from the
  * checker. The per-occurrence specifics come from each warning's `message`; this map explains the
  * violation CLASS and the recovery strategy the lifecycle engine applies when the identity is
- * unreliable.
+ * unreliable — stated as what the engine does, not as what a consumer should show or do: that
+ * wording is the consumer's, keyed by the code.
  */
 export declare const TEMPLATE_UUID_WARNING_INFO: Record<TemplateUuidWarningCode, TemplateUuidWarningInfo>;
 //# sourceMappingURL=template-uuid-check.info.d.ts.map