@pisell/materials 6.11.204 → 6.11.205

package/lib/components/pisellFloorMapLayout/hooks/useDraftConfigHistory.d.ts

@@ -0,0 +1,18 @@
+export interface DraftHistoryCommitOptions {
+    /** 同一 groupId 在合并窗口内连续提交将合并为一条历史 */
+    groupId?: string;
+    /** 合并窗口（毫秒），默认 600 */
+    mergeWindowMs?: number;
+}
+export interface DraftHistory<T> {
+    present: T | null;
+    /** 写入并入栈（按 group/time 自动合并） */
+    commit: (next: T | null | ((prev: T | null) => T | null), options?: DraftHistoryCommitOptions) => void;
+    /** 重置（不入栈），清空历史；用于上游 props 同步 */
+    replace: (next: T | null) => void;
+    undo: () => void;
+    redo: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
+}
+export declare function useDraftConfigHistory<T>(): DraftHistory<T>;

package/lib/components/pisellFloorMapLayout/hooks/useFloorMapPaletteTouchDrag.d.ts

@@ -0,0 +1,21 @@
+import type { MutableRefObject, PointerEvent as ReactPointerEvent } from 'react';
+import type { FloorMapPaletteDragPayload } from '../utils/floorMapDropUtils';
+export interface UseFloorMapPaletteTouchDragParams {
+    enabled: boolean;
+    mapDropLayerRef: MutableRefObject<HTMLDivElement | null>;
+    contentWidth: number;
+    contentHeight: number;
+    contentOffsetRef: MutableRefObject<{
+        x: number;
+        y: number;
+    }>;
+    setMapPaletteDragActive: (v: boolean) => void;
+    onDropInScene: (payload: FloorMapPaletteDragPayload, sceneX: number, sceneY: number) => void;
+}
+export interface UseFloorMapPaletteTouchDragResult {
+    /** 挂在图元预览按钮上；mouse 不处理，交给 HTML5 DnD */
+    handlePaletteCardPointerDown: (payload: FloorMapPaletteDragPayload, e: ReactPointerEvent<HTMLElement>) => void;
+    /** 图元按钮 onClick 前检查：触摸拖放过则吞掉本次点击 */
+    consumeToolbarClickIfTouchDrag: () => boolean;
+}
+export declare function useFloorMapPaletteTouchDrag(params: UseFloorMapPaletteTouchDragParams): UseFloorMapPaletteTouchDragResult;

