🚀 SIMDPointer 🚀

✨ The Art of Intelligence ✨

We believe in the "Art of Intelligence," and SIMDPointer.js is a testament to that philosophy. It's designed to be elegant, powerful, and a joy to use.

💡 Core Concepts

🧠 Local Shared Memory

At the heart of SIMDPointer.js is a LocalSharedMemory instance. This provides a contiguous block of memory that we can read from and write to, just like in C or Rust.

👉 Pointers

We introduce a Pointer class that behaves like a memory address. These pointers are just numbers, but they give us a powerful way to reference and manage data within our shared memory.

📦 Typed Arrays and Numbers

We provide a full suite of TypedArray and TypedNumber classes that mirror the standard JavaScript TypedArrays, but with a key difference: they operate on our shared memory. This includes:

• Uint8Array, Int8Array
• Uint16Array, Int16Array
• Uint32Array, Int32Array
• Float32Array, Float64Array
• BigUint64Array, BigInt64Array
• And our very own BigVec128Array!

Introducing BigVec - The 128-bit Primitive 🌌

The star of the show is BigVec, our novel 128-bit primitive type. While JavaScript doesn't have a native 128-bit integer, we've created a BigInt-prototyped object that can hold 128-bit values.

This opens up a world of possibilities, including native UUID generation!

UUIDs from BigVec

A BigVec instance can be effortlessly converted to a 32-character hex string, which is the standard format for a UUID v4.

import SIMD from 'simdpointer';

// Create a random BigVec128Array with 4 elements
const myVectors = SIMD.BigVec128Array.random(4);

// Get the first vector from the array
const aVector = myVectors.debug().at(0);

// Convert it to a UUID!
const myUUID = aVector.toUUID(); 

console.log(myUUID); // e.g., 'f81d4fae-7dec-11d0-a765-00a0c91e6bf6'

🎮 Example Usage

Let's see the magic in action!

import SIMD from 'simdpointer';

// Let's create a random BigVec128Array with 4 vectors
const vecArray = SIMD.BigVec128Array.random(4);

// You can get a debug-friendly view of the array
const debugVectors = vecArray.debug();

// Access a single vector and its UUID representation
const firstVec = debugVectors.at(0);
console.log('My first vector:', firstVec);
console.log('As a UUID:', firstVec.toUUID());
console.log('As a hex string:', firstVec.toString());

// It works with other types too!
const u32Array = SIMD.Uint32Array.random(4);
console.log('A random Uint32Array:', u32Array.debug());

// You can also create single numbers
const aRandomUUID = crypto.randomUUID();
const bigVecNumber = SIMD.BigVec128Number.of(aRandomUUID);

console.log('Original UUID:', aRandomUUID);
console.log('BigVec Number:', bigVecNumber.value());
console.log('Back to string:', bigVecNumber.value().toString());

const aFloat = 3.14159265359;
const float64Number = SIMD.Float64Number.of(aFloat);
console.log('Original float:', aFloat);
console.log('Float64 Number:', float64Number.value());

🛠️ API

SIMD.Pointer

The base class for all our memory-managed types.

SIMD.TypedNumber classes

• SIMD.Uint8Number
• SIMD.Int8Number
• ...and so on for all types.

SIMD.TypedArray classes

• SIMD.Uint8Array
• SIMD.Int8Array
• SIMD.BigVec128Array
• ...and so on for all types.

📦 Installation

npm install simdpointer

Made with ❤️ and a touch of genius.