@projektemacher/storymapjs 0.10.3 → 0.10.5

package/README.md

@@ -71,14 +71,43 @@ need `icon` inside the location object.
 ### Limit the map to a bounding box
 
 Set `map_bbox` to `[west, south, east, north]` (lon/lat) to constrain the map —
-nothing outside of the box can be visible:
+the view center stays inside the box, so the map cannot pan away from it:
 
     map_bbox: [-11, 34, 32, 71],   // or null (the default) to leave the map unconstrained
 
 For image-space (IIIF) maps the coordinates are raw image pixels. When the
 slide content panel is opaque (a solid background that hides the map behind it),
 the initial fit accounts for the covered area so the story stays inside the
-visible region.
+visible region. To limit the map to the left, visible half in landscape (with
+an opaque slide panel instead of the gradient over the map), set
+`map_area: "left"` (default `"full"`).
+
+### Custom tile templates
+
+`map_type` accepts absolute or relative tile URL templates and style JSON URLs:
+
+    map_type: "https://tile.openstreetmap.org/{z}/{x}/{y}.png",
+    map_type: "./tiles/{z}/{x}/{y}.png",   // same-origin, works on subpaths + Electron
+    map_type: "https://tiles.openfreemap.org/styles/bright",  // vector style
+
+Any value containing `{z}` renders as a raster XYZ layer; a path without `{z}`
+that looks like a URL/path renders as a vector style layer; anything else falls
+back to classic OSM raster.
+
+### Switching the basemap at runtime
+
+`storymap.setMapOption("map_type", next)` / `setMapOptions({...})` rebuilds the
+main tile layer **and** the minimap (`ol/control/OverviewMap`) layer, keeping
+the overview fitted to the marker bounds (zoomify/IIIF extents preserved). The
+current slide is re-fitted after the swap.
+
+### Icons
+
+Default pins use the bundled `vco-icons` font (`dist/css/icons/`, referenced via
+relative `./icons/...` URLs from `dist/css/storymap.css`), so pins render on
+subpath deploys, bundler consumers (Vite leaves absolute `/css/...` untouched)
+and `file://`/Electron hosts without extra configuration. Import the stylesheet
+once (`import "@projektemacher/storymapjs/css/storymap.css"`).
 
 ## Custom HTML in slide content
 

package/dist/assets/{demo-rv3vz65J.js → demo-CVQ7kFek.js}

@@ -1 +1 @@
-import{t as e}from"./main-mUk_qlWN.js";import"./modulepreload-polyfill-P2Xu9kJm.js";function t(e){document.title=`StoryMapJS: `+e.title}window.storymap=new e(`storymap-embed`,`./demo.json`,{},{title:t});
+import{t as e}from"./main-DwbXrrYn.js";import"./modulepreload-polyfill-P2Xu9kJm.js";function t(e){document.title=`StoryMapJS: `+e.title}window.storymap=new e(`storymap-embed`,`./demo.json`,{},{title:t});

package/dist/assets/{harness-BnQbtq1l.js → harness-C-VZV-ou.js}

@@ -1 +1 @@
-import{t as e}from"./main-mUk_qlWN.js";import"./modulepreload-polyfill-P2Xu9kJm.js";window.__smErrors=[],window.__smReady=!1,window.addEventListener(`error`,e=>{window.__smErrors.push(String(e.message||e))});var t=new URLSearchParams(window.location.search),n=t.get(`manifest`),r=t.get(`url`),i=n===null?t.get(`example`):n,a=n===null?`/examples/`:`/examples-iiif/`,o={};if(t.get(`options`))try{o=JSON.parse(t.get(`options`))}catch(e){window.__smErrors.push(`harness: bad options param: `+e)}var s=r??a+i+`.json`;fetch(s).then(e=>e.json()).then(t=>{window.__sm=new e(`storymap-embed`,t,o,{}),window.__smReady=!0}).catch(e=>{window.__smErrors.push(`harness: `+(e&&e.message?e.message:String(e))),window.__smReady=!0});
+import{t as e}from"./main-DwbXrrYn.js";import"./modulepreload-polyfill-P2Xu9kJm.js";window.__smErrors=[],window.__smReady=!1,window.addEventListener(`error`,e=>{window.__smErrors.push(String(e.message||e))});var t=new URLSearchParams(window.location.search),n=t.get(`manifest`),r=t.get(`url`),i=n===null?t.get(`example`):n,a=n===null?`/examples/`:`/examples-iiif/`,o={};if(t.get(`options`))try{o=JSON.parse(t.get(`options`))}catch(e){window.__smErrors.push(`harness: bad options param: `+e)}var s=r??a+i+`.json`;fetch(s).then(e=>e.json()).then(t=>{window.__sm=new e(`storymap-embed`,t,o,{}),window.__smReady=!0}).catch(e=>{window.__smErrors.push(`harness: `+(e&&e.message?e.message:String(e))),window.__smReady=!0});