feffery_antd_components 0.4.3-rc3 → 0.4.3-rc4

package/DESCRIPTION

@@ -1,6 +1,6 @@
 Package: fefferyAntdComponents
 Title: Best implementation of Antd components in Plotly Dash.
-Version: 0.4.3-rc3
+Version: 0.4.3-rc4
 Description: Best implementation of Antd components in Plotly Dash.
 Depends: R (>= 3.0.2)
 Imports: 

package/Project.toml

@@ -2,7 +2,7 @@
 name = "FefferyAntdComponents"
 uuid = "1b08a953-4be3-4667-9a23-674b58f7de79"
 authors = ["CNFeffery <fefferypzy@gmail.com>"]
-version = "0.4.3-rc3"
+version = "0.4.3-rc4"
 
 [deps]
 Dash = "1b08a953-4be3-4667-9a23-3db579824955"

package/README-en_US.md

@@ -33,7 +33,7 @@ pip install feffery-antd-components -U
 ## 2 Install the latest preview release version
 
 > [!NOTE]  
-> The latest preview release version (2025-10-23): `0.4.3rc3`
+> The latest preview release version (2025-11-19): `0.4.3rc4`
 
 ```bash
 pip install feffery-antd-components --pre -U

package/README.md

@@ -33,7 +33,7 @@ pip install feffery-antd-components -U
 ## 2 最新预发布版本安装方式
 
 > [!NOTE]  
-> 最新预发布版本（2025-10-23）：`0.4.3rc3`
+> 最新预发布版本（2025-11-19）：`0.4.3rc4`
 
 ```bash
 pip install feffery-antd-components --pre -U

package/feffery_antd_components/AntdConfigProvider.py

@@ -37,6 +37,16 @@ Keyword arguments:
     为内部组件设置快捷主题算法，支持多种主题组合，可选项有`'default'`、`'dark'`、`'compact'`
     默认值：`'default'`.
 
+- cssVar (dict; optional):
+    是否开启`CSS`变量模式，具体参考：https://ant-design.antgroup.com/docs/react/css-variables
+    默认值：`False`.
+
+    `cssVar` is a boolean | dict with keys:
+
+    - prefix (string; optional)
+
+    - key (string; optional)
+
 - useOldTheme (a value equal to: 'default', 'dark'; optional):
     是否强制使用`0.3.x`版本之前的主题样式，可选项有`'default'`、`'dark'`.
 
