basmilius

Bas Milius 软件包

@basmilius npm 作用域分为三个层次，共同构成一套技术栈；references/ 中为每层都提供了指南：

1. @basmilius/utils - 约 45 个与框架无关的辅助函数（通过 Luxon 处理日期、颜色、数字、下载、DOM、计时、地理／天文、带种子的 PRNG）。可用于任何 TypeScript 项目。
2. @basmilius/http-client - 类型化数据层：每个请求体都是一个 @dto 类，每组端点都是一个 BaseService，原始 snake_case JSON 由静态 @adapter 映射。基于 utils 构建。
3. @basmilius/common - Vue 3 应用基础组件：返回 ref 的 defineStore、useService + guarded、useDataTable / useDataReport、useDtoForm、丰富的组合式函数目录，以及轻量的 vue-router 包装器。依赖 Pinia 和 Vue Router，并基于上述两个软件包构建。

共同前提：涉及 Vue 时使用 Vue 3.6 预发布版（具体范围见各软件包的 peerDependencies）；日期功能将 luxon 作为 peer 依赖。@flux-ui/* 是独立的软件库，有自己的 skill（flux-ui）；这里刻意不涉及 @basmilius/vite-preset。

路由：编写代码前先阅读软件包指南

各软件包的注意事项和判断依据都在指南中，而不在这里。先阅读对应的指南，然后按需查阅签名／模式文件：

正在处理	首先阅读	然后按需查阅
日期／数字／颜色／下载／DOM 辅助函数，或从 @basmilius/utils 导入的任何内容	references/utils.md	references/utils-function-index.md（包含每个函数的精确签名，以及浏览器与纯函数的区分）
DTO、适配器、服务、请求、（反）序列化、Vite 插件、tsconfig 装饰器标志	references/http-client.md	references/http-client-reference.md（完整导出内容）、references/http-client-patterns.md（DTO → 适配器 → 服务的完整示例、错误处理、脏数据保存）
Store、数据表／报告、表单、URL 状态、组合式函数、路由辅助函数、异常	references/common.md	references/common-reference.md（含签名的组合式函数目录）、references/common-patterns.md（Store、useService、useDataTable 视图、useDtoForm、useUrlState 的完整示例）

任务通常会跨越多个层次：数据表视图会涉及 common（useDataTable）、http-client（服务和 DTO），有时还会涉及 utils（格式化）。请阅读涉及的每份指南；这些指南都很简短，并通过交叉链接说明各层之间的关系。

相关 skills

• vue-build-feature / code-style - 与软件库无关的 Vue 架构和 SFC 模式，这些软件包可融入其中；common 是 vue-build-feature 所依赖的具体数据／状态层。
• flux-ui - Flux UI 组件库（独立的 @flux-ui 作用域）。