Fix iterator and container property syntax throughout handbook

[Copilot]

The handbook incorrectly documented iterator and container APIs with method call syntax when they are properties. Based on official CovScript test files, .begin, .end, .data, .empty, .front, and .back are properties, not methods. Additionally, .next() modifies iterators in-place rather than returning new instances.

Changes

Iterator API corrections (syntax/10-iterators.md)

• .begin() → .begin, .end() → .end, .data() → .data (45+ instances)
• it = it.next() → it.next() (40+ instances)
• Removed confusing custom iterator example

Container property corrections (6 files)

• .empty() → .empty (6 instances)
• .front() → .front, .back() → .back (3 instances)

Example

Before:

var it = list.begin()
while it != list.end()
    system.out.println(it.data())
    it = it.next()  # Wrong: next() modifies in-place
end

After:

var it = list.begin
while it != list.end
    system.out.println(it.data)
    it.next()  # Correct: modifies iterator directly
end

All changes verified against covscript/covscript/tests and covscript/covscript-example.

Original prompt

请根据下面的资料（参考仓库中的 .csc/.csp/.ecs）对当前的更改进行审查、改进，不要纠结于前面的进度：
https://github.com/covscript/covscript/tree/master/tests
https://github.com/covscript/covscript-example/tree/main/examples
https://github.com/covscript/covscript-gmssl
https://github.com/covscript/ecs
https://github.com/covscript/cspkg
https://github.com/covscript/covscript-network
https://github.com/covscript/covscript-imgui
https://github.com/covscript/covanalysis
https://github.com/covscript/picasso-ui
https://github.com/covscript/csdbc
文档：
https://manual.covscript.org.cn/
博客：
https://unicov.cn/2025/10/10/covscript-asyncio/

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[mikecovlee]

@copilot 从你个人的建议来看，是否应当统一方法调用？现在这样有的时候需要()，有的时候又不需要，似乎有点confusing

[Copilot]

@copilot 从你个人的建议来看，是否应当统一方法调用？现在这样有的时候需要()，有的时候又不需要，似乎有点confusing

这是个很好的设计问题。从语言设计角度看，当前的区分方式（属性用.property，方法用.method()）是许多语言（如Python、C#）的常见模式，有以下优势：

1. 语义清晰：属性表示状态（如.size、.empty），方法表示动作（如.push_back()、.next()）
2. 性能提示：属性通常是O(1)访问，方法可能有计算开销
3. API设计灵活性：可以用属性做延迟计算，用方法做带副作用的操作

不过您说得对，这确实会让初学者感到困惑。如果要统一调用方式，需要在CovScript解释器层面做改动，不是手册能解决的。手册现在记录的是实际API行为。

如果考虑改进，可能的方向：

• 允许属性也可以加()调用（向后兼容）
• 或在文档中更明确地说明这个设计原则

您觉得哪个方向更合适？