feffery_antd_components 0.4.3-rc6 → 0.4.3

package/package.json

@@ -1,97 +1,112 @@
-{
-    "name": "feffery_antd_components",
-    "version": "0.4.3-rc6",
-    "description": "Best implementation of Antd components in Plotly Dash.",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/CNFeffery/feffery-antd-components.git"
-    },
-    "bugs": {
-        "url": "https://github.com/CNFeffery/feffery-antd-components/issues"
-    },
-    "homepage": "http://fac.feffery.tech/",
-    "main": "build/index.js",
-    "scripts": {
-        "start": "webpack-serve --config ./webpack.serve.config.js --open",
-        "build:js": "webpack --mode production",
-        "build:backends": "dash-generate-components ./src/lib/components feffery_antd_components --keep-prop-order ALL -p package-info.json --r-prefix 'feffery' --jl-prefix 'feffery'",
-        "build:backends-activated": "(. venv/bin/activate || venv\\scripts\\activate && npm run build:py_and_r)",
-        "build": "npm run build:js && npm run build:backends",
-        "build:activated": "npm run build:js && npm run build:backends-activated"
-    },
-    "author": "CNFeffery <fefferypzy@gmail.com>",
-    "email": "fefferypzy@gmail.com",
-    "license": "MIT",
-    "dependencies": {
-        "@ant-design/charts": "^1.4.2",
-        "@ant-design/compatible": "^5.0.0",
-        "@ant-design/happy-work-theme": "^1.0.0",
-        "@ant-design/icons": "^5.0.0",
-        "@ant-design/pro-components": "^2.6.49",
-        "@formily/antd-v5": "^1.2.0",
-        "@formily/core": "^2.3.1",
-        "@formily/react": "^2.3.1",
-        "@plotly/webpack-dash-dynamic-import": "^1.3.0",
-        "ahooks": "^3.7.0",
-        "antd": "^5.28.0",
-        "antd-img-crop": "^4.2.3",
-        "color": "^4.2.3",
-        "dayjs": "^1.11.13",
-        "is-absolute-url": "4.0.1",
-        "md5": "2.3.0",
-        "nano-css": "^5.3.5",
-        "ramda": "0.26.1",
-        "react-draggable": "4.4.6",
-        "react-fast-marquee": "1.3.1",
-        "react-highlight-words": "0.17.0",
-        "react-icons": "^4.11.0",
-        "react-text-loop": "2.3.0",
-        "react-use": "^17.4.0",
-        "uuid": "8.3.2",
-        "zustand": "^4.5.2"
-    },
-    "devDependencies": {
-        "@babel/core": "^7.5.4",
-        "@babel/plugin-proposal-nullish-coalescing-operator": "^7.18.6",
-        "@babel/plugin-proposal-object-rest-spread": "^7.5.4",
-        "@babel/plugin-proposal-optional-chaining": "^7.21.0",
-        "@babel/preset-env": "^7.5.4",
-        "@babel/preset-react": "^7.0.0",
-        "babel-eslint": "^10.0.2",
-        "babel-loader": "^8.0.6",
-        "copyfiles": "^2.1.1",
-        "css-loader": "^3.0.0",
-        "eslint": "^6.0.1",
-        "eslint-config-prettier": "^6.0.0",
-        "eslint-plugin-import": "^2.18.0",
-        "eslint-plugin-react": "^7.14.2",
-        "less": "^3.13.1",
-        "less-loader": "^5.0.0",
-        "lodash": "^4.17.21",
-        "npm": "^6.1.0",
-        "prop-types": "^15.7.2",
-        "react": "^18.3.1",
-        "react-docgen": "^5.4.3",
-        "react-dom": "^18.3.1",
-        "style-loader": "^0.23.1",
-        "styled-jsx": "^3.2.1",
-        "webpack": "4.36.1",
-        "webpack-bundle-analyzer": "^4.7.0",
-        "webpack-cli": "^3.3.6",
-        "webpack-serve": "3.1.0"
-    },
-    "babel": {
-        "presets": [
-            "@babel/preset-react",
-            "@babel/preset-env"
-        ],
-        "plugins": [
-            "@babel/plugin-proposal-optional-chaining",
-            "@babel/plugin-transform-react-jsx"
-        ]
-    },
-    "engines": {
-        "node": ">=8.11.0",
-        "npm": ">=6.1.0"
-    }
+{
+    "name": "feffery_antd_components",
+    "version": "0.4.3",
+    "description": "Best implementation of Antd components in Plotly Dash.",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/CNFeffery/feffery-antd-components.git"
+    },
+    "bugs": {
+        "url": "https://github.com/CNFeffery/feffery-antd-components/issues"
+    },
+    "homepage": "http://fac.feffery.tech/",
+    "main": "build/index.js",
+    "scripts": {
+        "start": "webpack-serve --config ./webpack.serve.config.js --open",
+        "build:js": "webpack --mode production",
+        "build:backends": "dash-generate-components ./src/lib/components feffery_antd_components --keep-prop-order ALL -p package-info.json --r-prefix 'feffery' --jl-prefix 'feffery'",
+        "build:backends-activated": "(. venv/bin/activate || venv\\scripts\\activate && npm run build:py_and_r)",
+        "build": "npm run build:js && npm run build:backends",
+        "build:activated": "npm run build:js && npm run build:backends-activated"
+    },
+    "author": "CNFeffery <fefferypzy@gmail.com>",
+    "email": "fefferypzy@gmail.com",
+    "license": "MIT",
+    "dependencies": {
+        "@ant-design/charts": "^1.4.2",
+        "@ant-design/compatible": "^5.0.0",
+        "@ant-design/happy-work-theme": "^1.0.0",
+        "@ant-design/icons": "^5.0.0",
+        "@ant-design/pro-components": "^2.6.49",
+        "@plotly/webpack-dash-dynamic-import": "^1.3.0",
+        "ahooks": "^3.7.0",
+        "antd": "^5.28.0",
+        "antd-img-crop": "^4.2.3",
+        "color": "^4.2.3",
+        "dayjs": "^1.11.13",
+        "is-absolute-url": "4.0.1",
+        "md5": "2.3.0",
+        "nano-css": "^5.3.5",
+        "ramda": "0.26.1",
+        "react-draggable": "4.4.6",
+        "react-fast-marquee": "1.3.1",
+        "react-highlight-words": "0.17.0",
+        "react-icons": "^4.11.0",
+        "react-text-loop": "2.3.0",
+        "react-use": "^17.4.0",
+        "uuid": "8.3.2",
+        "zustand": "^4.5.2"
+    },
+    "devDependencies": {
+        "@babel/core": "^7.5.4",
+        "@babel/plugin-proposal-nullish-coalescing-operator": "^7.18.6",
+        "@babel/plugin-proposal-object-rest-spread": "^7.5.4",
+        "@babel/plugin-proposal-optional-chaining": "^7.21.0",
+        "@babel/preset-env": "^7.5.4",
+        "@babel/preset-react": "^7.0.0",
+        "babel-eslint": "^10.0.2",
+        "babel-loader": "^8.0.6",
+        "copyfiles": "^2.1.1",
+        "css-loader": "^3.0.0",
+        "eslint": "^6.0.1",
+        "eslint-config-prettier": "^6.0.0",
+        "eslint-plugin-import": "^2.18.0",
+        "eslint-plugin-react": "^7.14.2",
+        "less": "^3.13.1",
+        "less-loader": "^5.0.0",
+        "lodash": "^4.17.21",
+        "npm": "^6.1.0",
+        "prop-types": "^15.7.2",
+        "react": "^18.3.1",
+        "react-docgen": "^5.4.3",
+        "react-dom": "^18.3.1",
+        "style-loader": "^0.23.1",
+        "styled-jsx": "^4.0.0",
+        "webpack": "4.36.1",
+        "webpack-bundle-analyzer": "^4.7.0",
+        "webpack-cli": "^3.3.6",
+        "webpack-serve": "3.1.0"
+    },
+    "overrides": {
+        "@ant-design/charts": {
+            "@ant-design/icons": "$@ant-design/icons",
+            "antd": "$antd"
+        },
+        "react-fast-marquee": {
+            "react": "$react",
+            "react-dom": "$react-dom"
+        },
+        "react-highlight-words": {
+            "react": "$react",
+            "react-dom": "$react-dom"
+        },
+        "react-text-loop": {
+            "react": "$react",
+            "react-dom": "$react-dom"
+        }
+    },
+    "babel": {
+        "presets": [
+            "@babel/preset-react",
+            "@babel/preset-env"
+        ],
+        "plugins": [
+            "@babel/plugin-proposal-optional-chaining",
+            "@babel/plugin-transform-react-jsx"
+        ]
+    },
+    "engines": {
+        "node": ">=8.11.0",
+        "npm": ">=6.1.0"
+    }
 }

