@matter/node 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/cjs/behavior/state/managed/Datasource.js

@@ -0,0 +1,360 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Datasource_exports = {};
+__export(Datasource_exports, {
+  Datasource: () => Datasource
+});
+module.exports = __toCommonJS(Datasource_exports);
+var import_general = require("#general");
+var import_model = require("#model");
+var import_errors = require("../../errors.js");
+var import_Tx = require("../transaction/Tx.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("Datasource");
+function Datasource(options) {
+  const internals = configure(options);
+  let readOnlyView;
+  return {
+    toString() {
+      return internals.path.toString();
+    },
+    reference(session) {
+      let context = internals.sessions?.get(session);
+      if (!context) {
+        context = createSessionContext(this, internals, session);
+      }
+      return context.managed;
+    },
+    get version() {
+      return internals.version;
+    },
+    validate(session, values) {
+      const validate = internals.supervisor.validate;
+      if (!validate) {
+        return;
+      }
+      validate(values ?? internals.values, session, { path: internals.path });
+    },
+    get view() {
+      if (!readOnlyView) {
+        const session = {
+          offline: true,
+          authorizedFor(desiredAccessLevel) {
+            return desiredAccessLevel === import_model.AccessLevel.View;
+          },
+          transaction: import_Tx.ReadOnlyTransaction
+        };
+        readOnlyView = createSessionContext(this, internals, session).managed;
+      }
+      return readOnlyView;
+    }
+  };
+}
+function configure(options) {
+  const values = new options.type();
+  const initialValues = {
+    ...options.defaults,
+    ...options.store?.initialValues
+  };
+  for (const key in initialValues) {
+    values[key] = initialValues[key];
+  }
+  return {
+    ...options,
+    version: import_general.Crypto.getRandomUInt32(),
+    values,
+    interactionObserver() {
+      function handleObserverError(error) {
+        logger.error(`Error in ${options.path} observer:`, error);
+      }
+      try {
+        const result = options.events?.interactionEnd?.emit();
+        if (import_general.MaybePromise.is(result)) {
+          return result.then(handleObserverError);
+        }
+      } catch (e) {
+        handleObserverError(e);
+      }
+    }
+  };
+}
+function createSessionContext(resource, internals, session) {
+  let values = internals.values;
+  let precommitValues;
+  let changes;
+  let expired = false;
+  const participant = {
+    toString() {
+      return internals.path.toString();
+    },
+    preCommit,
+    commit1,
+    commit2,
+    postCommit,
+    rollback
+  };
+  const transaction = session.transaction;
+  void transaction.onShared(() => {
+    if (values !== internals.values) {
+      try {
+        rollback();
+      } catch (e) {
+        logger.error(
+          `Error resetting reference to ${internals.path} after reset of transaction ${transaction.via}:`,
+          e
+        );
+      }
+    }
+  });
+  const fields = internals.supervisor.memberNames;
+  const persistentFields = internals.supervisor.persistentNames;
+  const reference = {
+    get original() {
+      return internals.values;
+    },
+    get value() {
+      if (expired) {
+        throw new import_errors.ExpiredReferenceError(this.location);
+      }
+      return values;
+    },
+    set value(_value) {
+      throw new import_general.InternalError(`Cannot set root reference for ${internals.supervisor.schema.name}`);
+    },
+    get expired() {
+      return expired;
+    },
+    get location() {
+      return { path: internals.path, cluster: internals.cluster };
+    },
+    set location(_loc) {
+      throw new import_general.ImplementationError("Root reference location is immutable");
+    },
+    get rootOwner() {
+      return internals.owner;
+    },
+    change(mutator) {
+      if (expired) {
+        throw new import_errors.ExpiredReferenceError(this.location);
+      }
+      startWrite();
+      transaction.beginSync();
+      if (values === internals.values) {
+        const old = values;
+        values = new internals.type();
+        for (const index of fields) {
+          values[index] = old[index];
+        }
+        refreshSubrefs();
+      }
+      mutator();
+      refreshSubrefs();
+    },
+    refresh() {
+      throw new import_general.InternalError(`Cannot refresh root reference for ${internals.supervisor.schema.name}`);
+    }
+  };
+  reference.toString = () => `ref<${resource}>`;
+  const context = {
+    managed: internals.supervisor.manage(reference, session),
+    onChange(oldValues) {
+      if (values === oldValues) {
+        values = internals.values;
+        refreshSubrefs();
+      }
+    }
+  };
+  if (!internals.sessions) {
+    internals.sessions = /* @__PURE__ */ new Map();
+  }
+  internals.sessions.set(session, context);
+  void transaction.onClose(() => {
+    try {
+      internals.sessions?.delete(session);
+      expired = true;
+      refreshSubrefs();
+    } catch (e) {
+      logger.error(
+        `Error detaching reference to ${internals.path} from closed transaction ${transaction.via}:`,
+        e
+      );
+    }
+  });
+  return context;
+  function startWrite() {
+    transaction.addResourcesSync(resource);
+    transaction.addParticipants(participant);
+    transaction.beginSync();
+    if (session.interactionComplete && !session.interactionComplete.isObservedBy(internals.interactionObserver)) {
+      internals.events?.interactionBegin?.emit();
+      session.interactionComplete.on(internals.interactionObserver);
+    }
+  }
+  function refreshSubrefs() {
+    const subrefs = reference.subrefs;
+    if (subrefs) {
+      for (const key in subrefs) {
+        subrefs[key].refresh();
+      }
+    }
+  }
+  function incrementVersion() {
+    internals.version++;
+    if (internals.version > 4294967295) {
+      internals.version = 0;
+    }
+  }
+  function computePreCommitChange(name) {
+    let oldValue;
+    if (precommitValues && name in precommitValues) {
+      oldValue = precommitValues[name];
+    } else {
+      oldValue = internals.values[name];
+    }
+    const newValue = values[name];
+    if ((0, import_general.isDeepEqual)(oldValue, newValue)) {
+      return;
+    }
+    if (!precommitValues) {
+      precommitValues = {};
+    }
+    precommitValues[name] = (0, import_general.deepCopy)(newValue);
+    return { newValue: context.managed[name], oldValue };
+  }
+  function preCommit() {
+    const { events } = internals;
+    if (!events) {
+      return false;
+    }
+    let mayHaveMutated = false;
+    const keyIterator = Object.keys(values)[Symbol.iterator]();
+    function nextKey() {
+      while (true) {
+        const n = keyIterator.next();
+        if (n.done) {
+          return mayHaveMutated;
+        }
+        const name = n.value;
+        const event = events?.[`${name}$Changing`];
+        if (!event?.isObserved) {
+          continue;
+        }
+        const change = computePreCommitChange(name);
+        if (change) {
+          mayHaveMutated = true;
+          const result = event.emit(change.newValue, change.oldValue, session);
+          if (import_general.MaybePromise.is(result)) {
+            return result.then(nextKey);
+          }
+        }
+      }
+    }
+    return nextKey();
+  }
+  function computePostCommitChanges() {
+    changes = void 0;
+    if (internals.values === values) {
+      return changes;
+    }
+    for (const name in values) {
+      const newval = values[name];
+      const oldval = internals.values[name];
+      if (oldval !== newval && !(0, import_general.isDeepEqual)(newval, oldval)) {
+        if (!changes) {
+          changes = { notifications: [] };
+        }
+        if (persistentFields.has(name)) {
+          if (changes.persistent === void 0) {
+            changes.persistent = {};
+          }
+          changes.persistent[name] = values[name];
+        }
+        const event = internals.events?.[`${name}$Changed`];
+        if (event?.isObserved) {
+          changes.notifications.push({
+            event,
+            params: [values[name], internals.values[name], session]
+          });
+        }
+      }
+    }
+    if (changes) {
+      incrementVersion();
+    }
+  }
+  function commit1() {
+    computePostCommitChanges();
+    const persistent = changes?.persistent;
+    if (!persistent) {
+      return;
+    }
+    return internals.store?.set(session.transaction, persistent);
+  }
+  function commit2() {
+    if (!changes) {
+      return;
+    }
+    const oldValues = internals.values;
+    internals.values = values;
+    if (internals.sessions) {
+      for (const context2 of internals.sessions.values()) {
+        context2.onChange(oldValues);
+      }
+    }
+    if (session.trace && changes.persistent) {
+      let mutations = session.trace.mutations;
+      if (!mutations) {
+        mutations = session.trace.mutations = [];
+      }
+      mutations.push({
+        path: internals.path,
+        values: changes.persistent
+      });
+    }
+  }
+  function postCommit() {
+    if (!changes || !internals.events) {
+      return;
+    }
+    const iterator = changes.notifications[Symbol.iterator]();
+    function emitChanged() {
+      while (true) {
+        const n = iterator.next();
+        if (n.done) {
+          return;
+        }
+        const { event, params } = n.value;
+        const result = event.emit(...params);
+        if (import_general.MaybePromise.is(result)) {
+          return Promise.resolve(result).then(emitChanged);
+        }
+      }
+    }
+    return emitChanged();
+  }
+  function rollback() {
+    ({ values } = internals);
+    refreshSubrefs();
+  }
+}
+//# sourceMappingURL=Datasource.js.map

package/dist/cjs/behavior/state/managed/Datasource.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/state/managed/Datasource.ts"],
+  "mappings": "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",
+  "names": ["context"]
+}

