max-priority-queue-typed 2.5.1 → 2.5.3

package/dist/types/data-structures/binary-tree/tree-set.d.ts

@@ -197,15 +197,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Check empty
-   *  console.log(new TreeSet().isEmpty()); // true;
-     */
-    isEmpty(): boolean;
-    private _validateKey;
-    /**
-     * Add a key to the set (no-op if already present).
-     * @remarks Expected time O(log n)
      
      
      
@@ -241,6 +232,15 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Check empty
+   *  console.log(new TreeSet().isEmpty()); // true;
+     */
+    isEmpty(): boolean;
+    private _validateKey;
+    /**
+     * Add a key to the set (no-op if already present).
+     * @remarks Expected time O(log n)
      
      
      
@@ -352,22 +352,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Unique tags with sorted order
-   *  const tags = new TreeSet<string>(['javascript', 'typescript', 'react', 'typescript', 'node']);
-   *
-   *     // Duplicates removed, sorted alphabetically
-   *     console.log([...tags]); // ['javascript', 'node', 'react', 'typescript'];
-   *     console.log(tags.size); // 4;
-   *
-   *     tags.add('angular');
-   *     console.log(tags.first()); // 'angular';
-   *     console.log(tags.last()); // 'typescript';
-     */
-    add(key: K): this;
-    /**
-     * Test whether a key exists.
-     * @remarks Expected time O(log n)
      
      
      
@@ -438,6 +422,25 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Unique tags with sorted order
+   *  const tags = new TreeSet<string>(['javascript', 'typescript', 'react', 'typescript', 'node']);
+   *
+   *     // Duplicates removed, sorted alphabetically
+   *     console.log([...tags]); // ['javascript', 'node', 'react', 'typescript'];
+   *     console.log(tags.size); // 4;
+   *
+   *     tags.add('angular');
+   *     console.log(tags.first()); // 'angular';
+   *     console.log(tags.last()); // 'typescript';
+     */
+    add(key: K): this;
+    /**
+     * Add multiple keys at once.
+     * @remarks Expected time O(m log n), where m is the number of keys.
+     * @param keys - Iterable of keys to add.
+     * @returns Array of booleans indicating whether each key was newly added.
+    
      
      
      
@@ -453,6 +456,16 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Add multiple keys
+   *  const ts = new TreeSet<number>();
+   *     ts.addMany([5, 3, 7, 1, 9]);
+   *     console.log(ts.size); // 5;
+     */
+    addMany(keys: Iterable<K>): boolean[];
+    /**
+     * Test whether a key exists.
+     * @remarks Expected time O(log n)
      
      
      
@@ -522,18 +535,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Checking membership in a sorted collection
-   *  const allowed = new TreeSet<string>(['admin', 'editor', 'viewer']);
-   *
-   *     console.log(allowed.has('admin')); // true;
-   *     console.log(allowed.has('guest')); // false;
-     */
-    has(key: K): boolean;
-    /**
-     * Delete a key.
-     * @returns `true` if the key existed; otherwise `false`.
-     * @remarks Expected time O(log n)
      
      
      
@@ -654,6 +655,18 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Checking membership in a sorted collection
+   *  const allowed = new TreeSet<string>(['admin', 'editor', 'viewer']);
+   *
+   *     console.log(allowed.has('admin')); // true;
+   *     console.log(allowed.has('guest')); // false;
+     */
+    has(key: K): boolean;
+    /**
+     * Delete a key.
+     * @returns `true` if the key existed; otherwise `false`.
+     * @remarks Expected time O(log n)
      
      
      
@@ -688,17 +701,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Removing elements while maintaining order
-   *  const nums = new TreeSet<number>([1, 3, 5, 7, 9]);
-   *
-   *     console.log(nums.delete(5)); // true;
-   *     console.log(nums.delete(5)); // false; // already gone
-   *     console.log([...nums]); // [1, 3, 7, 9];
-     */
-    delete(key: K): boolean;
-    /**
-     * Remove all keys.
      
      
      
@@ -842,15 +844,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Remove all
-   *  const ts = new TreeSet<number>([1, 2]);
-   *       ts.clear();
-   *       console.log(ts.isEmpty()); // true;
-     */
-    clear(): void;
-    /**
-     * Iterate over keys in ascending order.
      
      
      
@@ -863,6 +856,31 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Removing elements while maintaining order
+   *  const nums = new TreeSet<number>([1, 3, 5, 7, 9]);
+   *
+   *     console.log(nums.delete(5)); // true;
+   *     console.log(nums.delete(5)); // false; // already gone
+   *     console.log([...nums]); // [1, 3, 7, 9];
+     */
+    delete(key: K): boolean;
+    /**
+     * Delete all keys matching a predicate.
+     * @remarks Time O(N), Space O(N)
+     * @param predicate - Function (key, index, set) → boolean; return true to delete.
+     * @returns True if at least one key was deleted.
+     */
+    deleteWhere(predicate: (key: K, index: number, set: this) => boolean): boolean;
+    /**
+     * Remove all keys.
+     
+     
+     
+     
+     
+     
+     
      
      
      
@@ -994,16 +1012,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Get sorted keys
-   *  const ts = new TreeSet<number>([30, 10, 20]);
-   *       console.log([...ts.keys()]); // [10, 20, 30];
-     */
-    keys(): IterableIterator<K>;
-    /**
-     * Iterate over values in ascending order.
-     *
-     * Note: for Set-like containers, `values()` is the same as `keys()`.
      
      
      
@@ -1044,6 +1052,15 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Remove all
+   *  const ts = new TreeSet<number>([1, 2]);
+   *       ts.clear();
+   *       console.log(ts.isEmpty()); // true;
+     */
+    clear(): void;
+    /**
+     * Iterate over keys in ascending order.
      
      
      
@@ -1147,16 +1164,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Get values (same as keys for Set)
-   *  const ts = new TreeSet<number>([2, 1, 3]);
-   *       console.log([...ts.values()]); // [1, 2, 3];
-     */
-    values(): IterableIterator<K>;
-    /**
-     * Iterate over `[value, value]` pairs (native Set convention).
-     *
-     * Note: TreeSet stores only keys internally; `[k, k]` is created on-the-fly during iteration.
      
      
      
@@ -1232,6 +1239,16 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Get sorted keys
+   *  const ts = new TreeSet<number>([30, 10, 20]);
+   *       console.log([...ts.keys()]); // [10, 20, 30];
+     */
+    keys(): IterableIterator<K>;
+    /**
+     * Iterate over values in ascending order.
+     *
+     * Note: for Set-like containers, `values()` is the same as `keys()`.
      
      
      
@@ -1300,17 +1317,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Iterate entries
-   *  const ts = new TreeSet<number>([3, 1, 2]);
-   *       console.log([...ts.entries()].map(([k]) => k)); // [1, 2, 3];
-     */
-    entries(): IterableIterator<[K, K]>;
-    [Symbol.iterator](): IterableIterator<K>;
-    /**
-     * Visit each value in ascending order.
-     *
-     * Callback follows native Set convention: `(value, value2, set)`.
      
      
      
@@ -1421,6 +1427,18 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Get values (same as keys for Set)
+   *  const ts = new TreeSet<number>([2, 1, 3]);
+   *       console.log([...ts.values()]); // [1, 2, 3];
+     */
+    values(): IterableIterator<K>;
+    /**
+     * Iterate over `[value, value]` pairs (native Set convention).
+     *
+     * Note: TreeSet stores only keys internally; `[k, k]` is created on-the-fly during iteration.
+     
+     
      
      
      
@@ -1454,19 +1472,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Execute for each
-   *  const ts = new TreeSet<number>([3, 1, 2]);
-   *       const keys: number[] = [];
-   *       ts.forEach(k => keys.push(k));
-   *       console.log(keys); // [1, 2, 3];
-     */
-    forEach(cb: (value: K, value2: K, set: TreeSet<K>) => void, thisArg?: unknown): void;
-    /**
-     * Create a new TreeSet by mapping each value to a new key.
-     *
-     * This mirrors `RedBlackTree.map`: mapping produces a new ordered container.
-     * @remarks Time O(n log n) expected, Space O(n)
      
      
      
@@ -1611,17 +1616,16 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
       * @example
-   * // Transform
-   *  const ts = new TreeSet<number>([1, 2, 3]);
-   *       const doubled = ts.map(k => k * 2);
-   *       console.log([...doubled]); // [2, 4, 6];
+   * // Iterate entries
+   *  const ts = new TreeSet<number>([3, 1, 2]);
+   *       console.log([...ts.entries()].map(([k]) => k)); // [1, 2, 3];
      */
