@pisell/materials 6.3.26 → 6.3.28

package/es/components/page/index.js

@@ -18,6 +18,8 @@ import enUS from 'antd/es/locale/en_US';
 import zhCN from 'antd/es/locale/zh_CN';
 import zhTW from 'antd/es/locale/zh_TW';
 import zhHK from 'antd/es/locale/zh_HK';
+import jaJP from 'antd/es/locale/ja_JP';
+import ptPT from 'antd/es/locale/pt_PT';
 import PisellConfigProvider from "../pisell-config-provider";
 import useEngineContext from "../../hooks/useEngineContext";
 import { getThemeConfig } from "../../theme/tokens";
@@ -26,7 +28,9 @@ var localMap = {
   'zh-CN': zhCN,
   'zh-HK': zhHK,
   'en-US': enUS,
-  en: enUS
+  en: enUS,
+  'ja': jaJP,
+  'pt': ptPT
 };
 var localeDateMap = {
   'en-US': {
@@ -43,6 +47,12 @@ var localeDateMap = {
   },
   'zh-CN': {
     adapterLocale: 'zh-cn'
+  },
+  'ja': {
+    adapterLocale: 'ja'
+  },
+  'pt': {
+    adapterLocale: 'pt'
   }
 };
 var Page = function Page(props) {

package/es/components/page-header/index.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import './index.less';
+interface PageHeaderProps {
+    title?: React.ReactNode;
+    showTitle?: boolean;
+    subTitle?: React.ReactNode;
+    showSubTitle?: boolean;
+    showDivider?: boolean;
+    extra?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const PageHeader: (props: PageHeaderProps) => React.JSX.Element | null;
+export default PageHeader;

package/es/components/pisellAdjustPrice/status.d.ts

@@ -0,0 +1,32 @@
+export declare const defaultConfig: {
+    dark: {
+        backgroundColor: string;
+        containerBackgroundColor: string;
+        buttonBackgroundColor: string;
+        textColor: string;
+        resetButtonBackgroundColor: string;
+        resetButtonTextColor: string;
+        isDoneButtonFollowTheme: boolean;
+        doneButtonBackgroundColor: string;
+        doneButtonTextColor: string;
+        isShowMainText: boolean;
+        mainTextColor: string;
+        isShowSubText: boolean;
+        subTextColor: string;
+    };
+    light: {
+        backgroundColor: string;
+        containerBackgroundColor: string;
+        buttonBackgroundColor: string;
+        textColor: string;
+        resetButtonBackgroundColor: string;
+        resetButtonTextColor: string;
+        isDoneButtonFollowTheme: boolean;
+        doneButtonBackgroundColor: string;
+        doneButtonTextColor: string;
+        isShowMainText: boolean;
+        mainTextColor: string;
+        isShowSubText: boolean;
+        subTextColor: string;
+    };
+};

package/es/components/pisellAlert/index.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import { AlertProps } from 'antd';
+import './index.less';
+export interface PisellAlertProps extends AlertProps {
+    /** 是否展示忽略按钮 */
+    showDismiss?: boolean;
+    /** 忽略按钮内容 */
+    dismiss?: React.ReactNode;
+    /** 是否展示行为按钮 */
+    showView?: boolean;
+    /** 行为按钮内容 */
+    view?: React.ReactNode;
+    /** 行为按钮点击事件 */
+    onViewClick?: (e: any) => void;
+}
+/**
+ * PisellAlert警告提示组件
+ * @param props
+ * @constructor
+ */
+declare const PisellAlert: (props: PisellAlertProps) => false | React.JSX.Element;
+export default PisellAlert;

package/es/components/pisellAnchor/index.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import './index.less';
+export interface Option {
+    id: string | number;
+    name: React.ReactNode;
+}
+export interface PisellAnchorProps {
+    options?: Option[];
+    tab?: string | number;
+    className?: string;
+    style?: React.CSSProperties;
+    onChange?: (key: string | number) => void;
+    onTabClick?: () => void;
+    containerRef?: React.RefObject<HTMLElement>;
+    /**
+     * 平台类型，仅用于样式调整，不再影响锚点滚动功能
+     * 无论pc还是h5模式，点击锚点都会自动滚动到对应内容
+     * @default 'pc'
+     */
+    platform?: 'pc' | 'h5';
+}
+declare const PisellAnchor: React.FC<PisellAnchorProps>;
+export default PisellAnchor;

package/es/components/pisellAppCard/PisellAppCard.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { PisellAppCardProps } from './types';
+import './PisellAppCard.less';
+declare const PisellAppCard: React.FC<PisellAppCardProps>;
+export default PisellAppCard;

package/es/components/pisellAppCard/index.d.ts

@@ -0,0 +1,3 @@
+import PisellAppCard from './PisellAppCard';
+export default PisellAppCard;
+export type { PisellAppCardProps } from './types';

package/es/components/pisellAppCard/types.d.ts

@@ -0,0 +1,34 @@
+import { CSSProperties } from 'react';
+export interface PisellAppCardProps {
+    /** 类名 */
+    className?: string;
+    /** 样式 */
+    style?: CSSProperties;
+    /** 头像地址 */
+    avatar?: string;
+    /** icon */
+    icon?: string;
+    /** 标签列表 */
+    tags?: Array<{
+        label: string;
+        color?: 'success' | 'warning' | 'error' | 'gray';
+        type: 'pill_color' | 'pill_outline';
+    }>;
+    /** 标题 */
+    title: string;
+    /** 描述 */
+    description?: string;
+    /** 底部按钮列表 */
+    bottomButtons?: Array<{
+        label: string;
+        onClick?: () => void;
+        type?: 'primary' | 'default' | 'dashed' | 'link' | 'text';
+        hidden: boolean;
+    }>;
+    /** 右侧更多操作列表 */
+    moreActions?: Array<{
+        label: string;
+        onClick?: () => void;
+        icon?: React.ReactNode;
+    }>;
+}

package/es/components/pisellAvatar/index.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { AvatarProps } from 'antd';
+import './index.less';
+export declare type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+export interface PisellAvatarProps extends Omit<AvatarProps, 'size' | 'shape'> {
+    shape?: 'circle' | 'square';
+    size?: AvatarSize;
+    src?: string;
+    alt?: string;
+    icon?: React.ReactNode;
+    children?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    useTextAvatar?: boolean;
+    borderRadius?: number;
+    onError?: () => boolean;
+}
+declare const PisellAvatar: React.FC<PisellAvatarProps>;
+export default PisellAvatar;

package/es/components/pisellBatchActionBar/PisellBatchActionBar.js

@@ -19,9 +19,19 @@ import classNames from 'classnames';
 import { Popconfirm, Modal, Popover } from 'antd';
 import PisellBasicGrid from "../PisellBasicGrid";
 import GraphicTextCard from "../PisellCards/components/GraphicTextCard";
+import { locales as utilsLocales } from '@pisell/utils';
 import { getText } from "../../locales";
 import "./PisellBatchActionBar.less";
 
+/** 优先 utils；若 utils 返回 key（未命中）则用 materials RecordBoard 再回退 batch-action-bar-* */
+function getBatchBarText(key) {
+  var _getText;
+  var fullKey = "pisell2.salesManagement.batchActionBar.".concat(key);
+  var fromUtils = utilsLocales.getText(fullKey);
+  if (fromUtils !== fullKey) return fromUtils;
+  return (_getText = getText(fullKey)) !== null && _getText !== void 0 ? _getText : getText("batch-action-bar-".concat(key));
+}
+
 /**
  * PisellBatchActionBar 批量操作栏组件
  *
@@ -72,7 +82,7 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
     _props$overflowThresh = props.overflowThreshold,
     overflowThreshold = _props$overflowThresh === void 0 ? 5 : _props$overflowThresh,
     _props$moreText = props.moreText,
-    moreText = _props$moreText === void 0 ? getText('batch-action-bar-more') : _props$moreText,
+    moreText = _props$moreText === void 0 ? getBatchBarText('more') : _props$moreText,
     onSelectAll = props.onSelectAll,
     onClear = props.onClear,
     onInvert = props.onInvert,
@@ -166,8 +176,8 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
       return selectedCountText.replace('{count}', String(count));
     }
 
-    // 使用国际化文本，如果返回的是函数则调用它
-    var i18nText = getText('batch-action-bar-selected-count');
+    // 优先 utils locales，无则 materials getText
+    var i18nText = getBatchBarText('selectedCount');
     if (typeof i18nText === 'function') {
       return i18nText(count);
     }
@@ -191,7 +201,7 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
     if ((defaultActions === null || defaultActions === void 0 ? void 0 : defaultActions.showSelectAll) !== false) {
       defaultActionNodes.push( /*#__PURE__*/React.createElement(GraphicTextCard, {
         key: "select-all",
-        text: getText('batch-action-bar-select-all'),
+        text: getBatchBarText('selectAll'),
         icon: "pisell2-check-square",
         variant: "horizontal",
         size: "small",
@@ -228,7 +238,7 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
     if ((defaultActions === null || defaultActions === void 0 ? void 0 : defaultActions.showInvert) !== false) {
       defaultActionNodes.push( /*#__PURE__*/React.createElement(GraphicTextCard, {
         key: "invert",
-        text: getText('batch-action-bar-invert'),
+        text: getBatchBarText('invert'),
         icon: "pisell2-check-done-01",
         variant: "horizontal",
         size: "small",
@@ -265,7 +275,7 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
     if ((defaultActions === null || defaultActions === void 0 ? void 0 : defaultActions.showClear) !== false) {
       defaultActionNodes.push( /*#__PURE__*/React.createElement(GraphicTextCard, {
         key: "clear",
-        text: getText('batch-action-bar-clear'),
+        text: getBatchBarText('clear'),
         icon: "pisell2-square",
         variant: "horizontal",
         size: "small",
@@ -302,7 +312,7 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
     if ((defaultActions === null || defaultActions === void 0 ? void 0 : defaultActions.showDelete) !== false) {
       defaultActionNodes.push( /*#__PURE__*/React.createElement(GraphicTextCard, {
         key: "delete",
-        text: getText('batch-action-bar-delete'),
+        text: getBatchBarText('delete'),
         icon: "pisell2-delete_wght300_24px",
         variant: "horizontal",
         size: "small",
@@ -328,6 +338,7 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
           height: '48px'
         },
         onClick: function onClick() {
+          var _deleteConfirmConfig$, _deleteConfirmConfig$2, _deleteConfirmConfig$3, _deleteConfirmConfig$4;
           // 防止重复点击弹出多个 Modal
           if (isDeleteModalOpenRef.current) {
             return;
@@ -337,18 +348,13 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
           isDeleteModalOpenRef.current = true;
 
           // 显示确认弹窗
-          var deleteContent = function () {
-            var i18nContent = getText('batch-action-bar-delete-confirm-content');
-            if (typeof i18nContent === 'function') {
-              return i18nContent(selectionState.selectedCount);
-            }
-            return i18nContent || "\u786E\u5B9A\u8981\u5220\u9664\u9009\u4E2D\u7684 ".concat(selectionState.selectedCount, " \u9879\u5417\uFF1F");
-          }();
+          var i18nContent = getBatchBarText('deleteConfirmContent');
+          var deleteContent = typeof i18nContent === 'function' ? i18nContent(selectionState.selectedCount) : i18nContent || "\u786E\u5B9A\u8981\u5220\u9664\u9009\u4E2D\u7684 ".concat(selectionState.selectedCount, " \u9879\u5417\uFF1F");
           Modal.confirm({
-            title: (deleteConfirmConfig === null || deleteConfirmConfig === void 0 ? void 0 : deleteConfirmConfig.title) || getText('batch-action-bar-delete-confirm-title'),
-            content: (deleteConfirmConfig === null || deleteConfirmConfig === void 0 ? void 0 : deleteConfirmConfig.description) || deleteContent,
-            okText: (deleteConfirmConfig === null || deleteConfirmConfig === void 0 ? void 0 : deleteConfirmConfig.okText) || getText('batch-action-bar-delete-confirm-ok'),
-            cancelText: (deleteConfirmConfig === null || deleteConfirmConfig === void 0 ? void 0 : deleteConfirmConfig.cancelText) || getText('batch-action-bar-delete-confirm-cancel'),
+            title: (_deleteConfirmConfig$ = deleteConfirmConfig === null || deleteConfirmConfig === void 0 ? void 0 : deleteConfirmConfig.title) !== null && _deleteConfirmConfig$ !== void 0 ? _deleteConfirmConfig$ : getBatchBarText('deleteConfirmTitle'),
+            content: (_deleteConfirmConfig$2 = deleteConfirmConfig === null || deleteConfirmConfig === void 0 ? void 0 : deleteConfirmConfig.description) !== null && _deleteConfirmConfig$2 !== void 0 ? _deleteConfirmConfig$2 : deleteContent,
+            okText: (_deleteConfirmConfig$3 = deleteConfirmConfig === null || deleteConfirmConfig === void 0 ? void 0 : deleteConfirmConfig.okText) !== null && _deleteConfirmConfig$3 !== void 0 ? _deleteConfirmConfig$3 : getBatchBarText('deleteConfirmOk'),
+            cancelText: (_deleteConfirmConfig$4 = deleteConfirmConfig === null || deleteConfirmConfig === void 0 ? void 0 : deleteConfirmConfig.cancelText) !== null && _deleteConfirmConfig$4 !== void 0 ? _deleteConfirmConfig$4 : getBatchBarText('deleteConfirmCancel'),
             okButtonProps: {
               danger: true
             },
@@ -402,7 +408,7 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
     }) : visibleActions;
     return sortedActions.map(function (action) {
       var disabled = typeof action.disabled === 'function' ? action.disabled(selectedKeys, selectedRows) : action.disabled || false;
-      var card = /*#__PURE__*/React.createElement(GraphicTextCard, _defineProperty(_defineProperty({
+      var card = /*#__PURE__*/React.createElement(GraphicTextCard, {
         key: action.key,
         text: action.label,
         icon: action.icon,
@@ -432,20 +438,21 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
           padding: '8px 12px',
           minWidth: '120px',
           height: '48px'
-        }, action.style)
-      }, "className", action.className), "onClick", function onClick() {
-        return handleActionClick(action);
-      }));
+        }, action.style),
+        onClick: function onClick() {
+          return handleActionClick(action);
+        }
+      });
 
       // 如果需要确认弹窗
       if (action.confirm) {
         var confirmConfig = _typeof(action.confirm) === 'object' ? action.confirm : {};
         return /*#__PURE__*/React.createElement(Popconfirm, {
           key: action.key,
-          title: confirmConfig.title || getText('batch-action-bar-confirm-title'),
+          title: confirmConfig.title || getBatchBarText('confirmTitle'),
           description: confirmConfig.description,
-          okText: confirmConfig.okText || getText('batch-action-bar-delete-confirm-ok'),
-          cancelText: confirmConfig.cancelText || getText('batch-action-bar-delete-confirm-cancel'),
+          okText: confirmConfig.okText || getBatchBarText('deleteConfirmOk'),
+          cancelText: confirmConfig.cancelText || getBatchBarText('deleteConfirmCancel'),
           onConfirm: function onConfirm() {
             return handleActionClick(action);
           }
@@ -500,9 +507,11 @@ var PisellBatchActionBar = function PisellBatchActionBar(props) {
     // 克隆溢出按钮并修改样式
     var modifiedOverflowActions = overflowActions.map(function (action) {
       if ( /*#__PURE__*/React.isValidElement(action)) {
-        var _action$props;
-        return /*#__PURE__*/React.cloneElement(action, {
-          style: _objectSpread(_objectSpread({}, ((_action$props = action.props) === null || _action$props === void 0 ? void 0 : _action$props.style) || {}), {}, {
+        var _el$props;
+        var el = action;
+        var prevStyle = (_el$props = el.props) === null || _el$props === void 0 ? void 0 : _el$props.style;
+        return /*#__PURE__*/React.cloneElement(el, {
+          style: _objectSpread(_objectSpread({}, prevStyle || {}), {}, {
             minWidth: '160px',
             width: '160px'
           })

package/es/components/pisellBatchActionBar/types.d.ts

@@ -0,0 +1,237 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 布局模式
+ */
+export declare type BatchActionBarPosition = 'sticky-top' | 'sticky-bottom' | 'float' | 'inline';
+/**
+ * 确认弹窗配置
+ */
+export interface BatchActionConfirmConfig {
+    /**
+     * 弹窗标题
+     */
+    title?: string;
+    /**
+     * 弹窗描述内容
+     */
+    description?: string;
+    /**
+     * 确认按钮文案
+     */
+    okText?: string;
+    /**
+     * 取消按钮文案
+     */
+    cancelText?: string;
+}
+/**
+ * 默认操作按钮配置
+ * @description 固定四个基础操作按钮：全选、反选、取消选择、删除
+ */
+export interface DefaultActionsConfig {
+    /**
+     * 是否显示默认操作按钮（全选、反选、取消选择、删除）
+     * @default true
+     */
+    showDefaultActions?: boolean;
+    /**
+     * 是否显示全选按钮
+     * @default true
+     */
+    showSelectAll?: boolean;
+    /**
+     * 是否显示反选按钮
+     * @default true
+     */
+    showInvert?: boolean;
+    /**
+     * 是否显示取消选择按钮
+     * @default true
+     */
+    showClear?: boolean;
+    /**
+     * 是否显示删除按钮
+     * @default true
+     */
+    showDelete?: boolean;
+}
+/**
+ * 自定义操作按钮配置
+ */
+export interface BatchActionItem {
+    /**
+     * 操作唯一标识
+     */
+    key: string;
+    /**
+     * 按钮文案
+     */
+    label: ReactNode;
+    /**
+     * 按钮图标
+     */
+    icon?: ReactNode;
+    /**
+     * 按钮尺寸
+     * @description 对应 GraphicTextCard 的 size 属性
+     * @default 'small'
+     */
+    size?: 'small' | 'default' | 'large';
+    /**
+     * 是否禁用
+     * @description 支持函数形式，基于 selection 动态判断
+     */
+    disabled?: boolean | ((selectedKeys: React.Key[], selectedRows?: any[]) => boolean);
+    /**
+     * 是否显示
+     * @description 支持函数形式，基于 selection 动态判断
+     * @default true
+     */
+    visible?: boolean | ((selectedKeys: React.Key[], selectedRows?: any[]) => boolean);
+    /**
+     * 是否显示 loading 状态
+     */
+    loading?: boolean;
+    /**
+     * 是否需要确认弹窗
+     * @default false
+     */
+    confirm?: boolean | BatchActionConfirmConfig;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 按钮组标识
+     * @description 相同 group 的按钮会分组展示
+     */
+    group?: string;
+    /**
+     * 按钮点击回调
+     * @description 如果配置了此回调，会优先使用此回调，否则使用组件级别的 onActionClick
+     */
+    onClick?: (selectedKeys: React.Key[], selectedRows?: any[]) => void | Promise<void>;
+}
+/**
+ * PisellBatchActionBar 组件 Props
+ * @description 批量操作栏组件，用于承载基于选中对象的批量行为操作
+ */
+export interface PisellBatchActionBarProps {
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * 选中的 key 数组
+     * @description 必填，用于感知选择状态
+     */
+    selectedKeys: React.Key[];
+    /**
+     * 选中的行数据数组
+     * @description 可选，用于传递给操作回调
+     */
+    selectedRows?: any[];
+    /**
+     * 总数据量
+     * @description 用于判断全选状态
+     */
+    total?: number;
+    /**
+     * 当前页数据量
+     * @description 用于判断全选当前页状态
+     */
+    currentPageTotal?: number;
+    /**
+     * 当前页数据 key 数组
+     * @description 用于判断全选当前页状态
+     */
+    currentPageKeys?: React.Key[];
+    /**
+     * 布局模式
+     * @default 'float'
+     */
+    position?: BatchActionBarPosition;
+    /**
+     * 吸顶/吸底时的偏移量
+     * @default 0
+     */
+    offset?: number;
+    /**
+     * 是否显示选中数量提示
+     * @default true
+     */
+    showSelectedCount?: boolean;
+    /**
+     * 选中数量提示文案
+     * @description 支持字符串模板（使用 {count} 占位符）或函数形式，默认使用国际化文本
+     * @default getText('batch-action-bar-selected-count', count)
+     */
+    selectedCountText?: string | ((count: number) => string);
+    /**
+     * 默认操作按钮配置
+     * @description 只包含前三个基础选择操作按钮，其他操作按钮通过 actions 传入
+     */
+    defaultActions?: DefaultActionsConfig;
+    /**
+     * 自定义操作按钮配置
+     */
+    actions?: BatchActionItem[];
+    /**
+     * 操作按钮排序
+     * @description 通过 key 数组控制按钮顺序
+     */
+    actionOrder?: string[];
+    /**
+     * 是否启用溢出折叠
+     * @default true
+     */
+    enableOverflow?: boolean;
+    /**
+     * 溢出折叠阈值（按钮数量）
+     * @default 5
+     */
+    overflowThreshold?: number;
+    /**
+     * "更多"按钮文案
+     * @description 默认使用国际化文本
+     * @default getText('batch-action-bar-more')
+     */
+    moreText?: string;
+    /**
+     * 全选回调
+     */
+    onSelectAll?: () => void;
+    /**
+     * 反选回调
+     * @description 反选操作，将当前选中的变为未选中，未选中的变为选中
+     */
+    onInvert?: () => void;
+    /**
+     * 清空选择回调
+     */
+    onClear?: () => void;
+    /**
+     * 删除回调
+     * @description 删除选中项，点击后会先弹出确认弹窗
+     */
+    onDelete?: (selectedKeys: React.Key[], selectedRows?: any[]) => void;
+    /**
+     * 删除确认弹窗配置
+     * @description 自定义删除确认弹窗的标题和内容
+     */
+    deleteConfirmConfig?: BatchActionConfirmConfig;
+    /**
+     * 自定义操作按钮点击回调
+     * @description 当 actions 中的按钮被点击时触发，通过 action.key 区分不同的操作
+     * @description 如果 action 中配置了 onClick，则优先使用 action.onClick
+     */
+    onActionClick?: (key: string, selectedKeys: React.Key[], selectedRows?: any[]) => void | Promise<void>;
+}

package/es/components/pisellCard/index.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { CardProps } from 'antd';
+import './index.less';
+export interface PisellCardProps extends CardProps {
+    bordered?: boolean;
+    selected?: boolean;
+    loading?: boolean;
+    padding?: number;
+    borderRadius?: number;
+    disabled?: boolean;
+    onClick?: () => void;
+    isClickable?: boolean;
+}
+/**
+ * Pisell 卡片容器组件
+ * @param props
+ * @constructor
+ */
+declare const PisellCard: (props: PisellCardProps) => React.JSX.Element;
+export default PisellCard;

package/es/components/pisellCheckboxGroup/mock.d.ts

@@ -0,0 +1,4 @@
+export declare const mockList: {
+    label: string;
+    value: string;
+}[];

package/es/components/pisellCountdown/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 格式化时间字符串函数
+ * 该函数将给定的持续时间（以秒为单位）格式化为指定格式的时间字符串
+ * @param duration - 持续时间，单位为秒。
+ * @param format - 时间格式字符串，其中包含要显示的时间单位及其格式。例如："[HH] hours, [mm] minutes, [ss] seconds"。
+ */
+export declare function formatTimeStr(duration: number, format: string): string;