feat: add runtime table builder and pretty-csv utility (#73)

* feat: add runtime table builder and pretty-csv utility

Implements `TableBuilder` for dynamic row management during runtime.
Introduces `pretty-csv` binary for rendering text tables from CSV/TSV data.
Updates install script and documentation coverage.

* feat(pretty-table): add DynTable for dynamic tables

Refactor pretty-csv to use the new DynTable module instead of custom rendering logic.

Remove duplicate width detection and truncation implementation to leverage library features. Update documentation to reflect changes in pretty-table and add new packages.

* fmt

* refactor(pretty-table): rename APIs and expand features

Rename API types for semantic clarity:
- Rename `TableBuilder(N)` to `Table(N).Owned`.
- Rename `DynTable` to `RuntimeTable`.

Add support for more complex data representations:
- Add `transpose` mode and row separators to `Table(N)`.
- Add footer support, per-column alignment, and `"{f}"` formatting to `RuntimeTable`.
- Expose `--row-separator` and `--right-columns` flags to CLI tools.

This enables flexible row representations and precise numerical alignment in reports.

* fix(pretty-csv): remove column filtering limit

Remove hardcoded 256 column limit in filtering by utilizing dynamic memory allocation. Previously, columns exceeding this threshold were silently truncated.

Improve visual truncation accuracy by counting UTF-8 code points instead of bytes for accurate alignment and representation of multi-byte characters.

Author: jiacai2050

CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## Unreleased
+
+### New Programs
+- **pretty-csv**: Pretty-print CSV/TSV files as aligned tables
+  - Auto-fits table width to terminal, truncates with `…`
+  - Three border styles: `ascii`, `box`, `dos`
+  - Transpose mode (`-t`): show each record as vertical key-value block
+  - Column selection (`-c 1,3,5`): display only specific columns
+  - Row separators (`--row-separator`) and right-aligned selected columns (`-r 2,4`)
+  - Configurable delimiter, padding, and max input size
+
+### Improvements
+- **pretty-table**: `Table(N).Owned` runtime row helper with string shorthand and Cell-level control
+  - `Table(N)` and `Table(N).Owned`: optional transpose mode
+  - `RuntimeTable`: runtime column count with footer rows, header/footer cell setters, row separators, per-column alignment, `"{f}"` formatting, optional cell truncation, and UTF-8-safe truncation boundaries
+  - Windows targets skip POSIX terminal-width probing during cross-compilation
+- **pretty-csv**: column filtering no longer truncates silently when CSV inputs exceed 256 columns
+
+### Documentation
+- Added `gitignore` package docs
+- Updated `pretty-table` and `simargs` docs for Zig 0.15 API
+
 ## v0.4.0 (2026-03-18)
 
 ### New Programs

build.zig

@@ -119,6 +119,7 @@ fn buildBinaries(
         "tcp-proxy",
         "timeout",
         "cowsay",
+        "pretty-csv",
         "zfetch",
         "progress",
     }) |name| {

docs/content/install.org

@@ -51,7 +51,8 @@ Then in your =build.zig=, import the module like this:
 #+begin_src zig
 const zigcli = b.dependency("zigcli", .{});
 
-// Currently zigcli provide two packages.
+// Currently zigcli provides three packages.
 exe.root_module.addImport("simargs", zigcli.module("simargs"));
 exe.root_module.addImport("pretty-table", zigcli.module("pretty-table"));
+exe.root_module.addImport("gitignore", zigcli.module("gitignore"));
 #+end_src

docs/content/packages/gitignore.org

@@ -0,0 +1,54 @@
+#+TITLE: gitignore
+#+DATE: 2026-03-20T08:45:00+0800
+#+LASTMOD: 2026-03-20T08:45:00+0800
+#+TYPE: docs
+#+WEIGHT: 30
+#+DESCRIPTION: Pure Zig .gitignore pattern matching — no libc dependency
+
+* Features
+- Full [[https://git-scm.com/docs/gitignore][.gitignore spec]] support: =*=, =?=, =[abc]=, =**/=, negation (=!=)
+- Recursive =.gitignore= filtering via =GitignoreStack= (per-directory layers)
+- Pure Zig implementation — no =libc= =fnmatch= dependency
+- Last-match-wins semantics across all layers
+
+* API
+
+** =Gitignore=
+Parse a single =.gitignore= file and match paths against it.
+
+#+begin_src zig
+const gitignore = @import("gitignore");
+
+var gi = try gitignore.Gitignore.init(allocator, content);
+defer gi.deinit();
+
+if (gi.shouldIgnore("build/output.o", false)) {
+    // path is ignored
+}
+#+end_src
+
+** =GitignoreStack=
+Manage a stack of =.gitignore= layers for recursive directory walks.
+Each layer is anchored to its directory, and patterns are evaluated with
+correct relative paths.
+
+#+begin_src zig
+const gitignore = @import("gitignore");
+
+var stack = gitignore.GitignoreStack.init();
+defer stack.deinit(allocator);
+
+// Push a layer when entering a directory.
+const pushed = try stack.tryPushDir(dir, rel_dir, allocator);
+
+if (stack.shouldIgnore(rel_path, is_dir)) {
+    // path is ignored
+}
+
+// Pop when leaving the directory.
+if (pushed) stack.pop(allocator);
+#+end_src
+
+* Used by
+- =tree=: Respects =.gitignore= when listing directory trees.
+- =loc=: Skips ignored files when counting lines of code.