@dialecte/scl 0.3.15 → 0.3.17

package/dist/v2019C1/extensions/lifecycle/engine/match-child.d.ts

@@ -0,0 +1,31 @@
+import { Config } from '../../../config';
+import { AnyTreeRecord } from '@dialecte/core';
+import type * as Core from '@dialecte/core';
+/** A read surface shared by the diff (Query) and reconcile (Transaction) sides. */
+type Reader = Core.Query<Config> | Core.Transaction<Config>;
+/**
+ * Find the instance child that corresponds to a source child — the ONE matcher shared by the diff
+ * (report) and reconcile (apply) sides, so both pair children identically:
+ *  - **Identified** elements match by `templateUuid` lineage (the source `uuid`) via `index`, guarded
+ *    to the same tag: a placeholder `templateUuid` smeared across unrelated tags (real .ssd files
+ *    reuse one dummy value on Substation, LNode, ...) can coincide with a source `uuid`; a cross-type
+ *    hit is a collision, not a lineage.
+ *  - A uuid-less **REFERENCE** (e.g. `FunctionRef`) matches by its reference IDENTITY — the target
+ *    `*Uuid` it points to, mapped back to template space — never by tag position; with a name-space
+ *    fallback for projects authored with placeholder `templateUuid`s. `refsAlwaysAdded` forces a fresh
+ *    instantiation's refs to surface as `added` instead of matching a prior instance's ref.
+ *  - Any other uuid-less element (e.g. `FunctionRoleContent`) matches a same-tag sibling by position.
+ *
+ * The source side reads raw identities; the candidate (target) side is normalized to template space —
+ * that role split is internal here, so callers never pass a space/`mapToTemplate` flag.
+ */
+export declare function matchChild(sourceQuery: Reader, params: {
+    targetQuery: Reader;
+    sourceChild: AnyTreeRecord;
+    instanceParent: AnyTreeRecord;
+    index: Map<string, AnyTreeRecord>;
+    matchedInstanceIds: ReadonlySet<string>;
+    refsAlwaysAdded?: boolean;
+}): Promise<AnyTreeRecord | undefined>;
+export {};
+//# sourceMappingURL=match-child.d.ts.map

package/dist/v2019C1/extensions/lifecycle/engine/match-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-child.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/engine/match-child.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,mFAAmF;AACnF,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACP,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,aAAa,CAAA;IAC1B,cAAc,EAAE,aAAa,CAAA;IAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACjC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACvC,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB,GACC,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CA+CpC"}

package/dist/v2019C1/extensions/lifecycle/engine/match-key.d.ts

@@ -0,0 +1,26 @@
+import { Config } from '../../../config';
+import { MatchKey } from '../scenario';
+import { AnyTreeRecord } from '@dialecte/core';
+import type * as Core from '@dialecte/core';
+/** A read surface shared by the diff (Query) and reconcile (Transaction) sides. */
+type Reader = Core.Query<Config> | Core.Transaction<Config>;
+/**
+ * Index an instance subtree by its `matchKey` attribute (`templateUuid`, or `uuid` for fork), so a
+ * source element's `uuid` can find its instance in O(1) by lineage. Shared verbatim by the diff
+ * (report) and reconcile (apply) sides so both derive the same key → element map.
+ */
+export declare function indexByMatchKey(reader: Reader, params: {
+    node: AnyTreeRecord;
+    index: Map<string, AnyTreeRecord>;
+    matchKey: MatchKey;
+}): Promise<void>;
+/**
+ * Collect every `uuid` in a source subtree — the set of template lineages that still exist, used to
+ * decide which instance elements were removed from the template. Shared by both engine sides.
+ */
+export declare function collectUuids(reader: Reader, params: {
+    node: AnyTreeRecord;
+    out: Set<string>;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=match-key.d.ts.map

package/dist/v2019C1/extensions/lifecycle/engine/match-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-key.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/engine/match-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,mFAAmF;AACnF,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AAE3D;;;;GAIG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACpF,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GAC/C,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/v2019C1/extensions/lifecycle/engine/reconcile.d.ts

@@ -6,7 +6,7 @@ import { MatchKey } from '../scenario';
 import { AnyRefOrRecord } from '@dialecte/core';
 import type * as Core from '@dialecte/core';
 /**
- * Engine apply-core (ENGINE.md §3/§8): reconcile an updated template subtree
+ * Engine apply-core: reconcile an updated template subtree
  * (`sourceRootRef`) ONTO an existing instance (`instanceRootRef`) instead of
  * duplicating it. Elements match by `templateUuid` (= the source element's
  * `uuid`, immutable across template versions):
@@ -42,5 +42,11 @@ export declare function reconcile(tx: Core.Transaction<Config>, params: {
     matchKey?: MatchKey;
     /** Identity write mode for added elements. `stamp-template` (default) or `keep` (fork). */
     identityMode?: IdentityMode;
-}): Promise<void>;
+    /**
+     * Child tags to treat as BOUNDARIES: their subtrees are left untouched (not reconciled,
+     * added, or deleted) because another pass owns them (e.g. the topology frame reconcile
+     * delegates Application/Function to the fn/app cascade).
+     */
+    omit?: readonly string[];
+}): Promise<Map<string, AnyRefOrRecord>>;
 //# sourceMappingURL=reconcile.d.ts.map

