Rename kit package to ui

adrianpk · adrianpk · commit 0131af568cf2 · 2026-02-17T14:01:17.000+01:00
diff --git a/docs/features.md b/docs/features.md
@@ -17,7 +17,7 @@
 | `middleware` | Request ID, role-based access, rate limiting, locale detection, static cache |
 | `render` | Template FuncMap utilities, i18n integration |
 | `render/ui` | UI components (Badge, Chip, Price, Stat, Button, Link, Form, Input, Alert, Toast) |
-| `kit` | UI kit with dependency injection, HTMX-first components, emoji support, CSRF integration |
+| `ui` | UI kit with dependency injection, HTMX-first components, emoji support, CSRF integration |
 | `modal` | Modal dialog configuration |
 | `pagination` | Generic pagination (`Result[T]`) |
 | `i18n` | Internationalization with YAML translation files |
diff --git a/ui/assets.go b/ui/assets.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"embed"
diff --git a/ui/assets_test.go b/ui/assets_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"embed"
diff --git a/ui/button.go b/ui/button.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"fmt"
diff --git a/ui/button_test.go b/ui/button_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"strings"
diff --git a/ui/chip.go b/ui/chip.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"fmt"
diff --git a/ui/chip_test.go b/ui/chip_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"strings"
diff --git a/ui/emoji.go b/ui/emoji.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 // Emoji represents an emoji character.
 type Emoji string
diff --git a/ui/emoji_test.go b/ui/emoji_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import "testing"
 
diff --git a/ui/form.go b/ui/form.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"fmt"
diff --git a/ui/form_test.go b/ui/form_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"strings"
diff --git a/ui/funcmap.go b/ui/funcmap.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"html/template"
diff --git a/ui/funcmap_test.go b/ui/funcmap_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"testing"
@@ -7,12 +7,12 @@ import (
 	"github.com/hatmaxkit/hatmax/log"
 )
 
