Initial Dever 0.0.1

lib/doc/dever-bytes.md

@@ -0,0 +1,55 @@
+# 字节
+
+Bytes 保存原始字节，按 UTF-8 与 Text 显式转换。
+
+## dever.bytes.DecodeResult
+
+UTF-8 解码结果：Decoded 保存文本，Failed 保存错误原因。
+
+分支：
+- `Decoded(text: Text)`：成功结果
+- `error Failed(message: Text)`：失败原因
+
+## dever.bytes.BufferResult
+
+字节构造结果：Ready 保存字节，Failed 保存错误原因。
+
+分支：
+- `Ready(bytes: Bytes)`：成功结果
+- `error Failed(message: Text)`：失败原因
+
+## dever.bytes.fromText
+
+按 UTF-8 编码复制文本字节。
+
+## dever.bytes.toText
+
+完整校验 UTF-8；无效字节不会替换或忽略。
+
+## dever.bytes.decoded
+
+成功时返回文本，失败时保持原错误身份。
+
+## dever.bytes.fromInts
+
+按顺序转换 0–255 的 Int；超范围失败。
+
+## dever.bytes.length
+
+返回字节数。
+
+## dever.bytes.at
+
+使用从零开始的索引，越界返回 null。
+
+## dever.bytes.slice
+
+截取左闭右开区间，负数、倒置或越界范围失败。
+
+## dever.bytes.ready
+
+成功时返回字节，失败时保持原错误身份。
+
+## dever.bytes.concat
+
+顺序连接两段字节，保留两个输入的值。