package/dist/v2019C1/extensions/lifecycle/engine/reconcile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/engine/reconcile.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAA;AAClG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAA;AAEnE;;;;;;;;;;;;;;;;GAgBG;AAEH,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,aAAa,EAAE,cAAc,CAAA;IAC7B,eAAe,EAAE,cAAc,CAAA;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,2FAA2F;IAC3F,YAAY,CAAC,EAAE,YAAY,CAAA;CAC3B,GACC,OAAO,CAAC,IAAI,CAAC,CA4Cf"}
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/engine/reconcile.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAA;AAClG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAA;AAEnE;;;;;;;;;;;;;;;;GAgBG;AAEH,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,aAAa,EAAE,cAAc,CAAA;IAC7B,eAAe,EAAE,cAAc,CAAA;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,2FAA2F;IAC3F,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACxB,GACC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAsDtC"}

package/dist/v2019C1/extensions/lifecycle/engine/reference-match.d.ts

@@ -0,0 +1,25 @@
+import { Config } from '../../../config';
+import { AnyTreeRecord } from '@dialecte/core';
+import type * as Core from '@dialecte/core';
+/** A read surface shared by the diff (Query) and reconcile (Transaction) sides. */
+type Reader = Core.Query<Config> | Core.Transaction<Config>;
+/**
+ * The reference identity of a link element: the set of target `*Uuid` attributes it carries, as a
+ * stable string. When `mapToTemplate` is set (the INSTANCE/target side), each target uuid is resolved
+ * to its element's `templateUuid` so an instantiated (remapped) reference compares equal to the
+ * template reference it came from. The SOURCE side passes the raw uuids, which are already template
+ * space. Returns `undefined` when no uuid attribute is set (unresolved ref), so matching falls back to
+ * position. Lineage-aware by design — this is a matching helper, not an agnostic identity read.
+ */
+export declare function referenceIdentity(query: Reader, node: AnyTreeRecord, options: {
+    mapToTemplate: boolean;
+}): Promise<string | undefined>;
+/**
+ * Fallback identity for a reference node: the NAME of each resolved target element. Stable across
+ * instantiate even when the project uses placeholder `templateUuid`s that are not the source
+ * element's own `uuid` (so the uuid round-trip in {@link referenceIdentity} cannot bridge the two
+ * sides). Undefined when no target resolves to a named element.
+ */
+export declare function referenceNameIdentity(query: Reader, node: AnyTreeRecord): Promise<string | undefined>;
+export {};
+//# sourceMappingURL=reference-match.d.ts.map

package/dist/v2019C1/extensions/lifecycle/engine/reference-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-match.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/engine/reference-match.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,mFAAmF;AACnF,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AAE3D;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACtC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE;IAAE,aAAa,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAa7B;AAyBD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,aAAa,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B"}

package/dist/v2019C1/extensions/lifecycle/extract/transaction/post-extraction-cleanup.d.ts

