@pisell/materials 1.8.24 → 1.8.25

package/lib/components/PisellScrollView/PisellScrollView.stories.d.ts

@@ -0,0 +1,87 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import PisellScrollView from './PisellScrollView';
+/**
+ * PisellScrollView 滚动视图组件
+ *
+ * 提供丰富的滚动功能，包括滚动方向控制、滚动条样式、滚动按钮、滚动事件监听、
+ * 视图监听、吸附滚动等功能
+ */
+declare const meta: Meta<typeof PisellScrollView>;
+export default meta;
+declare type Story = StoryObj<typeof PisellScrollView>;
+/**
+ * 基础用法 - 垂直滚动
+ */
+export declare const Default: Story;
+/**
+ * 水平滚动
+ */
+export declare const HorizontalScroll: Story;
+/**
+ * 双向滚动
+ */
+export declare const BothDirections: Story;
+/**
+ * 滚动条样式 - 细滚动条
+ */
+export declare const ThinScrollbar: Story;
+/**
+ * 滚动条样式 - 隐藏滚动条
+ */
+export declare const HiddenScrollbar: Story;
+/**
+ * 滚动按钮 - 右侧箭头
+ */
+export declare const RightArrows: Story;
+/**
+ * 滚动按钮 - 左右箭头
+ */
+export declare const LeftRightArrows: Story;
+/**
+ * 滚动按钮 - 返回顶部
+ */
+export declare const BackToTop: Story;
+/**
+ * 滚动事件监听
+ */
+export declare const ScrollEvents: Story;
+/**
+ * 吸附滚动 - 垂直方向
+ */
+export declare const SnapScrollVertical: Story;
+/**
+ * 吸附滚动 - 水平方向
+ */
+export declare const SnapScrollHorizontal: Story;
+/**
+ * 视图监听 - IntersectionObserver
+ */
+export declare const IntersectionObserver: Story;
+/**
+ * Ref 方法调用
+ */
+export declare const RefMethods: Story;
+/**
+ * 滚动到指定元素
+ */
+export declare const ScrollToElement: Story;
+/**
+ * 自定义尺寸
+ */
+export declare const CustomSize: Story;
+/**
+ * 综合示例 - 商品列表
+ */
+export declare const ProductList: Story;
+/**
+ * 综合示例 - 横向标签页
+ */
+export declare const HorizontalTabs: Story;
+/**
+ * 交互测试 - 验证组件渲染
+ */
+export declare const RenderTest: Story;
+/**
+ * 交互测试 - 滚动按钮点击
+ */
+export declare const ScrollButtonTest: Story;

package/lib/components/PisellScrollView/hooks/useScrollEvents.d.ts

@@ -0,0 +1,20 @@
+import { RefObject } from 'react';
+import { ScrollEventData, PisellScrollViewProps } from '../types';
+interface UseScrollEventsProps {
+    containerRef: RefObject<HTMLElement>;
+    onScroll?: PisellScrollViewProps['onScroll'];
+    onScrollStart?: PisellScrollViewProps['onScrollStart'];
+    onScrollEnd?: PisellScrollViewProps['onScrollEnd'];
+    onReachTop?: PisellScrollViewProps['onReachTop'];
+    onReachBottom?: PisellScrollViewProps['onReachBottom'];
+    onReachLeft?: PisellScrollViewProps['onReachLeft'];
+    onReachRight?: PisellScrollViewProps['onReachRight'];
+    reachThreshold?: number;
+    scrollEndDelay?: number;
+    updateScrollState: () => void;
+    scrollState: ScrollEventData;
+}
+export declare const useScrollEvents: ({ containerRef, onScroll, onScrollStart, onScrollEnd, onReachTop, onReachBottom, onReachLeft, onReachRight, reachThreshold, scrollEndDelay, updateScrollState, scrollState, }: UseScrollEventsProps) => {
+    handleScroll: () => void;
+};
+export {};

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

