Master 2.17.0 build artifacts

dash/dash_table/package-info.json

@@ -1,6 +1,6 @@
 {
   "name": "dash-table",
-  "version": "5.2.10",
+  "version": "5.2.11",
   "description": "Dash table",
   "repository": {
     "type": "git",
@@ -41,13 +41,13 @@
   "maintainer": "Alex Johnson <[email protected]>",
   "license": "MIT",
   "devDependencies": {
-    "@babel/cli": "^7.23.9",
-    "@babel/core": "^7.24.0",
+    "@babel/cli": "^7.24.1",
+    "@babel/core": "^7.24.1",
     "@babel/plugin-syntax-dynamic-import": "^7.8.3",
-    "@babel/plugin-transform-regenerator": "^7.23.3",
+    "@babel/plugin-transform-regenerator": "^7.24.1",
     "@babel/polyfill": "^7.12.1",
-    "@babel/preset-env": "^7.24.0",
-    "@babel/preset-react": "^7.23.3",
+    "@babel/preset-env": "^7.24.5",
+    "@babel/preset-react": "^7.24.1",
     "@fortawesome/fontawesome-svg-core": "1.2.36",
     "@fortawesome/free-regular-svg-icons": "^5.15.4",
     "@fortawesome/free-solid-svg-icons": "^5.15.4",
@@ -104,7 +104,7 @@
     "style-loader": "^3.3.3",
     "ts-loader": "^9.4.3",
     "typescript": "^5.3.3",
-    "webpack": "^5.90.3",
+    "webpack": "^5.91.0",
     "webpack-cli": "^5.1.4",
     "webpack-dev-server": "^4.15.1",
     "webpack-preprocessor": "^0.1.12",
@@ -125,6 +125,6 @@
     "npm": ">=6.1.0"
   },
   "browserslist": [
-    "last 8 years and not dead"
+    "last 9 years and not dead"
   ]
 }

dash/dcc/Loading.py

@@ -18,17 +18,33 @@ class Loading(Component):
         in an app.
 
     - className (string; optional):
-        Additional CSS class for the spinner root DOM node.
+        Additional CSS class for the built-in spinner root DOM node.
 
     - color (string; default '#119DFF'):
-        Primary colour used for the loading spinners.
+        Primary color used for the built-in loading spinners.
+
+    - custom_spinner (a list of or a singular dash component, string or number; optional):
+        Component to use rather than the built-in spinner specified in the
+        `type` prop.
 
     - debug (boolean; optional):
-        If True, the spinner will display the component_name and prop_name
-        while loading.
+        If True, the built-in spinner will display the component_name and
+        prop_name while loading.
+
+    - delay_hide (number; default 0):
+        Add a time delay (in ms) to the spinner being removed to prevent
+        flickering.
+
+    - delay_show (number; default 0):
+        Add a time delay (in ms) to the spinner being shown after the
+        loading_state is set to True.
+
+    - display (a value equal to: 'auto', 'show', 'hide'; default 'auto'):
+        Setting display to  \"show\" or \"hide\"  will override the
+        loading state coming from dash-renderer.
 
     - fullscreen (boolean; optional):
-        Boolean that makes the spinner display full-screen.
+        Boolean that makes the built-in spinner display full-screen.
 
     - loading_state (dict; optional):
         Object that holds the loading state object coming from
@@ -45,6 +61,11 @@ class Loading(Component):
         - prop_name (string; optional):
             Holds which property is loading.
 
+    - overlay_style (dict; optional):
+        Additional CSS styling for the spinner overlay. This is applied to
+        the dcc.Loading children while the spinner is active.  The default
+        is `{'visibility': 'hidden'}`.
+
     - parent_className (string; optional):
         Additional CSS class for the outermost dcc.Loading parent div DOM
         node.
@@ -53,15 +74,25 @@ class Loading(Component):
         Additional CSS styling for the outermost dcc.Loading parent div
         DOM node.
 
+    - show_initially (boolean; default True):
+        Whether the Spinner should show on app start-up before the loading
+        state has been determined. Default True.  Use when also setting
+        `delay_show`.
+
     - style (dict; optional):
-        Additional CSS styling for the spinner root DOM node.
+        Additional CSS styling for the built-in spinner root DOM node.
+
+    - target_components (dict with strings as keys and values of type string | list of strings; optional):
+        Specify component and prop to trigger showing the loading spinner
+        example: `{\"output-container\": \"children\", \"grid\":
+        [\"rowData\", \"columnDefs]}`.
 
     - type (a value equal to: 'graph', 'cube', 'circle', 'dot', 'default'; default 'default'):
-        Property that determines which spinner to show one of 'graph',
-        'cube', 'circle', 'dot', or 'default'."""
+        Property that determines which built-in spinner to show one of
+        'graph', 'cube', 'circle', 'dot', or 'default'."""
 
-    _children_props = []
-    _base_nodes = ["children"]
+    _children_props = ["custom_spinner"]
+    _base_nodes = ["custom_spinner", "children"]
     _namespace = "dash_core_components"
     _type = "Loading"
 
@@ -77,21 +108,35 @@ def __init__(
         parent_className=Component.UNDEFINED,
         style=Component.UNDEFINED,
         parent_style=Component.UNDEFINED,
+        overlay_style=Component.UNDEFINED,
         color=Component.UNDEFINED,
         loading_state=Component.UNDEFINED,
+        display=Component.UNDEFINED,
+        delay_hide=Component.UNDEFINED,
+        delay_show=Component.UNDEFINED,
+        show_initially=Component.UNDEFINED,
+        target_components=Component.UNDEFINED,
+        custom_spinner=Component.UNDEFINED,
         **kwargs
     ):
         self._prop_names = [
             "children",
             "id",
             "className",
             "color",
+            "custom_spinner",
             "debug",
+            "delay_hide",
+            "delay_show",
+            "display",
             "fullscreen",
             "loading_state",
+            "overlay_style",
             "parent_className",
             "parent_style",
+            "show_initially",
             "style",
+            "target_components",
             "type",
         ]
         self._valid_wildcard_attributes = []
@@ -100,12 +145,19 @@ def __init__(
             "id",
             "className",
             "color",
+            "custom_spinner",
             "debug",
+            "delay_hide",
+            "delay_show",
+            "display",
             "fullscreen",
             "loading_state",
+            "overlay_style",
             "parent_className",
             "parent_style",
+            "show_initially",
             "style",
+            "target_components",
             "type",
         ]
         self.available_wildcard_properties = []

dash/dcc/metadata.json

@@ -3499,7 +3499,7 @@
           ]
         },
         "required": false,
