ev_lib 0.17.1

#![allow(unused_features)]
#![feature(default_field_values)]
//! EV-invest's shared Rust libraries, one per Cargo feature.
//!
//! Each library is a self-contained module gated behind a feature flag, so a
//! consumer pulls in only what it asks for and nothing else is compiled:
//!
//! ```toml
//! ev_lib = { git = "https://github.com/EV-invest/lib.git", default-features = false, features = ["architecture"] }
//! ```
//!
//! # Available features
//!
//! - **`architecture`** — generic, I/O-free, `wasm32`-safe DDD tactical kernel
//!   (typed ids, entities, aggregate roots, repositories, gateways, the unit of
//!   work, domain events, specifications). See [`architecture`].
//! - **`uikit`** — dep-light Dioxus UI kit (mirrors `@evinvest/uikit`). See [`uikit`].
//! - **`analytics`** — PostHog product analytics (mirrors `@evinvest/analytics`):
//!   native async capture over `reqwest`; pure-Rust fetch on the Dioxus/wasm
//!   frontend. Does network I/O — opt-in, not the kernel. See [`analytics`].
//! - **`error_monitoring`** — Sentry error monitoring (mirrors
//!   `@evinvest/error-monitoring`): native backend on the `sentry` crate; pure-Rust
//!   envelope POST + panic hook on the Dioxus/wasm frontend. See [`error_monitoring`].
//! - **`experiments`** — frontend-only A/B testing (mirrors `@evinvest/experiments`):
//!   cookie-bucketed variant assignment; exposure is reported through an injected
//!   sink, so it never imports `analytics`. See [`experiments`].
//! - **`settings`** — typed env settings (mirrors `@evinvest/settings`): the
//!   `settings!` macro reads env vars into a validated struct with aggregate
//!   error reporting and secret redaction. Zero deps; sops stays at the shell/CI
//!   boundary. See [`settings`](mod@settings).
//! - **`types`** — shared domain TypeObjects (mirrors `@evinvest/types`):
//!   [`PhoneNumber`](types::PhoneNumber) with E.164 validation and formatting, plus
//!   the generic [`Branded<T, B>`](types::Branded) newtype for future types (Email,
//!   Currency, …). Zero deps, wasm-safe. See [`types`](mod@types).
//! - **`otel`** — OpenTelemetry logs + traces over OTLP (native backends only;
//!   inert on wasm): two `tracing` layers + a flush guard, and tonic
//!   interceptors for W3C trace propagation. See [`otel`].
//! - **`i18n`** — five-locale internationalisation (mirrors `@evinvest/i18n`):
//!   the locale registry, the `/<locale>` URL contract, `Accept-Language`
//!   negotiation, an ICU-subset message formatter, the translation policy that
//!   refuses a translation whose English source has moved, and the [`t!`] macro
//!   — English written where it renders, with the catalogue generated back out
//!   of the code. Wasm-safe and zero-dep there; natively it carries `inventory`,
//!   which is what turns `t!` sites into that catalogue. Reads the same
//!   `messages/<locale>/*.json` as the TypeScript half, so a catalogue is
//!   portable between them. See [`i18n`].

#![cfg_attr(docsrs, feature(doc_cfg))]

#[cfg(feature = "architecture")]
pub mod architecture;

#[cfg(feature = "uikit")]
pub mod uikit;

// The `cn!` fuse macro and styling data live in the Dioxus-free `ev_lib_classes`
// crate; re-export so the in-crate `crate::cn` path keeps resolving.
#[cfg(feature = "uikit")]
pub use ev_lib_classes::cn;

#[cfg(feature = "analytics")]
pub mod analytics;

#[cfg(feature = "error_monitoring")]
pub mod error_monitoring;

#[cfg(feature = "otel")]
pub mod otel;

#[cfg(feature = "experiments")]
pub mod experiments;

#[cfg(feature = "i18n")]
pub mod i18n;

#[cfg(feature = "settings")]
pub mod settings;

#[cfg(feature = "types")]
pub mod types;

// wasm-only: the module links wasm-bindgen/web-sys, which aren't deps on native.
// The `mfe!` macro is `#[macro_export]`ed from inside, so it too is wasm-only —
// the sole consumer (a producer cdylib) is always a wasm build.
#[cfg(all(feature = "mfe", target_arch = "wasm32"))]
pub mod mfe;