SDK UUID

Author: realorko

sdk/math.sn

@@ -71,29 +71,14 @@ native fn fmin(x: double, y: double): double
 # Mathematical Constants
 # ==============================================================================
 
-fn pi(): double =>
-    return 3.14159265358979323846
-
-fn e(): double =>
-    return 2.71828182845904523536
-
-fn tau(): double =>
-    return 6.28318530717958647692
-
-fn phi(): double =>
-    return 1.61803398874989484820
-
-fn sqrt2(): double =>
-    return 1.41421356237309504880
-
-fn sqrt3(): double =>
-    return 1.73205080756887729352
-
-fn ln2(): double =>
-    return 0.69314718055994530942
-
-fn ln10(): double =>
-    return 2.30258509299404568402
+fn pi(): double => 3.14159265358979323846
+fn e(): double => 2.71828182845904523536
+fn tau(): double => 6.28318530717958647692
+fn phi(): double => 1.61803398874989484820
+fn sqrt2(): double => 1.41421356237309504880
+fn sqrt3(): double => 1.73205080756887729352
+fn ln2(): double => 0.69314718055994530942
+fn ln10(): double => 2.30258509299404568402
 
 # ==============================================================================
 # Integer Helper Functions
@@ -411,29 +396,14 @@ native fn fminF(x: float, y: float): float
 # Mathematical Constants (float)
 # ==============================================================================
 
-fn piF(): float =>
-    return 3.14159265
-
-fn eF(): float =>
-    return 2.71828182
-
-fn tauF(): float =>
-    return 6.28318530
-
-fn phiF(): float =>
-    return 1.61803398
-
-fn sqrt2F(): float =>
-    return 1.41421356
-
-fn sqrt3F(): float =>
-    return 1.73205080
-
-fn ln2F(): float =>
-    return 0.69314718
-
-fn ln10F(): float =>
-    return 2.30258509
+fn piF(): float => 3.14159265
+fn eF(): float => 2.71828182
+fn tauF(): float => 6.28318530
+fn phiF(): float => 1.61803398
+fn sqrt2F(): float => 1.41421356
+fn sqrt3F(): float => 1.73205080
+fn ln2F(): float => 0.69314718
+fn ln10F(): float => 2.30258509
 
 # ==============================================================================
 # Float Helper Functions

sdk/uuid.sn

