chore: refresh bun.lock and apply pickier --fix

Author: glennmichael123

CONFIG_FEATURES.md

@@ -3,6 +3,7 @@
 ## Overview
 
 zig-cli includes a powerful configuration system supporting three popular formats:
+
 - **TOML** - Simple, readable configuration format
 - **JSONC** - JSON with Comments (also handles standard JSON)
 - **JSON5** - JSON with extended syntax (more JavaScript-like)
@@ -14,18 +15,21 @@ zig-cli includes a powerful configuration system supporting three popular format
 Each format has its own strengths:
 
 **TOML:**
+
 - Simple, INI-like syntax
 - Great for human editing
 - Native support for nested tables
 - Comments with `#`
 
 **JSONC:**
+
 - JSON with `//` and `/* */` comments
 - Trailing commas allowed
 - Familiar to JavaScript developers
 - Works with standard JSON files too
 
 **JSON5:**
+
 - Unquoted object keys
 - Single and double quotes for strings
 - Trailing commas
@@ -44,7 +48,7 @@ const AppConfig = struct {
         host: []const u8,
         port: u16,
     },
-    log_level: enum { debug, info, warn, @"error" } = .info,
+    log*level: enum { debug, info, warn, @"error" } = .info,
     debug: bool = false,
 };
 
@@ -69,6 +73,7 @@ defer config.deinit();
 ```
 
 Search locations (in order):
+
 1. `./myapp.{toml,json5,jsonc,json}`
 2. `./.config/myapp.{toml,json5,jsonc,json}`
 3. `~/.config/myapp/myapp.{toml,json5,jsonc,json}`
@@ -80,19 +85,19 @@ First found file is loaded.
 For cases where you don't have a schema, use the raw `Config` type:
 
 ```zig
-var raw_config = cli.config.Config.init(allocator);
-defer raw_config.deinit();
+var raw*config = cli.config.Config.init(allocator);
+defer raw*config.deinit();
 
-try raw_config.loadFromFile("config.toml", .auto);
+try raw*config.loadFromFile("config.toml", .auto);
 
 // Typed getters with optional returns
-const name = raw_config.getString("name");        // ?[]const u8
-const port = raw_config.getInt("port");           // ?i64
-const debug = raw_config.getBool("debug");        // ?bool
-const timeout = raw_config.getFloat("timeout");   // ?f64
+const name = raw*config.getString("name");        // ?[]const u8
+const port = raw*config.getInt("port");           // ?i64
+const debug = raw*config.getBool("debug");        // ?bool
+const timeout = raw*config.getFloat("timeout");   // ?f64
 
 // Raw value access for complex types
-const value = raw_config.get("database");         // ?*Value
+const value = raw*config.get("database");         // ?*Value
 ```
 
 ### 5. Nested Configuration
@@ -127,18 +132,18 @@ timeout = 30
 Auto-detect based on file extension:
 
 ```zig
-try raw_config.loadFromFile("config.toml", .auto);  // Detects TOML
-try raw_config.loadFromFile("config.json5", .auto); // Detects JSON5
-try raw_config.loadFromFile("config.jsonc", .auto); // Detects JSONC
-try raw_config.loadFromFile("config.json", .auto);  // Treats as JSONC
+try raw*config.loadFromFile("config.toml", .auto);  // Detects TOML
+try raw*config.loadFromFile("config.json5", .auto); // Detects JSON5
+try raw*config.loadFromFile("config.jsonc", .auto); // Detects JSONC
+try raw*config.loadFromFile("config.json", .auto);  // Treats as JSONC
 ```
 
 Or specify explicitly:
 
 ```zig