@@ -81,6 +91,14 @@ Keyword arguments:
     _base_nodes = ['children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdConfigProvider'
+    CssVar = TypedDict(
+        "CssVar",
+            {
+            "prefix": NotRequired[str],
+            "key": NotRequired[str]
+        }
+    )
+
     Token = TypedDict(
         "Token",
             {
@@ -102,6 +120,7 @@ Keyword arguments:
         id: typing.Optional[typing.Union[str, dict]] = None,
         key: typing.Optional[str] = None,
         algorithm: typing.Optional[typing.Union[Literal["default", "dark", "compact"], typing.Sequence[Literal["default", "dark", "compact"]]]] = None,
+        cssVar: typing.Optional[typing.Union[bool, "CssVar"]] = None,
         useOldTheme: typing.Optional[Literal["default", "dark"]] = None,
         primaryColor: typing.Optional[str] = None,
         componentDisabled: typing.Optional[bool] = None,
@@ -114,9 +133,9 @@ Keyword arguments:
         enableLayer: typing.Optional[bool] = None,
         **kwargs
     ):
-        self._prop_names = ['id', 'key', 'children', 'algorithm', 'useOldTheme', 'primaryColor', 'componentDisabled', 'componentSize', 'locale', 'wavesDisabled', 'token', 'componentsToken', 'compatibilityMode', 'enableLayer']
+        self._prop_names = ['id', 'key', 'children', 'algorithm', 'cssVar', 'useOldTheme', 'primaryColor', 'componentDisabled', 'componentSize', 'locale', 'wavesDisabled', 'token', 'componentsToken', 'compatibilityMode', 'enableLayer']
         self._valid_wildcard_attributes =            []
-        self.available_properties = ['id', 'key', 'children', 'algorithm', 'useOldTheme', 'primaryColor', 'componentDisabled', 'componentSize', 'locale', 'wavesDisabled', 'token', 'componentsToken', 'compatibilityMode', 'enableLayer']
+        self.available_properties = ['id', 'key', 'children', 'algorithm', 'cssVar', 'useOldTheme', 'primaryColor', 'componentDisabled', 'componentSize', 'locale', 'wavesDisabled', 'token', 'componentsToken', 'compatibilityMode', 'enableLayer']
         self.available_wildcard_properties =            []
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()

package/feffery_antd_components/AntdModal.py

@@ -92,6 +92,9 @@ Keyword arguments:
 - title (a list of or a singular dash component, string or number; optional):
     组件型，标题内容.
 
+- loadingTitle (a list of or a singular dash component, string or number; optional):
+    组件型，loading状态下的标题内容.
+
 - renderFooter (boolean; default False):
     是否渲染底部操作按钮  默认值：`False`.
 
@@ -238,8 +241,8 @@ Keyword arguments:
 
 - aria-* (string; optional):
     `aria-*`格式属性通配."""
-    _children_props = ['title', 'okText', 'cancelText', 'loadingOkText']
-    _base_nodes = ['title', 'okText', 'cancelText', 'loadingOkText', 'children']
+    _children_props = ['title', 'loadingTitle', 'okText', 'cancelText', 'loadingOkText']
+    _base_nodes = ['title', 'loadingTitle', 'okText', 'cancelText', 'loadingOkText', 'children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdModal'
     Styles = TypedDict(
@@ -317,6 +320,7 @@ Keyword arguments:
         locale: typing.Optional[Literal["zh-cn", "en-us", "de-de", "ru-ru"]] = None,
         visible: typing.Optional[bool] = None,
         title: typing.Optional[ComponentType] = None,
+        loadingTitle: typing.Optional[ComponentType] = None,
         renderFooter: typing.Optional[bool] = None,
         okText: typing.Optional[ComponentType] = None,
         okButtonProps: typing.Optional["OkButtonProps"] = None,
@@ -343,9 +347,9 @@ Keyword arguments:
         loading: typing.Optional[bool] = None,
         **kwargs
     ):
-        self._prop_names = ['id', 'key', 'children', 'style', 'className', 'styles', 'classNames', 'locale', 'visible', 'title', 'renderFooter', 'okText', 'okButtonProps', 'cancelText', 'cancelButtonProps', 'width', 'centered', 'keyboard', 'closable', 'mask', 'maskClosable', 'okClickClose', 'preventClose', 'zIndex', 'okCounts', 'cancelCounts', 'closeCounts', 'confirmAutoSpin', 'loadingOkText', 'confirmLoading', 'transitionType', 'forceRender', 'destroyOnClose', 'loading', 'data-*', 'aria-*']
+        self._prop_names = ['id', 'key', 'children', 'style', 'className', 'styles', 'classNames', 'locale', 'visible', 'title', 'loadingTitle', 'renderFooter', 'okText', 'okButtonProps', 'cancelText', 'cancelButtonProps', 'width', 'centered', 'keyboard', 'closable', 'mask', 'maskClosable', 'okClickClose', 'preventClose', 'zIndex', 'okCounts', 'cancelCounts', 'closeCounts', 'confirmAutoSpin', 'loadingOkText', 'confirmLoading', 'transitionType', 'forceRender', 'destroyOnClose', 'loading', 'data-*', 'aria-*']
         self._valid_wildcard_attributes =            ['data-', 'aria-']
-        self.available_properties = ['id', 'key', 'children', 'style', 'className', 'styles', 'classNames', 'locale', 'visible', 'title', 'renderFooter', 'okText', 'okButtonProps', 'cancelText', 'cancelButtonProps', 'width', 'centered', 'keyboard', 'closable', 'mask', 'maskClosable', 'okClickClose', 'preventClose', 'zIndex', 'okCounts', 'cancelCounts', 'closeCounts', 'confirmAutoSpin', 'loadingOkText', 'confirmLoading', 'transitionType', 'forceRender', 'destroyOnClose', 'loading', 'data-*', 'aria-*']
+        self.available_properties = ['id', 'key', 'children', 'style', 'className', 'styles', 'classNames', 'locale', 'visible', 'title', 'loadingTitle', 'renderFooter', 'okText', 'okButtonProps', 'cancelText', 'cancelButtonProps', 'width', 'centered', 'keyboard', 'closable', 'mask', 'maskClosable', 'okClickClose', 'preventClose', 'zIndex', 'okCounts', 'cancelCounts', 'closeCounts', 'confirmAutoSpin', 'loadingOkText', 'confirmLoading', 'transitionType', 'forceRender', 'destroyOnClose', 'loading', 'data-*', 'aria-*']
         self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()

package/feffery_antd_components/AntdNotification.py

@@ -33,10 +33,10 @@ Keyword arguments:
 - className (string | dict; optional):
     当前组件css类名，支持[动态css](/advanced-classname).
 
-- message (string; optional):
+- message (a list of or a singular dash component, string or number; optional):
     通知提醒主要信息.
 
-- description (string; optional):
+- description (a list of or a singular dash component, string or number; optional):
     通知提醒描述信息.
 
 - type (a value equal to: 'default', 'success', 'error', 'info', 'warning'; default 'default'):
@@ -86,10 +86,14 @@ Keyword arguments:
     - danger (boolean; optional):
         按钮是否呈现危险状态  默认值：`False`.
 
-- stack (boolean; default False):
-    是否开启多通知自动折叠堆叠功能  默认值：`False`."""
-    _children_props = []
-    _base_nodes = ['children']
+- stack (dict; default False):
+    是否开启多通知自动折叠堆叠功能  默认值：`False`.
+
+    `stack` is a boolean | dict with keys:
+
+    - threshold (number; optional)"""
+    _children_props = ['message', 'description']
+    _base_nodes = ['message', 'description', 'children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdNotification'
     CloseButton = TypedDict(
@@ -103,6 +107,13 @@ Keyword arguments:
         }
     )
 
+    Stack = TypedDict(
+        "Stack",
+            {
+            "threshold": NotRequired[NumberType]
+        }
+    )
+
 
     def __init__(
         self,
@@ -110,8 +121,8 @@ Keyword arguments:
         key: typing.Optional[str] = None,
         style: typing.Optional[typing.Any] = None,
         className: typing.Optional[typing.Union[str, dict]] = None,
-        message: typing.Optional[str] = None,
-        description: typing.Optional[str] = None,
+        message: typing.Optional[ComponentType] = None,
+        description: typing.Optional[ComponentType] = None,
         type: typing.Optional[Literal["default", "success", "error", "info", "warning"]] = None,
         placement: typing.Optional[Literal["top", "bottom", "topLeft", "topRight", "bottomLeft", "bottomRight"]] = None,
         top: typing.Optional[NumberType] = None,
@@ -121,7 +132,7 @@ Keyword arguments:
         pauseOnHover: typing.Optional[bool] = None,
         closable: typing.Optional[bool] = None,
         closeButton: typing.Optional["CloseButton"] = None,
-        stack: typing.Optional[bool] = None,
+        stack: typing.Optional[typing.Union[bool, "Stack"]] = None,
         **kwargs
     ):
         self._prop_names = ['id', 'key', 'style', 'className', 'message', 'description', 'type', 'placement', 'top', 'bottom', 'duration', 'showProgress', 'pauseOnHover', 'closable', 'closeButton', 'stack']

package/feffery_antd_components/AntdTable.py

@@ -254,13 +254,37 @@ Keyword arguments:
         适用于`'tags'`模式，标签颜色.
 
     - tag (string | number; optional):
-        适用于`'tags'`模式，标签内容. | list of dicts with keys:
+        适用于`'tags'`模式，标签内容.
+
+    - tooltip (dict; optional):
+        适用于`'tags'`模式，为当前标签添加额外的文字提示功能.
+
+        `tooltip` is a dict with keys:
+
+        - title (string; optional):
+            文字提示内容.
+
+        - placement (a value equal to: 'top', 'left', 'right', 'bottom', 'topLeft', 'topRight', 'bottomLeft', 'bottomRight'; optional):
+            文字提示弹出方向，可选项有`'top'`、`'left'`、`'right'`、`'bottom'`、`'topLeft'`、`'topRight'`、`'bottomLeft'`、`'bottomRight'`、`'leftTop'`、`'leftBottom'`、`'rightTop'`、`'rightBottom'`
+            默认值：`'top'`. | list of dicts with keys:
 
     - color (string; optional):
         适用于`'tags'`模式，当前标签颜色.
 
     - tag (string | number; optional):
-        适用于`'tags'`模式，当前标签内容. | dict with keys:
+        适用于`'tags'`模式，当前标签内容.
+
+    - tooltip (dict; optional):
+        适用于`'tags'`模式，为当前标签添加额外的文字提示功能.
+
+        `tooltip` is a dict with keys:
+
+        - title (string; optional):
+            文字提示内容.
+
+        - placement (a value equal to: 'top', 'left', 'right', 'bottom', 'topLeft', 'topRight', 'bottomLeft', 'bottomRight'; optional):
+            文字提示弹出方向，可选项有`'top'`、`'left'`、`'right'`、`'bottom'`、`'topLeft'`、`'topRight'`、`'bottomLeft'`、`'bottomRight'`、`'leftTop'`、`'leftBottom'`、`'rightTop'`、`'rightBottom'`
+            默认值：`'top'`. | dict with keys:
 
     - disabled (boolean; optional):
         适用于`'button'`模式，同`AntdButton`中的同名参数.
@@ -603,17 +627,19 @@ Keyword arguments:
 - recentlyMouseEnterRow (dict; optional):
     当`enableHoverListen=True`时，监听最近一次鼠标移入的行数据信息.
 
-- titlePopoverInfo (dict; optional):
+- titlePopoverInfo (list of dicts; optional):
     配置各字段标题额外气泡说明卡片信息相关参数.
 
-    `titlePopoverInfo` is a dict with strings as keys and values of
-    type dict with keys:
+    `titlePopoverInfo` is a list of dicts with keys:
 
-    - title (string; optional):
-        气泡卡片标题.
+    - dataIndex (string; required):
+        必填，对应字段的dataIndex.
 
-    - content (string; optional):
-        气泡卡片内容.
+    - title (a list of or a singular dash component, string or number; optional):
+        气泡卡片标题，支持字符串或组件型.
+
+    - content (a list of or a singular dash component, string or number; optional):
+        气泡卡片内容，支持字符串或组件型.
 
     - placement (a value equal to: 'top', 'left', 'right', 'bottom', 'topLeft', 'topRight', 'bottomLeft', 'bottomRight', 'leftTop', 'leftBottom', 'rightTop', 'rightBottom'; optional):
         气泡卡片弹出方位，可选项有`'top'`、`'left'`、`'right'`、`'bottom'`、`'topLeft'`、`'topRight'`、`'bottomLeft'`、`'bottomRight'`、`'leftTop'`、`'leftBottom'`、`'rightTop'`、`'rightBottom'`
@@ -1018,7 +1044,7 @@ Keyword arguments:
 
 - aria-* (string; optional):
     `aria-*`格式属性通配."""
-    _children_props = ['columns[].title', 'data[]{}', 'summaryRowContents[].content', 'expandedRowKeyToContent[].content', 'emptyContent', 'title', 'footer']
+    _children_props = ['columns[].title', 'data[]{}', 'titlePopoverInfo[].title', 'titlePopoverInfo[].content', 'summaryRowContents[].content', 'expandedRowKeyToContent[].content', 'emptyContent', 'title', 'footer']
     _base_nodes = ['emptyContent', 'title', 'footer', 'children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdTable'
@@ -1141,20 +1167,20 @@ Keyword arguments:
         }
     )
 
-    DataPopConfirmProps = TypedDict(
-        "DataPopConfirmProps",
+    DataTooltip = TypedDict(
+        "DataTooltip",
             {
             "title": NotRequired[str],
-            "okText": NotRequired[str],
-            "cancelText": NotRequired[str]
+            "placement": NotRequired[Literal["top", "left", "right", "bottom", "topLeft", "topRight", "bottomLeft", "bottomRight"]]
         }
     )
 
-    DataTooltip = TypedDict(
-        "DataTooltip",
+    DataPopConfirmProps = TypedDict(
+        "DataPopConfirmProps",
             {
             "title": NotRequired[str],
-            "placement": NotRequired[Literal["top", "left", "right", "bottom", "topLeft", "topRight", "bottomLeft", "bottomRight"]]
+            "okText": NotRequired[str],
+            "cancelText": NotRequired[str]
         }
     )
 
@@ -1190,8 +1216,9 @@ Keyword arguments:
     TitlePopoverInfo = TypedDict(
         "TitlePopoverInfo",
             {
-            "title": NotRequired[str],
-            "content": NotRequired[str],
+            "dataIndex": str,
+            "title": NotRequired[ComponentType],
+            "content": NotRequired[ComponentType],
             "placement": NotRequired[Literal["top", "left", "right", "bottom", "topLeft", "topRight", "bottomLeft", "bottomRight", "leftTop", "leftBottom", "rightTop", "rightBottom"]],
             "overlayStyle": NotRequired[dict]
         }
@@ -1349,7 +1376,7 @@ Keyword arguments:
         recentlyMouseEnterColumnDataIndex: typing.Optional[str] = None,
         recentlyMouseEnterRowKey: typing.Optional[typing.Union[str, NumberType]] = None,
         recentlyMouseEnterRow: typing.Optional[dict] = None,
-        titlePopoverInfo: typing.Optional[typing.Dict[typing.Union[str, float, int], "TitlePopoverInfo"]] = None,
+        titlePopoverInfo: typing.Optional[typing.Sequence["TitlePopoverInfo"]] = None,
         columnsFormatConstraint: typing.Optional[typing.Dict[typing.Union[str, float, int], "ColumnsFormatConstraint"]] = None,
         sortOptions: typing.Optional["SortOptions"] = None,
         showSorterTooltip: typing.Optional[bool] = None,