package/dist/cjs/behavior/state/managed/Instrumentation.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ValueSupervisor } from "../../supervision/ValueSupervisor.js";
+import type { Val } from "../Val.js";
+/**
+ * Instrumentation points for the managed values used for {@link Behavior.state}.
+ */
+export declare namespace Instrumentation {
+    /**
+     * A constructor for the generated class associated with a {@link Val.Struct}.
+     */
+    type StructFactory = new (ref: Val.Reference<Val.Struct>, session: ValueSupervisor.Session) => Val.Struct;
+    /**
+     * Instrument the class generated for Matter structs.
+     */
+    function instrumentStruct(factory: StructFactory): StructFactory;
+    /**
+     * Creation function for generating proxies for Matter lists.
+     */
+    type ListFactory = (handlers: ProxyHandler<Val.List>, target: Val.List) => Val.List;
+    /**
+     * Instrument Matter list creation.
+     */
+    function instrumentList(factory: ListFactory): ListFactory;
+}
+//# sourceMappingURL=Instrumentation.d.ts.map

package/dist/cjs/behavior/state/managed/Instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Instrumentation.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/Instrumentation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC;;GAEG;AACH,yBAAiB,eAAe,CAAC;IAC7B;;OAEG;IACH,KAAY,aAAa,GAAG,KAAK,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,KAAK,GAAG,CAAC,MAAM,CAAC;IAEjH;;OAEG;IACH,SAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,iBAEtD;IAED;;OAEG;IACH,KAAY,WAAW,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;IAE3F;;OAEG;IACH,SAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,eAElD;CACJ"}

