@rfkit/charts 1.4.0 → 1.4.2

package/README.md

@@ -1,6 +1,9 @@
 # rfkit-charts
 
-服务于无线电监测产品的 web 图表组件库
+服务于无线电监测产品的 Web 图表组件库。
+
+- 仓库名：`rfkit-charts`
+- npm 发布名：`@rfkit/charts`
 
 ## 安装
 
@@ -8,319 +11,199 @@
 pnpm add @rfkit/charts
 ```
 
-## 主题与 Tailwind 集成
-
-默认情况下，消费方只需要安装并直接使用组件：
-
-```ts
-import { Spectrum } from '@rfkit/charts';
-```
+正式版本由源码仓库内的 Release PR 自动发布到 npm；仓库里的本地 `publish:*` 脚本只作为维护调试或应急入口，不属于常规发布流程。
 
-本库发布产物已经默认携带新 UI 所需的样式，并会自动注入 charts 侧需要的主题 / 尺寸变量定义。外部项目不需要再额外引入 `tailwind-bridge.css` 才能让组件正常显示。
+## 发布入口
 
-也就是说，默认推荐接法仍然是：
+当前对外正式入口只有两个：
 
-```ts
-import { Spectrum } from '@rfkit/charts';
-```
+- JS / TS：`@rfkit/charts`
+- CSS bridge：`@rfkit/charts/tailwind-bridge.css`
 
-如果你的应用已经在使用 `@rfkit/theme`，接法也不需要改。charts 会只读根节点上的这两个契约标识：
+默认直接从包根导入组件即可。组件运行所需样式会随包根入口自动加载，普通消费方不需要额外引 CSS。
 
-- `theme`
-- `theme-follow-OS`
+## 快速开始
 
-也就是说，外部继续这样初始化即可：
+公开组件默认通过 `ref` 暴露 `Publish` 能力，不走 `publish` prop。
 
-```ts
+```tsx
+import { useEffect, useRef } from 'react';
 import {
-  initTheme,
-  toggleTheme,
-  toggleThemeMode
-} from '@rfkit/theme';
-
-initTheme();
-toggleTheme();
-toggleThemeMode();
-```
-
-`initChartsTheme()` 现在主要用于两个场景：
+  ChartType,
+  PSType,
+  Spectrum,
+  type Publish
+} from '@rfkit/charts';
 
