docs: expand progress demos and table usage

Author: inhere

docs/progress.md

@@ -405,6 +405,35 @@ The default messages are `done`, `failed`, and `skipped`. `Done()` advances to t
 - `Len() int`
 - `VisibleLen() int`
 
+### Runnable Demos
+
+The `examples` directory contains runnable progress demos. They do not perform real network downloads; all work is simulated with in-memory data, timers, and goroutines.
+
+Fixed worker slot and safe logging demo:
+
+```bash
+go run ./examples/progress-multi-demo
+```
+
+Render mode demo:
+
+```bash
+go run ./examples/progress-render-mode-demo auto
+go run ./examples/progress-render-mode-demo dynamic
+go run ./examples/progress-render-mode-demo plain
+go run ./examples/progress-render-mode-demo disabled
+```
+
+`auto` selects `RenderDynamic` for interactive terminals and `RenderPlain` for non-interactive writers. `plain` is useful for CI logs and redirected output. `disabled` suppresses progress rendering while keeping log output.
+
+Byte tracker and concurrent writer demo:
+
+```bash
+go run ./examples/progress-byte-tracker-demo
+```
+
+This demo shows both `ByteTracker.Add()` from simulated chunk workers and `NewConcurrentWriterWithInterval()` with `io.Copy()` over an in-memory reader.
+
 ## Progress Bar
 
 ### Internal Widgets

docs/show.md

@@ -156,7 +156,9 @@ Env
 
 ### Table
 
-Use `show/table` when you need a tabular layout:
+Use `show/table` when command output needs aligned columns, such as user lists, process summaries, package results, or deployment reports.
+
+Basic table:
 
 ```go
 tb := table.New("Users")
@@ -178,6 +180,79 @@ Users
 +----+------+
 ```
 
+Rows can also be loaded in batches. `SetRows()` accepts common data shapes such as `[][]any`, `[]map[string]any`, and slices of structs:
+
+```go
+type Package struct {
+	Name    string `json:"name"`
+	Version string `json:"version"`
+	Status  string `json:"status"`
+}
+
+rows := []Package{
+	{Name: "fd", Version: "10.2.0", Status: "installed"},
+	{Name: "bat", Version: "0.25.0", Status: "pending"},
+}
+
+tb := table.New("Packages")
+tb.SetRows(rows)
+tb.Println()
+```
+
+For simple two-dimensional data, set headers first and pass a slice of rows:
+
+```go
+tb := table.New("Jobs")
+tb.SetHeads("Name", "Status", "Duration")
+tb.SetRows([][]any{
+	{"build", "ok", "12s"},
+	{"test", "failed", "31s"},
+})
+tb.Println()
+```
+
+Table styles and borders are configurable:
+
+```go
+tb := table.New("Release",
+	table.WithStyle(table.StyleRounded),
+	table.WithBorderFlags(table.BorderAll),
+	table.WithShowRowNumber(true),
+)
+tb.SetHeads("Package", "Status")
+tb.AddRow("cliui", "ready")
+tb.AddRow("docs", "updated")
+tb.Println()
+```
+
+Built-in styles include `StyleSimple`, `StyleMySql`, `StyleMarkdown`, `StyleBold`, `StyleBoldBorder`, `StyleRounded`, `StyleDouble`, and `StyleMinimal`.
+
+For long text, configure column width and overflow behavior:
+
+```go
+tb := table.New("Tasks")
+tb.SetHeads("Task", "Description")
+tb.AddRow("download", "Fetch archive from mirror and verify checksum")
+tb.AddRow("extract", "Unpack files into the selected destination")
+tb.WithOptions(
+	table.WithColumnWidths(12, 32),
+	table.WithColMaxWidth(32),
+	table.WithOverflowFlag(table.OverflowWrap),
+)
+tb.Println()
+```
+
+Use `OverflowCut` to truncate long content, or `OverflowWrap` to wrap it across multiple display lines. Use `WithSortColumn(index, ascending)` to sort rows by a column:
+
+```go
+tb := table.New("Results")
+tb.SetHeads("Name", "Status")
+tb.AddRow("test", "failed")
+tb.AddRow("build", "ok")
+tb.WithOptions(table.WithSortColumn(0, true))
+tb.Println()
+```
+
 ### JSON
 
 `JSON` prints formatted structured objects. It is useful for debugging, showing API responses, or returning machine-readable output.

docs/zh-CN/progress.md

