feat(zig-compat): enhance cross-version support for Zig 0.16

- add compatibility layer for `std.io.FixedBufferStream` removal
- update README and README_CN with Zig 0.16 compatibility notes
- modify example code to use cross-version buffer stream implementation
- export compatibility module in main msgpack module
- update test imports to use new compatibility layer

Author: jinzhongjia

README.md

@@ -23,9 +23,10 @@ An article introducing it: [Zig Msgpack](https://blog.nvimer.org/2025/09/20/zig-
 | 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 | ✅ Fully supported |
+| 0.16.0-dev (nightly) | 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:
 
@@ -75,13 +76,18 @@ const msgpack = @import("msgpack");
 pub fn main() !void {
     const allocator = std.heap.page_allocator;
     var buffer: [1024]u8 = undefined;
-    var stream = std.io.fixedBufferStream(&buffer);
+    
+    // Use the compatibility layer for cross-version support
+    const compat = msgpack.compat;
+    var write_buffer = compat.fixedBufferStream(&buffer);
+    var read_buffer = compat.fixedBufferStream(&buffer);
 
+    const BufferType = compat.BufferStream;
     var packer = msgpack.Pack(
-        *std.io.FixedBufferStream([]u8), *std.io.FixedBufferStream([]u8),
-        std.io.FixedBufferStream([]u8).WriteError, std.io.FixedBufferStream([]u8).ReadError,
-        std.io.FixedBufferStream([]u8).write, std.io.FixedBufferStream([]u8).read,
-    ).init(&stream, &stream);
+        *BufferType, *BufferType,
+        BufferType.WriteError, BufferType.ReadError,
+        BufferType.write, BufferType.read,
+    ).init(&write_buffer, &read_buffer);
 
     // Create and encode data
     var map = msgpack.Payload.mapPayload(allocator);
@@ -91,7 +97,7 @@ pub fn main() !void {
     try packer.write(map);
 
     // Decode
-    stream.pos = 0;
+    read_buffer.pos = 0;
     const decoded = try packer.read(allocator);
     defer decoded.free(allocator);
     
@@ -133,7 +139,7 @@ const ts2 = msgpack.Payload.timestampToPayload(1234567890, 123456789);
 
 // Write and read timestamp
 try packer.write(ts2);
-stream.pos = 0;
+read_buffer.pos = 0;
 const decoded_ts = try packer.read(allocator);
 defer decoded_ts.free(allocator);
 
@@ -179,6 +185,17 @@ To run the unit tests for this library, use the following command:
 
 ```sh
 zig build test
+
+# For more detailed test output
+zig build test --summary all
+```
+
+## Documentation
+
+To generate documentation for this library:
+
+```sh
+zig build docs
 ```
 
 ## Contributing

README_CN.md

@@ -23,9 +23,10 @@ Zig 编程语言的 MessagePack 实现。此库提供了一种简单高效的方
 | 0.13 及更早版本 | 0.0.6 | 旧版支持 |
 | 0.14.0 | 当前版本 | ✅ 完全支持 |
 | 0.15.x | 当前版本 | ✅ 完全支持 |
-| 0.16.0-dev (nightly) | 当前版本 | ✅ 完全支持 |
+| 0.16.0-dev (nightly) | 当前版本 | ⚠️ 通过兼容层支持 |
 
 > **注意**: 对于 Zig 0.13 及更早版本，请使用本库的 `0.0.6` 版本。
+> **注意**: Zig 0.16+ 移除了 `std.io.FixedBufferStream`，但本库提供了兼容层以在所有支持的版本中维持相同的 API。
 
 对于 Zig `0.14.0`、`0.15.x` 和 `0.16.0-dev` 版本，请按以下步骤操作：
 
@@ -75,13 +76,18 @@ const msgpack = @import("msgpack");
 pub fn main() !void {
     const allocator = std.heap.page_allocator;
     var buffer: [1024]u8 = undefined;
-    var stream = std.io.fixedBufferStream(&buffer);
+    
+    // 使用兼容层实现跨版本支持
+    const compat = msgpack.compat;
+    var write_buffer = compat.fixedBufferStream(&buffer);
+    var read_buffer = compat.fixedBufferStream(&buffer);
 
+    const BufferType = compat.BufferStream;
     var packer = msgpack.Pack(
-        *std.io.FixedBufferStream([]u8), *std.io.FixedBufferStream([]u8),
-        std.io.FixedBufferStream([]u8).WriteError, std.io.FixedBufferStream([]u8).ReadError,
-        std.io.FixedBufferStream([]u8).write, std.io.FixedBufferStream([]u8).read,
-    ).init(&stream, &stream);
+        *BufferType, *BufferType,
+        BufferType.WriteError, BufferType.ReadError,
+        BufferType.write, BufferType.read,
+    ).init(&write_buffer, &read_buffer);
 
     // 创建和编码数据
     var map = msgpack.Payload.mapPayload(allocator);
@@ -91,7 +97,7 @@ pub fn main() !void {
     try packer.write(map);
 
     // 解码
-    stream.pos = 0;
+    read_buffer.pos = 0;
     const decoded = try packer.read(allocator);
     defer decoded.free(allocator);
     
@@ -133,7 +139,7 @@ const ts2 = msgpack.Payload.timestampToPayload(1234567890, 123456789);
 
 // 写入和读取时间戳
 try packer.write(ts2);
-stream.pos = 0;
+read_buffer.pos = 0;
 const decoded_ts = try packer.read(allocator);
 defer decoded_ts.free(allocator);
 
@@ -179,6 +185,17 @@ const uint_result = int_payload.getUint() catch |err| switch (err) {
 
 ```sh
 zig build test
+
+# 获取更详细的测试输出
+zig build test --summary all
+```
+
+## 文档
+
+要生成此库的文档：
+
+```sh
+zig build docs
 ```
 
 ## 贡献

src/msgpack.zig

@@ -1691,3 +1691,6 @@ pub fn Pack(
         }
     };
 }
+
+// Export compatibility layer for cross-version support
+pub const compat = @import("compat.zig");

src/test.zig

@@ -1,7 +1,7 @@
 const std = @import("std");
 const builtin = @import("builtin");
 const msgpack = @import("msgpack");
-const compat = @import("compat.zig");
+const compat = msgpack.compat;
 const allocator = std.testing.allocator;
 const expect = std.testing.expect;
 const Payload = msgpack.Payload;