package/pytest.ini

@@ -1,5 +1,5 @@
-[pytest]
-testpaths = tests/
-addopts = -rsxX -vv
-log_format = %(asctime)s | %(levelname)s | %(name)s:%(lineno)d | %(message)s
-log_cli_level = ERROR
+[pytest]
+testpaths = tests/
+addopts = -rsxX -vv
+log_format = %(asctime)s | %(levelname)s | %(name)s:%(lineno)d | %(message)s
+log_cli_level = ERROR

package/release-to-test-pypi.sh

@@ -1 +1 @@
-python setup.py sdist bdist_wheel && python -m twine upload --repository-url https://test.pypi.org/legacy/ dist/*
+python setup.py sdist bdist_wheel && python -m twine upload --repository-url https://test.pypi.org/legacy/ dist/*

package/requirements.txt

@@ -1,2 +1,2 @@
-# dash is required to call `build:py`
-dash[dev]>=1.15.0
+# dash is required to call `build:py`
+dash[dev]>=1.15.0

package/review_checklist.md

@@ -1,47 +1,47 @@
-# Code Review Checklist
-
-## Code quality & design
-
--   Is your code clear? If you had to go back to it in a month, would you be happy to? If someone else had to contribute to it, would they be able to?
-
-    A few suggestions:
-
-    -   Make your variable names descriptive and use the same naming conventions throughout the code.
-
-    -   For more complex pieces of logic, consider putting a comment, and maybe an example.
-
-    -   In the comments, focus on describing _why_ the code does what it does, rather than describing _what_ it does. The reader can most likely read the code, but not necessarily understand why it was necessary.
-
-    -   Don't overdo it in the comments. The code should be clear enough to speak for itself. Stale comments that no longer reflect the intent of the code can hurt code comprehension.
-
-*   Don't repeat yourself. Any time you see that the same piece of logic can be applied in multiple places, factor it out into a function, or variable, and reuse that code.
-*   Scan your code for expensive operations (large computations, DOM queries, React re-renders). Have you done your possible to limit their impact? If not, it is going to slow your app down.
-*   Can you think of cases where your current code will break? How are you handling errors? Should the user see them as notifications? Should your app try to auto-correct them for them?
-
-## Component API
-
--   Have you tested your component on the Python side by creating an app in `usage.py` ?
-
-    Do all of your component's props work when set from the back-end?
-
-    Should all of them be settable from the back-end or are some only relevant to user interactions in the front-end?
-
--   Have you provided some basic documentation about your component? The Dash community uses [react docstrings](https://github.com/plotly/dash-docs/blob/master/tutorial/plugins.py#L45) to provide basic information about dash components. Take a look at this [Checklist component example](https://github.com/plotly/dash-core-components/blob/master/src/components/Checklist.react.js) and others from the dash-core-components repository.
-
-    At a minimum, you should describe what your component does, and describe its props and the features they enable.
-
-    Be careful to use the correct formatting for your docstrings for them to be properly recognized.
-
-## Tests
-
--   The Dash team uses integration tests extensively, and we highly encourage you to write tests for the main functionality of your component. In the `tests` folder of the boilerplate, you can see a sample integration test. By launching it, you will run a sample Dash app in a browser. You can run the test with:
-    ```
-    python -m tests.test_render
-    ```
-    [Browse the Dash component code on GitHub for more examples of testing.](https://github.com/plotly/dash-core-components)
-
-## Ready to publish? Final scan
-
--   Take a last look at the external resources that your component is using. Are all the external resources used [referenced in `MANIFEST.in`](https://github.com/plotly/dash-docs/blob/0b2fd8f892db720a7f3dc1c404b4cff464b5f8d4/tutorial/plugins.py#L55)?
-
--   [You're ready to publish!](https://github.com/plotly/dash-component-boilerplate/blob/master/%7B%7Bcookiecutter.project_shortname%7D%7D/README.md#create-a-production-build-and-publish)
+# Code Review Checklist
+
+## Code quality & design
+
+-   Is your code clear? If you had to go back to it in a month, would you be happy to? If someone else had to contribute to it, would they be able to?
+
+    A few suggestions:
+
+    -   Make your variable names descriptive and use the same naming conventions throughout the code.
+
+    -   For more complex pieces of logic, consider putting a comment, and maybe an example.
+
+    -   In the comments, focus on describing _why_ the code does what it does, rather than describing _what_ it does. The reader can most likely read the code, but not necessarily understand why it was necessary.
+
+    -   Don't overdo it in the comments. The code should be clear enough to speak for itself. Stale comments that no longer reflect the intent of the code can hurt code comprehension.
+
+*   Don't repeat yourself. Any time you see that the same piece of logic can be applied in multiple places, factor it out into a function, or variable, and reuse that code.
+*   Scan your code for expensive operations (large computations, DOM queries, React re-renders). Have you done your possible to limit their impact? If not, it is going to slow your app down.
+*   Can you think of cases where your current code will break? How are you handling errors? Should the user see them as notifications? Should your app try to auto-correct them for them?
+
+## Component API
+
+-   Have you tested your component on the Python side by creating an app in `usage.py` ?
+
+    Do all of your component's props work when set from the back-end?
+
+    Should all of them be settable from the back-end or are some only relevant to user interactions in the front-end?
+
+-   Have you provided some basic documentation about your component? The Dash community uses [react docstrings](https://github.com/plotly/dash-docs/blob/master/tutorial/plugins.py#L45) to provide basic information about dash components. Take a look at this [Checklist component example](https://github.com/plotly/dash-core-components/blob/master/src/components/Checklist.react.js) and others from the dash-core-components repository.
+
+    At a minimum, you should describe what your component does, and describe its props and the features they enable.
+
+    Be careful to use the correct formatting for your docstrings for them to be properly recognized.
+
+## Tests
+
+-   The Dash team uses integration tests extensively, and we highly encourage you to write tests for the main functionality of your component. In the `tests` folder of the boilerplate, you can see a sample integration test. By launching it, you will run a sample Dash app in a browser. You can run the test with:
+    ```
+    python -m tests.test_render
+    ```
+    [Browse the Dash component code on GitHub for more examples of testing.](https://github.com/plotly/dash-core-components)
+
+## Ready to publish? Final scan
+
+-   Take a last look at the external resources that your component is using. Are all the external resources used [referenced in `MANIFEST.in`](https://github.com/plotly/dash-docs/blob/0b2fd8f892db720a7f3dc1c404b4cff464b5f8d4/tutorial/plugins.py#L55)?
+
+-   [You're ready to publish!](https://github.com/plotly/dash-component-boilerplate/blob/master/%7B%7Bcookiecutter.project_shortname%7D%7D/README.md#create-a-production-build-and-publish)

package/ruff.toml

@@ -1,4 +1,4 @@
-line-length = 60
-
-[format]
-quote-style = "single"
+line-length = 60
+
+[format]
+quote-style = "single"

package/setup.py

@@ -1,33 +1,33 @@
-import io
-import json
-from setuptools import setup
-
-
-with open('package.json') as f:
-    package = json.load(f)
-
-package_name = package["name"].replace(" ", "_").replace("-", "_")
-
-setup(
-    name=package_name,
-    version=package["version"],
-    author_email=package['email'],
-    homepage='https://github.com/CNFeffery/feffery-antd-components',
-    author=package['author'],
-    packages=[package_name],
-    include_package_data=True,
-    package_data={
-        'feffery_antd_components': ['*']
-    },
-    license=package['license'],
-    description=package.get('description', package_name),
-    long_description=io.open("README.md", encoding="utf-8").read(),
-    long_description_content_type="text/markdown",
-    install_requires=[
-        'dash>=3.1.1',
-    ],
-    classifiers=[
-        'Framework :: Dash',
-    ],
-    url='https://github.com/CNFeffery/feffery-antd-components'
-)
+import io
+import json
+from setuptools import setup
+
+
+with open('package.json') as f:
+    package = json.load(f)
+
+package_name = package["name"].replace(" ", "_").replace("-", "_")
+
+setup(
+    name=package_name,
+    version=package["version"],
+    author_email=package['email'],
+    homepage='https://github.com/CNFeffery/feffery-antd-components',
+    author=package['author'],
+    packages=[package_name],
+    include_package_data=True,
+    package_data={
+        'feffery_antd_components': ['*']
+    },
+    license=package['license'],
+    description=package.get('description', package_name),
+    long_description=io.open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    install_requires=[
+        'dash>=3.1.1',
+    ],
+    classifiers=[
+        'Framework :: Dash',
+    ],
+    url='https://github.com/CNFeffery/feffery-antd-components'
+)

package/src/jl/'feffery'_antdform.jl

@@ -33,6 +33,7 @@ Those elements have the following types:
 - `layout` (a value equal to: 'horizontal', 'vertical', 'inline'; optional): 表单布局模式，可选项有`'horizontal'`、`'vertical'`、`'inline'`
 默认值：`'horizontal'`
 - `style` (Dict; optional): 当前组件css样式
+- `tooltips` (Dict with Strings as keys and values of type a list of or a singular dash component, string or number; optional): 当`enableBatchControl=True`时，可用于统一设置内部各`AntdFormItem`组件的`tooltip`值，键为对应`AntdFormItem`组件的`label`值，优先级低于各`AntdFormItem`组件的`tooltip`值
 - `validateStatuses` (Dict with Strings as keys and values of type a value equal to: 'success', 'warning', 'error', 'validating'; optional): 当`enableBatchControl=True`时，可用于统一设置内部各`AntdFormItem`组件的`validateStatus`值，键为对应`AntdFormItem`组件的`label`值，优先级低于各`AntdFormItem`组件的`validateStatus`值
 - `values` (Dict; optional): 当`enableBatchControl=True`时，可用于监听或设置搜集内部表单输入类组件的输入值变化情况，开启后内部表单输入类组件自身的`defaultValue`、`value`参数将会失效
 - `wrapperCol` (optional): 配置表单项控件部分相关参数. wrapperCol has the following type: lists containing elements 'span', 'offset', 'flex'.
@@ -42,7 +43,7 @@ Those elements have the following types:
   - `flex` (String | Real; optional): 同css中的flex属性，用于更灵活的控制控件部分所占宽度
 """
 function 'feffery'_antdform(; kwargs...)
-        available_props = Symbol[:children, :id, :className, :colon, :enableBatchControl, :helps, :key, :labelAlign, :labelCol, :labelWrap, :layout, :style, :validateStatuses, :values, :wrapperCol]
+        available_props = Symbol[:children, :id, :className, :colon, :enableBatchControl, :helps, :key, :labelAlign, :labelCol, :labelWrap, :layout, :style, :tooltips, :validateStatuses, :values, :wrapperCol]
         wild_props = Symbol[Symbol("aria-"), Symbol("data-")]
         return Component("'feffery'_antdform", "AntdForm", "feffery_antd_components", available_props, wild_props; kwargs...)
 end

package/src/jl/'feffery'_antdtable.jl

@@ -49,13 +49,15 @@ Those elements have the following types:
   - `title` (a list of or a singular dash component, string or number; required): 必填，当前字段标题
   - `dataIndex` (String; required): 必填，当前字段唯一识别id
   - `group` (String | Array of Strings; optional): 当前字段所属分组信息，用于渲染多级表头
-  - `renderOptions` (optional): 配置字段[再渲染模式](/AntdTable-rerender)相关参数. renderOptions has the following type: lists containing elements 'renderType', 'renderLinkText', 'renderButtonSplit', 'renderButtonPopConfirmProps', 'miniChartColor', 'tooltipCustomContent', 'progressOneHundredPercentColor', 'progressShowPercent', 'progressPercentPrecision', 'progressPercentPosition', 'progressStrokeLinecap', 'progressSize', 'progressColor', 'ringProgressFontSize', 'dropdownProps'.
+  - `renderOptions` (optional): 配置字段[再渲染模式](/AntdTable-rerender)相关参数. renderOptions has the following type: lists containing elements 'renderType', 'renderLinkText', 'likeDccLink', 'renderButtonSplit', 'renderButtonPopConfirmProps', 'miniChartColor', 'tooltipCustomContent', 'progressOneHundredPercentColor', 'progressShowPercent', 'progressPercentPrecision', 'progressPercentPosition', 'progressStrokeLinecap', 'progressSize', 'progressColor', 'ringProgressFontSize', 'dropdownProps'.
 Those elements have the following types:
   - `renderType` (a value equal to: 'link', 'ellipsis', 'copyable', 'ellipsis-copyable', 'tags', 'status-badge', 'image', 'custom-format', 'corner-mark', 'row-merge', 'dropdown', 'dropdown-links', 'image-avatar', 'mini-line', 'mini-bar', 'mini-progress', 'mini-ring-progress', 'mini-area', 'button', 'checkbox', 'switch', 'select'; optional): 再渲染类型，可选项有`'link'`、`'ellipsis'`、`'copyable'`、`'ellipsis-copyable'`、`'tags'`、`'status-badge'`、`'image'`
 、`'custom-format'`、`'corner-mark'`、`'row-merge'`、`'dropdown'`、`'dropdown-links'`、`'image-avatar'`
 、`'mini-line'`、`'mini-bar'`、`'mini-progress'`、`'mini-ring-progress'`、`'mini-area'`
 、`'button'`、`'checkbox'`、`'switch'`、`'select'`
   - `renderLinkText` (String; optional): 当`renderType='link'`时，统一设置渲染链接文本内容
+  - `likeDccLink` (Bool; optional): 当`renderType`为`'link'`、`'button'`时，统一设置链接跳转行为是否采用`dcc.Link`模式
+默认值：`false`
   - `renderButtonSplit` (Bool; optional): 当`renderType='button'`时，控制多个按钮之间是否添加分割线
   - `renderButtonPopConfirmProps` (optional): 当`renderType='button'`时，配置气泡确认框相关参数. renderButtonPopConfirmProps has the following type: lists containing elements 'title', 'okText', 'cancelText'.
 Those elements have the following types:
@@ -427,14 +429,13 @@ Those elements have the following types:
 默认值：`false`
 - `tableLayout` (a value equal to: 'auto', 'fixed'; optional): 当`columns`中各字段未设置`width`时，用于控制整体字段宽度分配方式，可选项有`'auto'`、`'fixed'`
 - `title` (a list of or a singular dash component, string or number; optional): 组件型，表格整体标题内容
-- `titlePopoverInfo` (optional): 配置各字段标题额外气泡说明卡片信息相关参数. titlePopoverInfo has the following type: Array of lists containing elements 'dataIndex', 'title', 'content', 'placement', 'overlayStyle'.
+- `titlePopoverInfo` (optional): 配置各字段标题额外气泡说明卡片信息相关参数. titlePopoverInfo has the following type: Dict with Strings as keys and values of type lists containing elements 'title', 'content', 'placement', 'overlayStyle'.
 Those elements have the following types:
-  - `dataIndex` (String; required): 必填，对应字段的dataIndex
-  - `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): 气泡卡片内容，支持字符串或组件型
+  - `title` (String; optional): 气泡卡片标题，支持字符串或组件型
+  - `content` (String; 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'`
 默认值：`'bottom'`
-  - `overlayStyle` (Dict; optional): 气泡卡片展开层css样式s
+  - `overlayStyle` (Dict; optional): 气泡卡片展开层css样式
 - `virtual` (Bool; optional): 是否开启虚拟滚动模式
 默认值：`false`
 """