@@ -3,9 +3,9 @@ import type * as Core from '@dialecte/core';
 /**
  * Universal post-extraction cleanup run after cloning records into a target DB.
  *
- * Phase 1 — Remap: orphanUuidRefs (clear/delete refs whose target is absent)
- * Phase 2 — Resolve orphan LNodes: resetLNode (reset IED bindings)
- * Phase 3 — Prune: pruneEmptyContainers (empty Private elements + empty ref containers)
+ * 1. Remap: orphanUuidRefs (clear/delete refs whose target is absent)
+ * 2. Resolve orphan LNodes: resetLNode (reset IED bindings)
+ * 3. Prune: pruneEmptyContainers (empty Private elements + empty ref containers)
  *
  * Same function runs for all extraction scopes (FSD, ASD, ISD).
  * Behavior differs based on target DB content.

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

@@ -3,10 +3,12 @@ import type * as Core from '@dialecte/core';
 /**
  * Extract a bay-typical (or wider process scope) from a project into a standalone SSD template.
  *
- * Mirrors `extract.asd`: seeds a TEMPLATE `Substation/VoltageLevel/Bay` scaffold, records an SSD
- * `Header`, then `cloneTopologyContent` gathers the scope's content by CONSUMING the application
- * layer (each `Application` + its composed `Function`s + type closure + satellites). uuid refs are
- * repointed and orphans cleaned up.
+ * Records an SSD `Header`, then `cloneTopologyContent` REPRODUCES the scope's structural frame
+ * (Substation/VoltageLevel/Bay + BayType + equipment) and CONSUMES the application layer (each
+ * `Application` + its composed `Function`s + type closure + satellites). The reproduced ancestors
+ * above the selected entrypoint are then TEMPLATE-named (the scaffolding marker: the first named
+ * level below the TEMPLATE-named ancestors is the instantiable root), the entrypoint keeps its name
+ * with `templateUuid` stripped, uuid refs are repointed and orphans cleaned up.
  */
 export declare function ssd(tx: Core.Transaction<Config>, params: {
     sourceQuery: Core.Query<Config>;

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

@@ -1 +1 @@
-{"version":3,"file":"ssd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/extract/transaction/ssd.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;GAOG;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,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC1E,IAAI,EAAE,GAAG,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAA;IACrD,GAAG,EAAE,GAAG,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAA;IAChD,aAAa,CAAC,EAAE,GAAG,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAA;CACtE,GACC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA6CjC"}
+{"version":3,"file":"ssd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/extract/transaction/ssd.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;GASG;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,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC1E,IAAI,EAAE,GAAG,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAA;IACrD,GAAG,EAAE,GAAG,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAA;IAChD,aAAa,CAAC,EAAE,GAAG,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAA;CACtE,GACC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoDjC"}

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

@@ -23,7 +23,7 @@ import * as updateTransaction from './update';
  *                   sourceQuery, ref, anchor })` returns a `DiffReport`
  *                   (fast/full classification) — nothing is written.
  *
- * Two-track surface (verb-agnostic, ENGINE.md §6): `query.lifecycle.report(...)`
+ * Two-track surface (verb-agnostic): `query.lifecycle.report(...)`
  * classifies, then `tx.lifecycle.apply(tx, { ..., report })` applies the fast
  * track headless (full track returns the report for decision review — nothing is
  * written until decisions come back).

package/dist/v2019C1/extensions/lifecycle/instance/find-instance.d.ts

@@ -1,4 +1,5 @@
 import { Scl, Config } from '../../../config';
+import { ElementIdentity } from '../../identity/query';
 import { MatchKey } from '../scenario';
 import { AnyTrackedRecord, AnyTreeRecord } from '@dialecte/core';
 import type * as Core from '@dialecte/core';
@@ -40,8 +41,8 @@ export declare function findInstancesUnder(reader: Reader, params: {
 export declare function findInstanceByTemplateUuid(reader: Reader, params: {
     tagName: Scl.ElementsOf;
     sourceUuid: string | undefined;
-    sourceName?: string;
     matchKey?: MatchKey;
+    sourceIdentity?: ElementIdentity;
 }): Promise<AnyTrackedRecord | undefined>;
 /**
  * ALL records of `tagName` anywhere whose `templateUuid` equals the source uuid,
@@ -49,20 +50,40 @@ export declare function findInstanceByTemplateUuid(reader: Reader, params: {
  * where there is no placement anchor (the ASD report/apply cascade), so several
  * instances of one template are enumerated and gated as a subset (multi-instance).
  *
- * `sourceName` opt-in fallback: when NO instance carries the source `uuid` as its
- * `templateUuid` — an externally-authored project whose `templateUuid` lineage is
- * broken (a placeholder value, not the source uuid, as real .ssd files reuse one
- * dummy across elements) — recognize the instance by `name` instead, but ONLY when
- * it is unambiguous (exactly one same-tag element of that name), so an unrelated
- * element is never adopted. Callers that omit `sourceName` keep the strict lineage
- * behaviour.
+ * Matching is schema-driven (`resolveIdentity`), no name fallback:
+ *  - **uuid-bearing** `tagName` → LINEAGE ONLY (`instance[matchKey] === sourceUuid`). A miss is a
+ *    miss; a same-name element sharing no lineage is never adopted (that was the scaffold-`TEMPLATE`
+ *    bug). A project whose lineage is a hand-authored placeholder is a data defect surfaced by the UI
+ *    `checkTemplateUuids` warning, not recovered here.
+ *  - **uuid-less** `tagName` with schema `identityFields` → matched by the `sourceIdentity` fields
+ *    tuple, unambiguous only (e.g. DataTypeTemplates types by `id`). Callers pass `sourceIdentity`
+ *    (from `resolveIdentity(sourceRecord)`) for these; uuid-bearing callers pass nothing.
  */
 export declare function findInstancesByTemplateUuid(reader: Reader, params: {
     tagName: Scl.ElementsOf;
     sourceUuid: string | undefined;
-    sourceName?: string;
     /** Attribute matched against `sourceUuid`. Default `templateUuid`; `uuid` for fork. */
     matchKey?: MatchKey;
+    /** The source element's identity, required only for a uuid-less (fields-identified) tag. */
+    sourceIdentity?: ElementIdentity;
 }): Promise<AnyTrackedRecord[]>;
+/**
+ * Narrow a set of matched instances to those SCOPED to one specific target instance: the instance
+ * itself, or any instance structurally UNDER it. When `targetInstance` is undefined, every instance
+ * passes (the default — operate on ALL instances of the template, a template-rollout).
+ *
+ * This is the multi-instance anchor seam: a consumer names ONE target instance (e.g. a specific
+ * pasted Bay) and every enumeration point in the update/report verbs filters through here, so the
+ * frame, the applications and the composed functions all resolve under the chosen instance and no
+ * other. The containment predicate makes it uniform across layers — a Bay `targetInstance` scopes
+ * its descendant Applications/Functions; a Function/Application `targetInstance` scopes itself.
+ */
+export declare function scopeToTargetInstance<GenericRecord extends {
+    id: string;
+    tagName: string;
+}>(reader: Reader, params: {
+    instances: readonly GenericRecord[];
+    targetInstance: Scl.Ref<Scl.ElementsOf> | undefined;
+}): Promise<GenericRecord[]>;
 export {};
 //# sourceMappingURL=find-instance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"find-instance.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/instance/find-instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAErE,iFAAiF;AACjF,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AAE3D;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACP,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB,GACC,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAGpC;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACP,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB,GACC,OAAO,CAAC,aAAa,EAAE,CAAC,CAQ1B;AAyBD;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC/C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACP,OAAO,EAAE,GAAG,CAAC,UAAU,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB,GACC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAGvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACP,OAAO,EAAE,GAAG,CAAC,UAAU,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB,GACC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsB7B"}
+{"version":3,"file":"find-instance.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/instance/find-instance.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AACvE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAErE,iFAAiF;AACjF,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AAE3D;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACP,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB,GACC,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAGpC;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACP,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB,GACC,OAAO,CAAC,aAAa,EAAE,CAAC,CAQ1B;AAyBD;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC/C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACP,OAAO,EAAE,GAAG,CAAC,UAAU,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,cAAc,CAAC,EAAE,eAAe,CAAA;CAChC,GACC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAGvC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACP,OAAO,EAAE,GAAG,CAAC,UAAU,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,eAAe,CAAA;CAChC,GACC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA6B7B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAChG,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACP,SAAS,EAAE,SAAS,aAAa,EAAE,CAAA;IACnC,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;CACnD,GACC,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB1B"}

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

@@ -1,3 +1,3 @@
 export { collectComposedFunctionUuids } from './composed-functions';
-export { findInstanceByTemplateUuid, findInstancesByTemplateUuid, findInstancesUnder, findInstanceUnder, } from './find-instance';
+export { findInstanceByTemplateUuid, findInstancesByTemplateUuid, findInstancesUnder, findInstanceUnder, scopeToTargetInstance, } from './find-instance';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/instance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EACN,0BAA0B,EAC1B,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/v2019C1/extensions/lifecycle/instance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EACN,0BAA0B,EAC1B,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,iBAAiB,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"asd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/asd.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAO,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAiF7F"}
+{"version":3,"file":"asd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/asd.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAO,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAgF7F"}

package/dist/v2019C1/extensions/lifecycle/instantiate/transaction/asd.types.d.ts

@@ -20,5 +20,11 @@ export type AsdResult = {
     composedFunctionRefs: (Scl.Ref<'Function'> | Scl.Ref<'SubFunction'>)[];
     /** Full source-record -> target-record mapping for the cloned content. */
     recordMappings: Scl.CloneMapping[];
+    /**
+     * Every source->target mapping produced, including the cross-cutting satellites that live outside
+     * the Application subtree — the full set the report→applied correlation needs for a first-time
+     * instantiate (`sourceToTargetMap` over these).
+     */
+    mappings: Scl.CloneMapping[];
 };
 //# sourceMappingURL=asd.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"asd.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/asd.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,MAAM,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,yDAAyD;IACzD,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,wFAAwF;IACxF,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,wFAAwF;IACxF,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACvB,kDAAkD;IAClD,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,gFAAgF;IAChF,oBAAoB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAA;IACtE,0EAA0E;IAC1E,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;CAClC,CAAA"}
+{"version":3,"file":"asd.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/asd.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,MAAM,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,yDAAyD;IACzD,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,wFAAwF;IACxF,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,wFAAwF;IACxF,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACvB,kDAAkD;IAClD,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,gFAAgF;IAChF,oBAAoB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAA;IACtE,0EAA0E;IAC1E,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;IAClC;;;;OAIG;IACH,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;CAC5B,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"fsd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/fsd.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAO,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAyE7F"}
+{"version":3,"file":"fsd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/fsd.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAO,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAoE7F"}

package/dist/v2019C1/extensions/lifecycle/instantiate/transaction/fsd.types.d.ts

@@ -21,5 +21,11 @@ export type FsdResult = {
     functionRef: Scl.Ref<'Function'> | Scl.Ref<'SubFunction'>;
     /** Full source-record -> target-record mapping for the cloned subtree. */
     recordMappings: Scl.CloneMapping[];
+    /**
+     * Every source->target mapping produced, including the carried satellites (FunctionCategory,
+     * Variable, BehaviorDescription) that live outside the subtree — the full set the report→applied
+     * correlation needs for a first-time instantiate (`sourceToTargetMap` over these).
+     */
+    mappings: Scl.CloneMapping[];
 };
 //# sourceMappingURL=fsd.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fsd.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/fsd.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,MAAM,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,uEAAuE;IACvE,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACzD,6EAA6E;IAC7E,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,wFAAwF;IACxF,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACvB;;;OAGG;IACH,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACzD,0EAA0E;IAC1E,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;CAClC,CAAA"}
+{"version":3,"file":"fsd.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/fsd.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,MAAM,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,uEAAuE;IACvE,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACzD,6EAA6E;IAC7E,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,wFAAwF;IACxF,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACvB;;;OAGG;IACH,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACzD,0EAA0E;IAC1E,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;IAClC;;;;OAIG;IACH,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;CAC5B,CAAA"}

package/dist/v2019C1/extensions/lifecycle/instantiate/transaction/index.d.ts

@@ -1,6 +1,8 @@
 export { fsd } from './fsd';
 export { asd } from './asd';
+export { ssd } from './ssd';
 export { resolveTargetStructure } from './resolve-target-structure';
 export type { FsdParams } from './fsd.types';
 export type { AsdParams } from './asd.types';
+export type { SsdParams } from './ssd.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/v2019C1/extensions/lifecycle/instantiate/transaction/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}

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

@@ -0,0 +1,19 @@
+import { SsdParams, SsdResult } from './ssd.types';
+import { Config } from '../../../../config';
+import type * as Core from '@dialecte/core';
+/**
+ * Instantiate the process-section content carried by an SSD into a target project.
+ *
+ * The topology layer OWNS its frame: `cloneTopologyContent` REPRODUCES the source structural
+ * skeleton (Substation/VoltageLevel/Bay + BayType + equipment) by name under `targetParent`, then
+ * consumes the application/function layers to place the Applications + their composed Functions +
+ * standalone Functions (with the type closure) under the name-correct level. Cross-cutting satellites
+ * travel too; then the identity policy applies (`stamp-template` for bay-typical reuse = fresh uuid +
+ * templateUuid, `keep` for a project base = preserved uuids). The instantiation is recorded once as a
+ * document-level `SclFileReference` under the target `Header > SourceFiles`.
+ *
+ * The scope defaults to the SSD's instantiable root (the first named level down the
+ * `Substation -> VoltageLevel -> Bay` chain).
+ */
+export declare function ssd(tx: Core.Transaction<Config>, params: SsdParams): Promise<SsdResult>;
+//# sourceMappingURL=ssd.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ssd.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/ssd.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAuE7F"}

package/dist/v2019C1/extensions/lifecycle/instantiate/transaction/ssd.types.d.ts

@@ -0,0 +1,25 @@
+import { Config, Scl } from '../../../../config';
+import { TopologyStructuralTag } from '../../../../constants';
+import { KeepNameTypesFrom } from '../../../data-model/transaction';
+import { CollisionOverrides } from '../../engine/decide.types';
+import type * as Core from '@dialecte/core';
+export type SsdParams = {
+    sourceQuery: Core.Query<Config>;
+    /** The SSD scope to instantiate. Defaults to the SSD's instantiable root. */
+    scopeRef?: Scl.Ref<TopologyStructuralTag>;
+    /** Target parent the SSD content is instantiated under (e.g. a project Bay). */
+    targetParent: Scl.Ref<Scl.ElementsOf>;
+    /** Identity policy: `stamp-template` (bay-typical reuse, default) or `keep` (project-base). */
+    mode?: 'stamp-template' | 'keep';
+    /** User-edited values per source element id (full track); drives collision override. */
+    overrides?: CollisionOverrides;
+    /** Type-dedup name authority, forwarded to `importTypes`. Default `'target'`. */
+    keepNameTypesFrom?: KeepNameTypesFrom;
+};
+export type SsdResult = {
+    /** The SSD scope root that was instantiated (source-side ref). */
+    scopeRef: Scl.Ref<TopologyStructuralTag>;
+    /** Full source-record -> target-record mapping for the cloned content. */
+    recordMappings: Scl.CloneMapping[];
+};
+//# sourceMappingURL=ssd.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ssd.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/instantiate/transaction/ssd.types.ts"],"names":[],"mappings":"AAAA,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,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAE3C,MAAM,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IACzC,gFAAgF;IAChF,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,+FAA+F;IAC/F,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAA;IAChC,wFAAwF;IACxF,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACvB,kEAAkE;IAClE,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IACxC,0EAA0E;IAC1E,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;CAClC,CAAA"}

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

@@ -1,27 +1,30 @@
+import { CloneTopologyContentResult } from './clone-topology-content.types';
 import { Config, Scl } from '../../../../config';
 import { TopologyStructuralTag } from '../../../../constants';
-import { TargetStructure } from '../../transplant/transaction';
 import { OmitEntry } from '@dialecte/core';
 import type * as Core from '@dialecte/core';
 /**
- * Topology-layer take-over (extract direction): gathers a topology scope's content into a
- * self-contained target.
+ * Topology-layer take-over: gathers a topology scope's content into a self-contained target.
  *
- * 1. **Applications** under `scopeRef` - delegates to `cloneApplicationContent`, CONSUMING the
+ * 1. **Frame** - reproduces the source structural skeleton (Substation/VoltageLevel/Bay + their
+ *    own `Private`/BayType, equipment, connectivity) by name via {@link ensureTopologyFrame}. The
+ *    topology layer OWNS this content, so it is carried here rather than fed in.
+ * 2. **Applications** under `scopeRef` - delegates to `cloneApplicationContent`, CONSUMING the
  *    application layer (Application + its composed `Function`s + type closure + satellites).
- * 2. **Standalone Functions** structurally under the scope that no Application already pulled in.
- * 3. **Equipment** (the topology layer's own content) placed back at its structural level.
+ * 3. **Standalone Functions** structurally under the scope that no Application already pulled in.
  *
- * Each is placed at its structural level in `structure`. Direction-agnostic: returns the full
- * `CloneMapping[]`; the caller applies identity policy and `reference.applyUuidRemap`.
+ * Each fn/app is placed under its name-correct reproduced level (via the frame index), so multiple
+ * bays never collapse. Direction-agnostic: returns the full `CloneMapping[]` plus the placed roots
+ * and the frame index; the caller applies identity policy, `applyUuidRemap`, and placement-collision.
  *
- * This is the building block a bay-typical extract (and later SCD) composes.
+ * This is the building block a bay-typical instantiate/extract (and later SCD) composes.
  */
 export declare function cloneTopologyContent(tx: Core.Transaction<Config>, params: {
     sourceQuery: Core.Query<Config>;
     scopeRef: Scl.Ref<TopologyStructuralTag>;
-    structure: TargetStructure;
-    /** Child tags to drop from clones (extract prunes provenance refs; keeps equipment). */
+    /** The target element the reproduced frame is rooted under (typically the SCL root). */
+    targetParent: Scl.Ref<Scl.ElementsOf>;
+    /** Child tags to drop from clones (extract prunes provenance refs). */
     omit?: OmitEntry<Config>[];
-}): Promise<Scl.CloneMapping[]>;
+}): Promise<CloneTopologyContentResult>;
 //# sourceMappingURL=clone-topology-content.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"clone-topology-content.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/clone-topology-content.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACzC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IACxC,SAAS,EAAE,eAAe,CAAA;IAC1B,wFAAwF;IACxF,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;CAC1B,GACC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAwC7B"}
+{"version":3,"file":"clone-topology-content.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/clone-topology-content.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAA;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACzC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE;IACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IACxC,wFAAwF;IACxF,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,uEAAuE;IACvE,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;CAC1B,GACC,OAAO,CAAC,0BAA0B,CAAC,CAqDrC"}

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

@@ -0,0 +1,14 @@
+import { Scl } from '../../../../config';
+export type CloneTopologyContentResult = {
+    /** All source -> target clone mappings for the gathered content (frame + fn/app). */
+    mappings: Scl.CloneMapping[];
+    /**
+     * Source refs of the top-level placed elements (Applications, their composed Functions,
+     * standalone Functions) - the elements a caller runs placement-collision on. The structural
+     * frame is placed by merge-by-name, so it is not included here.
+     */
+    placedRoots: Scl.Ref<Scl.ElementsOf>[];
+    /** Source structural element id -> reproduced target ref, for name-correct placement. */
+    frameIndex: Map<string, Scl.Ref<Scl.ElementsOf>>;
+};
+//# sourceMappingURL=clone-topology-content.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clone-topology-content.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/clone-topology-content.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAE3C,MAAM,MAAM,0BAA0B,GAAG;IACxC,qFAAqF;IACrF,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;IAC5B;;;;OAIG;IACH,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAA;IACtC,yFAAyF;IACzF,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;CAChD,CAAA"}

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

@@ -0,0 +1,25 @@
+import { EnsureTopologyFrameParams, EnsureTopologyFrameResult } from './ensure-topology-frame.types';
+import { Config, Scl } from '../../../../config';
+import { TargetStructure } from '../../transplant/transaction';
+import type * as Core from '@dialecte/core';
+/**
+ * Reproduce the source topology frame into the target, keyed by structural POSITION (never by name).
+ *
+ * The topology layer OWNS its structural frame (Substation/VoltageLevel/Bay + their `Private`/BayType,
+ * equipment, connectivity). Ancestors ABOVE the scope root are the target CONTEXT: reused from
+ * `targetParent`'s existing chain where present, created from source where absent (so an empty target
+ * gets the whole chain). The scope root and its structural DESCENDANTS are always CREATED from source
+ * with their own content, OMITTING the delegated fn/app children (the fn/app layers place those), and
+ * stamped by the caller so a later update can match them by `templateUuid`.
+ *
+ * Returns a `frameIndex` (source structural id -> target ref) so callers place fn/app content under
+ * the correct target level even across multiple bays.
+ */
+export declare function ensureTopologyFrame(tx: Core.Transaction<Config>, params: EnsureTopologyFrameParams): Promise<EnsureTopologyFrameResult>;
+/**
+ * The structural chain (Substation/VL/Bay) of `ref` mapped to its reproduced target records, as a
+ * `TargetStructure`. Lets a caller place fn/app content under the name-correct target level of `ref`,
+ * even across multiple bays, using `resolveStructureRef` / `createAncestryResolver`.
+ */
+export declare function resolveFrameStructure(tx: Core.Transaction<Config>, sourceQuery: Core.Query<Config>, ref: Scl.Ref<Scl.ElementsOf>, frameIndex: ReadonlyMap<string, Scl.Ref<Scl.ElementsOf>>): Promise<TargetStructure>;
+//# sourceMappingURL=ensure-topology-frame.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-topology-frame.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/ensure-topology-frame.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,yBAAyB,EACzB,yBAAyB,EACzB,MAAM,+BAA+B,CAAA;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAW3C;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACxC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE,yBAAyB,GAC/B,OAAO,CAAC,yBAAyB,CAAC,CAkDpC;AAqHD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAC1C,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAC5B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAC/B,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAC5B,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GACtD,OAAO,CAAC,eAAe,CAAC,CAW1B"}

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

@@ -0,0 +1,22 @@
+import { Config, Scl } from '../../../../config';
+import { TargetStructure } from '../../transplant/transaction';
+import { OmitEntry } from '@dialecte/core';
+import type * as Core from '@dialecte/core';
+export type EnsureTopologyFrameParams = {
+    sourceQuery: Core.Query<Config>;
+    /** The instantiable root of the source frame (Substation / VoltageLevel / Bay). */
+    scopeRef: Scl.Ref<Scl.ElementsOf>;
+    /** The target element the reproduced frame is rooted under (typically the SCL root). */
+    targetParent: Scl.Ref<Scl.ElementsOf>;
+    /** Extra child tags to drop from the frame's own-content clones (e.g. extract prunes provenance). */
+    omit?: OmitEntry<Config>[];
+};
+export type EnsureTopologyFrameResult = {
+    /** The scope root's own structural chain (Substation/VL/Bay), for single-scope placement compat. */
+    structure: TargetStructure;
+    /** Source structural element id -> its reproduced target ref (multi-bay-safe placement). */
+    frameIndex: Map<string, Scl.Ref<Scl.ElementsOf>>;
+    /** Source -> target mappings for every reproduced structural element and its own-content clones. */
+    mappings: Scl.CloneMapping[];
+};
+//# sourceMappingURL=ensure-topology-frame.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-topology-frame.types.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/ensure-topology-frame.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AAC5F,OAAO,KAAK,KAAK,IAAI,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,MAAM,yBAAyB,GAAG;IACvC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,mFAAmF;IACnF,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACjC,wFAAwF;IACxF,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACrC,qGAAqG;IACrG,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACvC,oGAAoG;IACpG,SAAS,EAAE,eAAe,CAAA;IAC1B,4FAA4F;IAC5F,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;IAChD,oGAAoG;IACpG,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;CAC5B,CAAA"}

package/dist/v2019C1/extensions/lifecycle/layers/topology/index.d.ts

@@ -1,3 +1,8 @@
 export { resolveInstantiableRoot } from './root-selection';
 export { cloneTopologyContent } from './clone-topology-content';
+export { ensureTopologyFrame, resolveFrameStructure } from './ensure-topology-frame';
+export { reconcileTopologyFrame } from './reconcile-topology-frame';
+export { resolveTopologyReconcilables } from './scope-content';
+export type { TopologyReconcilables } from './scope-content.types';
+export type { EnsureTopologyFrameParams, EnsureTopologyFrameResult, } from './ensure-topology-frame.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/v2019C1/extensions/lifecycle/layers/topology/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/v2019C1/extensions/lifecycle/layers/topology/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAClE,YAAY,EACX,yBAAyB,EACzB,yBAAyB,GACzB,MAAM,+BAA+B,CAAA"}

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

@@ -0,0 +1,29 @@
+import { Config, Scl } from '../../../../config';
+import { TopologyStructuralTag } from '../../../../constants';
+import { IdentityMode } from '../../../identity/transaction/write-identity.types';
+import { DecisionMap, DiffReport } from '../../engine/diff.types';
+import { MatchKey } from '../../scenario';
+import type * as Core from '@dialecte/core';
+/**
+ * Reconcile a topology scope's OWN structural content (Substation/VoltageLevel/Bay attributes +
+ * BayType + equipment) against a newer source, matched by identity.
+ *
+ * Finds the scope instances by `templateUuid` (stamp) / `uuid` (keep) - rename-robust, since the
+ * frame carries stamped lineage - then runs the shared engine `reconcile` over each matched
+ * instance's structural subtree with the fn/app tags as a BOUNDARY, so the delegated
+ * Applications/Functions are left to the fn/app cascade. Several bays may share one `templateUuid`
+ * (a bay-typical instantiated more than once): EACH is reconciled, gated by ONLY its own report
+ * groups (partitioned by instance) so the user can update a subset. No-op when no instance exists
+ * (a first-time update instantiates instead).
+ */
+export declare function reconcileTopologyFrame(tx: Core.Transaction<Config>, params: {
+    sourceQuery: Core.Query<Config>;
+    scopeRef: Scl.Ref<TopologyStructuralTag>;
+    matchKey: MatchKey;
+    identityMode: IdentityMode;
+    report?: DiffReport;
+    decisions?: DecisionMap;
+    /** Multi-instance anchor: reconcile only the frame instance that IS the target (or under it). */
+    targetInstance?: Scl.Ref<Scl.ElementsOf>;
+}): Promise<void>;
+//# sourceMappingURL=reconcile-topology-frame.d.ts.map

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

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