package/lib/components/pisellFloorMapLayout/utils/alignSnap.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 拖动/缩放图元时的「边缘对齐吸附」：对照其他图元的 6 条候选线
+ * （左/中/右 + 上/中/下），如果当前 rect 的对应边距离它们小于
+ * 阈值（内容坐标），就把 rect 平移到精确贴合，并返回参考辅助线，
+ * 供画布上渲染红色对齐线。
+ *
+ * 阈值应保持小（典型 4~8 px / scale），避免吞掉正常拖动手感。
+ */
+export interface AlignSnapRect {
+    /** 用于排除自身。可为 undefined 表示参与对齐的"其他" rect */
+    id?: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export declare type AlignGuideEdgeX = 'left' | 'centerX' | 'right';
+export declare type AlignGuideEdgeY = 'top' | 'centerY' | 'bottom';
+export interface AlignGuide {
+    orientation: 'v' | 'h';
+    /** 该参考线所在坐标（v: x；h: y） */
+    position: number;
+    /** 沿参考线方向的覆盖范围 [min, max]，便于 SVG 渲染端到端 */
+    start: number;
+    end: number;
+    /** 命中的当前 rect 边 */
+    selfEdge: AlignGuideEdgeX | AlignGuideEdgeY;
+    /** 命中的对方 rect 边 */
+    otherEdge: AlignGuideEdgeX | AlignGuideEdgeY;
+    /** 命中的对方 rect id（如果有） */
+    otherId?: string;
+}
+export interface AlignSnapResult {
+    rect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    guides: AlignGuide[];
+}
+/** 拖动模式：x/y 两轴可独立平移；不改尺寸 */
+export interface AlignSnapDragOptions {
+    mode: 'drag';
+    threshold: number;
+}
+/** 缩放模式：根据 handle 决定 left/right/top/bottom 哪条边可动 */
+export interface AlignSnapResizeOptions {
+    mode: 'resize';
+    threshold: number;
+    /** 哪些边在当前缩放手柄下「可动」 */
+    movableEdgesX?: ('left' | 'right')[];
+    movableEdgesY?: ('top' | 'bottom')[];
+}
+export declare type AlignSnapOptions = AlignSnapDragOptions | AlignSnapResizeOptions;
+/**
+ * 对一个 rect 做边对齐吸附。返回 snap 后的 rect + 实际命中的辅助线（0~2 条）。
+ *
+ * 算法：对 x、y 轴独立处理；每轴在所有「自身 3 边 × 所有 other 3 边」组合
+ * 中选距离最小且 < threshold 的一对，把自身整体平移让它们贴齐；同时记录
+ * 所有「平移后仍精确贴齐」的参考线（可能不止 1 条，例如 left 和 centerX
+ * 同时与他人对齐时只有 1 条平移量但 2 条 guide）。
+ */
+export declare function snapRectToOthers(rect: AlignSnapRect, others: AlignSnapRect[], options: AlignSnapOptions): AlignSnapResult;

package/lib/components/pisellFloorMapLayout/utils/floorMapBuiltinShapes.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 内置图形图元（`floorMapBuiltinShape`）的预设清单。
+ *
+ * 每个预设：
+ * - `key`：持久化在 `sceneElement.builtinShapeKey`，跨语言稳定；
+ * - `labelKey`：展示名 i18n key（在 `locales.ts` / `-ja` / `-pt` 中维护）；
+ * - `defaultSize`：调色板落点 / 切换 kind 时的初始像素尺寸，比例与下文 viewBox 一致；
+ * - `render(props)`：内置 SVG 图形（统一 `preserveAspectRatio="xMidYMid meet"`，
+ *   按 viewBox 自然比例缩放并居中，容器尺寸变化时不会被拉伸变形）。
+ *
+ * 不引入图片资源 / 字体图标，全部 inline SVG，避免额外构建依赖与请求。
+ */
+import React from 'react';
+/** 内置图形渲染函数共享 props（容器已限定 100% 宽高） */
+export interface FloorMapBuiltinShapeRenderProps {
+    /** 主体填充色（壳层为浅灰），允许通过 sceneElement.fillColor 覆盖 */
+    fillColor?: string;
+    /** 描边色，允许通过 sceneElement.strokeColor 覆盖 */
+    strokeColor?: string;
+}
+export interface FloorMapBuiltinShapeDef {
+    key: string;
+    /** i18n 文案 key（在 locales.ts 中维护中英繁日葡） */
+    labelKey: string;
+    /** 调色板落点时的默认像素尺寸；比例与 viewBox 对齐，避免落点后立刻变形 */
+    defaultSize: {
+        width: number;
+        height: number;
+    };
+    /** 内置 SVG 渲染（按 viewBox 比例缩放，容器变化时居中保比例） */
+    render: (props: FloorMapBuiltinShapeRenderProps) => React.ReactElement;
+    /**
+     * 是否随容器宽高自动切换横/竖方向。
+     * - `true`：容器高 > 宽时，wrapper 自动给整张图形 rotate 90deg，让图形在画
+     *   布上看起来始终「贴墙 / 贴边」。比追加一个 `*-vertical` key 更直观，
+     *   也不需要持久化方向，纯几何 fit。
+     * - 默认 `false`（厕所 / 柱子 / 分隔等无方向语义或自带 stretch 策略的图形）。
+     */
+    orientationAware?: boolean;
+}
+/** 默认主色 / 描边色：偏中性灰，与地面其它图元（房间 / 桌位）调性一致 */
+declare const DEFAULT_FILL = "#f1f3f5";
+declare const DEFAULT_STROKE = "#6b7280";
+/**
+ * 内置图形预设清单（顺序即调色板 / 编辑面板下拉的展示顺序）。
+ * `defaultSize` 比例严格跟随对应 SVG 的 viewBox：
+ * - 厕所 / 柱子 / 大门：正方形（viewBox 100×100）
+ * - 分隔：viewBox 100×100，但渲染层用 `preserveAspectRatio="none"`，
+ *   `defaultSize` 给个常用的瘦高比例（32×160）作为「默认竖分隔」落点，
+ *   用户可直接拖宽变横分隔，不需要换 key。
+ * - 沙发：2:1 水平（viewBox 200×100）
+ *
+ * 新增预设：在此追加一项即可，编辑面板 / 调色板 / fallback 渲染会自动适配。
+ */
+export declare const FLOOR_MAP_BUILTIN_SHAPES: FloorMapBuiltinShapeDef[];
+/** 通过 key 查找预设，未命中返回 undefined（让上层显示「未选择」占位） */
+export declare function getFloorMapBuiltinShapeDef(key: string | undefined): FloorMapBuiltinShapeDef | undefined;
+export { DEFAULT_FILL as FLOOR_MAP_BUILTIN_SHAPE_DEFAULT_FILL };
+export { DEFAULT_STROKE as FLOOR_MAP_BUILTIN_SHAPE_DEFAULT_STROKE };

package/lib/components/pisellFloorMapLayout/utils/floorMapDropUtils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 平面图编辑态：侧栏图元拖拽到画布的 DataTransfer 与坐标
+ */
+/** 与 setData 一致，用于识别左侧图元栏发起的拖拽 */
+export declare const FLOOR_MAP_PALETTE_DRAG_MIME = "application/x-pisell-floor-map-element";
+export interface FloorMapPaletteDragPayload {
+    elementKind: string;
+    dataSourceKey?: string;
+    recordId?: string;
+    recordIds?: string[];
+    /**
+     * 内置图形 kind 拖拽时，侧栏预选的图形 key（{@link FLOOR_MAP_BUILTIN_SHAPES}）；
+     * 落点会以此为初始 `sceneElement.builtinShapeKey` 与默认像素尺寸。
+     * 其它 kind 不读取此字段。
+     */
+    builtinShapeKey?: string;
+}
+/**
+ * 与 {@link useFloorMapEditState} 落点一致：内容区 drop 的 offset 减去内容区 padding 偏移
+ */
+export declare function sceneXYFromContentDropOffset(offsetX: number, offsetY: number, contentOffset: {
+    x: number;
+    y: number;
+}): {
+    x: number;
+    y: number;
+};
+/** 是否为左侧图元栏拖拽（非本地文件 / 外链图片） */
+export declare function isFloorMapPaletteDrag(dt: DataTransfer | null): boolean;
+/**
+ * 解析侧栏拖拽 payload；非法时返回 null
+ */
+export declare function parsePaletteDragPayload(dt: DataTransfer): FloorMapPaletteDragPayload | null;

package/lib/components/pisellFloorMapLayout/utils/floorMapElementNameAsTitle.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 「将图元名作为资源标题」开关：通用读写 + 标题解析。
+ *
+ * - 持久化在 `sceneElement.extensions[NAME_AS_TITLE_EXT_KEY]`，避免污染顶层 schema、
+ *   不影响未启用该能力的旧 / 新 kind。
+ * - 是否在编辑面板「显示」该选项，由 `FloorMapElementKindConfig.nameAsTitleConfigurable`
+ *   控制；展示侧（业务卡片渲染）只读 extensions，不依赖 kindConfig，确保即便业务方
+ *   后续撤回 kindConfig 开关，已落库的偏好仍生效。
+ */
+/** 持久化字段名：固定字符串，跨包共用，勿改 */
+export declare const NAME_AS_TITLE_EXT_KEY: "nameAsTitle";
+interface ElementWithExtensions {
+    name?: string;
+    extensions?: Record<string, unknown>;
+}
+/** 安全读取「图元名作为标题」开关 */
+export declare function isElementNameAsTitleEnabled(el: ElementWithExtensions | null | undefined): boolean;
+/**
+ * 计算 `extensions` patch：返回值供调用方写入 `sceneElement.extensions`。
+ *
+ * - `enabled === true` 时写入 `true`；
+ * - `enabled === false` 时**移除**该 key（而非写 `false`），避免持久化里残留无意义字段；
+ * - 返回 `undefined` 表示「extensions 整体可清空」（仅当结果是空对象时）。
+ *
+ * @example
+ * const nextExt = buildNameAsTitleExtensionsPatch(el.extensions, true);
+ * onUpdate({ extensions: nextExt });
+ */
+export declare function buildNameAsTitleExtensionsPatch(prev: Record<string, unknown> | undefined, enabled: boolean): Record<string, unknown> | undefined;
+/**
+ * 通用图元标题解析：业务展示层（卡片标题、占位标题等）统一调用本函数，
+ * 让「图元名作为资源标题」这一偏好对所有接入方一致生效。
+ *
+ * 优先级：
+ *   1. 启用了 nameAsTitle 且 `el.name` 非空 → `el.name`
+ *   2. `recordTitle`（业务侧按自己规则算出来的，如预约页 `row.main_field` / `row.code`）
+ *   3. `el.name`（业务字段缺失时的兜底，与历史行为一致）
+ *   4. `fallback`（如 kindLabel）
+ *   5. 空串
+ *
+ * 不更改 `displayRoomTitleFromRow` / `record.name` 等业务函数本身，
+ * 业务方只需把"按业务字段"算出来的结果以 `recordTitle` 传入即可，
+ * `bookingDetailModal` 等下游不会被联动改坏。
+ */
+export declare function resolveSceneElementDisplayTitle(opts: {
+    sceneElement?: ElementWithExtensions | null;
+    recordTitle?: string;
+    fallback?: string;
+}): string;
+export {};

package/lib/components/pisellFloorMapLayout/utils/floorMapResourcePickerDisplay.d.ts

@@ -0,0 +1,27 @@
+import type { PisellCardPickerCardBadge, PisellCardPickerCardMeta, PisellCardPickerCategoryConfig, PisellCardPickerItem } from './floorMapResourcePickerTypes';
+import { parseNestedPathSegments } from './floorMapResourcePickerTypes';
+/** @deprecated 使用 PisellCardPickerItem */
+export declare type FloorMapResourcePickerRecord = PisellCardPickerItem;
+/** 平面图资源选择卡片 meta：在通用 meta 基础上确保 id 存在，便于搜索文本拼接 */
+export interface FloorMapResourcePickerCardMeta extends PisellCardPickerCardMeta {
+    id: string;
+}
+/** 人数/容量：无值或为 0 时不展示 */
+export declare function resolveResourcePickerCapacity(record: PisellCardPickerItem): string | undefined;
+/**
+ * 预约桌位：从 `area` 解析路径，最多 3 段。
+ * 当前资源多为单段（如 `party_room1`）；将来 `广东/中山/三乡` 会自动出现二、三级筛选行。
+ */
+export declare function getFloorMapResourcePickerCategoryPath(record: PisellCardPickerItem): ReturnType<typeof parseNestedPathSegments>;
+/** 平面图 / 预约：area 最多三级；仅展示 chip，不显示行左侧「区域」等标签 */
+export declare function getFloorMapCardPickerCategoryConfig(): PisellCardPickerCategoryConfig;
+/**
+ * 把 capacity 字符串包装成「人数图标 + 数值」badge。
+ * 抽出来便于业务侧组合（如再追加 status badge 等）。
+ */
+export declare function buildResourceCapacityBadge(capacity?: string): PisellCardPickerCardBadge | null;
+/**
+ * 小卡片主标题 + 标签（人数等；区域已在筛选区展示，副文案不再重复 area）。
+ */
+export declare function getFloorMapResourcePickerCardMeta(record: PisellCardPickerItem): FloorMapResourcePickerCardMeta;
+export declare function floorMapResourcePickerRecordSearchText(record: PisellCardPickerItem): string;

package/lib/components/pisellFloorMapLayout/utils/floorMapResourcePickerTypes.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 平面图资源选择槽位的通用类型与工具。
+ * 默认由 `@pisell/materials` 的 `PisellResourcePickerModal` 承担；
+ * 业务可通过 `renderFilterBar` 注入 Tabbar 等筛选区，或通过 `renderResourcePickerModal` 整页覆盖。
+ */
+import type { ReactNode } from 'react';
+/** 选择模式 */
+export declare type PisellCardPickerMode = 'single' | 'multiple';
+/** 可选条目：至少包含稳定主键 id */
+export interface PisellCardPickerItem {
+    id: string;
+    [key: string]: unknown;
+}
+/** 分类路径，最多 3 级（不足时后续为 null；未选层级表示「全部」） */
+export declare type PisellCardPickerCategoryPath = [
+    string | null | undefined,
+    string | null | undefined,
+    string | null | undefined
+];
+/** 单级分类配置（最多 3 级） */
+export interface PisellCardPickerCategoryLevelConfig {
+    /** 嵌套模式下该级行左侧标签（如「省」「市」「区/镇」） */
+    label?: string;
+    /**
+     * parallel 模式：从 item[field] 读取该维度的 key。
+     * nested 模式：请用 getCategoryPath / nestedPathField 从单字段拆路径。
+     */
+    field?: string;
+}
+/**
+ * nested：同一维度嵌套分级（广东 → 中山 → 三乡），子级依赖父级已选。
+ * parallel：三个独立维度（每级互不影响）。
+ */
+export declare type PisellCardPickerCategoryMode = 'nested' | 'parallel';
+/** 分类筛选配置（最多 3 级；数据只有 1 级时 UI 只展示有值的那一行） */
+export interface PisellCardPickerCategoryConfig {
+    /** 默认 nested */
+    mode?: PisellCardPickerCategoryMode;
+    /**
+     * 最多 3 级配置位。
+     * nested：单字段拆路径；仅 1 段时只出现第 1 行，多段时再逐级出现。
+     */
+    levels: [
+        PisellCardPickerCategoryLevelConfig?,
+        PisellCardPickerCategoryLevelConfig?,
+        PisellCardPickerCategoryLevelConfig?
+    ];
+    /** 自定义 [L1,L2,L3]；优先于 levels[].field */
+    getCategoryPath?: (item: PisellCardPickerItem) => PisellCardPickerCategoryPath;
+    /**
+     * nested 便捷项：从 item[nestedPathField] 用 `/` `>` 等拆成最多 3 段。
+     * 与 getCategoryPath 同时存在时以 getCategoryPath 为准。
+     */
+    nestedPathField?: string;
+}
+/**
+ * 卡片小标签（如人数、状态、面积等）。
+ * - text：必填，纯文本内容
+ * - icon：可选 ReactNode，前置图标（如 TeamOutlined）
+ * 业务自由组合多个；空数组等价于不展示。
+ */
+export interface PisellCardPickerCardBadge {
+    text: string;
+    icon?: ReactNode;
+}
+export interface PisellCardPickerCardMeta {
+    title: string;
+    subtitles: string[];
+    /**
+     * 卡片末行的标签数组（如人数 / 状态）。比 subtitle 更紧凑，支持前置 icon。
+     */
+    badges?: PisellCardPickerCardBadge[];
+    /**
+     * 左侧缩略图/预览节点。传入字符串走内置 `<img>`，传入 ReactNode 直接渲染
+     * （如平面图 View All 的 palette preview cell）。
+     */
+    image?: ReactNode | string;
+}
+/**
+ * 平面图工具栏「打开资源选择」槽位 props。
+ * 与 `PisellProResourcePickerModalProps` 字段对齐；业务注入 modal 时可透传
+ * `categoryConfig` / `getSearchText` / `getCardMeta` 等扩展项。
+ */
+export interface FloorMapResourcePickerSlotProps {
+    open: boolean;
+    onClose: () => void;
+    onConfirm: (selectedIds: string[]) => void;
+    records: PisellCardPickerItem[];
+    mode?: PisellCardPickerMode;
+    value?: string[];
+    title?: string;
+    disabledIds?: string[];
+    /** 最多三级分类；不传则仅搜索 + 列表 */
+    categoryConfig?: PisellCardPickerCategoryConfig;
+    getSearchText?: (record: PisellCardPickerItem) => string;
+    getCardMeta?: (record: PisellCardPickerItem) => PisellCardPickerCardMeta;
+    renderCard?: (record: PisellCardPickerItem, ctx: {
+        selected: boolean;
+        disabled: boolean;
+    }) => ReactNode;
+    zIndex?: number;
+    width?: number;
+    className?: string;
+}
+/**
+ * 把单字段中的层级路径解析为 [L1, L2, L3]。
+ * 例：`广东/中山/三乡` → `['广东','中山','三乡']`；不足三级后续为 null。
+ */
+export declare function parseNestedPathSegments(raw: unknown, maxDepth?: number): PisellCardPickerCategoryPath;

package/lib/components/pisellGridPro/GridView/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import { GridViewProps } from './type';
+export type { GridViewProps };
+declare const GridView: (props: GridViewProps) => React.JSX.Element;
+export default GridView;

package/lib/components/pisellGridPro/GridView/type.d.ts

@@ -0,0 +1,3 @@
+import { PisellScrollViewProps } from '../../PisellScrollView/types';
+export interface GridViewProps extends PisellScrollViewProps {
+}

package/lib/components/pisellLookup/PisellLookup.js

@@ -104,6 +104,7 @@ var PisellLookupComponent = (0, import_react.forwardRef)((props, ref) => {
     mask = false,
     maskClosable,
     clearOnClose = false,
+    autoFocusOnOpen = true,
     // 样式配置
     className,
     style,
@@ -159,7 +160,7 @@ var PisellLookupComponent = (0, import_react.forwardRef)((props, ref) => {
   }, [visible, clearOnClose, setKeyword]);
   const handleAfterOpen = (0, import_react.useCallback)(() => {
     setTimeout(() => {
-      if (modalInputRef.current) {
+      if (autoFocusOnOpen && modalInputRef.current) {
         modalInputRef.current.focus();
         if (!clearOnClose && keyword) {
           modalInputRef.current.select();
@@ -169,7 +170,7 @@ var PisellLookupComponent = (0, import_react.forwardRef)((props, ref) => {
         onSearch == null ? void 0 : onSearch(keyword);
       }
     }, 100);
-  }, [clearOnClose, keyword, onSearch]);
+  }, [autoFocusOnOpen, clearOnClose, keyword, onSearch]);
   (0, import_react.useEffect)(() => {
     if (!showSuggestions || !onLoadSuggestions || !keyword || !visible) {
       setSuggestions([]);

package/lib/components/pisellLookup/PisellLookup.stories.d.ts

@@ -0,0 +1,129 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellLookup } from './PisellLookup';
+/**
+ * PisellLookup 组件 Storybook
+ * 搜索交互协议组件，提供统一的搜索入口、状态管理和结果承载能力
+ */
+declare const meta: Meta<typeof PisellLookup>;
+export default meta;
+declare type Story = StoryObj<typeof PisellLookup>;
+/**
+ * 基础示例 - Input 触发器 + Inline 展示
+ */
+export declare const Basic: Story;
+/**
+ * Input 触发器 - 默认尺寸（Middle）
+ */
+export declare const InputTriggerMiddle: Story;
+/**
+ * Input 触发器 - 大号尺寸
+ */
+export declare const InputTriggerLarge: Story;
+/**
+ * Button 触发器 + Modal 展示
+ */
+export declare const ButtonTrigger: Story;
+/**
+ * Icon 触发器 + Modal 展示
+ */
+export declare const IconTrigger: Story;
+/**
+ * Text 触发器 + Modal 展示
+ */
+export declare const TextTrigger: Story;
+/**
+ * 自定义触发器 + Modal 展示
+ */
+export declare const CustomTrigger: Story;
+/**
+ * Drawer 展示模式
+ */
+export declare const DrawerDisplay: Story;
+/**
+ * 搜索历史功能
+ */
+export declare const WithSearchHistory: Story;
+/**
+ * 联想词功能
+ */
+export declare const WithSuggestions: Story;
+/**
+ * 热门搜索功能
+ */
+export declare const WithHotWords: Story;
+/**
+ * 完整功能 - 历史 + 联想词 + 热门搜索
+ */
+export declare const FullFeatures: Story;
+/**
+ * 实时搜索模式
+ */
+export declare const RealtimeSearch: Story;
+/**
+ * 确认触发模式
+ */
+export declare const ConfirmSearch: Story;
+/**
+ * 受控模式示例
+ */
+export declare const Controlled: Story;
+/**
+ * 加载状态
+ */
+export declare const Loading: Story;
+/**
+ * 禁用状态
+ */
+export declare const Disabled: Story;
+/**
+ * Modal 自定义宽度
+ */
+export declare const ModalCustomWidth: Story;
+/**
+ * Modal 显示遮罩层
+ */
+export declare const ModalWithMask: Story;
+/**
+ * Modal 挂载到容器并使用 100% 宽度
+ */
+export declare const ModalFullWidth: Story;
+/**
+ * Drawer 不同方向
+ */
+export declare const DrawerPlacements: Story;
+/**
+ * 自定义空状态
+ */
+export declare const CustomEmpty: Story;
+/**
+ * 移动端场景
+ */
+export declare const MobileScenario: Story;
+/**
+ * 保留搜索内容（默认行为）
+ */
+export declare const PreserveKeyword: Story;
+/**
+ * 关闭时清空内容
+ */
+export declare const ClearOnClose: Story;
+/**
+ * 隐藏 Lookup 按钮（输入即搜索）
+ */
+export declare const NoConfirmButton: Story;
+/**
+ * 监听打开和关闭事件
+ */
+export declare const WithOpenCloseEvents: Story;
+/**
+ * 使用 Ref 控制
+ */
+export declare const WithRef: Story;
+/**
+ * 仅触发搜索（不展示结果）
+ */
+export declare const OnlyTriggerSearch: Story;
+/**
+ * Playground - 自由配置
+ */
+export declare const Playground: Story;

package/lib/components/pisellLookup/components/HotWords.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { HotWordsProps } from '../types';
+/**
+ * HotWords 组件
+ * 展示热门搜索
+ */
+export declare const HotWords: React.FC<HotWordsProps>;

package/lib/components/pisellLookup/components/LookupAuxiliary.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { LookupAuxiliaryProps } from '../types';
+/**
+ * LookupAuxiliary 组件
+ * 辅助信息层：搜索历史、联想词、热门搜索
+ */
+export declare const LookupAuxiliary: React.FC<LookupAuxiliaryProps>;

package/lib/components/pisellLookup/components/SearchHistory.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { SearchHistoryProps } from '../types';
+/**
+ * SearchHistory 组件
+ * 展示搜索历史记录
+ */
+export declare const SearchHistory: React.FC<SearchHistoryProps>;

package/lib/components/pisellLookup/components/SuggestWords.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { SuggestWordsProps } from '../types';
+/**
+ * SuggestWords 组件
+ * 展示搜索联想词
+ */
+export declare const SuggestWords: React.FC<SuggestWordsProps>;

package/lib/components/pisellLookup/components/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 子组件统一导出
+ */
+export { SearchHistory } from './SearchHistory';
+export { SuggestWords } from './SuggestWords';
+export { HotWords } from './HotWords';
+export { LookupAuxiliary } from './LookupAuxiliary';
+export { LookupTrigger } from './LookupTrigger';
+export { LookupResultHost } from './LookupResultHost';

package/lib/components/pisellLookup/hooks/useSearchHistory.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 搜索历史管理 Hook
+ */
+export interface UseSearchHistoryOptions {
+    /**
+     * 存储 key
+     */
+    historyKey: string;
+    /**
+     * 最大历史记录数量
+     */
+    maxHistoryCount: number;
+    /**
+     * 自定义加载历史记录函数
+     */
+    onLoadHistory?: () => string[];
+    /**
+     * 自定义保存历史记录函数
+     */
+    onSaveHistory?: (history: string[]) => void;
+}
+export interface UseSearchHistoryResult {
+    /**
+     * 历史记录数组
+     */
+    history: string[];
+    /**
+     * 添加历史记录
+     */
+    addHistory: (keyword: string) => void;
+    /**
+     * 删除历史记录
+     */
+    removeHistory: (keyword: string) => void;
+    /**
+     * 清除全部历史记录
+     */
+    clearAllHistory: () => void;
+    /**
+     * 重新加载历史记录
+     */
+    reloadHistory: () => void;
+}
+/**
+ * 搜索历史管理 Hook
+ * 支持自定义存储逻辑
+ */
+export declare const useSearchHistory: (options: UseSearchHistoryOptions) => UseSearchHistoryResult;

package/lib/components/pisellLookup/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PisellLookup 组件导出
+ */
+export { PisellLookup } from './PisellLookup';
+export type { PisellLookupRef } from './types';
+export type * from './types';