@@ -0,0 +1,199 @@
+# ==============================================================================
+# sdk/uuid.sn - UUID Type for Sindarin
+# ==============================================================================
+# Provides a UUID type for generating and manipulating Universally Unique
+# Identifiers. Supports v4 (random), v5 (SHA-1 hash), and v7 (time-ordered).
+# Drop-in replacement for the builtin UUID type.
+#
+# Usage:
+#   import "sdk/uuid"
+#
+#   var id: SnUUID = SnUUID.create()
+#   print($"UUID: {id.toString()}\n")
+#   print($"Version: {id.version()}\n")
+#
+#   var v5id: SnUUID = SnUUID.v5(SnUUID.namespaceUrl(), "https://example.com")
+#
+# ==============================================================================
+
+# Self-contained implementation - compile and link our own C source
+#pragma source "uuid.sn.c"
+
+# ==============================================================================
+# SnUUID Native Struct Definition
+# ==============================================================================
+# Uses #pragma alias to map SnUUID to RtUuid in the runtime.
+# The 'as ref' modifier means native methods receive self by pointer.
+# SnUUID represents an opaque handle type (like built-in UUID).
+
+#pragma alias "RtUuid"
+native struct SnUUID as ref =>
+    #pragma alias "high"
+    _high: long
+
+    #pragma alias "low"
+    _low: long
+
+    # ==========================================================================
+    # Static Factory Methods - UUID Generation
+    # ==========================================================================
+
+    # Create a UUIDv7 (time-ordered) - recommended default
+    static fn create(): SnUUID =>
+        return sn_uuid_create(arena)
+
+    # Alias for create() - matches common convention
+    static fn new(): SnUUID =>
+        return sn_uuid_create(arena)
+
+    # Generate a UUIDv4 (random)
+    static fn v4(): SnUUID =>
+        return sn_uuid_v4(arena)
+
+    # Generate a UUIDv5 (SHA-1 hash of namespace + name)
+    static fn v5(namespace: SnUUID, name: str): SnUUID =>
+        return sn_uuid_v5(arena, namespace, name)
+
+    # Generate a UUIDv7 (timestamp + random)
+    static fn v7(): SnUUID =>
+        return sn_uuid_v7(arena)
+
+    # ==========================================================================
+    # Static Factory Methods - Parsing
+    # ==========================================================================
+
+    # Parse from standard 36-char format (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
+    static fn fromString(s: str): SnUUID =>
+        return sn_uuid_from_string(arena, s)
+
+    # Parse from 32-char hex format (no dashes)
+    static fn fromHex(s: str): SnUUID =>
+        return sn_uuid_from_hex(arena, s)
+
+    # Parse from 22-char URL-safe base64 format
+    static fn fromBase64(s: str): SnUUID =>
+        return sn_uuid_from_base64(arena, s)
+
+    # ==========================================================================
+    # Static Factory Methods - Special UUIDs
+    # ==========================================================================
+
+    # Get nil UUID (all zeros: 00000000-0000-0000-0000-000000000000)
+    static fn zero(): SnUUID =>
+        return sn_uuid_nil(arena)
+
+    # Get max UUID (all ones: ffffffff-ffff-ffff-ffff-ffffffffffff)
+    static fn max(): SnUUID =>
+        return sn_uuid_max(arena)
+
+    # ==========================================================================
+    # Static Factory Methods - Namespace Constants
+    # ==========================================================================
+
+    # Get DNS namespace UUID (6ba7b810-9dad-11d1-80b4-00c04fd430c8)
+    static fn namespaceDns(): SnUUID =>
+        return sn_uuid_namespace_dns(arena)
+
+    # Get URL namespace UUID (6ba7b811-9dad-11d1-80b4-00c04fd430c8)
+    static fn namespaceUrl(): SnUUID =>
+        return sn_uuid_namespace_url(arena)
+
+    # Get OID namespace UUID (6ba7b812-9dad-11d1-80b4-00c04fd430c8)
+    static fn namespaceOid(): SnUUID =>
+        return sn_uuid_namespace_oid(arena)
+
+    # Get X.500 namespace UUID (6ba7b814-9dad-11d1-80b4-00c04fd430c8)
+    static fn namespaceX500(): SnUUID =>
+        return sn_uuid_namespace_x500(arena)
+
+    # ==========================================================================
+    # Property Getters (native - pass self by pointer via 'as ref')
+    # ==========================================================================
+
+    # Get UUID version (1-8)
+    #pragma alias "sn_uuid_get_version"
+    native fn version(): int
+
+    # Get UUID variant
+    #pragma alias "sn_uuid_get_variant"
+    native fn variant(): int
+
+    # Check if UUID is nil (all zeros)
+    #pragma alias "sn_uuid_is_nil"
+    native fn isNil(): bool
+
+    # ==========================================================================
+    # Time Extraction (v7 only)
+    # ==========================================================================
+
+    # Get Unix timestamp in milliseconds (v7 only, throws on non-v7)
+    #pragma alias "sn_uuid_get_timestamp"
+    native fn timestamp(): long
+
+    # ==========================================================================
+    # Conversion Methods (non-native - need arena for string allocation)
+    # ==========================================================================
+
+    # Format as standard 36-char string (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
+    fn toString(): str =>
+        return sn_uuid_to_string(arena, self)
+
+    # Format as 32-char hex string (no dashes)
+    fn toHex(): str =>
+        return sn_uuid_to_hex(arena, self)
+
+    # Format as 22-char URL-safe base64 string
+    fn toBase64(): str =>
+        return sn_uuid_to_base64(arena, self)
+
+    # ==========================================================================
+    # Comparison Methods (native - pass self by pointer)
+    # ==========================================================================
+
+    # Check if two UUIDs are equal
+    #pragma alias "sn_uuid_equals"
+    native fn equals(other: SnUUID): bool
+
+    # Compare two UUIDs (returns -1, 0, or 1)
+    #pragma alias "sn_uuid_compare"
+    native fn compare(other: SnUUID): int
+
+    # Check if uuid < other
+    #pragma alias "sn_uuid_is_less_than"
+    native fn isLessThan(other: SnUUID): bool
+
+    # Check if uuid > other
+    #pragma alias "sn_uuid_is_greater_than"
+    native fn isGreaterThan(other: SnUUID): bool
+
+# ==============================================================================
+# Runtime Function Declarations
+# ==============================================================================
+# These declare the runtime functions directly.
+# SnUUID is an opaque handle type that generates as RtUuid* in C.
+
+# Factory functions - return SnUUID (which is RtUuid*)
+native fn sn_uuid_create(a: *void): SnUUID
+native fn sn_uuid_v4(a: *void): SnUUID
+native fn sn_uuid_v5(a: *void, namespace: SnUUID, name: str): SnUUID
+native fn sn_uuid_v7(a: *void): SnUUID
+
+# Parsing functions - return SnUUID
+native fn sn_uuid_from_string(a: *void, s: str): SnUUID
+native fn sn_uuid_from_hex(a: *void, s: str): SnUUID
+native fn sn_uuid_from_base64(a: *void, s: str): SnUUID
+
+# Special UUIDs
+native fn sn_uuid_nil(a: *void): SnUUID
+native fn sn_uuid_max(a: *void): SnUUID
+
+# Namespace UUIDs
+native fn sn_uuid_namespace_dns(a: *void): SnUUID
+native fn sn_uuid_namespace_url(a: *void): SnUUID
+native fn sn_uuid_namespace_oid(a: *void): SnUUID
+native fn sn_uuid_namespace_x500(a: *void): SnUUID
+
+# Conversion functions - take SnUUID (which is RtUuid*)
+native fn sn_uuid_to_string(a: *void, u: SnUUID): str
+native fn sn_uuid_to_hex(a: *void, u: SnUUID): str
+native fn sn_uuid_to_base64(a: *void, u: SnUUID): str