hedron-maps 0.1.0__tar.gz

hedron_maps-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+.DS_Store
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+/build/
+# Artifact/output build trees only — never ignore package source such as
+# packages/hedron/src/hedron/build (Hatchling respects gitignore and would
+# omit it from sdists/wheels; see #32).
+**/.hedron/build/
+packages/hedron-runtime-java/build/
+target/
+.venv*/
+.bounds-venv*
+venv*/
+.env
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.hypothesis/
+.tox/
+.nox/
+.audit-build-proj/
+examples/reference-app/.hedron/
+*.html.gz
+/site/
+*.so
+*.dylib
+*.pyd
+.devcontainer/
+# Local SQLite demos (e.g. examples/notes-sqlalchemy)
+*.db

hedron_maps-0.1.0/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## [0.1.0] — 2026-08-17
+
+### Added
+
+- Independent Beta `hedron-maps` `0.1.0`: typed `MapSpec` / `MapPlan`, `compile_map`,
+  `hedron_maps.Map`, OSM preset, custom/offline sources, `hedron-map` host, and
+  `MapInteraction` (D-078 / D-082 / RFC-0074).
+
+### Fixed
+
+- Custom ``OpenStreetMap.tile_url`` hosts must pass the same origin allowlist as raster
+  tiles (#351).
+- ``Map(tiles=)`` uses exact-origin allowlisting instead of empty or host-prefix bypass
+  (#352).
+- MapStyle source ``data`` / ``urls`` close through origin policy (#353).
+- ``MapInteraction`` POSTs typed events to the registered command path with CSRF (#357).

hedron_maps-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Odos Matthews
+
+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.

hedron_maps-0.1.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.5
+Name: hedron-maps
+Version: 0.1.0
+Summary: First-class maps, offline geospatial presentation, and typed map interactions for Hedron
+Project-URL: Homepage, https://github.com/eddiethedean/hedron
+Project-URL: Repository, https://github.com/eddiethedean/hedron
+Project-URL: Issues, https://github.com/eddiethedean/hedron/issues
+Project-URL: Changelog, https://github.com/eddiethedean/hedron/blob/main/packages/hedron-maps/CHANGELOG.md
+Project-URL: Documentation, https://hedron.readthedocs.io/en/latest/
+Author-email: Odos Matthews <odosmatthews@gmail.com>
+Maintainer-email: Odos Matthews <odosmatthews@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: geojson,hedron,maplibre,maps,mbtiles,osm,pmtiles
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: <3.15,>=3.11
+Requires-Dist: hedron-core<0.48,>=0.47.0
+Description-Content-Type: text/markdown
+
+# hedron-maps
+
+Typed first-class maps, offline geospatial presentation, and `MapInteraction` for Hedron.
+
+**Package maturity:** Beta · **Package version:** `0.1.0`
+
+Install with the 0.47 train extra `hedron[maps]` or independently:
+
+```bash
+pip install "hedron-maps>=0.1.0,<0.2"
+```
+
+```python
+from hedron_maps import Map
+
+Map(center=(37.7749, -122.4194), zoom=11, title="Bay Area", description="OSM raster map")
+```
+
+The default is `OpenStreetMap.standard()` on `hedron_maps.Map` only. Core `hedron.Map`
+keeps no OSM default. Enhanced rendering uses a pinned MapLibre GL JS **5.6.1** strict-CSP
+build (not the experimental charts 4.5.0 pin). Semantic `.hedron-map-alternative` tables
+remain when JavaScript, WebGL, workers, or tiles are absent.
+
+See [Maps API](https://hedron.readthedocs.io/en/latest/api/MAPS/).

hedron_maps-0.1.0/README.md

@@ -0,0 +1,24 @@
+# hedron-maps
+
+Typed first-class maps, offline geospatial presentation, and `MapInteraction` for Hedron.
+
+**Package maturity:** Beta · **Package version:** `0.1.0`
+
+Install with the 0.47 train extra `hedron[maps]` or independently:
+
+```bash
+pip install "hedron-maps>=0.1.0,<0.2"
+```
+
+```python
+from hedron_maps import Map
+
+Map(center=(37.7749, -122.4194), zoom=11, title="Bay Area", description="OSM raster map")
+```
+
+The default is `OpenStreetMap.standard()` on `hedron_maps.Map` only. Core `hedron.Map`
+keeps no OSM default. Enhanced rendering uses a pinned MapLibre GL JS **5.6.1** strict-CSP
+build (not the experimental charts 4.5.0 pin). Semantic `.hedron-map-alternative` tables
+remain when JavaScript, WebGL, workers, or tiles are absent.
+
+See [Maps API](https://hedron.readthedocs.io/en/latest/api/MAPS/).

hedron_maps-0.1.0/pyproject.toml

@@ -0,0 +1,68 @@
+[project]
+name = "hedron-maps"
+version = "0.1.0"
+description = "First-class maps, offline geospatial presentation, and typed map interactions for Hedron"
+readme = "README.md"
+requires-python = ">=3.11,<3.15"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Odos Matthews", email = "odosmatthews@gmail.com" },
+]
+maintainers = [
+    { name = "Odos Matthews", email = "odosmatthews@gmail.com" },
+]
+keywords = [
+    "geojson",
+    "hedron",
+    "maplibre",
+    "maps",
+    "mbtiles",
+    "osm",
+    "pmtiles",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+    "Topic :: Scientific/Engineering :: GIS",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "hedron-core>=0.47.0,<0.48",
+]
+
+[project.entry-points."hedron.plugins"]
+hedron_maps = "hedron_maps.plugin:register"
+
+[project.urls]
+Homepage = "https://github.com/eddiethedean/hedron"
+Repository = "https://github.com/eddiethedean/hedron"
+Issues = "https://github.com/eddiethedean/hedron/issues"
+Changelog = "https://github.com/eddiethedean/hedron/blob/main/packages/hedron-maps/CHANGELOG.md"
+Documentation = "https://hedron.readthedocs.io/en/latest/"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hedron_maps"]
+
+[tool.hatch.build.targets.sdist]
+only-include = [
+    "src/hedron_maps",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "pyproject.toml",
+]

hedron_maps-0.1.0/src/hedron_maps/__init__.py

@@ -0,0 +1,89 @@
+"""hedron-maps: first-class maps, offline geospatial presentation, and typed events."""
+
+from __future__ import annotations
+
+from hedron_maps.compile import compile_map, parse_map_spec
+from hedron_maps.element import TAG_NAME, Map
+from hedron_maps.interaction import (
+    FeatureActivated,
+    FeatureSelected,
+    LayerVisibilityChanged,
+    MapFailed,
+    MapInteraction,
+    MapLoaded,
+    ViewportChanged,
+)
+from hedron_maps.mbtiles import MBTilesArchive
+from hedron_maps.offline import SYNTHETIC_ARCHIVE, bundle_from_paths
+from hedron_maps.pins import MAPLIBRE_VERSION, RUNTIME_PINS, assert_pins_present, verify_pin
+from hedron_maps.spec import (
+    Bounds,
+    CircleLayer,
+    GeoJSONLayer,
+    LineLayer,
+    MapPlan,
+    MapPolicy,
+    MapSpec,
+    MapStyle,
+    MapTheme,
+    MarkerLayer,
+    MBTiles,
+    NoBasemap,
+    OfflineMapBundle,
+    OpenStreetMap,
+    PMTiles,
+    PolygonLayer,
+    RasterLayer,
+    RasterTiles,
+    StaticImage,
+    TileJSON,
+    VectorTiles,
+    ViewState,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "MAPLIBRE_VERSION",
+    "RUNTIME_PINS",
+    "SYNTHETIC_ARCHIVE",
+    "TAG_NAME",
+    "Bounds",
+    "CircleLayer",
+    "FeatureActivated",
+    "FeatureSelected",
+    "GeoJSONLayer",
+    "LayerVisibilityChanged",
+    "LineLayer",
+    "MBTiles",
+    "MBTilesArchive",
+    "Map",
+    "MapFailed",
+    "MapInteraction",
+    "MapLoaded",
+    "MapPlan",
+    "MapPolicy",
+    "MapSpec",
+    "MapStyle",
+    "MapTheme",
+    "MarkerLayer",
+    "NoBasemap",
+    "OfflineMapBundle",
+    "OpenStreetMap",
+    "PMTiles",
+    "PolygonLayer",
+    "RasterLayer",
+    "RasterTiles",
+    "StaticImage",
+    "TAG_NAME",
+    "TileJSON",
+    "VectorTiles",
+    "ViewState",
+    "ViewportChanged",
+    "__version__",
+    "assert_pins_present",
+    "bundle_from_paths",
+    "compile_map",
+    "parse_map_spec",
+    "verify_pin",
+]

hedron_maps-0.1.0/src/hedron_maps/assets/maplibre/LICENSE.txt

@@ -0,0 +1,116 @@
+Copyright (c) 2023, MapLibre contributors
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+    * Neither the name of MapLibre GL JS nor the names of its contributors
+      may be used to endorse or promote products derived from this software
+      without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+-------------------------------------------------------------------------------
+
+Contains code from mapbox-gl-js v1.13 and earlier
+
+Version v1.13 of mapbox-gl-js and earlier are licensed under a BSD-3-Clause license
+
+Copyright (c) 2020, Mapbox
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+* Neither the name of Mapbox GL JS nor the names of its contributors
+  may be used to endorse or promote products derived from this software
+  without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+-------------------------------------------------------------------------------
+
+Contains code from glfx.js
+
+Copyright (C) 2011 by Evan Wallace
+
+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.
+
+--------------------------------------------------------------------------------
+
+Contains a portion of d3-color https://github.com/d3/d3-color
+
+Copyright 2010-2016 Mike Bostock
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the author nor the names of contributors may be used to
+  endorse or promote products derived from this software without specific prior
+  written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.