@@ -0,0 +1,3 @@
+import PisellScrollView from './PisellScrollView';
+export type { PisellScrollViewProps, PisellScrollViewRef } from './types';
+export default PisellScrollView;

package/lib/components/PisellSteps/PisellSteps.stories.d.ts

@@ -0,0 +1,155 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import PisellSteps from './PisellSteps';
+/**
+ * PisellSteps 步骤条组件
+ *
+ * 基于 Ant Design Steps 组件进行二次封装和增强
+ * 支持多种展示样式、布局方式和丰富的交互功能
+ */
+declare const meta: Meta<typeof PisellSteps>;
+export default meta;
+declare type Story = StoryObj<typeof PisellSteps>;
+/**
+ * 基础用法 - 默认步骤条
+ */
+export declare const Default: Story;
+/**
+ * 非受控模式
+ * @description 使用 defaultCurrent 设置初始步骤
+ */
+export declare const Uncontrolled: Story;
+/**
+ * 垂直方向
+ */
+export declare const Vertical: Story;
+/**
+ * 点状步骤条
+ * @description 通过 progressDot 属性启用点状样式
+ */
+export declare const Dot: Story;
+/**
+ * 自定义点状渲染
+ * @description 使用函数自定义点状图标的渲染
+ */
+export declare const CustomProgressDot: Story;
+/**
+ * 导航步骤条
+ */
+export declare const Navigation: Story;
+/**
+ * 小尺寸
+ */
+export declare const Small: Story;
+/**
+ * 大尺寸
+ */
+export declare const Large: Story;
+/**
+ * 标签垂直布局
+ * @description 标签在图标下方显示
+ */
+export declare const LabelVertical: Story;
+/**
+ * 错误状态
+ */
+export declare const ErrorStatus: Story;
+/**
+ * 自定义步骤状态
+ * @description 每个步骤可以单独设置状态
+ */
+export declare const CustomStatus: Story;
+/**
+ * 可点击步骤
+ */
+export declare const Clickable: Story;
+/**
+ * 禁止点击已完成步骤
+ * @description 设置 allowClickFinished 为 false
+ */
+export declare const DisallowClickFinished: Story;
+/**
+ * 禁用特定步骤
+ * @description 通过 disabled 属性禁用某个步骤
+ */
+export declare const DisabledStep: Story;
+/**
+ * 自定义图标
+ */
+export declare const CustomIcon: Story;
+/**
+ * 完成图标
+ */
+export declare const FinishIcon: Story;
+/**
+ * 栅格布局
+ * @description 启用栅格布局，自定义列数
+ */
+export declare const GridLayout: Story;
+/**
+ * 自定义图标与文本间距
+ * @description 通过 itemGap 属性自定义间距
+ */
+export declare const CustomItemGap: Story;
+/**
+ * 移动端 - 完整模式
+ * @description 移动端显示完整步骤条
+ */
+export declare const MobileModeFull: Story;
+/**
+ * 移动端 - 当前步骤模式
+ * @description 只显示当前步骤信息
+ */
+export declare const MobileModeCurrent: Story;
+/**
+ * 移动端 - 自动模式
+ * @description 根据屏幕宽度自动切换显示模式
+ */
+export declare const MobileModeAuto: Story;
+/**
+ * 自定义移动端断点
+ * @description 通过 mobileBreakpoint 自定义断点宽度
+ */
+export declare const CustomMobileBreakpoint: Story;
+/**
+ * 自定义起始索引
+ * @description 通过 initial 设置起始步骤索引
+ */
+export declare const InitialIndex: Story;
+/**
+ * 隐藏特定步骤
+ * @description 通过 hidden 属性动态隐藏步骤
+ */
+export declare const HiddenStep: Story;
+/**
+ * 带子标题
+ * @description 步骤可以包含子标题
+ */
+export declare const WithSubTitle: Story;
+/**
+ * 响应式步骤条
+ * @description 开启响应式后会自动调整布局
+ */
+export declare const Responsive: Story;
+/**
+ * 完整功能演示
+ * @description 展示多种功能的组合使用
+ */
+export declare const FullFeature: Story;
+/**
+ * 多步骤流程
+ * @description 更多步骤的场景
+ */
+export declare const ManySteps: Story;
+/**
+ * 购物流程示例
+ * @description 模拟真实的购物流程
+ */
+export declare const ShoppingFlow: Story;
+/**
+ * 交互测试 - 点击步骤
+ */
+export declare const InteractionTest: Story;
+/**
+ * 交互测试 - 验证组件渲染
+ */
+export declare const RenderTest: Story;

