geovizpy 0.1.7__py3-none-any.whl → 0.1.8__py3-none-any.whl

docs/source/conf.py

@@ -0,0 +1,32 @@
+# Configuration file for the Sphinx documentation builder.
+import os
+import sys
+sys.path.insert(0, os.path.abspath('../../'))
+
+project = 'geovizpy'
+copyright = '2026, fbxyz'
+author = 'fbxyz'
+release = '0.1.3'
+
+# -- General configuration ---------------------------------------------------
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.napoleon',
+    'sphinx.ext.viewcode',
+    'sphinx.ext.githubpages',
+]
+
+templates_path = ['_templates']
+exclude_patterns = []
+
+# -- Options for HTML output -------------------------------------------------
+try:
+    import sphinx_rtd_theme
+    html_theme = 'sphinx_rtd_theme'
+except ImportError:
+    html_theme = 'alabaster'
+
+html_static_path = ['_static']
+
+# -- Options for autodoc -----------------------------------------------------
+autodoc_member_order = 'bysource'

examples/advanced_plots.py

@@ -0,0 +1,82 @@
+"""Example script demonstrating advanced plot types."""
+
+import json
+import os
+import random
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"{data_path} not found.")
+    world_data = {}
+
+continents = ["Africa", "Asia", "Europe", "North America", "South America", "Oceania"]
+symbols_list = ["star", "circle", "cross", "diamond", "square", "triangle"]
+
+for f in world_data.get("features", []):
+    f["properties"]["random_continent"] = random.choice(continents)
+    f["properties"]["random_symbol"] = random.choice(symbols_list)
+
+# 1. Typology Map
+viz1 = Geoviz(projection="EqualEarth", width=800)
+viz1.outline()
+viz1.graticule(stroke="white", strokeWidth=0.4)
+
+viz1.typo(
+    data=world_data,
+    var="random_continent",
+    colors="Pastel",
+    strokeWidth=0.5,
+    leg_title="Random Continent",
+    leg_pos=[10, 200]
+)
+viz1.header(text="Typology Map (Random Data)", fontSize=20)
+viz1.render_html(os.path.join(output_dir, "advanced_typo.html"))
+
+# 2. Proportional Symbols with Typology
+viz2 = Geoviz(projection="EqualEarth", width=800)
+viz2.outline()
+viz2.graticule()
+viz2.path(datum=world_data, fill="#eee")
+
+viz2.proptypo(
+    data=world_data,
+    var1="pop",
+    var2="random_continent",
+    k=50,
+    colors="Set1",
+    leg1_title="Population",
+    leg2_title="Continent",
+    leg1_pos=[10, 300],
+    leg2_pos=[10, 150]
+)
+viz2.header(text="Proportional Symbols + Typology", fontSize=20)
+viz2.render_html(os.path.join(output_dir, "advanced_proptypo.html"))
+
+# 3. Symbol Map
+viz3 = Geoviz(projection="EqualEarth", width=800)
+viz3.outline()
+viz3.graticule()
+viz3.path(datum=world_data, fill="#ddd")
+
+viz3.picto(
+    data=world_data,
+    var="random_symbol",
+    symbols=["star", "circle", "cross", "diamond", "square", "triangle"],
+    colors="black",
+    fill="red",
+    stroke="white",
+    strokeWidth=1,
+    k=15,
+    leg_title="Random Symbols",
+    leg_pos=[10, 200]
+)
+viz3.header(text="Symbol Map (Picto)", fontSize=20)
+viz3.render_html(os.path.join(output_dir, "advanced_symbol.html"))

examples/bubble.py

@@ -0,0 +1,46 @@
+"""Example script for creating a proportional symbol map (bubble map)."""
+
+import json
+import os
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"{data_path} not found.")
+    world_data = {}
+
+viz = Geoviz(projection="EqualEarth", zoomable=True)
+viz.outline()
+viz.graticule(stroke="white", strokeWidth=0.4)
+viz.path(datum=world_data, fill="white", fillOpacity=0.4)
+
+# Use viz.prop instead of viz.circle to get automatic legend handling
+viz.prop(
+    data=world_data,
+    var="pop", # 'var' is used instead of 'r' in viz.prop
+    fill="#f07d75",
+    tip="(d) => `${d.properties.NAMEen}\n${d.properties.pop / 1000} thousands inh.`",
+    leg_type="separate",
+    leg_title="Population",
+    leg_pos=[30, 30], # Added position to make sure it's visible
+    leg_title_fontSize=15
+)
+
+pops = [f["properties"]["pop"] for f in world_data.get("features", []) if "pop" in f["properties"]]
+
+viz.header(
+    fontSize=30,
+    text="A World Map With Bubbles",
+    fill="#267A8A",
+    fontWeight="bold",
+    fontFamily="Tangerine"
+)
+
+viz.render_html(os.path.join(output_dir, "bubble.html"))

examples/choropleth.py

