speechflow 2.3.0 → 2.3.1

package/speechflow-cli/src/speechflow-util-queue.ts

@@ -48,6 +48,15 @@ export class QueuePointer<T extends QueueElement> extends EventEmitter {
     silent (silence: boolean) {
         this.silence = silence
     }
+    silently<R> (fn: () => R): R {
+        this.silence = true
+        try {
+            return fn()
+        }
+        finally {
+            this.silence = false
+        }
+    }
 
     /*  notify about operation  */
     notify (event: string, info: any) {
@@ -171,12 +180,14 @@ export class QueuePointer<T extends QueueElement> extends EventEmitter {
     }
     insert (element: T) {
         this.queue.elements.splice(this.index, 0, element)
+        this.queue.adjustPointers(this, this.index, "insert")
         this.queue.notify("write", { start: this.index, end: this.index, op: "insert" })
     }
     delete () {
         if (this.index >= this.queue.elements.length)
             throw new Error("cannot delete after last element")
         this.queue.elements.splice(this.index, 1)
+        this.queue.adjustPointers(this, this.index, "delete")
         this.queue.notify("write", { start: this.index, end: this.index, op: "delete" })
     }
 }
@@ -193,6 +204,15 @@ export class Queue<T extends QueueElement> extends EventEmitter {
     silent (silence: boolean) {
         this.silence = silence
     }
+    silently<R> (fn: () => R): R {
+        this.silence = true
+        try {
+            return fn()
+        }
+        finally {
+            this.silence = false
+        }
+    }
     notify (event: string, info: any) {
         if (!this.silence)
             this.emit(event, info)
@@ -207,6 +227,24 @@ export class Queue<T extends QueueElement> extends EventEmitter {
             throw new Error("pointer does not exist")
         this.pointers.delete(name)
     }
+
+    /*  adjust all sibling pointer positions (after insert/delete splice)
+        NOTICE: for insert, pointers AT the index are shifted forward to preserve
+        their pointer-to-element binding; for delete, pointers AT the index are
+        intentionally NOT adjusted, causing them to silently advance to the next
+        element (which shifted into the deleted position).  */
+    adjustPointers (exclude: QueuePointer<T>, index: number, op: "insert" | "delete"): void {
+        for (const pointer of this.pointers.values()) {
+            if (pointer === exclude)
+                continue
+            const pos = pointer.position()
+            if (op === "insert" && pos >= index)
+                pointer.position(pos + 1)
+            else if (op === "delete" && pos > index)
+                pointer.position(pos - 1)
+        }
+    }
+
     trim (): void {
         /*  determine minimum pointer position  */
         let min = this.elements.length
@@ -227,6 +265,11 @@ export class Queue<T extends QueueElement> extends EventEmitter {
             this.notify("write", { start: 0, end: min, op: "trim" })
         }
     }
+    clear (): void {
+        this.elements.length = 0
+        for (const pointer of this.pointers.values())
+            pointer.position(0)
+    }
 }
 
 /*  meta store  */