@rfkit/charts 1.8.2 → 1.9.1

package/index.js.LICENSE.txt

@@ -0,0 +1,6 @@
+/**
+ * @license lucide-react v0.577.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */

package/modules/Heatmap/Capture/sliderInfo.d.ts

@@ -0,0 +1,18 @@
+import type { TimestampedFloat32Array, WaterfallSnapshot } from '@rfkit/spectrum-analyzer';
+import type { AxisXProps, HeatmapSlider2DData } from '../../../types';
+import { type HeatmapSourceRange } from '../viewport.ts';
+interface SliderInfoParams {
+    formatBandwidth: (bandwidth: number) => string;
+    frequencyFormat: AxisXProps['frequencyFormat'];
+    heatmapData: readonly TimestampedFloat32Array[];
+    rect: {
+        height: number;
+        leftPosition: number;
+        position: number;
+        width: number;
+    };
+    sourceRangeOverride?: HeatmapSourceRange;
+    waterfallSnapshot: Readonly<WaterfallSnapshot> | null;
+}
+export declare const calculateHeatmapSliderInfo: ({ formatBandwidth, frequencyFormat, heatmapData, rect, sourceRangeOverride, waterfallSnapshot }: SliderInfoParams) => HeatmapSlider2DData | null;
+export {};

package/modules/Heatmap/Capture/tools.d.ts

@@ -1,4 +1,5 @@
 import type { AxisXProps, HeatmapAreaData, HeatmapCaptureProps } from '../../../types';