-    map<MK>(callbackfn: TreeSetElementCallback<K, MK, TreeSet<K>>, options?: Omit<TreeSetOptions<MK>, 'toElementFn'> & {
-        comparator?: (a: MK, b: MK) => number;
-    }, thisArg?: unknown): TreeSet<MK>;
+    entries(): IterableIterator<[K, K]>;
+    [Symbol.iterator](): IterableIterator<K>;
     /**
-     * Create a new TreeSet containing only values that satisfy the predicate.
-     * @remarks Time O(n log n) expected, Space O(n)
+     * Visit each value in ascending order.
+     *
+     * Callback follows native Set convention: `(value, value2, set)`.
      
      
      
@@ -1765,16 +1769,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Filter
-   *  const ts = new TreeSet<number>([1, 2, 3, 4, 5]);
-   *       const evens = ts.filter(k => k % 2 === 0);
-   *       console.log([...evens]); // [2, 4];
-     */
-    filter(callbackfn: TreeSetElementCallback<K, boolean, TreeSet<K>>, thisArg?: unknown): TreeSet<K>;
-    /**
-     * Reduce values into a single accumulator.
-     * @remarks Time O(n), Space O(1)
      
      
      
@@ -1810,6 +1804,19 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Execute for each
+   *  const ts = new TreeSet<number>([3, 1, 2]);
+   *       const keys: number[] = [];
+   *       ts.forEach(k => keys.push(k));
+   *       console.log(keys); // [1, 2, 3];
+     */
+    forEach(cb: (value: K, value2: K, set: TreeSet<K>) => void, thisArg?: unknown): void;
+    /**
+     * Create a new TreeSet by mapping each value to a new key.
+     *
+     * This mirrors `RedBlackTree.map`: mapping produces a new ordered container.
+     * @remarks Time O(n log n) expected, Space O(n)
      
      
      
@@ -1918,16 +1925,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Aggregate
-   *  const ts = new TreeSet<number>([1, 2, 3]);
-   *       const sum = ts.reduce((acc, k) => acc + k, 0);
-   *       console.log(sum); // 6;
-     */
-    reduce<A>(callbackfn: TreeSetReduceCallback<K, A, TreeSet<K>>, initialValue: A): A;
-    /**
-     * Test whether all values satisfy a predicate.
-     * @remarks Time O(n), Space O(1)
      
      
      
@@ -1998,6 +1995,18 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Transform
+   *  const ts = new TreeSet<number>([1, 2, 3]);
+   *       const doubled = ts.map(k => k * 2);
+   *       console.log([...doubled]); // [2, 4, 6];
+     */
+    map<MK>(callbackfn: TreeSetElementCallback<K, MK, TreeSet<K>>, options?: Omit<TreeSetOptions<MK>, 'toElementFn'> & {
+        comparator?: (a: MK, b: MK) => number;
+    }, thisArg?: unknown): TreeSet<MK>;
+    /**
+     * Create a new TreeSet containing only values that satisfy the predicate.
+     * @remarks Time O(n log n) expected, Space O(n)
      
      
      
@@ -2069,15 +2078,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Test all
-   *  const ts = new TreeSet<number>([2, 4, 6]);
-   *       console.log(ts.every(k => k > 0)); // true;
-     */
-    every(callbackfn: TreeSetElementCallback<K, boolean, TreeSet<K>>, thisArg?: unknown): boolean;
-    /**
-     * Test whether any value satisfies a predicate.
-     * @remarks Time O(n), Space O(1)
      
      
      
@@ -2185,6 +2185,19 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Filter
+   *  const ts = new TreeSet<number>([1, 2, 3, 4, 5]);
+   *       const evens = ts.filter(k => k % 2 === 0);
+   *       console.log([...evens]); // [2, 4];
+     */
+    filter(callbackfn: TreeSetElementCallback<K, boolean, TreeSet<K>>, thisArg?: unknown): TreeSet<K>;
+    /**
+     * Reduce values into a single accumulator.
+     * @remarks Time O(n), Space O(1)
+     
+     
+     
      
      
      
@@ -2219,15 +2232,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Test any
-   *  const ts = new TreeSet<number>([1, 3, 5]);
-   *       console.log(ts.some(k => k === 3)); // true;
-     */
-    some(callbackfn: TreeSetElementCallback<K, boolean, TreeSet<K>>, thisArg?: unknown): boolean;
-    /**
-     * Find the first value that satisfies a predicate.
-     * @remarks Time O(n), Space O(1)
      
      
      
@@ -2370,15 +2374,15 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
       * @example
-   * // Find entry
+   * // Aggregate
    *  const ts = new TreeSet<number>([1, 2, 3]);
-   *       const found = ts.find(k => k === 2);
-   *       console.log(found); // 2;
+   *       const sum = ts.reduce((acc, k) => acc + k, 0);
+   *       console.log(sum); // 6;
      */
