nargo-types

HXO 框架的基础库，定义共享类型与错误处理规范。

📖 简介

nargo-types 是 HXO 生态系统的基石。它定义了整个框架共享的核心数据结构、位置信息以及统一的错误处理机制。

✨ 核心特性

• 位置追踪: 提供统一的 Span 和 Position 类型，支持全链路源码映射。
• 错误系统: 实现了高度可定制的错误枚举，支持跨包的错误转换。
• SFC 模型: 定义了 NargoFile 和 NargoBlock，统一了单文件组件的内存表示。
• 配置模型: 包含路由、编译器选项等通用配置的类型定义。

🏗️ 核心数据结构

• Span / Position: 记录代码片段在源文件中的起止位置（行、列、偏移量）。
• NargoValue: 通用的值枚举，支持响应式信号、二进制数据及源码片段。
• Error: 统一的错误容器，包含错误码、消息和位置信息。

🔗 相关项目

本包被 compilers/ 目录下几乎所有的包所依赖。