//! Operating system utilities and abstractions.
//!
//! This module provides comprehensive OS-level functionality including:
//!
//! - **File System Operations** (`fs`): Copy, move, delete files and directories, file I/O operations
//! - **Platform Detection** (`platform`): Detect OS type (macOS, Linux) and CPU architecture
//! - **Package Management** (`package`): Install, remove, and search for packages across platforms
//! - **Downloads** (`download`): Download files and archives from URLs with automatic extraction
//!
//! # Platform Support
//!
//! Most functions work across:
//! - macOS
//! - Linux
//! - Windows (with some platform-specific behavior)
//!
//! # Examples
//!
//! ```no_run
//! use herolib_os::os::{copy, file_read, mkdir};
//!
//! // File system operations
//! mkdir("data")?;
//! copy("file.txt", "data/file.txt")?;
//! let content = file_read("data/file.txt")?;
//!
//! // Platform detection
//! use herolib_os::os::platform::{is_linux, is_osx};
//! if is_linux() {
//!     println!("Running on Linux");
//! } else if is_osx() {
//!     println!("Running on macOS");
//! }
//! # Ok::<(), Box<dyn std::error::Error>>(())
//! ```

pub mod download;
pub mod fs;
pub mod package;
pub mod platform;

// Re-export all public functions and types
pub use download::*;
pub use fs::*;
pub use package::*;
pub use platform::*;

// Rhai integration module
pub mod rhai;
