@projektemacher/storymapjs 0.10.7 → 0.11.0

package/schema/storymap.schema.json

@@ -10,31 +10,70 @@
             "type": "object",
             "required": ["slides"],
             "properties": {
-                "language": { "type": "string" },
+                "language": {
+                    "type": "string"
+                },
                 "map_type": {
-                    "type": "string",
-                    "description": "Basemap type: osm:<style>, osm (classic raster), mapbox://styles/<user>/<style>, stadia:<style>, stamen:<style> (deprecated, remapped), tile URL template or style JSON URL (absolute https://... or relative ./tiles/{z}/{x}/{y}.png, /tiles/{z}/...), iiif, ch-watercolor, zoomify (legacy image pyramid, needs the zoomify options)."
+                    "description": "Basemap type, or \"none\" for a storymap with no map at all. A keyword: \"\" (the default, OpenStreetMap), osm:<style>, osm (classic raster), mapbox://styles/<user>/<style>, stadia:<style>, stamen:<style> (deprecated, remapped), iiif, ch-watercolor, zoomify (legacy image pyramid, needs the zoomify options). Or a tile URL template or style JSON URL (absolute https://... or relative ./tiles/{z}/{x}/{y}.png, /tiles/{z}/...).",
+                    "anyOf": [
+                        {
+                            "type": "string",
+                            "enum": [
+                                "",
+                                "none",
+                                "osm",
+                                "iiif",
+                                "stamen",
+                                "stadia",
+                                "ch-watercolor",
+                                "zoomify"
+                            ]
+                        },
+                        {
+                            "type": "string",
+                            "pattern": "^(?:osm|stadia|mapbox|ch|esri|stamen)(?::|$)|\\{|/|\\.json$"
+                        }
+                    ]
                 },
                 "zoomify": {
                     "anyOf": [
                         {
                             "type": "object",
                             "properties": {
-                                "path": { "type": "string" },
-                                "width": { "type": "number" },
-                                "height": { "type": "number" },
-                                "tolerance": { "type": "number" },
-                                "attribution": { "type": "string" }
+                                "path": {
+                                    "type": "string"
+                                },
+                                "width": {
+                                    "type": "number"
+                                },
+                                "height": {
+                                    "type": "number"
+                                },
+                                "tolerance": {
+                                    "type": "number"
+                                },
+                                "attribution": {
+                                    "type": "string"
+                                }
                             }
                         },
-                        { "type": "boolean" }
+                        {
+                            "type": "boolean"
+                        }
                     ]
                 },
-                "map_as_image": { "type": "boolean" },
-                "map_mini": { "type": "boolean" },
-                "map_subdomains": { "type": "string" },
-                "map_access_token": { "type": "string" },
-                "map_background_color": { "type": "string" },
+                "map_as_image": {
+                    "type": "boolean"
+                },
+                "map_mini": {
+                    "type": "boolean"
+                },
+                "map_access_token": {
+                    "type": "string"
+                },
+                "map_background_color": {
+                    "type": "string"
+                },
                 "map_options": {
                     "type": "object",
                     "description": "OpenLayers passthrough options (view, controls, interactions); element replaces the map container"
@@ -43,39 +82,188 @@
                     "anyOf": [
                         {
                             "type": "array",
-                            "items": { "type": "number" },
+                            "items": {
+                                "type": "number"
+                            },
                             "minItems": 4,
                             "maxItems": 4
                         },
-                        { "type": "null" }
+                        {
+                            "type": "null"
+                        }
                     ]
                 },
                 "map_area": {
                     "type": "string",
                     "enum": ["full", "left"]
                 },
-                "consent_required": { "type": "boolean" },
+                "overview_extent": {
+                    "anyOf": [
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "number"
+                            },
+                            "minItems": 4,
+                            "maxItems": 4
+                        },
+                        {
+                            "type": "null"
+                        }
+                    ],
+                    "description": "Constrain the minimap overview to this lon/lat bounding box [west, south, east, north]; null (default) leaves it unconstrained"
+                },
+                "keyboard": {
+                    "type": "boolean",
+                    "description": "Navigate slides with the arrow keys anywhere on the page (default false)"
+                },
+                "overlays": {
+                    "type": "array",
+                    "description": "Raster layers stacked above the base map and below the route lines",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "map_type": {
+                                "type": "string",
+                                "description": "Any map_type the tile layer factory accepts. Omit when the entry carries a georeference instead."
+                            },
+                            "opacity": {
+                                "type": "number",
+                                "minimum": 0,
+                                "maximum": 1
+                            },
+                            "visible": {
+                                "type": "boolean"
+                            },
+                            "attribution": {
+                                "type": "string"
+                            },
+                            "label": {
+                                "type": "string",
+                                "description": "Layer switcher row label (defaults to map_type)"
+                            },
+                            "locked": {
+                                "type": "boolean",
+                                "description": "Render the switcher row checked and disabled"
+                            },
+                            "control": {
+                                "type": "boolean",
+                                "description": "False hides the row from the switcher without removing the overlay"
+                            },
+                            "className": {
+                                "type": "string",
+                                "description": "CSS class of the layer container, isolating it from the shared ol-layer canvas (e.g. for blend modes)"
+                            },
+                            "blendMode": {
+                                "type": "string"
+                            },
+                            "extent": {
+                                "type": "array",
+                                "items": {
+                                    "type": "number"
+                                },
+                                "minItems": 4,
+                                "maxItems": 4,
+                                "description": "Clip the layer to this lon/lat bounding box [west, south, east, north] (mercator maps)"
+                            },
+                            "georeference": {
+                                "type": "object",
+                                "description": "A IIIF Georeference Extension annotation body plus the image it places. In a IIIF manifest this is a motivation: \"georeferencing\" annotation whose target embeds the image and whose body is the FeatureCollection of ground control points.",
+                                "required": ["url", "width", "height", "body"],
+                                "properties": {
+                                    "url": {
+                                        "type": "string",
+                                        "description": "IIIF Image API service base, or a full-size image URL"
+                                    },
+                                    "width": {
+                                        "type": "number",
+                                        "exclusiveMinimum": 0,
+                                        "description": "Image width in pixels (the resourceCoords space)"
+                                    },
+                                    "height": {
+                                        "type": "number",
+                                        "exclusiveMinimum": 0,
+                                        "description": "Image height in pixels"
+                                    },
+                                    "body": {
+                                        "type": "object",
+                                        "description": "The Georeference Extension annotation body, verbatim: a GeoJSON FeatureCollection of ground control points pairing properties.resourceCoords (image pixels) with geometry.coordinates (WGS84 lon/lat), optionally with a transformation hint.",
+                                        "required": ["type", "features"],
+                                        "properties": {
+                                            "type": {
+                                                "const": "FeatureCollection"
+                                            },
+                                            "transformation": {
+                                                "type": "object"
+                                            },
+                                            "features": {
+                                                "type": "array",
+                                                "minItems": 1
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        },
+                        "anyOf": [
+                            {
+                                "required": ["map_type"]
+                            },
+                            {
+                                "required": ["georeference"]
+                            }
+                        ]
+                    }
+                },
+                "consent_required": {
+                    "type": "boolean"
+                },
                 "map_center_offset": {
                     "type": "object",
                     "properties": {
-                        "left": { "type": "number" },
-                        "top": { "type": "number" }
+                        "left": {
+                            "type": "number"
+                        },
+                        "top": {
+                            "type": "number"
+                        }
                     }
                 },
-                "map_popup": { "type": "boolean" },
-                "use_custom_markers": { "type": "boolean" },
-                "zoom_distance": { "type": "number" },
-                "calculate_zoom": { "type": "boolean" },
-                "less_bounce": { "type": "boolean" },
-                "line_follows_path": { "type": "boolean" },
-                "show_lines": { "type": "boolean" },
-                "show_history_line": { "type": "boolean" },
-                "line_color": { "type": "string" },
-                "line_color_inactive": { "type": "string" },
-                "line_weight": { "type": "number" },
-                "line_opacity": { "type": "number", "minimum": 0, "maximum": 1 },
-                "line_dash": { "type": "string" },
-                "line_join": { "type": "string" },
+                "use_custom_markers": {
+                    "type": "boolean"
+                },
+                "calculate_zoom": {
+                    "type": "boolean"
+                },
+                "line_follows_path": {
+                    "type": "boolean"
+                },
+                "show_lines": {
+                    "type": "boolean"
+                },
+                "show_history_line": {
+                    "type": "boolean"
+                },
+                "line_color": {
+                    "type": "string"
+                },
+                "line_color_inactive": {
+                    "type": "string"
+                },
+                "line_weight": {
+                    "type": "number"
+                },
+                "line_opacity": {
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1
+                },
+                "line_dash": {
+                    "type": "string"
+                },
+                "line_join": {
+                    "type": "string"
+                },
                 "iiif": {
                     "type": "object",
                     "required": ["url"],
@@ -84,52 +272,331 @@
                             "type": "string",
                             "description": "URL of the IIIF Image API info.json document"
                         },
-                        "attribution": { "type": "string" }
+                        "attribution": {
+                            "type": "string"
+                        },
+                        "width": {
+                            "type": "number",
+                            "exclusiveMinimum": 0,
+                            "description": "Canvas width in pixels, enabling region clamping and the static fallback without another fetch"
+                        },
+                        "height": {
+                            "type": "number",
+                            "exclusiveMinimum": 0,
+                            "description": "Canvas height in pixels, enabling region clamping and the static fallback without another fetch"
+                        },
+                        "fallbackUrl": {
+                            "type": "string",
+                            "format": "uri",
+                            "description": "Full-size image used when info.json cannot be loaded (slideshow image_static)"
+                        }
                     }
                 },
-                "font_css": { "type": "string" },
-                "call_to_action": { "type": "boolean" },
-                "call_to_action_text": { "type": "string" },
-                "fullscreen": { "type": "boolean" },
-                "show_overview": { "type": "boolean" },
-                "show_back_to_start": { "type": "boolean" },
-                "show_progress": { "type": "boolean" },
-                "show_distance": { "type": "boolean" },
-                "marker_labels": { "type": "boolean" },
-                "text_align": { "type": "string" },
-                "text_color": { "type": "string" },
-                "text_background_color": { "type": "string" },
-                "nocache": { "type": "boolean" },
+                "tilejson": {
+                    "type": "object",
+                    "description": "TileJSON source for the base layer: tiles becomes the map_type template, the rest constrains the source/view where the map can act on it",
+                    "required": ["tiles"],
+                    "properties": {
+                        "tiles": {
+                            "anyOf": [
+                                { "type": "string" },
+                                { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+                            ]
+                        },
+                        "minzoom": { "type": "number" },
+                        "maxzoom": { "type": "number" },
+                        "bounds": {
+                            "type": "array",
+                            "items": { "type": "number" },
+                            "minItems": 4,
+                            "maxItems": 4
+                        },
+                        "scheme": { "type": "string", "enum": ["xyz", "tms"] },
+                        "center": {
+                            "type": "array",
+                            "items": { "type": "number" },
+                            "minItems": 3,
+                            "maxItems": 3
+                        }
+                    }
+                },
+                "see_also": {
+                    "type": "array",
+                    "description": "seeAlso targets recorded from a IIIF manifest (annotation collections/pages); recorded but not fetched on load",
+                    "items": {
+                        "type": "object",
+                        "required": ["id", "type"],
+                        "properties": {
+                            "id": { "type": "string" },
+                            "type": { "type": "string" }
+                        }
+                    }
+                },
+                "title": {
+                    "type": "string",
+                    "description": "Story title carried by IIIF manifests (label) and slideshow tours; extra on legacy documents"
+                },
+                "metadata": {
+                    "type": "array",
+                    "description": "Label/value pairs carried from a IIIF manifest or slideshow tour; data-only, handed on as data.metadata[]"
+                },
+                "logo": {
+                    "description": "Publisher logo carried from a IIIF manifest; data-only, offered as data.logo"
+                },
+                "font_css": {
+                    "anyOf": [{ "type": "string" }, { "const": false }],
+                    "description": "Font theme stylesheet (stock:<name> or URL); false disables the injected stylesheet because the host bundles the theme itself"
+                },
+                "theme": {
+                    "type": "string",
+                    "enum": ["dark", "light"],
+                    "description": "Colour theme: dark forces the dark palette, light pins the light one; unset follows prefers-color-scheme"
+                },
+                "call_to_action": {
+                    "type": "boolean"
+                },
+                "call_to_action_text": {
+                    "type": "string"
+                },
+                "fullscreen": {
+                    "type": "boolean"
+                },
+                "show_overview": {
+                    "type": "boolean"
+                },
+                "show_back_to_start": {
+                    "type": "boolean"
+                },
+                "show_progress": {
+                    "type": "boolean"
+                },
+                "progressbar": {
+                    "anyOf": [
+                        { "type": "boolean" },
+                        {
+                            "type": "string",
+                            "enum": ["bar", "dots", "squares", "block", "thinblock", "off"]
+                        }
+                    ],
+                    "description": "Progress indicator style (slideshow progressbar): false/off hides it, true/bar is the classic fill bar, dots/squares render one step per slide, block/thinblock are fill-bar height variants. Absent means show_progress decides with the bar style. Honored only with slideshow_source."
+                },
+                "show_layers_control": {
+                    "type": "boolean",
+                    "description": "Show the basemap/overlay switcher in the menubar"
+                },
+                "basemaps": {
+                    "type": "array",
+                    "description": "Selectable base maps for the layer switcher; entry 0 is the initial basemap unless map_type says otherwise",
+                    "items": {
+                        "type": "object",
+                        "required": ["map_type"],
+                        "properties": {
+                            "map_type": {
+                                "type": "string",
+                                "description": "Any map_type value"
+                            },
+                            "label": {
+                                "type": "string",
+                                "description": "Control row label (defaults to map_type)"
+                            }
+                        }
+                    }
+                },
+                "show_distance": {
+                    "type": "boolean"
+                },
+                "marker_labels": {
+                    "type": "boolean"
+                },
+                "text_align": {
+                    "type": "string",
+                    "enum": ["left", "center", "right"],
+                    "description": "Default horizontal alignment for slide text"
+                },
+                "textmode": {
+                    "type": "string",
+                    "enum": ["left", "right", "bottom"],
+                    "description": "Slide panel dock (slideshow textmode) in landscape: right (default) is the current layout, left mirrors it, bottom docks the panel below the map. Portrait layouts always behave like bottom. Honored only with slideshow_source."
+                },
+                "textsize": {
+                    "type": "number",
+                    "minimum": 10,
+                    "maximum": 80,
+                    "description": "Slide panel size as a percentage (slideshow textsize): percent of the width for side docks, of the height for the bottom dock. Absent keeps the built-in 50/50 split. Honored only with slideshow_source."
+                },
+                "fxmode": {
+                    "type": "string",
+                    "enum": ["slide", "fade", "none"],
+                    "description": "Slide transition effect (slideshow fxmode): slide (default) is the current glide, fade cross-fades slides, none jumps without animation. prefers-reduced-motion still forces none. Honored only with slideshow_source."
+                },
+                "mode": {
+                    "type": "string",
+                    "enum": ["standard", "static"],
+                    "description": "Reading mode (slideshow mode): standard (default) is the slider; static stacks all slides in a scrollable list and follows the map to the slide in view. Honored only with slideshow_source."
+                },
+                "hudcolor": {
+                    "type": "string",
+                    "description": "HUD foreground color override (slideshow hudcolor). Honored only with slideshow_source."
+                },
+                "hudbgcolor": {
+                    "type": "string",
+                    "description": "HUD background color override (slideshow hudbgcolor). Honored only with slideshow_source."
+                },
+                "hudopacity": {
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 100,
+                    "description": "HUD opacity percent 0..100 (slideshow hudopacity), applied to the HUD background. Honored only with slideshow_source."
+                },
+                "shownav": {
+                    "type": "boolean",
+                    "description": "Show the previous/next slide navigation (slideshow shownav). Default true. Honored only with slideshow_source."
+                },
+                "show_headings": {
+                    "type": "boolean",
+                    "description": "Render slide headlines (slideshow showheadings). Default true; false hides headline elements. Honored only with slideshow_source."
+                },
+                "show_scrollbars": {
+                    "type": "boolean",
+                    "description": "Show scrollbars in the slide panel (slideshow showscrollbars). Default true; false hides them (content still scrolls). Honored only with slideshow_source."
+                },
+                "viewerheight": {
+                    "type": "string",
+                    "pattern": "^[0-9]+(\\.[0-9]+)?(px|%|vh)$",
+                    "description": "Fixed viewer height (slideshow viewerheight), e.g. 400px: applied as a container height override when set. Honored only with slideshow_source."
+                },
+                "show_info": {
+                    "type": "boolean",
+                    "description": "Show media captions and credits (slideshow showinfo). Default true; false hides the caption/credit block. Honored only with slideshow_source."
+                },
+                "text_color": {
+                    "type": "string"
+                },
+                "text_background_color": {
+                    "type": "string"
+                },
+                "nocache": {
+                    "type": "boolean"
+                },
                 "autoplay": {
                     "type": "number",
-                    "description": "Seconds per slide; 0 disables autoplay"
+                    "description": "Milliseconds per slide; 0 (the default) disables autoplay"
+                },
+                "autoplay_media": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "When autoplaying, wait for the slide media to end before advancing; the autoplay timer stays as the fallback."
+                },
+                "trackResize": {
+                    "type": "boolean"
+                },
+                "duration": {
+                    "type": "number"
                 },
-                "trackResize": { "type": "boolean" },
-                "dragging": { "type": "boolean" },
-                "duration": { "type": "number" },
                 "map_overview_center": {
                     "anyOf": [
                         {
                             "type": "object",
                             "properties": {
-                                "lat": { "type": "number" },
-                                "lon": { "type": "number" }
+                                "lat": {
+                                    "type": "number"
+                                },
+                                "lon": {
+                                    "type": "number"
+                                }
                             }
                         },
-                        { "type": "null" }
+                        {
+                            "type": "null"
+                        }
                     ]
                 },
-                "api_key_flickr": { "type": "string" },
-                "attribution": { "type": "string" },
-                "start_at_slide": { "type": "integer", "minimum": 0 },
+                "api_key_flickr": {
+                    "type": "string"
+                },
+                "attribution": {
+                    "type": "string"
+                },
+                "start_at_slide": {
+                    "type": "integer",
+                    "minimum": 0
+                },
                 "slides": {
                     "type": "array",
-                    "items": { "$ref": "#/$defs/slide" }
+                    "items": {
+                        "$ref": "#/$defs/slide"
+                    }
+                },
+                "credit": {
+                    "type": "object",
+                    "description": "Authorship and rights for the story (slideshow creator/rights); rendered into the map attribution line for slideshow tours.",
+                    "properties": {
+                        "creator": { "type": "string" },
+                        "rights": { "type": "string" },
+                        "licenseUrl": { "type": "string", "format": "uri" }
+                    }
+                },
+                "layout": {
+                    "type": "string",
+                    "enum": ["landscape", "portrait"],
+                    "description": "Force a layout instead of deriving it from the container width. \"portrait\" is what the viewer picks at or below skinny_size."
                 }
             }
         }
     },
     "$defs": {
+        "media": {
+            "type": "object",
+            "properties": {
+                "url": {
+                    "type": ["string", "null"]
+                },
+                "caption": {
+                    "type": ["string", "null"]
+                },
+                "credit": {
+                    "type": ["string", "null"]
+                },
+                "thumb": {
+                    "type": "string"
+                },
+                "alt": {
+                    "type": "string"
+                },
+                "srcset": {
+                    "type": "string"
+                },
+                "sizes": {
+                    "type": "string"
+                },
+                "subtitles": {
+                    "type": ["string", "null"],
+                    "format": "uri",
+                    "description": "WebVTT subtitle file for an audio or video slide, rendered as a <track kind=\"subtitles\">."
+                },
+                "offset": {
+                    "type": "number",
+                    "minimum": 0,
+                    "description": "Start offset in seconds for audio/video media (slideshow audio.offset). Honored only with slideshow_source"
+                },
+                "loop": {
+                    "type": "boolean",
+                    "description": "Loop audio/video media (slideshow audio.loop). Honored only with slideshow_source"
+                },
+                "play": {
+                    "type": "string",
+                    "enum": ["auto", "click"],
+                    "description": "auto plays on activation; click arms paused for the visitor to start. Honored only with slideshow_source"
+                },
+                "stopOnExit": {
+                    "type": "boolean",
+                    "description": "Stop this media when leaving the slide (default true); false lets an audio bed continue. Honored only with slideshow_source"
+                },
+                "mediatype": {
+                    "type": ["object", "null"]
+                }
+            }
+        },
         "slide": {
             "type": "object",
             "properties": {
@@ -137,8 +604,16 @@
                     "type": "string",
                     "description": "'overview' marks the map overview slide"
                 },
-                "date": { "type": ["string", "object", "null"] },
-                "group": { "type": "string" },
+                "date": {
+                    "type": ["string", "object", "null"]
+                },
+                "group": {
+                    "type": "string"
+                },
+                "language": {
+                    "type": "string",
+                    "description": "The language tag this slide's text is in. A IIIF manifest states text as a language map; the reader picks the viewer's configured language and reports which one it used, so a host can offer a language switch. Absent for language-neutral (none) text."
+                },
                 "location": {
                     "type": "object",
                     "properties": {
@@ -150,46 +625,224 @@
                             "type": "number",
                             "description": "Longitude, or horizontal position in image pixels for image maps"
                         },
-                        "zoom": { "type": "number" },
-                        "line": { "type": "boolean" },
-                        "name": { "type": "string" },
-                        "icon": { "type": "string", "format": "uri" },
+                        "region": {
+                            "type": "array",
+                            "items": {
+                                "type": "number"
+                            },
+                            "minItems": 4,
+                            "maxItems": 4,
+                            "description": "Image region [x, y, w, h] in image pixels (IIIF xywh convention) for image maps; the view fits the region on navigation. Negative origins are clamped to the canvas."
+                        },
+                        "rotation": {
+                            "type": "number",
+                            "description": "View rotation in degrees clockwise (slideshow rotation); absent means north-up. Honored only with slideshow_source"
+                        },
+                        "filter": {
+                            "type": "object",
+                            "description": "Per-slide image grading (slideshow filters), applied as a CSS filter() on the map viewport. Honored only with slideshow_source",
+                            "properties": {
+                                "brightness": { "type": "number", "minimum": 0, "maximum": 200 },
+                                "contrast": { "type": "number", "minimum": 0, "maximum": 200 },
+                                "saturate": { "type": "number", "minimum": 0, "maximum": 200 },
+                                "hueRotate": { "type": "number", "minimum": -180, "maximum": 180 },
+                                "sepia": { "type": "number", "minimum": 0, "maximum": 100 },
+                                "blur": { "type": "number", "minimum": 0, "maximum": 20 }
+                            }
+                        },
+                        "mask": {
+                            "type": "object",
+                            "description": "Spotlight mask (slideshow passepartout): normalized viewport fractions left visible while the rest is dimmed. Honored only with slideshow_source",
+                            "required": ["x", "y", "w", "h"],
+                            "properties": {
+                                "x": { "type": "number" },
+                                "y": { "type": "number" },
+                                "w": { "type": "number", "exclusiveMinimum": 0 },
+                                "h": { "type": "number", "exclusiveMinimum": 0 },
+                                "color": { "type": "string" },
+                                "invert": { "type": "boolean" },
+                                "opacity": { "type": "number", "minimum": 0, "maximum": 1 }
+                            }
+                        },
+                        "basemap": {
+                            "type": "string",
+                            "description": "Per-slide basemap override (multi-manifest tours): any map_type value or IIIF info.json URL. Absent keeps the story basemap. Honored only with slideshow_source."
+                        },
+                        "zoom": {
+                            "type": "number"
+                        },
+                        "line": {
+                            "type": "boolean"
+                        },
+                        "name": {
+                            "type": "string"
+                        },
+                        "icon": {
+                            "type": "string",
+                            "format": "uri"
+                        },
                         "iconSize": {
                             "type": "array",
-                            "items": { "type": "number" },
+                            "items": {
+                                "type": "number"
+                            },
                             "minItems": 1,
                             "maxItems": 2
                         },
-                        "image": { "type": "string", "format": "uri" },
-                        "use_custom_marker": { "type": "boolean" }
+                        "image": {
+                            "type": "string",
+                            "format": "uri"
+                        },
+                        "use_custom_marker": {
+                            "type": "boolean"
+                        }
                     }
                 },
                 "media": {
-                    "type": "object",
-                    "properties": {
-                        "url": { "type": ["string", "null"] },
-                        "caption": { "type": ["string", "null"] },
-                        "credit": { "type": ["string", "null"] },
-                        "thumb": { "type": "string" },
-                        "mediatype": { "type": ["object", "null"] }
+                    "$ref": "#/$defs/media"
+                },
+                "media_extra": {
+                    "type": ["array", "null"],
+                    "description": "Additional visible media for this slide (#358), rendered after media in order. Items without a non-empty url are skipped. In a IIIF manifest these are further painting annotations on the canvas.",
+                    "items": {
+                        "$ref": "#/$defs/media"
                     }
                 },
+                "media_layout": {
+                    "type": "string",
+                    "enum": ["stack", "row"],
+                    "description": "Layout of a multi-media slide (#358): stack piles the items vertically (the panel scrolls), row puts two items side by side. Defaults to stack; row with anything but two items falls back to stack."
+                },
                 "text": {
                     "type": "object",
                     "properties": {
-                        "headline": { "type": "string" },
-                        "text": { "type": "string" },
-                        "date": { "type": ["string", "object", "null"] }
+                        "headline": {
+                            "type": "string"
+                        },
+                        "text": {
+                            "type": "string"
+                        },
+                        "date": {
+                            "type": ["string", "object", "null"]
+                        },
+                        "text_align": {
+                            "type": "string",
+                            "enum": ["left", "center", "right"],
+                            "description": "Horizontal alignment of this slide's text block"
+                        }
+                    }
+                },
+                "marker": {
+                    "type": ["object", "null"],
+                    "description": "Per-slide marker presentation. location.icon/iconSize/image/use_custom_marker and location.name remain supported as legacy spellings; marker.* wins when present. In a IIIF manifest these arrive in the navPlace Feature properties instead.",
+                    "properties": {
+                        "icon": {
+                            "type": "string",
+                            "format": "uri"
+                        },
+                        "iconSize": {
+                            "type": "array",
+                            "items": {
+                                "type": "number"
+                            }
+                        },
+                        "image": {
+                            "type": "string",
+                            "format": "uri"
+                        },
+                        "label": {
+                            "type": "string"
+                        },
+                        "popup": {
+                            "type": "boolean"
+                        },
+                        "audioBadge": {
+                            "type": "boolean"
+                        }
                     }
                 },
+                "narration": {
+                    "type": ["object", "null"],
+                    "description": "Spoken narration for this slide, played through a dedicated audio element. In a IIIF manifest this is a motivation: supplementing Sound/Video body, read and written alongside the painting annotation.",
+                    "properties": {
+                        "url": {
+                            "type": "string",
+                            "format": "uri"
+                        },
+                        "loop": {
+                            "type": "boolean",
+                            "description": "Loop the narration (slideshow audio.loop). Honored only with slideshow_source"
+                        },
+                        "offset": {
+                            "type": "number",
+                            "minimum": 0,
+                            "description": "Start offset in seconds (slideshow audio.offset). Honored only with slideshow_source"
+                        },
+                        "play": {
+                            "type": "string",
+                            "enum": ["auto", "click"],
+                            "description": "auto plays on navigation; click arms paused for the visitor to start (slideshow audio.play). Honored only with slideshow_source"
+                        },
+                        "stopOnExit": {
+                            "type": "boolean",
+                            "description": "Stop when leaving the slide (default true); false keeps an audio bed across slides while the URL is unchanged. Honored only with slideshow_source"
+                        },
+                        "stopAllPrevious": {
+                            "type": "boolean",
+                            "description": "Stop any other playing track before starting (default true); false allows ambient overlap. Honored only with slideshow_source"
+                        }
+                    },
+                    "required": ["url"]
+                },
+                "slidetimeout": {
+                    "type": "number",
+                    "minimum": 0,
+                    "description": "Per-slide autoplay dwell in milliseconds (slideshow slidetimeout): overrides the global autoplay interval for this slide; 0 holds. Absent means the global interval. Honored only with slideshow_source."
+                },
+                "imgoverlay": {
+                    "anyOf": [{ "type": "object" }, { "type": "null" }],
+                    "description": "Per-slide image overlay on the map (slideshow imgoverlay), shown while this slide is active. Honored only with slideshow_source",
+                    "properties": {
+                        "url": { "type": "string", "format": "uri" },
+                        "size": { "type": "number", "exclusiveMinimum": 0 },
+                        "opacity": { "type": "number", "minimum": 0, "maximum": 1 },
+                        "extent": {
+                            "type": "array",
+                            "items": { "type": "number" },
+                            "minItems": 4,
+                            "maxItems": 4
+                        }
+                    },
+                    "required": ["url"]
+                },
                 "background": {
                     "type": ["object", "string"],
                     "properties": {
-                        "url": { "type": ["string", "null"], "format": "uri" },
-                        "color": { "type": ["string", "null"] }
+                        "url": {
+                            "type": ["string", "null"],
+                            "format": "uri"
+                        },
+                        "color": {
+                            "type": ["string", "null"]
+                        },
+                        "opacity": {
+                            "type": "number",
+                            "description": "Background image opacity, 0-1"
+                        }
                     }
                 },
-                "uniqueid": { "type": "string" }
+                "uniqueid": {
+                    "type": "string"
+                },
+                "provenance": {
+                    "type": "object",
+                    "description": "Provenance identifiers for the slide's source (slideshow manifest/canvas/image ids). Data-only, never rendered.",
+                    "properties": {
+                        "manifest": { "type": "string", "format": "uri" },
+                        "canvas": { "type": "string", "format": "uri" },
+                        "image": { "type": "string", "format": "uri" }
+                    }
+                }
             }
         }
     }