iter(g282): 代码块支持长行折行

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T15:06:03.807Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T15:08:10.710Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -2270,6 +2270,7 @@ diffView({ before: oldText, after: newText })
 - lang：string —— 语言名（如 ts / css）；无 title 时作头部标题
 - title：string —— 头部标题（如文件名）；优先于 lang
 - lineNumbers：boolean —— 是否显示行号列；缺省 true（单行代码自动省略）
+- wrap：boolean —— 长行是否折行（窄屏 / 长日志场景）；缺省 false（横向滚动，行号保持对齐）
 - maxHeight：number —— 代码区最高高度（px），超出在框内滚动；缺省不限高
 - copyable：boolean —— 右上角是否出现复制按钮；缺省 true
 - onCopy：(text: string) => void —— 复制成功回调（参数为实际写入剪贴板的内容）
@@ -2288,6 +2289,7 @@ codeBlock({ code: source, title: 'main.ts', lang: 'ts', maxHeight: 320 })
 3. 长代码给 maxHeight，超出在框内滚动；滚动条已是统一细条，暗色下不会露原生亮条
 4. 单行代码自动省掉行号列；想彻底不要行号传 lineNumbers: false
 5. 不需要复制按钮（例如代码本身是操作步骤）传 copyable: false；连标题都没有时头部整条省掉
+6. 窄屏或长日志要折行就传 wrap: true：长行按容器宽度换行，行号仍只占首行左侧；对齐要求高的代码别开，折行会让缩进失去参照
 
 现场演示：apps/docs/demo.html#sec-code