@projektemacher/storymapjs 0.10.8 → 0.11.0

package/docs/storymap-as-iiif-manifest.md

@@ -10,7 +10,11 @@ the fixtures in [`public/examples/`](../public/examples/) are real-world samples
 ([`public/examples-iiif/`](../public/examples-iiif/)), and
 `scripts/validate-iiif.mjs` checks every converted manifest against the
 [official IIIF presentation validator](https://presentation-validator.iiif.io/)
-(`npm run validate:iiif`). All converted fixtures pass the official validator.
+(`npm run validate:iiif`). All converted fixtures pass the official validator,
+except the two hand-authored georeferenced-layer fixtures, which the base
+validator schema cannot accept by design (see "Geo-referenced layers" below);
+`npm run validate:iiif` reports those two as _not covered_ rather than as
+failures.
 
 ## Contexts
 
@@ -28,7 +32,6 @@ reference; a manifest must reference it by URL, not paste it in (see the
         "@version": 1.1,
         "storymap": "https://christianmahnke.de/iiif/storymap#",
         "mapAsImage": "storymap:mapAsImage",
-        "basemap": "storymap:basemap",
         "tilejson": "storymap:tilejson",
         "mapAccessToken": "storymap:mapAccessToken",
         "mapBackgroundColor": "storymap:mapBackgroundColor",
@@ -58,7 +61,19 @@ reference; a manifest must reference it by URL, not paste it in (see the
             "@type": "@id"
         },
         "mediaSrcset": "storymap:mediaSrcset",
-        "mediaSizes": "storymap:mediaSizes"
+        "mediaSizes": "storymap:mediaSizes",
+        "rotation": "storymap:rotation",
+        "basemap": "storymap:basemap",
+        "filter": "storymap:filter",
+        "mask": "storymap:mask",
+        "slidetimeout": "storymap:slidetimeout",
+        "imgoverlay": "storymap:imgoverlay",
+        "loop": "storymap:loop",
+        "offset": "storymap:offset",
+        "play": "storymap:play",
+        "stopOnExit": "storymap:stopOnExit",
+        "stopAllPrevious": "storymap:stopAllPrevious",
+        "provenance": "storymap:provenance"
     }
 }
 ```
@@ -94,7 +109,6 @@ what the fixtures reference. Content:
     "@context": {
         "@version": 1.1,
         "storymap": "https://christianmahnke.de/iiif/storymap#",
-        "basemap": "storymap:basemap",
         "tilejson": "storymap:tilejson",
         "mapAsImage": "storymap:mapAsImage",
         "mapAccessToken": "storymap:mapAccessToken",
@@ -122,7 +136,19 @@ what the fixtures reference. Content:
         "overlays": "storymap:overlays",
         "type": { "@id": "storymap:type", "@type": "@id" },
         "mediaSrcset": "storymap:mediaSrcset",
-        "mediaSizes": "storymap:mediaSizes"
+        "mediaSizes": "storymap:mediaSizes",
+        "rotation": "storymap:rotation",
+        "basemap": "storymap:basemap",
+        "filter": "storymap:filter",
+        "mask": "storymap:mask",
+        "slidetimeout": "storymap:slidetimeout",
+        "imgoverlay": "storymap:imgoverlay",
+        "loop": "storymap:loop",
+        "offset": "storymap:offset",
+        "play": "storymap:play",
+        "stopOnExit": "storymap:stopOnExit",
+        "stopAllPrevious": "storymap:stopAllPrevious",
+        "provenance": "storymap:provenance"
     }
 }
 ```
@@ -175,9 +201,16 @@ with one GeoJSON Feature:
   verbatim. For image-map storymaps (`storymap:mapAsImage: true`) the values are
   image coordinates rather than WGS84 degrees; consumers can detect this via
   `storymap:mapAsImage`.
