SuperAPI AI 工具集

repo-structure-navigate

编程与开发

查看项目

更新于 10-16 02:39

技能介绍

用途:在 Valibot 仓库中快速找到文件、理解代码库布局,定位 schema、action、method 的实现与测试、类型定义、i18n 文案、API 文档与指南页面。

仓库布局:mono repo 含 library(零依赖核心包)、packages/i18n(25+ 语言错误信息)、packages/to-json-schema(JSON Schema 转换器)、codemod(migrate-to-v0.31.0、zod-to-valibot)、website(valibot.dev,Qwik + Vite)、brand、skills、prompts。

核心库 library/src 分 schemas(数据类型校验,如 string/object/array/union)、actions(校验与转换,如 email/minLength/trim/transform)、methods(parse/safeParse/pipe/partial)、types(schema.ts、issue.ts、dataset.ts)、utils(_addIssue、_stringify、ValiError 等内部工具)、storages(全局状态与消息存储)。

查找路径:schema 在 library/src/schemas/[name]/[name].ts,action 在 actions 下,method 在 methods 下;类型在 types,内部工具在 utils,错误信息在 packages/i18n/[lang]/,API 文档在 website/src/routes/api/(分类)/[name]/,指南在 website/src/routes/guides/(分类)/[name]/;测试与源码同目录,后缀 .test.ts 与 .test-d.ts。

开发约定:新增 schema/action 需建目录并包含实现、运行时测试、类型测试与 index.ts,按现有模式编写,从分类 index 导出后运行 pnpm -C library test。修改 library/src/types/ 会影响整个库,须跑全量测试。快速实验可用 library/playground.ts。

命令:pnpm install、pnpm format;pnpm -C library build/test/lint/format;pnpm -C website dev/build。

原则与限制:模块化、单文件单函数、核心零依赖、100% 测试覆盖、可 tree-shaking、TypeScript 严格模式、仅 ESM 且导入带 .ts 后缀。不要引入外部依赖、未跑全量测试不要改核心类型、不要跳过测试、避免大而杂的函数、不要修改 dist/ 与 coverage/ 等生成文件。本资料未提供收费、价格或平台信息。