@u-map/vue3

@u-map/vue3

Vue 3 组合式工具与组件库。仅 ESM。

主入口（轻量，无重依赖）

import { debouncedRef, useRealTime, useTableScroll } from '@u-map/vue3';

• debouncedRef(value, delay?)：防抖自定义 ref
• useRealTime(date_format?)：实时时钟，每秒刷新，卸载自动清定时器
• useTableScroll(table_ref)：Element Plus 表格自动滚动。参数为结构类型 { value: any } 而非 Ref——库可能被 link 进 vue 小版本不同的工程，Ref 带 unique symbol，跨声明副本名义不兼容

@u-map/vue3/echarts 子路径（echarts 重依赖隔离）

import { useEcharts, echarts, type ECOption } from '@u-map/vue3/echarts';

• 子模块内置 echarts 按需注册副作用（charts/components/CanvasRenderer），无需在应用入口手动注册
• useEcharts(ele: string | HTMLElement, theme?)：懒初始化、容器尺寸变化自动 resize、onBeforeUnmount 自动 dispose；返回 { getInstance, setOption, clear, dispose }
• echarts 为 echarts/core 命名空间（需要 echarts.init 等直接调用时使用）

peerDependencies：vue、dayjs（主入口 useRealTime）、echarts ^5.6（仅 echarts 子路径）。 包内 hooks/useResizeObserver.ts 是内部工具不导出；应用需要该能力请直接用 @vueuse/core。

明确不入库的内容

• MarkdownPreview（AI 回答渲染器）：与 SSE 流式业务协议、第三方模型供应商（含端点/密钥）耦合，样式依赖消费方 UnoCSS 管道，且仅单一功能消费，保留在各项目内。