package/dist/cjs/behavior/state/managed/Instrumentation.js

@@ -0,0 +1,40 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Instrumentation_exports = {};
+__export(Instrumentation_exports, {
+  Instrumentation: () => Instrumentation
+});
+module.exports = __toCommonJS(Instrumentation_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Instrumentation;
+((Instrumentation2) => {
+  function instrumentStruct(factory) {
+    return factory;
+  }
+  Instrumentation2.instrumentStruct = instrumentStruct;
+  function instrumentList(factory) {
+    return factory;
+  }
+  Instrumentation2.instrumentList = instrumentList;
+})(Instrumentation || (Instrumentation = {}));
+//# sourceMappingURL=Instrumentation.js.map

package/dist/cjs/behavior/state/managed/Instrumentation.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/state/managed/Instrumentation.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,IAAU;AAAA,CAAV,CAAUA,qBAAV;AASI,WAAS,iBAAiB,SAAwB;AACrD,WAAO;AAAA,EACX;AAFO,EAAAA,iBAAS;AAYT,WAAS,eAAe,SAAsB;AACjD,WAAO;AAAA,EACX;AAFO,EAAAA,iBAAS;AAAA,GArBH;",
+  "names": ["Instrumentation"]
+}

package/dist/cjs/behavior/state/managed/Internal.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Val } from "../Val.js";
+/**
+ * API for bypassing managed collections and accessing the internal object containing raw data.
+ */
+export declare namespace Internal {
+    const reference: unique symbol;
+    interface Collection {
+        [reference]: Val.Reference<Val.Collection>;
+    }
+}
+//# sourceMappingURL=Internal.d.ts.map

