@dougongjs/core 0.2.0 → 0.4.0

package/dist/index.js

@@ -1,65 +1,109 @@
-function rt(r, t) {
+function at(r, t) {
   if (typeof t != "string" || !t.trim())
     throw new TypeError(`${r} id must be a non-empty string`);
   if (t !== t.trim())
     throw new TypeError(`${r} id cannot start or end with whitespace`);
 }
 function V(r, t) {
-  return rt("Contract", t), Object.freeze({ id: t, kind: r });
+  return at("Contract", t), Object.freeze({ id: t, kind: r });
 }
 function v(r, t) {
   if (!r || typeof r != "object") return !1;
   const e = r;
   return typeof e.id == "string" && e.id.length > 0 && e.id === e.id.trim() && (e.kind === "service" || e.kind === "extensionPoint" || e.kind === "event") && (t === void 0 || e.kind === t);
 }
-function b(r, t) {
+function m(r, t) {
   if (!v(r, t))
-    throw new TypeError(t ? `Expected ${nt(t)}` : "Invalid contract");
+    throw new TypeError(t ? `Expected ${ct(t)}` : "Invalid contract");
 }
-function nt(r) {
+function ct(r) {
   return r === "extensionPoint" ? "an ExtensionPoint" : r === "event" ? "an Event" : "a Service";
 }
-function de(r) {
+function fe(r) {
   return V("service", r);
 }
-function le(r) {
+function pe(r) {
   return V("event", r);
 }
-function ue(r) {
+function ge(r) {
   return V("extensionPoint", r);
 }
-function fe(r) {
+function we(r) {
   if (!v(r, "service"))
     throw new TypeError("optional() expects a Service");
   return Object.freeze({ kind: "optional", service: r });
 }
-function ot(r) {
+function ht(r) {
   if (!r || typeof r != "object") return !1;
   const t = r;
   return t.kind === "optional" && v(t.service, "service");
 }
 class u extends Error {
+  name = "DougongError";
+  code;
   constructor(t, e, i) {
+    if (typeof t != "string" || t.trim() !== t || t.length === 0)
+      throw new TypeError("DougongError code must be a non-empty trimmed string");
+    if (typeof e != "string") throw new TypeError("DougongError message must be a string");
     super(e, i), this.code = t;
   }
-  code;
-  name = "DougongError";
 }
-class P extends u {
+class dt {
+  #t;
+  constructor(t) {
+    if (!(t instanceof Error)) throw new TypeError("ErrorSummary expects an Error");
+    const e = F(t, "name", "Error"), i = F(t, "message", ""), s = t instanceof u ? lt(t) : void 0;
+    this.#t = Object.freeze(
+      s === void 0 ? {
+        category: t instanceof TypeError ? "typeError" : "error",
+        name: e,
+        message: i
+      } : {
+        category: "coded",
+        name: e,
+        message: i,
+        code: s
+      }
+    ), Object.freeze(this);
+  }
+  restore(t = (e, i) => new u(e, i)) {
+    const e = this.#t, i = e.category === "coded" ? t(e.code, e.message) : e.category === "typeError" ? new TypeError(e.message) : new Error(e.message);
+    if (!(i instanceof Error))
+      throw new TypeError("ErrorSummary coded error factory must return an Error");
+    return i.name = e.name, i;
+  }
+}
+function F(r, t, e) {
+  try {
+    const i = r[t];
+    return typeof i == "string" ? i : e;
+  } catch {
+    return e;
+  }
+}
+function lt(r) {
+  try {
+    const t = r.code;
+    return typeof t == "string" && t.trim() === t && t.length > 0 ? t : void 0;
+  } catch {
+    return;
+  }
+}
+class z extends u {
 }
 function $(r, t, e) {
-  return r instanceof P ? r.code === t ? r : new P(t, e, { cause: r.cause }) : r instanceof Error ? r : new P(t, e, { cause: r });
+  return r instanceof z ? r.code === t ? r : new z(t, e, { cause: r.cause }) : r instanceof Error ? r : new z(t, e, { cause: r });
 }
-function J(r, t) {
+function tt(r, t) {
   if (!r || typeof r != "object" || typeof r.aborted != "boolean" || typeof r.addEventListener != "function" || typeof r.removeEventListener != "function" || typeof r.throwIfAborted != "function")
     throw new TypeError("Cancellation classifier expects an AbortSignal");
   return r.aborted ? Object.is(t, r.reason) ? !0 : t instanceof Error && t.name === "AbortError" : !1;
 }
-class at extends u {
+class ut extends u {
   name = "ConfigValidationError";
   issues;
   constructor(t) {
-    const e = ct(t);
+    const e = ft(t);
     super(
       "CONFIG_INVALID",
       `Invalid Plugin config:
@@ -68,7 +112,7 @@ ${e.map((i) => `  - ${i.message}`).join(`
     ), this.issues = e;
   }
 }
-function ct(r) {
+function ft(r) {
   if (!Array.isArray(r))
     throw new TypeError("Config validation issues must be an array");
   return Object.freeze(
@@ -80,12 +124,12 @@ function ct(r) {
         throw new TypeError(`Config validation issue at index ${e} message must be a string`);
       return Object.freeze({
         message: i.message,
-        ...i.path === void 0 ? {} : { path: ht(i.path, e) }
+        ...i.path === void 0 ? {} : { path: pt(i.path, e) }
       });
     })
   );
 }
-function ht(r, t) {
+function pt(r, t) {
   if (!Array.isArray(r))
     throw new TypeError(`Config validation issue at index ${t} path must be an array`);
   return Object.freeze(
@@ -107,7 +151,7 @@ function ht(r, t) {
 function G(r) {
   return typeof r == "string" || typeof r == "number" || typeof r == "symbol";
 }
-async function X(r, t, e) {
+async function et(r, t, e) {
   if (!r) return t;
   const i = await r["~standard"].validate(t);
   if (!i || typeof i != "object")
@@ -116,7 +160,7 @@ async function X(r, t, e) {
     );
   const s = Object.hasOwn(i, "issues") ? i.issues : void 0;
   if (s !== void 0)
-    throw Array.isArray(s) ? new at(s) : new TypeError(
+    throw Array.isArray(s) ? new ut(s) : new TypeError(
       `Installation '${e}' config validator returned non-array issues`
     );
   if (!Object.hasOwn(i, "value"))
@@ -125,26 +169,26 @@ async function X(r, t, e) {
     );
   return i.value;
 }
-class dt {
+class gt {
   #t = /* @__PURE__ */ new Map();
   get kinds() {
     return this.#t;
   }
   assertCompatible(t) {
-    Z(this.#t, t);
+    it(this.#t, t);
   }
   remember(t) {
-    T(this.#t, t);
+    j(this.#t, t);
   }
   draft(t) {
-    return new lt(this, t);
+    return new wt(this, t);
   }
   commit(t) {
     for (const [e, i] of t) this.assertCompatible({ id: e, kind: i });
     for (const [e, i] of t) this.#t.set(e, i);
   }
 }
-class lt {
+class wt {
   #t;
   constructor(t, e) {
     this.#t = { phase: "open", registry: t, pending: /* @__PURE__ */ new Map() };
@@ -158,7 +202,7 @@ class lt {
     }
     if (e.phase === "discarded")
       throw new Error("Contract registry draft has been discarded");
-    e.registry.assertCompatible(t), !e.registry.kinds.has(t.id) && T(e.pending, t);
+    e.registry.assertCompatible(t), !e.registry.kinds.has(t.id) && j(e.pending, t);
   }
   commit() {
     const t = this.#t;
@@ -168,10 +212,10 @@ class lt {
     this.#t.phase === "open" && (this.#t = { phase: "discarded" });
   }
 }
-function T(r, t) {
-  Z(r, t), r.set(t.id, t.kind);
+function j(r, t) {
+  it(r, t), r.set(t.id, t.kind);
 }
-function Z(r, t) {
+function it(r, t) {
   const e = r.get(t.id);
   if (e && e !== t.kind)
     throw new u(
@@ -190,7 +234,7 @@ class M {
   contractKinds;
   #t;
   static build(t, e) {
-    const i = [...t].sort((c, d) => c.index - d.index), s = new Map(e), n = ut(i, s), o = ft(i, n, s), { order: a, layers: h } = pt(
+    const i = [...t].sort((c, d) => c.index - d.index), s = new Map(e), n = vt(i, s), o = bt(i, n, s), { order: a, layers: h } = mt(
       i,
       o.dependents,
       o.indegree
@@ -225,11 +269,11 @@ class M {
     }
   }
 }
-function ut(r, t) {
+function vt(r, t) {
   const e = /* @__PURE__ */ new Map();
   for (const i of r)
     for (const s of Object.values(i.declaration.plugin.provides ?? {})) {
-      T(t, s);
+      j(t, s);
       const n = e.get(s.id);
       if (n)
         throw new u(
@@ -240,12 +284,12 @@ function ut(r, t) {
     }
   return e;
 }
-function ft(r, t, e) {
+function bt(r, t, e) {
   const i = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map(), n = new Map(r.map((o) => [o, 0]));
   for (const o of r)
     for (const a of Object.values(o.declaration.plugin.requires ?? {})) {
       const h = a.kind === "optional" ? a.service : a;
-      if (T(e, h), h.kind === "extensionPoint") continue;
+      if (j(e, h), h.kind === "extensionPoint") continue;
       const c = t.get(h.id);
       if (!c) {
         if (a.kind === "optional") continue;
@@ -266,7 +310,7 @@ function ft(r, t, e) {
     }
   return { resolvedProviders: i, dependents: s, indegree: n };
 }
-function pt(r, t, e) {
+function mt(r, t, e) {
   let i = r.filter((o) => e.get(o) === 0);
   const s = [], n = [];
   for (; i.length; ) {
@@ -280,7 +324,7 @@ function pt(r, t, e) {
       }
   }
   if (s.length !== r.length) {
-    const o = gt(r, t);
+    const o = yt(r, t);
     throw new u(
       "SERVICE_CYCLE",
       `Installation dependency cycle: ${o.map((a) => a.id).join(" -> ")}`
@@ -288,7 +332,7 @@ function pt(r, t, e) {
   }
   return { order: s, layers: n };
 }
-function gt(r, t) {
+function yt(r, t) {
   const e = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), s = [], n = (o) => {
     i.add(o), s.push(o);
     for (const a of t.get(o) ?? []) {
@@ -309,7 +353,7 @@ function gt(r, t) {
   }
   throw new Error("Dependency graph is cyclic but no cycle path was found");
 }
-class S {
+class O {
   #t;
   constructor(t = []) {
     if (!t || typeof t != "object" && typeof t != "function" || typeof t[Symbol.iterator] != "function")
@@ -341,21 +385,30 @@ class S {
     return this.entries();
   }
 }
-function wt(r) {
+function Et(r) {
   if (typeof r != "function")
     throw new Error("Unsupported JavaScript runtime: Promise.withResolvers is required");
 }
-function tt(r, t) {
+function st(r, t) {
   return r ?? Symbol.for(t);
 }
-wt(Promise.withResolvers);
-const g = tt(
+Et(Promise.withResolvers);
+const g = st(
   Symbol.dispose,
   "Symbol.dispose"
-), j = tt(
+), k = st(
   Symbol.asyncDispose,
   "Symbol.asyncDispose"
-), m = /* @__PURE__ */ new WeakMap();
+);
+function P(r, t) {
+  if (Ct(r))
+    throw Promise.resolve(r).catch(() => {
+    }), new TypeError(t);
+}
+function Ct(r) {
+  return r === null || typeof r != "object" && typeof r != "function" ? !1 : typeof r.then == "function";
+}
+const y = /* @__PURE__ */ new WeakMap();
 class q {
   #t = /* @__PURE__ */ new Set();
   #e;
@@ -369,18 +422,21 @@ class q {
   }
   view = Object.freeze({
     get: () => this.#n(),
-    subscribe: (t) => this.#o(t)
+    subscribe: (t) => this.#a(t)
   });
   invalidate() {
-    const { report: t } = this.#a();
+    const { report: t } = this.#o();
     this.#s = !0;
     const e = [];
     for (const i of [...this.#t])
       try {
-        bt(i);
+        Ot(i);
       } catch (s) {
         try {
-          t(s);
+          P(
+            t(s),
+            "Snapshot error reporters must be synchronous"
+          );
         } catch (n) {
           e.push(s, n);
         }
@@ -398,7 +454,7 @@ class q {
         this.#s = !1;
         const e = [...this.#t];
         this.#t.clear();
-        for (const i of e) mt(i);
+        for (const i of e) It(i);
       }
     }
   }
@@ -409,10 +465,10 @@ class q {
     const t = this.#e;
     return t.phase === "active" && this.#r(t.read), this.#i;
   }
-  #o(t) {
+  #a(t) {
     if (typeof t != "function") throw new TypeError("Subscriber must be a function");
-    this.#a();
-    const e = new vt(t, (i) => {
+    this.#o();
+    const e = new St(t, (i) => {
       this.#t.delete(i);
     });
     return this.#t.add(e), e;
@@ -420,31 +476,32 @@ class q {
   #r(t) {
     this.#s && (this.#i = t(), this.#s = !1);
   }
-  #a() {
+  #o() {
     const t = this.#e;
     if (t.phase === "disposed") throw new TypeError("Snapshot publisher is disposed");
     return t;
   }
 }
-class vt {
+class St {
   constructor(t, e) {
-    m.set(this, { listener: t, detach: e }), Object.freeze(this);
+    y.set(this, { listener: t, detach: e }), Object.freeze(this);
   }
   dispose() {
-    const t = m.get(this);
-    t && (m.delete(this), t.detach(this));
+    const t = y.get(this);
+    t && (y.delete(this), t.detach(this));
   }
   [g]() {
     this.dispose();
   }
 }
-function bt(r) {
-  m.get(r)?.listener();
+function Ot(r) {
+  const t = y.get(r);
+  t && P(t.listener(), "Snapshot subscribers must be synchronous");
 }
-function mt(r) {
-  m.delete(r);
+function It(r) {
+  y.delete(r);
 }
-class yt {
+class At {
   #t;
   get;
   subscribe;
@@ -466,7 +523,7 @@ class yt {
     return t;
   }
 }
-class Et {
+class Tt {
   #t;
   constructor(t) {
     this.#t = t, Object.freeze(this);
@@ -481,12 +538,12 @@ class Et {
     this.dispose();
   }
 }
-class Ct {
+class $t {
   #t;
   #e;
   handle;
   constructor(t, e, i, s) {
-    this.#e = e, this.#t = { phase: "staged", store: t, value: i, detachFromOwner: s }, this.handle = new Et(this);
+    this.#e = e, this.#t = { phase: "staged", store: t, value: i, detachFromOwner: s }, this.handle = new Tt(this);
   }
   publish() {
     const t = this.#t;
@@ -519,33 +576,33 @@ class Ct {
     this.dispose();
   }
 }
-class Ot {
+class jt {
   #t;
   #e;
   #i = /* @__PURE__ */ new Map();
   #s = /* @__PURE__ */ new Map();
   #n;
-  #o = new S();
+  #a = new O();
   #r = 0;
-  #a = 0;
+  #o = 0;
   #d = !1;
   #f = !1;
   constructor(t, e, i) {
-    this.#t = t, this.#e = i, this.#n = new q(() => this.#o, e);
+    this.#t = t, this.#e = i, this.#n = new q(() => this.#a, e);
   }
   stage(t, e, i, s) {
-    $t(e);
-    const n = Tt(t, e);
+    zt(e);
+    const n = Rt(t, e);
     if (this.#i.has(n))
       throw new TypeError(`Duplicate contribution '${n}'`);
-    const o = new Ct(this, n, i, s);
+    const o = new $t(this, n, i, s);
     return this.#i.set(n, o), o;
   }
   view(t) {
     this.#r++;
     const e = { binding: { store: this, own: t } };
     let i;
-    const s = new St(e, () => {
+    const s = new kt(e, () => {
       const n = i;
       i = void 0;
       try {
@@ -559,7 +616,7 @@ class Ot {
     } catch (n) {
       throw e.binding = void 0, this.#r--, this.#h(), n;
     }
-    return new yt(e);
+    return new At(e);
   }
   /** A stable view explicitly owned by the Host for graph-external consumers. */
   hostView() {
@@ -572,15 +629,15 @@ class Ot {
     if (typeof t != "function")
       throw new TypeError("Contribution subscriber must be a function");
     const i = this.#n.view.subscribe(t);
-    this.#a++;
+    this.#o++;
     let s;
-    const n = new It(i, () => {
+    const n = new Pt(i, () => {
       const o = s;
       s = void 0;
       try {
         o?.();
       } finally {
-        this.#a--, this.#h();
+        this.#o--, this.#h();
       }
     });
     try {
@@ -609,7 +666,7 @@ class Ot {
   }
   publishSnapshot() {
     const t = [...this.#s].map(([i, s]) => [i, s.value]);
-    t.length === this.#o.size && t.every(([i, s]) => Object.is(this.#o.get(i), s)) || (this.#o = new S(t), this.#n.invalidate());
+    t.length === this.#a.size && t.every(([i, s]) => Object.is(this.#a.get(i), s)) || (this.#a = new O(t), this.#n.invalidate());
   }
   #l(t, e) {
     if (this.#i.get(t) !== e)
@@ -622,7 +679,7 @@ class Ot {
     return i;
   }
   #h() {
-    if (!(this.#f || this.#d || this.#i.size || this.#s.size || this.#a || this.#r)) {
+    if (!(this.#f || this.#d || this.#i.size || this.#s.size || this.#o || this.#r)) {
       this.#f = !0;
       try {
         this.#n.dispose();
@@ -632,7 +689,7 @@ class Ot {
     }
   }
 }
-class St {
+class kt {
   #t;
   constructor(t, e) {
     this.#t = { state: t, release: e }, Object.freeze(this);
@@ -645,7 +702,7 @@ class St {
     this.dispose();
   }
 }
-class It {
+class Pt {
   #t;
   constructor(t, e) {
     this.#t = { subscription: t, release: e }, Object.freeze(this);
@@ -665,7 +722,7 @@ class It {
     this.dispose();
   }
 }
-class At {
+class Lt {
   #t = /* @__PURE__ */ new Map();
   #e = /* @__PURE__ */ new Set();
   #i;
@@ -676,7 +733,7 @@ class At {
   get(t) {
     const e = this.#t.get(t.id);
     if (e) return e;
-    const i = new Ot(
+    const i = new jt(
       (s) => this.#n(s),
       this.#i,
       (s) => {
@@ -711,19 +768,19 @@ class At {
     this.#e.add(t), !this.#s && (this.#e.delete(t), t.publishSnapshot());
   }
 }
-function $t(r) {
+function zt(r) {
   if (typeof r != "string" || !r.trim())
     throw new TypeError("Contribution key must be a non-empty string");
   if (r !== r.trim())
     throw new TypeError("Contribution key cannot start or end with whitespace");
 }
-function Tt(r, t) {
-  return `${B(r)}/${B(t)}`;
+function Rt(r, t) {
+  return `${U(r)}/${U(t)}`;
 }
-function B(r) {
+function U(r) {
   return r.replaceAll("%", "%25").replaceAll("/", "%2F");
 }
-class jt {
+class Nt {
   #t;
   constructor(t) {
     this.#t = t, Object.freeze(this);
@@ -736,12 +793,12 @@ class jt {
     this.dispose();
   }
 }
-class kt {
+class xt {
   #t;
   #e;
   handle;
   constructor(t, e, i, s) {
-    this.#e = e, this.#t = { phase: "staged", hub: t, slot: { listener: i }, release: s }, this.handle = new jt(this);
+    this.#e = e, this.#t = { phase: "staged", hub: t, slot: { listener: i }, release: s }, this.handle = new Nt(this);
   }
   publish() {
     const t = this.#t;
@@ -762,11 +819,11 @@ class kt {
     this.dispose();
   }
 }
-class Pt {
+class Dt {
   #t = /* @__PURE__ */ new Map();
   stage(t, e, i) {
     if (typeof e != "function") throw new TypeError("Event listener must be a function");
-    return new kt(this, t, e, i);
+    return new xt(this, t, e, i);
   }
   add(t, e) {
     const i = this.#t.get(t) ?? /* @__PURE__ */ new Set();
@@ -786,15 +843,15 @@ class Pt {
       throw new AggregateError(n, `Event '${t}' listeners failed`);
   }
 }
-class Lt {
+class Vt {
   #t;
   root;
   view;
   constructor(t, e) {
-    this.root = F(t), this.#t = new q(() => et(this.root), e), this.view = this.#t.view;
+    this.root = _(t), this.#t = new q(() => rt(this.root), e), this.view = this.#t.view;
   }
   createNode(t) {
-    return F(t);
+    return _(t);
   }
   attach(t, e) {
     if (t.children.has(e)) throw new Error("Lifetime diagnostic node is attached");
@@ -815,7 +872,7 @@ class Lt {
     this.root.phase !== "disposed" && (this.root.phase = "disposed", this.#t.invalidate(), this.#t.dispose());
   }
 }
-function F(r) {
+function _(r) {
   return {
     label: r,
     phase: "active",
@@ -830,8 +887,8 @@ function F(r) {
     children: /* @__PURE__ */ new Set()
   };
 }
-function et(r) {
-  const t = Object.freeze([...r.children].map(et));
+function rt(r) {
+  const t = Object.freeze([...r.children].map(rt));
   return Object.freeze({
     label: r.label,
     phase: r.phase,
@@ -839,14 +896,18 @@ function et(r) {
     children: t
   });
 }
-function zt(r) {
-  if (!r || typeof r != "object") return !1;
-  const t = r;
-  return [t.debug, t.info, t.warn, t.error].every(
-    (e) => typeof e == "function"
-  );
+function Mt(r) {
+  if (!r || typeof r != "object" && typeof r != "function") return !1;
+  try {
+    const t = r;
+    return [t.debug, t.info, t.warn, t.error].every(
+      (e) => typeof e == "function"
+    );
+  } catch {
+    return !1;
+  }
 }
-const R = Object.freeze(new DOMException("Resource disposed", "AbortError"));
+const x = Object.freeze(new DOMException("Resource disposed", "AbortError"));
 class w {
   #t = /* @__PURE__ */ new Set();
   #e;
@@ -885,7 +946,7 @@ class w {
     return this.#t[Symbol.iterator]();
   }
 }
-class Rt {
+class qt {
   #t;
   constructor(t, e) {
     this.#t = { phase: "active", cleanup: t, detachFromParent: e }, Object.freeze(this);
@@ -905,11 +966,11 @@ class Rt {
     });
     return this.#t = { phase: "disposing", completion: e }, e;
   }
-  [j]() {
+  [k]() {
     return this.dispose();
   }
 }
-class Nt {
+class Bt {
   #t;
   #e;
   #i;
@@ -922,7 +983,7 @@ class Nt {
       () => this.#s(),
       (a) => {
         try {
-          J(n.signal, a) || i(a);
+          tt(n.signal, a) || i(a);
         } finally {
           this.#s();
         }
@@ -940,9 +1001,9 @@ class Nt {
       () => {
       }
     );
-    return this.#i = { phase: "disposing", completion: e }, t.controller.abort(R), this.#n(), e;
+    return this.#i = { phase: "disposing", completion: e }, t.controller.abort(x), this.#n(), e;
   }
-  [j]() {
+  [k]() {
     return this.dispose();
   }
   #s() {
@@ -956,15 +1017,15 @@ class Nt {
     this.#t = void 0, t?.();
   }
 }
-class D {
+class B {
   #t;
   #e;
   #i;
   #s;
   #n;
-  #o;
-  #r;
   #a;
+  #r;
+  #o;
   #d;
   #f;
   #l;
@@ -972,7 +1033,7 @@ class D {
   handle;
   #h;
   constructor(t, e, i = {}) {
-    this.#e = e, this.handle = new xt(this);
+    this.#e = e, this.handle = new Ft(this);
     const s = new AbortController();
     this.#h = {
       phase: "active",
@@ -981,14 +1042,14 @@ class D {
     };
     const n = i.parent;
     this.#u = n?.detach, this.#f = n ? "child" : "root";
-    const o = n?.diagnostics ?? new Lt(e, (l) => t.report(l)), a = n?.diagnosticNode ?? o.root;
+    const o = n?.diagnostics ?? new Vt(e, (l) => t.report(l)), a = n?.diagnosticNode ?? o.root;
     this.#t = { port: t, diagnostics: o, diagnosticNode: a };
     const h = (l) => ({
       diagnostics: o,
       node: a,
       kind: l
     });
-    this.#i = new w(h("listeners")), this.#s = new w(h("contributions")), this.#n = new w(h("contributionViews")), this.#o = new w(h("subscriptions")), this.#r = new w(h("tasks")), this.#a = new w(), this.#d = new w(h("cleanups"));
+    this.#i = new w(h("listeners")), this.#s = new w(h("contributions")), this.#n = new w(h("contributionViews")), this.#a = new w(h("subscriptions")), this.#r = new w(h("tasks")), this.#o = new w(), this.#d = new w(h("cleanups"));
     const c = i.parentSignal;
     if (!c) return;
     const d = () => s.abort(c.reason);
@@ -1001,7 +1062,7 @@ class D {
   get diagnostics() {
     return this.#c().diagnostics.view;
   }
-  /** A facade whose only Runtime edge disappears when this Lifetime terminates. */
+  /** A facade whose only InstanceCoordinator edge disappears when this Lifetime terminates. */
   contextLogger(t) {
     const e = (i) => (s, ...n) => this.#p().port.writeLog(i, s, t, n);
     return Object.freeze({
@@ -1013,29 +1074,29 @@ class D {
   }
   cleanup(t) {
     if (this.#c(), typeof t != "function") throw new TypeError("Cleanup must be a function");
-    const e = new Rt(t, this.#d.release);
+    const e = new qt(t, this.#d.release);
     return this.#d.add(e), e;
   }
   lifetime(t) {
     const { port: e, diagnostics: i, diagnosticNode: s } = this.#c();
-    Vt(t);
-    const n = i.createNode(t), o = new D(e, this.#e, {
+    Gt(t);
+    const n = i.createNode(t), o = new B(e, this.#e, {
       parentSignal: this.signal,
       declarations: this.#g(),
       parent: {
         diagnostics: i,
         diagnosticNode: n,
         detach: (a) => {
-          this.#a.release(a) && i.detach(s, n);
+          this.#o.release(a) && i.detach(s, n);
         }
       }
     });
-    return this.#a.add(o), i.attach(s, n), o.handle;
+    return this.#o.add(o), i.attach(s, n), o.handle;
   }
   spawn(t) {
     const { port: e } = this.#c();
     if (typeof t != "function") throw new TypeError("Background task must be a function");
-    const i = new Nt(
+    const i = new Bt(
       this.signal,
       t,
       (s) => e.report(s),
@@ -1044,7 +1105,12 @@ class D {
     return this.#r.add(i), i;
   }
   on(t, e) {
-    const { port: i } = this.#c(), s = i.stageOn(this.#e, t, e, this.#i.release);
+    const { port: i } = this.#c(), s = i.stageOn(
+      this.#e,
+      t,
+      e,
+      this.#i.release
+    );
     return this.#i.add(s), this.#g() === "published" && s.publish(), s.handle;
   }
   async emit(t, ...e) {
@@ -1063,7 +1129,7 @@ class D {
   }
   /** Owns an internal live capability without exposing a second Context API. */
   ownLease(t, e) {
-    return this.#c(), (e === "view" ? this.#n : this.#o).own(t);
+    return this.#c(), (e === "view" ? this.#n : this.#a).own(t);
   }
   /** Releases a temporary startup cancellation edge after its layer commits. */
   detachStartupSignal() {
@@ -1073,11 +1139,11 @@ class D {
   /** Atomically makes all declarations staged during setup visible. */
   publish() {
     const t = this.#h;
-    if (t.phase !== "active") throw y();
+    if (t.phase !== "active") throw E();
     if (this.#c(), t.declarations !== "published") {
       for (const e of this.#i) e.publish();
       for (const e of this.#s) e.publish();
-      for (const e of this.#a) e.publish();
+      for (const e of this.#o) e.publish();
       this.#h = { ...t, declarations: "published" };
     }
   }
@@ -1087,10 +1153,10 @@ class D {
     if (t.phase === "disposed") return Promise.resolve();
     const e = this.#p(), i = Promise.resolve().then(async () => {
       const s = [];
-      if (await this.#i.dispose(s), await this.#s.dispose(s), await this.#o.dispose(s), await this.#n.dispose(s), t.controller.abort(R), this.detachStartupSignal(), await this.#r.dispose(s), await this.#a.dispose(s), await this.#d.dispose(s), s.length === 1) throw s[0];
+      if (await this.#i.dispose(s), await this.#s.dispose(s), await this.#a.dispose(s), await this.#n.dispose(s), t.controller.abort(x), this.detachStartupSignal(), await this.#r.dispose(s), await this.#o.dispose(s), await this.#d.dispose(s), s.length === 1) throw s[0];
       if (s.length > 1) throw new AggregateError(s, "Lifetime cleanup failed");
     }).finally(() => {
-      this.#h = { phase: "disposed", signal: AbortSignal.abort(R) };
+      this.#h = { phase: "disposed", signal: AbortSignal.abort(x) };
       const s = this.#u;
       this.#u = void 0;
       try {
@@ -1101,27 +1167,27 @@ class D {
     });
     return this.#h = { phase: "disposing", controller: t.controller, completion: i }, e.diagnostics.beginDisposing(e.diagnosticNode), i;
   }
-  [j]() {
+  [k]() {
     return this.dispose();
   }
   #c() {
     const t = this.#t;
     if (this.#h.phase !== "active" || this.signal.aborted || !t)
-      throw y();
+      throw E();
     return t;
   }
   #p() {
     const t = this.#t;
-    if (!t) throw y();
+    if (!t) throw E();
     return t;
   }
   #g() {
     const t = this.#h;
-    if (t.phase !== "active") throw y();
+    if (t.phase !== "active") throw E();
     return t.declarations;
   }
 }
-class xt {
+class Ft {
   #t;
   constructor(t) {
     this.#t = t, Object.freeze(this);
@@ -1150,32 +1216,32 @@ class xt {
   dispose() {
     return this.#t.dispose();
   }
-  [j]() {
+  [k]() {
     return this.dispose();
   }
 }
-function Vt(r) {
+function Gt(r) {
   if (typeof r != "string" || !r.trim())
     throw new TypeError("Lifetime label must be a non-empty string");
   if (r !== r.trim())
     throw new TypeError("Lifetime label cannot start or end with whitespace");
 }
-function y() {
+function E() {
   return new u("LIFETIME_DISPOSED", "Lifetime is disposing or has been disposed");
 }
-class N extends AggregateError {
+class D extends AggregateError {
 }
-class Mt {
+class Ut {
   #t;
   #e;
   #i;
   #s;
   #n = /* @__PURE__ */ new Map();
-  #o = new Pt();
+  #a = new Dt();
   #r;
-  #a = [];
+  #o = [];
   constructor(t) {
-    this.#t = t.hostName, this.#e = t.logger, this.#i = t.isInstalled, this.#s = t.report, this.#r = new At(t.report);
+    this.#t = t.hostName, this.#e = t.logger, this.#i = t.isInstalled, this.#s = t.report, this.#r = new Lt(t.report);
   }
   readService(t, e) {
     const i = this.#n.get(t);
@@ -1193,13 +1259,13 @@ class Mt {
     return e;
   }
   resetActivationState() {
-    this.#n.clear(), this.#a = [];
+    this.#n.clear(), this.#o = [];
   }
   commitActivationOrder(t) {
-    this.#a = t.slice();
+    this.#o = t.slice();
   }
   deactivateAll() {
-    return this.deactivate(new Set(this.#a));
+    return this.deactivate(new Set(this.#o));
   }
   async activate(t, e, i, s) {
     const n = this.#c(s);
@@ -1211,7 +1277,7 @@ class Mt {
       const h = new AbortController(), c = await Promise.allSettled(
         a.map(async (f) => {
           try {
-            const p = i.has(f) ? i.get(f) : await X(
+            const p = i.has(f) ? i.get(f) : await et(
               f.declaration.plugin.config,
               f.declaration.config,
               f.id
@@ -1227,12 +1293,12 @@ class Mt {
             throw h.abort(p), p;
           }
         })
-      ), d = qt(c, h.signal), l = c.filter(
+      ), d = _t(c, h.signal), l = c.filter(
         (f) => f.status === "fulfilled"
       ).map((f) => f.value);
       if (d.length) {
         const f = await this.#l(l), p = d.length === 1 ? d[0] : new AggregateError(d, "Installation startup layer failed");
-        throw f.length ? new N(
+        throw f.length ? new D(
           [p, ...f],
           "Installation startup layer failed and could not be cleanly disposed"
         ) : p;
@@ -1241,8 +1307,8 @@ class Mt {
     }
   }
   async deactivate(t) {
-    const e = [], i = this.#a.filter((s) => t.has(s)).reverse();
-    this.#a = this.#a.filter(
+    const e = [], i = this.#o.filter((s) => t.has(s)).reverse();
+    this.#o = this.#o.filter(
       (s) => !t.has(s)
     );
     for (const s of i) {
@@ -1285,7 +1351,7 @@ class Mt {
   }
   async #d(t, e, i, s, n) {
     e.deactivate();
-    const o = e.declaration.plugin, a = new D(n, e.id, { parentSignal: s });
+    const o = e.declaration.plugin, a = new B(n, e.id, { parentSignal: s });
     try {
       const h = this.#u(t, e, o, a), c = Object.freeze({
         hostName: this.#t,
@@ -1293,13 +1359,13 @@ class Mt {
         installationId: e.id,
         groupId: e.groupId
       }), d = this.#h(a, c, h), l = await o.setup(d, i), f = /* @__PURE__ */ new Map();
-      for (const [p, st] of Object.entries(o.provides ?? {})) {
+      for (const [p, ot] of Object.entries(o.provides ?? {})) {
         if (typeof l != "object" || l === null || !Object.hasOwn(l, p))
           throw new u(
             "SERVICE_NOT_RETURNED",
             `Installation '${e.id}' did not return provided Service '${p}'`
           );
-        f.set(st.id, l[p]);
+        f.set(ot.id, l[p]);
       }
       return Object.freeze({
         installation: e,
@@ -1311,7 +1377,7 @@ class Mt {
       try {
         await a.dispose();
       } catch (d) {
-        throw new N(
+        throw new D(
           [c, d],
           `Installation '${e.id}' failed to start and could not be cleanly disposed`
         );
@@ -1321,7 +1387,7 @@ class Mt {
   }
   #f(t) {
     for (const { installation: e, instance: i, services: s } of t)
-      this.#n.set(e, s), e.activate(i), this.#a.push(e);
+      this.#n.set(e, s), e.activate(i), this.#o.push(e);
     for (const { instance: e } of t)
       e.lifetime.publish(), e.lifetime.detachStartupSignal();
   }
@@ -1384,18 +1450,23 @@ class Mt {
       stageOn: (e, i, s, n) => this.#p(e, i, s, n, t),
       emit: (e, i, s) => this.#g(e, i, s, t),
       stageContribution: (e, i, s, n, o) => this.#v(e, i, s, n, o, t),
-      writeLog: (e, i, s, n) => this.#e[e](i, s, ...n),
+      writeLog: (e, i, s, n) => {
+        P(
+          this.#e[e](i, s, ...n),
+          "Logger methods must be synchronous"
+        );
+      },
       report: this.#s
     };
   }
   #p(t, e, i, s, n) {
-    return this.#w(t), b(e, "event"), n.remember(e), this.#o.stage(e.id, i, s);
+    return this.#w(t), m(e, "event"), n.remember(e), this.#a.stage(e.id, i, s);
   }
   #g(t, e, i, s) {
-    return this.#w(t), b(e, "event"), s.remember(e), this.#o.emit(e.id, i);
+    return this.#w(t), m(e, "event"), s.remember(e), this.#a.emit(e.id, i);
   }
   #v(t, e, i, s, n, o) {
-    return this.#w(t), b(e, "extensionPoint"), o.remember(e), this.#r.get(e).stage(t, i, s, n);
+    return this.#w(t), m(e, "extensionPoint"), o.remember(e), this.#r.get(e).stage(t, i, s, n);
   }
   #b(t, e) {
     return this.#r.get(t).view((i, s) => e.ownLease(i, s));
@@ -1405,27 +1476,27 @@ class Mt {
       throw new Error(`Installation '${t}' is not installed`);
   }
 }
-function qt(r, t) {
+function _t(r, t) {
   const e = [];
   let i = !1;
   for (const s of r)
-    s.status !== "fulfilled" && (Object.is(s.reason, t.reason) ? (i || e.push(s.reason), i = !0) : J(t, s.reason) || e.push(s.reason));
+    s.status !== "fulfilled" && (Object.is(s.reason, t.reason) ? (i || e.push(s.reason), i = !0) : tt(t, s.reason) || e.push(s.reason));
   return e;
 }
-class Dt {
-  #t = new dt();
+class Ht {
+  #t = new gt();
   #e;
   #i;
   constructor(t) {
-    this.#e = new Mt(t);
+    this.#e = new Ut(t);
   }
   get hasCommittedPlan() {
     return this.#i !== void 0;
   }
   get(t, e) {
-    const i = ot(t), s = i ? t.service : t;
-    if (b(s, "service"), this.#t.assertCompatible(s), e === "unavailable") throw U();
-    const n = this.#a().provider(s.id);
+    const i = ht(t), s = i ? t.service : t;
+    if (m(s, "service"), this.#t.assertCompatible(s), e === "unavailable") throw H();
+    const n = this.#o().provider(s.id);
     if (!n) {
       if (i) return;
       throw new u("SERVICE_UNAVAILABLE", `Service '${s.id}' is not active`);
@@ -1438,7 +1509,7 @@ class Dt {
     return o.value;
   }
   contributions(t) {
-    return b(t, "extensionPoint"), this.#t.remember(t), this.#e.contributions(t);
+    return m(t, "extensionPoint"), this.#t.remember(t), this.#e.contributions(t);
   }
   buildPlan(t) {
     return M.build(t, this.#t.kinds);
@@ -1452,12 +1523,14 @@ class Dt {
     }
   }
   async stop() {
-    const t = await this.#e.withContributionBatch(() => this.#e.deactivateAll());
+    const t = await this.#e.withContributionBatch(
+      () => this.#e.deactivateAll()
+    );
     return this.#i = void 0, t;
   }
   async transition(t, e, i) {
     return this.#e.withContributionBatch(async () => {
-      const s = this.#a(), n = s.affectedByTransitionTo(t, e);
+      const s = this.#o(), n = s.affectedByTransitionTo(t, e);
       let o, a;
       try {
         o = await this.#r(
@@ -1477,11 +1550,11 @@ class Dt {
         return await this.#e.activate(t, n, o, a), a.commit(), this.#e.commitActivationOrder(t.order), this.#i = t, Object.freeze({ kind: "committed", affected: n });
       } catch (d) {
         const l = await this.#e.deactivate(n);
-        return a.discard(), d instanceof N || l.length ? this.#n(
+        return a.discard(), d instanceof D || l.length ? this.#n(
           i,
           [d, ...l],
           "Installation change failed and its partial activation could not be cleanly disposed"
-        ) : this.#o(i, s, n, h, [
+        ) : this.#a(i, s, n, h, [
           d,
           ...l
         ]);
@@ -1503,7 +1576,7 @@ class Dt {
     const s = await this.#e.deactivateAll();
     throw this.#i = void 0, new AggregateError([...e, ...s], i);
   }
-  async #o(t, e, i, s, n) {
+  async #a(t, e, i, s, n) {
     t();
     const o = this.#t.draft(e.contractKinds);
     try {
@@ -1524,7 +1597,7 @@ class Dt {
       try {
         e.set(
           i,
-          await X(
+          await et(
             i.declaration.plugin.config,
             i.declaration.config,
             i.id
@@ -1539,15 +1612,15 @@ class Dt {
       }
     return e;
   }
-  #a() {
-    if (!this.#i) throw U();
+  #o() {
+    if (!this.#i) throw H();
     return this.#i;
   }
 }
-function U() {
+function H() {
   return new u("SERVICE_UNAVAILABLE", "Host services are not active");
 }
-class Gt {
+class Kt {
   #t;
   #e;
   #i;
@@ -1592,28 +1665,31 @@ class Gt {
       name: this.#t,
       status: t,
       revision: this.#s,
-      installations: new S(s),
-      groups: new S(n)
+      installations: new O(s),
+      groups: new O(n)
     });
   }
 }
-function k(r, t, e = {}) {
+function L(r, t, e = {}) {
   if (!r || typeof r != "object" || Array.isArray(r))
-    throw E(e, `${t} must be a plain record`);
+    throw b(e, `${t} must be a plain record`);
   const i = Object.getPrototypeOf(r);
   if (i !== Object.prototype && i !== null)
-    throw E(e, `${t} must be a plain record`);
+    throw b(e, `${t} must be a plain record`);
   for (const s of Reflect.ownKeys(r)) {
-    if (typeof s != "string" || !Object.prototype.propertyIsEnumerable.call(r, s))
-      throw E(e, `${t} keys must be enumerable strings`);
+    const n = Reflect.getOwnPropertyDescriptor(r, s);
+    if (typeof s != "string" || !n?.enumerable)
+      throw b(e, `${t} keys must be enumerable strings`);
+    if (!("value" in n))
+      throw b(e, `${t} field '${s}' must be a data property`);
     if (e.fields && !e.fields.has(s))
-      throw E(e, `${t}: unknown field '${s}'`);
+      throw b(e, `${t}: unknown field '${s}'`);
   }
 }
-function E(r, t) {
+function b(r, t) {
   return r.createError?.(t) ?? new TypeError(t);
 }
-const Bt = /* @__PURE__ */ new Set([
+const Wt = /* @__PURE__ */ new Set([
   "signal",
   "meta",
   "log",
@@ -1623,12 +1699,12 @@ const Bt = /* @__PURE__ */ new Set([
   "on",
   "emit",
   "contribute"
-]), Ft = /* @__PURE__ */ new Set(["name", "config", "requires", "provides", "setup"]);
-function pe(r) {
-  return it(r);
+]), Yt = /* @__PURE__ */ new Set(["name", "config", "requires", "provides", "setup"]);
+function ve(r) {
+  return nt(r);
 }
-function it(r) {
-  Ut(r);
+function nt(r) {
+  Qt(r);
   const t = Object.hasOwn(r, "name") ? r.name : void 0, e = Object.hasOwn(r, "config") ? r.config : void 0, i = Object.hasOwn(r, "requires") ? r.requires : void 0, s = Object.hasOwn(r, "provides") ? r.provides : void 0, n = Object.hasOwn(r, "setup") ? r.setup : void 0;
   if (typeof t != "string" || !t.trim())
     throw new TypeError("Plugin name must be a non-empty string");
@@ -1636,15 +1712,15 @@ function it(r) {
     throw new TypeError("Plugin name cannot start or end with whitespace");
   if (typeof n != "function")
     throw new TypeError(`Plugin '${t}' must define setup()`);
-  if (e !== void 0 && !_t(e))
+  if (e !== void 0 && !Jt(e))
     throw new TypeError(`Plugin '${t}' config must implement Standard Schema V1`);
-  _(i, t, "requires"), _(s, t, "provides");
+  K(i, t, "requires"), K(s, t, "provides");
   const o = i ? Object.freeze({ ...i }) : void 0, a = s ? Object.freeze({ ...s }) : void 0, h = /* @__PURE__ */ new Map();
   for (const [c, d] of Object.entries(o ?? {})) {
     if (!c.trim()) throw new TypeError("Plugin requirement alias cannot be empty");
     if (c !== c.trim())
       throw new TypeError("Plugin requirement alias cannot start or end with whitespace");
-    if (Bt.has(c))
+    if (Wt.has(c))
       throw new TypeError(`Plugin requirement '${c}' conflicts with the context API`);
     if (!d || typeof d != "object")
       throw new TypeError(`Plugin requirement '${c}' is not a contract`);
@@ -1653,7 +1729,7 @@ function it(r) {
         throw new TypeError(`Optional requirement '${c}' must wrap a Service`);
     } else if (!v(d, "service") && !v(d, "extensionPoint"))
       throw new TypeError(`Plugin requirement '${c}' must be a Service or ExtensionPoint`);
-    H(
+    W(
       t,
       h,
       "requirement",
@@ -1667,7 +1743,7 @@ function it(r) {
       throw new TypeError("Plugin provision alias cannot start or end with whitespace");
     if (!v(d, "service"))
       throw new TypeError(`Plugin provision '${c}' must be a Service`);
-    H(t, h, "provision", c, d);
+    W(t, h, "provision", c, d);
   }
   return Object.freeze({
     name: t,
@@ -1677,20 +1753,20 @@ function it(r) {
     setup: n
   });
 }
-function Ut(r) {
-  k(r, "Plugin declaration", { fields: Ft });
+function Qt(r) {
+  L(r, "Plugin declaration", { fields: Yt });
 }
-function _t(r) {
+function Jt(r) {
   if (!r || typeof r != "object" && typeof r != "function") return !1;
   const t = r["~standard"];
   if (!t || typeof t != "object") return !1;
   const e = t;
   return e.version === 1 && typeof e.vendor == "string" && typeof e.validate == "function";
 }
-function _(r, t, e) {
-  r !== void 0 && k(r, `Plugin '${t}' ${e}`);
+function K(r, t, e) {
+  r !== void 0 && L(r, `Plugin '${t}' ${e}`);
 }
-function H(r, t, e, i, s) {
+function W(r, t, e, i, s) {
   const n = t.get(s.id);
   if (!n) {
     t.set(s.id, { alias: i, kind: s.kind, role: e });
@@ -1698,38 +1774,49 @@ function H(r, t, e, i, s) {
   }
   if (n.kind !== s.kind)
     throw new TypeError(
-      `Plugin '${r}' uses Contract '${s.id}' as both ${L(n.kind)} and ${L(s.kind)}`
+      `Plugin '${r}' uses Contract '${s.id}' as both ${R(n.kind)} and ${R(s.kind)}`
     );
-  const o = L(s.kind);
+  const o = R(s.kind);
   throw n.role !== e ? new TypeError(
     `Plugin '${r}' cannot both require and provide ${o} '${s.id}'`
   ) : new TypeError(
     `Plugin '${r}' ${e} aliases '${n.alias}' and '${i}' reference the same ${o} '${s.id}'`
   );
 }
-function L(r) {
+function R(r) {
   return r === "extensionPoint" ? "ExtensionPoint" : r === "event" ? "Event" : "Service";
 }
-function K(r) {
-  return it(r);
+function Y(r) {
+  return nt(r);
+}
+const Xt = /* @__PURE__ */ new Set(["plugin", "config"]), I = /* @__PURE__ */ new WeakMap();
+function Zt(r, t) {
+  I.get(r)?.discard(t);
 }
-const Ht = /* @__PURE__ */ new Set(["plugin", "config"]), x = /* @__PURE__ */ new WeakMap();
-function Kt(r, t) {
-  x.get(r)?.(t);
+function te(r, t, e, i) {
+  const s = I.get(r);
+  if (!s) throw new Error("ChangeSet draft control has been released");
+  return s.install(t, e, i);
 }
-class Wt {
+class ee {
   #t = /* @__PURE__ */ new Map();
   #e;
   constructor(t) {
-    this.#e = { phase: "open", port: t }, x.set(this, (e) => this.#i(e)), Object.freeze(this);
+    this.#e = { phase: "open", port: t }, I.set(this, {
+      discard: (e) => this.#s(e),
+      install: (e, i, s) => this.#i(e, i, s)
+    }), Object.freeze(this);
   }
   install(t, ...e) {
-    const i = this.#n(), s = K(t), n = i.create(s, e[0]);
-    return this.#s({ kind: "install", installation: n.record }), n.publicInstallation;
+    return this.#i(t, e[0]);
+  }
+  #i(t, e, i) {
+    const s = this.#a(), n = Y(t), o = (i ?? s.create)(n, e);
+    return this.#n({ kind: "install", installation: o.record }), o.facade;
   }
   update(t, e) {
-    const i = this.#n();
-    k(e, "Installation update", { fields: Ht });
+    const i = this.#a();
+    L(e, "Installation update", { fields: Xt });
     const s = Object.hasOwn(e, "plugin"), n = Object.hasOwn(e, "config");
     if (!s && !n)
       throw new TypeError("Installation update must include 'plugin' or 'config'");
@@ -1738,16 +1825,16 @@ class Wt {
     if (s) {
       const d = e.plugin;
       if (!d) throw new TypeError("Installation update 'plugin' must be a Plugin");
-      a = K(d);
+      a = Y(d);
     }
     let h;
     a && n ? h = { kind: "plugin-and-config", plugin: a, config: e.config } : a ? h = { kind: "plugin", plugin: a } : h = { kind: "config", config: e.config };
     const c = { kind: "update", installation: o, declaration: h };
-    this.#s(c);
+    this.#n(c);
   }
   remove(t) {
-    const e = this.#n();
-    this.#s({ kind: "remove", installation: e.resolve(t) });
+    const e = this.#a();
+    this.#n({ kind: "remove", installation: e.resolve(t) });
   }
   commit() {
     const t = this.#e;
@@ -1764,7 +1851,7 @@ class Wt {
     } catch (n) {
       for (const o of e)
         o.kind === "install" && i.discard(o.installation, n);
-      return this.#o(Promise.reject(n));
+      return this.#r(Promise.reject(n));
     }
     let s;
     try {
@@ -1772,38 +1859,38 @@ class Wt {
     } catch (n) {
       s = Promise.reject(n);
     }
-    return this.#o(s);
+    return this.#r(s);
   }
-  #i(t) {
+  #s(t) {
     const e = this.#e;
     if (e.phase !== "open") return;
     this.#e = { phase: "discarded" };
     const i = [...this.#t.values()];
-    this.#r();
+    this.#o();
     for (const s of i)
       s.kind === "install" && e.port.discard(s.installation, t);
   }
-  #s(t) {
+  #n(t) {
     if (this.#t.has(t.installation))
       throw new TypeError(
         `Installation '${t.installation.id}' can only appear once in the same ChangeSet`
       );
     this.#t.set(t.installation, Object.freeze(t));
   }
-  #n() {
+  #a() {
     const t = this.#e;
     if (t.phase !== "open")
       throw new TypeError(`Cannot modify a ${t.phase} ChangeSet`);
     return t.port;
   }
-  #o(t) {
-    return this.#e = { phase: "submitted", promise: t }, this.#r(), t;
+  #r(t) {
+    return this.#e = { phase: "submitted", promise: t }, this.#o(), t;
   }
-  #r() {
-    this.#t.clear(), x.delete(this);
+  #o() {
+    this.#t.clear(), I.delete(this);
   }
 }
-class Yt {
+class ie {
   #t;
   constructor(t, e, i) {
     this.#t = { phase: "open", draft: t, discard: e, normalize: i };
@@ -1814,7 +1901,7 @@ class Yt {
   requireDraft() {
     const t = this.#t;
     if (t.phase === "failed") throw t.error;
-    if (t.phase === "sealed") throw z();
+    if (t.phase === "sealed") throw N();
     return t.draft;
   }
   assertOpen() {
@@ -1823,7 +1910,7 @@ class Yt {
   fail(t) {
     const e = this.#t;
     if (e.phase === "failed") return e.error;
-    if (e.phase === "sealed") throw z();
+    if (e.phase === "sealed") throw N();
     const i = e.normalize(t);
     return this.#t = {
       phase: "failed",
@@ -1835,7 +1922,7 @@ class Yt {
   seal() {
     const t = this.#t;
     if (t.phase === "failed") throw t.error;
-    if (t.phase === "sealed") throw z();
+    if (t.phase === "sealed") throw N();
     return this.#t = { phase: "sealed" }, t.draft;
   }
   discard(t) {
@@ -1845,10 +1932,10 @@ class Yt {
     this.#t = { phase: "sealed" }, e.discard(e.draft, i);
   }
 }
-function z() {
+function N() {
   return new Error("Group configuration has been sealed");
 }
-class I {
+class A {
   constructor(t, e, i) {
     this.id = t, this.name = e, this.#e = { phase: "attached", parent: i };
   }
@@ -1857,7 +1944,7 @@ class I {
   #t = /* @__PURE__ */ new Map();
   #e;
   static root(t) {
-    return new I("/", t, void 0);
+    return new A("/", t, void 0);
   }
   get attached() {
     return this.#e.phase !== "detached";
@@ -1870,9 +1957,9 @@ class I {
     return t.phase === "detached" ? void 0 : t.parent;
   }
   create(t) {
-    if (this.assertAttached(), Qt(t), this.#t.has(t))
+    if (this.assertAttached(), se(t), this.#t.has(t))
       throw new TypeError(`Group '${this.#i(t)}' already exists`);
-    const e = new I(this.#i(t), t, this);
+    const e = new A(this.#i(t), t, this);
     return this.#t.set(t, e), e;
   }
   contains(t) {
@@ -1904,14 +1991,14 @@ class I {
     return this.id === "/" ? `/${t}` : `${this.id}/${t}`;
   }
 }
-function Qt(r) {
+function se(r) {
   if (typeof r != "string" || !r.trim())
     throw new TypeError("Group name must be a non-empty string");
   if (r !== r.trim())
     throw new TypeError("Group name cannot start or end with whitespace");
   if (r.includes("/")) throw new TypeError("Group name cannot contain '/'");
 }
-class W {
+class Q {
   constructor(t, e, i) {
     this.node = t, this.#t = { phase: e }, this.#e = i;
   }
@@ -1962,11 +2049,11 @@ class W {
     return e.phase === "pending" && e.attempt === t;
   }
 }
-function A(r) {
+function T(r) {
   return new u("GROUP_REMOVED", `Group '${r.id}' has been removed`);
 }
 const C = /* @__PURE__ */ new WeakMap();
-class Jt {
+class re {
   #t;
   #e;
   constructor(t, e, i) {
@@ -1992,11 +2079,16 @@ class Jt {
   }
   ready() {
     const t = this.#e;
-    return t.phase === "revoked" ? Promise.reject(A(this.#t)) : t.coordinator.ready(this.#t);
+    return t.phase === "revoked" ? Promise.reject(T(this.#t)) : t.coordinator.ready(this.#t);
   }
   install(t, ...e) {
     const i = this.#e;
-    return i.phase === "configuring" ? i.configuration.requireDraft().install(t, ...e) : this.#i().install(this.#t, t, ...e);
+    return i.phase === "configuring" ? i.coordinator.stageConfigurationInstall(
+      this.#t,
+      i.configuration,
+      t,
+      ...e
+    ) : this.#i().install(this.#t, t, ...e);
   }
   change() {
     if (this.#e.phase === "configuring")
@@ -2020,19 +2112,19 @@ class Jt {
   }
   #i() {
     const t = this.#e;
-    if (t.phase === "revoked") throw A(this.#t);
+    if (t.phase === "revoked") throw T(this.#t);
     return t.coordinator;
   }
 }
-class Xt {
+class ne {
   root;
   #t;
   #e = /* @__PURE__ */ new WeakMap();
   #i = /* @__PURE__ */ new WeakMap();
   constructor(t, e) {
-    this.root = I.root(t), this.#t = e, this.#i.set(
+    this.root = A.root(t), this.#t = e, this.#i.set(
       this.root,
-      new W(this.root, "established", () => e.notifyChanged())
+      new Q(this.root, "established", () => e.notifyChanged())
     );
   }
   nodes() {
@@ -2040,10 +2132,18 @@ class Xt {
   }
   install(t, e, ...i) {
     const s = this.change(t), n = s.install(e, ...i);
-    return Y(s.commit()), n;
+    return J(s.commit()), n;
+  }
+  stageConfigurationInstall(t, e, i, ...s) {
+    return this.#r(t), te(
+      e.requireDraft(),
+      i,
+      s[0],
+      (n, o) => (this.#r(t), this.#t.createDraft(t, n, o))
+    );
   }
   change(t, e = "immediate") {
-    return this.#r(t), new Wt({
+    return this.#r(t), new ee({
       create: (i, s) => (this.#r(t), this.#t.createDraft(t, i, s)),
       resolve: (i) => {
         this.#r(t);
@@ -2057,7 +2157,7 @@ class Xt {
         this.#r(t);
         const s = this.#t.executeChanges(t, i);
         for (const n of i) n.installation.trackReadiness(s);
-        return i.length && e === "immediate" && this.#o(t, s), s;
+        return i.length && e === "immediate" && this.#a(t, s), s;
       },
       attach: (i) => {
         this.#r(t), this.#t.attachInstallation(i);
@@ -2068,33 +2168,33 @@ class Xt {
   create(t, e, i, s) {
     if (typeof i != "function") throw new TypeError("Group configure must be a function");
     const n = t.create(e);
-    this.#i.set(n, new W(n, "new", () => this.#t.notifyChanged()));
-    const o = s === void 0, a = s ?? new Yt(
+    this.#i.set(n, new Q(n, "new", () => this.#t.notifyChanged()));
+    const o = s === void 0, a = s ?? new ie(
       this.change(n, "deferred"),
-      Kt,
+      Zt,
       (c) => $(
         c,
         "GROUP_UNAVAILABLE",
         `Group '${n.id}' configuration failed with a non-Error value`
       )
-    ), h = new Jt(this, n, a);
+    ), h = new re(this, n, a);
     this.#e.set(n, h);
     try {
       const c = i(h);
-      te(c) && Zt(c);
+      P(c, "Group configure must be synchronous");
       const d = a.failure;
       if (d) throw d;
     } catch (c) {
       const d = a.fail(c), l = n.walk();
-      throw n.detach(), this.#a(l), o && a.discard(d), this.#t.notifyChanged(), d;
+      throw n.detach(), this.#o(l), o && a.discard(d), this.#t.notifyChanged(), d;
     }
     if (o) {
       const c = a.seal().commit();
       for (const d of n.walk()) {
         const l = this.#e.get(d);
-        l && C.get(l)?.finishConfiguration(), this.#o(d, c);
+        l && C.get(l)?.finishConfiguration(), this.#a(d, c);
       }
-      Y(c);
+      J(c);
     }
     return this.#t.notifyChanged(), h;
   }
@@ -2110,15 +2210,15 @@ class Xt {
     if (t === this.root) throw new TypeError("The root Group cannot be removed");
     return t.attached ? this.#t.runExclusive(async () => {
       if (!t.attached) {
-        this.#a([t]);
+        this.#o([t]);
         return;
       }
       const e = t.walk(), i = this.#s(t).map((s) => ({
         kind: "remove",
         installation: s
       }));
-      await this.#t.removeInstallations(i), t.detach(), this.#a(e), this.#t.notifyChanged();
-    }) : (this.#a([t]), Promise.resolve());
+      await this.#t.removeInstallations(i), t.detach(), this.#o(e), this.#t.notifyChanged();
+    }) : (this.#o([t]), Promise.resolve());
   }
   #s(t) {
     return [...this.#t.installations()].filter(
@@ -2129,15 +2229,15 @@ class Xt {
     const e = this.#s(t);
     return e.some((i) => i.status === "failed") ? "failed" : e.some((i) => i.status === "stopping") ? "stopping" : e.length && e.every((i) => i.status === "active") ? "active" : e.length ? "pending" : "active";
   }
-  #o(t, e) {
+  #a(t, e) {
     this.#r(t).track(e);
   }
   #r(t) {
     const e = this.#i.get(t);
-    if (!t.attached || !e) throw A(t);
+    if (!t.attached || !e) throw T(t);
     return e;
   }
-  #a(t) {
+  #o(t) {
     for (const e of t) {
       this.#i.get(e)?.release(), this.#i.delete(e);
       const i = this.#e.get(e);
@@ -2145,21 +2245,14 @@ class Xt {
     }
   }
 }
-function Y(r) {
+function J(r) {
   Promise.resolve(r).catch(() => {
   });
 }
-function Zt(r) {
-  throw Promise.resolve(r).catch(() => {
-  }), new TypeError("Group configure must be synchronous");
-}
-function te(r) {
-  return r === null || typeof r != "object" && typeof r != "function" ? !1 : typeof r.then == "function";
-}
-function Q(r, t) {
+function X(r, t) {
   return Object.freeze({ plugin: r, config: t });
 }
-class ee {
+class oe {
   constructor(t, e, i, s) {
     this.id = t, this.index = e, this.groupId = i.id, this.#i = { declaration: s, group: i, notifyChanged: void 0 };
   }
@@ -2189,7 +2282,7 @@ class ee {
   get error() {
     const t = this.#t;
     if (t.phase === "failed")
-      return t.failure.retention === "live" ? t.failure.error : se(t.failure.summary);
+      return t.failure.retention === "live" ? t.failure.error : t.failure.summary.restore();
     if (t.phase === "removed")
       return new u("INSTALLATION_REMOVED", `Installation '${this.id}' has been removed`);
   }
@@ -2262,20 +2355,20 @@ class ee {
     this.#r({ phase: "pending" });
   }
   fail(t) {
-    return this.#o(t);
+    return this.#a(t);
   }
   discard(t) {
-    const e = this.#a(t);
+    const e = this.#o(t);
     this.#r({
       phase: "failed",
-      failure: { retention: "summary", summary: ie(e) },
+      failure: { retention: "summary", summary: new dt(e) },
       readiness: "settled"
     });
     for (const i of this.#s) i.reject(e);
     this.#s.clear(), this.#e = void 0, this.#i = void 0;
   }
-  #o(t) {
-    const e = this.#a(t);
+  #a(t) {
+    const e = this.#o(t);
     return this.#r({
       phase: "failed",
       failure: { retention: "live", error: e },
@@ -2288,7 +2381,7 @@ class ee {
   #r(t) {
     this.#t = t, this.#i?.notifyChanged?.();
   }
-  #a(t) {
+  #o(t) {
     return $(
       t,
       "INSTALLATION_UNAVAILABLE",
@@ -2301,23 +2394,12 @@ class ee {
     return t;
   }
 }
-function ie(r) {
-  return r instanceof u ? { category: "dougong", name: r.name, message: r.message, code: r.code } : {
-    category: r instanceof TypeError ? "typeError" : "error",
-    name: r.name,
-    message: r.message
-  };
-}
-function se(r) {
-  const t = r.category === "dougong" ? new u(r.code, r.message) : r.category === "typeError" ? new TypeError(r.message) : new Error(r.message);
-  return t.name = r.name, t;
-}
-const O = /* @__PURE__ */ new WeakMap();
-class re {
+const S = /* @__PURE__ */ new WeakMap();
+class ae {
   #t;
   #e = { phase: "draft" };
   constructor(t) {
-    this.#t = t, O.set(this, {
+    this.#t = t, S.set(this, {
       attach: (e, i) => {
         if (this.#e.phase !== "draft")
           throw new Error(`Installation '${this.#t.id}' control is already sealed`);
@@ -2362,7 +2444,7 @@ class re {
     );
   }
 }
-class ne {
+class ce {
   #t = /* @__PURE__ */ new Map();
   #e = /* @__PURE__ */ new WeakMap();
   #i = /* @__PURE__ */ new WeakMap();
@@ -2382,13 +2464,13 @@ class ne {
   }
   create(t, e, i) {
     t.assertAttached();
-    const s = ++this.#n, n = new ee(
+    const s = ++this.#n, n = new oe(
       `${e.name}:${s}`,
       s,
       t,
-      Q(e, i)
-    ), o = new re(n);
-    return this.#e.set(o, n), this.#i.set(n, o), { record: n, publicInstallation: o };
+      X(e, i)
+    ), o = new ae(n);
+    return this.#e.set(o, n), this.#i.set(n, o), { record: n, facade: o };
   }
   resolve(t) {
     const e = this.#e.get(t);
@@ -2398,7 +2480,7 @@ class ne {
   attach(t) {
     const e = this.#i.get(t);
     if (!e) throw new Error(`Installation '${t.id}' has no public facade`);
-    const i = O.get(e);
+    const i = S.get(e);
     if (!i) throw new Error(`Installation '${t.id}' has no draft control`);
     t.attach(this.#s.notifyChanged), i.attach(
       (s) => this.#s.update(t, e, s),
@@ -2425,37 +2507,36 @@ class ne {
         this.#t.set(e.installation.id, e.installation);
       else if (e.kind === "update") {
         const i = e.installation.declaration, s = e.declaration.kind === "config" ? i.plugin : e.declaration.plugin, n = e.declaration.kind === "plugin" ? i.config : e.declaration.config;
-        e.installation.replaceDeclaration(Q(s, n));
+        e.installation.replaceDeclaration(X(s, n));
       } else this.contains(e.installation) && this.#t.delete(e.installation.id);
   }
   settleChanges(t, e) {
     for (const i of t)
-      i.kind === "remove" ? (i.installation.remove(), i.installation.settleReady(), this.#o(i.installation)) : e || i.installation.deactivate();
+      i.kind === "remove" ? (i.installation.remove(), i.installation.settleReady(), this.#a(i.installation)) : e || i.installation.deactivate();
   }
   settleReadiness(t) {
     for (const e of t) e.settleReady();
   }
   discard(t, e) {
-    t.discard(e), this.#o(t);
+    t.discard(e), this.#a(t);
   }
   capture() {
-    return [...this.#t].map(([t, e]) => ({
-      id: t,
-      installation: e,
-      declaration: e.declaration
+    return [...this.#t.values()].map((t) => ({
+      installation: t,
+      declaration: t.declaration
     }));
   }
   restore(t) {
     this.#t.clear();
     for (const e of t)
-      e.installation.replaceDeclaration(e.declaration), this.#t.set(e.id, e.installation);
+      e.installation.replaceDeclaration(e.declaration), this.#t.set(e.installation.id, e.installation);
   }
-  #o(t) {
+  #a(t) {
     const e = this.#i.get(t);
-    e && (O.get(e)?.revoke(), O.delete(e)), this.#i.delete(t);
+    e && (S.get(e)?.revoke(), S.delete(e)), this.#i.delete(t);
   }
 }
-class oe {
+class he {
   #t = Promise.resolve();
   get settled() {
     return this.#t;
@@ -2472,8 +2553,8 @@ class oe {
     ), e;
   }
 }
-const ae = console, ce = /* @__PURE__ */ new Set(["name", "logger", "onError"]);
-class he {
+const de = console, le = /* @__PURE__ */ new Set(["name", "logger", "onError"]);
+class ue {
   name;
   diagnostics;
   #t;
@@ -2481,11 +2562,11 @@ class he {
   #i;
   #s;
   #n;
-  #o;
+  #a;
   #r = "idle";
-  #a = new oe();
+  #o = new he();
   constructor(t = {}) {
-    k(t, "Host options", { fields: ce });
+    L(t, "Host options", { fields: le });
     const e = Object.hasOwn(t, "name") ? t.name : void 0, i = Object.hasOwn(t, "logger") ? t.logger : void 0, s = Object.hasOwn(t, "onError") ? t.onError : void 0, n = e ?? "host";
     if (typeof n != "string" || !n.trim())
       throw new TypeError("Host name must be a non-empty string");
@@ -2493,9 +2574,9 @@ class he {
       throw new TypeError("Host name cannot start or end with whitespace");
     if (s !== void 0 && typeof s != "function")
       throw new TypeError("Host onError must be a function");
-    if (i !== void 0 && !zt(i))
+    if (i !== void 0 && !Mt(i))
       throw new TypeError("Host logger must implement debug/info/warn/error");
-    this.name = n, this.#i = i ?? ae, this.#n = s ?? ((o) => this.#i.error(o)), this.#t = new ne({
+    this.name = n, this.#i = i ?? de, this.#n = s ?? ((o) => this.#i.error(o)), this.#t = new ce({
       notifyChanged: () => this.#p(),
       update: (o, a, h) => {
         const c = this.#s.change(o.group);
@@ -2505,22 +2586,22 @@ class he {
         const h = this.#s.change(o.group);
         return h.remove(a), h.commit();
       }
-    }), this.#o = new Dt({
+    }), this.#a = new Ht({
       hostName: n,
       logger: this.#i,
       isInstalled: (o) => this.#t.has(o),
       report: (o) => this.#h(o)
-    }), this.#s = new Xt(n, {
+    }), this.#s = new ne(n, {
       installations: () => this.#t.values(),
       createDraft: (o, a, h) => this.#t.create(o, a, h),
       resolveInstallation: (o) => this.#t.resolve(o),
       executeChanges: (o, a) => this.#d(o, a),
       attachInstallation: (o) => this.#t.attach(o),
       discardInstallation: (o, a) => this.#t.discard(o, a),
-      runExclusive: (o) => this.#a.run(o),
+      runExclusive: (o) => this.#o.run(o),
       removeInstallations: (o) => this.#f(o),
       notifyChanged: () => this.#p()
-    }), this.#e = new Gt(
+    }), this.#e = new Kt(
       n,
       this.#s.nodes(),
       (o) => this.#h(o)
@@ -2531,10 +2612,10 @@ class he {
   }
   get(t) {
     const e = this.#r === "active" ? "available" : "unavailable";
-    return this.#o.get(t, e);
+    return this.#a.get(t, e);
   }
   contributions(t) {
-    return this.#o.contributions(t);
+    return this.#a.contributions(t);
   }
   install(t, ...e) {
     return this.#s.install(this.#s.root, t, ...e);
@@ -2546,12 +2627,12 @@ class he {
     return this.#s.create(this.#s.root, t, e);
   }
   start() {
-    return this.#a.run(async () => {
+    return this.#o.run(async () => {
       if (this.#r !== "active") {
         this.#c("starting");
         try {
-          const t = this.#o.buildPlan(this.#t.values());
-          await this.#o.start(t), this.#c("active"), this.#t.settleReadiness(t.order);
+          const t = this.#a.buildPlan(this.#t.values());
+          await this.#a.start(t), this.#c("active"), this.#t.settleReadiness(t.order);
         } catch (t) {
           this.#c("idle");
           for (const e of this.#t.values())
@@ -2562,19 +2643,19 @@ class he {
     });
   }
   stop() {
-    return this.#a.run(async () => {
+    return this.#o.run(async () => {
       if (this.#r === "idle") return;
       this.#c("stopping");
-      const t = await this.#o.stop();
+      const t = await this.#a.stop();
       if (this.#c("idle"), t.length === 1) throw t[0];
       if (t.length > 1) throw new AggregateError(t, "Host shutdown failed");
     });
   }
   #d(t, e) {
     const i = e.filter((s) => s.kind === "install").map((s) => s.installation);
-    return this.#a.run(async () => {
+    return this.#o.run(async () => {
       try {
-        if (!t.attached) throw A(t);
+        if (!t.attached) throw T(t);
         if (!e.length) return;
         this.#r === "active" ? await this.#l(e) : (this.#t.apply(e), this.#t.settleChanges(e, !1)), this.#p();
       } catch (s) {
@@ -2597,31 +2678,30 @@ class he {
     this.#c("changing");
     let s;
     try {
-      this.#t.apply(t), s = this.#o.buildPlan(this.#t.values());
+      this.#t.apply(t), s = this.#a.buildPlan(this.#t.values());
     } catch (n) {
       throw this.#t.restore(e), this.#c("active"), n;
     }
     try {
-      const n = await this.#o.transition(
+      const n = await this.#a.transition(
         s,
         i,
         () => this.#t.restore(e)
       );
       return this.#c("active"), n;
     } catch (n) {
-      throw this.#c(this.#o.hasCommittedPlan ? "active" : "idle"), n;
+      throw this.#c(this.#a.hasCommittedPlan ? "active" : "idle"), n;
     }
   }
   #h(t) {
+    const e = this.#i;
     try {
-      this.#n(t);
-    } catch (e) {
-      try {
-        this.#i.error(
-          new AggregateError([t, e], "Host error reporter failed")
-        );
-      } catch {
-      }
+      const i = this.#n(t);
+      Promise.resolve(i).catch((s) => {
+        Z(e, t, s);
+      });
+    } catch (i) {
+      Z(e, t, i);
     }
   }
   #c(t) {
@@ -2631,24 +2711,35 @@ class he {
     this.#e.publish(this.#r, this.#t.values(), this.#s.nodes());
   }
 }
-function ge(r) {
-  return new he(r);
+function be(r) {
+  return new ue(r);
+}
+function Z(r, t, e) {
+  try {
+    const i = r.error(
+      new AggregateError([t, e], "Host error reporter failed")
+    );
+    Promise.resolve(i).catch(() => {
+    });
+  } catch {
+  }
 }
 export {
-  at as ConfigValidationError,
+  ut as ConfigValidationError,
   u as DougongError,
-  S as ReadonlyMapSnapshot,
-  oe as SerialQueue,
+  dt as ErrorSummary,
+  O as ReadonlyMapSnapshot,
+  he as SerialQueue,
   q as SnapshotPublisher,
-  k as assertPlainRecord,
-  j as asyncDisposeSymbol,
-  ge as createHost,
-  pe as definePlugin,
+  L as assertPlainRecord,
+  k as asyncDisposeSymbol,
+  be as createHost,
+  ve as definePlugin,
   g as disposeSymbol,
-  le as event,
-  ue as extensionPoint,
-  J as isCancellationReason,
-  zt as isLogger,
-  fe as optional,
-  de as service
+  pe as event,
+  ge as extensionPoint,
+  tt as isCancellationReason,
+  Mt as isLogger,
+  we as optional,
+  fe as service
 };