@rfkit/charts 1.6.0 → 1.7.0

package/modules/Dial/index.d.ts

@@ -1,2 +1,2 @@
-declare const Dial: () => import("react/jsx-runtime").JSX.Element;
+declare const Dial: () => import("react").JSX.Element;
 export default Dial;

package/modules/IQEye/index.d.ts

@@ -2,5 +2,5 @@ import { type IQChartType } from '../base';
 interface IQEyeProps {
     type?: IQChartType;
 }
-export default function IQEye({ type }: IQEyeProps): import("react/jsx-runtime").JSX.Element;
+export default function IQEye({ type }: IQEyeProps): import("react").JSX.Element;
 export {};

package/modules/IQPlanisphere/index.d.ts

@@ -2,5 +2,5 @@ import { type IQChartType } from '../base';
 interface IQPlanisphereProps {
     type?: IQChartType;
 }
-export default function IQPlanisphere({ type }: IQPlanisphereProps): import("react/jsx-runtime").JSX.Element;
+export default function IQPlanisphere({ type }: IQPlanisphereProps): import("react").JSX.Element;
 export {};

package/modules/Spectrum/AxisYCanvas/index.d.ts

@@ -2,5 +2,5 @@ import type { RenderChartType } from '../../../types';
 interface AxisYCanvasProps {
     chart: RenderChartType | null;
 }
-export default function AxisYCanvas(props: AxisYCanvasProps): import("react/jsx-runtime").JSX.Element | null;
+export default function AxisYCanvas(props: AxisYCanvasProps): import("react").JSX.Element | null;
 export {};

package/modules/Spectrum/BandLayer/bandState.d.ts

@@ -0,0 +1,9 @@
+import type { SegmentType } from '../../../types/common.ts';
+import { type BandState } from '../../../types/store/ui.ts';
+export { resolveBandState } from '../../../store/bandState.ts';
+export interface BandPosition {
+    key: string;
+    left: number;
+    width: number;
+}
+export declare function resolveBandPositions(band: BandState, segments: SegmentType[]): BandPosition[];

package/package.json

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

package/store/bandState.d.ts

@@ -0,0 +1,7 @@
+import { type BandState } from '../types/store/ui.ts';
+export type BandUpdateStrategy = 'merge' | 'replace';
+/**
+ * 将 prop / publish 的 Band 输入归一化为唯一内部状态。
+ * 无效输入返回当前状态引用，避免破坏已生效的 Band。
+ */
+export declare function resolveBandState(input: Record<string, unknown>, current?: BandState, strategy?: BandUpdateStrategy): BandState;

package/types/publish.d.ts

@@ -111,9 +111,9 @@ export interface PointsEvent {
     pstype: 'points';
     data: number[];
 }
-export interface BandEvent extends BandProps {
+export type BandEvent = BandProps & {
     pstype: 'band';
-}
+};
 export interface ScopeEvent extends RecursiveObject {
     pstype: 'scope';
     frequency: number;

package/types/store/index.d.ts

@@ -24,7 +24,7 @@ import type { HeatmapCaptureProps } from './heatmap';
 import type { MarkerProps } from './marker';
 import type { LevelStreamProps, SeriesProps } from './series';
 import type { SignalAnalysisProps, SignalProps } from './signal';
-import type { BandProps, BlazeProps, CursorProps, DeltaMeasurementProps, EventBusProps, FluorescenceProps, FrequencyTagLineBoardProps, LegendProps, LimitProps, ScopeProps, StripeProps, SystemConfig, ToolbarProps, ZoomProps } from './ui';
+import type { BandProps, BandState, BlazeProps, CursorProps, DeltaMeasurementProps, EventBusProps, FluorescenceProps, FrequencyTagLineBoardProps, LegendProps, LimitProps, ScopeProps, StripeProps, SystemConfig, ToolbarProps, ZoomProps } from './ui';
 export interface StoreState {
     globalID: string;
     config: unknown;
@@ -43,7 +43,7 @@ export interface StoreState {
     zoom: ZoomProps;
     signal: SignalProps;
     signalAnalysis: SignalAnalysisProps;
-    band: BandProps;
+    band: BandState;
     scope: ScopeProps;
     gridLines: boolean;
     legend: LegendProps;
@@ -89,7 +89,7 @@ export interface ParamsProps {
     frequencyTagLine?: Partial<FrequencyTagLineBoardProps>;
     frequencyAllocation?: Partial<FrequencyAllocationProps>;
     toolbar?: Partial<ToolbarProps>;
-    band?: Partial<BandProps>;
+    band?: BandProps;
     levelStream?: Partial<LevelStreamProps>;
     deltaMeasurement?: Partial<DeltaMeasurementProps>;
     publish?: Publish;

package/types/store/ui.d.ts

@@ -53,12 +53,62 @@ export interface ZoomProps {
     onChange: (se: [string, string], interval: AxisXRange) => void;
     autoCloseTimeout: number;
 }
-export interface BandProps {
+type BandSharedProps = {
+    show?: boolean;
+    color?: string;
+};
+type BandPositionProps = {
+    left?: number;
+    width?: number;
+    frequency?: never;
+    bandwidth?: never;
+    startFrequency?: never;
+    stopFrequency?: never;
+};
+type BandCenterBandwidthProps = {
+    frequency: number;
+    bandwidth: number;
+    left?: never;
+    width?: never;
+    startFrequency?: never;
+    stopFrequency?: never;
+};
+type BandFrequencyRangeProps = {
+    startFrequency: number;
+    stopFrequency: number;
+    left?: never;
+    width?: never;
+    frequency?: never;
+    bandwidth?: never;
+};
+/** Band 对外配置：百分比、中心频率带宽、起止频率三种定位方式互斥。 */
+export type BandProps = BandSharedProps & (BandPositionProps | BandCenterBandwidthProps | BandFrequencyRangeProps);
+export declare const BandKind: {
+    readonly Position: "position";
+    readonly CenterBandwidth: "centerBandwidth";
+    readonly FrequencyRange: "frequencyRange";
+};
+export type BandKind = (typeof BandKind)[keyof typeof BandKind];
+/** Band 内部归一化状态。 */
+export type BandState = {
+    kind: typeof BandKind.Position;
     show: boolean;
+    color?: string;
     left?: number;
     width: number;
+} | {
+    kind: typeof BandKind.CenterBandwidth;
+    show: boolean;
     color?: string;
-}
+    frequency: number;
+    bandwidth: number;
+} | {
+    kind: typeof BandKind.FrequencyRange;
+    show: boolean;
+    color?: string;
+    startFrequency: number;
+    stopFrequency: number;
+};
 export interface ScopeProps {
     show: boolean;
     left: number;
@@ -112,3 +162,4 @@ export interface EventBusProps {
     onDoubleClick: (frequency: string, e: RecursiveObject) => void;
     [key: string]: unknown;
 }
+export {};

package/utils/object.d.ts

@@ -3,7 +3,7 @@
  */
 import type { RecursiveObject } from '../types';
 /**
- * 混合对象 - 将参数对象合并到源对象中
+ * 混合对象 - 将参数对象合并到源对象副本中
  * @param source 源对象
  * @param params 要混合的参数
  * @returns 混合后的对象