# nargo-types
> HXO 框架的基础库，定义共享类型与错误处理规范。
## 📖 简介
`nargo-types` 是 HXO 生态系统的基石。它定义了整个框架共享的核心数据结构、位置信息以及统一的错误处理机制。
## ✨ 核心特性
- **位置追踪**: 提供统一的 `Span` 和 `Position` 类型，支持全链路源码映射。
- **错误系统**: 实现了高度可定制的错误枚举，支持跨包的错误转换。
- **SFC 模型**: 定义了 `NargoFile` 和 `NargoBlock`，统一了单文件组件的内存表示。
- **配置模型**: 包含路由、编译器选项等通用配置的类型定义。
## 🏗️ 核心数据结构
- **Span / Position**: 记录代码片段在源文件中的起止位置（行、列、偏移量）。
- **NargoValue**: 通用的值枚举，支持响应式信号、二进制数据及源码片段。
- **Error**: 统一的错误容器，包含错误码、消息和位置信息。
## 🔗 相关项目
本包被 `compilers/` 目录下几乎所有的包所依赖。