/**
 * 高性能可扩容 TypedArray 封装
 * @template T 具体 TypedArray 类型，如 Float64Array、Uint32Array 等
 */
declare class DynamicTypedArray {
    private _buf;
    private _len;
    private _CTOR;
    /**
     * @param ctor 类型化数组构造器，例如 Float64Array
     * @param initialCapacity 初始容量（默认 1024，避免小数据频繁扩容）
     */
    constructor(initialCapacity?: number);
    length(): number;
    buffer(): Float64Array;
    /** 确保至少能容纳 extra 个额外元素 */
    reserve(extra: number): void;
    /** 内部扩容，翻倍直到满足 required */
    private _grow;
    /** 末尾追加一个值 */
    push(value: number): number;
    /** 弹出最后一个值 */
    pop(): number | undefined;
    /** 读取索引（支持负数） */
    at(index: number): number | undefined;
    /** 写入索引 */
    setAt(index: number, value: number): void;
    /**
     * 批量追加，利用原生 set 实现内存级拷贝。
     * @param source 数值数组或另一 TypedArray
     */
    pushMany(source: ArrayLike<number>): number;
    forEach(callback: (value: number, index: number, arr: DynamicTypedArray) => void): void;
    [Symbol.iterator](): IterableIterator<number>;
    /** 返回一份新的 TypedArray（拷贝） */
    toTypedArray(): Float64Array;
    /** 清空 */
    clear(): void;
}
export { DynamicTypedArray };