-- `properties`: marker data — `name`, `zoom`, `line`, `icon`, `iconSize`,
-  `image`, `use_custom_marker`, plus the presentation-only `popup` and
-  `audioBadge` (only present keys).
+- `properties`: marker data — `name`, `zoom`, `rotation` (view rotation in
+  degrees clockwise), `basemap` (a per-slide basemap override: any `map_type`
+  value or IIIF `info.json` URL), `filter` (per-slide image grading:
+  `brightness`/`contrast`/`saturate` in percent, `hueRotate` in degrees,
+  `sepia` in percent, `blur` in CSS pixels), `mask` (a spotlight mask:
+  normalized `{x, y, w, h}` viewport fractions plus `color`/`invert`), `line`,
+  `icon`, `iconSize`, `image`, `use_custom_marker`, plus the
+  presentation-only `popup` and `audioBadge` (only present keys). Slides
+  without `lat`/`lon` carry `rotation`/`basemap`/`filter`/`mask` as the
+  canvas `storymap:` terms below instead.
 - `location.use_custom_marker` / `use_custom_markers` (manifest) opt into
   custom marker rendering; see the storymap terms below.
 
@@ -189,8 +222,7 @@ context, and a client that meets a property it does not understand must ignore
 it. There is no IIIF extension for marker presentation — navPlace defines
 exactly one term, `navPlace` itself — so the local context is the only option.
 It is why `popup` and `audioBadge` need no `storymap:` term of their own, and
-the same mechanism is what `docs/plans/iiif-media-tours.md` §2 wants for its
-marker config. The nine local names hang off this project's existing namespace
+the same mechanism serves marker config. The thirteen local names hang off this project's existing namespace
 (`https://christianmahnke.de/iiif/storymap#`), not a new one.
 
 ### Context order matters
@@ -307,7 +339,9 @@ properties):
 A keyword basemap and a tile URL template are different kinds of thing, and
 `mapType` used to be both. They are now separate: `storymap:basemap` names a
 source the viewer knows how to configure, and an **unprefixed** `tilejson`