package/dist/cjs/behavior/state/managed/Internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Internal.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/Internal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC;;GAEG;AACH,yBAAiB,QAAQ,CAAC;IACf,MAAM,SAAS,eAAsB,CAAC;IAE7C,UAAiB,UAAU;QACvB,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;KAC9C;CACJ"}

package/dist/cjs/behavior/state/managed/Internal.js

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Internal_exports = {};
+__export(Internal_exports, {
+  Internal: () => Internal
+});
+module.exports = __toCommonJS(Internal_exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Internal;
+((Internal2) => {
+  Internal2.reference = Symbol("reference");
+})(Internal || (Internal = {}));
+//# sourceMappingURL=Internal.js.map

package/dist/cjs/behavior/state/managed/Internal.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/state/managed/Internal.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWO,IAAU;AAAA,CAAV,CAAUA,cAAV;AACI,EAAMA,UAAA,YAAY,OAAO,WAAW;AAAA,GAD9B;",
+  "names": ["Internal"]
+}

package/dist/cjs/behavior/state/managed/ManagedReference.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Val } from "../Val.js";
+/**
+ * ManagedReference manages a reference to a container property of another reference.
+ *
+ * The ManagedReference detects when the value changes and clones the container if it is the original copy.
+ *
+ * This serves the following purposes:
+ *
+ *   - We can change properties in a container (an array or object) without modifying the original container
+ *
+ *   - When nested, this effect bubbles so we make copies at all levels in the hierarchy as necessary
+ *
+ *   - Preserves metadata regarding the state of the value
+ *
+ * Change detection happens automatically if the value is replaced.  If a subvalue is replaced, the logic replacing the
+ * subvalue must update "changed" manually before replacing the subvalue.  For managed structures this is handled by a
+ * separate ManagedReference.
+ *
+ * @param parent a reference to the container we reference
+ * @param index the key we reference
+ * @param assertWriteOk enforces ACLs and read-only
+ * @param clone clones the container prior to write; undefined if not transactional
+ *
+ * @returns a reference to the property
+ */
+export declare function ManagedReference(parent: Val.Reference<Val.Collection>, index: string | number, assertWriteOk: (value: Val) => void, clone: (container: Val) => Val): Val.Reference<unknown>;
+//# sourceMappingURL=ManagedReference.d.ts.map

package/dist/cjs/behavior/state/managed/ManagedReference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManagedReference.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/state/managed/ManagedReference.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAIhC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EACrC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,aAAa,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,EACnC,KAAK,EAAE,CAAC,SAAS,EAAE,GAAG,KAAK,GAAG,0BA0GjC"}

package/dist/cjs/behavior/state/managed/ManagedReference.js

@@ -0,0 +1,109 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ManagedReference_exports = {};
+__export(ManagedReference_exports, {
+  ManagedReference: () => ManagedReference
+});
+module.exports = __toCommonJS(ManagedReference_exports);
+var import_errors = require("../../errors.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function ManagedReference(parent, index, assertWriteOk, clone) {
+  let value = parent.value[index];
+  let expired = false;
+  let location = {
+    ...parent.location,
+    path: parent.location.path.at(index)
+  };
+  const reference = {
+    owner: parent,
+    get value() {
+      return value;
+    },
+    get expired() {
+      return expired;
+    },
+    get location() {
+      return location;
+    },
+    set location(loc) {
+      location = loc;
+    },
+    get rootOwner() {
+      return parent.rootOwner;
+    },
+    set value(newValue) {
+      if (value === newValue) {
+        return;
+      }
+      assertWriteOk(newValue);
+      replaceValue(newValue);
+      this.change(() => parent.value[index] = newValue);
+    },
+    get original() {
+      if (!parent.original) {
+        return void 0;
+      }
+      return parent.original[index];
+    },
+    change(mutator) {
+      if (expired) {
+        throw new import_errors.ExpiredReferenceError(this.location);
+      }
+      parent.change(() => {
+        if (clone && value === this.original) {
+          const newValue = clone(value);
+          parent.value[index] = newValue;
+          replaceValue(newValue);
+        }
+        mutator();
+      });
+    },
+    refresh() {
+      if (parent.expired) {
+        expired = true;
+        return;
+      }
+      if (parent.value === void 0) {
+        expired = true;
+        replaceValue(void 0);
+        return;
+      }
+      replaceValue(parent.value[index]);
+    }
+  };
+  if (!parent.subrefs) {
+    parent.subrefs = {};
+  }
+  parent.subrefs[index] = reference;
+  return reference;
+  function replaceValue(newValue) {
+    value = newValue;
+    const subrefs = reference.subrefs;
+    if (subrefs) {
+      for (const key in subrefs) {
+        subrefs[key].refresh();
+      }
+    }
+  }
+}
+//# sourceMappingURL=ManagedReference.js.map

