@pisell/materials 1.8.11 → 1.8.13

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

@@ -1,6 +1,7 @@
 /**
  * PisellCurrency 组件导出
  */
-export { default as PisellCurrency } from './PisellCurrency';
+import PisellCurrency from './PisellCurrency';
+export { PisellCurrency };
 export type { PisellCurrencyProps } from './types';
 export type { DisplayState, ValidationResult, NumberInputState, BaseNumberInputProps } from './types';

package/lib/components/pisellCurrency/index.js

@@ -32,7 +32,14 @@ __export(pisellCurrency_exports, {
   PisellCurrency: () => import_PisellCurrency.default
 });
 module.exports = __toCommonJS(pisellCurrency_exports);
+var import_locales = require("../../locales");
 var import_PisellCurrency = __toESM(require("./PisellCurrency"));
+import_PisellCurrency.default.SortOptions = {
+  getSortItems: (fieldKey) => [
+    { key: `${fieldKey}:asc`, label: (0, import_locales.getText)("sort-0-9") },
+    { key: `${fieldKey}:desc`, label: (0, import_locales.getText)("sort-9-0") }
+  ]
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PisellCurrency

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

@@ -0,0 +1,16 @@
+import React from 'react';
+import './index.less';
+export interface PisellCustomCheckboxGroupProps {
+    dataSource?: any[];
+    disabled?: boolean;
+    allowAdd?: boolean;
+    isMultiple?: boolean;
+    id?: string | string[];
+    onClick?: (value: any) => void;
+    onAdd?: () => void;
+    renderAddItem?: (item: any) => React.ReactNode;
+    [key: string]: any;
+    className?: string;
+}
+declare const PisellCustomCheckboxGroup: React.FC<PisellCustomCheckboxGroupProps>;
+export default PisellCustomCheckboxGroup;

package/lib/components/pisellDataSourceContainer/PisellDataSourceContainer.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { DataSourceContainerProps } from './type';
-declare const PisellDataSourceContainer: (props: DataSourceContainerProps) => React.JSX.Element;
+declare const PisellDataSourceContainer: (props: DataSourceContainerProps) => JSX.Element;
 export default PisellDataSourceContainer;

package/lib/components/pisellDataSourceContainer/components/ColumnsSetting/utils.d.ts

@@ -1,17 +1,24 @@
+/**
+ * 列设置工具：持久化复用 @pisell/utils 的 saveColumnSettingToLocal / getColumnSettingFromLocal；
+ * mergeColumnSettingSimple 为 Table 列与本地缓存的合并逻辑，保留在此。
+ */
 import React from 'react';
-export declare const saveColumnSettingToLocal: ({ componentId, columnSetting, }: {
+import { getColumnSettingFromLocal, clearColumnSettingFromLocal } from '@pisell/utils';
+export { getColumnSettingFromLocal, clearColumnSettingFromLocal };
+/** 与 DataSourceContainer ColumnsSetting 调用处类型兼容的列设置项（含 React.ReactNode title） */
+export interface ColumnSettingItemForSave {
+    key: string;
+    dataIndex: string;
+    title?: React.ReactNode;
+    titleString?: string;
+    isShow: boolean;
+    sortIndex?: number;
+    fixed?: 'left' | 'right' | boolean;
+}
+export declare const saveColumnSettingToLocal: (params: {
     componentId: string;
-    columnSetting: Array<{
-        key: string;
-        dataIndex: string;
-        title?: React.ReactNode;
-        titleString?: string;
-        isShow: boolean;
-        sortIndex?: number;
-        fixed?: 'left' | 'right' | boolean;
-    }>;
+    columnSetting: ColumnSettingItemForSave[];
 }) => void;
-export declare const getColumnSettingFromLocal: (componentId?: string) => any;
 export declare const mergeColumnSettingSimple: ({ columns, componentId, }: {
     columns: Record<string, any>[];
     componentId?: string | undefined;
@@ -19,4 +26,3 @@ export declare const mergeColumnSettingSimple: ({ columns, componentId, }: {
     isShow: any;
     sortIndex: any;
 }[];
-export declare const clearColumnSettingFromLocal: (componentId?: string) => void;

package/lib/components/pisellDataSourceContainer/components/ColumnsSetting/utils.js

@@ -19,52 +19,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/components/pisellDataSourceContainer/components/ColumnsSetting/utils.ts
 var utils_exports = {};
 __export(utils_exports, {
-  clearColumnSettingFromLocal: () => clearColumnSettingFromLocal,
-  getColumnSettingFromLocal: () => getColumnSettingFromLocal,
+  clearColumnSettingFromLocal: () => import_utils.clearColumnSettingFromLocal,
+  getColumnSettingFromLocal: () => import_utils.getColumnSettingFromLocal,
   mergeColumnSettingSimple: () => mergeColumnSettingSimple,
   saveColumnSettingToLocal: () => saveColumnSettingToLocal
 });
 module.exports = __toCommonJS(utils_exports);
 var import_utils = require("@pisell/utils");
-var getTableKey = (componentId) => {
-  if (typeof window === "undefined" || typeof window.location === "undefined") {
-    return `table-setting-${componentId}`;
-  }
-  const { pathname, search } = window.location;
-  let appendPath = pathname || "/";
-  let memoryKey = "";
-  try {
-    const params = new URLSearchParams(search || "");
-    const mk = params.get("memory_key");
-    if (mk && mk.trim() !== "") {
-      memoryKey = mk.trim();
-    }
-  } catch (e) {
-  }
-  const urlPart = memoryKey ? `${appendPath}#${memoryKey}` : appendPath;
-  return `table-setting-${componentId}-${urlPart}`;
-};
-var saveColumnSettingToLocal = ({
-  componentId,
-  columnSetting
-}) => {
-  if (!componentId) return;
-  const storageKey = getTableKey(componentId);
-  const data = {
-    column_setting: columnSetting,
-    updatedAt: Date.now()
-  };
-  localStorage.setItem(storageKey, JSON.stringify(data));
-};
-var getColumnSettingFromLocal = (componentId) => {
-  if (!componentId) return null;
-  const storageKey = getTableKey(componentId);
-  const originData = localStorage.getItem(storageKey);
-  if (originData && (0, import_utils.isJson)(originData)) {
-    const data = JSON.parse(originData);
-    return data.column_setting;
-  }
-  return null;
+var saveColumnSettingToLocal = (params) => {
+  (0, import_utils.saveColumnSettingToLocal)({
+    componentId: params.componentId,
+    columnSetting: params.columnSetting
+  });
 };
 var mergeColumnSettingSimple = ({
   columns,
@@ -77,7 +43,7 @@ var mergeColumnSettingSimple = ({
       sortIndex: index
     }));
   }
-  const cachedColumns = getColumnSettingFromLocal(componentId);
+  const cachedColumns = (0, import_utils.getColumnSettingFromLocal)(componentId);
   if (!cachedColumns || !Array.isArray(cachedColumns)) {
     return columns.map((item, index) => ({
       ...item,
@@ -95,7 +61,6 @@ var mergeColumnSettingSimple = ({
         ...item,
         isShow: cached.isShow ?? true,
         sortIndex: cached.sortIndex ?? index
-        // 注意：fixed 等特殊字段不从缓存中覆盖，保持 props 传入的值
       };
     }
     return {
@@ -107,11 +72,6 @@ var mergeColumnSettingSimple = ({
   mergedColumns.sort((a, b) => (a.sortIndex ?? 0) - (b.sortIndex ?? 0));
   return mergedColumns;
 };
-var clearColumnSettingFromLocal = (componentId) => {
-  if (!componentId) return;
-  const storageKey = getTableKey(componentId);
-  localStorage.removeItem(storageKey);
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   clearColumnSettingFromLocal,

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

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

package/lib/components/pisellDataSourceContainer/hooks/useHandleAction.d.ts

@@ -0,0 +1,32 @@
+import { DataSourceContainerProps } from '../type';
+import { FormInstance } from 'antd';
+declare const useHandleAction: (initialParams: Record<string, any> | undefined, options: DataSourceContainerProps['pagination'], form: FormInstance | undefined) => {
+    list: {
+        pagination?: {
+            pageNumber: number;
+            pageSize: number;
+        } | undefined;
+        data: {
+            list: any;
+            count: any;
+        };
+        onSearch: (newParams?: Record<string, any>) => void;
+        onReset: () => void;
+        onPageChange: (pageNumber: number, pageSize: number) => void;
+        loading: boolean;
+        error?: Error | undefined;
+        params: any;
+        cancel: () => void;
+        refresh: () => void;
+        refreshAsync: () => Promise<any>;
+        run: (...params: any) => void;
+        runAsync: (...params: any) => Promise<any>;
+        mutate: (data?: any) => void;
+    };
+    get: import("ahooks/es/useRequest/src/types").Result<any, any>;
+    update: import("ahooks/es/useRequest/src/types").Result<any, any>;
+    create: import("ahooks/es/useRequest/src/types").Result<any, any>;
+    destroy: import("ahooks/es/useRequest/src/types").Result<any, any>;
+    getCurrentRecord: () => any;
+};
+export default useHandleAction;

package/lib/components/pisellDataSourceContainer/provider/ChildComponentProps.d.ts

@@ -0,0 +1,13 @@
+import React, { ReactNode } from 'react';
+import { FormInstance } from 'antd';
+import { ChildComponentPropsType } from '../type';
+declare type ChildComponentPropsContextType = ChildComponentPropsType & {
+    form: FormInstance;
+};
+interface ChildComponentPropsProviderProps {
+    childComponentProps?: ChildComponentPropsType;
+    children: ReactNode;
+}
+export declare const ChildComponentPropsProvider: React.FC<ChildComponentPropsProviderProps>;
+export declare const useChildComponentPropsContext: () => ChildComponentPropsContextType;
+export {};

package/lib/components/pisellDataSourceContainer/provider/HandleActions.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
 import { DataSourceContainerProps, HandleActionContextType } from '../type';
 export declare const HandleActionContext: React.Context<HandleActionContextType | null>;
-export declare const HandleActionsProvider: (props: DataSourceContainerProps) => React.JSX.Element;
+export declare const HandleActionsProvider: (props: DataSourceContainerProps) => JSX.Element;
 export declare const useHandleActionProvider: () => HandleActionContextType;

package/lib/components/pisellDataSourceContainer/provider/RefManager.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { RefManagerContextType } from '../type';
+export declare const RefManagerContext: React.Context<RefManagerContextType | null>;
+interface RefManagerProviderProps {
+    children: React.ReactNode;
+}
+export declare const RefManagerProvider: React.FC<RefManagerProviderProps>;
+export declare const useRefManagerProvider: () => RefManagerContextType;
+export {};

package/lib/components/pisellDataSourceContainer/type.d.ts

@@ -0,0 +1,84 @@
+import { DataSourceContextProps, DataSourceContextType } from '../dataSourceComponents/provider/dataSource/DataSourceContext';
+import { Result } from 'ahooks/es/useRequest/src/types';
+import { TableProps as AntdTableProps, PaginationProps, TabsProps as AntdTabsProps, FormInstance as AntdFormInstance } from 'antd';
+import { SortListProps } from '../sort/types';
+import { FilterItemProps } from '../filter/types';
+import { FilterListProps } from '../filter/components/FilterButton/types';
+/**
+ * 子组件属性集合类型定义
+ */
+export interface ChildComponentPropsType {
+    /** Filter 组件属性 */
+    filterComponent?: {
+        value: {
+            quickFilter?: FilterItemProps[];
+            otherFilter?: FilterItemProps[];
+        };
+        formFiltersPrefix?: string;
+        quickFilterMaxLength?: number;
+    };
+    /** QuickFilter 组件属性 */
+    quickFilterComponent?: {
+        filterList: FilterItemProps[];
+        formFiltersPrefix?: string;
+    };
+    /** FilterButton 组件属性 */
+    filterButtonComponent?: FilterListProps;
+    /** tabsComponent 组件属性 */
+    tabsComponent?: {
+        items: AntdTabsProps['items'];
+        type?: 'default' | 'button' | 'buttonGroup' | 'dropdown';
+    };
+    /** Sort 组件属性 */
+    sortComponent?: SortListProps;
+    /** Table 组件属性 */
+    tableComponent?: AntdTableProps<any>;
+    /** ColumnsSetting 组件属性 */
+    columnsSettingComponent?: {
+        value?: Record<string, any>[];
+        onChange?: (val: Record<string, any>[]) => void;
+    };
+    /** Pagination 组件属性 */
+    paginationComponent?: PaginationProps;
+}
+export interface DataSourceContainerProps extends DataSourceContextProps {
+    pagination?: boolean | {
+        pageNumber: number;
+        pageSize: number;
+    };
+    childComponentProps?: ChildComponentPropsType;
+}
+/**
+ * 扩展的 HandleActionContextType
+ */
+export interface HandleActionContextType extends Omit<DataSourceContextType, 'list'> {
+    list: Result<any, any> & {
+        onSearch: (newParams?: Record<string, any>) => void;
+        onReset: () => void;
+        onPageChange: (pageNumber: number, pageSize: number) => void;
+        pagination?: {
+            pageNumber: number;
+            pageSize: number;
+        };
+    };
+}
+export interface RefManagerContextType {
+    getRef: <T = any>(id: string) => T | undefined;
+    registerRef: <T = any>(id: string, ref: T) => void;
+    unregisterRef: (id: string) => void;
+    getSharedState: <T = any>(key: string) => T | undefined;
+    setSharedState: <T = any>(key: string, value: T) => void;
+    subscribeSharedState: <T = any>(key: string, callback: (value: T) => void) => () => void;
+}
+export interface DataSourceContainerContextType {
+    serverActions: HandleActionContextType;
+    refManager: RefManagerContextType;
+    form: AntdFormInstance;
+}
+export interface UseContainerContextReturnType {
+    serverActions: HandleActionContextType;
+    refManager: RefManagerContextType;
+    form: AntdFormInstance;
+    onValuesChange: (changedValues: Record<string, any>, allValues: Record<string, any>) => void;
+    [key: string]: any;
+}

package/lib/components/pisellDataSourceContainer/utils/formatData.d.ts

@@ -0,0 +1,9 @@
+declare const formatListResult: (result: any) => {
+    list: any;
+    count: any;
+};
+declare const formatListParams: (params: any) => {
+    page: any;
+    pageSize: any;
+};
+export { formatListParams, formatListResult };

package/lib/components/pisellDatePicker/datePickerCpt.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { PickerDateProps } from 'antd/es/date-picker/generatePicker';
 import { Dayjs } from 'dayjs';
 import './detePickerCpt.less';
@@ -18,5 +17,5 @@ export interface DatePickerCptProps extends PickerDateProps<Dayjs> {
  * @param props
  * @constructor
  */
-declare const DatePickerCpt: (props: DatePickerCptProps) => React.JSX.Element;
+declare const DatePickerCpt: (props: DatePickerCptProps) => JSX.Element;
 export default DatePickerCpt;

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

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

package/lib/components/pisellDateTimeDisplay/PisellDateTimeDisplay.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import 'dayjs/locale/zh-cn';
+import 'dayjs/locale/en';
+import type { PisellDateTimeDisplayProps } from './types';
+import './PisellDateTimeDisplay.less';
+/**
+ * PisellDateTimeDisplay 组件
+ *
+ * @description
+ * 专注于展示当前时间的组件，支持：
+ * - 当前日期、时间、星期展示
+ * - 多种布局方式（水平、垂直、单行）
+ * - 丰富的格式化配置
+ * - 自动刷新
+ * - 国际化支持
+ *
+ * @example
+ * // 基础用法
+ * <PisellDateTimeDisplay />
+ *
+ * // 自定义格式
+ * <PisellDateTimeDisplay
+ *   layout="vertical"
+ *   timeFormat={{ use12Hour: true, showSeconds: true }}
+ *   dateFormat={{ showYear: true, showChineseUnit: true }}
+ * />
+ *
+ * // 自定义格式化字符串
+ * <PisellDateTimeDisplay
+ *   customFormat="YYYY-MM-DD HH:mm:ss"
+ * />
+ */
+export declare const PisellDateTimeDisplay: React.FC<PisellDateTimeDisplayProps>;
+declare const _default: React.NamedExoticComponent<PisellDateTimeDisplayProps>;
+export default _default;

package/lib/components/pisellDateTimeDisplay/PisellDateTimeDisplay.js

@@ -41,9 +41,12 @@ var import_hooks = require("./hooks");
 var import_utils = require("./utils");
 var import_components = require("./components");
 var import_dateTimeDisplayFormats = require("./formats/dateTimeDisplayFormats");
+var import_useEngineContext = __toESM(require("../../hooks/useEngineContext"));
 var import_PisellDateTimeDisplay = require("./PisellDateTimeDisplay.less");
 var PisellDateTimeDisplay = (props) => {
+  var _a, _b;
   const {
+    value: valueProp,
     layout = "horizontal",
     textAlign = "center",
     fields,
@@ -65,7 +68,9 @@ var PisellDateTimeDisplay = (props) => {
     className,
     style
   } = props;
-  const localeKey = (0, import_utils.getDayjsLocale)(locale);
+  const context = (0, import_useEngineContext.default)();
+  const resolvedLocale = locale || ((_b = (_a = context == null ? void 0 : context.engine) == null ? void 0 : _a.props) == null ? void 0 : _b.locale) || "en";
+  const localeKey = (0, import_utils.getDayjsLocale)(resolvedLocale);
   const baseLocale = localeKey.split("-")[0];
   const presetSource = formatByLocale ?? import_dateTimeDisplayFormats.DATETIME_DISPLAY_FORMATS;
   const preset = presetSource[localeKey] ?? presetSource[baseLocale] ?? {};
@@ -76,12 +81,13 @@ var PisellDateTimeDisplay = (props) => {
   const computedRefreshInterval = refreshInterval ?? (0, import_utils.getRefreshInterval)(effectiveTimeFormat);
   const currentTime = (0, import_hooks.useCurrentTime)({
     refreshInterval: computedRefreshInterval,
-    disabled: disableAutoRefresh,
-    locale,
+    disabled: disableAutoRefresh || valueProp !== void 0,
+    locale: resolvedLocale,
     onUpdate: onTimeUpdate
   });
+  const displayTime = valueProp !== void 0 && valueProp !== null ? (0, import_dayjs.default)(valueProp).locale(localeKey) : currentTime;
   if (customFormat) {
-    const formattedTime = currentTime.format(customFormat);
+    const formattedTime = displayTime.format(customFormat);
     const containerInlineStyle2 = {
       background: containerStyle == null ? void 0 : containerStyle.background,
       borderRadius: containerStyle == null ? void 0 : containerStyle.borderRadius,
@@ -108,7 +114,7 @@ var PisellDateTimeDisplay = (props) => {
     fieldOrder = ["time", "date", "weekday"]
   } = effectiveFields || {};
   const referenceDate = (0, import_dayjs.default)();
-  const relativeDay = (effectiveDateFormat == null ? void 0 : effectiveDateFormat.showRelativeDay) ? (0, import_utils.getRelativeDay)(currentTime, referenceDate) : null;
+  const relativeDay = (effectiveDateFormat == null ? void 0 : effectiveDateFormat.showRelativeDay) ? (0, import_utils.getRelativeDay)(displayTime, referenceDate) : null;
   const hideWeekdayWhenDateRelative = showDate && relativeDay !== null;
   const containerInlineStyle = {
     background: containerStyle == null ? void 0 : containerStyle.background,
@@ -127,7 +133,7 @@ var PisellDateTimeDisplay = (props) => {
           import_components.TimeDisplay,
           {
             key: "time",
-            time: currentTime,
+            time: displayTime,
             format: effectiveTimeFormat,
             style: timeStyle
           }
@@ -137,7 +143,7 @@ var PisellDateTimeDisplay = (props) => {
           import_components.DateDisplay,
           {
             key: "date",
-            date: currentTime,
+            date: displayTime,
             format: effectiveDateFormat,
             referenceDate: (0, import_dayjs.default)(),
             style: dateStyle
@@ -148,7 +154,7 @@ var PisellDateTimeDisplay = (props) => {
           import_components.WeekdayDisplay,
           {
             key: "weekday",
-            weekday: currentTime,
+            weekday: displayTime,
             format: effectiveWeekdayFormat,
             style: weekdayStyle
           }
@@ -179,12 +185,12 @@ var PisellDateTimeDisplay = (props) => {
   }
   if (layout === "horizontal") {
     const timeField = showTime ? renderField("time") : null;
-    const currentLocale = currentTime.locale();
+    const currentLocale = displayTime.locale();
     const isChinese = (0, import_utils.isChinese)(currentLocale);
     if (showDate && showWeekday) {
       const labels = effectiveDateFormat == null ? void 0 : effectiveDateFormat.relativeDayLabels;
-      const dateStr = relativeDay ? (labels == null ? void 0 : labels[relativeDay]) ?? (0, import_utils.getRelativeDayLabel)(relativeDay, currentTime.locale()) : isChinese ? currentTime.format("M月D日") : currentTime.format("D MMM");
-      const weekdayStr = currentTime.format("ddd");
+      const dateStr = relativeDay ? (labels == null ? void 0 : labels[relativeDay]) ?? (0, import_utils.getRelativeDayLabel)(relativeDay, displayTime.locale()) : isChinese ? displayTime.format("M月D日") : displayTime.format("D MMM");
+      const weekdayStr = displayTime.format("ddd");
       const combinedStr = relativeDay ? dateStr : isChinese ? `${weekdayStr} ${dateStr}` : `${weekdayStr}, ${dateStr}`;
       const dateInlineStyle = {
         fontSize: dateStyle == null ? void 0 : dateStyle.fontSize,

package/lib/components/pisellDateTimeDisplay/PisellDateTimeDisplay.less

@@ -64,9 +64,10 @@
     line-height: 1.2;
   }
 
-  // 分隔符
+  // 分隔符：保留空格占位，避免纯空格时被折叠不显示
   &-separator {
     display: inline-block;
+    white-space: pre;
   }
 
   // 自定义格式化