@@ -0,0 +1,45 @@
+"""Example script for a choropleth map."""
+
+import json
+import os
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"{data_path} not found.")
+    world_data = {}
+
+viz = Geoviz(projection="EqualEarth")
+viz.outline()
+viz.graticule(stroke="white", step=30, strokeWidth=1.2)
+
+viz.choro(
+    data=world_data,
+    var="gdppc",
+    strokeWidth=0.3,
+    tip=True,
+    leg_type="horizontal",
+    leg_title="GDP per capita",
+    leg_subtitle="($ per inh.)",
+    leg_note="Source: worldbank, 2020",
+    leg_pos=[410, 370],
+    leg_values_round=0,
+    leg_missing_text="Missing values"
+)
+
+viz.header(
+    fontSize=30,
+    text="A Choropleth World Map",
+    fill="#267A8A",
+    fontWeight="bold",
+    fontFamily="Tangerine"
+)
+
+viz.render_html(os.path.join(output_dir, "choropleth.html"))

examples/choropleth_effect.py

@@ -0,0 +1,62 @@
+"""Example script demonstrating visual effects (shadow)."""
+
+import json
+import os
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"{data_path} not found.")
+    world_data = {}
+
+brazil = {
+    "type": "FeatureCollection",
+    "features": [f for f in world_data.get("features", []) if f["properties"].get("NAMEen") == "Brazil"]
+}
+
+viz = Geoviz(projection="EqualEarth")
+
+viz.effect_shadow(id="myshadow", dx=10, dy=10, opacity=0.5)
+
+viz.outline()
+viz.graticule(stroke="white", step=30, strokeWidth=1.2)
+
+viz.choro(
+    data=world_data,
+    var="gdppc",
+    strokeWidth=0.3,
+    tip=True,
+    leg_type="horizontal",
+    leg_title="GDP per capita",
+    leg_subtitle="($ per inh.)",
+    leg_note="Source: worldbank, 2020",
+    leg_pos=[410, 370],
+    leg_values_round=0,
+    leg_missing_text="Missing values"
+)
+
+if brazil["features"]:
+    viz.path(
+        data=brazil,
+        fill="none",
+        stroke="red",
+        strokeWidth=2,
+        filter="url(#myshadow)"
+    )
+
+viz.header(
+    fontSize=30,
+    text="Choropleth with Shadow Effect on Brazil",
+    fill="#267A8A",
+    fontWeight="bold",
+    fontFamily="Tangerine"
+)
+
+viz.render_html(os.path.join(output_dir, "choropleth_effect.html"))

examples/json_export.py

@@ -0,0 +1,37 @@
+"""Example script for exporting the map configuration to JSON."""
+
+import json
+import os
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"{data_path} not found.")
+    world_data = {}
+
+viz = Geoviz(projection="EqualEarth")
+viz.outline()
+viz.graticule(stroke="white", strokeWidth=0.4)
+viz.choro(
+    data=world_data,
+    var="gdppc",
+    strokeWidth=0.3,
+    tip=True,
+    leg_title="GDP per capita"
+)
+viz.header(text="Map from JSON Config", fontSize=30)
+
+config_json = viz.to_json()
+print("Configuration JSON (first 500 chars):")
+print(config_json[:500] + "...")
+
+with open(os.path.join(output_dir, "map_config.json"), "w") as f:
+    f.write(config_json)
+print(f"\nConfiguration saved to {os.path.join(output_dir, 'map_config.json')}")

examples/labels.py

@@ -0,0 +1,43 @@
+"""Example script for adding text labels to a map."""
+
+import json
+import os
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"{data_path} not found.")
+    world_data = {}
+
+countries_to_label = ["Brazil", "China", "United States", "France", "South Africa", "Australia"]
+labeled_features = [f for f in world_data.get("features", []) if f["properties"].get("NAMEen") in countries_to_label]
+labeled_data = {"type": "FeatureCollection", "features": labeled_features}
+
+viz = Geoviz(projection="EqualEarth")
+viz.outline()
+viz.graticule(stroke="white", strokeWidth=0.4)
+
+viz.path(datum=world_data, fill="#e0e0e0", stroke="white")
+
+viz.text(
+    data=labeled_data,
+    text="NAMEen",
+    fill="#333",
+    fontSize=14,
+    fontWeight="bold",
+    stroke="white",
+    strokeWidth=3,
+    paintOrder="stroke"
+)
+
+
+
+viz.header(text="Map with Labels", fontSize=20)
+viz.render_html(os.path.join(output_dir, "labels.html"))

examples/layer_control.py