-        "description": "Property that determines which spinner to show\none of 'graph', 'cube', 'circle', 'dot', or 'default'.",
+        "description": "Property that determines which built-in spinner to show\none of 'graph', 'cube', 'circle', 'dot', or 'default'.",
         "defaultValue": {
           "value": "'default'",
           "computed": false
@@ -3510,21 +3510,21 @@
           "name": "bool"
         },
         "required": false,
-        "description": "Boolean that makes the spinner display full-screen"
+        "description": "Boolean that makes the built-in spinner display full-screen"
       },
       "debug": {
         "type": {
           "name": "bool"
         },
         "required": false,
-        "description": "If true, the spinner will display the component_name and prop_name\nwhile loading"
+        "description": "If true, the built-in spinner will display the component_name and prop_name\nwhile loading"
       },
       "className": {
         "type": {
           "name": "string"
         },
         "required": false,
-        "description": "Additional CSS class for the spinner root DOM node"
+        "description": "Additional CSS class for the built-in spinner root DOM node"
       },
       "parent_className": {
         "type": {
@@ -3538,7 +3538,7 @@
           "name": "object"
         },
         "required": false,
-        "description": "Additional CSS styling for the spinner root DOM node"
+        "description": "Additional CSS styling for the built-in spinner root DOM node"
       },
       "parent_style": {
         "type": {
@@ -3547,12 +3547,19 @@
         "required": false,
         "description": "Additional CSS styling for the outermost dcc.Loading parent div DOM node"
       },
+      "overlay_style": {
+        "type": {
+          "name": "object"
+        },
+        "required": false,
+        "description": "Additional CSS styling for the spinner overlay. This is applied to the\ndcc.Loading children while the spinner is active.  The default is `{'visibility': 'hidden'}`"
+      },
       "color": {
         "type": {
           "name": "string"
         },
         "required": false,
-        "description": "Primary colour used for the loading spinners",
+        "description": "Primary color used for the built-in loading spinners",
         "defaultValue": {
           "value": "'#119DFF'",
           "computed": false
@@ -3581,6 +3588,92 @@
         },
         "required": false,
         "description": "Object that holds the loading state object coming from dash-renderer"
+      },
+      "display": {
+        "type": {
+          "name": "enum",
+          "value": [
+            {
+              "value": "'auto'",
+              "computed": false
+            },
+            {
+              "value": "'show'",
+              "computed": false
+            },
+            {
+              "value": "'hide'",
+              "computed": false
+            }
+          ]
+        },
+        "required": false,
+        "description": "Setting display to  \"show\" or \"hide\"  will override the loading state coming from dash-renderer",
+        "defaultValue": {
+          "value": "'auto'",
+          "computed": false
+        }
+      },
+      "delay_hide": {
+        "type": {
+          "name": "number"
+        },
+        "required": false,
+        "description": "Add a time delay (in ms) to the spinner being removed to prevent flickering.",
+        "defaultValue": {
+          "value": "0",
+          "computed": false
+        }
+      },
+      "delay_show": {
+        "type": {
+          "name": "number"
+        },
+        "required": false,
+        "description": "Add a time delay (in ms) to the spinner being shown after the loading_state\nis set to True.",
+        "defaultValue": {
+          "value": "0",
+          "computed": false
+        }
+      },
+      "show_initially": {
+        "type": {
+          "name": "bool"
+        },
+        "required": false,
+        "description": "Whether the Spinner should show on app start-up before the loading state\nhas been determined. Default True.  Use when also setting `delay_show`.",
+        "defaultValue": {
+          "value": "true",
+          "computed": false
+        }
+      },
+      "target_components": {
+        "type": {
+          "name": "objectOf",
+          "value": {
+            "name": "union",
+            "value": [
+              {
+                "name": "string"
+              },
+              {
+                "name": "arrayOf",
+                "value": {
+                  "name": "string"
+                }
+              }
+            ]
+          }
+        },
+        "required": false,
+        "description": "Specify component and prop to trigger showing the loading spinner\nexample: `{\"output-container\": \"children\", \"grid\": [\"rowData\", \"columnDefs]}`"
+      },
+      "custom_spinner": {
+        "type": {
+          "name": "node"
+        },
+        "required": false,
+        "description": "Component to use rather than the built-in spinner specified in the `type` prop."
       }
     }
   },