@itwin/core-i18n 4.8.0-dev.32 → 4.8.0-dev.34

package/lib/cjs/test/webpack/bundled-tests.js

@@ -18476,6 +18476,11 @@ var Id64;
     }
     Id64.Uint32Map = Uint32Map;
 })(Id64 || (Id64 = {}));
+function validateLocalId(num) {
+    if (num < 0 || Math.round(num) !== num) {
+        throw new Error("Local Id must be a non-negative integer");
+    }
+}
 /**
  * Generates unique [[Id64String]] values in sequence, which are guaranteed not to conflict with Ids associated with persistent elements or models.
  * This is useful for associating stable, non-persistent identifiers with things like [Decorator]($frontend)s.
@@ -18483,8 +18488,20 @@ var Id64;
  * @public
  */
 class TransientIdSequence {
-    constructor() {
-        this._localId = 0;
+    /** Constructor.
+     * @param initialLocalId The starting local Id. The local Id of the first [[Id64String]] generated by [[getNext]] will be `initialLocalId + 1`.
+     */
+    constructor(initialLocalId = 0) {
+        validateLocalId(initialLocalId);
+        this.initialLocalId = initialLocalId;
+        this._localId = initialLocalId;
+    }
+    /** The maximum local Id generated by the sequence thus far. It is never less than [[initialLocalId]]. If it is equal to [[initialLocalId]], then the sequence has
+     * not yet generated any Ids.
+     * Each call to [[getNext]] increments this by 1 and uses it as the local Id of the generated [[Id64String]].
+     */
+    get currentLocalId() {
+        return this._localId;
     }
     /** Generate and return the next transient Id64String in the sequence.
      * @deprecated in 3.x. Use [[getNext]].
@@ -18502,6 +18519,55 @@ class TransientIdSequence {
     peekNext() {
         return Id64.fromLocalAndBriefcaseIds(this._localId + 1, 0xffffff);
     }
+    /** Convert this sequence to its JSON representation. */
+    toJSON() {
+        return {
+            initialLocalId: this.initialLocalId,
+            currentLocalId: this.currentLocalId,
+        };
+    }
+    /** Create a sequence from its JSON representation. */
+    static fromJSON(props) {
+        validateLocalId(props.currentLocalId);
+        const sequence = new TransientIdSequence(props.initialLocalId);
+        sequence._localId = props.currentLocalId;
+        return sequence;
+    }
+    /** Obtain the JSON representation of a new sequence that diverges from this sequence, with its [[initialLocalId]] set to this sequence's [[currentLocalId]].
+     * The two sequences can generate Ids independently. Later, you can [[merge]] the sequences, resolving conflicts where the two sequences generated identical Ids.
+     * This is chiefly useful when generating transient Ids on a [Worker](https://developer.mozilla.org/en-US/docs/Web/API/Worker).
+     */
+    fork() {
+        return {
+            initialLocalId: this.currentLocalId,
+            currentLocalId: this.currentLocalId,
+        };
+    }
+    /** Integrate the Ids generated by a [[fork]] of this sequence. All of the Ids generated by `source` will be remapped to Ids at the end of this sequence.
+     * This is chiefly useful when generating transient Ids on a [Worker](https://developer.mozilla.org/en-US/docs/Web/API/Worker).
+     * @param source The JSON representation of the [[fork]]ed sequence to be merged with this one.
+     * @returns a function that permits you to remap the local Ids generated by `source` into the corresponding local Ids assigned by this sequence.
+     * @throws Error if `source` is not a fork of this sequence or is malformed (e.g., contains negative and/or non-integer local Ids).
+     */
+    merge(source) {
+        const { initialLocalId, currentLocalId } = source;
+        validateLocalId(initialLocalId);
+        validateLocalId(currentLocalId);
+        if (initialLocalId > this.currentLocalId) {
+            throw new Error("Transient Id sequences do not intersect");
+        }
+        if (initialLocalId > currentLocalId) {
+            throw new Error("Current local Id cannot be less than initial local Id");
+        }
+        const delta = this.currentLocalId - initialLocalId;
+        this._localId += currentLocalId - initialLocalId;
+        return (sourceLocalId) => {
+            if (sourceLocalId > initialLocalId && sourceLocalId <= currentLocalId) {
+                return sourceLocalId + delta;
+            }
+            return sourceLocalId;
+        };
+    }
 }
 /**
  * The Guid namespace provides facilities for working with GUID strings using the "8-4-4-4-12" pattern.