@pisell/materials 6.11.204 → 6.11.205

package/es/components/dataSourceComponents/fields/index.d.ts

@@ -20,7 +20,7 @@ declare const formFieldMap: {
         Subdomain: import("react").FC<import("antd").InputProps & {
             onChange: (value: string) => void;
             onBlur?: ((e: import("react").FocusEvent<HTMLInputElement, Element>) => void) | undefined;
-            rootDomain: "custom" | "xzero" | "saas";
+            rootDomain: "saas" | "custom" | "xzero";
             customDomain?: string | undefined;
             value?: string | undefined;
             tenantId: string;
@@ -35,7 +35,7 @@ declare const formFieldMap: {
     };
     FormItemSelect: (props: import("antd").SelectProps<any, import("antd/es/select").DefaultOptionType> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
         options?: any;
-        optionSourceType?: "default" | "custom" | "api" | undefined;
+        optionSourceType?: "default" | "api" | "custom" | undefined;
         labelField: string;
         valueField: string;
         extraParams?: Record<string, any> | undefined;
@@ -62,7 +62,7 @@ declare const formFieldMap: {
     FormItemIconSelect: import("react").FC<import("./IconSelect/type").IconSelectProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps>;
     FormItemRecordListWrapper: (props: import("./RecordListWrapper/type").RecordListWrapperProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
         options?: any;
-        optionSourceType?: "default" | "custom" | "api" | undefined;
+        optionSourceType?: "default" | "api" | "custom" | undefined;
         labelField: string;
         valueField: string;
         extraParams?: Record<string, any> | undefined;
@@ -72,7 +72,7 @@ declare const formFieldMap: {
     }) => import("react").JSX.Element;
     FormItemTabs: (props: import("./Tabs/type").TabsProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
         options?: any;
-        optionSourceType?: "default" | "custom" | "api" | undefined;
+        optionSourceType?: "default" | "api" | "custom" | undefined;
         labelField: string;
         valueField: string;
         extraParams?: Record<string, any> | undefined;
@@ -81,11 +81,7 @@ declare const formFieldMap: {
         extraParams?: Record<string, any> | undefined;
     }) => import("react").JSX.Element;
 };
-declare const getFieldComponent: (fieldComponent: string) => import("react").FC<import("./Translation/type").TranslationProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | (import("react").FC<{}> & {
-    Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;
-} & {
-    Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;
-}) | import("react").FC<import("./ColorPicker/type").ColorPickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<(import("antd").DatePickerProps & import("../dataSourceForm/utils").WithModeProps) & import("../dataSourceForm/utils").WithFormItemProps> | (import("react").FC<import("./Input/type").InputProps> & {
+declare const getFieldComponent: (fieldComponent: string) => (import("react").FC<import("./Input/type").InputProps> & {
     JSON: import("react").FC<any>;
     Password: import("react").FC<import("antd/es/input").PasswordProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps>;
     TextArea: import("react").FC<import("antd/es/input").TextAreaProps & import("react").RefAttributes<import("antd/es/input/TextArea").TextAreaRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps>;
@@ -98,7 +94,7 @@ declare const getFieldComponent: (fieldComponent: string) => import("react").FC<
     Subdomain: import("react").FC<import("antd").InputProps & {
         onChange: (value: string) => void;
         onBlur?: ((e: import("react").FocusEvent<HTMLInputElement, Element>) => void) | undefined;
-        rootDomain: "custom" | "xzero" | "saas";
+        rootDomain: "saas" | "custom" | "xzero";
         customDomain?: string | undefined;
         value?: string | undefined;
         tenantId: string;
@@ -106,12 +102,16 @@ declare const getFieldComponent: (fieldComponent: string) => import("react").FC<
         fieldKey?: string | undefined;
     } & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps>;
 }) | (import("react").FC<{}> & {
+    Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;
+} & {
+    Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;
+}) | import("react").FC<import("./ColorPicker/type").ColorPickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<(import("antd").DatePickerProps & import("../dataSourceForm/utils").WithModeProps) & import("../dataSourceForm/utils").WithFormItemProps> | (import("react").FC<{}> & {
     Group: import("react").FC<import("./Radio/type").RadioGroupProps & import("../dataSourceForm/utils").WithModeProps>;
 } & {
     Group: import("react").FC<import("./Radio/type").RadioGroupProps & import("../dataSourceForm/utils").WithModeProps>;
 }) | ((props: import("antd").SelectProps<any, import("antd/es/select").DefaultOptionType> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
     options?: any;
-    optionSourceType?: "default" | "custom" | "api" | undefined;
+    optionSourceType?: "default" | "api" | "custom" | undefined;
     labelField: string;
     valueField: string;
     extraParams?: Record<string, any> | undefined;
@@ -120,9 +120,9 @@ declare const getFieldComponent: (fieldComponent: string) => import("react").FC<
     extraParams?: Record<string, any> | undefined;
 }) => import("react").JSX.Element) | import("react").FC<any> | import("react").FC<import("./TimePicker/type").TimePickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Input.Phone/WithMode").PhoneInputProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Input.Mobile/WithMode").PhoneInputProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd").InputProps & {
     onChange: (value: string) => void;
-} & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd").InputProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd/es/input").PasswordProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Radio/type").RadioGroupProps & import("../dataSourceForm/utils").WithModeProps> | import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps> | import("react").FC<import("./DateRangePicker/type").DateRangePickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Upload/type").UploadProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./IconSelect/type").IconSelectProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | ((props: import("./RecordListWrapper/type").RecordListWrapperProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
+} & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd").InputProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("antd/es/input").PasswordProps & import("react").RefAttributes<import("antd").InputRef> & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Radio/type").RadioGroupProps & import("../dataSourceForm/utils").WithModeProps> | import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps> | import("react").FC<import("./DateRangePicker/type").DateRangePickerProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Upload/type").UploadProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./Translation/type").TranslationProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | import("react").FC<import("./IconSelect/type").IconSelectProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps> | ((props: import("./RecordListWrapper/type").RecordListWrapperProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
     options?: any;
-    optionSourceType?: "default" | "custom" | "api" | undefined;
+    optionSourceType?: "default" | "api" | "custom" | undefined;
     labelField: string;
     valueField: string;
     extraParams?: Record<string, any> | undefined;
@@ -131,7 +131,7 @@ declare const getFieldComponent: (fieldComponent: string) => import("react").FC<
     extraParams?: Record<string, any> | undefined;
 }) => import("react").JSX.Element) | ((props: import("./Tabs/type").TabsProps & import("../dataSourceForm/utils").WithModeProps & import("../dataSourceForm/utils").WithFormItemProps & {
     options?: any;
-    optionSourceType?: "default" | "custom" | "api" | undefined;
+    optionSourceType?: "default" | "api" | "custom" | undefined;
     labelField: string;
     valueField: string;
     extraParams?: Record<string, any> | undefined;

package/es/components/dataSourceComponents/hooks/useActions.d.ts

@@ -0,0 +1,18 @@
+import { DataSourceType } from '../provider/dataSource/DataSourceContext';
+export interface UseActionsParams {
+    dataSource?: DataSourceType;
+    currentValue?: 'server' | 'local';
+    __designMode?: string;
+    extraParams?: Record<string, any>;
+}
+declare const useActions: ({ dataSource: propsDataSource, currentValue: propsCurrentValue, __designMode, extraParams: propsExtraParams, }?: UseActionsParams) => {
+    create: (this: unknown, values: Record<string, any>) => Promise<any>;
+    get: (this: unknown) => Promise<any>;
+    update: (this: unknown, values: Record<string, any>) => Promise<any>;
+    list: (this: unknown, params: {
+        page: number;
+        pageSize: number;
+    }) => Promise<any>;
+    destroy: (this: unknown, id: string) => Promise<any>;
+};
+export default useActions;

package/es/components/dataSourceComponents/provider/dataSource/DataSourceContext.d.ts

@@ -0,0 +1,121 @@
+/// <reference types="react" />
+import { Result } from 'ahooks/es/useRequest/src/types';
+import { ActionsItem } from '../../dataSourceForm/serve';
+export interface Field {
+    name: string;
+    type: string;
+    allowNull: boolean;
+    primaryKey: boolean;
+    unique: boolean;
+    autoIncrement: boolean;
+    description?: (null | string)[];
+    possibleTypes?: string[];
+    rawType: string;
+    interface: string;
+    uiSchema: UiSchema;
+    key?: string;
+    collectionName?: string;
+    collectionKey?: any;
+    dataSourceKey?: string;
+    defaultValue?: any;
+}
+interface UiSchema {
+    type?: string;
+    'x-component': string;
+    'x-component-props'?: Xcomponentprops;
+    'x-validator'?: string;
+    title: string;
+    default?: any;
+    enum?: any[];
+}
+interface Xcomponentprops {
+    style?: Style;
+    autoSize?: AutoSize;
+    stringMode?: boolean;
+    step?: string;
+    dateFormat?: string;
+    showTime?: boolean;
+}
+interface AutoSize {
+    minRows: number;
+}
+interface Style {
+    width: string;
+}
+export declare type ActionTypes = 'list' | 'get' | 'update' | 'create' | 'destroy';
+export declare type DataSourceType = {
+    fromSettingMeta: boolean;
+    fromDeviceSettingMeta?: boolean;
+    actions: {
+        get: ActionsItem;
+        update: ActionsItem;
+        create: ActionsItem;
+        delete: ActionsItem;
+        list: ActionsItem;
+    };
+    headerDataSource: string;
+    dataSourceKey: string;
+    filterTargetKey: string;
+    introspected: boolean;
+    isCustomApi: boolean;
+    key: string;
+    tableName: string;
+    logging: boolean;
+    name: string;
+    title: string;
+    titleField: string;
+    types: ActionTypes[];
+    fields: Field[];
+    options: {
+        apiType: string;
+        baseUrl: string;
+    };
+};
+export declare type DataSourceContextProps = {
+    dataSource: DataSourceType;
+    children?: React.ReactNode;
+    currentValue?: string;
+    actions?: {
+        list?: () => Promise<any>;
+        get?: () => Promise<any>;
+        update?: () => Promise<any>;
+        create?: () => Promise<any>;
+        destroy?: () => Promise<any>;
+    };
+    requestOptions?: {
+        list?: any;
+        get?: any;
+        update?: any;
+        create?: any;
+        destroy?: any;
+    };
+    overrideData?: {
+        list?: any;
+        get?: any;
+    };
+    autoRun?: {
+        list?: boolean;
+        get?: boolean;
+    };
+    extraParams?: {
+        list?: Record<string, any>;
+        get?: Record<string, any>;
+        update?: Record<string, any>;
+        create?: Record<string, any>;
+        destroy?: Record<string, any>;
+    };
+    __id?: string;
+    __designMode?: string;
+};
+export interface DataSourceContextType {
+    dataSource?: DataSourceType;
+    list: Result<any, any>;
+    destroy: Result<any, any>;
+    get: Result<any, any>;
+    update: Result<any, any>;
+    create: Result<any, any>;
+    __designMode?: string;
+    getCurrentRecord: () => any;
+}
+export declare const DataSourceContext: import("react").Context<DataSourceContextType>;
+export default DataSourceContext;

package/es/components/dataSourceComponents/provider/variables/VariablesContext.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+export interface VariablesContextType {
+    children?: React.ReactNode;
+    variables?: Record<string, any>;
+    registerVariable?: (value: Record<string, any>) => void;
+    parseVariable?: (str: string, localVariables?: Record<string, any>) => any;
+    registerValueVariable?: (componentId: string, value: Record<string, any>) => void;
+    registerFunctionVariable?: (componentId: string, value: Record<string, any>) => void;
+    subscribeVariables?: (listener: (allVariables: Record<string, any>, updateVariables: Record<string, any>) => void) => () => void;
+    config?: {
+        disabledHistoryListener?: boolean;
+    };
+}
+export declare const VariablesContext: import("react").Context<VariablesContextType>;
+export default VariablesContext;

package/es/components/date-picker/index.d.ts

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const DatePicker: (props: any) => import("react").JSX.Element;
 export default DatePicker;

package/es/components/pisellDataSourceContainer/hooks/useDataSourceKey.d.ts

@@ -1,5 +1,6 @@
+/// <reference types="react" />
 declare const useDataSourceKey: () => {
-    dataSourceKey: string | import("../../dataSourceComponents/provider/dataSource/DataSourceContext").DataSourceType | undefined;
-    dataSourceKeyRef: import("react").MutableRefObject<string | import("../../dataSourceComponents/provider/dataSource/DataSourceContext").DataSourceType | undefined>;
+    dataSourceKey: string | undefined;
+    dataSourceKeyRef: import("react").MutableRefObject<string | undefined>;
 };
 export default useDataSourceKey;

package/es/components/pisellFind/PisellFind.stories.d.ts

@@ -0,0 +1,45 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellFind } from './index';
+/**
+ * PisellFind 组件 Storybook
+ * 基于 PisellLookup 的组件内查找优化版本
+ */
+declare const meta: Meta<typeof PisellFind>;
+export default meta;
+declare type Story = StoryObj<typeof PisellFind>;
+/**
+ * 基础示例 - 列表查找
+ */
+export declare const Basic: Story;
+/**
+ * 表格查找
+ */
+export declare const TableFind: Story;
+/**
+ * Input 模式查找
+ */
+export declare const InputMode: Story;
+/**
+ * 使用 Ref 控制
+ */
+export declare const WithRef: Story;
+/**
+ * 显示确认按钮
+ */
+export declare const WithConfirmButton: Story;
+/**
+ * 关闭历史记录
+ */
+export declare const NoHistory: Story;
+/**
+ * 多字段搜索
+ */
+export declare const MultiFieldSearch: Story;
+/**
+ * Drawer 模式
+ */
+export declare const DrawerMode: Story;
+/**
+ * Playground - 自由配置
+ */
+export declare const Playground: Story;

package/es/components/pisellFloorMapLayout/components/FloorMapEditQuickActions.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 编辑态选中图元旁的快捷操作：锁定 / 复制 / 删除（与侧栏同源逻辑）
+ */
+import React from 'react';
+export interface FloorMapEditQuickActionLabels {
+    lock: string;
+    unlock: string;
+    duplicate: string;
+    delete: string;
+    popTitle: string;
+    popDesc: string;
+    cancel: string;
+    okDelete: string;
+    ariaToolbar: string;
+}
+export interface FloorMapEditQuickActionsProps {
+    className?: string;
+    labels: FloorMapEditQuickActionLabels;
+    isLocked: boolean;
+    onToggleLock: () => void;
+    onDuplicate: () => void;
+    onDelete: () => void;
+    /** 画布 viewport scale，用于按 1/scale 反向缩放整个工具条，保持视觉尺寸恒定 */
+    viewportScale?: number;
+}
+export declare function FloorMapEditQuickActions(props: FloorMapEditQuickActionsProps): React.JSX.Element;

package/es/components/pisellFloorMapLayout/components/HistoryIcons.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 编辑顶栏 Undo / Redo 自定义 SVG icon。
+ *
+ * 设计来源：业务方提供的「圆勾箭头」风格 —— 整圈 ~270° 回环 + 末端三角箭头。
+ * 替换 antd 的 `UndoOutlined` / `RedoOutlined`：原版箭头偏方、回勾过短，
+ * 在 24/16px 的小尺寸下与界面其它细线 icon 不齐，且 Undo/Redo 镜像不够直观。
+ *
+ * 实现要点：
+ * - `stroke="currentColor"`、无填充：颜色完全跟随父级 `color`，与 Ant Button text 模式一致；
+ * - viewBox 14×14，配合 `font-size: 14px` 自动得到 14px icon；调用方可通过 fontSize/CSS 调整；
+ * - `stroke-linecap=round` + `stroke-linejoin=round`：在 1.5px 细线下保持圆润、抗锯齿友好；
+ * - 箭头用同色 `path` 三角，避免 marker-end 在不同浏览器下的尺寸漂移；
+ * - 接受 `className` / `style` / 其它 SVG 属性透传（与 antd icon 体感一致）。
+ */
+import React from 'react';
+declare type HistoryIconProps = React.SVGProps<SVGSVGElement> & {
+    /** 与 antd icon 类似：用于覆盖默认 1em 尺寸 */
+    size?: number | string;
+};
+/**
+ * Undo 图标：「↰」L 形带小圆角 —— 箭头在左侧水平指向左，主干由箭头水平向右、
+ * 经一个 1.5 半径的圆角折下、再竖直向下。
+ *
+ * 关于"看起来偏上"：antd `.anticon { vertical-align: -0.125em }` 已经把整个 svg
+ * 相对文字基线下移 ~0.125em，但我们的形状在 viewBox 内是几何居中的（y ∈ [3,11]），
+ * 与 antd 自家 outline icon（路径几乎铺满 viewBox）在视觉密度上不同 ——
+ * 留白对称会让人眼判断"图形在 viewBox 上半"。
+ *
+ * 解决：把形状整体下移 1 单位到 y ∈ [4, 12]，上侧留 4 / 下侧留 2，
+ * 让 icon 视觉中心匹配文字 x-height 中心，与 "Undo" 文本视觉齐平。
+ * x 仍保持 [3, 11] 居中。
+ */
+export declare function UndoHistoryIcon(props: HistoryIconProps): React.JSX.Element;
+/**
+ * Redo 图标：与 Undo 水平镜像，箭头在右侧指向右，干线右→左→下。
+ * 几何范围与 Undo 完全对称：x ∈ [3, 11]、y ∈ [4, 12]。
+ */
+export declare function RedoHistoryIcon(props: HistoryIconProps): React.JSX.Element;
+export {};

package/es/components/pisellFloorMapLayout/floorMapLayoutConstants.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 平面图布局根节点 BEM 前缀，与 `PisellFloorMapLayout.less` 中主 class 一致。
+ */
+export declare const FLOOR_MAP_LAYOUT_CLASS_PREFIX = "pisell-floor-map-layout";
+/** 手机左侧图元栏 Drawer，低于右侧属性抽屉 */
+export declare const FLOOR_MAP_PHONE_TOOLBAR_DRAWER_Z_INDEX = 2001;
+/** 手机右侧图元详情 Drawer */
+export declare const FLOOR_MAP_PHONE_EDIT_DRAWER_Z_INDEX = 2002;
+/**
+ * 高于 {@link FLOOR_MAP_PHONE_EDIT_DRAWER_Z_INDEX}，用于面板内 Popconfirm 等，避免被抽屉挡住。
+ */
+export declare const FLOOR_MAP_CONFIRM_OVERLAY_Z_INDEX = 2100;
+/**
+ * 「全览」伪画布 Tab id。
+ * 仅在阅读态、启用画布 > 1 时插入到画布 Tab 列表末尾，用来承载「同时查看所有画布」的入口。
+ * 不会写入 `config.canvases`，也不参与视口持久化、items 计算等真实画布逻辑。
+ */
+export declare const FLOOR_MAP_OVERVIEW_TAB_ID = "__pisell_floor_map_overview__";
+/**
+ * 全览视图：每个画布区块上方预留的标题带高度（像素）。
+ * 装箱时计入画布有效高度，保证画布之间的 gap 能容纳外置标题条。
+ */
+export declare const FLOOR_MAP_OVERVIEW_TITLE_BAND_HEIGHT = 36;
+/** 全览视图：画布区块之间的最小间距（像素，含标题带外的净距） */
+export declare const FLOOR_MAP_OVERVIEW_AREA_GAP = 40;
+/**
+ * 编辑态侧栏调色板：每个分类直接展示的图元数量上限。
+ * 超出时显示「查看全部」，在弹窗内选择数量并批量落点（所有分类通用）。
+ */
+export declare const FLOOR_MAP_TOOLBAR_PALETTE_SIDEBAR_LIMIT = 5;
+/**
+ * 右下 ViewControls Dock 底部留白（px）：`bottom: 14` + chrome `56` + 与面板间距 `8`。
+ * 编辑/连线属性面板滚动区 `padding-bottom` 引用同名 CSS 变量。
+ */
+export declare const FLOOR_MAP_VIEWPORT_DOCK_BOTTOM_CLEARANCE = 78;

package/es/components/pisellFloorMapLayout/hooks/floorMapViewportPersistence.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 平面图视口缓存：localStorage 读写、锁定态；供 useFloorMapTransformMetrics 使用。
+ */
+/** 平面图包围盒单侧默认外扩（像素）；过大会导致首屏大量空白 */
+export declare const DEFAULT_BOUNDING_PADDING = 56;
+/** 视口内与首屏对齐时，图元束左上与容器边缘的留白 */
+export declare const VIEWPORT_TOP_LEFT_MARGIN = 16;
+/** 平面图视口（缩放 + 平移）持久化到 localStorage 的 key 前缀 */
+export declare const VIEWPORT_STORAGE_PREFIX = "pisell-floor-map-layout.viewport:";
+/** 视口锁定态持久化前缀（与视口位置分开存储） */
+export declare const VIEWPORT_LOCK_STORAGE_PREFIX = "pisell-floor-map-layout.viewport-lock:";
+/** 视口持久化写入节流（避免拖动 / 缩放过程中高频写 localStorage） */
+export declare const VIEWPORT_PERSIST_DEBOUNCE_MS = 300;
+/** 判定当前 transform 是否处于「适配视口」结果时的容差 */
+export declare const FIT_BOUNDS_MATCH_POS_EPSILON = 0.5;
+export declare const FIT_BOUNDS_MATCH_SCALE_EPSILON = 0.005;
+export interface ViewportSnapshot {
+    x: number;
+    y: number;
+    scale: number;
+}
+export declare function readPersistedViewport(key: string): ViewportSnapshot | null;
+export declare function writePersistedViewport(key: string, snapshot: ViewportSnapshot): void;
+export declare function readPersistedViewportLock(key: string): boolean;
+export declare function writePersistedViewportLock(key: string, locked: boolean): void;

package/es/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/es/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/es/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/es/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/es/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;