-object describes any other tile service in the standard's own terms. Only
+object describes any other tile service in the standard's own terms (the
+`tilejson` context entry stays prefixed by JSON-LD convention; only the
+unprefixed wire form is read). Only
 `tiles` is required:
 
 ```json
@@ -334,7 +368,9 @@ object describes any other tile service in the standard's own terms. Only
 
 `tiles` becomes `map_type`, so everything that dispatches on a template (the
 `tile_source_factory` option, attribution, the minimap) works unchanged. The
-rest is honoured where the map can act on it:
+rest is honoured where the map can act on it when _reading_ a manifest; note
+the converter only writes `{tiles}` back out, so a manifest → storymap →
+manifest cycle drops `minzoom`/`maxzoom`/`bounds`/`scheme`/`center`:
 
 | Member    | Effect                                                                    |
 | --------- | ------------------------------------------------------------------------- |
@@ -349,45 +385,53 @@ The `center` is the initial view only, and `bounds` constrains the center
 without pinning the resolution — a hard extent constraint would fight the panel
 offset, the same reason `map_bbox` works the way it does.
 
-| Service property (storymap:)  | StoryMap field                      | Values                                                                                                                               |
-| ----------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `basemap`                     | `map_type`                          | A keyword the viewer configures itself: `osm:standard`, `mapbox://styles/...`, `stadia:...`, `iiif`. `zoomify` is replaced by `iiif` |
-| _(unprefixed)_ `tilejson`     | `map_type` + `tilejson`             | TileJSON 2.1 for an arbitrary tile service — see below                                                                               |
-| `mapAsImage`                  | `map_as_image`                      | `true` when the image itself is the map                                                                                              |
-| `mapAccessToken`              | `map_access_token`                  | Mapbox/Stadia token from the storymap data, never the repository                                                                     |
-| `mapBackgroundColor`          | `map_background_color`              | CSS color                                                                                                                            |
-| `mapCenterOffset`             | `map_center_offset`                 | `{left, top}`                                                                                                                        |
-| `mapSubdomains`               | `map_subdomains`                    | Tile URL subdomains                                                                                                                  |
-| _(none)_                      | `iiif.url`                          | From the Image API `service[]` a painting body carries, plus `/info.json`; see below                                                 |
-| `fontCss`                     | `font_css`                          | e.g. `stock:dancing-ledger`                                                                                                          |
-| `callToAction`                | `call_to_action`                    | boolean                                                                                                                              |
-| `callToActionText`            | `call_to_action_text`               | string                                                                                                                               |
-| `startAtSlide`                | `start_at_slide`                    | 0-based slide index                                                                                                                  |
-| `language`                    | `language`                          | IETF language tag                                                                                                                    |
-| `calculateZoom`               | `calculate_zoom`                    | boolean                                                                                                                              |
-| `lessBounce`                  | `less_bounce`                       | boolean                                                                                                                              |
-| `lineFollowsPath`             | `line_follows_path`                 | boolean                                                                                                                              |
-| `showLines`                   | `show_lines`                        | boolean                                                                                                                              |
-| `showHistoryLine`             | `show_history_line`                 | boolean                                                                                                                              |
-| `lineColor`                   | `line_color`                        | CSS color                                                                                                                            |
-| `lineColorInactive`           | `line_color_inactive`               | CSS color                                                                                                                            |
-| `lineWeight`                  | `line_weight`                       | number (px)                                                                                                                          |
-| `lineOpacity`                 | `line_opacity`                      | 0–1                                                                                                                                  |
-| `lineDash`                    | `line_dash`                         | CSS dash pattern                                                                                                                     |
-| `lineJoin`                    | `line_join`                         | CSS line join                                                                                                                        |
-| `useCustomMarkers`            | `use_custom_markers`                | boolean                                                                                                                              |
-| `mapArea`                     | `map_area`                          | `"full"` (default) or `"left"`                                                                                                       |
-| `overviewExtent`              | `overview_extent`                   | `[west, south, east, north]` lon/lat box for the minimap overview                                                                    |
-| `keyboard`                    | `keyboard`                          | boolean: arrow keys navigate the story from anywhere                                                                                 |
-| `overlays`                    | `overlays`                          | array of stacked layers (see below)                                                                                                  |
-| _(georeferencing annotation)_ | `overlays[]` (georeference entries) | IIIF images placed from ground control points — see "Geo-referenced layers"                                                          |
+| Service property (storymap:)  | StoryMap field                      | Values                                                                                                                                          |
+| ----------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `basemap`                     | `map_type`                          | A keyword the viewer configures itself: `osm:standard`, `mapbox://styles/...`, `stadia:...`, `iiif`. `zoomify` is replaced by `iiif`            |
+| _(unprefixed)_ `tilejson`     | `map_type` + `tilejson`             | TileJSON 2.1 for an arbitrary tile service — see below                                                                                          |
+| `mapAsImage`                  | `map_as_image`                      | `true` when the image itself is the map                                                                                                         |
+| `mapAccessToken`              | `map_access_token`                  | Mapbox/Stadia token from the storymap data, never the repository                                                                                |
+| `mapBackgroundColor`          | `map_background_color`              | CSS color                                                                                                                                       |
+| `mapCenterOffset`             | `map_center_offset`                 | `{left, top}`                                                                                                                                   |
+| _(none — removed)_            | `map_subdomains`                    | _dropped_ (inert, no reader; see the full mapping table)                                                                                        |
+| _(none)_                      | `iiif.url`                          | From the Image API `service[]` a painting body carries, plus `/info.json`; see below                                                            |
+| `fontCss`                     | `font_css`                          | e.g. `stock:dancing-ledger`, or `false` for no injected theme                                                                                   |
+| `callToAction`                | `call_to_action`                    | boolean                                                                                                                                         |
+| `callToActionText`            | `call_to_action_text`               | string                                                                                                                                          |
+| `startAtSlide`                | `start_at_slide`                    | 0-based slide index                                                                                                                             |
+| `language`                    | `language`                          | IETF language tag                                                                                                                               |
+| `calculateZoom`               | `calculate_zoom`                    | boolean                                                                                                                                         |
+| _(none — removed)_            | `less_bounce`                       | _dropped_ (inert, no reader; see the full mapping table)                                                                                        |
+| `lineFollowsPath`             | `line_follows_path`                 | boolean                                                                                                                                         |
+| `showLines`                   | `show_lines`                        | boolean                                                                                                                                         |
+| `showHistoryLine`             | `show_history_line`                 | boolean                                                                                                                                         |
+| `lineColor`                   | `line_color`                        | CSS color                                                                                                                                       |
+| `lineColorInactive`           | `line_color_inactive`               | CSS color                                                                                                                                       |
+| `lineWeight`                  | `line_weight`                       | number (px)                                                                                                                                     |
+| `lineOpacity`                 | `line_opacity`                      | 0–1                                                                                                                                             |
+| `lineDash`                    | `line_dash`                         | CSS dash pattern                                                                                                                                |
+| `lineJoin`                    | `line_join`                         | CSS line join                                                                                                                                   |
+| `useCustomMarkers`            | `use_custom_markers`                | boolean                                                                                                                                         |
+| `mapArea`                     | `map_area`                          | `"full"` (default) or `"left"`                                                                                                                  |
+| `overviewExtent`              | `overview_extent`                   | `[west, south, east, north]` lon/lat box for the minimap overview                                                                               |
+| `keyboard`                    | `keyboard`                          | boolean: arrow keys navigate the story from anywhere                                                                                            |
+| `overlays`                    | `overlays`                          | array of stacked layers (see below)                                                                                                             |
+| _(georeferencing annotation)_ | `overlays[]` (georeference entries) | IIIF images placed from ground control points — see "Geo-referenced layers"                                                                     |
+| _(viewer option)_             | `show_layers_control`, `basemaps`   | the layer switcher and its basemap list: viewer-side only, never read from a manifest; `label` functions likewise never cross the JSON boundary |
 
 ### Canvas level — direct properties
 
 Canvas objects are open for extension terms, so slide-specific StoryMap data is
 carried directly on the Canvas: `storymap:type`, plus the two terms with no
 standard home, `storymap:mediaSrcset` and `storymap:mediaSizes` (see the
-Canvas table above). A slide's date is the standard `navDate` and its
+Canvas table above), plus the view directives `storymap:rotation`,
+`storymap:basemap`, `storymap:filter` and `storymap:mask` (the fallback for
+slides without `lat`/`lon`, which have no `navPlace` to carry them — the
+reader prefers `navPlace` when both spell a key), the per-slide autoplay
+dwell `storymap:slidetimeout` (milliseconds, `0` holds), the per-slide
+image overlay `storymap:imgoverlay` (`{url, size?, opacity?, extent?}`) and
+the provenance identifiers `storymap:provenance`
+(`{manifest?, canvas?, image?}`, data-only). A slide's date is the standard `navDate` and its
 background is the standard `background` annotation. The media caption, credit and alt
 text are **not** terms any more: they are the painting annotation's own `label`,
 `requiredStatement` and `accessibilitySummary`, which is where Presentation 3