package/lib/components/PisellTabbar/locales.d.ts

@@ -0,0 +1,23 @@
+declare const _default: {
+    en: {
+        expand: string;
+        minimize: string;
+    };
+    "zh-CN": {
+        expand: string;
+        minimize: string;
+    };
+    "zh-HK": {
+        expand: string;
+        minimize: string;
+    };
+    ja: {
+        expand: string;
+        minimize: string;
+    };
+    pt: {
+        expand: string;
+        minimize: string;
+    };
+};
+export default _default;

package/lib/components/PisellTabbar/template/Template1/utils/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * PisellTabbar 工具函数
+ */
+import { TabbarDataSource } from '../../../types';
+/**
+ * 向数据源添加特殊项（如 all、search、expand 按钮）
+ *
+ * @param dataSource - 原始数据源
+ * @param keys - 要添加的特殊项 key 数组
+ * @returns 添加了特殊项的新数据源
+ *
+ * @example
+ * ```tsx
+ * const newData = addDataSourceItemsByKey(categoryData, ['expand', 'all']);
+ * // 返回: [expandItem, allItem, ...categoryData]
+ * ```
+ */
+export declare const addDataSourceItemsByKey: (dataSource: TabbarDataSource[], keys: ('all' | 'search' | 'expand')[]) => TabbarDataSource[];
+/**
+ * 获取默认激活的 key 数组
+ *
+ * @param dataSource - 数据源
+ * @param rowKey - 用作唯一标识的字段名
+ * @returns 默认激活的 key 数组（多层级）
+ *
+ * @description
+ * 默认选中第一项，如果第一项有子级，同时选中第一个子级
+ *
+ * @example
+ * ```tsx
+ * const defaultKeys = getDefaultActiveKey(categoryData, 'id');
+ * // 返回: [1, 0] (第一层级的第一项ID，第二层级的第一项ID)
+ * ```
+ */
+export declare const getDefaultActiveKey: (dataSource: TabbarDataSource[], rowKey: string) => (string | number)[];

package/lib/components/PisellTabbar2/locales.d.ts

@@ -0,0 +1,23 @@
+declare const _default: {
+    en: {
+        expand: string;
+        minimize: string;
+    };
+    "zh-CN": {
+        expand: string;
+        minimize: string;
+    };
+    "zh-HK": {
+        expand: string;
+        minimize: string;
+    };
+    ja: {
+        expand: string;
+        minimize: string;
+    };
+    pt: {
+        expand: string;
+        minimize: string;
+    };
+};
+export default _default;

package/lib/components/PisellTabbar3/locales.d.ts

@@ -0,0 +1,23 @@
+declare const _default: {
+    en: {
+        expand: string;
+        minimize: string;
+    };
+    "zh-CN": {
+        expand: string;
+        minimize: string;
+    };
+    "zh-HK": {
+        expand: string;
+        minimize: string;
+    };
+    ja: {
+        expand: string;
+        minimize: string;
+    };
+    pt: {
+        expand: string;
+        minimize: string;
+    };
+};
+export default _default;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { AppVersionControlProps } from './types';
 import './index.less';
 declare const AppVersionControl: (props: AppVersionControlProps) => JSX.Element;

