@pisell/materials 6.11.204 → 6.11.205

package/lib/components/dataSourceComponents/fields/RecordListWrapper/ReadPretty.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { RecordListWrapperProps } from './type';
+/**
+ * @title: RecordListWrapper 只读态
+ * @description: 低代码详情模式下展示每个 option 对应的 record 数据。
+ *   值结构: { optionValue: { field1: v1, field2: v2 } }
+ */
+declare const RecordListWrapperReadPretty: React.FC<RecordListWrapperProps>;
+export default RecordListWrapperReadPretty;

package/lib/components/dataSourceComponents/fields/RecordListWrapper/index.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 declare const RecordListWrapperWithDataSource: (props: import("./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;

package/lib/components/dataSourceComponents/fields/RecordListWrapper/type.d.ts

@@ -0,0 +1,87 @@
+import React from 'react';
+import { ModeType } from '../../dataSourceForm/type';
+export interface RecordListWrapperOption {
+    label?: React.ReactNode;
+    value: string | number;
+}
+export interface RecordListWrapperFieldSchema {
+    name: string;
+    label?: React.ReactNode;
+    component?: string;
+    componentName?: string;
+    type?: string;
+    /** 接口类型，用于映射到具体组件（如 Select、Input 等） */
+    interface?: string;
+    options?: RecordListWrapperOption[];
+    props?: Record<string, any>;
+    /** 子字段（用于嵌套结构，如 Input.JSON） */
+    children?: RecordListWrapperFieldSchema[];
+    _children?: RecordListWrapperFieldSchema[];
+    schema?: Record<string, any>;
+    uiSchema?: {
+        title?: React.ReactNode;
+        enum?: RecordListWrapperOption[];
+        'x-component'?: string;
+        'x-component-props'?: Record<string, any>;
+        'x-read-pretty'?: boolean;
+        'x-validator'?: string;
+        'x-display'?: 'visible' | 'hidden' | 'none';
+        'x-pattern'?: 'editable' | 'disabled' | 'readPretty';
+        'x-data-source'?: {
+            type?: string;
+            options?: Array<{
+                id?: string;
+                label: string | Record<string, any>;
+                value: string;
+                color?: string;
+            }>;
+            labelField?: string;
+            valueField?: string;
+            dataSource?: any;
+            extraParams?: Record<string, any>;
+        };
+        'x-record-schema'?: RecordListWrapperSchema | RecordListWrapperFieldSchema[] | string;
+        default?: any;
+        type?: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
+    };
+}
+export interface RecordListWrapperSchema {
+    fields?: RecordListWrapperFieldSchema[];
+    properties?: Record<string, any>;
+    children?: RecordListWrapperFieldSchema[];
+}
+/**
+ * @title RecordListWrapper 组件 Props
+ * @description
+ * 值结构为 Map：key 是 xDataSource option 的 value，value 是该 option 对应的表单字段值。
+ * 例如：{ "5": { "code": "xxx", "type": "yyy" }, "3": { "code": "aaa" } }
+ */
+export interface RecordListWrapperProps {
+    renderMode: ModeType;
+    /**
+     * 值: Map 结构
+     * - key: xDataSource option 的 value
+     * - value: 该 option 对应的 xRecordSchema 字段值对象
+     */
+    value?: Record<string, Record<string, any>>;
+    onChange?: (value: Record<string, Record<string, any>>) => void;
+    /** xDataSource 选项列表，驱动 tabs 导航和 records 结构 */
+    options?: RecordListWrapperOption[];
+    /**
+     * 上部插槽：用户可在低代码平台拖入自定义导航组件。
+     * RecordListWrapper 会通过 cloneElement 注入 options、value（activeKey）、onChange。
+     */
+    topSlot?: React.ReactNode;
+    slot?: React.ReactNode;
+    /** xRecordSchema：定义每条记录的子字段结构 */
+    xRecordSchema?: string | RecordListWrapperSchema | RecordListWrapperFieldSchema[];
+    /** 容器 children：低代码引擎渲染的子组件节点 */
+    children?: React.ReactNode;
+    /** 低代码设计模式标识 */
+    __designMode?: string;
+    /**
+     * 默认激活的 Tab key，外部传入时优先于 options[0].value
+     */
+    defaultValue?: string;
+    [key: string]: any;
+}

package/lib/components/dataSourceComponents/fields/Select/index.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 declare const SelectWithDataSource: (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;

package/lib/components/dataSourceComponents/fields/Tabs/Tabs.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import { TabsProps } from './type';
+import './Tabs.less';
+/**
+ * Tabs 胶囊风格选项卡组件
+ *
+ * @description 提供类似 Segmented 控件的胶囊风格选项卡，支持受控与非受控模式。
+ * 用于表单中替代 Radio.Group，展示更为直观的标签页切换交互。
+ *
+ * @example
+ * ```tsx
+ * <Tabs
+ *   value={current}
+ *   options={[
+ *     { label: '校区', value: 'campus' },
+ *     { label: '场地', value: 'venue' },
+ *   ]}
+ *   onChange={(val) => setCurrent(val)}
+ * />
+ * ```
+ */
+declare const Tabs: React.FC<TabsProps>;
+export default Tabs;

package/lib/components/dataSourceComponents/fields/Tabs/index.d.ts

@@ -1,7 +1,8 @@
+/// <reference types="react" />
 /** 包装 DataSource 层（提供数据源上下文） */
 declare const FormItemTabs: (props: import("./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/lib/components/dataSourceComponents/fields/Tabs/type.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import { ModeType } from '../../dataSourceForm/type';
+/**
+ * Tabs 选项配置
+ */
+export interface TabOption {
+    /** 选项显示文本 */
+    label: React.ReactNode;
+    /** 选项对应的值 */
+    value: string | number;
+    /** 是否禁用该选项 */
+    disabled?: boolean;
+}
+/**
+ * Tabs 基础 Props（编辑态组件使用，不含 renderMode）
+ */
+export interface TabsProps {
+    /** 当前选中的值（受控） */
+    value?: string | number;
+    /** 默认选中的值（非受控） */
+    defaultValue?: string | number;
+    /** 选项列表 */
+    options?: TabOption[];
+    /** 是否禁用整个组件 */
+    disabled?: boolean;
+    /** 选中值变化时的回调 */
+    onChange?: (value: string | number) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+/**
+ * Tabs ReadPretty Props（只读态组件使用，包含必填 renderMode）
+ */
+export interface TabsReadPrettyProps extends TabsProps {
+    renderMode: ModeType;
+}

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