Rename packages and consolidate view components

- Rename firefoxopen package to firefoxview
- Rename w3mopenpage package to w3mview
- Rename gintestpage package to mocksite
- Rename Dump function to DumpPage
- Add newUtf8Envs to fix CJK text rendering in w3m
- Add Pane struct with injection via NewPaneWith
- Streamline package structure and API design
- Add English/Chinese comments
- Rename test functions (TestNewTable0 to TestNewTable_Blank)
- Use must.Done to reduce test boilerplate
- Update go.mod and go.sum
- Update release.yml with latest action versions
- Update README.md and README.zh.md
- Add SkipIfCommandNotFound to skip tests when w3m unavailable
- Add TestShow_ChineseTable and TestShow_ChineseWithBadLocale
- Add example tests

Author: yyle88

.github/workflows/release.yml

@@ -12,13 +12,13 @@ jobs:
     name: lint
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-go@v5
+      - uses: actions/checkout@v6
+      - uses: actions/setup-go@v6
         with:
           go-version: stable
           cache: true
       - name: golangci-lint
-        uses: golangci/golangci-lint-action@v8
+        uses: golangci/golangci-lint-action@v9
         with:
           version: latest
           args: --timeout=5m
@@ -27,11 +27,11 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        go: [ "1.22.x", "1.23.x", "1.24.x", "1.25.x", "stable" ]
+        go: [ "1.25.x", "stable" ]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-go@v5
+      - uses: actions/setup-go@v6
         with:
           go-version: ${{ matrix.go }}
           cache: true
@@ -82,18 +82,18 @@ jobs:
       security-events: write
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@v3
+        uses: github/codeql-action/init@v4
         with:
           languages: go
 
       - name: Auto Build
-        uses: github/codeql-action/autobuild@v3
+        uses: github/codeql-action/autobuild@v4
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v3
+        uses: github/codeql-action/analyze@v4
 
   # 发布 Release
   release:
@@ -105,7 +105,7 @@ jobs:
     steps:
       # 1. 检出代码
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0  # 获取完整历史用于生成更好的 release notes
 

README.md

