avila_nucleus/lib.rs
1//! # avila-nucleus
2//!
3//! **Fundação Atômica da Pilha Criptográfica Ávila**
4//!
5//! Operações de nível mais baixo possível:
6//! - Manipulação direta de bits
7//! - Aritmética de precisão estendida (u64 → u128)
8//! - SIMD intrinsics raw (AVX2, AVX-512)
9//! - Operações constant-time
10//!
11//! ## Filosofia
12//!
13//! - ZERO abstrações desnecessárias
14//! - ZERO dependencies
15//! - 100% manual control
16//! - Constant-time por padrão
17//!
18//! ## Uso
19//!
20//! ```rust
21//! use avila_nucleus::bits::*;
22//!
23//! // Adição com carry
24//! let (sum, carry) = adc(0xFFFFFFFFFFFFFFFF, 1, 0);
25//! assert_eq!(sum, 0);
26//! assert_eq!(carry, 1);
27//!
28//! // Multiplicação wide
29//! let (lo, hi) = mul_wide(0xFFFFFFFFFFFFFFFF, 0xFFFFFFFFFFFFFFFF);
30//! ```
31
32#![no_std]
33// #![warn(missing_docs)] // Temporarily disabled for publication
34#![warn(clippy::all)]
35#![allow(incomplete_features)]
36
37#[cfg(feature = "std")]
38extern crate std;
39
40pub mod bits;
41pub mod simd;
42
43/// Versão do núcleo
44pub const VERSION: &str = env!("CARGO_PKG_VERSION");
45
46/// Verifica se código está rodando em constant-time
47/// (compile-time check, não runtime)
48#[inline(always)]
49pub const fn assert_ct() {
50 // Placeholder para futuras verificações
51}