-    find(callbackfn: TreeSetElementCallback<K, boolean, TreeSet<K>>, thisArg?: unknown): K | undefined;
+    reduce<A>(callbackfn: TreeSetReduceCallback<K, A, TreeSet<K>>, initialValue: A): A;
     /**
-     * Materialize the set into an array of keys.
-     * @remarks Time O(n), Space O(n)
+     * Test whether all values satisfy a predicate.
+     * @remarks Time O(n), Space O(1)
      
      
      
@@ -2522,15 +2526,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Convert to array
-   *  const ts = new TreeSet<number>([3, 1, 2]);
-   *       console.log(ts.toArray()); // [1, 2, 3];
-     */
-    toArray(): K[];
-    /**
-     * Print a human-friendly representation.
-     * @remarks Time O(n), Space O(n)
      
      
      
@@ -2564,6 +2559,17 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Test all
+   *  const ts = new TreeSet<number>([2, 4, 6]);
+   *       console.log(ts.every(k => k > 0)); // true;
+     */
+    every(callbackfn: TreeSetElementCallback<K, boolean, TreeSet<K>>, thisArg?: unknown): boolean;
+    /**
+     * Test whether any value satisfies a predicate.
+     * @remarks Time O(n), Space O(1)
+     
+     
      
      
      
@@ -2674,14 +2680,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Display tree
-   *  const ts = new TreeSet<number>([1, 2, 3]);
-   *       expect(() => ts.print()).not.toThrow();
-     */
-    print(): void;
-    /**
-     * Smallest key in the set.
      
      
      
@@ -2714,37 +2712,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Student grade ranking with custom comparator
-   *  interface Student {
-   *       name: string;
-   *       gpa: number;
-   *     }
-   *
-   *     const ranking = new TreeSet<Student>(
-   *       [
-   *         { name: 'Alice', gpa: 3.8 },
-   *         { name: 'Bob', gpa: 3.5 },
-   *         { name: 'Charlie', gpa: 3.9 },
-   *         { name: 'Diana', gpa: 3.5 }
-   *       ],
-   *       { comparator: (a, b) => b.gpa - a.gpa || a.name.localeCompare(b.name) }
-   *     );
-   *
-   *     // Sorted by GPA descending, then name ascending
-   *     const names = [...ranking].map(s => s.name);
-   *     console.log(names); // ['Charlie', 'Alice', 'Bob', 'Diana'];
-   *
-   *     // Top student
-   *     console.log(ranking.first()?.name); // 'Charlie';
-   *
-   *     // Filter students with GPA >= 3.8
-   *     const honors = ranking.filter(s => s.gpa >= 3.8);
-   *     console.log(honors.toArray().map(s => s.name)); // ['Charlie', 'Alice'];
-     */
-    first(): K | undefined;
-    /**
-     * Largest key in the set.
      
      
      
@@ -2778,14 +2745,14 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
       * @example
-   * // Get the maximum element
-   *  const temps = new TreeSet<number>([18, 22, 15, 30, 25]);
-   *     console.log(temps.last()); // 30;
-   *     console.log(temps.first()); // 15;
+   * // Test any
+   *  const ts = new TreeSet<number>([1, 3, 5]);
+   *       console.log(ts.some(k => k === 3)); // true;
      */
