reflex-components-plotly 0.9.2__tar.gz → 0.9.3__tar.gz

{reflex_components_plotly-0.9.2 → reflex_components_plotly-0.9.3}/.gitignore

@@ -1,5 +1,10 @@
 **/.DS_Store
 **/*.pyc
+**/__pycache__/
+.pytest_cache/
+.ruff_cache/
+**/.ruff_cache/
+.mypy_cache/
 assets/external/*
 dist/*
 examples/
@@ -21,4 +26,7 @@ reflex.db
 node_modules
 package-lock.json
 *.pyi
-.pre-commit-config.yaml
+.pre-commit-config.yaml
+.claude/.worktrees
+.claude/settings.local.json
+CLAUDE.local.md

reflex_components_plotly-0.9.3/CHANGELOG.md

@@ -0,0 +1,5 @@
+## v0.9.3 (2026-06-25)
+
+### Features
+
+- `rx.plotly` (and its dist variants like `rx.plotly.basic`) now accept a `locale` prop to localize Plotly's number/date formatting and modebar labels. The matching locale data from `plotly.js-locales` is resolved and merged into the chart config at render time, so per-chart locales work without any manual setup. ([#6428](https://github.com/reflex-dev/reflex/issues/6428))

{reflex_components_plotly-0.9.2 → reflex_components_plotly-0.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reflex-components-plotly
-Version: 0.9.2
+Version: 0.9.3
 Summary: Reflex plotly components.
 Author-email: Khaleel Al-Adhami <khaleel@reflex.dev>
 Maintainer-email: Khaleel Al-Adhami <khaleel@reflex.dev>

{reflex_components_plotly-0.9.2 → reflex_components_plotly-0.9.3}/src/reflex_components_plotly/plotly.py

@@ -90,6 +90,10 @@ class Plotly(NoSSRComponent):
 
     config: Var[dict] = field(doc="The config of the graph.")
 
+    locale: Var[str] = field(
+        doc="The locale code used for Plotly formatting and modebar labels."
+    )
+
     use_resize_handler: Var[bool] = field(
         default=LiteralVar.create(True),
         doc="If true, the graph will resize when the window is resized.",
@@ -175,16 +179,23 @@ class Plotly(NoSSRComponent):
         doc="Fired when a hovered element is no longer hovered."
     )
 
-    def add_imports(self) -> dict[str, str]:
+    def add_imports(self) -> ImportDict:
         """Add imports for the plotly component.
 
         Returns:
             The imports for the plotly component.
         """
-        return {
+        imports: ImportDict = {
             # For merging plotly data/layout/templates.
-            "mergician@v2.0.2": "mergician"
+            "mergician@v2.0.2": "mergician",
         }
+        if self.locale is not None:
+            # For locale dictionaries injected into plot config.locales.
+            imports["plotly.js-locales@3.5.0"] = ImportVar(
+                tag="plotlyLocales",
+                is_default=True,
+            )
+        return imports
 
     def add_custom_code(self) -> list[str]:
         """Add custom codes for processing the plotly points data.
@@ -192,7 +203,7 @@ class Plotly(NoSSRComponent):
         Returns:
             Custom code snippets for the module level.
         """
-        return [
+        codes = [
             "const removeUndefined = (obj) => {Object.keys(obj).forEach(key => obj[key] === undefined && delete obj[key]); return obj}",
             """
 const extractPoints = (points) => {
@@ -224,6 +235,45 @@ const extractPoints = (points) => {
 }
 """,
         ]
+        if self.locale is not None:
+            codes.append("""
+const _rxResolvePlotlyLocaleData = (plotlyLocales, locale) => {
+    if (locale === undefined || locale === null) return null;
+    const localeString = String(locale).trim();
+    if (localeString === "") return null;
+
+    const normalizedLocale = localeString.toLowerCase().replace(/_/g, "-");
+    const localesObject = plotlyLocales?.default ?? plotlyLocales;
+    if (!localesObject || typeof localesObject !== "object") return null;
+
+    return (
+        localesObject[normalizedLocale] ??
+        localesObject[normalizedLocale.split("-")[0]] ??
+        null
+    );
+}
+
+const _rxGetPlotlyLocaleConfig = (config, locale, plotlyLocales) => {
+    const localeData = _rxResolvePlotlyLocaleData(plotlyLocales, locale);
+    if (!localeData) {
+        if (locale === undefined || locale === null || String(locale).trim() === "") {
+            return config;
+        }
+        return { ...config, locale: String(locale) };
+    }
+
+    const localeName = localeData?.name ?? String(locale);
+    return {
+        ...config,
+        locale: localeName,
+        locales: {
+            ...(config?.locales ?? {}),
+            [localeName]: localeData,
+        },
+    };
+}
+""")
+        return codes
 
     @classmethod
     def create(cls, *children, **props) -> Component:
@@ -251,7 +301,7 @@ const extractPoints = (points) => {
 
     def _exclude_props(self) -> set[str]:
         # These props are handled specially in the _render function
-        return {"data", "layout", "template"}
+        return {"data", "layout", "template", "locale"}
 
     def _render(self):
         tag = super()._render()
@@ -285,6 +335,16 @@ const extractPoints = (points) => {
                     Var(_js_expr=str(figure)),
                 ]
             )
+        if self.locale is not None:
+            config = self.config if self.config is not None else LiteralVar.create({})
+            tag = tag.set(
+                props={
+                    **tag.props,
+                    "config": Var(
+                        _js_expr=f"_rxGetPlotlyLocaleConfig({config!s},{self.locale!s},plotlyLocales)"
+                    ),
+                },
+            )
         return tag
 
 
@@ -327,7 +387,7 @@ class PlotlyBasic(Plotly):
 
     lib_dependencies: list[str] = ["plotly.js-basic-dist-min@3.5.1"]
 
-    def add_imports(self) -> ImportDict | list[ImportDict]:
+    def add_imports(self) -> ImportDict:
         """Add imports for the plotly basic component.
 
         Returns:
@@ -353,7 +413,7 @@ class PlotlyCartesian(Plotly):
 
     lib_dependencies: list[str] = ["plotly.js-cartesian-dist-min@3.5.1"]
 
-    def add_imports(self) -> ImportDict | list[ImportDict]:
+    def add_imports(self) -> ImportDict:
         """Add imports for the plotly cartesian component.
 
         Returns:
@@ -379,7 +439,7 @@ class PlotlyGeo(Plotly):
 
     lib_dependencies: list[str] = ["plotly.js-geo-dist-min@3.5.1"]
 
-    def add_imports(self) -> ImportDict | list[ImportDict]:
+    def add_imports(self) -> ImportDict:
         """Add imports for the plotly geo component.
 
         Returns:
@@ -405,7 +465,7 @@ class PlotlyGl3d(Plotly):
 
     lib_dependencies: list[str] = ["plotly.js-gl3d-dist-min@3.5.1"]
 
-    def add_imports(self) -> ImportDict | list[ImportDict]:
+    def add_imports(self) -> ImportDict:
         """Add imports for the plotly 3d component.
 
         Returns:
@@ -431,7 +491,7 @@ class PlotlyGl2d(Plotly):
 
     lib_dependencies: list[str] = ["plotly.js-gl2d-dist-min@3.5.1"]
 
-    def add_imports(self) -> ImportDict | list[ImportDict]:
+    def add_imports(self) -> ImportDict:
         """Add imports for the plotly 2d component.
 
         Returns:
@@ -457,7 +517,7 @@ class PlotlyMapbox(Plotly):
 
     lib_dependencies: list[str] = ["plotly.js-mapbox-dist-min@3.5.1"]
 
-    def add_imports(self) -> ImportDict | list[ImportDict]:
+    def add_imports(self) -> ImportDict:
         """Add imports for the plotly mapbox component.
 
         Returns:
@@ -483,7 +543,7 @@ class PlotlyFinance(Plotly):
 
     lib_dependencies: list[str] = ["plotly.js-finance-dist-min@3.5.1"]
 
-    def add_imports(self) -> ImportDict | list[ImportDict]:
+    def add_imports(self) -> ImportDict:
         """Add imports for the plotly finance component.
 
         Returns:
@@ -509,7 +569,7 @@ class PlotlyStrict(Plotly):
 
     lib_dependencies: list[str] = ["plotly.js-strict-dist-min@3.5.1"]
 
-    def add_imports(self) -> ImportDict | list[ImportDict]:
+    def add_imports(self) -> ImportDict:
         """Add imports for the plotly strict component.
 
         Returns:

{reflex_components_plotly-0.9.2 → reflex_components_plotly-0.9.3}/src/reflex_components_plotly/plotly.pyi

@@ -47,7 +47,7 @@ class Point(TypedDict):
     bbox: BBox | None
 
 class Plotly(NoSSRComponent):
-    def add_imports(self) -> dict[str, str]: ...
+    def add_imports(self) -> ImportDict: ...
     def add_custom_code(self) -> list[str]: ...
     @classmethod
     def create(
@@ -57,6 +57,7 @@ class Plotly(NoSSRComponent):
         layout: Var[dict] | dict | None = None,
         template: Any | Var[Any] | None = None,
         config: Var[dict] | dict | None = None,
+        locale: Var[str] | str | None = None,
         use_resize_handler: Var[bool] | bool | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
@@ -112,6 +113,7 @@ class Plotly(NoSSRComponent):
             layout: The layout of the graph.
             template: The template for visual appearance of the graph.
             config: The config of the graph.
+            locale: The locale code used for Plotly formatting and modebar labels.
             use_resize_handler: If true, the graph will resize when the window is resized.
             style: The style of the component.
             key: A unique key for the component.
@@ -164,7 +166,7 @@ CREATE_PLOTLY_COMPONENT: ImportDict
 def dynamic_plotly_import(name: str, package: str) -> str: ...
 
 class PlotlyBasic(Plotly):
-    def add_imports(self) -> ImportDict | list[ImportDict]: ...
+    def add_imports(self) -> ImportDict: ...
     @classmethod
     def create(
         cls,
@@ -173,6 +175,7 @@ class PlotlyBasic(Plotly):
         layout: Var[dict] | dict | None = None,
         template: Any | Var[Any] | None = None,
         config: Var[dict] | dict | None = None,
+        locale: Var[str] | str | None = None,
         use_resize_handler: Var[bool] | bool | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
@@ -228,6 +231,7 @@ class PlotlyBasic(Plotly):
             layout: The layout of the graph.
             template: The template for visual appearance of the graph.
             config: The config of the graph.
+            locale: The locale code used for Plotly formatting and modebar labels.
             use_resize_handler: If true, the graph will resize when the window is resized.
             style: The style of the component.
             key: A unique key for the component.
@@ -276,7 +280,7 @@ class PlotlyBasic(Plotly):
         """
 
 class PlotlyCartesian(Plotly):
-    def add_imports(self) -> ImportDict | list[ImportDict]: ...
+    def add_imports(self) -> ImportDict: ...
     @classmethod
     def create(
         cls,
@@ -285,6 +289,7 @@ class PlotlyCartesian(Plotly):
         layout: Var[dict] | dict | None = None,
         template: Any | Var[Any] | None = None,
         config: Var[dict] | dict | None = None,
+        locale: Var[str] | str | None = None,
         use_resize_handler: Var[bool] | bool | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
@@ -340,6 +345,7 @@ class PlotlyCartesian(Plotly):
             layout: The layout of the graph.
             template: The template for visual appearance of the graph.
             config: The config of the graph.
+            locale: The locale code used for Plotly formatting and modebar labels.
             use_resize_handler: If true, the graph will resize when the window is resized.
             style: The style of the component.
             key: A unique key for the component.
@@ -388,7 +394,7 @@ class PlotlyCartesian(Plotly):
         """
 
 class PlotlyGeo(Plotly):
-    def add_imports(self) -> ImportDict | list[ImportDict]: ...
+    def add_imports(self) -> ImportDict: ...
     @classmethod
     def create(
         cls,
@@ -397,6 +403,7 @@ class PlotlyGeo(Plotly):
         layout: Var[dict] | dict | None = None,
         template: Any | Var[Any] | None = None,
         config: Var[dict] | dict | None = None,
+        locale: Var[str] | str | None = None,
         use_resize_handler: Var[bool] | bool | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
@@ -452,6 +459,7 @@ class PlotlyGeo(Plotly):
             layout: The layout of the graph.
             template: The template for visual appearance of the graph.
             config: The config of the graph.
+            locale: The locale code used for Plotly formatting and modebar labels.
             use_resize_handler: If true, the graph will resize when the window is resized.
             style: The style of the component.
             key: A unique key for the component.
@@ -500,7 +508,7 @@ class PlotlyGeo(Plotly):
         """
 
 class PlotlyGl3d(Plotly):
-    def add_imports(self) -> ImportDict | list[ImportDict]: ...
+    def add_imports(self) -> ImportDict: ...
     @classmethod
     def create(
         cls,
@@ -509,6 +517,7 @@ class PlotlyGl3d(Plotly):
         layout: Var[dict] | dict | None = None,
         template: Any | Var[Any] | None = None,
         config: Var[dict] | dict | None = None,
+        locale: Var[str] | str | None = None,
         use_resize_handler: Var[bool] | bool | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
@@ -564,6 +573,7 @@ class PlotlyGl3d(Plotly):
             layout: The layout of the graph.
             template: The template for visual appearance of the graph.
             config: The config of the graph.
+            locale: The locale code used for Plotly formatting and modebar labels.
             use_resize_handler: If true, the graph will resize when the window is resized.
             style: The style of the component.
             key: A unique key for the component.
@@ -612,7 +622,7 @@ class PlotlyGl3d(Plotly):
         """
 
 class PlotlyGl2d(Plotly):
-    def add_imports(self) -> ImportDict | list[ImportDict]: ...
+    def add_imports(self) -> ImportDict: ...
     @classmethod
     def create(
         cls,
@@ -621,6 +631,7 @@ class PlotlyGl2d(Plotly):
         layout: Var[dict] | dict | None = None,
         template: Any | Var[Any] | None = None,
         config: Var[dict] | dict | None = None,
+        locale: Var[str] | str | None = None,
         use_resize_handler: Var[bool] | bool | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
@@ -676,6 +687,7 @@ class PlotlyGl2d(Plotly):
             layout: The layout of the graph.
             template: The template for visual appearance of the graph.
             config: The config of the graph.
+            locale: The locale code used for Plotly formatting and modebar labels.
             use_resize_handler: If true, the graph will resize when the window is resized.
             style: The style of the component.
             key: A unique key for the component.
@@ -724,7 +736,7 @@ class PlotlyGl2d(Plotly):
         """
 
 class PlotlyMapbox(Plotly):
-    def add_imports(self) -> ImportDict | list[ImportDict]: ...
+    def add_imports(self) -> ImportDict: ...
     @classmethod
     def create(
         cls,
@@ -733,6 +745,7 @@ class PlotlyMapbox(Plotly):
         layout: Var[dict] | dict | None = None,
         template: Any | Var[Any] | None = None,
         config: Var[dict] | dict | None = None,
+        locale: Var[str] | str | None = None,
         use_resize_handler: Var[bool] | bool | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
@@ -788,6 +801,7 @@ class PlotlyMapbox(Plotly):
             layout: The layout of the graph.
             template: The template for visual appearance of the graph.
             config: The config of the graph.
+            locale: The locale code used for Plotly formatting and modebar labels.
             use_resize_handler: If true, the graph will resize when the window is resized.
             style: The style of the component.
             key: A unique key for the component.
@@ -836,7 +850,7 @@ class PlotlyMapbox(Plotly):
         """
 
 class PlotlyFinance(Plotly):
-    def add_imports(self) -> ImportDict | list[ImportDict]: ...
+    def add_imports(self) -> ImportDict: ...
     @classmethod
     def create(
         cls,
@@ -845,6 +859,7 @@ class PlotlyFinance(Plotly):
         layout: Var[dict] | dict | None = None,
         template: Any | Var[Any] | None = None,
         config: Var[dict] | dict | None = None,
+        locale: Var[str] | str | None = None,
         use_resize_handler: Var[bool] | bool | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
@@ -900,6 +915,7 @@ class PlotlyFinance(Plotly):
             layout: The layout of the graph.
             template: The template for visual appearance of the graph.
             config: The config of the graph.
+            locale: The locale code used for Plotly formatting and modebar labels.
             use_resize_handler: If true, the graph will resize when the window is resized.
             style: The style of the component.
             key: A unique key for the component.
@@ -948,7 +964,7 @@ class PlotlyFinance(Plotly):
         """
 
 class PlotlyStrict(Plotly):
-    def add_imports(self) -> ImportDict | list[ImportDict]: ...
+    def add_imports(self) -> ImportDict: ...
     @classmethod
     def create(
         cls,
@@ -957,6 +973,7 @@ class PlotlyStrict(Plotly):
         layout: Var[dict] | dict | None = None,
         template: Any | Var[Any] | None = None,
         config: Var[dict] | dict | None = None,
+        locale: Var[str] | str | None = None,
         use_resize_handler: Var[bool] | bool | None = None,
         style: Sequence[Mapping[str, Any]]
         | Mapping[str, Any]
@@ -1012,6 +1029,7 @@ class PlotlyStrict(Plotly):
             layout: The layout of the graph.
             template: The template for visual appearance of the graph.
             config: The config of the graph.
+            locale: The locale code used for Plotly formatting and modebar labels.
             use_resize_handler: If true, the graph will resize when the window is resized.
             style: The style of the component.
             key: A unique key for the component.