@@ -423,6 +423,35 @@ bar.Skip()
 - `Len() int`
 - `VisibleLen() int`
 
+### 可运行 Demo
+
+`examples` 目录中提供了可直接运行的 progress 示例。这些示例不会进行真实网络下载，内部通过内存数据、定时器和 goroutine 模拟任务进度。
+
+固定 worker slot 和安全日志示例：
+
+```bash
+go run ./examples/progress-multi-demo
+```
+
+render mode 示例：
+
+```bash
+go run ./examples/progress-render-mode-demo auto
+go run ./examples/progress-render-mode-demo dynamic
+go run ./examples/progress-render-mode-demo plain
+go run ./examples/progress-render-mode-demo disabled
+```
+
+`auto` 会在交互终端中选择 `RenderDynamic`，在非交互 writer 中选择 `RenderPlain`。`plain` 适合 CI 日志和重定向输出，`disabled` 会关闭 progress 渲染但保留日志输出。
+
+byte tracker 和 concurrent writer 示例：
+
+```bash
+go run ./examples/progress-byte-tracker-demo
+```
+
+该示例同时展示了多个模拟 chunk worker 调用 `ByteTracker.Add()`，以及 `NewConcurrentWriterWithInterval()` 搭配 `io.Copy()` 处理内存 reader 的用法。
+
 ## Progress Bar
 
 ### 内置 Widgets

docs/zh-CN/show.md

@@ -156,7 +156,9 @@ Env
 
 ### Table
 
-需要表格布局时，可以使用 `show/table`：
+命令输出需要按列对齐时，可以使用 `show/table`，例如用户列表、进程摘要、包处理结果或部署报告。
+
+基础表格：
 
 ```go
 tb := table.New("Users")
@@ -178,6 +180,79 @@ Users
 +----+------+
 ```
 
+也可以批量加载行数据。`SetRows()` 支持常见数据形态，例如 `[][]any`、`[]map[string]any` 和结构体切片：
+
+```go
+type Package struct {
+	Name    string `json:"name"`
+	Version string `json:"version"`
+	Status  string `json:"status"`
+}
+
+rows := []Package{
+	{Name: "fd", Version: "10.2.0", Status: "installed"},
+	{Name: "bat", Version: "0.25.0", Status: "pending"},
+}
+
+tb := table.New("Packages")
+tb.SetRows(rows)
+tb.Println()
+```
+
+对于简单二维数据，可以先设置表头，再传入行切片：
+
+```go
+tb := table.New("Jobs")
+tb.SetHeads("Name", "Status", "Duration")
+tb.SetRows([][]any{
+	{"build", "ok", "12s"},
+	{"test", "failed", "31s"},
+})
+tb.Println()
+```
+
+表格样式和边框可以配置：
+
+```go
+tb := table.New("Release",
+	table.WithStyle(table.StyleRounded),
+	table.WithBorderFlags(table.BorderAll),
+	table.WithShowRowNumber(true),
+)
+tb.SetHeads("Package", "Status")
+tb.AddRow("cliui", "ready")
+tb.AddRow("docs", "updated")
+tb.Println()
+```
+
+内置样式包括 `StyleSimple`、`StyleMySql`、`StyleMarkdown`、`StyleBold`、`StyleBoldBorder`、`StyleRounded`、`StyleDouble` 和 `StyleMinimal`。
+
+长文本可以配置列宽和溢出策略：
+
+```go
+tb := table.New("Tasks")
+tb.SetHeads("Task", "Description")
+tb.AddRow("download", "Fetch archive from mirror and verify checksum")
+tb.AddRow("extract", "Unpack files into the selected destination")
+tb.WithOptions(
+	table.WithColumnWidths(12, 32),
+	table.WithColMaxWidth(32),
+	table.WithOverflowFlag(table.OverflowWrap),
+)
+tb.Println()
+```
+
+`OverflowCut` 会截断过长内容，`OverflowWrap` 会把内容换行显示。需要按列排序时，可以使用 `WithSortColumn(index, ascending)`：
+
+```go
+tb := table.New("Results")
+tb.SetHeads("Name", "Status")
+tb.AddRow("test", "failed")
+tb.AddRow("build", "ok")
+tb.WithOptions(table.WithSortColumn(0, true))
+tb.Println()
+```
+
 ### JSON
 
 `JSON` 用于格式化输出结构化对象，适合调试、展示 API 响应或输出机器可读的结果。