-    last(): K | undefined;
+    some(callbackfn: TreeSetElementCallback<K, boolean, TreeSet<K>>, thisArg?: unknown): boolean;
     /**
-     * Remove and return the smallest key.
+     * Find the first value that satisfies a predicate.
+     * @remarks Time O(n), Space O(1)
      
      
      
@@ -2818,17 +2785,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Remove and return minimum
-   *  const queue = new TreeSet<number>([5, 1, 8, 3]);
-   *
-   *     console.log(queue.pollFirst()); // 1;
-   *     console.log(queue.pollFirst()); // 3;
-   *     console.log(queue.size); // 2;
-     */
-    pollFirst(): K | undefined;
-    /**
-     * Remove and return the largest key.
      
      
      
@@ -2861,16 +2817,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Remove and return maximum
-   *  const stack = new TreeSet<number>([10, 20, 30]);
-   *
-   *     console.log(stack.pollLast()); // 30;
-   *     console.log(stack.size); // 2;
-     */
-    pollLast(): K | undefined;
-    /**
-     * Smallest key that is >= the given key.
      
      
      
@@ -2983,6 +2929,16 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Find entry
+   *  const ts = new TreeSet<number>([1, 2, 3]);
+   *       const found = ts.find(k => k === 2);
+   *       console.log(found); // 2;
+     */
+    find(callbackfn: TreeSetElementCallback<K, boolean, TreeSet<K>>, thisArg?: unknown): K | undefined;
+    /**
+     * Materialize the set into an array of keys.
+     * @remarks Time O(n), Space O(n)
      
      
      
@@ -2993,26 +2949,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Finding nearest available time slot
-   *  // Available appointment times (minutes from midnight)
-   *     const slots = new TreeSet<number>([540, 600, 660, 720, 840, 900]);
-   *
-   *     // Customer wants something around 10:30 (630 min)
-   *     const nearest = slots.ceiling(630);
-   *     console.log(nearest); // 660; // 11:00 AM
-   *
-   *     // What's the latest slot before 2:00 PM (840)?
-   *     const before2pm = slots.lower(840);
-   *     console.log(before2pm); // 720; // 12:00 PM
-   *
-   *     // Book the 11:00 slot
-   *     slots.delete(660);
-   *     console.log(slots.ceiling(630)); // 720;
-     */
-    ceiling(key: K): K | undefined;
-    /**
-     * Largest key that is <= the given key.
      
      
      
@@ -3135,18 +3071,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Largest element ≤ target
-   *  const breakpoints = new TreeSet<number>([320, 768, 1024, 1280, 1920]);
-   *
-   *     // Current width is 800 → which breakpoint applies?
-   *     console.log(breakpoints.floor(800)); // 768;
-   *     console.log(breakpoints.floor(1024)); // 1024; // exact match
-   *     console.log(breakpoints.floor(100)); // undefined;
-     */
-    floor(key: K): K | undefined;
-    /**
-     * Smallest key that is > the given key.
      
      
      
@@ -3193,6 +3117,15 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Convert to array
+   *  const ts = new TreeSet<number>([3, 1, 2]);
+   *       console.log(ts.toArray()); // [1, 2, 3];
+     */
+    toArray(): K[];
+    /**
+     * Print a human-friendly representation.
+     * @remarks Time O(n), Space O(n)
      
      
      
@@ -3269,16 +3202,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Smallest element strictly > target
-   *  const levels = new TreeSet<number>([1, 5, 10, 25, 50, 100]);
-   *
-   *     console.log(levels.higher(10)); // 25;
-   *     console.log(levels.higher(100)); // undefined;
-     */
-    higher(key: K): K | undefined;
-    /**
-     * Largest key that is < the given key.
      
      
      
@@ -3381,6 +3304,894 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+      * @example
+   * // Display tree
+   *  const ts = new TreeSet<number>([1, 2, 3]);
+   *       expect(() => ts.print()).not.toThrow();
+     */
+    print(): void;
+    /**
+     * Smallest key in the set.
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+      * @example
+   * // Student grade ranking with custom comparator
+   *  interface Student {
+   *       name: string;
+   *       gpa: number;
+   *     }
+   *
+   *     const ranking = new TreeSet<Student>(
+   *       [
+   *         { name: 'Alice', gpa: 3.8 },
+   *         { name: 'Bob', gpa: 3.5 },
+   *         { name: 'Charlie', gpa: 3.9 },
+   *         { name: 'Diana', gpa: 3.5 }
+   *       ],
+   *       { comparator: (a, b) => b.gpa - a.gpa || a.name.localeCompare(b.name) }
+   *     );
+   *
+   *     // Sorted by GPA descending, then name ascending
+   *     const names = [...ranking].map(s => s.name);
+   *     console.log(names); // ['Charlie', 'Alice', 'Bob', 'Diana'];
+   *
+   *     // Top student
+   *     console.log(ranking.first()?.name); // 'Charlie';
+   *
+   *     // Filter students with GPA >= 3.8
+   *     const honors = ranking.filter(s => s.gpa >= 3.8);
+   *     console.log(honors.toArray().map(s => s.name)); // ['Charlie', 'Alice'];
+     */
+    first(): K | undefined;
+    /**
+     * Largest key in the set.
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+      * @example
+   * // Get the maximum element
+   *  const temps = new TreeSet<number>([18, 22, 15, 30, 25]);
+   *     console.log(temps.last()); // 30;
+   *     console.log(temps.first()); // 15;
+     */
+    last(): K | undefined;
+    /**
+     * Remove and return the smallest key.
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+      * @example
+   * // Remove and return minimum
+   *  const queue = new TreeSet<number>([5, 1, 8, 3]);
+   *
+   *     console.log(queue.pollFirst()); // 1;
+   *     console.log(queue.pollFirst()); // 3;
+   *     console.log(queue.size); // 2;
+     */
+    pollFirst(): K | undefined;
+    /**
+     * Remove and return the largest key.
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+      * @example
+   * // Remove and return maximum
+   *  const stack = new TreeSet<number>([10, 20, 30]);
+   *
+   *     console.log(stack.pollLast()); // 30;
+   *     console.log(stack.size); // 2;
+     */
+    pollLast(): K | undefined;
+    /**
+     * Smallest key that is >= the given key.
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+      * @example
+   * // Finding nearest available time slot
+   *  // Available appointment times (minutes from midnight)
+   *     const slots = new TreeSet<number>([540, 600, 660, 720, 840, 900]);
+   *
+   *     // Customer wants something around 10:30 (630 min)
+   *     const nearest = slots.ceiling(630);
+   *     console.log(nearest); // 660; // 11:00 AM
+   *
+   *     // What's the latest slot before 2:00 PM (840)?
+   *     const before2pm = slots.lower(840);
+   *     console.log(before2pm); // 720; // 12:00 PM
+   *
+   *     // Book the 11:00 slot
+   *     slots.delete(660);
+   *     console.log(slots.ceiling(630)); // 720;
+     */
+    ceiling(key: K): K | undefined;
+    /**
+     * Largest key that is <= the given key.
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+      * @example
+   * // Largest element ≤ target
+   *  const breakpoints = new TreeSet<number>([320, 768, 1024, 1280, 1920]);
+   *
+   *     // Current width is 800 → which breakpoint applies?
+   *     console.log(breakpoints.floor(800)); // 768;
+   *     console.log(breakpoints.floor(1024)); // 1024; // exact match
+   *     console.log(breakpoints.floor(100)); // undefined;
+     */
+    floor(key: K): K | undefined;
+    /**
+     * Smallest key that is > the given key.
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+      * @example
+   * // Smallest element strictly > target
+   *  const levels = new TreeSet<number>([1, 5, 10, 25, 50, 100]);
+   *
+   *     console.log(levels.higher(10)); // 25;
+   *     console.log(levels.higher(100)); // undefined;
+     */
+    higher(key: K): K | undefined;
+    /**
+     * Largest key that is < the given key.
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+      * @example
+   * // Largest element strictly < target
+   *  const tiers = new TreeSet<number>([100, 200, 500, 1000]);
+   *
+   *     console.log(tiers.lower(500)); // 200;
+   *     console.log(tiers.lower(100)); // undefined;
+     */
+    lower(key: K): K | undefined;
+    /**
+     * Return all keys in a given range.
+     *
+     * @param range `[low, high]`
+     * @param options Inclusive/exclusive bounds (defaults to inclusive).
+     
+     
+     
+     
+     
+     
+     
+     
      
      
      
@@ -3401,19 +4212,6 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
-      * @example
-   * // Largest element strictly < target
-   *  const tiers = new TreeSet<number>([100, 200, 500, 1000]);
-   *
-   *     console.log(tiers.lower(500)); // 200;
-   *     console.log(tiers.lower(100)); // undefined;
-     */
-    lower(key: K): K | undefined;
-    /**
-     * Return all keys in a given range.
-     *
-     * @param range `[low, high]`
-     * @param options Inclusive/exclusive bounds (defaults to inclusive).
      
      
      
@@ -3555,6 +4353,63 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
    *     console.log(blocklist.has(167772800)); // false;
      */
     rangeSearch(range: [K, K], options?: TreeSetRangeOptions): K[];
