fix: address PR #28 review follow-ups

- Fix gallery .mxcli/widgets/gallery.def.json: FILTERSPLACEHOLDER → FILTER
  to match embedded def and DESCRIBE output
- Fix gallery .mxcli/widgets/gallery.def.json: add missing "default": "Single"
  for itemSelection to match embedded def
- Fix cmd_widget.go: log LoadUserDefinitions errors instead of swallowing
- Fix lsp_completion.go: log LoadUserDefinitions errors instead of swallowing
- Translate Chinese headers in design doc to English
- Fix FILTERSPLACEHOLDER → FILTER in design doc examples

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ako

.mxcli/widgets/gallery.def.json

@@ -17,7 +17,8 @@
     {
       "propertyKey": "itemSelection",
       "source": "Selection",
-      "operation": "selection"
+      "operation": "selection",
+      "default": "Single"
     },
     {
       "propertyKey": "itemSelectionMode",
@@ -78,7 +79,7 @@
     },
     {
       "propertyKey": "filtersPlaceholder",
-      "mdlContainer": "FILTERSPLACEHOLDER",
+      "mdlContainer": "FILTER",
       "operation": "widgets"
     }
   ]

cmd/mxcli/cmd_widget.go

@@ -5,6 +5,7 @@ package main
 import (
 	"encoding/json"
 	"fmt"
+	"log"
 	"os"
 	"path/filepath"
 	"strings"
@@ -195,7 +196,9 @@ func runWidgetList(cmd *cobra.Command, args []string) error {
 	// Load user definitions if project path available
 	projectPath, _ := cmd.Flags().GetString("project")
 	if projectPath != "" {
-		_ = registry.LoadUserDefinitions(projectPath)
+		if err := registry.LoadUserDefinitions(projectPath); err != nil {
+			log.Printf("warning: loading user widget definitions: %v", err)
+		}
 	}
 
 	defs := registry.All()

cmd/mxcli/lsp_completion.go

@@ -4,6 +4,7 @@ package main
 
 import (
 	"context"
+	"log"
 	"strings"
 
 	"github.com/mendixlabs/mxcli/mdl/executor"
@@ -89,8 +90,7 @@ func (s *mdlServer) widgetRegistryCompletions() []protocol.CompletionItem {
 			return
 		}
 		if err := registry.LoadUserDefinitions(s.mprPath); err != nil {
-			// Non-fatal: user definitions are optional
-			_ = err
+			log.Printf("warning: loading user widget definitions for LSP: %v", err)
 		}
 		for _, def := range registry.All() {
 			s.widgetCompletionItems = append(s.widgetCompletionItems, protocol.CompletionItem{

docs/plans/2026-03-25-pluggable-widget-engine-design.md

@@ -1,23 +1,23 @@
-# Pluggable Widget Engine: 声明式 Widget 构建系统
+# Pluggable Widget Engine: Declarative Widget Build System
 
 **Date**: 2026-03-25
 **Status**: Implemented
 
 ## Problem
 
-当前每个 pluggable widget 都需要硬编码一个 Go builder 函数（`buildComboBoxV3`, `buildGalleryV3` 等），加上 switch case 注册。新增一个 widget 需要改 4 个地方：
+Each pluggable widget currently requires a hardcoded Go builder function (`buildComboBoxV3`, `buildGalleryV3`, etc.) plus a switch-case registration. Adding a new widget requires changes in 4 places:
 
-1. `sdk/pages/pages_widgets_advanced.go` — 添加 WidgetID 常量
-2. `sdk/widgets/templates/` — 添加 JSON 模板
-3. `mdl/executor/cmd_pages_builder_v3_pluggable.go` — 写专属 build 函数（50-200 行）
-4. `mdl/executor/cmd_pages_builder_v3.go` — 在 `buildWidgetV3()` switch 中添加 case
+1. `sdk/pages/pages_widgets_advanced.go` — Add WidgetID constant
+2. `sdk/widgets/templates/` — Add JSON template
+3. `mdl/executor/cmd_pages_builder_v3_pluggable.go` — Write a dedicated build function (50-200 lines)
+4. `mdl/executor/cmd_pages_builder_v3.go` — Add case in `buildWidgetV3()` switch
 
-这导致：
-- 用户无法自行添加 pluggable widget 支持
-- 大量重复代码（30+ builder 函数共享 ~80% 骨架）
-- 维护成本随 widget 数量线性增长
+This causes:
+- Users cannot add pluggable widget support on their own
+- Significant code duplication (30+ builder functions sharing ~80% boilerplate)
+- Maintenance cost grows linearly with widget count
 
-## Solution: 声明式 Widget 定义 + 通用构建引擎
+## Solution: Declarative Widget Definitions + Generic Build Engine
 
 ### Architecture
 
@@ -126,7 +126,7 @@ Gallery (with child slots):
   "childSlots": [
     {"propertyKey": "content", "mdlContainer": "TEMPLATE", "operation": "widgets"},
     {"propertyKey": "emptyPlaceholder", "mdlContainer": "EMPTYPLACEHOLDER", "operation": "widgets"},
-    {"propertyKey": "filtersPlaceholder", "mdlContainer": "FILTERSPLACEHOLDER", "operation": "widgets"}
+    {"propertyKey": "filtersPlaceholder", "mdlContainer": "FILTER", "operation": "widgets"}
   ]
 }
 ```