-func TestKitFuncMap(t *testing.T) {
+func TestUIFuncMap(t *testing.T) {
 	cfg := config.New()
 	logger := log.NewTestLogger("error")
-	kit := New(cfg, logger)
+	u := New(cfg, logger)
 
-	fm := kit.FuncMap()
+	fm := u.FuncMap()
 
 	funcs := []string{
 		"chip", "label",
diff --git a/ui/kit.go b/ui/kit.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"context"
diff --git a/ui/kit_test.go b/ui/kit_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"context"
diff --git a/ui/layout.go b/ui/layout.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"fmt"
diff --git a/ui/layout_test.go b/ui/layout_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"html/template"
diff --git a/ui/nav.go b/ui/nav.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"fmt"
diff --git a/ui/nav_test.go b/ui/nav_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"strings"
diff --git a/ui/readme.md b/ui/readme.md
@@ -1,21 +1,21 @@
-# kit
+# ui
 
 UI kit with dependency injection, emoji support, and HTMX-first components.
 
 ## Usage
 
 ```go
-kit := kit.New(cfg, log,
-    kit.WithSettings(settingsSvc),
-    kit.WithOverlay(os.DirFS("./custom")),
-    kit.WithCSRFFunc(csrf.Token),  // integrate with your CSRF middleware
+ui := ui.New(cfg, log,
+    ui.WithSettings(settingsSvc),
+    ui.WithOverlay(os.DirFS("./custom")),
+    ui.WithCSRFFunc(csrf.Token),  // integrate with your CSRF middleware
 )
 
 // Template functions
-tmpl := template.New("page").Funcs(kit.FuncMap())
+tmpl := template.New("page").Funcs(ui.FuncMap())
 
 // Or standalone (no kit instance)
-tmpl := template.New("page").Funcs(kit.FuncMap())
+tmpl := template.New("page").Funcs(ui.FuncMap())
 ```
 
 ## CSRF Integration
@@ -24,64 +24,64 @@ The kit integrates with external CSRF middleware via `WithCSRFFunc`:
 
 ```go
 // Your CSRF package provides a function to extract token from context
-kit := kit.New(cfg, log, kit.WithCSRFFunc(csrf.Token))
+ui := ui.New(cfg, log, ui.WithCSRFFunc(csrf.Token))
 
 // Then in handlers, get token from kit
-token := kit.CSRFToken(r.Context())
+token := ui.CSRFToken(r.Context())
 
 // Pass to forms
-form := kit.NewForm().Action("/submit").CSRFToken(token)
-deleteBtn := kit.NewDeleteButton("Delete", "/items/1").CSRFToken(token)
+form := ui.NewForm().Action("/submit").CSRFToken(token)
+deleteBtn := ui.NewDeleteButton("Delete", "/items/1").CSRFToken(token)
 ```
 
 ## Components
 
 ### Chip (rounded) and Label (squared)
 
 ```go
-chip := kit.NewChip("Active").Emoji(kit.EmojiCheck).Success()
-label := kit.NewLabel("Important").Emoji(kit.EmojiWarning).Warning()
+chip := ui.NewChip("Active").Emoji(ui.EmojiCheck).Success()
+label := ui.NewLabel("Important").Emoji(ui.EmojiWarning).Warning()
 ```
 
 ### Button
 
 ```go
-btn := kit.NewButton("Save").Emoji(kit.EmojiSave).Primary()
-btn := kit.NewButton("Delete").Emoji(kit.EmojiTrash).Danger()
+btn := ui.NewButton("Save").Emoji(ui.EmojiSave).Primary()
+btn := ui.NewButton("Delete").Emoji(ui.EmojiTrash).Danger()
 
 // With HTMX
-btn := kit.NewButton("Load").HX().Get("/data").TargetID("result").Done()
+btn := ui.NewButton("Load").HX().Get("/data").TargetID("result").Done()
 ```
 
 ### Layout
 
 ```go
-page := kit.NewPage("Dashboard").
+page := ui.NewPage("Dashboard").
     Header(header).
     Content(content).
     Footer(footer)
 
-header := kit.NewPageHeader("Settings").
+header := ui.NewPageHeader("Settings").
     Subtitle("Configure your app").
     Breadcrumbs(
-        kit.Breadcrumb{Label: "Home", Href: "/"},
-        kit.Breadcrumb{Label: "Settings"},
+        ui.Breadcrumb{Label: "Home", Href: "/"},
+        ui.Breadcrumb{Label: "Settings"},
     ).
     Actions(saveBtn, cancelBtn)
 
-container := kit.NewContainer().Content(html).Fluid()
+container := ui.NewContainer().Content(html).Fluid()
 ```
 
 ### Navigation
 
 ```go
-nav := kit.NewNavGrid().
-    AddItem(kit.EmojiHome, "Dashboard", "/").
-    AddItem(kit.EmojiSettings, "Settings", "/settings").
-    AddItemWithBadge(kit.EmojiMail, "Messages", "/messages", "5").
+nav := ui.NewNavGrid().
+    AddItem(ui.EmojiHome, "Dashboard", "/").
+    AddItem(ui.EmojiSettings, "Settings", "/settings").
+    AddItemWithBadge(ui.EmojiMail, "Messages", "/messages", "5").
     Cols(3)
 
-menu := kit.NewNav().
+menu := ui.NewNav().
     AddLink("Home", "/", true).
     AddLink("About", "/about", false).
     Vertical()
@@ -90,15 +90,15 @@ menu := kit.NewNav().
 ### Table
 
 ```go
-table := kit.NewTable().
+table := ui.NewTable().
     Columns(
-        kit.Col("name", "Name").WithWidth("200px"),
-        kit.Col("email", "Email"),
-        kit.Col("actions", "").WithAlign("right"),
+        ui.Col("name", "Name").WithWidth("200px"),
+        ui.Col("email", "Email"),
+        ui.Col("actions", "").WithAlign("right"),
     ).
     Rows(
-        kit.NewRow(kit.Text("Alice"), kit.Text("alice@example.com"), kit.HTML(actions)),
-        kit.NewRow(kit.Text("Bob"), kit.Text("bob@example.com"), kit.HTML(actions)),
+        ui.NewRow(ui.Text("Alice"), ui.Text("alice@example.com"), ui.HTML(actions)),
+        ui.NewRow(ui.Text("Bob"), ui.Text("bob@example.com"), ui.HTML(actions)),
     ).
     Striped().
     Hoverable().
@@ -108,7 +108,7 @@ table := kit.NewTable().
 ### Form (with CSRF support)
 
 ```go
-form := kit.NewForm().
+form := ui.NewForm().
     Action("/submit").
     CSRFToken(csrfToken).
     Post()
@@ -120,7 +120,7 @@ form := kit.NewForm().
 {{ form.Close }}
 
 // With HTMX
-form := kit.NewForm().
+form := ui.NewForm().
     HX().Post("/api/submit").TargetID("result").Done().
     CSRFToken(csrfToken)
 ```
@@ -129,13 +129,13 @@ form := kit.NewForm().
 
 ```go
 // Safe delete: renders as form, not link (bots can't accidentally trigger)
-deleteBtn := kit.NewDeleteButton("Delete", "/items/123").
+deleteBtn := ui.NewDeleteButton("Delete", "/items/123").
     CSRFToken(csrfToken).
     Confirm("Are you sure?").
-    Emoji(kit.EmojiTrash)
+    Emoji(ui.EmojiTrash)
 
 // With HTMX
-deleteBtn := kit.NewDeleteButton("Delete", "").
+deleteBtn := ui.NewDeleteButton("Delete", "").
     HX().Delete("/api/items/123").SwapDelete().Confirm("Sure?").Done().
     CSRFToken(csrfToken)
 ```
@@ -149,7 +149,7 @@ schemas := []settings.Schema{
     {Key: "theme", Type: settings.Enum, Options: []string{"light", "dark"}},
 }
 
-form := kit.NewSettingsForm(schemas).
+form := ui.NewSettingsForm(schemas).
     Values(currentValues).
     Errors(validationErrors).
     Action("/settings").
@@ -159,7 +159,7 @@ form := kit.NewSettingsForm(schemas).
 ### Assets
 
 ```go
-assets := kit.NewAssets(embeddedFS).
+assets := ui.NewAssets(embeddedFS).
     WithOverlay(os.DirFS("./custom")).
     WithPrefix("/static")
 
@@ -172,24 +172,24 @@ url := assets.URL("css/style.css") // "/static/css/style.css"
 ## Emoji Presets
 
 ```go
-kit.EmojiCheck    // ✅
-kit.EmojiCross    // ❌
-kit.EmojiWarning  // ⚠️
-kit.EmojiInfo     // ℹ️
-kit.EmojiStar     // ⭐
-kit.EmojiHeart    // ❤️
-kit.EmojiTrash    // 🗑
-kit.EmojiSettings // ⚙
-kit.EmojiUser     // 👤
-kit.EmojiHome     // 🏠
-kit.EmojiSave     // 💾
+ui.EmojiCheck    // ✅
+ui.EmojiCross    // ❌
+ui.EmojiWarning  // ⚠️
+ui.EmojiInfo     // ℹ️
+ui.EmojiStar     // ⭐
+ui.EmojiHeart    // ❤️
+ui.EmojiTrash    // 🗑
+ui.EmojiSettings // ⚙
+ui.EmojiUser     // 👤
+ui.EmojiHome     // 🏠
+ui.EmojiSave     // 💾
 // ... see emoji.go for full list
 ```
 
 Custom emojis:
 
 ```go
-chip := kit.NewChip("Coffee").Emoji("☕")
+chip := ui.NewChip("Coffee").Emoji("☕")
 ```
 
 ## Variants
diff --git a/ui/settings.go b/ui/settings.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"fmt"
diff --git a/ui/settings_test.go b/ui/settings_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"strings"
diff --git a/ui/table.go b/ui/table.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"fmt"
diff --git a/ui/table_test.go b/ui/table_test.go
@@ -1,4 +1,4 @@
-package kit
+package ui
 
 import (
 	"html/template"
diff --git a/ui/testdata/sample.txt b/ui/testdata/sample.txt

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-package kit`
	`1`	`+package ui`
`2`	`2`
`3`	`3`	`import (`
`4`	`4`	`"embed"`