@@ -398,6 +442,22 @@ Readers must use the prefixed term for the slide type (`storymap:type`): the
 bare `type` key of a Canvas is the IIIF class type (`"Canvas"`) and can never
 carry the StoryMap slide type.
 
+**Gating.** The slideshow-motivated fields above (`rotation`, `basemap`,
+`filter`, `mask`, `slidetimeout`, `imgoverlay`, `provenance`) are read
+data-preservingly from any manifest, but they render **only for slideshow
+tours** (the viewer's internal `slideshow_source` marker, set when a
+document arrives through the slideshow translator). Hand-written manifests
+and storymap JSON keep the long-standing rendering; see the README's
+slideshow section. The playback flags (`storymap:loop/offset/play/
+stopOnExit/stopAllPrevious`) are gated the same way.
+
+**Placement.** The view directives live on the **Canvas** (direct
+properties); the playback flags live as **Annotation** foreign members —
+`storymap:loop/offset/play/stopOnExit` on the painting annotation (for
+audio/video media) and the full set including `storymap:stopAllPrevious`
+on the `supplementing` narration annotation. When a key is spelled both on
+the Canvas and in `navPlace` properties, `navPlace` wins.
+
 ## Annotation-driven tour stops
 
 A Canvas annotation whose `motivation` is `commenting`, `tagging`,
@@ -427,15 +487,15 @@ The painting annotation's body is read into one shared record. The
 dropped — a manifest still using them loads, but the strings are not read —
 and the standard properties are the only source:
 
-| Body property                                                   | Slide media field                |
-| --------------------------------------------------------------- | -------------------------------- |
-| `label`                                                         | `caption`                        |
-| `requiredStatement` (one `{label, value}` object) or `provider` | `credit`                         |
-| `accessibilitySummary`                                          | `alt`                            |
-| `thumbnail`                                                     | `thumb`                          |
-| `type`, `format`                                                | player selection (`MediaType()`) |
-| `duration`, `start`, `end`                                      | time-anchored stops              |
-| a sibling `TextualBody` with `format: text/vtt`                 | `subtitles`                      |
+| Body property                                                   | Slide media field                                               |
+| --------------------------------------------------------------- | --------------------------------------------------------------- |
+| `label`                                                         | `caption`                                                       |
+| `requiredStatement` (one `{label, value}` object) or `provider` | `credit`                                                        |
+| `accessibilitySummary`                                          | `alt`                                                           |
+| `thumbnail`                                                     | `thumb`                                                         |
+| `type`, `format`                                                | player selection (`MediaType()`)                                |
+| `duration`, `start`, `end`                                      | time-anchored stops                                             |
+| a sibling `TextualBody` with `format: text/vtt` **and an `id`** | `subtitles` (both required — the `id` is the subtitle file URL) |
 
 ## Native IIIF vs. the StoryMap extension
 
