@sumslack/shadcn-pro 1.2.5

package/dist/index.d.ts

@@ -0,0 +1,1718 @@
+import { AgGridReactProps } from 'ag-grid-react';
+import { CellContextMenuEvent } from 'ag-grid-community';
+import { Checkbox as Checkbox_2 } from 'radix-ui';
+import { ClassProp } from 'class-variance-authority/types';
+import { ColDef } from 'ag-grid-community';
+import { ColumnHeaderContextMenuEvent } from 'ag-grid-community';
+import { DateRange } from 'react-day-picker';
+import { Dialog as Dialog_2 } from 'radix-ui';
+import { EChartsOption } from 'echarts';
+import { ExternalToast } from 'sonner';
+import { GridApi } from 'ag-grid-community';
+import { JSX } from 'react';
+import { LegendComponentOption } from 'echarts';
+import { OnSelectHandler } from 'react-day-picker';
+import * as React_2 from 'react';
+import { RefObject } from 'react';
+import * as ResizablePrimitive from 'react-resizable-panels';
+import { StoreApi } from 'zustand/vanilla';
+import { Switch } from 'radix-ui';
+import { Tabs as Tabs_2 } from 'radix-ui';
+import { toast } from 'sonner';
+import { ToasterProps } from 'sonner';
+import { Tooltip as Tooltip_2 } from 'radix-ui';
+import { VariantProps } from 'class-variance-authority';
+import { Z_INDEX } from '../../constants/z-index';
+
+declare interface ApiConfig {
+    isbin?: boolean;
+    encode_key?: string;
+    sign_key?: string;
+}
+
+/**
+ * 为 legend 区域创建 graphic 背景矩形，置于图表底部，宽度为整个 echart 宽度
+ * rect 的 bottom/height 需与 legend 的 bottom/height 一致，实现对齐
+ */
+export declare function buildProEChartsLegendBackgroundGraphic(options: {
+    width: number;
+    bottom: number;
+    height: number;
+    color?: string;
+}): {
+    elements: unknown[];
+};
+
+/**
+ * 根据 series 生成 legend 配置，柱状图 icon 用 rect，折线图用横条 path
+ * 与 temp 中 `buildLegendConfig` 一致；未传入 `legendScrollChrome` 时从 `:root` 读取 token。
+ * 推荐业务侧在 `option.legend` 中写官方格式并由 `mergeProEChartsOption` 自动增强；本函数保留供非 React 或一次性合并场景使用。
+ */
+export declare function buildProEChartsLegendConfig(series: ProEChartsLegendSeriesItem[], seriesVisible: boolean[], legendBottomOffset?: number, legendScrollChrome?: LegendComponentOption): EChartsOption["legend"];
+
+export declare function buildProEChartsScrollLegendChrome(tokens: ProEChartsThemeTokens): LegendComponentOption;
+
+export declare function buildProEChartsThemePartials(root: HTMLElement | null): ProEChartsThemePartials;
+
+/**
+ * 生成 tooltip formatter：图标根据 seriesType（scatter/line/bar）动态渲染
+ */
+export declare function buildProEChartsTooltipFormatter(): (params: unknown) => string;
+
+/**
+ * 根据 series 类型生成与 graphic 一致的 tooltip 图标 HTML
+ * line: 12x2 横条 | bar: 10x10 圆角矩形 | scatter/其他: 直径 8 的圆（与 legend 风格一致）
+ */
+export declare function buildProEChartsTooltipIconHtml(seriesType: string, color: string | Record<string, unknown> | undefined): string;
+
+/**
+ * 代理落点的完整 HTTPS URL（展示用）。本机实际请求多为同源 `/gw-nb/`，与 Vite `server` / `preview` 代理目标一致。
+ * @param apiId 脚本 API ID，支持前置斜杠
+ * @param isbin 是否使用 sdep-gateway-api2（默认 false，即 sdep-gateway-api）
+ * @param encode_key ，如果传入秘钥，表示加密二进制，和isbin联动使用
+ */
+export declare function buildSdpExecAbsoluteUrl(apiId: string, isbin?: boolean): string;
+
+export declare function buildSdpExecUrl(apiId: string, isbin?: boolean): string;
+
+declare function Button({ className, variant, size, asChild, ...props }: React_2.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
+    asChild?: boolean;
+}): React_2.JSX.Element;
+
+declare type ButtonComponentProps = React_2.ComponentProps<typeof Button>;
+
+declare const buttonVariants: (props?: ({
+    variant?: "primary" | "default" | "text" | "highlight" | "link" | "icon" | null | undefined;
+    size?: "default" | "xs" | "relaxed" | "lg" | "xl" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+declare function Checkbox({ className, ...props }: React_2.ComponentProps<typeof Checkbox_2.Root>): React_2.JSX.Element;
+
+declare type CheckboxComponentProps = React_2.ComponentProps<typeof Checkbox>;
+
+export declare function clearProFormLocalStorage(name: string): void;
+
+export { DateRange }
+
+declare function Dialog({ ...props }: React_2.ComponentProps<typeof Dialog_2.Root>): React_2.JSX.Element;
+
+export declare function DialogClose({ ...props }: React_2.ComponentProps<typeof Dialog_2.Close>): React_2.JSX.Element;
+
+export declare function DialogContent({ className, children, showCloseButton, closeButtonOnClick, ...props }: React_2.ComponentProps<typeof Dialog_2.Content> & {
+    showCloseButton?: boolean;
+    /** 点击内容区右上角内置关闭钮时触发（在 Radix 关闭弹层之前调用） */
+    closeButtonOnClick?: () => void;
+}): React_2.JSX.Element;
+
+export declare function DialogDescription({ className, ...props }: React_2.ComponentProps<typeof Dialog_2.Description>): React_2.JSX.Element;
+
+export declare function DialogFooter({ className, showCloseButton, children, ...props }: React_2.ComponentProps<"div"> & {
+    showCloseButton?: boolean;
+}): React_2.JSX.Element;
+
+export declare function DialogHeader({ className, ...props }: React_2.ComponentProps<"div">): React_2.JSX.Element;
+
+export declare function DialogTitle({ className, ...props }: React_2.ComponentProps<typeof Dialog_2.Title>): React_2.JSX.Element;
+
+export declare function DialogTrigger({ ...props }: React_2.ComponentProps<typeof Dialog_2.Trigger>): React_2.JSX.Element;
+
+declare const engine: ZustandEngine<Record<string, unknown>>;
+
+declare const engine_2: ZustandEngine<Record<string, unknown>>;
+
+/**
+ * 将业务侧按 ECharts 官方格式传入的 `legend` 与主题滚动条样式、尺寸与按 series 推断的 icon 合并。
+ * 供 `mergeProEChartsOption` 使用；调用方只需写官方字段（如 `type`、`data`），不必再调 `buildProEChartsLegendConfig`。
+ */
+export declare function enrichProEChartsLegend(theme: ProEChartsThemePartials, user: LegendComponentOption, series: ProEChartsLegendSeriesItem[]): LegendComponentOption;
+
+/**
+ * 仅传 `apiId`，请求 URL 自动为：
+ * `{getGwNbGatewayBase()}{SDP_EXEC_API_PREFIX}{apiId}`
+ *
+ * @param headers 可选；传入时合并进本次 POST（axios 配置），例如 Storybook 侧栏保存到 localStorage 后的 `getGwNbApiDevHeaders()`
+ *
+ * @returns  resolve 为完整响应体；业务载荷在 `data`，其 TypeScript 形态由泛型 `T` 描述（默认 `unknown`）。
+ */
+export declare function execApiById<T = unknown>(apiId: string, body?: SdpExecBody, headers?: Record<string, string>, apiConfig?: ApiConfig): Promise<SdpGatewayResponse<T>>;
+
+export { ExternalToast }
+
+/** 格式化 tooltip 中的数值显示 */
+export declare function formatProEChartsTooltipValue(value: unknown): string;
+
+export declare function getCollapserIconRotation(orientation: ProCollapserOrientation, collapsed: boolean, side: ProCollapserHandleSide): number;
+
+/**
+ * 根据 localStorage 中的用户配置生成请求头；仅包含非空字段。
+ * 另附 `Content-Type`（JSON POST 所需），不属于业务联调凭证。
+ */
+export declare function getGwNbApiDevHeaders(): Record<string, string>;
+
+/**
+ * 当前应使用的网关根路径：`localhost` / `127.0.0.1`（含 `vite build` + `vite preview`）走同源
+ * `/gw-nb/` 由 Vite 代理；其余按环境选择 QA / 正式完整 HTTPS 基址。
+ * ? 不再拼接完整地址, 只返回相对地址, 防止跨域
+ */
+export declare function getGwNbGatewayBase(): string;
+
+/** 从 option 中解析 legend.bottom 和 legend.height */
+export declare function getProEChartsLegendLayout(option: EChartsOption): {
+    bottom: number;
+    height: number;
+};
+
+/**
+ * 同步读取 localStorage 中指定表单的已存快照。
+ * `name` 与 `ProForm` 的 `formId` 一致；无数据或解析失败时返回 `null`。
+ */
+export declare function getProFormLocalStorage(name: string): Record<string, unknown> | null;
+
+/** 生成 ProIcon 使用代码，供 Story 复制 */
+export declare function getProIconUsageCode(type: ProIconType, options?: {
+    size?: number | string;
+    className?: string;
+}): string;
+
+/**
+ * 开发态与 Storybook 走 Vite `server.proxy` 的同源路径；生产态为 {@link getGwNbGatewayBase} 的默认落点之一，便于静态展示或 SSR 兜底。
+ * 与 `gw-nb-proxy.vite.ts` 中 `/gw-nb` 前缀一致。
+ */
+export declare const GW_NB_GATEWAY_BASE = "/gw-nb/";
+
+declare function Input({ className, type, ...props }: React_2.ComponentProps<"input">): React_2.JSX.Element;
+
+declare type InputComponentProps = React_2.ComponentProps<typeof Input>;
+
+/** 判断事件是否发生在 Pro 浮层（Select 下拉等）内，供 Dialog 拦截 outside 事件 */
+export declare function isProPopupElement(target: EventTarget | null): boolean;
+
+/** 当前 Dialog 是否为栈顶（最后打开、仍 open 的 Dialog） */
+export declare function isTopmostDialog(currentContent: HTMLElement | null): boolean;
+
+/** 从 localStorage 读取侧栏保存的联调项（无数据时为空字符串）。 */
+export declare function loadStorybookGwNbDevFields(): StorybookGwNbDevFields;
+
+export declare function mergeProEChartsOption(theme: ProEChartsThemePartials, partial: EChartsOption): EChartsOption;
+
+declare type PagePaginationBarProps = {
+    totalPages: number;
+    currentPage: number;
+    pageSize: number;
+    pageSizeOptions?: number[];
+    disabled?: boolean;
+    className?: string;
+    onPageChange: (page: number) => void;
+    onPageSizeChange: (pageSize: number) => void;
+};
+
+/**
+ * `formId.name`：`name` 可含 `.`；第一段子串为 formId，余下为字段名。
+ */
+export declare function parseFormPath(path: string): {
+    formId: string;
+    fieldName: string;
+};
+
+/** 公共 x/y 轴与 dataZoom（与 temp 中 ECHARTS_COMMON_OPTION 一致） */
+export declare const PRO_ECHARTS_AXIS_AND_DATAZOOM: {
+    readonly xAxis: {
+        readonly axisLabel: {
+            color: string;
+            fontSize: number;
+            fontWeight: "normal";
+        };
+        readonly axisTick: {
+            readonly show: false;
+        };
+        readonly axisLine: {
+            readonly lineStyle: {
+                readonly color: "#102C35";
+            };
+        };
+        readonly scale: true;
+        readonly splitLine: {
+            readonly show: false;
+        };
+    };
+    readonly yAxis: {
+        readonly show: true;
+        readonly scale: true;
+        readonly axisLine: {
+            readonly show: false;
+        };
+        readonly axisLabel: {
+            readonly formatter: (value: number) => string;
+            readonly color: string;
+            readonly fontSize: number;
+            readonly fontWeight: "normal";
+        };
+        readonly splitLine: {
+            readonly show: true;
+            readonly lineStyle: {
+                readonly color: "rgba(255, 255, 255, 0.15)";
+            };
+        };
+    };
+    /** 仅作用 x 轴，避免缩放时 y 轴与 splitLine 被 ECharts 内部更新导致消失 */
+    readonly dataZoom: readonly [{
+        readonly type: "inside";
+        readonly xAxisIndex: 0;
+    }];
+};
+
+/** 公共轴、图例样式，与业务 option 合并 */
+export declare const PRO_ECHARTS_AXIS_LABEL_COMMON: {
+    color: string;
+    fontSize: number;
+    fontWeight: "normal";
+};
+
+/** 公共 grid 配置 */
+export declare const PRO_ECHARTS_COMMON_GRID: {
+    readonly left: 10;
+    readonly right: 10;
+    readonly top: 10;
+    readonly bottom: 25;
+    readonly containLabel: true;
+};
+
+/** 公共 title 样式（业务 option 只需提供 title.text） */
+export declare const PRO_ECHARTS_COMMON_TITLE: {
+    left: number;
+    top: number;
+    textStyle: {
+        color: string;
+        fontSize: number;
+        fontWeight: "bold";
+    };
+};
+
+/** 公共 tooltip 样式 */
+export declare const PRO_ECHARTS_COMMON_TOOLTIP: {
+    backgroundColor: string;
+    borderColor: string;
+    textStyle: {
+        color: string;
+    };
+};
+
+/** 未在 option 中配置 legend 时使用的 grid 底部留白（为图例预留的 48 可收紧） */
+export declare const PRO_ECHARTS_GRID_BOTTOM_NO_LEGEND = 10;
+
+/** legend 背景区域默认高度 */
+export declare const PRO_ECHARTS_LEGEND_BAND_HEIGHT = 24;
+
+/** legend 向下偏移的默认值（距容器底边） */
+export declare const PRO_ECHARTS_LEGEND_BOTTOM_OFFSET_DEFAULT = 6;
+
+/**
+ * 图例 `data[].icon` 只决定形状；像素大小由 legend 的 `itemWidth` / `itemHeight` 决定。
+ * 若 `itemHeight` 过小（例如滚动图例 chrome 里为 2），`bar: "rect"` 会被压成细条，看起来像线。
+ */
+export declare const PRO_ECHARTS_LEGEND_ICON: {
+    readonly bar: "rect";
+    readonly line: "path://M0,4 L10,4 L10,6 L0,6 Z";
+};
+
+/** 图例符号外框：与 `PRO_ECHARTS_TOOLTIP_ICON.bar` 一致，柱状 rect 为正方形 */
+export declare const PRO_ECHARTS_LEGEND_ITEM: {
+    readonly w: 10;
+    readonly h: 10;
+};
+
+/** tooltip 中图标尺寸 */
+export declare const PRO_ECHARTS_TOOLTIP_ICON: {
+    readonly line: {
+        readonly w: 12;
+        readonly h: 2;
+    };
+    readonly bar: {
+        readonly w: 10;
+        readonly h: 10;
+        readonly r: 1;
+    };
+    readonly circle: {
+        readonly r: 4;
+    };
+};
+
+export declare const PRO_ICON_TYPES: readonly ["path-2", "quote-mini-window", "align-vertical-center-03", "annotation", "arrowed-segment", "caret-left", "caret-right", "double-down", "double-left", "double-right", "double-up", "down", "left", "revert", "right", "rollback", "caret-down", "caret-up", "up", "broken-line", "calculate-stroke-1", "calculate-stroke", "check", "divide", "equal-to", "minus", "multiplication", "plus", "union-1", "union-2", "union-23", "channel-lines", "chart-shape-stroke-1", "bars", "curve", "icon-stroke", "candle-stick-chart", "union-28", "union-29", "union-30", "union-31", "union-32", "union-33", "check-circle-o", "circular", "communication-shape-stroke", "contacts", "customer-service", "heart-o", "heart", "idcard", "like-o", "mail", "message", "mobile", "phone", "send-01", "share-alt", "share", "smile-o", "wechat", "team", "union-21", "user", "arrow", "cursor-close", "expand-02", "open", "pointing", "resize-col", "resize-row", "unavailable", "callin", "delete", "download", "drag-drop", "edit", "eye-hidden", "eye-o", "font-adjust", "popup", "save", "swap", "union-3", "union-4", "upload", "elliptical", "f9", "file-path-3", "document", "file", "group-1393", "pdf", "picture", "rectangle-3-1", "rectangle-3", "union-24", "union-25", "union-26", "folder-open", "folder", "frame-21-1", "frame-21-2", "frame-21-3", "frame-21-4", "frame-21", "func-export", "gann-box", "general-group-manage", "general-follow-collect", "general-path-stroke", "general-path", "general-image-copy", "app-full-normal", "app-min-normal", "app-restore-normal", "appstore-o", "arrows-alt", "bell", "belled", "calendar", "camera-o", "clock-circle", "general-close", "copy", "desktop", "error", "flag", "flash", "group-1394", "help-circle-o", "home", "info-circle-o", "jingxuan", "link", "location", "lock-o", "magnify-panel", "minus-square-o", "more-vertical", "more", "need-to-ask", "paper-clip", "plus-square-o", "pushpin-o", "pushpin", "reload", "scan", "general-screenshot", "search", "setting", "shrink", "skin", "star-o", "star", "subtract-1", "subtract-2", "subtract-3", "subtract-4", "subtract-5", "subtract-6", "subtract", "sync", "tag-o", "general-to-top", "union-10", "union-11", "union-12", "union-5", "union-6", "union-7", "union-8", "union-9", "unlock-o", "warning", "group-37", "hexagon", "horizontal-line", "column-vertical-4", "grid-4", "grid-6", "grid-9", "like-thumb-up", "line", "linear-regression-bands", "linear-regression-lines", "measure-target", "measurement", "news-follow-collect", "news-path-1", "news-all-sentiment", "news-daily-weekly-report", "news-shape", "news-important-info", "union-13", "union-14", "union-15", "union-16", "union-17", "union-18", "union-19", "union-20", "union-22", "union-27", "vector-1", "vector", "operation-default-1", "operation-default-2", "operation-default", "parallel-lines", "price-label", "ray", "rectangle-1157", "rectangle", "screenshot", "segment", "standard-deviation-channel", "quote-widget", "text-tool", "time-scale", "triangle", "union", "vertical-line", "wave-ruler"];
+
+/** 标签业务类型（机构 / 市场 / 报价等） */
+export declare const PRO_TAG_TYPES: readonly ["国利", "国际", "平安", "信唐", "中诚", "上田", "匿名", "双边", "上固收", "CFETS", "上交所", "深交所", "北交所", "上证固收", "交易所", "经纪商", "中债", "X-Bond", "双边报价"];
+
+/**
+ * 在 shadcn Button 之上的业务封装：统一加载态与图标间距。
+ * 后续可在此集中扩展权限、埋点、尺寸规范等。
+ */
+export declare function ProButton({ className, loading, disabled, children, width, style, ...props }: ProButtonProps): React_2.JSX.Element;
+
+export declare type ProButtonProps = Omit<ButtonComponentProps, "variant" | "size" | "disabled"> & {
+    /**
+     * 视觉变体：如主要、文字、线框、强调次要、链接、图标等，与底层 `Button` 一致。
+     */
+    variant?: ButtonComponentProps["variant"];
+    /**
+     * 尺寸：紧凑（`xs`）、默认、宽松（`relaxed`）、大型（`lg`）、超大（`xl`）。
+     */
+    size?: ButtonComponentProps["size"];
+    /**
+     * 是否禁用。为 `true` 时不可点击；`loading` 为 `true` 时内部也会禁用。
+     */
+    disabled?: ButtonComponentProps["disabled"];
+    /** 是否显示加载态并禁用点击（与 `disabled` 叠加为 `disabled || loading`）。 */
+    loading?: boolean;
+    /**
+     * 按钮宽度，写入内联样式 `width`。
+     * `number` 会转为 `${n}px`；`string` 原样使用（如 `100%`、`12rem`）。
+     */
+    width?: React_2.CSSProperties["width"];
+};
+
+/**
+ * 在 shadcn Checkbox（Radix）之上的业务封装：统一 Pro 品牌外观。
+ */
+export declare function ProCheckbox({ className, type: boxType, children, disabled, name, checked, defaultChecked, onCheckedChange, ...props }: ProCheckboxProps): React_2.JSX.Element;
+
+export declare type ProCheckboxProps = Omit<CheckboxComponentProps, "type"> & {
+    /** 圆形或正方形（正方为 2px 圆角）。 */
+    type?: ProCheckboxType;
+    /** 可选：显示在复选框右侧的文案或节点（传入时用 label 包裹，点击文案可切换勾选）。 */
+    children?: React_2.ReactNode;
+    /** 在 `ProForm` 内写入 `proFormBridge`（字段名） */
+    name?: string;
+};
+
+export declare type ProCheckboxType = "round" | "square";
+
+export declare function ProCollapserHandle({ withHandle, collapsed, onCollapsedChange, side, collapsedSize, className, ...props }: ProCollapserHandleProps): React_2.JSX.Element;
+
+export declare type ProCollapserHandleProps = React_2.ComponentProps<"div"> & {
+    withHandle?: boolean;
+    collapsed?: boolean;
+    onCollapsedChange?: (collapsed: boolean) => void;
+    /** 折叠方向：`start` 折叠手柄前的面板，`end` 折叠手柄后的面板 */
+    side?: ProCollapserHandleSide;
+    /**
+     * 与相邻折叠面板的 `collapsedSize` 保持一致。
+     * 大于 0 时折叠后手柄仍居中于分隔线，避免按钮整体偏移到未折叠侧。
+     */
+    collapsedSize?: number;
+};
+
+export declare type ProCollapserHandleSide = "start" | "end";
+
+export declare type ProCollapserOrientation = "horizontal" | "vertical";
+
+export declare function ProCollapserPanel({ className, collapsed, collapsedSize, animated, duration, style, children, ...props }: ProCollapserPanelProps): React_2.JSX.Element;
+
+export declare function ProCollapserPanelGroup({ className, orientation, ...props }: ProCollapserPanelGroupProps): React_2.JSX.Element;
+
+export declare type ProCollapserPanelGroupProps = React_2.ComponentProps<"div"> & {
+    orientation?: ProCollapserOrientation;
+};
+
+export declare type ProCollapserPanelProps = React_2.ComponentProps<"div"> & {
+    collapsed?: boolean;
+    /**
+     * 折叠后保留的尺寸（px）。默认 `0` 表示完全折叠；
+     * 设为大于 0 的值可保留窄条区域（如侧栏图标轨）。
+     */
+    collapsedSize?: number;
+    /** 是否开启折叠动画，默认关闭 */
+    animated?: boolean;
+    /** 折叠动画时长（ms），默认 200；仅在 `animated` 为 true 时生效 */
+    duration?: number;
+};
+
+/**
+ * 根据表单引擎快照驱动网关请求，并把 `execApiById` 返回的 **整段 `data`**（可经 `onApiRender` 映射）写入全局 bridge 快照。
+ * 本身不渲染 UI（返回 `null`）。
+ */
+export declare function ProDataBridge({ name, apiId, formName, formFields, action, order, pageSize, preflightCheck, onApiRender, dataKey, socketData, }: ProDataBridgeProps): null;
+
+export declare type ProDataBridgeAction = "auto" | "manual";
+
+/** 单次 `refetch` / `loadNextPage` / `loadPage` 调用时并入请求 `params` 的扩展字段；同名键覆盖表单与表格排序参数 */
+declare type ProDataBridgeCallParams = Record<string, unknown>;
+
+declare type ProDataBridgeEntry = {
+    data: unknown;
+    loading: boolean;
+    error: string | null;
+    /**
+     * 当前已成功加载的最后一页页码（从 0 起，与请求 `pageNum` 一致）。
+     * 尚无成功请求时为 `-1`；`refetch` 或表单触发的首屏请求进行过程中会先被置为 `0`。
+     */
+    pageNum: number;
+    /** 与 {@link ProDataBridge} 请求体中的 `pageSize` 一致，由 Bridge 写入；默认 `20`。 */
+    pageSize: number;
+    /**
+     * 仅当同名 {@link ProDataBridge} 为 `action="auto"` 时：筛选项变化或 `refetch`（第 0 页）由 Bridge 自增；
+     * `action="manual"` 时 **不会** 因 `refetch` 或筛选项变化而自增。订阅方在该值变化时将纵向滚动重置到顶部。
+     */
+    scrollResetToken: number;
+    /**
+     * 是否启用前置校验（由 {@link ProDataBridge} 在 `action="auto"` 且 `preflightCheck` 为真时写入）。
+     * 为真时，须 {@link useProDataBridgePreflight} 将 {@link preflightPassed} 置为 `true` 后才允许发起请求。
+     */
+    preflightRequired: boolean;
+    /** 前置校验是否已通过；未启用前置校验时恒为 `true`。 */
+    preflightPassed: boolean;
+    /**
+     * 是否还可调用 `loadNextPage`（无限滚动末页判定）。
+     * 由 {@link ProDataBridge} 在每次请求成功且 `loading` 即将置为 `false` 时按 `pageSize` 启发式更新；
+     * 覆盖型请求（`refetch` / `loadPage` / 表单首屏）开始时会乐观重置为 `true`。
+     */
+    hasMore: boolean;
+};
+
+export declare type ProDataBridgeProps = {
+    /** 实例标识，供 {@link useProDataBridge} 订阅 */
+    name: string;
+    /** 网关脚本 / API 标识 */
+    apiId: string;
+    /**
+     * 绑定表单：与 {@link ProForm} 的 `formId` 一致（组件参数命名为 formName 仅为语义上的「表单名」）。
+     */
+    formName?: string;
+    /** 若指定，则仅将这些字段写入请求 `params`；否则传入当前表单全部快照字段 */
+    formFields?: string[];
+    /**
+     * `auto`：表单快照变化时自动请求；筛选项变化或 `refetch` 时会自增 `scrollResetToken`（供表格滚回顶部）。
+     * `manual`：仅在被 `useProDataBridge(...).refetch()` 触发时请求；**不会**自增 `scrollResetToken`。
+     */
+    action?: ProDataBridgeAction;
+    /**
+     * 仅当 `action="auto"` 且由表单快照触发的自动请求时生效：`0` 最先执行，数值越大越靠后；
+     * 相同 `order` 的实例在同一阶段并行请求；较小 `order` 的整层全部结束后才开始下一层。
+     * `refetch()`、`loadNextPage()` 以及 `action="manual"` 不受此参数影响。
+     */
+    order?: number;
+    /** 传给 `execApiById` 的分页大小，默认 20 */
+    pageSize?: number;
+    /**
+     * 是否启用前置校验；**仅 `action="auto"` 时生效**。
+     * 启用后 `preflightPassed` 初始为 `false`，须通过 {@link useProDataBridgePreflight} 置为 `true` 后才允许任何请求。
+     */
+    preflightCheck?: boolean;
+    /**
+     * `apiId` 请求成功后对响应体中的 `data` 做映射（例如非标准结构转为本库期望的形态）。
+     * 返回值会写入 bridge 快照；`loadNextPage` 时每一页都会先经此函数再与已有 `data` 合并。
+     */
+    onApiRender?: (data: unknown) => unknown;
+    /**
+     * 列表项唯一键字段名；与 {@link socketData} 联用时必填。
+     * 仅指定 `dataKey` 而不传 `socketData` 时无额外行为。
+     */
+    dataKey?: string;
+    /**
+     * WebSocket 等推送的增量操作；可为单条或批次数组，变更时按 `type` 合并进当前 `data`。
+     * 指定时必须同时指定 {@link dataKey}。
+     */
+    socketData?: ProDataBridgeSocketItem | ProDataBridgeSocketItem[];
+};
+
+export declare type ProDataBridgeSocketAction = "INSERT" | "UPDATE" | "DELETE";
+
+export declare type ProDataBridgeSocketItem = {
+    type: ProDataBridgeSocketAction;
+    data: Record<string, unknown>;
+};
+
+/**
+ * 基于 shadcn `Popover` + `Calendar` 的日期选择，触发器样式与 Pro 系列控件对齐。
+ */
+export declare function ProDataPicker({ value, defaultValue, onValueChange, onSelect, placeholder, disabled, className, contentClassName, size, displayFormat, valueFormat, name, allowClear, }: ProDataPickerProps): React_2.JSX.Element;
+
+/** `mode="single"` 且非 required 时 DayPicker 的 `onSelect` 签名 */
+declare type ProDataPickerCalendarOnSelect = OnSelectHandler<Date | undefined>;
+
+export declare type ProDataPickerProps = {
+    /** 当前日期（受控），支持 `Date` 或按 `valueFormat` 格式化的字符串 */
+    value?: Date | string;
+    /** 默认日期（非受控），支持 `Date` 或按 `valueFormat` 格式化的字符串 */
+    defaultValue?: Date | string;
+    /**
+     * 选择器的**值**变更时触发，按 `valueFormat` 输出字符串（或清空时的 `undefined`）。
+     * 用于受控 `value`、表单同步；在 `ProForm` 内配合 `name` 时，内部写入 store 后仍会调用（与 `useProFormFieldSync` 的 `onChange` 一致）。
+     * 在日历里点选某一天并成功提交选择后调用，且晚于 `onSelect`。
+     */
+    onValueChange?: (value: string | undefined) => void;
+    /**
+     * 日历面板内由 DayPicker 触发的**选日**回调，与 `react-day-picker` 的 `onSelect` 一致：
+     * 参数依次为「选中的日期」「触发交互的日期」「该日的 modifiers」「鼠标或键盘事件」。
+     * 适合埋点、或需要区分「点击的是哪一天」与「最终选中值」的场景；做表单绑定时仍应使用 `onValueChange`。
+     */
+    onSelect?: ProDataPickerCalendarOnSelect;
+    placeholder?: string;
+    disabled?: boolean;
+    className?: string;
+    contentClassName?: string;
+    size?: ProDataPickerSize;
+    /** 展示用格式，传给 `date-fns` 的 `format` */
+    displayFormat?: string;
+    /** 值输出格式（`onValueChange` / 表单快照），传给 `date-fns` 的 `format` */
+    valueFormat?: string;
+    /** 在 `ProForm` 内写入 `proFormBridge`（字段名） */
+    name?: string;
+    /** 为 `true` 时，悬停触发器右侧显示清除按钮，点击清空已选日期 */
+    allowClear?: boolean;
+};
+
+declare type ProDataPickerSize = "small" | "normal" | "big";
+
+/**
+ * 基于 shadcn `Dialog` 的封装：支持默认标题；未传 `renderFooter` 时使用 `ProButton` 默认底栏（取消 / 确定）。
+ * 可选 `onClose` / `onOk` 对应关闭与确定（仅默认底栏与内置关闭钮；自定义 `renderFooter` 请自行处理）。
+ * 受控（传 `open`）时「确定」不自动关弹，由 `onOk` 内自行更新 `open`。
+ * 非受控时「确定」默认自动关弹；`onOk` 返回 `false` 时保持打开。
+ * 头尾也可通过 `renderHeader` / `renderFooter` 完全自定义。
+ * 渲染函数会收到 `open` 与 `setOpen`，便于在自定义按钮中关闭弹层。
+ */
+export declare function ProDialog({ trigger, title, renderHeader, renderFooter, headerClassName, footerClassName, onClose, onOk, open: openProp, onOpenChange, defaultOpen, modal, children, className, showCloseButton, onPointerDownOutside, onInteractOutside, onFocusOutside, onEscapeKeyDown, ...contentProps }: ProDialogProps): React_2.JSX.Element;
+
+export declare type ProDialogContext = {
+    /** 当前是否打开（受控时为外部 `open`，非受控时为内部同步状态） */
+    open: boolean;
+    setOpen: (open: boolean) => void;
+};
+
+export declare type ProDialogProps = Omit<React_2.ComponentProps<typeof Dialog>, "children"> & {
+    /** 包在 `DialogTrigger asChild` 内；纯受控弹层可不传 */
+    trigger?: React_2.ReactElement;
+    /** 头部标题文案（用于默认 `DialogTitle`；与 `renderHeader` 互斥，优先 `renderHeader`） */
+    title?: React_2.ReactNode;
+    /** 完全自定义头部区域 */
+    renderHeader?: (ctx: ProDialogContext) => React_2.ReactNode;
+    /**
+     * 自定义底部区域（建议内部使用 `DialogClose` 或 `ctx.setOpen(false)` 关闭）。
+     * 未传时渲染默认底部：`ProButton`「取消」（`variant="default"`）与「确定」（`variant="primary"`），尺寸均为 `default`（常规）。
+     */
+    renderFooter?: (ctx: ProDialogContext) => React_2.ReactNode;
+    /** 套在默认 `DialogHeader` 上的 `className`（仅默认 `title` 头部时生效） */
+    headerClassName?: string;
+    /** 套在 `renderFooter` 外层 `DialogFooter` 上的 `className` */
+    footerClassName?: string;
+    /** 主体内容（标题与底部之间） */
+    children?: React_2.ReactNode;
+    /** 点击头部关闭钮、内容区内置关闭钮，或默认底栏「取消」时触发（默认底栏 / 默认关闭钮；自定义 `renderFooter` 需自行调用） */
+    onClose?: () => void;
+    /**
+     * 默认底栏「确定」点击时触发。
+     * **受控**（传了 `open`）时不会自动关弹，请在回调里自行更新外部的 `open`（例如 `setOpen(false)`）。
+     * **非受控**时默认在回调后由组件内关闭弹层；若返回 `false` 则保持打开（便于校验失败不关弹）。
+     */
+    onOk?: () => void | false;
+} & Omit<React_2.ComponentProps<typeof DialogContent>, "children" | "showCloseButton" | "closeButtonOnClick"> & {
+    showCloseButton?: boolean;
+};
+
+export declare type ProEChartsLegendSeriesItem = {
+    name?: string;
+    type?: string;
+    itemStyle?: {
+        color?: string;
+    };
+    data?: unknown[];
+};
+
+export declare type ProEChartsThemePartials = {
+    tokens: ProEChartsThemeTokens;
+    scrollLegendChrome: LegendComponentOption;
+};
+
+export declare type ProEChartsThemeTokens = {
+    textSecondary: string;
+    textDisabled: string;
+};
+
+export declare type ProEChartsTooltipParam = {
+    seriesName?: string;
+    seriesType?: string;
+    color?: string | Record<string, unknown>;
+    value?: unknown;
+    axisValue?: string;
+};
+
+/**
+ * 品牌筛选条：根据 `options` 渲染可单选或多选的紧凑项，项间距 2px；`size` 控制高度、内边距与字阶（默认 `normal`）。
+ * `multiple` 默认 `true`；值统一为数组 `value`，单选时至多一项。
+ * 多选时在首部自动生成「全部」：`value` 为全部可选（未 `disable`）项的有序集合时视为全选；此时页面上仅有「全部」呈选中样式，各分项不高亮；逐项选满后与点「全部」等价（`value` 同上）。全选态下再点击某一分项视为「只选中该项」（`value` 变为仅该项），而非从全集中取消该项。单选与多选均要求至少保留一项选中：仅剩一项时再次点击该项不会取消勾选；全选态下再次点击「全部」也不会取消勾选。
+ * 提供可选 `name` 且在 `ProForm` 上下文中时，选中数组与 `proFormBridge` 同步，可通过 `useFormValues` / `useField` / `getField` 等读写。
+ */
+export declare function ProFilter<T extends string | number = string | number>(props: ProFilterProps<T>): React_2.ReactElement;
+
+export declare type ProFilterOption<T extends string | number = string | number> = {
+    label: React_2.ReactNode;
+    value: T;
+    disable?: boolean;
+};
+
+export declare type ProFilterProps<T extends string | number = string | number> = {
+    /** 筛选项配置：`label`、`value`、`disable`。 */
+    options: ProFilterOption<T>[];
+    /** 尺寸规格，默认 `normal`。稿面：`small` 18px；`normal` / `big` 均为 24px（样式一致）。 */
+    size?: ProFilterSize;
+    className?: string;
+    /** 多选，默认 `true`；单选时 `value` 至多一项（长度为 0 或 1）。 */
+    multiple?: boolean;
+    /** 选中值数组；单选时长度 0 或 1，多选可多元素。 */
+    value?: T[];
+    /** 非受控初始值；可为数组，或单个 `string` / `number`（会自动包成一项数组）。 */
+    defaultValue?: T | T[];
+    onChange?: (value: T[]) => void;
+    /** 置于 `ProForm` 内时写入 `proFormBridge`（字段值为当前选中数组）。 */
+    name?: string;
+};
+
+export declare type ProFilterSize = "small" | "normal" | "big";
+
+/**
+ * 为子树中的 Pro 组件提供 `formId` 上下文；带 `name` 的字段会写入 `proFormBridge`。
+ */
+export declare function ProForm({ formId, defaultValues, persistToLocalStorage, className, children, ...rest }: ProFormProps): React_2.JSX.Element;
+
+declare type ProFormBridge = {
+    engine: typeof engine;
+    getFormValues: (formId: string) => Record<string, unknown>;
+    setField: (formId: string, fieldName: string, value: unknown) => void;
+    /** 按字段 `name` 批量写入快照；已存在的键会被覆盖，界面会随 `useFormValues` / `useField` 更新 */
+    setFormValues: (formId: string, values: Record<string, unknown>) => void;
+    getFieldByPath: (path: string) => unknown;
+    getField: (formId: string, fieldName: string) => unknown;
+    hasField: (formId: string, fieldName: string) => boolean;
+    clearFormKeys: (formId: string) => void;
+    useFormValues: (formId: string) => Record<string, unknown>;
+    useField: (formId: string, fieldName: string) => unknown;
+    useFieldByPath: (path: string) => unknown;
+};
+
+export declare const proFormBridge: ProFormBridge;
+
+declare type ProFormContextValue = {
+    formId: string;
+};
+
+/** 按字段 `name` 为键的初始值；写入 `proFormBridge` 后由子字段消费 */
+declare type ProFormDefaultValues = Record<string, unknown>;
+
+declare type ProFormFieldSync<V> = {
+    active: false;
+} | {
+    active: true;
+    merged: V | undefined;
+    commit: (next: V) => void;
+};
+
+export declare type ProFormProps = React_2.HTMLAttributes<HTMLDivElement> & {
+    /** 引擎中识别该表单的 id，并与各字段 `name` 组合成快照键 */
+    formId: string;
+    /**
+     * 表单级默认值：键为各 Pro 字段的 `name`，值为该字段在引擎中的初始快照。
+     * 仅在该 `formId` + 本对象组合首次生效，且对应字段在引擎中尚不存在时写入。
+     */
+    defaultValues?: ProFormDefaultValues;
+    /**
+     * 是否将表单快照实时写入 localStorage（键为 `formId`）。
+     * 开启后会在挂载时尝试从本地恢复；每次引擎中该表单字段变化时同步保存。
+     * @default false
+     */
+    persistToLocalStorage?: boolean;
+};
+
+export declare function ProIcon({ type, size, className, style, role, ...props }: ProIconProps): React_2.JSX.Element | null;
+
+export declare type ProIconProps = Omit<React_2.HTMLAttributes<HTMLSpanElement>, "children"> & {
+    /** 图标名称，对应设计系统 SVG 文件名（已规范化） */
+    type: ProIconType;
+    /** 图标尺寸，默认 16 */
+    size?: number | string;
+};
+
+/** 图标 type 对应的原始文件路径（便于排查来源） */
+export declare const proIconSourceMap: Record<ProIconType, string>;
+
+export declare type ProIconType = "path-2" | "quote-mini-window" | "align-vertical-center-03" | "annotation" | "arrowed-segment" | "caret-left" | "caret-right" | "double-down" | "double-left" | "double-right" | "double-up" | "down" | "left" | "revert" | "right" | "rollback" | "caret-down" | "caret-up" | "up" | "broken-line" | "calculate-stroke-1" | "calculate-stroke" | "check" | "divide" | "equal-to" | "minus" | "multiplication" | "plus" | "union-1" | "union-2" | "union-23" | "channel-lines" | "chart-shape-stroke-1" | "bars" | "curve" | "icon-stroke" | "candle-stick-chart" | "union-28" | "union-29" | "union-30" | "union-31" | "union-32" | "union-33" | "check-circle-o" | "circular" | "communication-shape-stroke" | "contacts" | "customer-service" | "heart-o" | "heart" | "idcard" | "like-o" | "mail" | "message" | "mobile" | "phone" | "send-01" | "share-alt" | "share" | "smile-o" | "wechat" | "team" | "union-21" | "user" | "arrow" | "cursor-close" | "expand-02" | "open" | "pointing" | "resize-col" | "resize-row" | "unavailable" | "callin" | "delete" | "download" | "drag-drop" | "edit" | "eye-hidden" | "eye-o" | "font-adjust" | "popup" | "save" | "swap" | "union-3" | "union-4" | "upload" | "elliptical" | "f9" | "file-path-3" | "document" | "file" | "group-1393" | "pdf" | "picture" | "rectangle-3-1" | "rectangle-3" | "union-24" | "union-25" | "union-26" | "folder-open" | "folder" | "frame-21-1" | "frame-21-2" | "frame-21-3" | "frame-21-4" | "frame-21" | "func-export" | "gann-box" | "general-group-manage" | "general-follow-collect" | "general-path-stroke" | "general-path" | "general-image-copy" | "app-full-normal" | "app-min-normal" | "app-restore-normal" | "appstore-o" | "arrows-alt" | "bell" | "belled" | "calendar" | "camera-o" | "clock-circle" | "general-close" | "copy" | "desktop" | "error" | "flag" | "flash" | "group-1394" | "help-circle-o" | "home" | "info-circle-o" | "jingxuan" | "link" | "location" | "lock-o" | "magnify-panel" | "minus-square-o" | "more-vertical" | "more" | "need-to-ask" | "paper-clip" | "plus-square-o" | "pushpin-o" | "pushpin" | "reload" | "scan" | "general-screenshot" | "search" | "setting" | "shrink" | "skin" | "star-o" | "star" | "subtract-1" | "subtract-2" | "subtract-3" | "subtract-4" | "subtract-5" | "subtract-6" | "subtract" | "sync" | "tag-o" | "general-to-top" | "union-10" | "union-11" | "union-12" | "union-5" | "union-6" | "union-7" | "union-8" | "union-9" | "unlock-o" | "warning" | "group-37" | "hexagon" | "horizontal-line" | "column-vertical-4" | "grid-4" | "grid-6" | "grid-9" | "like-thumb-up" | "line" | "linear-regression-bands" | "linear-regression-lines" | "measure-target" | "measurement" | "news-follow-collect" | "news-path-1" | "news-all-sentiment" | "news-daily-weekly-report" | "news-shape" | "news-important-info" | "union-13" | "union-14" | "union-15" | "union-16" | "union-17" | "union-18" | "union-19" | "union-20" | "union-22" | "union-27" | "vector-1" | "vector" | "operation-default-1" | "operation-default-2" | "operation-default" | "parallel-lines" | "price-label" | "ray" | "rectangle-1157" | "rectangle" | "screenshot" | "segment" | "standard-deviation-channel" | "quote-widget" | "text-tool" | "time-scale" | "triangle" | "union" | "vertical-line" | "wave-ruler";
+
+/**
+ * 在 shadcn Input 之上的业务封装：统一加载态、前后缀图标与右侧指示。
+ */
+export declare function ProInput({ className, wrapClassName, loading, disabled, size, preIcon, afterIcon, name, value, defaultValue, onChange, ...props }: ProInputProps): React_2.JSX.Element;
+
+export declare type ProInputProps = Omit<InputComponentProps, "disabled" | "size"> & {
+    /** 在 `ProForm` 内与其它字段一起做引擎同步；不配 `ProForm` 时无 effect */
+    name?: string;
+    /** 是否禁用。`loading` 为 `true` 时也会禁用。 */
+    disabled?: InputComponentProps["disabled"];
+    /** 是否显示右侧加载中并禁止输入（与 `disabled` 叠加）。 */
+    loading?: boolean;
+    /** 尺寸：固定宽度、高度与水平内边距。 */
+    size?: ProInputSize;
+    /** 外层包裹 div 的 className，可覆盖默认宽度等布局样式。 */
+    wrapClassName?: string;
+    /** 输入框左侧图标（如 `<ProIcon type="search" />`）。 */
+    preIcon?: React_2.ReactNode;
+    /** 输入框右侧图标；`loading` 为 `true` 时由加载指示替代。 */
+    afterIcon?: React_2.ReactNode;
+};
+
+declare type ProInputSize = keyof typeof SIZE_CONFIG;
+
+/**
+ * 全区域半透明遮罩 + 旋转加载图标，需放在 `position: relative` 的容器内使用。
+ */
+export declare function ProLoading({ size, show, className }: ProLoadingProps): JSX.Element | null;
+
+export declare type ProLoadingProps = {
+    /** 加载指示器尺寸：`small`（40px）、`normal`（64px，ProTable 默认）、`big`（96px）。 */
+    size?: ProLoadingSize;
+    /** 是否显示加载遮罩；为 `false` 时不渲染。 */
+    show?: boolean;
+    className?: string;
+};
+
+export declare type ProLoadingSize = "small" | "normal" | "big";
+
+export declare function ProMultiSelect({ options: optionsProp, value, defaultValue, onChange, placeholder, disabled, loading, className, contentClassName, clearable, maxTagCount, emptyText, size, name, appIdMap, onApiRender, allowSearch, onSearch, }: ProMultiSelectProps): React_2.JSX.Element;
+
+/** 自定义远程搜索：传入关键词，返回选项列表（支持 Promise）。 */
+export declare type ProMultiSelectOnSearch = (keyword: string) => ProMultiSelectOption[] | Promise<ProMultiSelectOption[]>;
+
+export declare type ProMultiSelectOption = {
+    label: React_2.ReactNode;
+    value: string;
+    disabled?: boolean;
+};
+
+export declare type ProMultiSelectProps = {
+    /** 未配置 `appIdMap` 时必填；配置网关后由接口填充，可省略 */
+    options?: ProMultiSelectOption[];
+    value?: string[];
+    defaultValue?: string[];
+    onChange?: (value: string[]) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    loading?: boolean;
+    className?: string;
+    contentClassName?: string;
+    clearable?: boolean;
+    maxTagCount?: number;
+    emptyText?: React_2.ReactNode;
+    /** 输入框尺寸：trigger 与已选 tag 的样式。 */
+    size?: ProSelectSize_2;
+    /** 在 `ProForm` 内写入 `proFormBridge`（字段名） */
+    name?: string;
+    /**
+     * 配置后组件内用 `execApiById` 拉取数据（与 ProSelect / RequestPro 网关 Story 一致）。
+     */
+    appIdMap?: ProSelectGwNbAppIds;
+    /**
+     * 配置了 `appIdMap` 时：`options` / `search` 接口的 `res.data` 先经此函数转换，再解析为选项。
+     */
+    onApiRender?: ProSelectOnApiRender;
+    /**
+     * 为 true 且配置了 `appIdMap` 或 `onSearch` 时：下拉顶部展示搜索框，输入关键词后远程拉取结果。
+     */
+    allowSearch?: boolean;
+    /**
+     * 自定义远程搜索函数；与 `appIdMap.search` 二选一（同时配置时优先 `appIdMap`）。
+     * 关键词防抖后调用，须返回 `{ label, value }[]`（可选 `disabled`）。
+     */
+    onSearch?: ProMultiSelectOnSearch;
+};
+
+/**
+ * 品牌面板容器：固定背景、内边距与圆角，可通过 `className` 扩展样式。
+ */
+export declare function ProPanel({ className, ...props }: ProPanelProps): React_2.JSX.Element;
+
+export declare type ProPanelProps = React_2.ComponentProps<"div">;
+
+/**
+ * 基于 shadcn `Popover` + `Calendar`（range）的范围日期选择，触发器与面板样式对齐 ProDataPicker。
+ */
+export declare function ProRangePicker({ value, defaultValue, onValueChange, onSelect, startPlaceholder, endPlaceholder, disabled, className, contentClassName, size, displayFormat, valueFormat, name, numberOfMonths, allowClear, }: ProRangePickerProps): React_2.JSX.Element;
+
+declare type ProRangePickerCalendarOnSelect = OnSelectHandler<DateRange | undefined>;
+
+export declare type ProRangePickerInput = {
+    from?: Date | string;
+    to?: Date | string;
+};
+
+export declare type ProRangePickerProps = {
+    /** 当前区间（受控），起止支持 `Date` 或按 `valueFormat` 格式化的字符串 */
+    value?: ProRangePickerInput;
+    /** 默认区间（非受控），起止支持 `Date` 或按 `valueFormat` 格式化的字符串 */
+    defaultValue?: ProRangePickerInput;
+    /**
+     * 仅在区间选满（起止均有）或清空为 `undefined` 时触发，便于对齐 antd RangePicker 的提交时机。
+     * 选择起点但未选终点过程中的临时状态只反映在面板内，不会触发此回调。
+     * 输出值按 `valueFormat` 格式化为字符串。
+     */
+    onValueChange?: (range: ProRangePickerValue | undefined) => void;
+    /** 与 `react-day-picker` `onSelect` 一致，含选择过程中的临时区间 */
+    onSelect?: ProRangePickerCalendarOnSelect;
+    startPlaceholder?: string;
+    endPlaceholder?: string;
+    disabled?: boolean;
+    className?: string;
+    contentClassName?: string;
+    size?: ProRangePickerSize;
+    displayFormat?: string;
+    /** 值输出格式（`onValueChange` / 表单快照），传给 `date-fns` 的 `format` */
+    valueFormat?: string;
+    /** 在 `ProForm` 内写入 `proFormBridge`（字段名） */
+    name?: string;
+    /** 面板内并排月份数，默认 `2`（对齐 antd RangePicker） */
+    numberOfMonths?: number;
+    /** 为 `true` 时，悬停触发器右侧显示清除按钮，点击清空已选区间 */
+    allowClear?: boolean;
+};
+
+declare type ProRangePickerSize = "small" | "normal" | "big";
+
+/** 按 `valueFormat` 格式化后的区间值 */
+export declare type ProRangePickerValue = {
+    from?: string;
+    to?: string;
+};
+
+export declare function ProResizerHandle({ withHandle, className, ...props }: ResizablePrimitive.SeparatorProps & {
+    withHandle?: boolean;
+}): JSX.Element;
+
+export declare function ProResizerPanel({ ...props }: ResizablePrimitive.PanelProps): JSX.Element;
+
+export declare function ProResizerPanelGroup({ className, ...props }: ResizablePrimitive.GroupProps): JSX.Element;
+
+export declare const ProSecondaryTabs: React_2.MemoExoticComponent<typeof ProSecondaryTabsComponent>;
+
+export declare type ProSecondaryTabsChangeHandler = (previousKey: string, currentKey: string) => void;
+
+declare function ProSecondaryTabsComponent({ items, defaultActiveKey, activeKey: activeKeyProp, includeContent, onTabsChange, className, contentClassName, }: ProSecondaryTabsProps): React_2.JSX.Element | null;
+
+export declare type ProSecondaryTabsItem = {
+    key: string;
+    name: React_2.ReactNode;
+    content: React_2.ReactNode;
+    /** 为 `true` 时不可点击，展示禁用样式。 */
+    disable?: boolean;
+};
+
+export declare type ProSecondaryTabsProps = {
+    items: ProSecondaryTabsItem[];
+    /** 非受控时的初始选中项 `key`。不传时取第一个未禁用项，否则取第一项。 */
+    defaultActiveKey?: string;
+    /** 受控选中项 `key`。 */
+    activeKey?: string;
+    /**
+     * 是否渲染 `content` 面板。
+     * @default true
+     */
+    includeContent?: boolean;
+    /** 选中 `key` 变化时触发；与 `includeContent` 无关，切换成功时调用。 */
+    onTabsChange?: ProSecondaryTabsChangeHandler;
+    className?: string;
+    /** 内容区根节点额外 className。 */
+    contentClassName?: string;
+};
+
+export declare function ProSelect({ options: optionsProp, value, defaultValue, onChange, placeholder, disabled, loading, clearable, className, contentClassName, contentStyle, popupZIndex, emptyText, size, name, appIdMap, onApiRender, allowSearch, children, allowSelectNonLeaf, }: ProSelectProps): React_2.JSX.Element;
+
+export declare namespace ProSelect {
+    var Option: typeof ProSelectOptionEl;
+}
+
+/**
+ * 网关 `execApiById` 脚本 id（调用方式与「RequestPro 网关 API」Story 一致；请求头由内部读取联调配置，非组件 props）。
+ *
+ * - `options`：挂载后请求**选项列表**；若配置了 `onApiRender`，会先对 `res.data` 做转换，否则直接使用 `res.data`；最终须能被解析为 `{ label, value }[]`（可选 `disabled`）。
+ * - `search`（可选）：仅在 `allowSearch` 为 true 且用户在触发器内输入非空关键词时请求**筛选列表**；第二参 `params` 固定为 `{ keyword: 用户输入 }`。返回数据同样会先经 `onApiRender`（若配置）。未配置 `search` 时组件会写入错误文案且搜索结果为空。
+ */
+export declare type ProSelectGwNbAppIds = {
+    options: string;
+    search?: string;
+};
+
+/**
+ * 配置了 `appIdMap` 时：`execApiById` 返回的 `res.data` 先经过此函数，返回值再按 `{ label, value }[]` 规则解析为选项（与未配置时的约定一致）。
+ * options、search 两条请求共用同一转换函数。
+ */
+declare type ProSelectOnApiRender = (data: unknown) => unknown;
+
+export declare type ProSelectOption = {
+    label: React_2.ReactNode;
+    value: string;
+    disabled?: boolean;
+    /** 配置子级后进入级联筛选模式；叶子节点为最终可选值 */
+    children?: ProSelectOption[];
+};
+
+declare function ProSelectOptionEl(_props: ProSelectOptionProps): null;
+
+declare namespace ProSelectOptionEl {
+    var displayName: string;
+}
+
+export declare type ProSelectOptionProps = {
+    value: string;
+    label: React_2.ReactNode;
+    disabled?: boolean;
+    children?: React_2.ReactNode;
+};
+
+export declare type ProSelectProps = {
+    /** 未配置 `appIdMap` 时必填；配置网关后由接口填充，可省略 */
+    options?: ProSelectOption[];
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string | undefined) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    loading?: boolean;
+    /** 为 true 时在有选中项时显示清除按钮，点击可清空选择 */
+    clearable?: boolean;
+    className?: string;
+    contentClassName?: string;
+    /** 合并到下拉 listbox 的 style；`zIndex` 可覆盖默认浮层层级 */
+    contentStyle?: React_2.CSSProperties;
+    /** 下拉层 z-index，默认 `Z_INDEX.popup` */
+    popupZIndex?: number;
+    emptyText?: React_2.ReactNode;
+    size?: ProSelectSize;
+    /** 在 `ProForm` 内写入 `proFormBridge`（字段名） */
+    name?: string;
+    /**
+     * 配置后组件内用 `execApiById` 拉取数据（与 RequestPro 网关 Story 一致）。
+     * 联调请求头由内部统一处理，非组件入参（Storybook 见该 Story 侧栏与 `getGwNbApiDevHeaders`）。
+     */
+    appIdMap?: ProSelectGwNbAppIds;
+    /**
+     * 配置了 `appIdMap` 时生效：`options` / `search` 接口的 `res.data` 先经此函数转换，返回值再解析为下拉项（须可被解析为 `{ label, value }[]`，见 `defaultGwNbMapOptions`）。
+     */
+    onApiRender?: ProSelectOnApiRender;
+    /**
+     * 为 true 且配置了 `appIdMap` 时：在触发器内直接输入关键词，自动展开下拉并调用 `appIdMap.search` 展示结果。
+     * 未配置 `allowSearch` 时触发器不可输入（纯点击选择）。
+     */
+    allowSearch?: boolean;
+    /**
+     * 以 `ProSelect.Option` 声明级联选项；配置后下拉以多列级联方式展示（与 `options` 中 `children` 字段等效，且优先于 `options`）。
+     */
+    children?: React_2.ReactNode;
+    /**
+     * 级联模式下是否允许选中非叶子节点（含 `children` 的父级）。默认 `true`；
+     * 为 `false` 时仅叶子节点可被点击选中，父级仅用于悬停展开下一列。
+     */
+    allowSelectNonLeaf?: boolean;
+};
+
+declare type ProSelectSize = "small" | "normal" | "big";
+
+declare type ProSelectSize_2 = "small" | "normal" | "big";
+
+/**
+ * 在 shadcn Sonner（`Toaster`）之上的封装：统一挂载点样式与后续扩展入口。
+ * Toast 各 type 的视觉与品牌稿一致（圆角、描边、背景、阴影、正文字号/行高、图标色）。
+ */
+export declare function ProSonner({ className, toastOptions, icons, style, richColors, ...props }: ProSonnerProps): React_2.JSX.Element;
+
+export declare type ProSonnerProps = React_2.ComponentProps<typeof Toaster>;
+
+/**
+ * 在 Radix Switch 之上的业务封装：统一 Pro 品牌外观（稿面固定 26×16 轨道 + 8×8 滑块）。
+ */
+export declare function ProSwitch({ className, children, disabled, name, checked, defaultChecked, onCheckedChange, ...props }: ProSwitchProps): React_2.JSX.Element;
+
+export declare type ProSwitchProps = Omit<SwitchComponentProps, "asChild"> & {
+    /** 可选：显示在开关右侧的文案或节点 */
+    children?: React_2.ReactNode;
+    /** 在 `ProForm` 内写入 `proFormBridge`（字段名） */
+    name?: string;
+};
+
+/**
+ * 基于 AG Grid 的数据表格：默认 Quartz 主题与 `AllCommunityModule`，其余 props 与 `AgGridReact` 一致。
+ * 列定义可使用 `align: 'left' | 'center' | 'right'`，表头与单元格同步对齐。
+ *
+ * 传入 `bridgeName` 时，在组件内调用 `useProDataBridge` 绑定 `rowData` / `loading`；可选 `bridgeInfiniteScroll` 在触底时调用 `loadNextPage`。
+ * 可选 `pagePagination` 在表格底部自动渲染页码分页条；可选 `scrollPagination` 在滚动至底部时触发 `onScrollEnd`（二者互斥）。
+ * 可选配置 `headerContextMenuItems` / `cellContextMenuItems`（非空数组）启用表头或单元格自定义右键菜单；不设则无。
+ */
+export declare function ProTable<TData = unknown>({ bridgeName, bridgeInfiniteScroll, wrapperClassName, className, modules, defaultColDef, columnDefs, rowHeight, headerHeight, noRowsOverlayComponent, enableRowSelection, tableId, onRowClicked, onSelectionChanged, onSelectedRowChange, ...gridProps }: ProTableProps<TData>): JSX.Element;
+
+declare type ProTableBridge = {
+    engine: typeof engine_2;
+    getSelectedRow: <TData = unknown>(tableId: string) => TData | undefined;
+    /**
+     * 手动设置当前选中行（如默认选中首行）。
+     * 会写入引擎快照；若对应 `tableId` 的 `ProTable` 已挂载，会同步 AG Grid 行高亮。
+     */
+    setSelectedRow: <TData = unknown>(tableId: string, row: TData | undefined) => void;
+    hasSelectedRow: (tableId: string) => boolean;
+    clearSelectedRow: (tableId: string) => void;
+    useSelectedRow: <TData = unknown>(tableId: string) => TData | undefined;
+};
+
+export declare const proTableBridge: ProTableBridge;
+
+/** 单元格右键菜单单项 */
+declare type ProTableCellContextMenuItem<TData = unknown> = {
+    label: string;
+    onClick: (event: CellContextMenuEvent<TData>) => void;
+};
+
+/** 表头右键菜单单项 */
+declare type ProTableHeaderContextMenuItem<TData = unknown> = {
+    label: string;
+    onClick: (event: ColumnHeaderContextMenuEvent<TData>) => void;
+};
+
+/** 页码分页条配置（与 {@link PagePaginationBar} 一致，由 ProTable 在底部自动渲染） */
+declare type ProTablePagePaginationConfig = PagePaginationBarProps & {
+    /** 分页条外层 className */
+    className?: string;
+};
+
+export declare type ProTableProps<TData = unknown> = Omit<AgGridReactProps<TData>, "columnDefs"> & {
+    /** 外层容器：主题、圆角、最小高度等。默认宽度 `40vw`，可用 `wrapperClassName` 覆盖 */
+    wrapperClassName?: string;
+    columnDefs?: SSColDef[];
+    /** 是否允许行选中；默认不允许 */
+    enableRowSelection?: boolean;
+    /** 开启行选中时必填：作为表格选中行在引擎中的唯一标识 */
+    tableId?: string;
+    /**
+     * 行选中变化时回调（与 `enableRowSelection` 配合使用）。
+     * 当前为单选模式：选中时为该行数据，取消选中或未选中时为 `undefined`。
+     */
+    onSelectedRowChange?: (selectedRow: TData | undefined) => void;
+    /**
+     * 与 {@link useProDataBridge} 的 `name` 一致时，在表格内订阅 bridge 数据并驱动 `rowData` / `loading`。
+     * 与 `rowData` **互斥**：同时传入会抛错（请移除 `rowData`）。
+     */
+    bridgeName?: string;
+    /**
+     * 仅在传入 `bridgeName` 时生效：纵向滚动至底部时自动调用 `loadNextPage`。
+     * 建议设置稳定的 `getRowId`；末页是否还可加载由 {@link useProDataBridge} 快照中的 `hasMore`（由 `ProDataBridge` 维护）判断。
+     */
+    bridgeInfiniteScroll?: boolean;
+    /**
+     * 表头右键菜单项；不传或传空数组则不展示自定义菜单。
+     * 每项需 `label`、`onClick`。
+     */
+    headerContextMenuItems?: ProTableHeaderContextMenuItem<TData>[];
+    /**
+     * 单元格（表体）右键菜单项；不传或传空数组则不展示自定义菜单。
+     */
+    cellContextMenuItems?: ProTableCellContextMenuItem<TData>[];
+    /**
+     * 页码分页：传入底部分页条配置后，ProTable 在表格下方自动渲染 {@link PagePaginationBar}。
+     * 与 {@link scrollPagination} 互斥；表格会关闭 AG Grid 内置分页（`pagination={false}`）。
+     */
+    pagePagination?: ProTablePagePaginationConfig;
+    /**
+     * 滚动分页：纵向滚动至底部时触发 `onScrollEnd`，并提供保持视口的 `insertData`。
+     * 与 {@link pagePagination} 互斥；建议同时设置 `getRowId` 与 `suppressScrollOnNewData`。
+     */
+    scrollPagination?: ProTableScrollPaginationConfig<TData>;
+    /**
+     * 可选：绑定 AG Grid 外层 shell（`.ss-table-shell`）的 ref，供外部控制滚动位置。
+     * 传入 `bridgeName` 时，内部仍复用同一 ref 处理 `scrollResetToken` 归零与 `bridgeInfiniteScroll` 触底判定。
+     */
+    gridShellRef?: RefObject<HTMLDivElement | null>;
+};
+
+/** 滚动分页：纵向滚动至底部时自动触发 `onScrollEnd` */
+declare type ProTableScrollPaginationConfig<TData = unknown> = {
+    /**
+     * 更新受控 `rowData`（通常即 `setRows` 的函数式更新）。
+     * ProTable 在 `insertData` 内会先记录当前滚动位置再调用此回调。
+     */
+    onRowDataChange: (updater: (prev: TData[]) => TData[]) => void;
+    /** 滚动至已加载列表底部时触发 */
+    onScrollEnd: (payload: ProTableScrollPaginationOnScrollEndPayload<TData>) => void;
+    /**
+     * 距滚动条底端的像素容差，默认 `1`。
+     * 仅当 `scrollTop + clientHeight >= scrollHeight - bottomTolerancePx` 时视为触底（肉眼滚到底）。
+     */
+    bottomTolerancePx?: number;
+    /** 为 true 时不触发 `onScrollEnd` */
+    loading?: boolean;
+    /** 为 false 时不触发，默认 true */
+    hasMore?: boolean;
+};
+
+/** 滚动分页：`onScrollEnd` 触发时由 ProTable 注入的 `insertData`（更新 rowData 并保持视口） */
+declare type ProTableScrollPaginationOnScrollEndPayload<TData = unknown> = {
+    api: GridApi<TData>;
+    insertData: (updater: (prev: TData[]) => TData[]) => void;
+};
+
+/**
+ * 基于 shadcn `Tabs`（Radix）的 Pro 封装：列表与触发器使用品牌色与稿面字体。
+ */
+export declare function ProTabs({ className, width, style, contentClassName, ...props }: ProTabsProps): React_2.JSX.Element;
+
+export declare function ProTabsContent({ className, style, ...props }: React_2.ComponentProps<typeof TabsContent>): React_2.JSX.Element;
+
+export declare function ProTabsList({ className, variant, size, tabHeaderStart, tabHeaderEnd, tabHeaderFill, triggerMinWidth, triggerMaxWidth, ...props }: ProTabsListProps): React_2.JSX.Element;
+
+export declare type ProTabsListProps = React_2.ComponentProps<typeof TabsList> & {
+    /**
+     * 标签触发器尺寸：`normal` 内容区 16px 高，`big` 为 24px；均为上下 4px padding。
+     * @default "normal"
+     */
+    size?: ProTabsSize;
+    /**
+     * 标签栏 **左侧** 自定义区域（如工具按钮）。与 `tabHeaderEnd` 二选一或同时使用均可。
+     * 传入后，整行包在 `w-full` 容器内，`variant="default"` 时 **底部分隔线** 会横跨 `ProTabs` 全宽（标签触发器本身仍随文案或 `tabHeaderFill` 规则，不会被这条线「撑开」成均分）。
+     */
+    tabHeaderStart?: React_2.ReactNode;
+    /**
+     * 标签栏 **最右侧** 自定义区域。传入后同上：仅 **border-bottom** 铺满全宽，而非 `tabHeaderFill` 那种对触发器宽度的铺满。
+     */
+    tabHeaderEnd?: React_2.ReactNode;
+    /**
+     * 为 `true` 时标签栏横向 **铺满** `ProTabs` 根宽度，各 `ProTabsTrigger` **均分**宽度（文案仍居中；过长配合 `triggerMaxWidth` 省略）。
+     * 为 `false` 时标签宽度随文案，列表为 `w-fit`。
+     * @default false
+     */
+    tabHeaderFill?: boolean;
+    /**
+     * 单个标签触发器的最小宽度。不传则由内容自适应。
+     * `number` 视为 px；也可传 CSS 长度字符串。
+     */
+    triggerMinWidth?: ProTabsTriggerWidth;
+    /**
+     * 单个标签触发器的最大宽度；超出部分单行省略号展示。
+     * `number` 视为 px；也可传 CSS 长度字符串。
+     */
+    triggerMaxWidth?: ProTabsTriggerWidth;
+};
+
+export declare type ProTabsProps = React_2.ComponentProps<typeof Tabs> & {
+    /**
+     * **整个 Tabs**（标签栏 + 面板）的宽度。`number` 为 px；`string` 为任意 CSS 长度（如 `"32rem"`、`"100%"`）。
+     * 不传时由外层布局或 `className` 决定。
+     */
+    width?: ProTabsTriggerWidth;
+    /**
+     * 统一加在每个 `ProTabsContent` 根上的 `className`（如 padding、边框、背景），内部子节点只写各自差异即可。
+     */
+    contentClassName?: string;
+};
+
+/** `normal`：内容区 16px 高；`big`：24px。两种尺寸触发器均为上下各 4px 内边距（总高 24px / 32px）。 */
+export declare type ProTabsSize = "normal" | "big";
+
+export declare function ProTabsTrigger({ className, style, children, ...props }: React_2.ComponentProps<typeof TabsTrigger>): React_2.JSX.Element;
+
+export declare type ProTabsTriggerLayout = {
+    minWidth?: ProTabsTriggerWidth;
+    maxWidth?: ProTabsTriggerWidth;
+};
+
+/** `number` 按 px 写入样式；`string` 作为 CSS 长度原样使用（如 `"12rem"`）。 */
+export declare type ProTabsTriggerWidth = number | string;
+
+/**
+ * 机构 / 市场等业务标签：按 `type` 映射品牌色，支持 `primary` / `small` 两种尺寸。
+ */
+export declare function ProTag({ type, size, className, children, ...props }: ProTagProps): React_2.JSX.Element;
+
+export declare type ProTagProps = Omit<React_2.ComponentProps<"span">, "children"> & {
+    /** 标签类型，决定底色 / 描边与文案色 */
+    type: ProTagType;
+    /** 尺寸，默认 `primary` */
+    size?: ProTagSize;
+    /** 自定义文案；未传时展示 `type` 本身 */
+    children?: React_2.ReactNode;
+};
+
+/** `primary` 高 18px；`small` 高 14px、无内边距 */
+export declare type ProTagSize = "primary" | "small";
+
+export declare type ProTagType = (typeof PRO_TAG_TYPES)[number];
+
+/**
+ * 品牌时间轴：支持预设/自定义节点样式、title/content 双侧文案，以及左右翻转布局。
+ */
+export declare function ProTimeline({ items, reversed, titleWidth, className, ...props }: ProTimelineProps): React_2.JSX.Element;
+
+export declare type ProTimelineNode = {
+    key?: React_2.Key;
+    title?: React_2.ReactNode;
+    content?: React_2.ReactNode;
+    /** 预设节点样式；未指定时使用 default */
+    variant?: ProTimelineNodeVariant;
+    /** 自定义圆点图标，渲染区域 12×12；传入后优先于 variant 预设图标 */
+    icon?: React_2.ReactNode;
+    /** 覆盖组件级 titleWidth，仅作用于当前节点 */
+    titleWidth?: number | string;
+    /** link 节点跳转地址；配置后 content 可点击跳转 */
+    url?: string;
+    /** link 节点 `<a>` 的 target，默认 `_self` */
+    urlTarget?: React_2.HTMLAttributeAnchorTarget;
+};
+
+export declare type ProTimelineNodeVariant = "default" | "new" | "highlight" | "important" | "link";
+
+export declare type ProTimelineProps = React_2.ComponentProps<"div"> & {
+    items: ProTimelineNode[];
+    /** 左右翻转：时间轴右对齐，title 与 content 位置对调（样式不变） */
+    reversed?: boolean;
+    /** title 区域宽度，默认 48px */
+    titleWidth?: number | string;
+};
+
+/**
+ * shadcn `Tooltip` 薄封装：仅将气泡背景、描边固定为品牌变量。
+ */
+export declare function ProTooltip({ children, content, triggerMode, delayDuration, open, onOpenChange, side, showArrow, sideOffset, className, ...contentProps }: ProTooltipProps): React_2.JSX.Element;
+
+export declare type ProTooltipProps = {
+    children: React_2.ReactNode;
+    content: React_2.ReactNode;
+    /**
+     * `hover`：悬停/聚焦打开（默认）。
+     * `click`：仅通过点击触发器切换开关；受控时 Radix 因悬停/聚焦触发的 `onOpenChange(true)` 会被忽略。
+     */
+    triggerMode?: ProTooltipTriggerMode;
+    /**
+     * 气泡位置。支持四边与四角（及侧边上下角）。
+     * 未指定时默认 `bottom-right`（右下角）。
+     */
+    side?: ProTooltipSide;
+    /** 是否显示箭头，默认 `true` */
+    showArrow?: boolean;
+    /**
+     * 气泡与触发器之间的间距（px），对应 Radix `sideOffset`。
+     * 默认 `10`。
+     */
+    sideOffset?: number;
+} & TooltipRootProps & Omit<React_2.ComponentProps<typeof TooltipContent>, "children" | "bgColor" | "borderColor" | "showArrow" | "side" | "align" | "sideOffset">;
+
+/** 气泡相对触发器的位置；四角由 side + align 组合实现。默认 `bottom-right`。 */
+export declare type ProTooltipSide = "top" | "top-left" | "top-right" | "right" | "right-top" | "right-bottom" | "bottom" | "bottom-left" | "bottom-right" | "left" | "left-top" | "left-bottom";
+
+export declare type ProTooltipTriggerMode = "hover" | "click";
+
+/**
+ * 穿梭框：交互对齐 Ant Design Transfer，基于 shadcn Checkbox / Input / Button 封装。
+ */
+export declare function ProTransfer({ dataSource, targetKeys, defaultTargetKeys, selectedKeys, defaultSelectedKeys, onChange, onSelectChange, titles, operations, showSearch, filterOption, disabled, oneWay, listStyle, render, footer, locale, className, style, name, }: ProTransferProps): React_2.JSX.Element;
+
+export declare type ProTransferDirection = "left" | "right";
+
+export declare type ProTransferItem = {
+    key: string;
+    title: React_2.ReactNode;
+    disabled?: boolean;
+};
+
+export declare type ProTransferLocale = {
+    itemUnit?: string;
+    itemsUnit?: string;
+    searchPlaceholder?: string;
+    notFoundContent?: React_2.ReactNode;
+};
+
+export declare type ProTransferProps = {
+    /** 数据源 */
+    dataSource: ProTransferItem[];
+    /** 右侧列表 key（受控） */
+    targetKeys?: string[];
+    /** 右侧列表 key（非受控初始值） */
+    defaultTargetKeys?: string[];
+    /** 两侧已勾选项 key（受控） */
+    selectedKeys?: string[];
+    /** 两侧已勾选项 key（非受控初始值） */
+    defaultSelectedKeys?: string[];
+    /** 目标列表变化 */
+    onChange?: (targetKeys: string[], direction: ProTransferDirection, moveKeys: string[]) => void;
+    /** 勾选变化：左列已选、右列已选 */
+    onSelectChange?: (sourceSelectedKeys: string[], targetSelectedKeys: string[]) => void;
+    /** 左右列表标题 */
+    titles?: [React_2.ReactNode, React_2.ReactNode];
+    /** 中间操作按钮文案（右移、左移） */
+    operations?: [string, string];
+    /** 是否显示搜索 */
+    showSearch?: boolean;
+    /** 自定义过滤；默认按 title 文本包含匹配 */
+    filterOption?: (inputValue: string, item: ProTransferItem) => boolean;
+    /** 禁用整个穿梭框 */
+    disabled?: boolean;
+    /** 单向模式：仅允许从左到右 */
+    oneWay?: boolean;
+    /** 列表容器样式（左右共用） */
+    listStyle?: React_2.CSSProperties;
+    /** 自定义列表项渲染 */
+    render?: (item: ProTransferItem) => React_2.ReactNode;
+    /** 列表底部 */
+    footer?: (props: {
+        direction: ProTransferDirection;
+    }) => React_2.ReactNode;
+    locale?: ProTransferLocale;
+    className?: string;
+    style?: React_2.CSSProperties;
+    /** 在 `ProForm` 内写入 `proFormBridge`（字段值为 targetKeys） */
+    name?: string;
+};
+
+/**
+ * 基于 shadcn 设计体系的树形组件：支持展开/选中、多选勾选与品牌样式。
+ */
+export declare function ProTree({ treeData, showIcon, defaultNodeIcons, multiple, defaultExpandAll, expandedKeys: expandedKeysProp, defaultExpandedKeys, onExpand, selectedKeys: selectedKeysProp, defaultSelectedKeys, onSelect, checkedKeys: checkedKeysProp, defaultCheckedKeys, onCheck, switcherIcon, width, loadData, className, style, ...props }: ProTreeProps): React_2.JSX.Element;
+
+export declare type ProTreeCheckInfo = {
+    node: ProTreeNodeData;
+    checked: boolean;
+    checkedKeys: string[];
+};
+
+export declare type ProTreeContextMenuEvent = {
+    node: ProTreeNodeData;
+    nativeEvent: MouseEvent;
+};
+
+export declare type ProTreeContextMenuItem = {
+    /** 菜单项名称 */
+    name: string;
+    /** 点击回调 */
+    onClick: (event: ProTreeContextMenuEvent) => void;
+};
+
+/** `ProTree` 默认节点图标；字段为 `null` 时该类型节点不显示图标 */
+export declare type ProTreeDefaultNodeIcons = {
+    /** 非叶子节点折叠态 */
+    folder?: React_2.ReactNode | null;
+    /** 非叶子节点展开态 */
+    folderOpen?: React_2.ReactNode | null;
+    /** 叶子节点 */
+    leaf?: React_2.ReactNode | null;
+};
+
+export declare type ProTreeExpandInfo = {
+    node: ProTreeNodeData;
+    expanded: boolean;
+    expandedKeys: string[];
+};
+
+export declare type ProTreeNodeData = {
+    /** 节点唯一标识 */
+    key: string;
+    /** 节点标题 */
+    title: React_2.ReactNode;
+    /** 子节点 */
+    children?: ProTreeNodeData[];
+    /**
+     * 是否为叶子节点；未配置时根据 `children` 推断（无子节点或 `children` 为空则为叶子）。
+     * 显式设为 `false` 时，即使无子节点或 `children` 为空，也按非叶子节点展示（显示展开图标等）。
+     */
+    isLeaf?: boolean;
+    /** 自定义图标（组件形式，如 `<ProIcon type="folder" />`）；`null` 表示不显示；优先级高于 `ProTree` 默认图标 */
+    icon?: React_2.ReactNode | null;
+    /** 禁用后不可选中、不可勾选 */
+    disabled?: boolean;
+    /** 节点右键菜单项 */
+    contextMenu?: ProTreeContextMenuItem[];
+    /** 为 true 时，悬停节点后在右侧显示更多按钮；`contextMenu` 右键始终可用 */
+    showContextMenuIcon?: boolean;
+    /**
+     * 展开/折叠图标样式；未配置时继承 `ProTree` 的 `switcherIcon`，均为 `arrow`。
+     * 节点级配置优先级高于 `ProTree`。
+     */
+    switcherIcon?: ProTreeSwitcherIconMode;
+};
+
+export declare type ProTreeProps = Omit<React_2.HTMLAttributes<HTMLDivElement>, "onSelect"> & {
+    /** 树形数据 */
+    treeData: ProTreeNodeData[];
+    /** 是否显示节点图标；也可通过 `defaultNodeIcons` 配置默认图标 */
+    showIcon?: boolean;
+    /**
+     * 默认节点图标（非叶子折叠/展开、叶子）；字段为 `null` 时不显示对应类型图标。
+     * 节点 `icon` 优先级更高。
+     */
+    defaultNodeIcons?: ProTreeDefaultNodeIcons;
+    /**
+     * 是否可多选；开启后展示勾选框，点击节点或勾选框均可切换选中/勾选状态。
+     * 节点 `disabled` 时该节点不可勾选。
+     */
+    multiple?: boolean;
+    /** 是否默认展开全部父节点 */
+    defaultExpandAll?: boolean;
+    /** 受控：展开的 key */
+    expandedKeys?: string[];
+    /** 非受控：默认展开的 key */
+    defaultExpandedKeys?: string[];
+    onExpand?: (expandedKeys: string[], info: ProTreeExpandInfo) => void;
+    /** 受控：选中的 key */
+    selectedKeys?: string[];
+    /** 非受控：默认选中的 key */
+    defaultSelectedKeys?: string[];
+    onSelect?: (selectedKeys: string[], info: ProTreeSelectInfo) => void;
+    /** 受控：勾选的 key */
+    checkedKeys?: string[];
+    /** 非受控：默认勾选的 key */
+    defaultCheckedKeys?: string[];
+    onCheck?: (checkedKeys: string[], info: ProTreeCheckInfo) => void;
+    /**
+     * 展开/折叠图标样式：`arrow` 箭头（默认）、`button` 方框加减。
+     * 节点级 `switcherIcon` 可覆盖此配置。
+     */
+    switcherIcon?: ProTreeSwitcherIconMode;
+    /**
+     * 树容器固定宽度；`number` 为 px，`string` 为任意 CSS 长度。
+     * 过长标题在节点内省略显示，不会撑开整棵树。
+     * @default 248
+     */
+    width?: number | string;
+    /**
+     * 异步加载子节点：展开尚未加载的非叶子节点时触发。
+     * 返回子节点数组时由组件内部合并；返回 `void` 时由外部更新 `treeData`。
+     */
+    loadData?: (node: ProTreeNodeData) => Promise<ProTreeNodeData[] | void>;
+};
+
+export declare type ProTreeSelectInfo = {
+    node: ProTreeNodeData;
+    selected: boolean;
+    selectedKeys: string[];
+};
+
+export declare type ProTreeSwitcherIconMode = "arrow" | "button";
+
+export declare function readProEChartsThemeTokens(root: HTMLElement | null): ProEChartsThemeTokens;
+
+/** 将联调项写入 localStorage（由侧栏「保存」调用）。 */
+export declare function saveStorybookGwNbDevFields(fields: StorybookGwNbDevFields): void;
+
+/** SDP 脚本执行路径前缀（相对 `GW_NB_GATEWAY_BASE`） */
+export declare const SDP_EXEC_API_PREFIX = "sdep-gateway-api/api/exec/";
+
+export declare interface SdpExecBody {
+    params?: Record<string, unknown>;
+    pageSize?: number;
+    pageNum?: number;
+}
+
+/**
+ * DEP 网关脚本执行响应外壳。`data` 为泛型业务体，结构由具体脚本决定（类型层面为黑盒）。
+ */
+export declare interface SdpGatewayResponse<T = unknown> {
+    status: string;
+    message: string;
+    error: unknown;
+    data: T;
+}
+
+/**
+ * 判断点击/焦点是否落在「不应触发当前 Dialog dismiss」的嵌套弹层上。
+ * 覆盖 Pro 浮层（`data-pro-popup`）与其它 Dialog 的 content / overlay。
+ */
+export declare function shouldPreventDialogDismiss(target: EventTarget | null, currentContent: HTMLElement | null): boolean;
+
+/** 是否走 QA 网关完整地址：IP 访问、localhost、hostname 含 qa、或一级路径段包含 qa */
+export declare function shouldUseQaGatewayBase(hostname: string, pathname: string): boolean;
+
+declare const SIZE_CONFIG: {
+    readonly small: {
+        readonly wrapper: "w-[148px] gap-1";
+        readonly input: string;
+        readonly preIconPad: "pl-6";
+        readonly afterIconPad: "pr-6";
+        readonly loadingPad: "pr-6";
+        readonly preIconWrap: "left-1";
+        readonly afterIconWrap: "right-1.5";
+        readonly icon: "size-3";
+    };
+    readonly normal: {
+        readonly wrapper: "w-[207px] gap-1";
+        readonly input: string;
+        readonly preIconPad: "pl-7";
+        readonly afterIconPad: "pr-9";
+        readonly loadingPad: "pr-9";
+        readonly preIconWrap: "left-2";
+        readonly afterIconWrap: "right-2.5";
+        readonly icon: "size-4";
+    };
+    readonly large: {
+        readonly wrapper: "w-[207px] gap-1";
+        readonly input: string;
+        readonly preIconPad: "pl-8";
+        readonly afterIconPad: "pr-9";
+        readonly loadingPad: "pr-9";
+        readonly preIconWrap: "left-2";
+        readonly afterIconWrap: "right-2.5";
+        readonly icon: "size-4";
+    };
+};
+
+/** `ColDef` 增加 `align`；不与行泛型绑定，便于与 `ColDef` 任意列定义互用 */
+declare type SSColDef = ColDef & {
+    align?: SSColumnAlign;
+};
+
+/** 列水平对齐：`align` 同时作用于表头与单元格（内部映射为品牌样式类） */
+declare type SSColumnAlign = "left" | "center" | "right";
+
+/**
+ * Storybook 网关联调头：全部由用户在预览侧栏配置并保存到 localStorage，
+ * 请求前通过 {@link getGwNbApiDevHeaders} 读取。
+ */
+export declare const STORYBOOK_GW_NB_DEV_LOCAL_STORAGE_KEY = "storybook:gw-nb-dev";
+
+export declare type StorybookGwNbDevFields = {
+    userId: string;
+    cookies: string;
+    traceId: string;
+};
+
+declare type SwitchComponentProps = React_2.ComponentProps<typeof Switch.Root>;
+
+declare function Tabs({ className, orientation, ...props }: React_2.ComponentProps<typeof Tabs_2.Root>): React_2.JSX.Element;
+
+declare function TabsContent({ className, ...props }: React_2.ComponentProps<typeof Tabs_2.Content>): React_2.JSX.Element;
+
+declare function TabsList({ className, variant, ...props }: React_2.ComponentProps<typeof Tabs_2.List> & VariantProps<typeof tabsListVariants>): React_2.JSX.Element;
+
+export declare const tabsListVariants: (props?: ({
+    variant?: "default" | "line" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+declare function TabsTrigger({ className, ...props }: React_2.ComponentProps<typeof Tabs_2.Trigger>): React_2.JSX.Element;
+
+export { toast }
+
+/**
+ * shadcn/ui 风格的 Sonner 挂载点：与设计令牌（popover、border、radius）对齐。
+ * 主题请通过 `theme` 传入，或与根节点 `.dark` 类配合使用 `theme="system"`。
+ * 默认位置为顶部居中（Sonner 库默认为右下角）。
+ * 默认展示关闭按钮，支持手动点击关闭单条 toast。
+ */
+declare function Toaster({ className, theme, position, closeButton, portalContainer, ...props }: ToasterWithPortalProps): React_2.ReactPortal | null;
+
+export { ToasterProps }
+
+declare type ToasterWithPortalProps = ToasterProps & {
+    /**
+     * 传送门挂载节点；默认 `document.body`。
+     * Sonner 自带的 `Toaster` 不会 portal，在 Storybook 等局部容器内会贴在画布内，故默认挂到 body。
+     */
+    portalContainer?: HTMLElement | DocumentFragment | null;
+};
+
+declare function Tooltip({ ...props }: React_2.ComponentProps<typeof Tooltip_2.Root>): React_2.JSX.Element;
+
+declare const TooltipContent: React_2.ForwardRefExoticComponent<Omit<TooltipContentProps, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+declare type TooltipContentProps = React_2.ComponentProps<typeof Tooltip_2.Content> & {
+    bgColor: string;
+    borderColor: string;
+    borderWidth?: number;
+    showArrow?: boolean;
+};
+
+declare type TooltipRootProps = Pick<React_2.ComponentProps<typeof Tooltip>, "delayDuration" | "open" | "onOpenChange">;
+
+/**
+ * 按 {@link ProDataBridge} 的 `name` 订阅网关返回的数据及加载态。
+ * `refetch` 会触发当前已挂载的同名 Bridge 的发请求逻辑（`action="manual"` 时常用）。
+ */
+export declare function useProDataBridge(name: string): ProDataBridgeEntry & {
+    refetch: (params?: ProDataBridgeCallParams) => Promise<void>;
+    loadNextPage: (params?: ProDataBridgeCallParams) => Promise<void>;
+    loadPage: (pageNum: number, params?: ProDataBridgeCallParams) => Promise<void>;
+    setData: (data: unknown) => void;
+};
+
+/**
+ * 控制同名 {@link ProDataBridge} 的前置校验开关（仅当 Bridge 配置了 `preflightCheck` 且 `action="auto"` 时生效）。
+ * 未通过时，该 Bridge 的自动请求与 `refetch` / `loadNextPage` / `loadPage` 均会被拦截。
+ */
+export declare function useProDataBridgePreflight(name: string): {
+    preflightRequired: boolean;
+    preflightPassed: boolean;
+    setPreflightPassed: (passed: boolean) => void;
+};
+
+export declare function useProECharts(options?: UseProEChartsOptions): UseProEChartsResult;
+
+export declare interface UseProEChartsOptions {
+    /**
+     * 读取 `--chart-*`、`--foreground` 等 CSS 变量的根节点。
+     * 默认 `document.documentElement`（与 Storybook `data-brand-theme` / `.dark` 同步方式一致）。
+     * 若图表放在局部主题容器内，可传入该容器的 ref.current。
+     */
+    tokenRoot?: HTMLElement | null;
+}
+
+export declare interface UseProEChartsResult extends ProEChartsThemePartials {
+    /**
+     * 合并公共主题与自定义 `option`（见 `mergeProEChartsOption`）。
+     * 若 `partial.legend` 存在，会按当前主题的 `scrollLegendChrome` 与 series 类型补全 icon、尺寸等（业务侧按 ECharts 官方 `legend` 写法即可）。
+     */
+    mergeOption: (partial: EChartsOption) => EChartsOption;
+}
+
+export declare function useProFormContext(): ProFormContextValue | null;
+
+/**
+ * 在 `ProForm` 内与 `name` 同时存在时，将字段与 `proFormBridge` 同步；
+ * 否则对组件行为无影响（仍走各自受控/非受控逻辑）。
+ */
+export declare function useProFormFieldSync<V>(name: string | undefined, options: {
+    value: V | undefined;
+    defaultValue: V | undefined;
+    onChange?: (next: V) => void;
+}): ProFormFieldSync<V>;
+
+export declare function useProPopupContainerRef(): React_2.RefObject<HTMLElement | null> | null;
+
+export { Z_INDEX }
+
+declare type ZustandEngine<T extends Record<string, unknown>> = {
+    /** 底层 store，形状为 `{ snapshot: T }` */
+    store: StoreApi<ZustandEngineState<T>>;
+    /** Read：读取全部 */
+    getAll: () => T;
+    /** Read：按键读取 */
+    get: <K extends keyof T>(key: K) => T[K];
+    /** Create / Update：写入单键（对象合并语义） */
+    set: <K extends keyof T>(key: K, value: T[K]) => void;
+    /** Create：与 `set` 相同，强调新增键场景 */
+    create: <K extends keyof T>(key: K, value: T[K]) => void;
+    /** Update：批量部分更新 */
+    patch: (partial: Partial<T>) => void;
+    /** Delete：从快照中移除键（注意：若 T 为固定形状，运行后类型可能宽于 T） */
+    remove: (key: keyof T) => void;
+    /** 同 `remove` */
+    delete: (key: keyof T) => void;
+    /** Reset：不传 key 则整体恢复初始快照；传 key 则只恢复该键 */
+    reset: (key?: keyof T) => void;
+    has: (key: keyof T) => boolean;
+    subscribe: (listener: (snapshot: T, prev: T) => void) => () => void;
+    /** React：订阅完整快照 */
+    useSnapshot: () => T;
+    /** React：只订阅某一键，减少重渲染 */
+    useKey: <K extends keyof T>(key: K) => T[K];
+    /** React：自定义 selector */
+    useSelect: <R>(selector: (snapshot: T) => R) => R;
+};
+
+/** 引擎内部 Zustand 状态：仅暴露扁平快照，便于 selector */
+declare type ZustandEngineState<T extends Record<string, unknown>> = {
+    snapshot: T;
+};
+
+export { }
+
+
+declare namespace ProSelectOptionEl {
+    var displayName: string;
+}