@pisell/materials 6.12.1 → 6.12.2

package/lib/components/pisellFloorMapLayout/shopFloorPlan/shopFloorPlanTypes.d.ts

@@ -1,80 +0,0 @@
-/**
- * 店铺平面图 HTTP 契约（/shop/schedule/floor-plan）与 {@link FloorMapViewConfig} 映射所用类型。
- * 具体请求由 {@link ShopFloorPlanHttpAdapter} 注入，便于 materials 不依赖宿主 request 实现。
- */
-/** 遇 code 重复（接口 5001）时，{@link isFloorPlanDuplicateCodeError} 依赖此字段 */
-export declare const SHOP_FLOOR_PLAN_DUPLICATE_CODE = "floorPlanDuplicateCode";
-export interface ShopFloorPlanDetail {
-    id: number;
-    shop_id?: number;
-    code?: string;
-    name?: string | Record<string, string>;
-    layout: unknown;
-    canvas_width?: number;
-    canvas_height?: number;
-    sort?: number;
-    status?: number;
-    created_at?: string;
-    updated_at?: string;
-    [key: string]: unknown;
-}
-export interface ShopFloorPlanLayoutItem {
-    id: string;
-    type: 'rect' | 'circle';
-    label: string;
-    x: number;
-    y: number;
-    rotation: number;
-    color: string;
-    border_color: string;
-    resource_id: number | null;
-    width?: number;
-    height?: number;
-    radius?: number;
-    [key: string]: unknown;
-}
-export interface PostShopFloorPlanBody {
-    code: string;
-    name: Record<string, string>;
-    layout?: unknown;
-    canvas_width?: number;
-    canvas_height?: number;
-    sort?: number;
-    status?: number;
-}
-export interface PutShopFloorPlanBody {
-    code?: string;
-    name?: Record<string, string>;
-    layout?: unknown;
-    canvas_width?: number;
-    canvas_height?: number;
-    sort?: number;
-    status?: number;
-}
-export interface ShopFloorPlanByCodeRequestOptions {
-    osServer?: boolean;
-    subscriberId?: string;
-    callback?: (res: unknown) => void;
-}
-export declare type ShopFloorPlanHttpAdapter = {
-    get: (url: string, params?: unknown, config?: Record<string, unknown>) => Promise<unknown>;
-    post: (url: string, body?: unknown, config?: Record<string, unknown>) => Promise<unknown>;
-    put: (url: string, body?: unknown, config?: Record<string, unknown>) => Promise<unknown>;
-};
-export declare type CreateShopFloorPlanClientOptions = {
-    http: ShopFloorPlanHttpAdapter;
-    /** POST/PUT 失败且无更具体 message 时的兜底文案（静态；若需随语言切换请用 getSaveFailedMessage） */
-    saveFailedMessage?: string;
-    /** 保存失败时按当前运行时语言解析兜底文案（优先于 saveFailedMessage） */
-    getSaveFailedMessage?: () => string;
-    /**
-     * 是否走宿主 shop request 通道（`isShopApi`）。
-     * 默认 true：本 client 仅用于 `/shop/schedule/floor-plan`；拓扑单次 GET（无订阅）也需 shop 路由。
-     * 仅在极少数非 shop 宿主探测场景传 false。
-     */
-    useShopApi?: boolean;
-};
-/** ensure 流程可选：404 时 POST 创建体由调用方注入 */
-export declare type EnsureShopFloorPlanByCodeOptions = ShopFloorPlanByCodeRequestOptions & {
-    buildDefaultPostBody?: (code: string) => PostShopFloorPlanBody;
-};

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

@@ -1,64 +0,0 @@
-/**
- * 拖动/缩放图元时的「边缘对齐吸附」：对照其他图元的 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

@@ -1,59 +0,0 @@
-/**
- * 内置图形图元（`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

@@ -1,33 +0,0 @@
-/**
- * 平面图编辑态：侧栏图元拖拽到画布的 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

@@ -1,50 +0,0 @@
-/**
- * 「将图元名作为资源标题」开关：通用读写 + 标题解析。
- *
- * - 持久化在 `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

@@ -1,27 +0,0 @@
-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

@@ -1,109 +0,0 @@
-/**
- * 平面图资源选择槽位的通用类型与工具。
- * 默认由 `@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/pisellLookup/PisellLookup.d.ts

@@ -1,4 +0,0 @@
-import React from 'react';
-import type { PisellLookupProps, PisellLookupRef } from './types';
-import './PisellLookup.less';
-export declare const PisellLookup: React.ForwardRefExoticComponent<PisellLookupProps & React.RefAttributes<PisellLookupRef>>;

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

@@ -1,7 +0,0 @@
-import React from 'react';
-import type { LookupResultHostProps } from '../types';
-/**
- * LookupResultHost 组件
- * 结果承载层：根据展示类型渲染不同的容器
- */
-export declare const LookupResultHost: React.FC<LookupResultHostProps>;

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

@@ -1,3 +0,0 @@
-import React from 'react';
-import type { LookupTriggerProps, LookupTriggerRef } from '../types';
-export declare const LookupTrigger: React.ForwardRefExoticComponent<LookupTriggerProps & React.RefAttributes<LookupTriggerRef>>;

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

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