-try raw_config.loadFromFile("myfile", .toml);
-try raw_config.loadFromFile("myfile", .jsonc);
-try raw_config.loadFromFile("myfile", .json5);
+try raw*config.loadFromFile("myfile", .toml);
+try raw*config.loadFromFile("myfile", .jsonc);
+try raw*config.loadFromFile("myfile", .json5);
 ```
 
 ## Implementation Details
@@ -173,7 +178,7 @@ Unified `Value` type across all formats:
 
 ```zig
 pub const Value = union(enum) {
-    null_value: void,
+    null*value: void,
     boolean: bool,
     integer: i64,
     float: f64,
@@ -195,7 +200,7 @@ pub const Config = struct {
     // Loading
     pub fn loadFromFile(path, format) !void
     pub fn loadFromString(content, format) !void
-    pub fn discover(allocator, app_name) !Config
+    pub fn discover(allocator, app*name) !Config
 
     // Accessing
     pub fn get(key) ?*Value
@@ -217,7 +222,7 @@ The `ConfigLoader` provides the high-level typed API:
 // These are available via cli.config namespace:
 pub fn load(comptime T: type, allocator, path) !ConfigLoader(T)
 pub fn loadFromString(comptime T: type, allocator, content, format) !ConfigLoader(T)
-pub fn discover(comptime T: type, allocator, app_name) !ConfigLoader(T)
+pub fn discover(comptime T: type, allocator, app*name) !ConfigLoader(T)
 ```
 
 ## Usage Examples
@@ -236,7 +241,7 @@ const ServerConfig = struct {
 
 pub fn main() !void {
     var gpa = std.heap.GeneralPurposeAllocator(.{}){};
-    defer _ = gpa.deinit();
+    defer * = gpa.deinit();
     const allocator = gpa.allocator();
 
     // Load typed config
@@ -284,22 +289,22 @@ fn serverAction(ctx: *cli.BaseCommand.ParseContext) !void {
 ### Untyped Config with Nested Values
 
 ```zig
-var raw_config = cli.config.Config.init(allocator);
-defer raw_config.deinit();
+var raw*config = cli.config.Config.init(allocator);
+defer raw*config.deinit();
 
-try raw_config.loadFromFile("config.toml", .auto);
+try raw*config.loadFromFile("config.toml", .auto);
 
 // Access nested database config
-if (raw_config.get("database")) |db_value| {
-    if (db_value.* == .table) {
-        const db_table = &db_value.table;
+if (raw*config.get("database")) |db*value| {
+    if (db*value.* == .table) {
+        const db*table = &db*value.table;
 
-        const host = if (db_table.get("host")) |h|
+        const host = if (db*table.get("host")) |h|
             if (h == .string) h.string else "localhost"
         else
             "localhost";
 
-        const port = if (db_table.get("port")) |p|
+        const port = if (db*table.get("port")) |p|
             if (p == .integer) p.integer else 5432
         else
             5432;
@@ -376,6 +381,7 @@ zig build run-config
 ## Summary
 
 The configuration system provides:
+
 - **3 format parsers** with full feature support (TOML, JSONC, JSON5)
 - **Type-safe API** via `cli.config.load(T, ...)` for compile-time schema validation
 - **Untyped API** via `cli.config.Config` for dynamic config access

FEATURE_PARITY.md

@@ -5,6 +5,7 @@ This document tracks the feature parity between zig-cli and the clapp TypeScript
 ## Implemented Features
 
 ### CLI Framework
+
 - [x] **Fluent Builder API** - Chainable methods for intuitive CLI construction
 - [x] **Command System** - Full command routing with nested subcommands
 - [x] **Command Aliases** - Support for command shortcuts (e.g., `build`, `b`)
@@ -18,6 +19,7 @@ This document tracks the feature parity between zig-cli and the clapp TypeScript
 - [x] **Type-Safe Commands** - `cli.Command(T)` with compile-time validated struct-based options
 
 ### Interactive Prompts
+
 - [x] **TextPrompt** - Text input with placeholder and validation
 - [x] **ConfirmPrompt** - Yes/No confirmation
 - [x] **SelectPrompt** - Single selection from list
@@ -30,6 +32,7 @@ This document tracks the feature parity between zig-cli and the clapp TypeScript
 - [x] **Message Prompts** - intro, outro, note, log, cancel
 
 ### Terminal & UI
+
 - [x] **Terminal Detection** - Unicode/ASCII support detection
 - [x] **Color Support** - ANSI colors with NO_COLOR respect
 - [x] **Dimension Detection** - Terminal width/height via ioctl
@@ -43,11 +46,13 @@ This document tracks the feature parity between zig-cli and the clapp TypeScript
 - [x] **Keyboard Events** - Full keyboard handling (arrows, enter, backspace, etc.)
 
 ### State Management
+
 - [x] **State Machine** - 5-state system (initial -> active <-> error -> submit/cancel)
 - [x] **Event System** - Event types for value, cursor, key, submit, cancel
 - [x] **State Transitions** - Validated state transitions
 
 ### Configuration
+
 - [x] **TOML Parser** - Full TOML format support
 - [x] **JSONC Parser** - JSON with comments
 - [x] **JSON5 Parser** - Extended JSON syntax
@@ -56,6 +61,7 @@ This document tracks the feature parity between zig-cli and the clapp TypeScript
 - [x] **Format Auto-detection** - Based on file extension
 
 ### Architecture
+
 - [x] **Memory Safety** - Explicit allocators, proper cleanup
 - [x] **Error Handling** - Zig error unions throughout
 - [x] **Cross-platform** - macOS, Linux support (Windows partial)
@@ -64,6 +70,7 @@ This document tracks the feature parity between zig-cli and the clapp TypeScript
 ## Partially Implemented
 
 ### Terminal
+
 - [~] **Windows Support** - Basic structure exists, needs full implementation
   - Terminal raw mode placeholder
   - Console API integration needed
@@ -72,6 +79,7 @@ This document tracks the feature parity between zig-cli and the clapp TypeScript
 ## Not Yet Implemented (from clapp)
 
 ### Additional Prompt Types
+
 - [ ] **DatePrompt** - Date/time selection
 - [ ] **AutocompletePrompt** - Text input with suggestions
 - [ ] **GroupMultiselectPrompt** - Grouped multi-selection
@@ -81,26 +89,31 @@ This document tracks the feature parity between zig-cli and the clapp TypeScript
 - [ ] **StreamPrompt** - Streaming output display
 
 ### UI Components
+
 - [ ] **Tree Rendering** - Hierarchical tree display
 
 ### Advanced Features
+
 - [ ] **Theme System** - Customizable color themes
 - [ ] **Lifecycle Hooks** - SIGINT, SIGTERM, error handlers
 - [ ] **Shell Completion** - Generate shell completions
 - [ ] **Async Iterables** - Stream support for async operations
 
 ### Testing Utilities
+
 - [ ] **Mock Prompts** - Testing helpers for prompts
 - [ ] **Output Capture** - Capture and test CLI output
 - [ ] **File System Mocks** - Testing file operations
 
 ### Utilities
+
 - [ ] **Vim Keybindings** - hjkl navigation support
 - [ ] **Markdown Processing** - Render markdown in terminal
 
 ## Feature Completion Stats
 
 ### Core Features (Critical)
+
 - **CLI Framework**: 100%
 - **Basic Prompts**: 100% (text, confirm, select, multiselect, password)
 - **Advanced Prompts**: 100% (number, path, group, spinner)
@@ -109,12 +122,14 @@ This document tracks the feature parity between zig-cli and the clapp TypeScript
 - **Configuration**: 100% (TOML, JSONC, JSON5, typed loader, auto-discovery)
 
 ### Advanced Features
+
 - **Style System**: 95% (colors, chaining, backgrounds - themes missing)
 - **CLI Advanced**: 100% (aliases, middleware, typed commands)
 - **Platform Support**: 80% (Unix fully supported, Windows partial)
 
 ### Overall Completion
-**Estimated: ~95% feature parity**
+
+#### Estimated: ~95% feature parity
 
 All commonly used features are fully implemented. The remaining items (tree rendering, specialized prompt types, shell completion) are lower-priority specialized features.
 

FINAL_SUMMARY.md

@@ -19,6 +19,7 @@ A **comprehensive CLI library for Zig 0.16+** with extensive feature parity to p
 ### 1. CLI Framework (100% Complete)
 
 **Core:**
+
 - Fluent Builder API
 - Command routing with nested subcommands
 - Command aliases
@@ -30,13 +31,15 @@ A **comprehensive CLI library for Zig 0.16+** with extensive feature parity to p
 - Middleware system (pre/post hooks, built-in: logging, timing, validation)
 
 **Type-Safe Layer:**
+
 - `cli.Command(T)` - auto-generates options from struct fields
 - `cli.Context(T)` - compile-time validated field access
 - `cli.Action(T)` - typed action function signatures
 
 ### 2. Interactive Prompts (10 Types)
 
 **Basic:**
+
 - TextPrompt - with validation & placeholders
 - ConfirmPrompt - Yes/No
 - SelectPrompt - Single choice
@@ -45,11 +48,13 @@ A **comprehensive CLI library for Zig 0.16+** with extensive feature parity to p
 - NumberPrompt - Integer/Float with min/max
 
 **Advanced:**
+
 - SpinnerPrompt - Animated loading
 - PathPrompt - File/directory with Tab autocomplete
 - GroupPrompt - Sequential prompts with shared state
 
 **UI/Messages:**
+
 - Message prompts (intro, outro, note, log, cancel)
 - ProgressBar - 4 styles, percentage, count
 - Box rendering - 4 border styles
@@ -58,6 +63,7 @@ A **comprehensive CLI library for Zig 0.16+** with extensive feature parity to p
 ### 3. Styling & Terminal
 
 **Styling:**
+
 - ANSI colors (16 colors)
 - Text styles (bold, dim, italic, underline)
 - Style chaining - `style(text).red().bold().underline()`
@@ -66,6 +72,7 @@ A **comprehensive CLI library for Zig 0.16+** with extensive feature parity to p
 - Symbols library
 
 **Terminal:**
+
 - Raw mode handling
 - Cursor control (hide/show, save/restore)
 - Dimension detection (width/height)
@@ -76,11 +83,13 @@ A **comprehensive CLI library for Zig 0.16+** with extensive feature parity to p
 ### 4. Configuration System (100% Complete)
 
 **Formats:**
+
 - TOML parser
 - JSONC parser (JSON with comments)
 - JSON5 parser (extended JSON)
 
 **Features:**
+
 - Type-safe loading via `cli.config.load(T, ...)`
 - Auto-discovery of config files
 - Untyped access via `cli.config.Config`
@@ -170,7 +179,7 @@ const GreetOptions = struct {
     verbose: bool = false,
 };
 
-fn greet(ctx: *cli.Context(GreetOptions)) !void {
+fn greet(ctx: _cli.Context(GreetOptions)) !void {
     const name = ctx.get(.name);  // Compile-time validated!
     std.debug.print("Hello, {s}!\n", .{name});
 }
@@ -233,7 +242,7 @@ var progress = prompt.ProgressBar.init(allocator, 100, "Processing");
 try progress.start();
 
 for (0..100) |i| {
-    _ = std.c.nanosleep(&.{ .sec = 0, .nsec = 50 * std.time.ns_per_ms }, null);
+    _ = std.c.nanosleep(&.{ .sec = 0, .nsec = 50 _ std.time.ns_per_ms }, null);
     try progress.update(i + 1);
 }
 
@@ -274,7 +283,7 @@ try table.render();
 | **Terminal** | yes | yes | 90% |
 | **Middleware** | yes | yes | 100% |
 
-**Overall: ~95% feature parity**
+#### Overall: ~95% feature parity
 
 ### What's Still Missing (Low Priority)
 
@@ -321,15 +330,17 @@ zig build run-showcase # Run the showcase
 
 ---
 
-## Why zig-cli?
+## Why zig-cli
 
 ### vs TypeScript/JavaScript CLIs
+
 - **10-100x smaller binaries**
 - **Instant startup** (no Node.js runtime)
 - **Type safety** at compile time
 - **No dependencies** to manage
 
 ### vs Other Zig CLI libs
+
 - **Most feature-complete**
 - **Interactive prompts included**
 - **Configuration support built-in**