-- 你想覆盖 charts 默认的 `themeConfigs` / `sizeConfigs`
-- 你想通过 `subscribeThemeChange` 订阅 charts 解析后的主题状态
+export function Demo() {
+  const chartRef = useRef<Publish>(null);
 
-只有在外部项目自己也使用 `Tailwind CSS v4 + shadcn/ui`，并且希望复用本库这套语义 token 时，才需要额外引入 bridge：
+  useEffect(() => {
+    chartRef.current?.({
+      pstype: PSType.Spectrum,
+      data: new Float32Array([12, 28, 19, 35, 17])
+    });
+  }, []);
 
-```css
-@import "tailwindcss";
-@import "@rfkit/charts/tailwind-bridge.css";
+  return <Spectrum ref={chartRef} type={ChartType.SingleFrequency} />;
+}
 ```
 
-说明：
+## Publish 使用方式
 
-- 默认包入口已经自动携带组件运行所需样式，并自动注入 charts 侧默认主题 / 尺寸变量
-- charts 默认只读取 `theme` / `theme-follow-OS`，不再把自己当主题真源
-- `@rfkit/charts/tailwind-bridge.css` 只提供 Tailwind/shadcn 语义 token 复用能力，不包含全局 reset
-- 如果外部项目继续使用 `@rfkit/theme` 的 `initTheme()` / `toggleTheme()` / `toggleThemeMode()`，charts 会自动跟随刷新
-- 更完整的主题桥接说明见 [docs/theme-migration.md](/Users/hugh/workspace/github/rfkit-charts/docs/theme-migration.md)
+大多数图表的数据输入都通过组件 `ref` 返回的 `Publish` 函数完成。
 
-更多项目说明见：[docs/README.md](/Users/hugh/workspace/github/rfkit-charts/docs/README.md)
-
-## 基本使用
-
-```jsx
+```tsx
+import { useEffect, useRef } from 'react';
 import {
-  // 频谱图
-  Spectrum,
-  LevelStream,
-  // IQ图
-  IQ,
-  // 仪表图
   Gauge,
-  Dial,
-  // 辅助图形
-  Heatmap,
-  Occupancy,
+  PSType,
+  type Publish
 } from '@rfkit/charts';
 
-// 行为推送
-const publishRef = useRef(null);
-const handlePublishChange = (publish) => {
-  publishRef.current? = publish;
-};
-
-// 图表类型
-export enum ChartType {
-  // 频谱图
-  SingleFrequency = 'singleFrequency',
-  Scan = 'scan',
-  MScan = 'mscan',
-  ScanDF360 = 'ScanDF360',
-  DDC = 'ddc',
-  Lite = 'lite',
-  LiteNormalized = 'liteNormalized',
-  LevelStream = 'levelStream',
-  // IQ图
-  IQEye = 'iqEye',
-  IQLine = 'iqLine',
-  IQPlanisphere = 'iqPlanisphere',
-  IQStream = 'iqStream',
-  // 辅助图形
-  Heatmap = 'heatmap',
-  Occupancy = 'occupancy',
-}
+export function GaugeDemo() {
+  const gaugeRef = useRef<Publish>(null);
 
-// 频谱图
-<Spectrum type="singleFrequency" publish={handlePublishChange} /> // 单频频谱
-<Spectrum type="scan" publish={handlePublishChange} /> // 扫描频谱
-<Spectrum type="scanDF360" publish={handlePublishChange} /> // 扫描测向概率统计
-<Spectrum type="ddc" publish={handlePublishChange} channel onChannelChange /> // DCC
-<Spectrum type="lite" publish={handlePublishChange} /> // 精简模式
-<Spectrum type="liteNormalized" publish={handlePublishChange} /> // 精简模式（Y轴范围0-1）
-
-// DDC特殊参数
-export interface Props {
-  channel?: number; // 默认32
-  onChannelChange?: (c: {
-    frequency: number;
-    type: MarkerEventType;
-    list: number[];
-  }) => void;
+  useEffect(() => {
+    gaugeRef.current?.({
+      pstype: PSType.Gauge,
+      value: 42,
+      limit: 60
+    });
+
+    gaugeRef.current?.({
+      pstype: PSType.Reset
+    });
+  }, []);
+
+  return <Gauge ref={gaugeRef} />;
 }
+```
 
-// 电平瀑布图
-<LevelStream />
+常用公开类型：
 
-// IQ类型
-<IQ type={ChartType} publish={handlePublishChange} />
+- `Publish`
+- `PublishData`
+- `PublishSpectrum`
+- `PublishHeatmap`
+- `PublishIQ`
+- `PublishLevelStream`
+- `PublishDial`
+- `PublishGauge`
+- `SetSeries`
+- `SetSegments`
+- `SetMarker`
 
-// 仪表盘
-<Gauge publish={handlePublishChange} />
-<Dial axisY={{range}} onChange={onChange} publish={handlePublishChange} />
-```
+工具栏相关命名统一使用：
 
-**publish（行为推送工具）**
-
-```typescript
-export enum PSType {
-  // 频谱数据
-  SPECTRUM = 'spectrum',
-  // 天线因子数据
-  ANTENNA_FACTOR = 'antennaFactor',
-  // 占用度数据
-  OCCUPANCY = 'occupancy',
-  // 电平流数据
-  LEVEL_STREAM = 'levelStream',
-  // 瀑布图数据
-  HEATMAP = 'heatmap',
-  // IQ数据
-  IQ = 'IQ',
-  // 示向度盘
-  DIAL = 'dial',
-  // 刻度尺
-  GAUGE = 'gauge',
-
-  // 频谱线属性
-  SERIES = 'series',
-  // 频谱带宽规则：一般用于单频频谱
-  SPECTRUM_BANDWIDTH = 'spectrumBandwidth',
-  // 多段扫描规则：一般用于扫描数据的多段组合
-  SEGMENTS = 'segments',
-  // 多路DCC
-  CHANNELS = 'channels',
-  // Marker
-  MARKER = 'marker',
-
-  // 图形操作
-  RESET = 'reset',
-}
+- 工具栏枚举使用 `ToolbarItemType`
+- 组件参数使用 `toolbar`
 
-// 系列配置
-interface SeriesConfig {
-  readonly name: string;
-  // 内外可设置属性
-  label?: string;
-  color?: string;
-}
+## 主题接入
 
-// 推送频谱线属性
-export interface SetSeries extends SeriesConfig {
-  pstype: PSType.Series;
-}
+charts 只读取根节点上的两个契约：
 
-// 设置频谱带宽规则
-export interface SetSpectrumBandwidth extends SpectrumBandwidth {
-  pstype: PSType.SpectrumBandwidth;
-}
+- `theme="light" | "dark"`
+- `theme-follow-OS="true" | "false"`
 
-// 设置多段扫描规则
-export interface SetSegments {
-  pstype: PSType.Segments;
-  event?: SegmentsEvent; // 事件类型：默认覆盖数据
-  data?: SegmentsOriginal[]; // 多段扫描规则：设置数据才使用
-  index?: number; // 段索引：需要外部聚焦某段才使用
-}
+应用层直接写这两个属性即可：
 
-// 设置天线因子
-export interface SetAntennaFactor {
-  pstype: PSType.AntennaFactor;
-  data: Float32Array;
-}
+```ts
+document.documentElement.setAttribute('theme', 'dark');
+document.documentElement.setAttribute('theme-follow-OS', 'false');
+```
 
-// 设置台站库信息
-export interface SetStationInfo {
-  pstype: PSType.StationInfo;
-  data: StationInfoType[];
-}
+如果宿主已经在用 `@rfkit/theme`，通常不需要额外迁移，因为它写的也是同一套根契约。
 
-// 设置多路DCC信道
-export interface SetChannels {
-  pstype: PSType.Channels;
-  event: MarkerEventType;
-  frequency?: number;
-}
+### `initChartsTheme()`
 
-// 设置Marker
-export interface SetMarker {
-  pstype: PSType.Marker;
-  event: MarkerEventType;
-  marker?: Partial<MarkerType>;
-  frequencies?: number[]; // 设计规定：frequencies必须是频率数据
-  silent?: boolean; // 是否通知外部onChange回调
-}
+`initChartsTheme()` 现在只承担三件事：
 
-// 额外的频谱数据
-export interface SpectrumExtraData {
-  [key: string]: Float32Array;
-}
-// 推送频谱数据
-export interface PublishSpectrum {
-  pstype: PSType.Spectrum;
-  data?: Float32Array;
-  // 一般仅在静态绘制
-  maxData?: Float32Array;
-  minData?: Float32Array;
-  avgData?: Float32Array;
-  backgroundNoiseData?: Float32Array;
-  templateData?: Float32Array;
-  extraData?: SpectrumExtraData;
-  // 瀑布图可选参数
-  timestamp?: string;
-  // 扫描可选参数
-  offset?: number; // 当前段的点偏移量
-  segmentOffset?: number; // 当前段的索引
-}
+- 覆盖 charts 默认 `tokens`
+- 覆盖默认 `sizes`
+- 通过 `onChange` 订阅解析后的主题状态
 
-// 推送瀑布图数据
-export interface PublishHeatmap {
-  pstype: PSType.Heatmap;
-  data: TimestampedFloat32Array[];
-  timestamps: number[];
-}
+```ts
+import { initChartsTheme } from '@rfkit/charts';
+
+initChartsTheme({
+  onChange: ({ followOS, theme, contractTheme }) => {
+    console.log(followOS, theme, contractTheme);
+  },
+  tokens: {
+    semantic: {
+      primary: {
+        light: '#2A51F7',
+        dark: '#4371F8'
+      }
+    }
+  },
+  sizes: {
+    spacing: {
+      base: {
+        middle: '8px',
+        small: '4px'
+      }
+    }
+  }
+});
+```
 
-// 推送占用度数据
-export interface PublishOccupancy {
-  pstype: PSType.Occupancy;
-  data: Float32Array;
-  totalOccupancy: number;
-}
+### 读取和订阅主题状态
 
-// 推送电平流数据
-export interface PublishLevelStream {
-  pstype: PSType.LevelStream;
-  data: number;
-}
+```ts
+import {
+  getChartsThemeState,
+  subscribeChartsThemeChange
+} from '@rfkit/charts';
 
-// 推送IQ数据
-export interface PublishIQ {
-  pstype: PSType.IQ;
-  IData: number[];
-  Qdata: number[];
-}
+const state = getChartsThemeState();
+console.log(state.theme, state.preference);
 
-// 推送Dial数据
-export interface PublishDial {
-  pstype?: PSType.Dial;
-  series: Array<{
-    value: number;
-    color: string;
-  }>;
-  range?: number[]; // 概率范围 0-360
-  yawAngle?: number; // 偏航角 0-360
-  isNorthFacing?: boolean; // 是否朝北
-}
+const cleanup = subscribeChartsThemeChange((nextState) => {
+  console.log(nextState.followOS, nextState.contractTheme);
+});
 
-// 推送Gauge数据
-export interface PublishGauge {
-  pstype?: PSType.Gauge;
-  value: number; // 值
-  limit: number; // 门限值
-}
+cleanup();
+```
 
-// 推送图形操作
-export interface Reset {
-  pstype: PSType.Reset;
-}
+### `tailwind-bridge.css`
 
-// 推送渲染数据（内部）
-export interface Render {
-  pstype: PSType.Render;
-  [key: string]: unknown;
-}
+只有当宿主自己也在用 `Tailwind CSS v4 + shadcn/ui`，并且想复用 charts 的 canonical token 时，才需要额外引入：
 
-export type PublishData =
-  | SetSeries
-  | SetSpectrumBandwidth
-  | SetSegments
-  | SetChannels
-  | SetMarker
-  | SetAntennaFactor
-  | PublishSpectrum
-  | PublishHeatmap
-  | PublishOccupancy
-  | PublishLevelStream
-  | PublishIQ
-  | PublishDial
-  | PublishGauge
-  | Reset
-  | Render;
+```css
+@import "tailwindcss";
+@import "@rfkit/charts/tailwind-bridge.css";
 ```
+
+这份 bridge 的边界是：
+
+- 只做 canonical charts token 到 Tailwind / shadcn 语义色板的映射
+- 不包含全局 reset
+- 不再兜底旧 `--theme-*` 变量
+- 不负责替宿主生成 `:root` 上的 canonical token
+
+## 非公开边界
+
+以下内容不属于对外源码 API：
+
+- 任意 `src/**` 源码路径
+- `test/**` preview / example 宿主
+- 仓库内部工程文档
+
+## 主题变更摘要
+
+当前主题系统已经完成二阶段收口，外部需要注意的 breaking change 主要有：
+
+- `initChartsTheme()` 不再接受 `themeConfigs` / `sizeConfigs` / `subscribeThemeChange`
+- 新配置入口改为 `tokens` / `sizes` / `onChange`
+- `applyChartsTheme()` 与 `applyChartsThemePreference()` 已移除
+- 默认运行时不再输出旧 `--theme-*` alias
+- `@rfkit/charts/tailwind-bridge.css` 不再暴露 deprecated bridge token
+
+## 文档边界
+
+- 对外安装、接入方式、主题契约和常用用法以本文为准。
+- 精确公开 API 以 `@rfkit/charts` 包根导出的类型声明和编辑器智能提示为准。
+- npm 打包产物只同步根 `README.md`，不会把仓库内的 `docs/*` 一并作为公开文档入口发布。
+- 仓库内部专题文档只在源码仓库内维护，不属于发布包对外文档入口。

package/components/AxisY/heatmap/index.d.ts

@@ -1,6 +1,6 @@
 import type React from 'react';
 import type { RenderChartType } from '../../../types';
-import GradientRibbon from './type/Default/GradientRibbon';
+import GradientRibbon from './variants/standard/GradientRibbon';
 export { GradientRibbon };
 interface Props {
     id: string;

package/components/AxisY/heatmap/variants/standard/index.d.ts

@@ -0,0 +1,6 @@
+import type React from 'react';
+interface Props {
+    id: string;
+}
+declare const StandardHeatmapAxisYVariant: React.FC<Props>;
+export default StandardHeatmapAxisYVariant;

package/components/Container/runtime.d.ts

@@ -0,0 +1,10 @@
+import type { SystemConfig } from '../../types/store';
+export interface ContainerSizeSnapshot {
+    height: number;
+    width: number;
+}
+type ContainerElementLike = Pick<HTMLElement, 'offsetHeight' | 'offsetWidth'>;
+export declare const readContainerSize: (element: ContainerElementLike | null | undefined) => ContainerSizeSnapshot | null;
+export declare const hasContainerSizeChanged: (previousSize: ContainerSizeSnapshot | null, nextSize: ContainerSizeSnapshot | null) => boolean;
+export declare const createNextSystemConfig: (system: SystemConfig, size: ContainerSizeSnapshot) => SystemConfig;
+export {};

package/components/Cursor/popover-support.d.ts

@@ -0,0 +1,8 @@
+import type React from 'react';
+export declare const POPOVER_ROW_CLASS = "mt-1 flex items-center justify-between gap-1 text-xs text-popover-foreground";
+export declare const POPOVER_VALUE_CLASS = "inline-flex min-w-9 justify-end";
+export declare const useCursorPopoverUpdateKey: (key: string, id: string) => number;
+export declare const FrequencyDisplay: React.FC<{
+    frequency: string;
+    unit: string;
+}>;

package/components/Toolbar/registry.d.ts

@@ -0,0 +1,12 @@
+import type React from 'react';
+import { ChartType, ToolbarItemType } from '../../config';
+export interface ToolbarItemConfig {
+    component: React.ComponentType<Record<string, unknown>>;
+    toolType: ToolbarItemType;
+    supportedCharts: ChartType[];
+    excludedCharts?: ChartType[];
+    props?: Record<string, unknown>;
+}
+export declare const TOOLBAR_ITEM_CONFIGS: ToolbarItemConfig[];
+export declare const isToolbarItemVisible: (config: ToolbarItemConfig, chartType: ChartType | undefined, hiddenTools?: string[]) => boolean;
+export declare const resolveToolbarItemProps: (config: ToolbarItemConfig, chartType: ChartType | undefined) => Record<string, unknown>;

package/components/Toolbar/toggles/index.d.ts

@@ -0,0 +1,10 @@
+export { AutorangingControl as AutorangingSwitch, UnitControl as UnitSwitch } from '../../AxisY/spectrum/controls';
+export { default as ZoomSwitch } from '../../Zoom/Switch';
+export { default as FluorescenceSwitch } from '../../../modules/Fluorescence/Switch';
+export { default as HeatmapCaptureSwitch } from '../../../modules/Heatmap/Capture/Switch';
+export { default as TimeRangeSwitch } from '../../../modules/Heatmap/TimeRange/Switch';
+export { default as DeltaMeasurementSwitch } from '../../../modules/Spectrum/DeltaMeasurement/Switch';
+export { default as FrequencyAllocationSwitch } from '../../../modules/Spectrum/FrequencyAllocation/Switch';
+export { default as LimitSwitch } from '../../../modules/Spectrum/Limit/Switch';
+export { default as MarkersSwitch } from '../../../modules/Spectrum/Markers/Switch';
+export { default as SignalSwitch } from '../../../modules/Spectrum/Signal/Switch';

package/components/Zoom/ZoomViewportLayer.d.ts

@@ -0,0 +1,7 @@
+interface Props {
+    children: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const ZoomViewportLayer: import("react").ForwardRefExoticComponent<Props & import("react").RefAttributes<HTMLDivElement>>;
+export default ZoomViewportLayer;

package/components/ui/button.d.ts

@@ -1,14 +1,14 @@
 import { type VariantProps } from 'class-variance-authority';
 import type { ButtonHTMLAttributes } from 'react';
 declare const buttonVariants: (props?: {
-    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost";
+    variant?: "link" | "destructive" | "secondary" | "default" | "outline" | "ghost";
     size?: "default" | "icon" | "sm" | "lg";
 } & import("class-variance-authority/types").ClassProp) => string;
 export type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & VariantProps<typeof buttonVariants> & {
     asChild?: boolean;
 };
 export declare const Button: import("react").ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & VariantProps<(props?: {
-    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost";
+    variant?: "link" | "destructive" | "secondary" | "default" | "outline" | "ghost";
     size?: "default" | "icon" | "sm" | "lg";
 } & import("class-variance-authority/types").ClassProp) => string> & {
     asChild?: boolean;

package/config/constants.d.ts

@@ -97,7 +97,7 @@ export declare enum ToolType {
     FrequencyDataBoard = "frequencyDataBoard",
     FrequencyTagLine = "frequencyTagLine",
     GridLines = "gridLines",
-    GuageBox = "guageBox",
+    GaugeBox = "gaugeBox",
     HeatmapCapture = "heatmapCapture",
     Legend = "legend",
     Limit = "limit",
@@ -112,7 +112,7 @@ export declare enum ToolType {
     Frame = "frame",
     Area = "area"
 }
-export declare enum ToolsBarItemType {
+export declare enum ToolbarItemType {
     AutorangingSwitch = "AutorangingSwitch",
     UnitSwitch = "UnitSwitch",
     StepSwitch = "StepSwitch",

package/hooks/index.d.ts

@@ -2,11 +2,10 @@
  * Hooks 统一导出
  */
 export { useChannel, usePoints, useSegments } from './data';
-export { type EnhancedPublish, PUB_SUB, useMarkerPublish, usePublish, useSafePublish } from './publish';
+export { type EnhancedPublish, PUB_SUB, usePublish, useSafePublish } from './publish';
 export { SET_SEGMENTS_DISPLAY, type UseSpectrumChartTypeProps, useSpectrumChartType, useSpectrumRule } from './spectrum';
 export { default as useChart } from './useChart';
 export { withChartPublisher } from './useChartComponent';
 export { default as useLevelStreamAnalyzer } from './useLevelStreamAnalyzer';
 export { useModuleSubscription } from './useModuleSubscription';
 export { useFilteredSeries, useSeriesForComponent, useSeriesManager } from './useSeriesManager';
-export { default as useSpectrumAnalyzer } from './useSpectrumAnalyzer';

package/hooks/module-subscription-core.d.ts

@@ -0,0 +1,23 @@
+export type ModulePublishType = 'antennaFactor' | 'autoranging' | 'band' | 'channels' | 'clear' | 'dial' | 'fluorescence' | 'gauge' | 'heatmap' | 'iq' | 'levelStream' | 'marker' | 'occupancy' | 'option' | 'points' | 'render' | 'reset' | 'resize' | 'segments' | 'series' | 'signal' | 'spectrum' | 'spectrumBandwidth' | 'scope';
+export interface ModulePublishEventBase {
+    pstype?: ModulePublishType;
+}
+export interface ChartSubscriptionInterface<TData = unknown> {
+    updateSeries?(data: TData, ...args: unknown[]): void;
+    reset(): void;
+    resize(): void;
+    setRange?(range: unknown): void;
+    setSeries?(config: unknown): void;
+    useRangeAutoFocus?(): void;
+}
+export type DataExtractor<TData, TEvent extends ModulePublishEventBase = ModulePublishEventBase> = (event: TEvent) => TData;
+export type ModuleEventHandler<TData = unknown, TEvent extends ModulePublishEventBase = ModulePublishEventBase> = (event: TEvent, chart: ChartSubscriptionInterface<TData>) => void;
+export interface ModuleSubscriptionHandlerOptions<TData = unknown, TEvent extends ModulePublishEventBase = ModulePublishEventBase> {
+    chart: ChartSubscriptionInterface<TData>;
+    eventHandlers?: Partial<Record<ModulePublishType, ModuleEventHandler<TData, TEvent>>>;
+    extractData?: DataExtractor<TData, TEvent>;
+    handleRender?: ModuleEventHandler<TData, TEvent>;
+    renderPSTypes?: ModulePublishType[];
+    treatMissingPSTypeAsRender?: boolean;
+}
+export declare const handleModuleSubscriptionEvent: <TData = unknown, TEvent extends ModulePublishEventBase = ModulePublishEventBase>(event: TEvent, { chart, eventHandlers, extractData, handleRender, renderPSTypes, treatMissingPSTypeAsRender }: ModuleSubscriptionHandlerOptions<TData, TEvent>) => void;

package/hooks/publish/enhancedPublish.d.ts

@@ -1,5 +1,5 @@
 import type { Publish, PublishData } from '../../types';
-import type { rawData } from '../../utils/subscription';
+import { type rawData } from '../../utils/subscription.ts';
 type ReadyCleanup = () => void;
 type ReadyCallback = () => ReadyCleanup | undefined;
 export interface EnhancedPublish extends Publish {

package/hooks/publish/index.d.ts

@@ -2,6 +2,5 @@
  * 发布相关 hooks
  */
 export type { EnhancedPublish } from './enhancedPublish';
-export { default as useMarkerPublish } from './useMarkerPublish';
 export { default as usePublish, PUB_SUB } from './usePublish';
 export { default as useSafePublish } from './useSafePublish';

package/hooks/publish/publish-event.d.ts

@@ -0,0 +1,9 @@
+export interface PublishEventLike {
+    pstype?: string;
+}
+interface NormalizeRenderPublishEventOptions {
+    allowImplicitRender?: boolean;
+    renderPSTypes?: string[];
+}
+export declare const normalizeRenderPublishEvent: <T extends PublishEventLike>(event: T, options?: NormalizeRenderPublishEventOptions) => T;
+export {};

package/hooks/useLevelStreamAnalyzer.d.ts

@@ -3,7 +3,7 @@ interface levelStreamRenderData {
     probabilityRangeData: Float32Array;
     spectrumData: Float32Array;
 }
-export default function uselevelStreamAnalyzer(): {
+export default function useLevelStreamAnalyzer(): {
     analyzer: LevelStreamAnalyzer;
     updateLevelStreamData: (renderData: levelStreamRenderData) => void;
 };