fix: add compatibility for Zig 0.16 ArrayList and timer changes

.github/workflows/benchmark.yml

@@ -26,9 +26,9 @@ jobs:
               uses: actions/checkout@v4
 
             - name: Setup Zig
-              uses: goto-bus-stop/setup-zig@v2
+              uses: mlugg/setup-zig@v2
               with:
-                  version: 0.15.1
+                  version: 0.16.0
 
             - name: Display platform information
               shell: bash

.github/workflows/deploy_docs.yml

@@ -45,7 +45,7 @@ jobs:
               uses: actions/checkout@v3
               with:
                   fetch-depth: 0 # Not needed if lastUpdated is not enabled
-            - uses: goto-bus-stop/setup-zig@v2
+            - uses: mlugg/setup-zig@v2
               with:
                   cache: false
             - name: Generate Docs

.github/workflows/format-check.yml

@@ -17,9 +17,9 @@ jobs:
               uses: actions/checkout@v4
 
             - name: Setup Zig
-              uses: goto-bus-stop/setup-zig@v2
+              uses: mlugg/setup-zig@v2
               with:
-                  version: 0.15.1
+                  version: 0.16.0
 
             - name: Check code formatting
               run: zig fmt --check .

.github/workflows/test.yml

@@ -25,7 +25,7 @@ jobs:
                 # 架构配置标识符
                 arch_config: [linux-x86_64, linux-aarch64, macos-arm64, windows-x86_64]
                 # 定时任务只测试 master 版本，其他情况测试所有版本
-                version: ${{ github.event_name == 'schedule' && fromJSON('["master"]') || fromJSON('["0.14.1", "0.15.1", "master"]') }}
+                version: ${{ github.event_name == 'schedule' && fromJSON('["master"]') || fromJSON('["0.14.1", "0.15.1", "0.16.0", "master"]') }}
                 include:
                     # Linux x86_64
                     - arch_config: linux-x86_64
@@ -56,7 +56,7 @@ jobs:
                   fetch-depth: 0
 
             - name: Setup Zig
-              uses: goto-bus-stop/setup-zig@v2
+              uses: mlugg/setup-zig@v2
               with:
                   version: ${{ matrix.version }}
 

AGENT.md

@@ -230,8 +230,7 @@ defer result.free(allocator);           // 释放内存
 
 ### 5.1 支持的 Zig 版本
 
-- ✅ **完全支持**：Zig 0.14.x, 0.15.x
-- ⚠️ **部分支持**：Zig 0.16 (nightly)
+- ✅ **完全支持**：Zig 0.14.x, 0.15.x, 0.16.0
 
 ### 5.2 关键差异点
 

CLAUDE.md

