SArray (Dynamic Arrays)

Modules
	Core Types & Information
	Array Lifecycle & Size Management
	Array Operations
	Slicing, Cloning & Merging

Detailed Description

Generic dynamic arrays with type safety, optional sorting, and automatic growth.

Key Features:

• Type-safe generic programming through runtime type system
• Optional sorted mode with O(log n) binary search
• Configurable growth strategies for performance tuning
• Reference or value semantics for pointer types
• Automatic memory management with proper element destruction

Basic Usage:

sa_int32 arr = { 0 };
saInit(&arr, int32, 16);
saPush(&arr, int32, 42);
saPush(&arr, int32, 17);
int32 idx = saFind(arr, int32, 42);
saDestroy(&arr);

Sorted Arrays:

sa_int32 sorted = { 0 };
saInit(&sorted, int32, 0, SA_Sorted);
saPush(&sorted, int32, 30);  // Inserted in sorted position
saPush(&sorted, int32, 10);
saPush(&sorted, int32, 20);
// Array is now [10, 20, 30]
int32 idx = saFind(sorted, int32, 20);  // O(log n) binary search