refactor: array 模块收口定型骨架与子模块头

crates/oxide_builtins/src/array/common.rs

@@ -1,3 +1,5 @@
+//! Array 族共享助手：`this`/类数组解析、长度与回调校验，以及 `array_ptr` 族宏。
+
 use oxide_kernel::shape_forge::EMPTY_SHAPE_ID;
 use oxide_types::object::{JsObject, MAX_DENSE_PROPS};
 use oxide_types::value::JsValue;

crates/oxide_builtins/src/array/element.rs

@@ -1,3 +1,5 @@
+//! Array 元素变更与查找方法（push/pop/slice/splice/concat/join/indexOf 等）。
+
 use oxide_types::object::JsObject;
 use oxide_types::value::JsValue;
 

crates/oxide_builtins/src/array/from.rs

@@ -1,3 +1,5 @@
+//! Array 构造器与静态方法（constructor / isArray / of / from）及 species 构造辅助。
+
 use oxide_kernel::shape_forge::EMPTY_SHAPE_ID;
 use oxide_types::object::{JsObject, PropAttributes, MAX_DENSE_PROPS};
 use oxide_types::private_key::make_well_known_symbol_key;

crates/oxide_builtins/src/array/immutable.rs

@@ -1,3 +1,5 @@
+//! Array ES2023 不可变方法族（toReversed/with/toSorted/toSpliced）。
+
 use oxide_types::value::JsValue;
 
 use oxide_runtime_api::{NativeResult, VmHost};

crates/oxide_builtins/src/array/iterate.rs

@@ -1,3 +1,5 @@
+//! Array 高阶迭代方法（for_each/map/filter/reduce/find/some/every/flatMap 等）。
+
 use oxide_types::value::JsValue;
 
 use oxide_runtime_api::{NativeResult, VmHost};

crates/oxide_builtins/src/array/mod.rs

@@ -1,3 +1,8 @@
+//! Array 内置对象实现（constructor、静态方法与全部 Array.prototype 方法）。
+//!
+//! 按职责分 `common` 共享助手（含 `array_ptr` 族宏）、`from` 构造器与静态方法、`element` 元素变更与查找、
+//! `iterate` 高阶迭代、`sort_iterator` 排序与迭代协议、`immutable` ES2023 不可变方法族；各族经本模块重导出。
+
 mod common;
 pub(crate) use common::*;
 

crates/oxide_builtins/src/array/sort_iterator.rs

@@ -1,3 +1,5 @@
+//! Array 排序方法与迭代协议（sort/values/entries/keys/iterator_next 及迭代器构造）。
+
 use oxide_kernel::shape_forge::EMPTY_SHAPE_ID;
 use oxide_types::object::JsObject;
 use oxide_types::value::JsValue;