sparkid 1.0.0

//! # sparkid
//!
//! Fast, time-sortable, 22-char Base58 unique ID generator.
//!
//! Each ID is composed of three parts:
//!   - 8-char timestamp prefix  (milliseconds since epoch, Base58-encoded)
//!   - 6-char monotonic counter (randomly seeded each millisecond, incremented)
//!   - 8-char random tail       (independently random per ID)
//!
//! IDs are strictly monotonically increasing within a single generator instance
//! (or thread, when using [`SparkId::new`]).
//!
//! # Examples
//!
//! ```
//! use sparkid::SparkId;
//!
//! // Simple usage — zero-allocation, thread-safe
//! let id = SparkId::new();
//! assert_eq!(id.len(), 22);
//! println!("{id}");               // Display, no heap allocation
//! let s: &str = &id;             // Deref to &str, free
//! let owned: String = id.into(); // Into<String> when needed
//!
//! // Advanced usage — own generator instance
//! let mut gen = sparkid::IdGenerator::new();
//! let id = gen.next_id();
//! assert_eq!(id.len(), 22);
//! ```

#![no_std]

extern crate alloc;

#[cfg(feature = "std")]
extern crate std;

mod generator;

pub use generator::{IdGenerator, SparkId};

#[cfg(feature = "std")]
use std::cell::RefCell;

#[cfg(feature = "std")]
std::thread_local! {
    static LOCAL_GEN: RefCell<IdGenerator> = RefCell::new(IdGenerator::new());
}