@rfkit/charts 1.8.2 → 1.9.0

package/README.md

@@ -96,6 +96,19 @@ export function GaugeDemo() {
 
 `PublishSpectrum` 支持推送内置频谱数据线，包括 `data`、`maxData`、`minData`、`avgData`、`thresholdData`、`templateData`、`backgroundNoiseData` 和 `extraData`。`thresholdData` 不传 `segmentOffset` / `offset` 时按整条门限替换；传入 `segmentOffset` 或 `offset` 时按局部门限写入。
 
+独立 `Heatmap` 可以显式开启 X/Y 同步缩放：
+
+```tsx
+<Heatmap
+  ref={heatmapRef}
+  zoom={{ xy: true, overview: { show: true } }}
+/>
+```
+
+开启后，滚轮会围绕指针位置同步缩放频率列和时间行，左键拖拽会同时平移两个方向。`overview.show` 会在发生缩放后于右上角以小尺寸半透明悬浮显示全量瀑布缩略图，恢复全景后自动隐藏且不改变主图布局；点击空白区域居中、拖动视口框平移，双击主图或 Overview 恢复全景。框选边界越出视口时可通过主图边缘代理手柄继续调整；完全离开视口时可点击 Overview 中的虚线框定位，二者均不会自动改变框选或缩放倍率。外部也可以调用 `heatmapRef.current?.resetViewport?.()` 恢复完整 XY 范围。
+
+这些开关默认关闭，只作用于独立 `Heatmap`；`Spectrum` 组合使用的 `HeatmapPortal` 仍由频谱图统一控制，不显示 Overview，也不注册单独的缩放操作。
+
 工具栏相关命名统一使用：
 
 - 工具栏枚举使用 `ToolbarItemType`

package/components/DragSelectBox/index.d.ts

@@ -4,7 +4,8 @@
  */
 import type React from 'react';
 import { type ReactNode } from 'react';
-import { type RectPosition } from '../../hooks/useDragSelect';
+import { type RectBounds, type RectPosition } from '../../hooks/useDragSelect';
+type DragSelectBoxVariant = 'contained' | 'projected';
 export interface DragSelectBoxProps {
     enabled: boolean;
     defaultRect?: Partial<RectPosition>;
@@ -14,6 +15,7 @@ export interface DragSelectBoxProps {
     maxSize?: number;
     snapThreshold?: number;
     onChange?: (rect: RectPosition) => void;
+    onDragStart?: () => boolean | undefined;
     onDragEnd?: (rect: RectPosition) => void;
     children?: ReactNode;
     labels?: {
@@ -25,6 +27,8 @@ export interface DragSelectBoxProps {
     className?: string;
     zIndex?: number;
     showBoundaryLines?: boolean;
+    variant?: DragSelectBoxVariant;
+    interactionBounds?: RectBounds;
 }
 declare const DragSelectBox: React.FC<DragSelectBoxProps>;
 export default DragSelectBox;

package/hooks/publish/enhancedPublish.d.ts

@@ -6,6 +6,7 @@ export interface EnhancedPublish extends Publish {
     isReady: () => boolean;
     onReady: (callback: ReadyCallback) => ReadyCleanup | undefined;
     getSourceData: () => rawData;
+    resetViewport: () => void;
 }
 export interface EnhancedPublishController {
     attachPublish: (publish: Publish) => void;

package/hooks/publish/usePublish.d.ts

@@ -4,6 +4,7 @@ export declare const PUB_SUB: (globalID: string, func?: CSMCallback) => (...args
 interface Props {
     subscribe?: CSMCallback;
     publish?: Publish;
+    resetViewport?: () => void;
 }
-declare const usePublish: ({ publish, subscribe }: Props) => void;
+declare const usePublish: ({ publish, resetViewport, subscribe }: Props) => void;
 export default usePublish;

package/hooks/useDragSelect.d.ts

@@ -9,6 +9,12 @@ export interface RectPosition {
     leftPosition: number;
     width: number;
 }
+export interface RectBounds {
+    bottom: number;
+    left: number;
+    right: number;
+    top: number;
+}
 export interface UseDragSelectConfig {
     enabled?: boolean;
     defaultRect?: Partial<RectPosition>;
@@ -19,6 +25,8 @@ export interface UseDragSelectConfig {
     snapThreshold?: number;
     onChange?: (rect: RectPosition) => void;
     onDragEnd?: (rect: RectPosition) => void;
+    preserveDefaultRect?: boolean;
+    bounds?: RectBounds;
 }
 /**
  * 通用拖拽框选 Hook
@@ -28,7 +36,7 @@ export declare const useDragSelect: (config?: UseDragSelectConfig) => {
     isDragging: boolean;
     dragType: DragType;
     containerRef: import("react").RefObject<HTMLDivElement | null>;
-    handleMouseDown: (e: React.MouseEvent<HTMLDivElement>, type: DragType) => void;
+    handleMouseDown: (e: React.MouseEvent<HTMLElement>, type: DragType, startRect?: RectPosition) => void;
     resetRect: (newRect: Partial<RectPosition>) => void;
     setRect: (newRect: RectPosition) => void;
 };