package/dist/cjs/behavior/state/managed/ManagedReference.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/state/managed/ManagedReference.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,oBAAsC;AAPtC;AAAA;AAAA;AAAA;AAAA;AAoCO,SAAS,iBACZ,QACA,OACA,eACA,OACF;AACE,MAAI,QAAS,OAAO,MAAoB,KAAK;AAC7C,MAAI,UAAU;AACd,MAAI,WAAW;AAAA,IACX,GAAG,OAAO;AAAA,IACV,MAAM,OAAO,SAAS,KAAK,GAAG,KAAK;AAAA,EACvC;AAEA,QAAM,YAA2B;AAAA,IAC7B,OAAO;AAAA,IAEP,IAAI,QAAQ;AAIR,aAAO;AAAA,IACX;AAAA,IAEA,IAAI,UAAU;AACV,aAAO;AAAA,IACX;AAAA,IAEA,IAAI,WAAW;AACX,aAAO;AAAA,IACX;AAAA,IAEA,IAAI,SAAS,KAA6B;AACtC,iBAAW;AAAA,IACf;AAAA,IAEA,IAAI,YAAY;AACZ,aAAO,OAAO;AAAA,IAClB;AAAA,IAEA,IAAI,MAAM,UAAe;AACrB,UAAI,UAAU,UAAU;AACpB;AAAA,MACJ;AAGA,oBAAc,QAAQ;AAGtB,mBAAa,QAAQ;AAGrB,WAAK,OAAO,MAAQ,OAAO,MAAoB,KAAK,IAAI,QAAS;AAAA,IACrE;AAAA,IAEA,IAAI,WAAW;AACX,UAAI,CAAC,OAAO,UAAU;AAClB,eAAO;AAAA,MACX;AACA,aAAQ,OAAO,SAAuB,KAAK;AAAA,IAC/C;AAAA,IAEA,OAAO,SAAqB;AACxB,UAAI,SAAS;AACT,cAAM,IAAI,oCAAsB,KAAK,QAAQ;AAAA,MACjD;AAEA,aAAO,OAAO,MAAM;AAEhB,YAAI,SAAS,UAAU,KAAK,UAAU;AAClC,gBAAM,WAAW,MAAM,KAAK;AAC5B,UAAC,OAAO,MAAoB,KAAK,IAAI;AACrC,uBAAa,QAAQ;AAAA,QACzB;AAGA,gBAAQ;AAAA,MACZ,CAAC;AAAA,IACL;AAAA,IAEA,UAAU;AACN,UAAI,OAAO,SAAS;AAChB,kBAAU;AACV;AAAA,MACJ;AACA,UAAI,OAAO,UAAU,QAAW;AAC5B,kBAAU;AACV,qBAAa,MAAS;AACtB;AAAA,MACJ;AACA,mBAAc,OAAO,MAAoB,KAAK,CAAC;AAAA,IACnD;AAAA,EACJ;AAEA,MAAI,CAAC,OAAO,SAAS;AACjB,WAAO,UAAU,CAAC;AAAA,EACtB;AACA,SAAO,QAAQ,KAAK,IAAI;AAExB,SAAO;AAEP,WAAS,aAAa,UAAe;AACjC,YAAQ;AAER,UAAM,UAAU,UAAU;AAC1B,QAAI,SAAS;AACT,iBAAW,OAAO,SAAS;AACvB,gBAAQ,GAAG,EAAE,QAAQ;AAAA,MACzB;AAAA,IACJ;AAAA,EACJ;AACJ;",
+  "names": []
+}

package/dist/cjs/behavior/state/managed/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Instrumentation.js";
+//# sourceMappingURL=index.d.ts.map