docs: 添加 Rustdoc 注释

crates/oxide_builtins/src/lib.rs

@@ -1,22 +1,53 @@
+//! OxideJS 内置对象层（builtins）。
+//!
+//! 本 crate 实现 ECMAScript 内置对象与全局函数的 native 实现，包括 Array、String、
+//! Date、Object、Map、Set、JSON、Math、Number、RegExp、Symbol、TypedArray、
+//! ArrayBuffer、DataView、Reflect、Function、Error 与全局函数（URI/escape 等）。
+//! 每个内置方法以 `fn xxx<H: VmHost>(vm, args: &[u8]) -> NativeResult` 形式暴露，
+//! 由上层（oxide_vm / oxide_api）注册为 JS 全局对象上的 native function。
+//! 尚未支持的特性（Proxy、BigInt、WeakMap 等）在 `stubs` 中以占位实现占位并抛 TypeError。
+
+/// Array 内置对象实现（constructor 与全部 Array.prototype 方法）。
 pub mod array;
+/// ArrayBuffer 内置对象实现（字节缓冲区与 byteLength/slice/isView）。
 pub mod array_buffer;
+/// Boolean 内置对象实现（constructor 与 prototype 的 valueOf/toString）。
 pub mod boolean;
+/// builtins 层日志宏（`builtins_error`/`builtins_info` 等），target 为 `oxide::builtins`。
 pub mod builtins_log;
+/// DataView 内置对象实现（对 ArrayBuffer 的定点读写视图）。
 pub mod data_view;
+/// Date 内置对象实现（时间戳存取、get/set 系列与 to*String 系列）。
 pub mod date;
+/// Error 内置对象实现（各类 Error 构造函数与 stack/toString）。
 pub mod error;
+/// Function 内置对象实现（call/apply/bind/toString）。
 pub mod function;
+/// 全局函数模块（URI 编解码与 Annex B 的 escape/unescape）。
 pub mod global;
+/// 迭代器相关实现（Iterator 包装、for-of 底层迭代逻辑）。
 pub mod iterator;
+/// JSON 内置对象实现（parse/stringify）。
 pub mod json;
+/// Map 内置对象实现（键值集合与 entries/keys/values 迭代）。
 pub mod map;
+/// Math 内置对象实现（数学函数）。
 pub mod math;
+/// Number 内置对象实现（constructor 与 toFixed/isInteger 等）。
 pub mod number;
+/// Object 内置对象实现（keys/create/assign/defineProperty 等静态方法）。
 pub mod object;
+/// Reflect 内置对象实现（属性操作镜像）。
 pub mod reflect;
+/// RegExp 内置对象实现（constructor/test/exec/toString）。
 pub mod regexp;
+/// Set 内置对象实现（值集合与 entries/values/keys 迭代）。
 pub mod set;
+/// String 内置对象实现（constructor 与全部 String.prototype 方法）。
 pub mod string;
+/// 未实现特性的占位 native 实现（统一抛 TypeError）。
 pub mod stubs;
+/// Symbol 内置对象实现（constructor/for/keyFor/toString）。
 pub mod symbol;
+/// TypedArray 内置对象实现（元素访问、fill/slice/subarray/set 等）。
 pub mod typed_array;