@@ -1,13 +1,13 @@
 [![GitHub Workflow Status (branch)](https://img.shields.io/github/actions/workflow/status/go-xlan/go-webpage/release.yml?branch=main&label=BUILD)](https://github.com/go-xlan/go-webpage/actions/workflows/release.yml?query=branch%3Amain)
 [![GoDoc](https://pkg.go.dev/badge/github.com/go-xlan/go-webpage)](https://pkg.go.dev/github.com/go-xlan/go-webpage)
 [![Coverage Status](https://img.shields.io/coveralls/github/go-xlan/go-webpage/main.svg)](https://coveralls.io/github/go-xlan/go-webpage?branch=main)
-[![Supported Go Versions](https://img.shields.io/badge/Go-1.22.8+-lightgrey.svg)](https://go.dev/)
+[![Supported Go Versions](https://img.shields.io/badge/Go-1.25+-lightgrey.svg)](https://go.dev/)
 [![GitHub Release](https://img.shields.io/github/release/go-xlan/go-webpage.svg)](https://github.com/go-xlan/go-webpage/releases)
 [![Go Report Card](https://goreportcard.com/badge/github.com/go-xlan/go-webpage)](https://goreportcard.com/report/github.com/go-xlan/go-webpage)
 
 # go-webpage
 
-Convert Go struct slice to HTML table with browser automation.
+Convert Go struct slice to HTML table with Firefox/w3m output.
 
 ---
 
@@ -20,8 +20,8 @@ Convert Go struct slice to HTML table with browser automation.
 ## Main Features
 
 🎯 **Struct to HTML Table**: Convert Go struct slices to formatted HTML tables with custom tag support
-⚡ **Browser Automation**: Open generated HTML in Firefox; render in w3m console
-🔄 **Test Server**: Built-in HTTP test server supporting rapid webpage development and testing
+⚡ **HTML Output**: Open generated HTML in Firefox; display via w3m console
+🔄 **HTTP Test Host**: Built-in HTTP test service supporting rapid webpage development and testing
 🌍 **Flexible Options**: Customizable table headers, tag names, and rendering configurations
 📋 **XSS Protection**: HTML escaping built-in to prevent XSS vulnerabilities
 
@@ -43,23 +43,23 @@ import (
 	"github.com/go-xlan/go-webpage/slice2table"
 )
 
-type User struct {
+type Account struct {
 	Name string `table:"姓名"`
 	Age  int    `table:"年龄"`
 }
 
 func main() {
-	users := []*User{
+	accounts := []*Account{
 		{Name: "Alice", Age: 25},
 		{Name: "Bob", Age: 30},
 	}
 
-	htmlTable := slice2table.NewTable(users)
-	fmt.Println(htmlTable)
+	page := slice2table.NewTable(accounts)
+	fmt.Println(page)
 }
 ```
 
-### Browser Output
+### Firefox Output
 
 ```go
 package main
@@ -69,8 +69,7 @@ import (
 	"time"
 
 	"github.com/brianvoe/gofakeit/v7"
-	"github.com/go-xlan/go-webpage/firefoxopen"
-	"github.com/go-xlan/go-webpage/internal/utils"
+	"github.com/go-xlan/go-webpage/firefoxview"
 	"github.com/go-xlan/go-webpage/slice2table"
 	"github.com/yyle88/must"
 )
@@ -91,18 +90,18 @@ func main() {
 		newAdminInfo(),
 		newAdminInfo(),
 	}
-	page1 := utils.NewPage("admins", slice2table.NewTable(admins))
+	page1 := slice2table.NewTable(admins)
 
 	guests := []*GuestInfo{
 		newGuestInfo(),
 		newGuestInfo(),
 		newGuestInfo(),
 	}
-	page2 := utils.NewPage("guests", slice2table.NewTable(guests))
+	page2 := slice2table.NewTable(guests)
 
-	firefoxDraw := firefoxopen.NewFirefoxDraw()
-	defer firefoxDraw.Close(time.Minute)
-	firefoxDraw.ShowInNewTabs(page1, page2)
+	pane := firefoxview.NewPane()
+	defer pane.Close(time.Minute)
+	pane.ShowInNewTabs(page1, page2)
 	fmt.Println("done")
 }
 
@@ -131,61 +130,60 @@ import (
 	"time"
 
 	"github.com/brianvoe/gofakeit/v7"
-	"github.com/go-xlan/go-webpage/internal/utils"
 	"github.com/go-xlan/go-webpage/slice2table"
-	"github.com/go-xlan/go-webpage/w3mopenpage"
+	"github.com/go-xlan/go-webpage/w3mview"
 	"github.com/yyle88/must"
 	"github.com/yyle88/osexec"
 )
 
-type User struct {
-	ID        string    // 用户 ID
+type Account struct {
+	ID        string    // 账户 ID
 	Username  string    // 用户名
-	Email     string    // 邮箱
+	Mailbox   string    // 邮箱
 	Role      string    // 角色（如 admin, guest, student）
 	IsActive  bool      // 是否激活
 	CreatedAt time.Time // 创建时间
 }
 
-type Order struct {
-	ID        string    // 订单 ID
-	UserID    string    // 用户 ID
-	Total     float64   // 总金额
+type Invoice struct {
+	ID        string    // 账单 ID
+	AccountID string    // 账户 ID
+	Amount    float64   // 金额
 	Status    string    // 状态（如 pending, shipped）
-	OrderedAt time.Time // 下单时间
+	IssuedAt  time.Time // 签发时间
 }
 
 func main() {
-	users := []*User{
-		newUser(),
-		newUser(),
-		newUser(),
+	accounts := []*Account{
+		newAccount(),
+		newAccount(),
+		newAccount(),
 	}
-	page1 := utils.NewPage("users", slice2table.NewTable(users))
+	page1 := slice2table.NewTable(accounts)
 
-	orders := []*Order{
-		newOrder(),
-		newOrder(),
-		newOrder(),
+	invoices := []*Invoice{
+		newInvoice(),
+		newInvoice(),
+		newInvoice(),
 	}
-	page2 := utils.NewPage("orders", slice2table.NewTable(orders))
+	page2 := slice2table.NewTable(invoices)
 
-	commandConfig := osexec.NewOsCommand().WithDebug()
-	w3mopenpage.Show(commandConfig, page1)
-	w3mopenpage.Show(commandConfig, page2)
+	execConfig := osexec.NewOsCommand().WithDebug()
+	w3mview.Show(execConfig, page1)
+	w3mview.Show(execConfig, page2)
 	fmt.Println("done")
 }
 
-func newUser() *User {
-	user := &User{}
-	must.Done(gofakeit.Struct(user))
-	return user
+func newAccount() *Account {
+	account := &Account{}
+	must.Done(gofakeit.Struct(account))
+	return account
 }
 
-func newOrder() *Order {
-	order := &Order{}
-	must.Done(gofakeit.Struct(order))
-	return order
+func newInvoice() *Invoice {
+	invoice := &Invoice{}
+	must.Done(gofakeit.Struct(invoice))
+	return invoice
 }
 ```
 
@@ -198,7 +196,7 @@ func newOrder() *Order {
 ```go
 type Student struct {
 	Name string `custom:"Student Name"`
-	Grade int   `custom:"Grade Level"`
+	Grade int   `custom:"Grade Rank"`
 }
 
 students := []*Student{
@@ -214,8 +212,8 @@ table := slice2table.GenTable(students, options)
 ```go
 import "github.com/go-xlan/go-webpage/slice2table/struct2table"
 
-user := &User{Name: "Alice", Age: 25}
-table := struct2table.NewTable(user)
+account := &Account{Name: "Alice", Age: 25}
+table := struct2table.NewTable(account)
 ```
 
 ## API Reference
@@ -227,58 +225,73 @@ table := struct2table.NewTable(user)
 - `NewOptions() *Options` - Create default options
 - `(opts *Options) WithTagName(tagName string) *Options` - Set custom tag name
 
-### firefoxopen Package
+### struct2table Package
 
-- `OpenInNewWindows(command *osexec.OsCommand, urls ...string)` - Open URLs in new Firefox windows
-- `OpenInNewTabs(command *osexec.OsCommand, urls ...string)` - Open URLs in new Firefox tabs
-- `NewFirefoxDraw() *FirefoxShow` - Create Firefox output handler
+- `NewTable[T any](object *T) string` - Convert single struct to HTML table
+- `GenTable[T any](object *T, options *slice2table.Options) string` - Generate table with custom options
 
-### w3mopenpage Package
+### firefoxview Package
 
-- `NewW3mDrawPage() *W3mShowPage` - Create w3m output handler
-- `Show(page string)` - Show single page in console
-- `ShowPages(pages ...string)` - Show multiple pages
+- `Open(execConfig *osexec.OsCommand, urls []string, mode string)` - Open URLs in Firefox with mode
+- `OpenInNewWindows(execConfig *osexec.OsCommand, urls ...string)` - Open URLs in new Firefox windows
+- `OpenInNewTabs(execConfig *osexec.OsCommand, urls ...string)` - Open URLs in new Firefox tabs
+- `NewPane() *Pane` - Create Firefox output pane with default config
+- `NewPaneWith(pageSite *mocksite.PageSite, execConfig *osexec.OsCommand) *Pane` - Create pane with custom config
+- `(p *Pane) Close(waitTime time.Duration)` - Close pane when wait time elapses
+- `(p *Pane) ShowInNewWindows(pages ...string)` - Show pages in new windows
+- `(p *Pane) ShowInNewTabs(pages ...string)` - Show pages in new tabs
+- `(p *Pane) Show(pages []string, mode string)` - Show pages with mode
+- `(p *Pane) Open(pages []string, mode string)` - Alias of Show
 
-### gintestpage Package
+### w3mview Package
 
-- `NewService() *Service` - Create HTTP test server
-- `SetPage(path string, page []byte) string` - Set page and get URL
-- `GetLink(path string) string` - Get URL of page path
+- `Show(execConfig *osexec.OsCommand, page string)` - Display HTML page via w3m console
+- `Open(execConfig *osexec.OsCommand, link string)` - Open URL via w3m console
+- `DumpPage(execConfig *osexec.OsCommand, page string) string` - Process HTML and get text output
+- `DumpLink(execConfig *osexec.OsCommand, link string) string` - Fetch URL and return text
+- `NewPane() *Pane` - Create w3m output pane with default config
+- `NewPaneWith(pageSite *mocksite.PageSite, execConfig *osexec.OsCommand) *Pane` - Create pane with custom config
+- `(p *Pane) Close()` - Close pane and release resources
+- `(p *Pane) Show(page string)` - Show single page via pane
+- `(p *Pane) ShowPages(pages ...string)` - Show multiple pages via pane
 
-### utils Package
+### mocksite Package
 
-- `NewPage(subject string, content string) string` - Create complete HTML page with escaping
+- `NewPageSite() *PageSite` - Create HTTP test instance
+- `(s *PageSite) Close()` - Close test instance and release resources
+- `(s *PageSite) SetPage(path string, page []byte) string` - Set page and get access link
+- `(s *PageSite) GetLink(path string) string` - Get URL of page path
 
 ## Examples
 
 Check out the [examples](internal/demos/) path with more usage patterns:
 
-- [demo1x](internal/demos/demo1x/) - Gin test server with Firefox automation
+- [demo1x](internal/demos/demo1x/) - Mock site service with Firefox automation
 - [demo2x](internal/demos/demo2x/) - Multiple tables in Firefox tabs
 - [demo3x](internal/demos/demo3x/) - Console output with w3m
 - [demo4x](internal/demos/demo4x/) - W3m page output with multiple datasets
 
 <!-- TEMPLATE (EN) BEGIN: STANDARD PROJECT FOOTER -->
-<!-- VERSION 2025-09-26 07:39:27.188023 +0000 UTC -->
+<!-- VERSION 2025-11-25 03:52:28.131064 +0000 UTC -->
 
 ## 📄 License
 
-MIT License. See [LICENSE](LICENSE).
+MIT License - see [LICENSE](LICENSE).
 
 ---
 
-## 🤝 Contributing
+## 💬 Contact & Feedback
 
 Contributions are welcome! Report bugs, suggest features, and contribute code:
 
-- 🐛 **Found a mistake?** Open an issue on GitHub with reproduction steps
-- 💡 **Have a feature idea?** Create an issue to discuss the suggestion
-- 📖 **Documentation confusing?** Report it so we can improve
+- 🐛 **Mistake reports?** Open an issue on GitHub with reproduction steps
+- 💡 **Fresh ideas?** Create an issue to discuss
+- 📖 **Documentation confusing?** Report it so we can enhance it
 - 🚀 **Need new features?** Share the use cases to help us understand requirements
-- ⚡ **Performance issue?** Help us optimize through reporting slow operations
+- ⚡ **Performance issue?** Help us optimize via reporting slow operations
 - 🔧 **Configuration problem?** Ask questions about complex setups
-- 📢 **Follow project progress?** Watch the repo to get new releases and features
-- 🌟 **Success stories?** Share how this package improved the workflow
+- 📢 **Track project progress?** Watch the repo to get new releases and features
+- 🌟 **Success stories?** Share how this package enhanced the workflow
 - 💬 **Feedback?** We welcome suggestions and comments
 
 ---
@@ -292,8 +305,8 @@ New code contributions, follow this process:
 3. **Navigate**: Navigate to the cloned project (`cd repo-name`)
 4. **Branch**: Create a feature branch (`git checkout -b feature/xxx`).
 5. **Code**: Implement the changes with comprehensive tests
-6. **Testing**: (Golang project) Ensure tests pass (`go test ./...`) and follow Go code style conventions
-7. **Documentation**: Update documentation to support client-facing changes and use significant commit messages
+6. **Testing**: (Golang project) Ensure tests pass (`go test ./...`) and adhere to Go code style conventions
+7. **Documentation**: Update documentation to support client-facing changes
 8. **Stage**: Stage changes (`git add .`)
 9. **Commit**: Commit changes (`git commit -m "Add feature xxx"`) ensuring backward compatible code
 10. **Push**: Push to the branch (`git push origin feature/xxx`).