Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector'

This commit is contained in:
ruv
2026-02-28 14:39:40 -05:00
7854 changed files with 3522914 additions and 0 deletions

View File

@@ -0,0 +1,57 @@
/**
* Type declarations for the RVF WASM microkernel exports.
*/
export interface RvfWasmExports {
memory: WebAssembly.Memory;
// Memory management
rvf_alloc(size: number): number;
rvf_free(ptr: number, size: number): void;
// Core query path
rvf_init(config_ptr: number): number;
rvf_load_query(query_ptr: number, dim: number): number;
rvf_load_block(block_ptr: number, count: number, dtype: number): number;
rvf_distances(metric: number, result_ptr: number): number;
rvf_topk_merge(dist_ptr: number, id_ptr: number, count: number, k: number): number;
rvf_topk_read(out_ptr: number): number;
// Quantization
rvf_load_sq_params(params_ptr: number, dim: number): number;
rvf_dequant_i8(src_ptr: number, dst_ptr: number, count: number): number;
rvf_load_pq_codebook(codebook_ptr: number, m: number, k: number): number;
rvf_pq_distances(codes_ptr: number, count: number, result_ptr: number): number;
// HNSW navigation
rvf_load_neighbors(node_id: bigint, layer: number, out_ptr: number): number;
rvf_greedy_step(current_id: bigint, layer: number): bigint;
// Segment verification
rvf_verify_header(header_ptr: number): number;
rvf_crc32c(data_ptr: number, len: number): number;
rvf_verify_checksum(buf_ptr: number, buf_len: number): number;
// In-memory store
rvf_store_create(dim: number, metric: number): number;
rvf_store_open(buf_ptr: number, buf_len: number): number;
rvf_store_ingest(handle: number, vecs_ptr: number, ids_ptr: number, count: number): number;
rvf_store_query(handle: number, query_ptr: number, k: number, metric: number, out_ptr: number): number;
rvf_store_delete(handle: number, ids_ptr: number, count: number): number;
rvf_store_count(handle: number): number;
rvf_store_dimension(handle: number): number;
rvf_store_status(handle: number, out_ptr: number): number;
rvf_store_export(handle: number, out_ptr: number, out_len: number): number;
rvf_store_close(handle: number): number;
// Segment parsing
rvf_parse_header(buf_ptr: number, buf_len: number, out_ptr: number): number;
rvf_segment_count(buf_ptr: number, buf_len: number): number;
rvf_segment_info(buf_ptr: number, buf_len: number, idx: number, out_ptr: number): number;
// Witness chain
rvf_witness_verify(chain_ptr: number, chain_len: number): number;
rvf_witness_count(chain_len: number): number;
}
export default function init(input?: ArrayBuffer | Uint8Array | WebAssembly.Module): Promise<RvfWasmExports>;

View File

@@ -0,0 +1,72 @@
/**
* @ruvector/rvf-wasm — JS glue for the RVF WASM microkernel.
*
* Loads the .wasm binary and re-exports all C-ABI functions plus the
* WASM linear memory object.
*
* Works in Node.js (CJS/ESM) and browsers.
*/
var wasmInstance = null;
var _isNode = typeof process !== 'undefined' &&
typeof process.versions !== 'undefined' &&
typeof process.versions.node === 'string';
/**
* Initialize the WASM module.
* Returns the exports object with all rvf_* functions and `memory`.
*
* @param {ArrayBuffer|BufferSource|WebAssembly.Module|string} [input]
* Optional pre-loaded bytes, Module, or file path override.
*/
async function init(input) {
if (wasmInstance) return wasmInstance;
var wasmBytes;
if (input instanceof ArrayBuffer || ArrayBuffer.isView(input)) {
wasmBytes = input;
} else if (typeof WebAssembly !== 'undefined' && input instanceof WebAssembly.Module) {
var inst = await WebAssembly.instantiate(input, {});
wasmInstance = inst.exports;
return wasmInstance;
} else if (_isNode) {
// Node.js: always use readFile (fetch on file:// is unreliable)
var fs = await import('node:fs/promises');
var url = await import('node:url');
var path = await import('node:path');
var wasmPath;
if (typeof input === 'string') {
wasmPath = input;
} else if (typeof __dirname !== 'undefined') {
// CJS context
wasmPath = path.default.join(__dirname, 'rvf_wasm_bg.wasm');
} else {
// ESM context — import.meta.url available
var thisDir = path.default.dirname(url.default.fileURLToPath(import.meta.url));
wasmPath = path.default.join(thisDir, 'rvf_wasm_bg.wasm');
}
wasmBytes = await fs.default.readFile(wasmPath);
} else {
// Browser: use fetch + instantiateStreaming
var wasmUrl = new URL('rvf_wasm_bg.wasm', import.meta.url);
if (typeof WebAssembly.instantiateStreaming === 'function') {
var resp = await fetch(wasmUrl);
var result = await WebAssembly.instantiateStreaming(resp, {});
wasmInstance = result.instance.exports;
return wasmInstance;
}
var resp2 = await fetch(wasmUrl);
wasmBytes = await resp2.arrayBuffer();
}
var compiled = await WebAssembly.instantiate(wasmBytes, {});
wasmInstance = compiled.instance.exports;
return wasmInstance;
}
// Support both ESM (export default) and CJS (module.exports)
init.default = init;
if (typeof module !== 'undefined') module.exports = init;
export default init;

View File

@@ -0,0 +1,6 @@
/**
* @ruvector/rvf-wasm ESM entry point.
* Re-exports the init function from the CJS-compatible module.
*/
import init from './rvf_wasm.js';
export default init;

Binary file not shown.