@@ -840,78 +900,91 @@ photo, and a slide with a YouTube video — full manifest:
 
 ## Full mapping table
 
-| Legacy field (storymap root) | IIIF path                                                               |
-| ---------------------------- | ----------------------------------------------------------------------- |
-| `slides`                     | `items[]` (Canvas per slide)                                            |
-| `language`                   | `service[0].storymap:language`                                          |
-| `map_type`                   | `service[0].storymap:basemap` (`zoomify` → `iiif`), or `tilejson.tiles` |
-| `map_as_image`               | `service[0].storymap:mapAsImage`                                        |
-| `map_mini`                   | _dropped_ (viewer setting, not part of the exchange format)             |
-| `map_subdomains`             | _dropped_ (inert, no reader)                                            |
-| `map_access_token`           | `service[0].storymap:mapAccessToken`                                    |
-| `map_background_color`       | `service[0].storymap:mapBackgroundColor`                                |
-| `map_center_offset`          | `service[0].storymap:mapCenterOffset`                                   |
-| `map_popup`                  | _dropped_ (viewer setting)                                              |
-| `use_custom_markers`         | `service[0].storymap:useCustomMarkers`                                  |
-| `map_area`                   | `service[0].storymap:mapArea`                                           |
-| `overview_extent`            | `service[0].storymap:overviewExtent`                                    |
-| `keyboard`                   | `service[0].storymap:keyboard`                                          |
-| `overlays` (georeference)    | Georeferencing annotation `target` + `body`                             |
-| `zoom_distance`              | _dropped_ (viewer setting)                                              |
-| `calculate_zoom`             | `service[0].storymap:calculateZoom`                                     |
-| `less_bounce`                | _dropped_ (inert, no reader)                                            |
-| `line_follows_path`          | `service[0].storymap:lineFollowsPath`                                   |
-| `show_lines`                 | `service[0].storymap:showLines`                                         |
-| `show_history_line`          | `service[0].storymap:showHistoryLine`                                   |
-| `line_color`                 | `service[0].storymap:lineColor`                                         |
-| `line_color_inactive`        | `service[0].storymap:lineColorInactive`                                 |
-| `line_weight`                | `service[0].storymap:lineWeight`                                        |
-| `line_opacity`               | `service[0].storymap:lineOpacity`                                       |
-| `line_dash`                  | `service[0].storymap:lineDash`                                          |
-| `line_join`                  | `service[0].storymap:lineJoin`                                          |
-| `iiif.url`                   | Canvas Image annotation `service[0].id` + `/info.json`                  |
-| `iiif.attribution`           | `requiredStatement`                                                     |
-| `zoomify`                    | _dropped_ (zoomify is replaced by the IIIF reference image)             |
-| `font_css`                   | `service[0].storymap:fontCss`                                           |
-| `call_to_action`             | `service[0].storymap:callToAction`                                      |
-| `call_to_action_text`        | `service[0].storymap:callToActionText`                                  |
-| `relative_date`              | _dropped_ (viewer setting)                                              |
-| `start_at_slide`             | `service[0].storymap:startAtSlide`                                      |
-| _(root) `width`, `height`_   | _dropped_ (viewer embed size)                                           |
-
-| Legacy field (slide)           | IIIF path                                                                   |
-| ------------------------------ | --------------------------------------------------------------------------- |
-| `type: "overview"`             | Canvas `storymap:type: "overview"`                                          |
-| `date`                         | Canvas `navDate`                                                            |
-| `text.headline`                | Canvas `label` (language map)                                               |
-| `text.text`                    | Canvas `summary` (language map)                                             |
-| `location.lat`, `location.lon` | Canvas `navPlace` Feature `geometry.coordinates`                            |
-| `location.zoom`                | Canvas `navPlace` Feature `properties.zoom`                                 |
-| `location.line`                | Canvas `navPlace` Feature `properties.line`                                 |
-| `location.name`                | Canvas `navPlace` Feature `properties.name`                                 |
-| `location.icon`                | Canvas `navPlace` Feature `properties.icon`                                 |
-| `location.iconSize`            | Canvas `navPlace` Feature `properties.iconSize`                             |
-| `location.image`               | Canvas `navPlace` Feature `properties.image`                                |
-| `location.use_custom_marker`   | Canvas `navPlace` Feature `properties.use_custom_marker`                    |
-| `media.url` (image)            | Annotation body `{type: "Image", format: ...}`                              |
-| `media.url` (video service)    | Annotation body `{type: "Video"}`                                           |
-| `media.url` (audio service)    | Annotation body `{type: "Sound"}`                                           |
-| `media.url` (web page)         | Annotation body `{type: "Text", format: "text/html"}`                       |
-| `media.url` (absent / HTML)    | Annotation body `{type: "TextualBody", value: ...}`                         |
-| `media.caption`                | Painting annotation `label`                                                 |
-| `media.credit`                 | Painting annotation `requiredStatement` (`{label, value}`)                  |
-| `media.alt`                    | Painting annotation `accessibilitySummary`                                  |
-| `media.srcset`                 | Canvas `storymap:mediaSrcset`                                               |
-| `media.sizes`                  | Canvas `storymap:mediaSizes`                                                |
-| `location.region`              | Painting annotation target `ImageApiSelector` `xywh=pixel:`                 |
-| `media.thumb`                  | Canvas `thumbnail[]` or the body `thumbnail[]`                              |
-| `background`                   | Canvas `background` painting annotation (Image + Color body)                |
-| `uniqueid`                     | Canvas `id`                                                                 |
-| `group`                        | A `structures` Range label; the Range order is the slide order              |
-| `language` (per slide)         | The language tag the slide's text was read in (§3.4)                        |
-| `logo`, `metadata`             | Read into `data.logo` / `data.metadata[]`                                   |
-| `tilejson`                     | `service[0].tilejson`                                                       |
-| `title`                        | Manifest `label` (a label is required, so the converter uses the file name) |
+| Legacy field (storymap root)                                                                                                                         | IIIF path                                                                                                                                                                                       |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `slides`                                                                                                                                             | `items[]` (Canvas per slide)                                                                                                                                                                    |
+| `language`                                                                                                                                           | `service[0].storymap:language`                                                                                                                                                                  |
+| `map_type`                                                                                                                                           | `service[0].storymap:basemap` (`zoomify` → `iiif`), or `tilejson.tiles`                                                                                                                         |
+| `map_as_image`                                                                                                                                       | `service[0].storymap:mapAsImage`                                                                                                                                                                |
+| `map_mini`                                                                                                                                           | _dropped_ (viewer setting, not part of the exchange format)                                                                                                                                     |
+| `map_subdomains`                                                                                                                                     | _dropped_ (inert, no reader)                                                                                                                                                                    |
+| `map_access_token`                                                                                                                                   | `service[0].storymap:mapAccessToken`                                                                                                                                                            |
+| `map_background_color`                                                                                                                               | `service[0].storymap:mapBackgroundColor`                                                                                                                                                        |
+| `map_center_offset`                                                                                                                                  | `service[0].storymap:mapCenterOffset`                                                                                                                                                           |
+| `map_popup`                                                                                                                                          | _dropped_ (viewer setting)                                                                                                                                                                      |
+| `use_custom_markers`                                                                                                                                 | `service[0].storymap:useCustomMarkers`                                                                                                                                                          |
+| `map_area`                                                                                                                                           | `service[0].storymap:mapArea`                                                                                                                                                                   |
+| `overview_extent`                                                                                                                                    | `service[0].storymap:overviewExtent`                                                                                                                                                            |
+| `keyboard`                                                                                                                                           | `service[0].storymap:keyboard`                                                                                                                                                                  |
+| `overlays` (georeference)                                                                                                                            | Georeferencing annotation `target` + `body`                                                                                                                                                     |
+| `zoom_distance`                                                                                                                                      | _dropped_ (viewer setting)                                                                                                                                                                      |
+| `calculate_zoom`                                                                                                                                     | `service[0].storymap:calculateZoom`                                                                                                                                                             |
+| `less_bounce`                                                                                                                                        | _dropped_ (inert, no reader)                                                                                                                                                                    |
+| `line_follows_path`                                                                                                                                  | `service[0].storymap:lineFollowsPath`                                                                                                                                                           |
+| `show_lines`                                                                                                                                         | `service[0].storymap:showLines`                                                                                                                                                                 |
+| `show_history_line`                                                                                                                                  | `service[0].storymap:showHistoryLine`                                                                                                                                                           |
+| `line_color`                                                                                                                                         | `service[0].storymap:lineColor`                                                                                                                                                                 |
+| `line_color_inactive`                                                                                                                                | `service[0].storymap:lineColorInactive`                                                                                                                                                         |
+| `line_weight`                                                                                                                                        | `service[0].storymap:lineWeight`                                                                                                                                                                |
+| `line_opacity`                                                                                                                                       | `service[0].storymap:lineOpacity`                                                                                                                                                               |
+| `line_dash`                                                                                                                                          | `service[0].storymap:lineDash`                                                                                                                                                                  |
+| `line_join`                                                                                                                                          | `service[0].storymap:lineJoin`                                                                                                                                                                  |
+| `iiif.url`                                                                                                                                           | Canvas Image annotation `service[0].id` + `/info.json` (only when the story uses `map_type: "iiif"`)                                                                                            |
+| `iiif.attribution`                                                                                                                                   | `requiredStatement`                                                                                                                                                                             |
+| `zoomify`                                                                                                                                            | _dropped_ (zoomify is replaced by the IIIF reference image)                                                                                                                                     |
+| `font_css`                                                                                                                                           | `service[0].storymap:fontCss` (`false` disables the injected theme)                                                                                                                             |
+| `call_to_action`                                                                                                                                     | `service[0].storymap:callToAction`                                                                                                                                                              |
+| `call_to_action_text`                                                                                                                                | `service[0].storymap:callToActionText`                                                                                                                                                          |
+| `relative_date`                                                                                                                                      | _dropped_ (viewer setting)                                                                                                                                                                      |
+| `start_at_slide`                                                                                                                                     | `service[0].storymap:startAtSlide`                                                                                                                                                              |
+| _(root) `width`, `height`_                                                                                                                           | _dropped_ (viewer embed size)                                                                                                                                                                   |
+| _(slideshow tours) player chrome (`textmode`, `textsize`, `progressbar`, `fxmode`, `mode`, `hud*`, `shownav`, `show_*`, `viewerheight`, `autoplay`)_ | _dropped_ (no IIIF vocabulary; translator-only, see docs/slideshow.md)                                                                                                                          |
+| `credit.creator` / `credit.rights`                                                                                                                   | Manifest `metadata` entries ("Creator" / "Rights") — one way: the reader keeps all metadata in `data.metadata[]` and never reconstructs `credit`, and `credit.licenseUrl` is not written at all |
+| `iiif.fallbackUrl`                                                                                                                                   | _dropped_ (runtime fallback; tour documents carry `image_static` per stop)                                                                                                                      |
+
+| Legacy field (slide)                                    | IIIF path                                                                        |
+| ------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| `type: "overview"`                                      | Canvas `storymap:type: "overview"`                                               |
+| `date`                                                  | Canvas `navDate`                                                                 |
+| `text.headline`                                         | Canvas `label` (language map)                                                    |
+| `text.text`                                             | Canvas `summary` (language map)                                                  |
+| `location.lat`, `location.lon`                          | Canvas `navPlace` Feature `geometry.coordinates`                                 |
+| `location.zoom`                                         | Canvas `navPlace` Feature `properties.zoom`                                      |
+| `location.line`                                         | Canvas `navPlace` Feature `properties.line`                                      |
+| `location.name`                                         | Canvas `navPlace` Feature `properties.name`                                      |
+| `location.icon`                                         | Canvas `navPlace` Feature `properties.icon`                                      |
+| `location.iconSize`                                     | Canvas `navPlace` Feature `properties.iconSize`                                  |
+| `location.image`                                        | Canvas `navPlace` Feature `properties.image`                                     |
+| `location.use_custom_marker`                            | Canvas `navPlace` Feature `properties.use_custom_marker`                         |
+| `location.rotation`                                     | Canvas `navPlace` Feature `properties.rotation`, else Canvas `storymap:rotation` |
+| `location.basemap`                                      | Canvas `navPlace` Feature `properties.basemap`, else Canvas `storymap:basemap`   |
+| `location.filter`                                       | Canvas `navPlace` Feature `properties.filter`, else Canvas `storymap:filter`     |
+| `location.mask`                                         | Canvas `navPlace` Feature `properties.mask`, else Canvas `storymap:mask`         |
+| `slidetimeout`                                          | Canvas `storymap:slidetimeout` (milliseconds, `0` holds)                         |
+| `imgoverlay`                                            | Canvas `storymap:imgoverlay`                                                     |
+| `provenance`                                            | Canvas `storymap:provenance` (data-only identifiers)                             |
+| `narration.url`                                         | Supplementing annotation body `{type: "Sound"}`                                  |
+| `narration.loop/offset/play/stopOnExit/stopAllPrevious` | Supplementing annotation `storymap:` members (foreign members, only when set)    |
+| `media.offset/loop/play/stopOnExit`                     | Painting annotation `storymap:` members (foreign members, only when set)         |
+| `media.url` (image)                                     | Annotation body `{type: "Image", format: ...}`                                   |
+| `media.url` (video service)                             | Annotation body `{type: "Video"}`                                                |
+| `media.url` (audio service)                             | Annotation body `{type: "Sound"}`                                                |
+| `media.url` (web page)                                  | Annotation body `{type: "Text", format: "text/html"}`                            |
+| `media.url` (absent / HTML)                             | Annotation body `{type: "TextualBody", value: ...}`                              |
+| `media.caption`                                         | Painting annotation `label`                                                      |
+| `media.credit`                                          | Painting annotation `requiredStatement` (`{label, value}`)                       |
+| `media.alt`                                             | Painting annotation `accessibilitySummary`                                       |
+| `media.srcset`                                          | Canvas `storymap:mediaSrcset`                                                    |
+| `media.sizes`                                           | Canvas `storymap:mediaSizes`                                                     |
+| `location.region`                                       | Painting annotation target `ImageApiSelector` `xywh=pixel:`                      |
+| `media.thumb`                                           | Canvas `thumbnail[]` or the body `thumbnail[]`                                   |
+| `background`                                            | Canvas `background` painting annotation (Image + Color body)                     |
+| `uniqueid`                                              | Canvas `id`                                                                      |
+| `group`                                                 | A `structures` Range label; the Range order is the slide order                   |
+| `language` (per slide)                                  | The language tag the slide's text was read in (§3.4)                             |
+| `logo`, `metadata`                                      | Read into `data.logo` / `data.metadata[]`                                        |
+| `tilejson`                                              | `service[0].tilejson`                                                            |
+| `title`                                                 | Manifest `label` (a label is required, so the converter uses the file name)      |
 
 ## Conversion
 

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@projektemacher/storymapjs",
-    "version": "0.10.8",
-    "description": "StoryMapJS viewer library \u2014 unofficial TypeScript/OpenLayers rewrite of the Knight Lab StoryMapJS (viewer only)",
+    "version": "0.11.0",
+    "description": "StoryMapJS viewer library — unofficial TypeScript/OpenLayers rewrite of the Knight Lab StoryMapJS (viewer only)",
     "license": "MPL-2.0",
     "type": "module",
     "types": "./dist/js/storymap.d.ts",
@@ -44,6 +44,7 @@
         "ol-mapbox-style": "^13.5.1"
     },
     "devDependencies": {
+        "@axe-core/playwright": "^4.13.0",
         "@eslint/js": "^10.0.1",
         "@fontsource-variable/bitter": "^5.3.0",
         "@fontsource-variable/dancing-script": "^5.3.0",
@@ -109,6 +110,7 @@
         "check:locales:baseline": "node scripts/check-locales.mjs --write-baseline",
         "validate:iiif": "node scripts/validate-iiif.mjs",
         "convert:iiif": "node --experimental-strip-types scripts/convert-to-iiif.mjs",
+        "convert:slideshow": "node --experimental-strip-types scripts/convert-from-slideshow.mjs",
         "lint": "eslint . && stylelint 'src/scss/**/*.scss'",
         "format": "prettier --write .",
         "format:check": "prettier --check ."