@@ -0,0 +1,70 @@
+"""Example script for layer control and export functionality."""
+
+import json
+import os
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+# Load world data
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"{data_path} not found.")
+    world_data = {}
+
+# Create a map
+viz = Geoviz(projection="EqualEarth", zoomable=True)
+viz.outline(id="outline")
+viz.graticule(stroke="white", strokeWidth=0.4, id="graticule")
+
+# Add a choropleth layer with an ID and legend position
+viz.choro(
+    data=world_data,
+    var="gdppc",
+    colors="Reds",
+    id="choropleth_gdp",
+    legend=True,
+    leg_title="GDP per Capita",
+    leg_pos=[10, 100]  # Position for the choro legend
+)
+
+# Add a proportional symbol layer with an ID and legend position
+viz.prop(
+    data=world_data,
+    var="pop",
+    fill="#4f8a8b",
+    stroke="white",
+    id="prop_population",
+    legend=True,
+    leg_title="Population",
+    leg_pos=[10, 250]  # Position for the prop legend
+)
+
+# Add the layer control widget (hover to expand)
+viz.add_layer_control(
+    layers=["choropleth_gdp", "prop_population", "graticule"],
+    title="Layers",
+    x=10,
+    y=10
+)
+
+# Add the export control widget (hover to expand)
+viz.add_export_control(
+    pos="top-right" # Or use x, y
+)
+
+# Add opacity control for multiple layers
+viz.add_opacity_control(
+    layers=["choropleth_gdp", "prop_population"],
+    title="Layers Opacity",
+    x=10,
+    y=90
+)
+
+viz.header(text="Map with Layer & Export Controls", fontSize=20)
+viz.render_html(os.path.join(output_dir, "layer_control_map.html"))

examples/lines.py

@@ -0,0 +1,74 @@
+"""Example script demonstrating how to draw lines on a map."""
+
+import json
+import os
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"{data_path} not found.")
+    world_data = {}
+
+lines_data = {
+    "type": "FeatureCollection",
+    "features": [
+        {
+            "type": "Feature",
+            "properties": {"destination": "New York", "type": "Long-haul"},
+            "geometry": {
+                "type": "LineString",
+                "coordinates": [[2.35, 48.85], [-74.00, 40.71]]
+            }
+        },
+        {
+            "type": "Feature",
+            "properties": {"destination": "Beijing", "type": "Long-haul"},
+            "geometry": {
+                "type": "LineString",
+                "coordinates": [[2.35, 48.85], [116.40, 39.90]]
+            }
+        },
+        {
+            "type": "Feature",
+            "properties": {"destination": "Cape Town", "type": "Long-haul"},
+            "geometry": {
+                "type": "LineString",
+                "coordinates": [[2.35, 48.85], [18.42, -33.92]]
+            }
+        },
+        {
+            "type": "Feature",
+            "properties": {"destination": "Moscow", "type": "Medium-haul"},
+            "geometry": {
+                "type": "LineString",
+                "coordinates": [[2.35, 48.85], [37.61, 55.75]]
+            }
+        }
+    ]
+}
+
+viz = Geoviz(projection="EqualEarth")
+viz.outline()
+viz.graticule(stroke="white", strokeWidth=0.4)
+
+viz.path(datum=world_data, fill="#e0e0e0", stroke="white")
+
+viz.typo(
+    data=lines_data,
+    var="destination",
+    colors="Set1",
+    strokeWidth=2,
+    fill="none",
+    leg_title="Routes from Paris",
+    leg_pos=[10, 250]
+)
+
+viz.header(text="Map with Lines (Routes)", fontSize=20)
+viz.render_html(os.path.join(output_dir, "lines.html"))

examples/reactive.py

@@ -0,0 +1,37 @@
+"""Example script for a reactive map (zoomable)."""
+
+import json
+import os
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"{data_path} not found.")
+    world_data = {}
+
+viz = Geoviz(projection="polar", width=700, zoomable=True)
+viz.outline()
+viz.graticule(stroke="white", strokeWidth=0.4)
+viz.path(datum=world_data, fill="white", fillOpacity=0.3)
+
+viz.prop(
+    id="bubbles",
+    symbol="circle",
+    data=world_data,
+    var="pop",
+    fill="#F13C47",
+    dodge=False,
+    k=50,
+    leg_title="Population",
+    tip=True
+)
+
+print("Generating a static snapshot of the map.")
+viz.render_html(os.path.join(output_dir, "reactive_snapshot.html"))

examples/simple.py

@@ -0,0 +1,38 @@
+"""Example script for a simple world map."""
+
+import json
+import os
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+# Load geojson
+# Assuming running from repo root or examples folder
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"{data_path} not found.")
+    world_data = {}
+
+viz = Geoviz(projection="EqualEarth")
+viz.outline(fill="#267A8A")
+viz.graticule(stroke="white", strokeWidth=0.4)
+viz.path(
+    data=world_data,
+    fill="#F8D993",
+    stroke="#ada9a6",
+    strokeWidth=0.5,
+    tip="$NAMEen"
+)
+viz.header(
+    fontSize=30,
+    text="A Simple World Map",
+    fill="#267A8A",
+    fontWeight="bold",
+    fontFamily="Tangerine"
+)
+viz.render_html(os.path.join(output_dir, "simple.html"))

examples/tiles.py