+    /**
+     * Returns the element at the k-th position in tree order (0-indexed).
+     * @remarks Time O(log n). Requires `enableOrderStatistic: true`.
+     
+     
+     
+      * @example
+   * // Find k-th element in a TreeSet
+   *  const set = new TreeSet<number>([30, 10, 50, 20, 40], { enableOrderStatistic: true });
+   *       console.log(set.getByRank(0)); // 10;
+   *       console.log(set.getByRank(2)); // 30;
+   *       console.log(set.getRank(30)); // 2;
+     */
+    getByRank(k: number): K | undefined;
+    /**
+     * Returns the 0-based rank of a key (number of elements that precede it in tree order).
+     * @remarks Time O(log n). Requires `enableOrderStatistic: true`.
+      * @example
+   * // Get the rank of a key in sorted order
+   *  const tree = new TreeSet<number>(
+   *         [10, 20, 30, 40, 50],
+   *         { enableOrderStatistic: true }
+   *       );
+   *       console.log(tree.getRank(10)); // 0;  // smallest → rank 0
+   *       console.log(tree.getRank(30)); // 2;  // 2 elements before 30 in tree order
+   *       console.log(tree.getRank(50)); // 4;  // largest → rank 4
+   *       console.log(tree.getRank(25)); // 2;
+     */
+    getRank(key: K): number;
+    /**
+     * Returns elements by rank range (0-indexed, inclusive on both ends).
+     * @remarks Time O(log n + k). Requires `enableOrderStatistic: true`.
+     
+     
+     
+     
+     
+     
+     
+     
+     
+      * @example
+   * // Pagination by position in tree order
+   *  const tree = new TreeSet<number>(
+   *         [10, 20, 30, 40, 50, 60, 70, 80, 90],
+   *         { enableOrderStatistic: true }
+   *       );
+   *       const pageSize = 3;
+   *
+   *       // Page 1
+   *       console.log(tree.rangeByRank(0, pageSize - 1)); // [10, 20, 30];
+   *       // Page 2
+   *       console.log(tree.rangeByRank(pageSize, 2 * pageSize - 1)); // [40, 50, 60];
+   *       // Page 3
+   *       console.log(tree.rangeByRank(2 * pageSize, 3 * pageSize - 1)); // [70, 80, 90];
+     */
+    rangeByRank(start: number, end: number): K[];
     /**
      * Creates a shallow clone of this set.
      * @remarks Time O(n log n), Space O(n)
@@ -3681,6 +4536,41 @@ export declare class TreeSet<K = any, R = K> implements Iterable<K> {
      
      
      
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+