// Derived from PDFium's core/fxcrt/widestring.h/.cpp
// Original: Copyright 2014 The PDFium Authors
// Licensed under BSD-3-Clause / Apache-2.0
// See pdfium-upstream/LICENSE for the original license.

//! Wide-character string type (upstream compatibility alias).
//!
//! PDFium's `WideString` is a copy-on-write class wrapping wide characters
//! (`wchar_t`, typically UTF-16 on Windows / UTF-32 on Linux).
//!
//! In rpdfium, all text is represented as UTF-8 [`String`], which is a
//! strict superset of PDFium's string semantics. This module provides a
//! type alias so that code and documentation can reference the upstream name.

/// Upstream-compatible alias for PDFium's `WideString`.
///
/// `WideString` in PDFium is a wide-character string (wchar_t-based, UTF-16
/// on Windows).  In Rust, the equivalent is `String` (UTF-8), which provides
/// identical Unicode semantics without platform-specific width variation.
///
/// This alias exists purely for documentation clarity and upstream traceability.
/// It is fully interchangeable with [`String`].
///
/// Corresponds to `WideString` / `CFX_WideString` in `core/fxcrt/widestring.h`.
pub type WideString = String;