@@ -0,0 +1,47 @@
+"""Example script demonstrating how to use tile layers."""
+
+import json
+import os
+from geovizpy import Geoviz
+
+# Define output directory
+output_dir = os.path.join(os.path.dirname(__file__), "html")
+os.makedirs(output_dir, exist_ok=True)
+
+data_path = os.path.join(os.path.dirname(__file__), "data", "world.json")
+try:
+    with open(data_path) as f:
+        world_data = json.load(f)
+except FileNotFoundError:
+    print(f"Data file not found: {data_path}")
+    world_data = {}
+
+viz = Geoviz(projection="mercator", zoomable=True)
+
+# Use the keyword for the tile layer, as per geoviz.js documentation
+viz.tile(url="worldStreet")
+
+viz.graticule(stroke="white", strokeWidth=0.4)
+
+# This line might fail if world_data is empty
+if world_data:
+    viz.prop(
+        data=world_data,
+        var="pop",
+        fill="#f07d75",
+        tip="$NAMEen",
+        leg_title="Population",
+        leg_frame=True,
+        leg_pos=[30, 30]
+    )
+
+viz.text(
+    pos=[0,0],
+    text="Source: INSEE 2022",
+    fontSize=10,
+    fill="#666",
+    anchor="end"
+)
+
+
+viz.render_html(os.path.join(output_dir, "tiles.html"))

geovizpy/controls.py

@@ -29,3 +29,23 @@ class ControlsMixin:
         """
         self.export_control_config = {"pos": pos, "x": x, "y": y, "title": title}
         return self
+
+    def add_opacity_control(self, layers, pos=None, x=10, y=90, title="Opacity"):
+        """
+        Add a slider to control the opacity of one or multiple layers.
+        
+        Args:
+            layers (string or list): The ID(s) of the layer(s) to control.
+            pos (string): Predefined position ("top-right", "top-left", etc.). Overrides x, y.
+            x (int): X position of the control.
+            y (int): Y position of the control.
+            title (string): Title of the control.
+        """
+        if not hasattr(self, "opacity_control_configs"):
+            self.opacity_control_configs = []
+        
+        if isinstance(layers, str):
+            layers = [layers]
+            
+        self.opacity_control_configs.append({"layers": layers, "pos": pos, "x": x, "y": y, "title": title})
+        return self

geovizpy/geoviz.py

@@ -6,7 +6,6 @@ from .legends import LegendsMixin
 from .effects import EffectsMixin
 from .controls import ControlsMixin
 from .renderer import RendererMixin
-from .insets import InsetsMixin
 
 class Geoviz(
     MarksMixin,
@@ -14,8 +13,7 @@ class Geoviz(
     LegendsMixin,
     EffectsMixin,
     ControlsMixin,
-    RendererMixin,
-    InsetsMixin
+    RendererMixin
 ):
     """
     A Python wrapper for the geoviz JavaScript library.