@@ -21,13 +21,16 @@ zig build docs
 ```
 
 ### Zig Version Compatibility
-- **Currently supports**: Zig 0.14.0 and 0.15.x
-- **Partial support**: Zig 0.16 (nightly) - may have compatibility issues
+- **Currently supports**: Zig 0.14.0, 0.15.x, and 0.16.0
 - **Legacy support**: Zig 0.11-0.13 (use library version 0.0.6 for Zig 0.13 and older)
 - Code uses version detection (`builtin.zig_version.minor`) to handle API differences:
   - Endianness enum changes (`.Big`/`.Little` vs `.big`/`.little`)
   - ArrayList API changes in Zig 0.15+ (allocator parameter required for methods)
+  - ArrayList initialization changes in Zig 0.16 (`std.ArrayList(T){}` removed, use `initCapacity`)
   - Build system API differences between versions
+  - `std.time.Timer` removed in 0.16 (benchmarks use `std.Io.Clock.awake` instead)
+  - `std.heap.GeneralPurposeAllocator` removed in 0.16 (replaced with `page_allocator`)
+  - `std.io.fixedBufferStream` removed in 0.16 (compat layer provides `BufferStream`)
 
 ## Architecture
 
@@ -79,4 +82,4 @@ Tests use Zig's built-in testing framework. The test suite in `src/test.zig` cov
 
 ## CI/CD
 
-GitHub Actions workflow tests against multiple Zig versions (0.14.0, 0.15.1, nightly) to ensure compatibility.
+GitHub Actions workflow tests against multiple Zig versions (0.14.1, 0.15.1, 0.16.0, and master) to ensure compatibility.

README.md

@@ -47,12 +47,12 @@ This library is tested and optimized for all major platforms and architectures:
 | 0.13 and older       | 0.0.6           | Legacy support                        |
 | 0.14.0               | Current         | ✅ Fully supported                    |
 | 0.15.x               | Current         | ✅ Fully supported                    |
-| 0.16.0-dev (nightly) | Current         | ✅ Supported with compatibility layer |
+| 0.16.0               | Current         | ✅ Supported with compatibility layer |
 
 > **Note:** For Zig 0.13 and older versions, please use version `0.0.6` of this library.
 > **Note:** Zig 0.16+ removes `std.io.FixedBufferStream`, but this library provides a compatibility layer to maintain the same API across all supported versions.
 
-For Zig `0.14.0`, `0.15.x`, and `0.16.0-dev`, follow these steps:
+For Zig `0.14.0`, `0.15.x`, and `0.16.0`, follow these steps:
 
 1.  **Add as a dependency:**
     Add the library to your `build.zig.zon` file. You can fetch a specific commit or branch.

README_CN.md

@@ -47,12 +47,12 @@ Zig 编程语言的 MessagePack 实现。此库提供了一种简单高效的方
 | 0.13 及更早版本      | 0.0.6    | 旧版支持          |
 | 0.14.0               | 当前版本 | ✅ 完全支持       |
 | 0.15.x               | 当前版本 | ✅ 完全支持       |
-| 0.16.0-dev (nightly) | 当前版本 | ✅ 通过兼容层支持 |
+| 0.16.0               | 当前版本 | ✅ 通过兼容层支持 |
 
 > **注意**: 对于 Zig 0.13 及更早版本，请使用本库的 `0.0.6` 版本。
 > **注意**: Zig 0.16+ 移除了 `std.io.FixedBufferStream`，但本库提供了兼容层以在所有支持的版本中维持相同的 API。
 
-对于 Zig `0.14.0`、`0.15.x` 和 `0.16.0-dev` 版本，请按以下步骤操作：
+对于 Zig `0.14.0`、`0.15.x` 和 `0.16.0` 版本，请按以下步骤操作：
 
 1. **添加为依赖项**:
    将库添加到您的 `build.zig.zon` 文件中。您可以获取特定的提交或分支。

src/bench.zig

@@ -16,28 +16,45 @@ const pack = msgpack.Pack(
     bufferType.read,
 );
 
+const is_zig_16 = builtin.zig_version.minor >= 16;
+const BenchRuntime = if (is_zig_16) struct {
+    var io: ?std.Io = null;
+} else struct {};
+
+/// Get monotonic time in nanoseconds on Zig 0.16+.
+fn getTimeNs() u64 {
+    if (is_zig_16) {
+        const io = BenchRuntime.io orelse @panic("benchmark runtime io is not initialized");
+        return @intCast(std.Io.Clock.awake.now(io).nanoseconds);
+    }
+
+    unreachable;
+}
+
 /// Benchmark timer helper
 /// Run a benchmark and print results
 fn benchmark(
     comptime name: []const u8,
     comptime iterations: usize,
     comptime func: fn (allocator: std.mem.Allocator) anyerror!void,
 ) !void {
-    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
-    defer _ = gpa.deinit();
-    const allocator = gpa.allocator();
+    const allocator = std.heap.page_allocator;
 
     // Warmup
     for (0..10) |_| {
         try func(allocator);
     }
 
     // Actual benchmark
-    var timer = try std.time.Timer.start();
+    var legacy_timer: if (is_zig_16) void else std.time.Timer = if (is_zig_16) {} else undefined;
+    if (!is_zig_16) legacy_timer = try std.time.Timer.start();
+    const start_ns = if (is_zig_16) getTimeNs() else 0;
+
     for (0..iterations) |_| {
         try func(allocator);
     }
-    const elapsed_ns = timer.read();
+
+    const elapsed_ns = if (is_zig_16) getTimeNs() - start_ns else legacy_timer.read();
 
     const avg_ns = elapsed_ns / iterations;
     const ops_per_sec = if (avg_ns > 0) (1_000_000_000 / avg_ns) else 0;
@@ -850,7 +867,7 @@ fn benchMixedTypesRead(allocator: std.mem.Allocator) !void {
 // Main Benchmark Runner
 // ============================================================================
 
-pub fn main() !void {
+fn runBenchmarks() !void {
     std.debug.print("\n", .{});
     std.debug.print("=" ** 80 ++ "\n", .{});
     std.debug.print("MessagePack Benchmark Suite\n", .{});
@@ -936,3 +953,16 @@ pub fn main() !void {
     std.debug.print("Benchmark Complete\n", .{});
     std.debug.print("=" ** 80 ++ "\n", .{});
 }
+
+const BenchEntry = if (is_zig_16) struct {
+    pub fn main(init: std.process.Init) !void {
+        BenchRuntime.io = init.io;
+        try runBenchmarks();
+    }
+} else struct {
+    pub fn main() !void {
+        try runBenchmarks();
+    }
+};
+
+pub const main = BenchEntry.main;

src/msgpack.zig

@@ -1316,7 +1316,7 @@ pub const Payload = union(enum) {
                     var new_heap = if (current_zig.minor == 14)
                         std.ArrayList(Payload).init(alloc)
                     else
-                        std.ArrayList(Payload){};
+                        std.ArrayList(Payload).initCapacity(alloc, 0) catch unreachable;
 
                     // Copy existing items from stack buffer to heap
                     for (buffer[0..len.*]) |item| {
@@ -2857,7 +2857,7 @@ pub fn PackWithLimits(
             var parse_stack = if (current_zig.minor == 14)
                 std.ArrayList(ParseState).init(allocator)
             else
-                std.ArrayList(ParseState){};
+                try std.ArrayList(ParseState).initCapacity(allocator, 0);
             defer if (current_zig.minor == 14) parse_stack.deinit() else parse_stack.deinit(allocator);
             errdefer cleanupParseStack(&parse_stack, allocator);