+import { type HeatmapSourceRange } from '../viewport';
 interface Coordinates {
     startLeft: number;
     endLeft: number;
@@ -26,4 +27,7 @@ export declare const defaultAreaInfoResult: {
 };
 export default function calculateAreaInfo({ endLeft, startLeft, startTop, endTop, frequencyFormat, globalID }: AreaInfoParams): HeatmapAreaData;
 export declare const heatmapCaptureUpdate: (globalID: string, func?: (props: Partial<HeatmapCaptureProps>) => void) => (...args: any[]) => void;
+export declare const getHeatmapCaptureSourceRange: (globalID: string) => Readonly<HeatmapSourceRange> | null;
+export declare const setHeatmapCaptureSourceRange: (globalID: string, range: Readonly<HeatmapSourceRange> | null) => void;
+export declare const subscribeHeatmapCaptureSourceRange: (globalID: string, func: (range: Readonly<HeatmapSourceRange> | null) => void) => (...args: any[]) => void;
 export {};

package/modules/Heatmap/Overview.d.ts

@@ -0,0 +1,10 @@
+import type { WaterfallSnapshot } from '@rfkit/spectrum-analyzer';
+interface Props {
+    globalID: string;
+    onResetViewport: () => void;
+}
+export interface HeatmapOverviewHandle {
+    update: (snapshot: Readonly<WaterfallSnapshot>) => void;
+}
+declare const HeatmapOverview: import("react").ForwardRefExoticComponent<Props & import("react").RefAttributes<HeatmapOverviewHandle>>;
+export default HeatmapOverview;

package/modules/Heatmap/cursorValue.d.ts

@@ -1,4 +1,4 @@
-import type { TimestampedFloat32Array } from '@rfkit/spectrum-analyzer';
+import type { TimestampedFloat32Array, WaterfallSnapshot } from '@rfkit/spectrum-analyzer';
 export interface HeatmapGridInfo {
     columnCount: number;
     rowCount: number;
@@ -19,20 +19,31 @@ export interface HeatmapCursorValue {
     timestamp: string;
     value: number | null;
 }
-export declare const resolveHeatmapColumnCount: (waterfallData: TimestampedFloat32Array[]) => number;
-export declare const resolveHeatmapGridInfo: (waterfallData: TimestampedFloat32Array[]) => HeatmapGridInfo;
+export declare const resolveHeatmapColumnCount: (waterfallData: readonly TimestampedFloat32Array[]) => number;
+export declare const resolveHeatmapGridInfo: (waterfallData: readonly TimestampedFloat32Array[]) => HeatmapGridInfo;
 export declare const resolveHeatmapRowIndex: (top: number, rowCount: number) => number;
 export declare const resolveHeatmapColumnIndex: (left: number, columnCount: number) => number;
 export declare const resolveHeatmapRowRange: (topA: number, topB: number, rowCount: number) => HeatmapRowRange | null;
 export declare const resolveHeatmapColumnRange: (leftA: number, leftB: number, columnCount: number) => HeatmapColumnRange | null;
-export declare const resolveHeatmapGridRange: (waterfallData: TimestampedFloat32Array[], bounds: {
+export declare const resolveHeatmapGridRange: (waterfallData: readonly TimestampedFloat32Array[], bounds: {
     endLeft: number;
     endTop: number;
     startLeft: number;
     startTop: number;
 }) => HeatmapGridRange | null;
-export declare const resolveHeatmapRangeData: (waterfallData: TimestampedFloat32Array[], range: HeatmapGridRange) => number[][];
-export declare const resolveHeatmapCursorValue: (waterfallData: TimestampedFloat32Array[], coord: {
+export declare const resolveHeatmapRangeData: (waterfallData: readonly TimestampedFloat32Array[], range: HeatmapGridRange) => number[][];
+export declare const resolveHeatmapCursorValue: (waterfallData: readonly TimestampedFloat32Array[], coord: {
     left: number;
     top: number;
 }) => HeatmapCursorValue | null;
+export declare const resolveHeatmapCursorValueFromSnapshot: (snapshot: Readonly<WaterfallSnapshot>, coord: {
+    left: number;
+    top: number;
+}) => HeatmapCursorValue | null;
+export declare const resolveHeatmapGridRangeFromSnapshot: (snapshot: Readonly<WaterfallSnapshot>, bounds: {
+    endLeft: number;
+    endTop: number;
+    startLeft: number;
+    startTop: number;
+}) => HeatmapGridRange | null;
+export declare const resolveHeatmapRangeDataFromSnapshot: (snapshot: Readonly<WaterfallSnapshot>, range: HeatmapGridRange) => number[][];

package/modules/Heatmap/index.d.ts

@@ -1,5 +1,9 @@
+import { type ReactNode } from 'react';
 interface Props {
     heatmapDefaultData?: Array<Array<number>>;
+    onSubscriptionReadyChange?: (ready: boolean) => void;
+    overview?: ReactNode;
+    xyZoom?: boolean;
 }
 declare const Heatmap: React.FC<Props>;
 export default Heatmap;

package/modules/Heatmap/snapshot.d.ts

@@ -0,0 +1,3 @@
+import type { WaterfallSnapshot } from '@rfkit/spectrum-analyzer';
+export declare const getHeatmapWaterfallSnapshot: (globalID: string) => Readonly<WaterfallSnapshot> | null;
+export declare const resetHeatmapViewport: (globalID: string) => boolean;

package/modules/Heatmap/useWaterfallZoomEvent.d.ts

@@ -0,0 +1 @@
+export default function useWaterfallZoomEvent(id: string, enabled: boolean): void;

package/modules/Heatmap/viewport.d.ts

@@ -0,0 +1,98 @@
+import type { TimestampedFloat32Array, WaterfallSamplingOptions, WaterfallSnapshot } from '@rfkit/spectrum-analyzer';
+export interface HeatmapSourcePoint {
+    columnIndex: number;
+    rowIndex: number;
+    sourceLeft: number;
+    visibleColumnIndex: number;
+    visibleRowIndex: number;
+}
+export interface HeatmapSourceRange {
+    endCol: number;
+    endIndex: number;
+    startCol: number;
+    startIndex: number;
+}
+export interface HeatmapSourceRangeScreenRect {
+    height: number;
+    leftPosition: number;
+    position: number;
+    width: number;
+}
+export interface HeatmapViewportRange {
+    x: readonly [start: number, end: number];
+    y: readonly [start: number, end: number];
+}
+export type HeatmapViewportSnapshot = Pick<WaterfallSnapshot, 'range' | 'sourceSize'>;
+export interface HeatmapOverviewSourcePoint {
+    x: number;
+    y: number;
+}
+export interface HeatmapOverviewViewportRect {
+    height: number;
+    left: number;
+    top: number;
+    width: number;
+}
+export declare const clampHeatmapPercent: (value: number) => number;
+export declare const normalizeHeatmapFrames: (frames: readonly TimestampedFloat32Array[]) => TimestampedFloat32Array[];
+export declare const resolveHeatmapVisibleRowIndex: (top: number, rowCount: number) => number;
+export declare const resolveHeatmapVisibleColumnIndex: (left: number, columnCount: number) => number;
+export declare const resolveHeatmapSourceLeft: (left: number, snapshot: Readonly<WaterfallSnapshot>) => number;
+export declare const resolveHeatmapSourcePoint: (snapshot: Readonly<WaterfallSnapshot>, coord: {
+    left: number;
+    top: number;
+}) => HeatmapSourcePoint | null;
+export declare const resolveHeatmapSourceRange: (snapshot: Readonly<WaterfallSnapshot>, bounds: {
+    endLeft: number;
+    endTop: number;
+    startLeft: number;
+    startTop: number;
+}) => HeatmapSourceRange | null;
+export declare const resolveHeatmapSnapshotRangeData: (snapshot: Readonly<WaterfallSnapshot>, range: HeatmapSourceRange) => number[][];
+export declare const resolveHeatmapSourceRangeScreenRect: (snapshot: Readonly<HeatmapViewportSnapshot>, range: HeatmapSourceRange) => HeatmapSourceRangeScreenRect | null;
+export declare const resolveHeatmapProjectedSourceRange: (snapshot: Readonly<HeatmapViewportSnapshot>, bounds: {
+    endLeft: number;
+    endTop: number;
+    startLeft: number;
+    startTop: number;
+}) => HeatmapSourceRange | null;
+export declare const calculateHeatmapWheelRange: (snapshot: Readonly<WaterfallSnapshot>, wheel: number, coord: {
+    left: number;
+    top: number;
+}) => HeatmapViewportRange;
+export declare const resolveHeatmapOverviewSourcePoint: (snapshot: Readonly<HeatmapViewportSnapshot>, point: {
+    left: number;
+    top: number;
+}) => HeatmapOverviewSourcePoint;
+export declare const resolveHeatmapOverviewViewportRect: (snapshot: Readonly<HeatmapViewportSnapshot>) => HeatmapOverviewViewportRect;
+export declare const resolveHeatmapOverviewSourceRangeRect: (snapshot: Readonly<HeatmapViewportSnapshot>, range: HeatmapSourceRange) => HeatmapOverviewViewportRect;
+export declare const isHeatmapSourceRangeVisibleInViewport: (snapshot: Readonly<HeatmapViewportSnapshot>, range: HeatmapSourceRange) => boolean;
+export declare const isHeatmapOverviewSourcePointInRange: (range: HeatmapSourceRange, point: HeatmapOverviewSourcePoint, tolerance?: HeatmapOverviewSourcePoint) => boolean;
+export declare const isHeatmapViewportFullRange: (snapshot: Readonly<HeatmapViewportSnapshot>) => boolean;
+export declare const calculateHeatmapOverviewCenteredRange: (snapshot: Readonly<HeatmapViewportSnapshot>, point: {
+    left: number;
+    top: number;
+}) => HeatmapViewportRange;
+export declare const calculateHeatmapOverviewSourceRangeCenteredRange: (snapshot: Readonly<HeatmapViewportSnapshot>, range: HeatmapSourceRange) => HeatmapViewportRange;
+export declare const calculateHeatmapOverviewDragRange: (snapshot: Readonly<HeatmapViewportSnapshot>, point: {
+    left: number;
+    top: number;
+}, grabOffset: HeatmapOverviewSourcePoint) => HeatmapViewportRange;
+export declare const isHeatmapOverviewSourcePointInViewport: (snapshot: Readonly<HeatmapViewportSnapshot>, point: HeatmapOverviewSourcePoint) => boolean;
+export declare const calculateHeatmapDragRange: (snapshot: Readonly<HeatmapViewportSnapshot>, diff: {
+    left: number;
+    top: number;
+}) => HeatmapViewportRange;
+export declare const calculateHeatmapDragRangeFromCoordinates: (snapshot: Readonly<HeatmapViewportSnapshot>, start: {
+    left: number;
+    top: number;
+}, current: {
+    left: number;
+    top: number;
+}) => HeatmapViewportRange;
+export declare const toWaterfallSamplingOptions: (range: HeatmapViewportRange) => WaterfallSamplingOptions;
+export declare const isHeatmapViewportRangeEqual: (snapshot: Readonly<WaterfallSnapshot>, range: HeatmapViewportRange) => boolean;
+export declare const resolveHeatmapSourceRowScreenRange: (snapshot: Readonly<WaterfallSnapshot>, startIndex: number, endIndex: number) => {
+    height: number;
+    top: number;
+} | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rfkit/charts",
-  "version": "1.8.2",
+  "version": "1.9.1",
   "type": "module",
   "description": "Chart components for wireless monitoring web applications",
   "exports": {

package/types/publish.d.ts

@@ -136,5 +136,7 @@ export interface Render {
 export type PublishData = SetOption | SetSeries | SetSpectrumBandwidth | SetSegments | SetChannels | SetMarker | SetAntennaFactor | SetSignal | PublishSpectrum | PublishHeatmap | PublishFluorescence | PublishOccupancy | PublishLevelStream | PublishIQ | PublishDial | PublishGauge | AutorangingEvent | PointsEvent | BandEvent | ScopeEvent | Reset | Clear | Resize | Render;
 export type Publish = ((p: PublishData) => void) & {
     getSourceData: () => rawData;
+    /** 将支持视口的图表恢复为完整数据范围；不支持时为空操作。 */
+    resetViewport?: () => void;
 };
 export {};

package/types/store/heatmap.d.ts

@@ -1,4 +1,14 @@
 import type { TimestampedFloat32Array } from '@rfkit/spectrum-analyzer';
+export interface WaterfallViewportState {
+    range: {
+        x: readonly [start: number, end: number];
+        y: readonly [start: number, end: number];
+    };
+    sourceSize: {
+        width: number;
+        height: number;
+    };
+}
 export declare enum HeatmapCaptureType {
     Area = "area",
     Slider = "slider",

package/types/store/index.d.ts

@@ -20,7 +20,7 @@ export * from './ui';
 import type { Publish, SegmentsType } from '..';
 import type { AxisXProps, AxisYProps } from './axis';
 import type { FrequencyAllocationProps } from './frequency';
-import type { HeatmapCaptureProps } from './heatmap';
+import type { HeatmapCaptureProps, WaterfallViewportState } from './heatmap';
 import type { MarkerProps } from './marker';
 import type { LevelStreamProps, SeriesProps } from './series';
 import type { SignalAnalysisProps, SignalProps } from './signal';
@@ -39,6 +39,7 @@ export interface StoreState {
     marker: MarkerProps;
     limit: LimitProps;
     heatmapCapture: HeatmapCaptureProps;
+    waterfallViewport: WaterfallViewportState;
     cursor: CursorProps;
     zoom: ZoomProps;
     signal: SignalProps;

package/types/store/ui.d.ts

@@ -44,8 +44,16 @@ export interface CursorProps {
     timeout: number;
     mode?: ModuleType;
 }
+export interface ZoomOverviewProps {
+    /** 是否在独立瀑布图缩放后显示全景导航。仅在 zoom.xy=true 时生效。 */
+    show?: boolean;
+}
 export interface ZoomProps {
     show: boolean;
+    /** 独立瀑布图是否启用 X/Y 同步缩放。 */
+    xy?: boolean;
+    /** 独立瀑布图的可选全景导航。 */
+    overview?: ZoomOverviewProps;
     select: boolean;
     interval: AxisXRange;
     style: null | Record<string, unknown>;

package/utils/subscription.d.ts

@@ -1,4 +1,4 @@
-import type { SpectrumAnalyzer, SpectrumOutputData } from '@rfkit/spectrum-analyzer';
+import type { SpectrumAnalyzer, SpectrumOutputData, WaterfallAnalyzer } from '@rfkit/spectrum-analyzer';
 import type { RecursiveFunction } from '../types';
 interface ChartsGlobal {
     datas: Record<string, unknown>;
@@ -37,6 +37,7 @@ export declare const getPublishSubscriptionKey: (globalID: string) => string;
 export declare const getModuleSubscriptionKey: (globalID: string, moduleName: string) => string;
 export declare const getDatabaseStorageKey: (globalID: string) => string;
 export declare const getAnalyzerStorageKey: (globalID: string) => string;
+export declare const getWaterfallAnalyzerStorageKey: (globalID: string) => string;
 export declare const getUpdateDataSubscriptionKey: (id?: string) => string;
 export declare const createPublishSubscriptionManager: (globalID: string, func?: CSMCallback, name?: string) => (...args: any[]) => void;
 export declare const createModuleSubscriptionManager: (globalID: string, moduleName: string, func?: CSMCallback, name?: string) => (...args: any[]) => void;
@@ -49,4 +50,5 @@ export default function withDatabase(globalID: string, data?: rawData): rawData;
 export declare const withUpdateData: (id?: string, name?: string, func?: RecursiveFunction) => (...args: any[]) => void;
 export declare const setScanDF360Prob: (id?: string, func?: RecursiveFunction<[boolean]>) => (...args: any[]) => void;
 export declare function withSpectrumAnalyzerSYNC(globalID: string, analyzer?: SpectrumAnalyzer): SpectrumAnalyzer;
+export declare function withWaterfallAnalyzerSYNC(globalID: string, analyzer?: WaterfallAnalyzer | null): WaterfallAnalyzer | null;
 export {};