@@ -38,6 +36,7 @@ class Geoviz(
         self.commands.append({"name": "create", "args": kwargs})
         self.layer_control_config = None
         self.export_control_config = None
+        self.opacity_control_configs = []
 
     def _add_command(self, name, args):
         """Add a command to the list of commands to be executed."""

geovizpy/insets.py

@@ -1,20 +0,0 @@
-"""Module for creating inset maps."""
-
-class InsetsMixin:
-    """Mixin class for adding inset map functionality."""
-
-    def inset(self, **kwargs):
-        """
-        Add an inset map to the main map.
-
-        Args:
-            pos (list): [x, y] position of the inset.
-            width (int): Width of the inset SVG.
-            height (int): Height of the inset SVG.
-            domain (object): GeoJSON to define the domain of the inset.
-            projection (string): Projection name for the inset.
-            outline (dict): Dictionary for outline properties (e.g., {"stroke": "black", "strokeWidth": 2}).
-        """
-        # The actual creation of the inset will be handled in the JavaScript renderer,
-        # where the `geoviz.create` function will be called with the main SVG as parent.
-        return self._add_command("inset.create", kwargs)

geovizpy/renderer.py

@@ -18,7 +18,7 @@ class RendererMixin:
             for k, v in args.items():
                 if v is None:
                     continue
-                if isinstance(v, str) and (v.strip().startswith("(") or v.strip().startswith("function") or "=>" in v):
+                if isinstance(v, str) and (v.strip().startswith("(") or v.strip().startswith("function") or "=>" in v or v.strip().startswith("d3.")):
                      new_args[k] = {"__js_func__": v}
                 elif isinstance(v, dict):
                     new_args[k] = process_args(v)
@@ -42,6 +42,7 @@ class RendererMixin:
         
         layer_control_js = self._get_layer_control_js()
         export_control_js = self._get_export_control_js()
+        opacity_control_js = self._get_opacity_control_js()
 
         return f"""
 <!DOCTYPE html>
@@ -58,6 +59,7 @@ class RendererMixin:
   </style>
 </head>
 <body>
+<div id="geoviz-container" style="position: relative; display: inline-block;"></div>
 <script>
   const commands = {json_commands};
   let svg;
@@ -94,31 +96,23 @@ class RendererMixin:
          }} else {{
             console.warn("Method " + parts[0] + " not found");
          }}
-      }} else if (parts.length === 2) {
-         if (cmd.name === "inset.create") {
-            const insetArgs = { ...cmd.args };
-            const outlineArgs = insetArgs.outline;
-            delete insetArgs.outline;
-            
-            const insetSvg = geoviz.create({ parent: svg, ...insetArgs });
-            if (outlineArgs) {
-                insetSvg.outline(outlineArgs);
-            }
-         } else if (svg[parts[0]] && svg[parts[0]][parts[1]]) {
+      }} else if (parts.length === 2) {{
+         if (svg[parts[0]] && svg[parts[0]][parts[1]]) {{
             svg[parts[0]][parts[1]](cmd.args);
-         } else {
+         }} else {{
             console.warn("Method " + cmd.name + " not found");
-         }
+         }}
       }}
     }}
   }});
 
   if (svg) {{
-    document.body.appendChild(svg.render());
+    document.getElementById("geoviz-container").appendChild(svg.render());
   }}
   
   {layer_control_js}
   {export_control_js}
+  {opacity_control_js}
 </script>
 </body>
 </html>
@@ -344,7 +338,7 @@ if __name__ == "__main__":
                 if (count > 0) {{
                     wrapper.appendChild(button);
                     wrapper.appendChild(panel);
-                    document.body.appendChild(wrapper);
+                    document.getElementById("geoviz-container").appendChild(wrapper);
                 }}
             }}
             setTimeout(createLayerControl, 100);
@@ -424,7 +418,127 @@ if __name__ == "__main__":
                 panel.appendChild(btnPNG);
                 wrapper.appendChild(button);
                 wrapper.appendChild(panel);
-                document.body.appendChild(wrapper);
+                document.getElementById("geoviz-container").appendChild(wrapper);
             }}
             setTimeout(createExportControl, 100);
         """
+
+    def _get_opacity_control_js(self):
+        if not hasattr(self, "opacity_control_configs") or not self.opacity_control_configs:
+            return ""
+        
+        js_code = ""
+        for config in self.opacity_control_configs:
+            config_json = json.dumps(config)
+            js_code += f"""
+            (function() {{
+                const opacityConfig = {config_json};
+                
+                function createOpacityControl() {{
+                    const wrapper = document.createElement("div");
+                    wrapper.style.position = "absolute";
+                    wrapper.style.zIndex = "1000";
+                    
+                    const button = document.createElement("div");
+                    button.innerHTML = `<svg width="24" height="24" viewBox="0 0 24 24" fill="#333"><path d="M17.66 8L12 2.35 6.34 8C4.78 9.56 4 11.64 4 13.64s.78 4.11 2.34 5.66 3.61 2.35 5.66 2.35 4.1-.79 5.66-2.35S20 15.64 20 13.64 19.22 9.56 17.66 8zM6 14c.01-2 .62-3.27 1.76-4.4L12 5.27l4.24 4.38C17.38 10.77 17.99 12 18 14H6z"/></svg>`;
+                    button.style.width = "32px";
+                    button.style.height = "32px";
+                    button.style.cursor = "pointer";
+                    button.style.border = "1px solid #ccc";
+                    button.style.borderRadius = "4px";
+                    button.style.backgroundColor = "white";
+                    button.style.display = "flex";
+                    button.style.alignItems = "center";
+                    button.style.justifyContent = "center";
+                    button.style.boxShadow = "0 1px 3px rgba(0,0,0,0.2)";
+                    
+                    const panel = document.createElement("div");
+                    panel.style.display = "none";
+                    panel.style.backgroundColor = "white";
+                    panel.style.padding = "10px";
+                    panel.style.border = "1px solid #ccc";
+                    panel.style.borderRadius = "5px";
+                    panel.style.fontFamily = "sans-serif";
+                    panel.style.fontSize = "12px";
+                    panel.style.boxShadow = "0 2px 4px rgba(0,0,0,0.2)";
+                    panel.style.marginTop = "5px";
+                    panel.style.minWidth = "150px";
+
+                    wrapper.addEventListener("mouseenter", () => panel.style.display = "block");
+                    wrapper.addEventListener("mouseleave", () => panel.style.display = "none");
+
+                    if (opacityConfig.pos === "top-right") {{
+                        wrapper.style.top = "90px"; wrapper.style.right = "10px";
+                    }} else if (opacityConfig.pos === "bottom-right") {{
+                        wrapper.style.bottom = "90px"; wrapper.style.right = "10px";
+                    }} else {{
+                        wrapper.style.top = `${{opacityConfig.y}}px`;
+                        wrapper.style.left = `${{opacityConfig.x}}px`;
+                    }}
+                    
+                    const title = document.createElement("div");
+                    title.innerText = opacityConfig.title;
+                    title.style.fontWeight = "bold";
+                    title.style.marginBottom = "8px";
+                    title.style.borderBottom = "1px solid #eee";
+                    title.style.paddingBottom = "5px";
+                    panel.appendChild(title);
+
+                    opacityConfig.layers.forEach(layerId => {{
+                        const row = document.createElement("div");
+                        row.style.marginBottom = "10px";
+                        
+                        const label = document.createElement("div");
+                        label.innerText = layerId;
+                        label.style.fontSize = "11px";
+                        label.style.marginBottom = "2px";
+                        label.style.color = "#555";
+                        
+                        const sliderContainer = document.createElement("div");
+                        sliderContainer.style.display = "flex";
+                        sliderContainer.style.alignItems = "center";
+                        
+                        const slider = document.createElement("input");
+                        slider.type = "range";
+                        slider.min = "0";
+                        slider.max = "1";
+                        slider.step = "0.1";
+                        slider.value = "1"; // Default value
+                        slider.style.width = "100%";
+                        slider.style.cursor = "pointer";
+
+                        // Set initial slider value from layer's current opacity
+                        const layerNodeForOpacity = svg.select("#" + layerId);
+                        if (!layerNodeForOpacity.empty()) {{
+                            const firstShape = layerNodeForOpacity.select("path, circle, rect");
+                            if (!firstShape.empty()) {{
+                                slider.value = firstShape.style("fill-opacity");
+                            }}
+                        }}
+                        
+                        slider.addEventListener("input", (e) => {{
+                            const val = e.target.value;
+                            const layer = svg.select("#" + layerId);
+                            if (!layer.empty()) {{
+                                layer.selectAll("path, circle, rect").style("fill-opacity", val);
+                            }}
+                            const legLayer = svg.select("#leg_" + layerId);
+                            if (!legLayer.empty()) {{
+                                legLayer.selectAll("path, circle, rect").style("fill-opacity", val);
+                            }}
+                        }});
+                        
+                        sliderContainer.appendChild(slider);
+                        row.appendChild(label);
+                        row.appendChild(sliderContainer);
+                        panel.appendChild(row);
+                    }});
+                    
+                    wrapper.appendChild(button);
+                    wrapper.appendChild(panel);
+                    document.getElementById("geoviz-container").appendChild(wrapper);
+                }}
+                setTimeout(createOpacityControl, 100);
+            }})();
+            """
+        return js_code

{geovizpy-0.1.7.dist-info → geovizpy-0.1.8.dist-info}/METADATA

@@ -1,118 +1,112 @@
-Metadata-Version: 2.4
-Name: geovizpy
-Version: 0.1.7
-Summary: A Python wrapper for the geoviz JavaScript library
-Author: fbxyz
-Project-URL: Source, https://codeberg.org/fbxyz/geovizpy
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Provides-Extra: export
-Requires-Dist: playwright; extra == "export"
-Dynamic: author
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: requires-python
-Dynamic: summary
-
-# geovizpy
-
-**geovizpy** is a Python wrapper for the `geoviz` JavaScript library, designed to bring the power of D3.js-based thematic mapping to Python. It allows you to create high-quality, interactive maps directly from Python scripts or Jupyter notebooks.
-
-This library is a wrapper around the  `geoviz` library. For detailed information on the underlying mapping logic, please refer to the [original geoviz documentation](https://github.com/neocarto/geoviz).
-
-![Choropleth Map Example](https://codeberg.org/fbxyz/geovizpy/raw/branch/main/docs/source/_static/choropleth.png)
-
-## Features
-
-- **Simple, chainable API**: Build complex maps by chaining intuitive methods.
-- **Variety of Map Types**: Create choropleth, proportional symbol, typology, and other thematic maps.
-- **Interactive Controls**: Add hover-to-expand controls for toggling layer visibility and exporting the map as SVG or PNG.
-- **Customizable**: Extensive options to customize colors, legends, strokes, and more.
-- **Standalone HTML**: Renders self-contained HTML files with no server required.
-- **Image Export**: Save maps directly to PNG or SVG from Python (requires optional dependencies).
-
-## Installation
-
-### Standard Installation
-
-You can install the core library using pip:
-
-```bash
-pip install geovizpy
-```
-
-Or install directly from the source repository:
-
-```bash
-pip install git+https://codeberg.org/fbxyz/geovizpy.git
-```
-
-### For Image Export
-
-To save maps as PNG or SVG files directly from Python, you need to install the optional `export` dependencies:
-
-1.  **Install the extra dependencies:**
-
-    ```bash
-    pip install "geovizpy[export]"
-    ```
-
-2.  **Install Playwright's browser binaries:**
-
-    ```bash
-    playwright install
-    ```
-
-    On Linux, you may also need to install host dependencies:
-    
-    ```bash
-    sudo playwright install-deps
-    ```
-
-## Quick Start
-
-Here is a simple example of how to create a choropleth map:
-
-```python
-from geovizpy import Geoviz
-import json
-
-# Load your GeoJSON data
-# (Assuming 'world.json' is in a 'data' subdirectory)
-with open("data/world.json") as f:
-    world_data = json.load(f)
-
-# Initialize the map
-viz = Geoviz(projection="EqualEarth", width=800)
-
-# Add layers
-viz.outline()
-viz.graticule()
-
-# Add a choropleth layer
-viz.choro(
-    data=world_data,
-    var="gdppc",
-    colors="Blues",
-    legend=True,
-    leg_title="GDP per Capita"
-)
-
-# Add interactive controls
-viz.add_layer_control(layers=["choropleth_gdp"])
-viz.add_export_control()
-
-# Save the map
-viz.save("my_map.html")  # Renders an interactive HTML file
-# viz.save("my_map.png")   # Renders a static PNG image (requires export dependencies)
-```
-
-## Documentation
-
-For more detailed information on all available methods and parameters, please see the [full documentation](https://geovizpy.readthedocs.io/en/latest/).
+Metadata-Version: 2.4
+Name: geovizpy
+Version: 0.1.8
+Summary: A Python wrapper for the geoviz JavaScript library
+Author: fbxyz
+License: MIT
+Project-URL: Source, https://codeberg.org/fbxyz/geovizpy
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Provides-Extra: export
+Requires-Dist: playwright; extra == "export"
+Dynamic: requires-python
+
+# geovizpy
+
+**geovizpy** is a Python wrapper for the `geoviz` JavaScript library, designed to bring the power of D3.js-based thematic mapping to Python. It allows you to create high-quality, interactive maps directly from Python scripts or Jupyter notebooks.
+
+This library is a wrapper around the  `geoviz` library. For detailed information on the underlying mapping logic, please refer to the [original geoviz documentation](https://github.com/neocarto/geoviz).
+
+![Choropleth Map Example](https://codeberg.org/fbxyz/geovizpy/raw/branch/main/docs/source/_static/choropleth.png)
+
+## Features
+
+- **Simple, chainable API**: Build complex maps by chaining intuitive methods.
+- **Variety of Map Types**: Create choropleth, proportional symbol, typology, and other thematic maps.
+- **Interactive Controls**: Add hover-to-expand controls for toggling layer visibility and exporting the map as SVG or PNG.
+- **Customizable**: Extensive options to customize colors, legends, strokes, and more.
+- **Standalone HTML**: Renders self-contained HTML files with no server required.
+- **Image Export**: Save maps directly to PNG or SVG from Python (requires optional dependencies).
+
+## Installation
+
+### Standard Installation
+
+You can install the core library using pip:
+
+```bash
+pip install geovizpy
+```
+
+Or install directly from the source repository:
+
+```bash
+pip install git+https://codeberg.org/fbxyz/geovizpy.git
+```
+
+### For Image Export
+
+To save maps as PNG or SVG files directly from Python, you need to install the optional `export` dependencies:
+
+1.  **Install the extra dependencies:**
+
+    ```bash
+    pip install "geovizpy[export]"
+    ```
+
+2.  **Install Playwright's browser binaries:**
+
+    ```bash
+    playwright install
+    ```
+
+    On Linux, you may also need to install host dependencies:
+    
+    ```bash
+    sudo playwright install-deps
+    ```
+
+## Quick Start
+
+Here is a simple example of how to create a choropleth map:
+
+```python
+from geovizpy import Geoviz
+import json
+
+# Load your GeoJSON data
+# (Assuming 'world.json' is in a 'data' subdirectory)
+with open("data/world.json") as f:
+    world_data = json.load(f)
+
+# Initialize the map
+viz = Geoviz(projection="EqualEarth", width=800)
+
+# Add layers
+viz.outline()
+viz.graticule()
+
+# Add a choropleth layer
+viz.choro(
+    data=world_data,
+    var="gdppc",
+    colors="Blues",
+    legend=True,
+    leg_title="GDP per Capita"
+)
+
+# Add interactive controls
+viz.add_layer_control(layers=["choropleth_gdp"])
+viz.add_export_control()
+
+# Save the map
+viz.save("my_map.html")  # Renders an interactive HTML file
+# viz.save("my_map.png")   # Renders a static PNG image (requires export dependencies)
+```
+
+## Documentation
+
+For more detailed information on all available methods and parameters, please see the [full documentation](https://geovizpy.readthedocs.io/en/latest/).

geovizpy-0.1.8.dist-info/RECORD

@@ -0,0 +1,25 @@
+docs/source/conf.py,sha256=5ki8cc3YgZ76akTNYXTsnrnzWa-GGYDllwKHXji9J_I,815
+examples/advanced_plots.py,sha256=1HlsJjYtyHMv1HvQwrSttB5c_5SlrXyQ7eX6c1XDbxc,2283
+examples/bubble.py,sha256=N_ulY0hCj13XwQ4oWFt7ZFg5QmOAcp1JsZ_GCvrDHEg,1363
+examples/choropleth.py,sha256=u9JgDyeckyIYw748R6kKgbjVQKpTknmlSBH98fY1j4Q,1062
+examples/choropleth_effect.py,sha256=ReMWWSGi7pYNQ9cOsFO2rUgLdML27fdLSZt38rO_AmQ,1480
+examples/json_export.py,sha256=MV5xvYrkPgIJRsDnk5iiRSN-DHVaVFbOtvuw3We0PVM,1024
+examples/labels.py,sha256=Ql62vtqya-Dv8e-tDWhnSogJcG9Ku6A64WLIxm9mDJU,1194
+examples/layer_control.py,sha256=D0dlqxFY_K9uGIfp4bbt_9ux5xisZzek8wN7Wj5aTXY,1771
+examples/lines.py,sha256=sOrYm4d1lEGICSnU_22zc6g2aDgiL6-61506GJJXRWw,2064
+examples/reactive.py,sha256=V6w9J-9yNEp52X5orUiH4ZQ3jQ8idAm4Z-VVfcwByOM,932
+examples/simple.py,sha256=EP-iqlPZGCu5x7zBKXrhmOR18hC25mdZ1EpCGYoWMPM,936
+examples/tiles.py,sha256=sUq7xDxd-ZO0mraQq98-oTCce3oasAlhfCo6CvkCmaw,1095
+geovizpy/__init__.py,sha256=gvgVlK5oB6meBmYgXkXFVohPKkO3ev9UupPA8BQNzYg,120
+geovizpy/controls.py,sha256=aFF60_ZcZ_NHVb1IeQJDRTmcqXXLk1oO-oLrr2eX7NI,2155
+geovizpy/effects.py,sha256=6F78g0IJEbEG8EsKurmBapE8UX0sho7zKHDnzqJ0ci0,1433
+geovizpy/geoviz.py,sha256=M_0_TisSDLvVy4lRDo1i3nBwVCoOcEXrMnt3xdr7k-o,1457
+geovizpy/insets.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+geovizpy/legends.py,sha256=IPn_1drQ9MkmJlQ54XwBqAlTRSyq98sm8gzgE-ATRog,2218
+geovizpy/marks.py,sha256=xqwf8ELY05lnrrXGQljMe-mm315vUt_-qOmdFAsYhwA,5520
+geovizpy/plots.py,sha256=EVjPPBFyUFQpXH7sAuxCz_sctonJVUxoi8edbehKrpI,3089
+geovizpy/renderer.py,sha256=BXiDLMh3pHFzMOtUPT6j-g9XdGhTkonZGr9UwY__Vmo,23198
+geovizpy-0.1.8.dist-info/METADATA,sha256=hGc9qq-Kc-cHGjNtFbv2_f8F7fxMI8sM8P1gbEAJ1-A,3323
+geovizpy-0.1.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+geovizpy-0.1.8.dist-info/top_level.txt,sha256=A35IMflZV2CCs6n081ygN9VFsh9z2zN3zghfZ_8fVmk,34
+geovizpy-0.1.8.dist-info/RECORD,,

{geovizpy-0.1.7.dist-info → geovizpy-0.1.8.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.2)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

geovizpy-0.1.8.dist-info/top_level.txt

@@ -0,0 +1,4 @@
+docs
+examples
+geoviz_src
+geovizpy

geovizpy-0.1.7.dist-info/RECORD

@@ -1,13 +0,0 @@
-geovizpy/__init__.py,sha256=gvgVlK5oB6meBmYgXkXFVohPKkO3ev9UupPA8BQNzYg,120
-geovizpy/controls.py,sha256=pvSrbrkgyB8VURVXED3Etou3Wk2wfWB5p4nnvHLFrgM,1319
-geovizpy/effects.py,sha256=6F78g0IJEbEG8EsKurmBapE8UX0sho7zKHDnzqJ0ci0,1433
-geovizpy/geoviz.py,sha256=nSkblpSf7MeHtdNhkC-g9ltByBaLCbIjW1URVizeMv0,1464
-geovizpy/insets.py,sha256=ljraMXuPGhyPLfkkA9y7Io6fIQGD7j2dU44F9ZvM8pM,861
-geovizpy/legends.py,sha256=IPn_1drQ9MkmJlQ54XwBqAlTRSyq98sm8gzgE-ATRog,2218
-geovizpy/marks.py,sha256=xqwf8ELY05lnrrXGQljMe-mm315vUt_-qOmdFAsYhwA,5520
-geovizpy/plots.py,sha256=EVjPPBFyUFQpXH7sAuxCz_sctonJVUxoi8edbehKrpI,3089
-geovizpy/renderer.py,sha256=51jdjvR2uHr6fFeCOUHC1lCl8ayp7hU2yN5gD-f9rSg,16905
-geovizpy-0.1.7.dist-info/METADATA,sha256=RxFZorl1X5yKz1CyiZu3egebipETy6BwjO0lQMqjCWE,3581
-geovizpy-0.1.7.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-geovizpy-0.1.7.dist-info/top_level.txt,sha256=3D5AFdMd9bWEvGQUWDy6jccJamUwdKmchgCmxLHaAYs,9
-geovizpy-0.1.7.dist-info/RECORD,,

geovizpy-0.1.7.dist-info/top_level.txt

@@ -1 +0,0 @@
-geovizpy