From 2f251facf156b6c89e6be3ba690261556baa02fa Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Tue, 24 Feb 2026 12:33:51 +0800
Subject: Implement SheetSystem core library

Add IndexSource type for resource addressing and implement mapping
system
with LocalMapping, Mapping, and MappingBuf types. Create Sheet and
SheetData
structs for managing sheet data with editing capabilities.

Implement binary format serialization/deserialization with reader and
writer
modules. Add constants for file format layout and comprehensive test
suite
for roundtrip verification.
---
 systems/sheet/src/index_source.rs | 114 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 114 insertions(+)
 create mode 100644 systems/sheet/src/index_source.rs

(limited to 'systems/sheet/src/index_source.rs')

diff --git a/systems/sheet/src/index_source.rs b/systems/sheet/src/index_source.rs
new file mode 100644
index 0000000..a2fc43d
--- /dev/null
+++ b/systems/sheet/src/index_source.rs
@@ -0,0 +1,114 @@
+/// IndexSource
+/// Points to a unique resource address in Vault
+#[derive(Debug, Clone, Copy)]
+pub struct IndexSource {
+    /// The index ID of the resource
+    id: u32,
+
+    /// The index version of the resource
+    ver: u16,
+}
+
+// Implement construction and querying for IndexSource
+
+impl IndexSource {
+    /// Create IndexSource
+    pub fn new(id: u32, ver: u16) -> Self {
+        IndexSource { id, ver }
+    }
+
+    /// Get index ID from IndexSource
+    pub fn id(&self) -> u32 {
+        self.id
+    }
+
+    /// Get index version from IndexSource
+    pub fn version(&self) -> u16 {
+        self.ver
+    }
+}
+
+// Implement comparison for IndexSource
+
+impl PartialEq for IndexSource {
+    fn eq(&self, other: &Self) -> bool {
+        &self.id == &other.id && &self.ver == &other.ver
+    }
+}
+
+impl Eq for IndexSource {}
+
+// Implement hashing for IndexSource and IndexSourceBuf
+
+impl std::hash::Hash for IndexSource {
+    fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
+        self.id.hash(state);
+        self.ver.hash(state);
+    }
+}
+
+// Implement construction of IndexSource from strings
+
+impl<'a> TryFrom<&'a str> for IndexSource {
+    type Error = &'static str;
+
+    fn try_from(value: &'a str) -> Result<Self, Self::Error> {
+        let parts: Vec<&str> = value.split('/').collect();
+        if parts.len() != 2 {
+            return Err("Invalid format: expected 'id/version'");
+        }
+
+        let id_str = parts[0].trim();
+        let ver_str = parts[1].trim();
+
+        if id_str.is_empty() || ver_str.is_empty() {
+            return Err("ID or version cannot be empty");
+        }
+
+        let id = id_str
+            .parse::<u32>()
+            .map_err(|_| "ID must be a valid u32")?;
+        let ver = ver_str
+            .parse::<u16>()
+            .map_err(|_| "Version must be a valid u16")?;
+
+        // Check for overflow (though parsing already validates range)
+        // Additional bounds checks can be added here if needed
+        Ok(Self { id, ver })
+    }
+}
+
+impl TryFrom<String> for IndexSource {
+    type Error = &'static str;
+
+    fn try_from(value: String) -> Result<Self, Self::Error> {
+        Self::try_from(value.as_str())
+    }
+}
+
+impl From<IndexSource> for (u32, u16) {
+    fn from(src: IndexSource) -> Self {
+        (src.id, src.ver)
+    }
+}
+
+// Implement modifications for IndexSource
+impl IndexSource {
+    /// Set the index ID of IndexSource
+    pub fn set_id(&mut self, index_id: u32) {
+        self.id = index_id;
+    }
+
+    /// Set the index version of IndexSource
+    pub fn set_version(&mut self, version: u16) {
+        self.ver = version;
+    }
+}
+
+// Implement Display for IndexSourceBuf and IndexSource
+
+impl std::fmt::Display for IndexSource {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        write!(f, "{}/{}", self.id.to_string(), self.ver.to_string())
+    }
+}
-- 
cgit