@pisell/materials 6.11.204 → 6.11.205

package/es/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/es/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/es/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/es/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/es/components/pisellGridPro/GridView/type.d.ts

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

package/es/components/pisellLookup/PisellLookup.js

@@ -105,6 +105,8 @@ var PisellLookupComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     maskClosable = props.maskClosable,
     _props$clearOnClose = props.clearOnClose,
     clearOnClose = _props$clearOnClose === void 0 ? false : _props$clearOnClose,
+    _props$autoFocusOnOpe = props.autoFocusOnOpen,
+    autoFocusOnOpen = _props$autoFocusOnOpe === void 0 ? true : _props$autoFocusOnOpe,
     className = props.className,
     style = props.style,
     zIndex = props.zIndex;
@@ -221,8 +223,8 @@ var PisellLookupComponent = /*#__PURE__*/forwardRef(function (props, ref) {
    */
   var handleAfterOpen = useCallback(function () {
     setTimeout(function () {
-      // 使用 ref 聚焦和选中
-      if (modalInputRef.current) {
+      // 使用 ref 聚焦和选中（可通过 autoFocusOnOpen 关闭）
+      if (autoFocusOnOpen && modalInputRef.current) {
         modalInputRef.current.focus();
 
         // 如果配置了保留内容且有关键词，选中文字
@@ -236,7 +238,7 @@ var PisellLookupComponent = /*#__PURE__*/forwardRef(function (props, ref) {
         onSearch === null || onSearch === void 0 || onSearch(keyword);
       }
     }, 100);
-  }, [clearOnClose, keyword, onSearch]);
+  }, [autoFocusOnOpen, clearOnClose, keyword, onSearch]);
 
   /**
    * 加载联想词

package/es/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/es/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/es/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/es/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/es/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/es/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/es/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/es/components/pisellLookup/index.d.ts

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