reatom

Reatom

在实现或解释 Reatom v1001 时使用此技能。将 REFERENCE.md 视为此技能随附的权威 API 参考。

使用方法

1. 阅读 REFERENCE.md 中与任务相关的部分；如果通用 React/Solid/Vue 状态模式与参考文档冲突，请勿加载。
2. 遵循所修改程序包或示例中的现有代码，包括命名、文件布局和扩展风格。
3. 对于深入的异步流程（wrap、withAsyncData、withAbort、采样、Suspense），切换到 reatom-async 技能。
4. 对于 @reatom/jsx（原生 DOM JSX、mount、props、css prop），切换到 reatom-jsx 技能。
5. 对于拉取请求、代码审查或对 Agent 输出进行审慎验证，切换到 reatom-review 技能。
6. 对于设计、重构或替换辅助函数、扩展或公共 API，切换到 reatom-api-design 技能。

章节索引

使用此索引，仅打开 REFERENCE.md 中相关的部分：

主题	章节
Atoms、computed、action、effect、extend	Core primitives and mental model
查询和变更	withAsync
await 后/回调中的异步上下文	wrap rules
集合、布尔值、路由辅助函数	Primitives quick usage
嵌套响应式字段	Atomization
Subscribe 错误回调	Subscribe error listener
日志记录、log.label、log.state	Full SPA example (logging setup)
钩子、连接/断开连接、惰性工作	Lifecycle and extension hooks
DOM / 外部事件	Event sampling and orchestration
热派生	Memoization: memo and memoKey
字段和验证	Forms: base usage and reactive validation
SPA 路由和加载器	Routing
搜索参数、存储	URL sync and persistence helpers
React Suspense 集成	Suspense notes
批量更新	Transactions notes
测试和 SSR	SSR and testing
从较早版本的 Reatom 升级	v3 migration highlights

更深入的配方和适配器文档位于 v1001.reatom.dev 的 /docs/handbook/* 和 /docs/reference/* 下。

实现默认规范

• 使用命名的 atoms、actions、computed 值和 effects；工厂名称使用 reatom* 前缀。
• 读取：零参数调用。写入：.set(...)。
• 幂等读取：computed(async () => ...).extend(withAsyncData(...))。
• 命令/变更：action(async () => ...).extend(withAsync(...))。
• 离开 Reatom 执行帧的异步边界：await wrap(promise)；外部回调：传入 wrap(fn)。
• 在 computed 中派生状态；在 effect 中执行副作用，并明确指定生命周期（路由加载器、初始化 action 或挂载作用域——功能开发中不要使用无作用域的模块级 effects）。
• 表单（字段、验证、提交）使用 reatomForm / reatomField，不要为每个字段手动创建 atoms 和提交 actions。
• 路由数据通过 reatomRoute 加载器处理；使用 .go(...) 导航，使用 .path(...) 创建链接。

如果参考文档与本地示例不一致，请优先遵循参考文档；如果示例有误，则修正示例。