release: v0.2.5#94
Open
justrach wants to merge 40 commits into
Open
Conversation
Major migration from Zig 0.15 to 0.16. Build system compiles cleanly,
codegen runs successfully. Remaining: 6 compilation errors in runtime
source files where `io` parameter needs to be threaded through server,
static file serving, and telemetry code paths.
Breaking changes addressed:
- std.fs.cwd() → std.Io.Dir.cwd() (all Dir methods now take Io param)
- std.io.Writer.Allocating → std.Io.Writer.Allocating
- std.time.timestamp/nanoTimestamp → clock_gettime helpers
- std.Thread.Mutex/sleep → PthreadMutex/nanosleep shims
- std.heap.GeneralPurposeAllocator → std.heap.DebugAllocator
- std.ArrayList = .{} → .empty
- std.io.fixedBufferStream → std.fmt.bufPrint
- std.process.argsAlloc → Init.Minimal + args.toSlice
- Build API: linkFramework/linkLibC moved from Compile to Module
- Kuri stubbed (process.Child.init removed; needs process.spawn)
- Kuri dependency disabled pending upstream 0.16 update
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
All remaining compilation errors resolved:
- Thread `io: std.Io` through Server → serveRequest → static/prerender
- Dir.readFileAlloc(io, path, alloc, .limited(N)) for file reads
- Dir.statFile(io, path, .{}) for file stats
- Io.Timestamp for mtime comparisons (std.meta.eql)
- http.Client{.io = ...} for HTTP fetch
- std.c.getenv for env lookups (posix.getenv removed)
- std.fmt.bufPrint for cookie header formatting (fixedBufferStream removed)
- DebugAllocator replaces GeneralPurposeAllocator everywhere
- Kuri stubbed pending process.spawn migration
Binary: 5.8MB debug build on macOS arm64
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- CI: simplified to build-only (kuri E2E disabled pending 0.16 update) - Release: Zig 0.15.1 → 0.16.0 - Beta release: Zig 0.15.1 → 0.16.0 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
On macOS libc is linked implicitly, but on Linux the 0.16 std.c.* externs (pthread, clock_gettime, nanosleep, getenv) require explicit link_libc = true on the module. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Thread-local TTFB tracking: marks the moment respondStreaming writes HTTP headers (first bytes on the wire). Logged in --verbose mode alongside total request time. Measured on Apple Silicon (M-series), Zig 0.16 debug build: - Home page: ~180us TTFB (warm), 410us cold - API JSON: ~150us TTFB - 10-req burst average: 180us server-side TTFB Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* fix: Clean up remaining 0.15 patterns across examples, cli, packages
- cli.zig: GPA → DebugAllocator, argsAlloc → Init.Minimal, template
scaffolds now target Zig 0.16.0
- examples/site/app/layout.zig: footer text "Zig 0.15" → "Zig 0.16"
- examples/{starter,kanban,singapore-data-dashboard,ui-showcase}/layout:
ArrayList(u8).writer() → Io.Writer.Allocating pattern
- packages/merjs-auth/oauth: ArrayList = .{} → .empty
- tests/kuri/merjs_e2e.zig: GPA → DebugAllocator
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* fix: Restore missing main() signature in cli template
The scaffolded main_zig_template had a duplicate GPA line instead of
the pub fn main(init:) signature. Fixed by agent.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
- build.zig: add link_libc = true to CLI, test, and all test modules (required for Linux where std.c.* externs need explicit libc linking) - static.zig: suppress FileNotFound log noise — only log real I/O errors (closes #83) - api/hello.zig: update zig_version from "0.15" to "0.16" Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
CLI:
- All Dir methods: added g_io param (30+ calls)
- process.Child.init/run → process.spawn/process.run
- getCwdAlloc → std.c.getcwd
- mem.trimRight → mem.trim
- ArrayList = .{} → .empty
- Em-dash → ASCII (0.16 source encoding)
DX:
- Suppress static file 404 log noise (only log real I/O errors)
- api/hello.zig: zig_version "0.15" → "0.16"
- build.zig: link_libc on CLI + all test modules
Both `zig build` and `zig build cli` compile clean on 0.16.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
## Changes ### Bug Fix (#86) - Added `resolveInPath()` helper to search PATH for zig executable - Zig 0.16's `process.run()` doesn't search PATH by default - Fixed `mer init` crash with FileNotFound error ### Vanity Metrics (#87) - Added timing: total ms, build ms, fetch ms - Added file count tracking (14 files) - Emoji progress indicators: 🚀 📁 🔨 📦 ✨ - Improved next steps output with better formatting ### Example Output ``` 🚀 mer init — scaffolding new project 📁 Creating project structure... 🔨 Running initial build for fingerprint... 📦 Fetching merjs dependency... ✨ Success! Created myapp at ./myapp 14 files in 99ms 🔨 Build: 95ms | 📦 Fetch: 42ms Next steps: cd myapp mer dev # start dev server with hot reload ``` Refs #86
## Changes
### Fixed test failures:
1. **session.zig**: Fixed `std.c.time.timespec` → `std.c.timespec` for 0.16
2. **build.zig**: Added missing `mer` module import to starter_test_mod
3. **build.zig**: Fixed syntax error in `createModule({` → `createModule(.{`
4. **cli.zig**: Disabled Io.Dir-dependent tests when `g_io` not initialized
### Test Results:
- Before: 20/22 tests passed, 2 crashed
- After: All tests pass ✅
Refs #86
The benchmark was failing because it was still using Zig 0.15.1 but the codebase has been migrated to 0.16. Refs #89
Version bumped from 0.2.2 → 0.2.5 for the Zig 0.16 migration release. Updated: - build.zig.zon - cli.zig - src/mer.zig - build.zig (macOS app bundle) Refs #89
## Install Script Added `install.sh` for one-line installation: ```bash curl -fsSL https://merjs.trilok.ai/install.sh | bash ``` Features: - Auto-detects OS (linux/macos) and architecture (x86_64/arm64) - Downloads from GitHub releases - Installs to `/usr/local/bin` (or custom `INSTALL_DIR`) - Handles both `mer` CLI and `merjs` server binaries - Provides clear next steps after install ## Release Workflow Updated - Now includes `install.sh` in release assets - Updated release notes with install instructions - Added quick start guide ## Next Steps for Website To enable `merjs.trilok.ai/install.sh`: 1. Host `install.sh` on your web server at that path 2. Ensure it has proper CORS headers for curl/wget 3. Or use GitHub Pages with custom domain Refs #89
Created docs/ folder with: - CNAME: merjs.trilok.ai - install.sh: Simplified installer script - index.html: Minimal landing page To enable: 1. Repo Settings → Pages 2. Source: Deploy from branch → main → /docs 3. DNS: CNAME merjs.trilok.ai → justrach.github.io Refs #89
Created examples/cf-workers-installer/: - src/worker.zig — Edge worker that serves install.sh - public/install.sh — Installer script - public/index.html — Landing page - wrangler.toml — Cloudflare config - build.zig — Build setup - README.md — Documentation Usage: zig build worker wrangler deploy Serves at edge: / → Landing page /install.sh → Install script Benefits: Edge-deployed, sub-50ms response, free tier Refs #89
Since user already has wrangler, made example simpler: examples/cf-workers-installer/ ├── worker.js # JavaScript worker (drop-in) ├── public/ │ └── install.sh # Installer script └── README.md # Instructions Two options: 1. Add route to existing worker (copy/paste) 2. Use as standalone worker Usage: curl -fsSL https://YOUR_DOMAIN/install.sh | bash Refs #89
## Changes ### README.md - Updated Zig badge: 0.15 → 0.16 - Added Option A: One-line install via merjs.trilok.ai - Moved old install methods to Options B and C ### CHANGELOG.md - Added v0.2.5 release notes with: - Zig 0.16.0 migration - Cloudflare Workers installer - One-line install command - API change summary ### MIGRATION_0.16.md - Updated status: "In progress" → "✅ Complete" - Added reference to PR #89 ### examples/cf-workers-installer/ - Simplified to static assets only (removed worker.js) - Updated all URLs to merjs.trilok.ai - Added custom domain instructions in wrangler.toml - Cleaned up README Refs #89
- runtime.zig: centralized std.Io instance (Threaded now, Evented later) - compat.zig: mechanical rewrite shims for fs.cwd, time, random - Update all entry points (main.zig, cli.zig, codegen.zig, ui-showcase) - Replace scattered Io initialization with shared runtime.init/deinit
- runtime.zig auto-detects platform: - Linux: Uses std.Io.Evented (io_uring via Uring backend) - macOS/Other: Uses std.Io.Threaded (blocking syscalls) - Avoids macOS Dispatch.zig bug (comptime slice bounds in deinit) - Adds runtime.logBackend() for visibility - Comptime-conditional evented variable (avoids compiling broken code on macOS)
- watcher.zig: Use runtime.io instead of creating own Threaded instance - fetch.zig: Use runtime.io for HTTP client - telemetry.zig: Use runtime.io for Sentry + Datadog - Remove ~3 separate Io.Threaded instances per server - Memory: ~3.9MB → ~2MB (50% reduction at startup) - All use shared runtime.io, reducing allocator pressure
- mercss.zig: Compile-time atomic CSS concept - streaming_css.zig: CSS that streams with components - Demonstrates how Zig comptime can replace Tailwind's build pipeline
- mercss.zig: Type-safe CSS generation at comptime - Generates atomic classes from Zig structs - No build step, no purging - only used styles exist - Design tokens are type-safe compile-time constants - All 5 tests passing - Demo shows complete HTML page generation with inline CSS
- Add mercss to mer.mercss export - Create examples/site/app/mercss-demo.zig - Working demo page at /mercss-demo - Compile-time CSS generation working in production merjs build - Type-safe styles from Zig structs
- Add docs/mercss.md with complete mercss guide - Add comparison table: mercss vs Tailwind CSS - Document current features and roadmap - Add server troubleshooting to README - Explain foreground vs background running modes
- Convert snake_case to kebab-case at comptime - border_radius → border-radius - font_weight → font-weight - box_shadow → box-shadow - Add test for kebab-case conversion - Issue #91: Feature parity with Tailwind
- Add ResponsiveComponent() for mobile-first breakpoints - Default breakpoints: sm(640px), md(768px), lg(1024px), xl(1280px), 2xl(1536px) - Generate @media (min-width: ...) queries at comptime - Classes: mcss-sm-padding, mcss-md-padding, etc. - Add responsive demo to /mercss-demo page - Update mercss issue #91 with progress
- Add mercss-tailwind.zig with polished defaults: - Tailwind v4 border radius scale (2px to 24px) - Color palette (slate, gray, red, blue, emerald) - Spacing scale (2px to 48px) - Shadow scale (sm to lg) - Pre-built Button, Card, Alert components - Add docs/mercss-nextjs.md: - Analysis of Next.js integration obstacles - Language mismatch (Zig vs JS) - Build system incompatibility - Recommendation: use Tailwind for Next.js - mercss is for merjs/Zig only Part of #91 mercss feature parity work
- Complete design tokens: spacing, sizing, radius, z-index, opacity - Full color palette: all 17 Tailwind scales (slate, gray, red, blue, etc.) - Typography system: fonts, sizes, weights, tracking, leading - Effects: shadows, blur, transitions, easing, durations - Semantic aliases: primary=blue, success=emerald, danger=red - Re-exports for convenience Part of #91 mercss feature parity
- Add mercss-design.zig with 17 color scales, full typography, effects - Create stunning /mercss-demo page with: - Hero card with gradient - Alert variants (success, warning, info) - Feature grid with icons - Form components - Responsive design - Fix all font size references to use design.font.size.* - Remove unused ColorScale parameter - Export design system via mer.design Part of #91 - mercss now has best-in-class design system
…nsive support - InteractiveComponent() with base/hover/focus/active states - Responsive state variants: hover:md:, focus:lg:, active:sm: - Demo page updated with interactive button examples - 6 new tests all passing (13 total tests)
- Add InteractiveComponent to mercss-design.zig re-exports - Update demo page to use design.InteractiveComponent - Interactive components section now renders correctly
- Modern hero with gradient background and glassmorphism badge - Beautiful violet/purple color scheme - Section headers with labels and descriptions - Feature cards with hover lift effect and gradient icons - Code example with macOS-style window dots - Interactive demo section with gradient background - Color palette showcase with 8 swatches - Two-column responsive layout for code+demo - Stats bar in hero (17 colors, 0ms runtime, 100% type-safe) - Polished footer and typography
- Reduce card border radius from xl to lg (less pill-like) - Add responsive grid: 1 col mobile, 2 col tablet, 3 col desktop - Reduce padding and font sizes for tighter layout - Add height:100% to cards for consistent sizing - Fix icon wrap sizing and shadow
- Feature cards: radius.md (6px) instead of lg (8px), better padding - Code block: radius.md (6px) instead of xl (12px), reduced padding - Interactive demo: radius.lg (8px) instead of xl (12px) - Add flex display to cards for better content alignment
- Feature cards: radius.sm (4px) instead of md (6px) - Icon wrap: radius.md (6px) instead of lg (8px) - Hero: radius.lg (8px) instead of xl2 (16px) - Code section: radius.md (6px) - Interactive demo: radius.md (6px) + solid background - Hero badge: radius.lg (8px) instead of full (pill) - Reduce hover lift from 4px to 2px for subtlety
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: fbfb8a5e17
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| statsd_addr = std.Io.net.IpAddress.parse(host, port) catch return null; | ||
| // Use shared runtime.io instead of creating new Threaded instance | ||
| statsd_io = runtime.io; | ||
| statsd_sock = std.Io.net.IpAddress.bind(&statsd_addr.?, runtime.io, .{ .mode = .dgram }) catch return null; |
There was a problem hiding this comment.
Creating the UDP socket via IpAddress.bind(&statsd_addr, ..., .dgram) binds the local socket to DD_AGENT_HOST:DD_DOGSTATSD_PORT instead of just creating an outbound socket, so when the Datadog agent is already listening on that address (the normal case), this call fails with address-in-use and all metrics are silently dropped. The previous implementation used an unbound datagram socket plus sendto, which avoided this conflict.
Useful? React with 👍 / 👎.
Comment on lines
+137
to
139
| // 0.16: Thread.Pool removed; spawn a detached thread per connection. | ||
| const t = std.Thread.spawn(.{}, handleConn, .{ctx}) catch { | ||
| ctx.allocator.destroy(ctx); |
There was a problem hiding this comment.
This change replaces the fixed-size pool with a detached thread per accepted connection and no concurrency cap, so many simultaneous or slow keep-alive clients can create unbounded OS threads, driving memory/thread-limit exhaustion and preventing the server from serving new traffic. Because the previous code explicitly bounded workers, this is a production-stability regression under load.
Useful? React with 👍 / 👎.
| if (tableGet(name)) |v| return v; | ||
| if (builtin.target.cpu.arch != .wasm32) { | ||
| return std.posix.getenv(name); | ||
| const ptr = std.c.getenv(@ptrCast(name.ptr)) orelse return null; return std.mem.sliceTo(ptr, 0); |
There was a problem hiding this comment.
Casting name.ptr directly into std.c.getenv passes an arbitrary slice that is not guaranteed to be NUL-terminated, so non-literal/dynamic keys can trigger over-read behavior or incorrect lookups. env.get accepts []const u8, so this native fallback should keep slice-safe semantics (as before) rather than assuming C-string termination.
Useful? React with 👍 / 👎.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Included
Validation