package/lib/components/auto-complete-number/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { AutoCompleteProps, InputNumberProps } from "antd";
 interface AutoCompleteNumberProps {
     autoCompleteProps: AutoCompleteProps;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { BadgeProps as OriginalBadgeprops } from 'antd';
 import './index.less';
 export interface Badgeprops extends OriginalBadgeprops {

package/lib/components/batch-editor/fields/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 declare const _default: {
     price: import("react").FC<import("./Price").PriceProps>;
     image: (props: import("./Image").ImageProps) => JSX.Element | null;

package/lib/components/batch-editor/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import "./index.less";
 interface BatchEditorProps {
     columns: any[];

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

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

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

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

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

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

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { ColorPickerProps } from 'antd';
 declare const ColorPicker: (props: ColorPickerProps) => JSX.Element;
 export default ColorPicker;

package/lib/components/config-provider/index.d.ts

@@ -0,0 +1,9 @@
+import { ConfigProviderProps as OriginalConfigProviderProps } from "antd/es/config-provider";
+import "dayjs/locale/zh-cn";
+import "dayjs/locale/ja";
+import "dayjs/locale/pt";
+export interface ConfigProviderProps extends OriginalConfigProviderProps {
+    [key: string]: any;
+}
+declare const ConfigProvider: (props: ConfigProviderProps) => JSX.Element;
+export default ConfigProvider;

package/lib/components/dataSourceComponents/dataSourceForm/urlUtils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * URL参数处理工具方法
+ */
+/**
+ * 从浏览器URL获取查询参数
+ * @returns Record<string, string> URL查询参数对象
+ */
+export declare const getUrlParams: () => Record<string, string>;
+/**
+ * 从URL参数中提取formSettingMeta相关的参数
+ * @param urlParams URL查询参数对象，如果不传则自动从浏览器获取
+ * @returns 包含business_code、channel_code和isBoard参数的对象
+ */
+export declare const getFormSettingParams: (urlParams?: Record<string, string>) => {
+    businessCode: string;
+    channelCode: string;
+    isBoard: boolean;
+};
+/**
+ * 根据URL参数更新租户设置数据
+ * @param data 要更新的数据对象，如 {"order.prefix":"","order.suffix":"","payment.number":""}
+ * @returns Promise<any> 返回更新结果
+ */
+export declare const updateTenantSettingFromUrl: (data: Record<string, any>) => Promise<any>;

package/lib/components/dataSourceComponents/dataSourceShow/dataSourceImage/index.d.ts

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

package/lib/components/dataSourceComponents/dataSourceShow/dataSourceQRCode/index.d.ts

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

package/lib/components/dataSourceComponents/dataSourceTable/hooks/useDataSourceKey.d.ts

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

package/lib/components/dataSourceComponents/dataSourceTable/hooks/useDrawerState.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 declare const useDrawerState: (operationContent?: {
     [key: string]: import("react").ReactNode;
 } | undefined) => any;

package/lib/components/dataSourceComponents/dataSourceTable/hooks/useTableProps.d.ts

@@ -19,7 +19,7 @@ interface UseTablePropsProps {
  */
 declare const useTableProps: (props: UseTablePropsProps) => {
     currentComponentId: any;
-    title: number | boolean | React.ReactFragment | JSX.Element | (() => React.ReactNode) | null | undefined;
+    title: string | number | boolean | React.ReactFragment | JSX.Element | (() => React.ReactNode) | null | undefined;
     pagination: {
         total: number;
         current: number;
@@ -28,7 +28,7 @@ declare const useTableProps: (props: UseTablePropsProps) => {
         showSizeChanger: boolean;
     };
     columns: import("./useColumns").Column[];
-    subTitle: number | boolean | React.ReactFragment | JSX.Element | (() => React.ReactNode) | null | undefined;
+    subTitle: string | number | boolean | React.ReactFragment | JSX.Element | (() => React.ReactNode) | null | undefined;
     buttons: any[] | null;
     filter: {
         dom: any;
@@ -72,7 +72,7 @@ declare const useTableProps: (props: UseTablePropsProps) => {
         useCustomAction: boolean;
         actionType: string;
         openMode: "modal" | "drawer";
-        openContentSize: "small" | "middle" | "large";
+        openContentSize: "large" | "middle" | "small";
         openTitle: string;
         key: string;
     } | undefined;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { ColorPickerProps } from './type';
 import './ReadPretty.less';
 declare const ColorPickerReadPretty: (props: ColorPickerProps) => JSX.Element;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { DateRangePickerProps } from './type';
 import './ReadPretty.less';
 declare const DateRangePickerReadPretty: (props: DateRangePickerProps) => JSX.Element;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { IconSelectProps } from './type';
 import './ReadPretty.less';
 declare const IconSelectReadPretty: (props: IconSelectProps) => JSX.Element | null;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InputProps } from './type';
 import './ReadPretty.less';
 declare const InputReadPretty: (props: InputProps) => JSX.Element;

package/lib/components/dataSourceComponents/fields/Input.Email/ReadPretty.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InputProps } from './type';
 import './ReadPretty.less';
 declare const InputReadPretty: (props: InputProps) => JSX.Element;

package/lib/components/dataSourceComponents/fields/Input.Phone/serve.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 获取nocobase数据列表
+ */
+export declare const getCountryDataList: () => Promise<any>;
+export declare const getShopCountryDataList: (locale?: any) => Promise<any>;
+export interface Country {
+    id: number;
+    name: {
+        en: string;
+        'zh-CN': string;
+        'zh-HK': string;
+        'ja': string;
+        'pt': string;
+        original: string;
+    };
+    code: string;
+    calling_code: string;
+    currency_code: string;
+    sort: number;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+}
+export declare const useCountries: () => {
+    data: Country[];
+};

package/lib/components/dataSourceComponents/fields/Input.Subdomain/ReadPretty.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InputProps } from './type';
 import './ReadPretty.less';
 declare const InputReadPretty: (props: InputProps) => JSX.Element;

package/lib/components/dataSourceComponents/fields/Input.TextArea/ReadPretty.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { TextAreaProps } from "./type";
 import "./ReadPretty.less";
 declare const TextAreaReadPretty: (props: TextAreaProps) => JSX.Element;

package/lib/components/dataSourceComponents/fields/Input.Url/ReadPretty.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { UrlProps } from './type';
 import './ReadPretty.less';
 export declare const formatUrl: (url: string) => string;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { TimePickerProps } from './type';
 import './ReadPretty.less';
 declare const TimePickerReadPretty: (props: TimePickerProps) => JSX.Element;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { TranslationProps } from './type';
 import './ReadPretty.less';
 declare const TranslationReadPretty: (props: TranslationProps) => JSX.Element;

package/lib/components/dataSourceComponents/fields/Upload/CameraPopover.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 declare const CameraPopover: (props: {
     onLocalFileClick: () => void;
     onCameraChange: (file: any) => void;

package/lib/components/dataSourceComponents/fields/Upload/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const SUPPORTED_LANGUAGES: readonly ["original", "en", "zh-CN", "zh-HK", "ja", "pt"];
+export declare const DEFAULT_MAX_COUNT = 9;
+export declare const DEFAULT_UID = "-1";
+export declare const MEDIA_TYPES: {
+    readonly VIDEO: "video/";
+    readonly AUDIO: "audio/";
+};
+export declare const IMAGE_QUALITY = 0.8;
+export declare const IMAGE_TYPE = "image/jpeg";

package/lib/components/dataSourceComponents/fields/Upload/utils.d.ts

@@ -15,4 +15,4 @@ export declare const getFileMetadataParams: (file: RcFile & {
     metadata?: MediaMetadata;
 }) => Record<string, any>;
 export declare const isValueEqual: (value: any, fileListValue: any) => boolean;
-export declare const getBaseTime: (size: number) => 1000 | 2000 | 4000 | 8000;
+export declare const getBaseTime: (size: number) => 2000 | 1000 | 4000 | 8000;