SuperAPI AI 工具集

veltra-compositions

通用与其它

查看项目

更新于 10-16 03:42

技能介绍

用途:这是 @veltra/compositions 的文档与源码镜像技能,面向实现或重构涉及组合式函数(composable)的场景,围绕该包内多个 use-* 函数提供说明与调用模式参考。

主要内容:generated/modules/ 为每个 use-* 生成一篇文档并含该模块全部 .ts 源码;generated/manifest.json 记录同步时间与模块文件列表;references/usage-patterns.md 收录 desktop 中的真实调用片段。另有 references/source-discovery.md、references/api-map.md、references/patterns.md 作为旧版参考文档,与 generated/ 镜像互补,提供源码定位、模块地图与编写模式。

函数概览(14 个):useModel 自定义 v-model;useUserAction 在用户动作期间阻断 modelValue 回流副作用;useDrag 拖拽;useFocus 焦点与 hover 语义;useTransition 过渡(css 或 style);usePop Popper 定位;useReactiveSize 响应式测量尺寸;useResizeObserver / useObserverCallback;useVirtualizer 虚拟列表低阶适配层;useFallbackProps props 到全局 config 回退;useFormFallbackProps 表单三级回退;useFormComponent 表单 provide / inject;useConfig 全局配置读取;useComponentProps 规范化组件 props。

导入约定:从 '@veltra/compositions' 按需引入所需函数,无默认导出。

使用方式:按场景选用,如状态与并发用 useModel、useUserAction;UI 交互用 useDrag、useFocus、useTransition;布局与列表用 usePop、useReactiveSize、useResizeObserver、useVirtualizer;表单用 useFormComponent、useFormFallbackProps、useFallbackProps、useConfig。源码权威位置为 packages/compositions/src/,修改 API 后需运行 bun run sync-veltra-compositions 更新 generated/,以保持技能文档与类型一致。

限制:资料未提供具体 API 参数细节、返回值完整定义及运行环境要求,需结合对应源码查看;useComponentProps 等部分函数的详细行为标注为见源码注释。