multilayer-sdk 0.1.0__tar.gz

multilayer_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yusuf Eminoğlu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

multilayer_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: multilayer-sdk
+Version: 0.1.0
+Summary: Pure-Python Synchronized Multi-Panel Map Visualization, Spatial Comparison Engine, and Interactive Dashboard Builder.
+Author-email: Yusuf Eminoğlu <yusufeminoglu@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/YusufEminoglu/multilayer-sdk
+Project-URL: Repository, https://github.com/YusufEminoglu/multilayer-sdk
+Project-URL: Issues, https://github.com/YusufEminoglu/multilayer-sdk/issues
+Project-URL: Documentation, https://yusufeminoglu.github.io/multilayer-sdk/
+Project-URL: Changelog, https://github.com/YusufEminoglu/multilayer-sdk/blob/main/CHANGELOG.md
+Keywords: gis,multimap,multilayer,geovisualization,spatial-comparison,synchronized-maps,side-by-side,curtain-swipe,geojson,geopandas,leaflet,dashboard,urban-planning,headless
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Multimedia :: Graphics :: Presentation
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: geo
+Requires-Dist: shapely>=2.0.0; extra == "geo"
+Requires-Dist: geopandas>=0.12.0; extra == "geo"
+Requires-Dist: matplotlib>=3.5.0; extra == "geo"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<img src="docs/icons/logo.svg" width="128" height="128" alt="multilayer-sdk Logo" style="filter: drop-shadow(0 12px 24px rgba(16,185,129,0.3));"/>
+
+# multilayer-sdk
+
+**Pure-Python Synchronized Multi-Panel Map Visualization, Spatial Comparison Engine & Interactive Dashboard Builder.**
+
+[![PyPI Version](https://img.shields.io/pypi/v/multilayer-sdk.svg?color=10b981&label=PyPI%20package)](https://pypi.org/project/multilayer-sdk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/multilayer-sdk.svg?color=06b6d4)](https://pypi.org/project/multilayer-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![CI](https://github.com/YusufEminoglu/multilayer-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/YusufEminoglu/multilayer-sdk/actions)
+[![Documentation](https://img.shields.io/badge/Docs-GitHub%20Pages-blueviolet?logo=github)](https://yusufeminoglu.github.io/multilayer-sdk/)
+
+<br/>
+
+<img src="docs/assets/hero.svg" width="100%" alt="multilayer-sdk Architecture"/>
+
+</div>
+
+---
+
+## 🌟 Overview
+
+**multilayer-sdk** (the headless Python core behind **02Multimap**) allows urban planners, spatial data scientists, and researchers to visualize, cross-analyze, and compare multiple spatial datasets side-by-side with millisecond synchronization.
+
+Instead of toggling layers on and off in a single map, `multilayer` coordinates up to 8 synchronized map viewports in dynamic grids (1x2, 2x1, 1x3, 2x2, 2x3, 2x4) with:
+- **Bi-directional Pan & Zoom Broadcasting**: Drag or zoom on any panel to coordinate all others in real time.
+- **Neon Laser Crosshair Cursor Tracking**: Move your mouse over any panel to project neon-colored crosshairs tracking the exact geographic coordinate across all viewports.
+- **Graduated Thematic Choropleths**: Quantiles, Equal Interval, Natural Breaks, and Standard Deviation statistical binning with scientific palettes (`viridis`, `magma`, `plasma`, `turbo`, `cividis`, `spectral`, `rdylbu`).
+- **Interactive Split-Screen Curtain Swipe**: Draggable split slider for before/after temporal change detection.
+- **Single-File Self-Contained HTML Dashboards**: Export zero-dependency interactive HTML files ready for presentations, stakeholders, or offline field audits.
+- **Jupyter Notebook & Google Colab Integration**: Rich inline widget display via `mm.show()`.
+
+---
+
+## 🚀 Installation
+
+```bash
+pip install multilayer-sdk
+```
+
+---
+
+## ⚡ Quickstart
+
+### 1. Build a 4-Panel Synchronized Workspace
+
+```python
+import multilayer as ml
+
+# 1. Initialize a 4-panel (2x2) synchronized map grid
+mm = ml.MultiMap(grid="2x2", title="Urban Vulnerability & Land Use Assessment", basemap="carto-dark")
+
+# 2. Panel 1: High-resolution satellite imagery with study area boundary
+mm.panel(0).title = "1. Satellite Context"
+mm.panel(0).set_basemap("satellite")
+mm.panel(0).add_layer("study_area.geojson", stroke_color="#38bdf8", fill_opacity=0.2)
+
+# 3. Panel 2: Thematic choropleth of population density
+vlayer = ml.VectorLayer.from_geojson("demographics.geojson")
+pop_choro = ml.Choropleth.classify(vlayer, property_name="density_km2", method="quantiles", color_ramp="viridis")
+mm.panel(1).title = "2. Population Density"
+mm.panel(1).add_layer(pop_choro)
+
+# 4. Panel 3: Flood hazard exposure score
+risk_choro = ml.Choropleth.classify(vlayer, property_name="flood_risk_score", method="equal_interval", color_ramp="magma")
+mm.panel(2).title = "3. Flood Hazard Exposure"
+mm.panel(2).add_layer(risk_choro)
+
+# 5. Panel 4: Future 2030 Master Zoning Plan
+mm.panel(3).title = "4. Future Master Plan 2030"
+mm.panel(3).add_layer("zoning_plan.geojson", fill_color="#10b981", fill_opacity=0.6)
+
+# 6. Save as standalone interactive HTML dashboard
+mm.to_html("urban_assessment_dashboard.html")
+
+# 7. Render inline in Jupyter Notebook / Google Colab
+mm.show()
+```
+
+---
+
+### 2. Draggable Split-Screen Curtain Swipe Comparison
+
+```python
+import multilayer as ml
+
+swipe = ml.SwipeMap(
+    left_layer="landcover_2010.geojson",
+    right_layer="landcover_2026.geojson",
+    left_title="Historical (2010)",
+    right_title="Current (2026)",
+    basemap="satellite"
+)
+
+swipe.to_html("deforestation_swipe.html")
+```
+
+---
+
+## 💻 Command Line Interface (CLI)
+
+```bash
+# 1. Build a 2x2 synchronized dashboard from 4 GeoJSON files
+multilayer build --layers bldgs.geojson,roads.geojson,hazard.geojson,zoning.geojson --grid 2x2 --out city_dashboard.html --open
+
+# 2. Build a 2-panel before/after split-screen swipe comparison
+multilayer compare flood_2020.geojson flood_2026.geojson --left-title "2020 Flood" --right-title "2026 Flood" --out flood_swipe.html
+
+# 3. Inspect GeoJSON feature count, properties, and bounding box
+multilayer inspect study_area.geojson
+
+# 4. List all built-in web map tile basemaps
+multilayer tiles
+```
+
+---
+
+## ⚙️ Supported Grid Matrices
+
+| Grid Preset | Layout Dimensions | Panel Count | Primary Cartographic Use Case |
+| :--- | :--- | :--- | :--- |
+| **`1x2`** | 1 Row $\times$ 2 Columns | 2 Panels | Before/After comparisons, Suitability vs Actual zoning |
+| **`2x1`** | 2 Rows $\times$ 1 Column | 2 Panels | Vertical elevation profiles, transport corridors |
+| **`1x3`** | 1 Row $\times$ 3 Columns | 3 Panels | Past $\rightarrow$ Present $\rightarrow$ Future temporal timelines |
+| **`2x2`** | 2 Rows $\times$ 2 Columns | 4 Panels | 4-way evaluation (Base, Demographics, Hazards, Policy) |
+| **`2x3`** | 2 Rows $\times$ 3 Columns | 6 Panels | Multi-criteria evaluation (MCDA factor grids) |
+| **`2x4`** | 2 Rows $\times$ 4 Columns | 8 Panels | High-density multi-scenario sensitivity snapshots |
+
+---
+
+## 📄 Academic Citation
+
+If you use **multilayer-sdk** in scientific publications, planning projects, or research, please cite:
+
+```bibtex
+@software{eminoglu2026multilayer,
+  author    = {Emino{\\u{g}}lu, Yusuf},
+  title     = {{multilayer-sdk: Pure-Python Synchronized Multi-Panel Map Visualization, Spatial Comparison Engine, and Interactive Dashboard Builder}},
+  year      = {2026},
+  publisher = {PyPI - Python Package Index},
+  version   = {0.1.0},
+  url       = {https://github.com/YusufEminoglu/multilayer-sdk}
+}
+```
+
+---
+
+## 📜 License
+
+Distributed under the **MIT** License. Copyright (c) 2026 Yusuf Eminoğlu.

multilayer_sdk-0.1.0/README.md

@@ -0,0 +1,152 @@
+<div align="center">
+
+<img src="docs/icons/logo.svg" width="128" height="128" alt="multilayer-sdk Logo" style="filter: drop-shadow(0 12px 24px rgba(16,185,129,0.3));"/>
+
+# multilayer-sdk
+
+**Pure-Python Synchronized Multi-Panel Map Visualization, Spatial Comparison Engine & Interactive Dashboard Builder.**
+
+[![PyPI Version](https://img.shields.io/pypi/v/multilayer-sdk.svg?color=10b981&label=PyPI%20package)](https://pypi.org/project/multilayer-sdk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/multilayer-sdk.svg?color=06b6d4)](https://pypi.org/project/multilayer-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![CI](https://github.com/YusufEminoglu/multilayer-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/YusufEminoglu/multilayer-sdk/actions)
+[![Documentation](https://img.shields.io/badge/Docs-GitHub%20Pages-blueviolet?logo=github)](https://yusufeminoglu.github.io/multilayer-sdk/)
+
+<br/>
+
+<img src="docs/assets/hero.svg" width="100%" alt="multilayer-sdk Architecture"/>
+
+</div>
+
+---
+
+## 🌟 Overview
+
+**multilayer-sdk** (the headless Python core behind **02Multimap**) allows urban planners, spatial data scientists, and researchers to visualize, cross-analyze, and compare multiple spatial datasets side-by-side with millisecond synchronization.
+
+Instead of toggling layers on and off in a single map, `multilayer` coordinates up to 8 synchronized map viewports in dynamic grids (1x2, 2x1, 1x3, 2x2, 2x3, 2x4) with:
+- **Bi-directional Pan & Zoom Broadcasting**: Drag or zoom on any panel to coordinate all others in real time.
+- **Neon Laser Crosshair Cursor Tracking**: Move your mouse over any panel to project neon-colored crosshairs tracking the exact geographic coordinate across all viewports.
+- **Graduated Thematic Choropleths**: Quantiles, Equal Interval, Natural Breaks, and Standard Deviation statistical binning with scientific palettes (`viridis`, `magma`, `plasma`, `turbo`, `cividis`, `spectral`, `rdylbu`).
+- **Interactive Split-Screen Curtain Swipe**: Draggable split slider for before/after temporal change detection.
+- **Single-File Self-Contained HTML Dashboards**: Export zero-dependency interactive HTML files ready for presentations, stakeholders, or offline field audits.
+- **Jupyter Notebook & Google Colab Integration**: Rich inline widget display via `mm.show()`.
+
+---
+
+## 🚀 Installation
+
+```bash
+pip install multilayer-sdk
+```
+
+---
+
+## ⚡ Quickstart
+
+### 1. Build a 4-Panel Synchronized Workspace
+
+```python
+import multilayer as ml
+
+# 1. Initialize a 4-panel (2x2) synchronized map grid
+mm = ml.MultiMap(grid="2x2", title="Urban Vulnerability & Land Use Assessment", basemap="carto-dark")
+
+# 2. Panel 1: High-resolution satellite imagery with study area boundary
+mm.panel(0).title = "1. Satellite Context"
+mm.panel(0).set_basemap("satellite")
+mm.panel(0).add_layer("study_area.geojson", stroke_color="#38bdf8", fill_opacity=0.2)
+
+# 3. Panel 2: Thematic choropleth of population density
+vlayer = ml.VectorLayer.from_geojson("demographics.geojson")
+pop_choro = ml.Choropleth.classify(vlayer, property_name="density_km2", method="quantiles", color_ramp="viridis")
+mm.panel(1).title = "2. Population Density"
+mm.panel(1).add_layer(pop_choro)
+
+# 4. Panel 3: Flood hazard exposure score
+risk_choro = ml.Choropleth.classify(vlayer, property_name="flood_risk_score", method="equal_interval", color_ramp="magma")
+mm.panel(2).title = "3. Flood Hazard Exposure"
+mm.panel(2).add_layer(risk_choro)
+
+# 5. Panel 4: Future 2030 Master Zoning Plan
+mm.panel(3).title = "4. Future Master Plan 2030"
+mm.panel(3).add_layer("zoning_plan.geojson", fill_color="#10b981", fill_opacity=0.6)
+
+# 6. Save as standalone interactive HTML dashboard
+mm.to_html("urban_assessment_dashboard.html")
+
+# 7. Render inline in Jupyter Notebook / Google Colab
+mm.show()
+```
+
+---
+
+### 2. Draggable Split-Screen Curtain Swipe Comparison
+
+```python
+import multilayer as ml
+
+swipe = ml.SwipeMap(
+    left_layer="landcover_2010.geojson",
+    right_layer="landcover_2026.geojson",
+    left_title="Historical (2010)",
+    right_title="Current (2026)",
+    basemap="satellite"
+)
+
+swipe.to_html("deforestation_swipe.html")
+```
+
+---
+
+## 💻 Command Line Interface (CLI)
+
+```bash
+# 1. Build a 2x2 synchronized dashboard from 4 GeoJSON files
+multilayer build --layers bldgs.geojson,roads.geojson,hazard.geojson,zoning.geojson --grid 2x2 --out city_dashboard.html --open
+
+# 2. Build a 2-panel before/after split-screen swipe comparison
+multilayer compare flood_2020.geojson flood_2026.geojson --left-title "2020 Flood" --right-title "2026 Flood" --out flood_swipe.html
+
+# 3. Inspect GeoJSON feature count, properties, and bounding box
+multilayer inspect study_area.geojson
+
+# 4. List all built-in web map tile basemaps
+multilayer tiles
+```
+
+---
+
+## ⚙️ Supported Grid Matrices
+
+| Grid Preset | Layout Dimensions | Panel Count | Primary Cartographic Use Case |
+| :--- | :--- | :--- | :--- |
+| **`1x2`** | 1 Row $\times$ 2 Columns | 2 Panels | Before/After comparisons, Suitability vs Actual zoning |
+| **`2x1`** | 2 Rows $\times$ 1 Column | 2 Panels | Vertical elevation profiles, transport corridors |
+| **`1x3`** | 1 Row $\times$ 3 Columns | 3 Panels | Past $\rightarrow$ Present $\rightarrow$ Future temporal timelines |
+| **`2x2`** | 2 Rows $\times$ 2 Columns | 4 Panels | 4-way evaluation (Base, Demographics, Hazards, Policy) |
+| **`2x3`** | 2 Rows $\times$ 3 Columns | 6 Panels | Multi-criteria evaluation (MCDA factor grids) |
+| **`2x4`** | 2 Rows $\times$ 4 Columns | 8 Panels | High-density multi-scenario sensitivity snapshots |
+
+---
+
+## 📄 Academic Citation
+
+If you use **multilayer-sdk** in scientific publications, planning projects, or research, please cite:
+
+```bibtex
+@software{eminoglu2026multilayer,
+  author    = {Emino{\\u{g}}lu, Yusuf},
+  title     = {{multilayer-sdk: Pure-Python Synchronized Multi-Panel Map Visualization, Spatial Comparison Engine, and Interactive Dashboard Builder}},
+  year      = {2026},
+  publisher = {PyPI - Python Package Index},
+  version   = {0.1.0},
+  url       = {https://github.com/YusufEminoglu/multilayer-sdk}
+}
+```
+
+---
+
+## 📜 License
+
+Distributed under the **MIT** License. Copyright (c) 2026 Yusuf Eminoğlu.

multilayer_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,106 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "multilayer-sdk"
+version = "0.1.0"
+authors = [
+    { name = "Yusuf Eminoğlu", email = "yusufeminoglu@gmail.com" }
+]
+description = "Pure-Python Synchronized Multi-Panel Map Visualization, Spatial Comparison Engine, and Interactive Dashboard Builder."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+keywords = [
+    "gis",
+    "multimap",
+    "multilayer",
+    "geovisualization",
+    "spatial-comparison",
+    "synchronized-maps",
+    "side-by-side",
+    "curtain-swipe",
+    "geojson",
+    "geopandas",
+    "leaflet",
+    "dashboard",
+    "urban-planning",
+    "headless",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: GIS",
+    "Topic :: Scientific/Engineering :: Visualization",
+    "Topic :: Multimedia :: Graphics :: Presentation",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+]
+dependencies = []
+
+[project.optional-dependencies]
+geo = [
+    "shapely>=2.0.0",
+    "geopandas>=0.12.0",
+    "matplotlib>=3.5.0",
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+    "build>=1.0.0",
+    "twine>=5.0.0",
+]
+
+[project.scripts]
+multilayer = "multilayer.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/YusufEminoglu/multilayer-sdk"
+Repository = "https://github.com/YusufEminoglu/multilayer-sdk"
+Issues = "https://github.com/YusufEminoglu/multilayer-sdk/issues"
+Documentation = "https://yusufeminoglu.github.io/multilayer-sdk/"
+Changelog = "https://github.com/YusufEminoglu/multilayer-sdk/blob/main/CHANGELOG.md"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+multilayer = ["py.typed"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+exclude = [
+    ".venv",
+    "build",
+    "dist",
+    "build_multilayer_docs.py",
+]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "C4"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.coverage.run]
+source = ["multilayer"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 70

multilayer_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

multilayer_sdk-0.1.0/src/multilayer/__init__.py

@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+"""
+multilayer — Pure-Python Synchronized Multi-Panel Map Visualization & Spatial Comparison Engine.
+"""
+
+from __future__ import annotations
+
+from multilayer.core import MultiMap, Panel, SwipeMap, create_multimap
+from multilayer.grid import GridLayout, GridPreset
+from multilayer.layers import (
+    Layer,
+    RasterLayer,
+    TileLayer,
+    TileProvider,
+    VectorLayer,
+    get_tile_provider,
+)
+from multilayer.symbology import (
+    CategoricalStyle,
+    Choropleth,
+    ClassificationMethod,
+    ColorRamp,
+    GraduatedStyle,
+    StyleRule,
+)
+
+__version__ = "0.1.0"
+__author__ = "Yusuf Eminoğlu"
+__email__ = "yusufeminoglu@gmail.com"
+
+__all__ = [
+    "MultiMap",
+    "Panel",
+    "SwipeMap",
+    "create_multimap",
+    "GridLayout",
+    "GridPreset",
+    "Layer",
+    "VectorLayer",
+    "RasterLayer",
+    "TileLayer",
+    "TileProvider",
+    "get_tile_provider",
+    "Choropleth",
+    "ClassificationMethod",
+    "ColorRamp",
+    "StyleRule",
+    "GraduatedStyle",
+    "CategoricalStyle",
+    "__version__",
+]

multilayer_sdk-0.1.0/src/multilayer/cli.py

@@ -0,0 +1,134 @@
+# -*- coding: utf-8 -*-
+"""Command Line Interface for multilayer-sdk."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+import webbrowser
+
+from multilayer import __version__
+from multilayer.core import MultiMap, SwipeMap
+from multilayer.layers import TileProvider, VectorLayer
+
+
+def main(args: list[str] | None = None) -> int:
+    """Main CLI entrypoint."""
+    parser = argparse.ArgumentParser(
+        prog="multilayer",
+        description="Pure-Python Synchronized Multi-Panel Map Visualization & Spatial Comparison CLI.",
+    )
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+
+    subparsers = parser.add_subparsers(dest="command", help="Available subcommands")
+
+    # Subcommand: build
+    build_parser = subparsers.add_parser("build", help="Build synchronized multi-panel HTML dashboard")
+    build_parser.add_argument("--layers", "-l", required=True, help="Comma-separated list of GeoJSON layer paths")
+    build_parser.add_argument("--grid", "-g", default="2x2", help="Grid preset: 1x2, 2x1, 1x3, 2x2, 2x3, 2x4 (default: 2x2)")
+    build_parser.add_argument("--title", "-t", default="MultiMap Workspace", help="Dashboard title")
+    build_parser.add_argument("--basemap", "-b", default="carto-dark-matter", help="Basemap provider (default: carto-dark-matter)")
+    build_parser.add_argument("--theme", default="dark", choices=["dark", "light"], help="Color theme (default: dark)")
+    build_parser.add_argument("--out", "-o", default="multimap_dashboard.html", help="Output HTML file path")
+    build_parser.add_argument("--open", action="store_true", help="Open generated HTML dashboard in default browser")
+
+    # Subcommand: compare (Swipe Map)
+    compare_parser = subparsers.add_parser("compare", help="Create split-screen curtain swipe map")
+    compare_parser.add_argument("left_layer", help="Left / Before GeoJSON file path")
+    compare_parser.add_argument("right_layer", help="Right / After GeoJSON file path")
+    compare_parser.add_argument("--left-title", default="Before", help="Left layer title")
+    compare_parser.add_argument("--right-title", default="After", help="Right layer title")
+    compare_parser.add_argument("--out", "-o", default="swipe_map.html", help="Output HTML file path")
+    compare_parser.add_argument("--open", action="store_true", help="Open generated swipe map in browser")
+
+    # Subcommand: inspect
+    inspect_parser = subparsers.add_parser("inspect", help="Inspect GeoJSON layer features, bounding box, and properties")
+    inspect_parser.add_argument("input_file", help="GeoJSON file path to inspect")
+
+    # Subcommand: tiles
+    subparsers.add_parser("tiles", help="List all built-in web map tile basemaps")
+
+    parsed_args = parser.parse_args(args)
+
+    if not parsed_args.command:
+        parser.print_help()
+        return 0
+
+    if parsed_args.command == "build":
+        layer_paths = [p.strip() for p in parsed_args.layers.split(",") if p.strip()]
+        mm = MultiMap(
+            grid=parsed_args.grid,
+            title=parsed_args.title,
+            theme=parsed_args.theme,
+            basemap=parsed_args.basemap,
+        )
+
+        for idx, lp in enumerate(layer_paths):
+            if not os.path.exists(lp):
+                print(f"Error: Layer file not found: {lp}", file=sys.stderr)
+                return 1
+            if idx < mm.panel_count:
+                vlyr = VectorLayer.from_geojson(lp)
+                mm.panel(idx).add_layer(vlyr)
+                mm.panel(idx).title = vlyr.name
+
+        out_path = os.path.abspath(parsed_args.out)
+        mm.to_html(out_path)
+        print(f"✓ Synchronized MultiMap dashboard generated: {out_path} ({os.path.getsize(out_path):,} bytes)")
+
+        if parsed_args.open:
+            webbrowser.open(f"file://{out_path}")
+        return 0
+
+    elif parsed_args.command == "compare":
+        if not os.path.exists(parsed_args.left_layer) or not os.path.exists(parsed_args.right_layer):
+            print("Error: One or both layer files not found.", file=sys.stderr)
+            return 1
+
+        sm = SwipeMap(
+            left_layer=parsed_args.left_layer,
+            right_layer=parsed_args.right_layer,
+            left_title=parsed_args.left_title,
+            right_title=parsed_args.right_title,
+        )
+        out_path = os.path.abspath(parsed_args.out)
+        sm.to_html(out_path)
+        print(f"✓ Split-screen Swipe Map generated: {out_path} ({os.path.getsize(out_path):,} bytes)")
+
+        if parsed_args.open:
+            webbrowser.open(f"file://{out_path}")
+        return 0
+
+    elif parsed_args.command == "inspect":
+        if not os.path.exists(parsed_args.input_file):
+            print(f"Error: File not found: {parsed_args.input_file}", file=sys.stderr)
+            return 1
+        with open(parsed_args.input_file, "r", encoding="utf-8") as f:
+            data = json.load(f)
+        v = VectorLayer.from_geojson(data, name=parsed_args.input_file)
+        feats = data.get("features", [])
+        bounds = v.get_bounds()
+        props_keys = set()
+        for ft in feats:
+            props_keys.update(ft.get("properties", {}).keys())
+
+        print(f"Layer File     : {parsed_args.input_file}")
+        print(f"Feature Count  : {len(feats):,}")
+        print(f"Bounding Box   : {bounds}")
+        print(f"Properties ({len(props_keys)}) : {', '.join(sorted(props_keys))}")
+        return 0
+
+    elif parsed_args.command == "tiles":
+        print("Available Built-in Tile Providers in multilayer-sdk:")
+        for tp in TileProvider:
+            if tp != TileProvider.NONE:
+                print(f"  - {tp.value:<20} : {tp.url_template}")
+        return 0
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())