@nulib/clover 4.0.0-beta.1 → 4.1.0

package/dist/web-components/custom-elements.json

@@ -44,7 +44,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "In a Collection, the Manifest to open first. The reader moves on from it."
+              "description": "In a Collection, the Manifest to open first. The others stay reachable from it."
             },
             {
               "name": "language",
@@ -53,6 +53,14 @@
               },
               "description": "The language to read IIIF text in."
             },
+            {
+              "name": "high-contrast",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Clover's higher-contrast mode, for what is inside: the accent kept to rings, outlines and marks, never under words or a glyph, where the controls' dark fill takes its place, edged in the accent. On wherever the system asks for more contrast, too.",
+              "default": "false"
+            },
             {
               "name": "search-query",
               "type": {
@@ -79,11 +87,19 @@
             {
               "name": "items",
               "type": {
-                "text": "\"slider\" | \"list\" | \"grid\" | \"false\""
+                "text": "\"slider\" | \"list\" | \"grid\" | \"masonry\" | \"false\""
               },
-              "description": "Default: the thumbnails, as a slider, list or grid, or \"false\" for none.",
+              "description": "Default and Gallery: Default's thumbnails, as a slider, list or grid, or \"false\" for none; Gallery's grid, as grid (its default) or masonry.",
               "default": "slider"
             },
+            {
+              "name": "single-item",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Default and Document: the thumbnails even where the resource has one view, which has nothing to choose between. Gallery's grid always shows them.",
+              "default": "false"
+            },
             {
               "name": "header",
               "type": {
@@ -97,7 +113,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Default: \"false\" leaves out the information panel.",
+              "description": "Default and Gallery: \"false\" leaves out the information panel, Default's beside its Body, the Gallery's beside its lightbox's view.",
               "default": "true"
             },
             {
@@ -105,7 +121,15 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Default and Document: \"false\" leaves out the downloads: Default's in its panel's About, Document's in its toolbar (its panel's About lists none).",
+              "description": "Default, Document and Gallery: \"false\" leaves out the downloads: Default's and the Gallery's from a Download button beside its panel's About heading, Document's in its toolbar (its panel's About offers none).",
+              "default": "true"
+            },
+            {
+              "name": "languages",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Default, Document and Gallery: where what the resource says of itself comes in several languages, the panel's About heading offers them, and the whole Viewer reads in the one chosen. \"false\" leaves the choice out.",
               "default": "true"
             },
             {
@@ -113,14 +137,14 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Default and Document: whether the information panel starts open beside the page. Default's does, by default; Document's starts shut. Where it would slide over the page (a phone), it starts shut."
+              "description": "Default, Document and Gallery: whether the information panel starts open beside the page (the Gallery's, beside its lightbox's view). Default's and the Gallery's do, by default; Document's starts shut. Where it would slide over the page (a phone), it starts shut."
             },
             {
               "name": "panel-layout",
               "type": {
                 "text": "\"accordion\" | \"tabs\""
               },
-              "description": "Default and Document: the panel's sections as stacked boxes, each opened by its heading, or as tabs.",
+              "description": "Default, Document and Gallery: the panel's sections as stacked boxes, each opened by its heading, or as tabs.",
               "default": "accordion"
             },
             {
@@ -135,7 +159,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Default and Document: where the width the reader gives a pane is remembered (localStorage); \"false\" forgets it."
+              "description": "Default, Document and Gallery: where the width chosen for a pane is remembered (localStorage); \"false\" forgets it."
             },
             {
               "name": "fill",
@@ -145,6 +169,14 @@
               "description": "Default: as tall as the box it is in, the Body taking what the header and the thumbnails leave.",
               "default": "false"
             },
+            {
+              "name": "collapse-controls",
+              "type": {
+                "text": "\"auto\" | \"always\""
+              },
+              "description": "Default, Document and Gallery: when the Body's view controls (zoom, the turns, reset, full screen) collapse behind one button, the Gallery's in its lightbox: auto, only where the row cannot hold them all; always, wherever there are any, leaving the media more room.",
+              "default": "auto"
+            },
             {
               "name": "size",
               "type": {
@@ -152,6 +184,45 @@
               },
               "description": "Gallery: the size of a cell in the grid.",
               "default": "10rem"
+            },
+            {
+              "name": "height",
+              "type": {
+                "text": "string"
+              },
+              "description": "Gallery: its height, auto (growing with its grid) or a CSS length, the grid scrolling under the header.",
+              "default": "auto"
+            },
+            {
+              "name": "gap",
+              "type": {
+                "text": "string"
+              },
+              "description": "Gallery: the space between the grid's cells, a CSS length. Its inset unless set."
+            },
+            {
+              "name": "secondary",
+              "type": {
+                "text": "\"summary\" | \"navDate\" | \"none\""
+              },
+              "description": "Gallery: the line under each cell's label, where it has one: summary, navDate or none.",
+              "default": "summary"
+            },
+            {
+              "name": "summary",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Gallery: the resource's summary under the title, cut to two lines with Read more under it where it runs longer; \"false\" leaves it out.",
+              "default": "true"
+            },
+            {
+              "name": "lightbox-items",
+              "type": {
+                "text": "\"slider\" | \"pager\""
+              },
+              "description": "Gallery: how its lightbox moves on from the view it shows: a short strip of thumbnails (slider), or a pager, Previous, the position and Next.",
+              "default": "slider"
             }
           ],
           "members": [
@@ -194,14 +265,14 @@
               "type": {
                 "text": "CustomEvent<{ canvasId: string }>"
               },
-              "description": "The reader moved to a Canvas."
+              "description": "The current Canvas changed."
             },
             {
               "name": "clover-manifest-change",
               "type": {
                 "text": "CustomEvent<{ manifestId: string }>"
               },
-              "description": "In a Collection, the reader moved to another Manifest."
+              "description": "In a Collection, another Manifest opened."
             },
             {
               "name": "clover-status-change",
@@ -215,7 +286,7 @@
               "type": {
                 "text": "CustomEvent<{ json: Record<string, unknown>; encoded: string }>"
               },
-              "description": "Where the reader is, as a IIIF content state, each time it settles."
+              "description": "The current view, as a IIIF content state, as it changes: at most every 100ms while it moves, and always its last place."
             }
           ],
           "slots": []
@@ -225,7 +296,7 @@
           "customElement": true,
           "tagName": "clover-root",
           "name": "CloverRootElement",
-          "description": "The root of a layout of your own: it loads what it is given, holds where the reader is, and gives every part inside it the same state. The page's markup inside it stays as written.",
+          "description": "The root of a layout of your own: it loads what it is given, holds the current view, and gives every part inside it the same state. The page's markup inside it stays as written.",
           "superclass": {
             "name": "HTMLElement"
           },
@@ -243,21 +314,29 @@
               "type": {
                 "text": "string"
               },
-              "description": "The Canvas to open on. Changed later, it moves the reader there."
+              "description": "The Canvas to open on. Changed later, the view moves there."
             },
             {
               "name": "manifest-id",
               "type": {
                 "text": "string"
               },
-              "description": "In a Collection, the Manifest to open first. Changed later, it moves the reader there."
+              "description": "In a Collection, the Manifest to open first. Changed later, the view moves there."
             },
             {
               "name": "language",
               "type": {
                 "text": "string"
               },
-              "description": "The language to read IIIF text in. The page's, then the reader's, by default."
+              "description": "The language to read IIIF text in. The page's, then the browser's, by default."
+            },
+            {
+              "name": "high-contrast",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Clover's higher-contrast mode, for what is inside: the accent kept to rings, outlines and marks, never under words or a glyph, where the controls' dark fill takes its place, edged in the accent. On wherever the system asks for more contrast, too.",
+              "default": "false"
             },
             {
               "name": "search-query",
@@ -279,7 +358,7 @@
               "type": {
                 "text": "\"view\" | \"all\""
               },
-              "description": "Whose referenced annotation pages to fetch: the view's as the reader moves, or every Canvas's at once.",
+              "description": "Whose referenced annotation pages to fetch: the current view's as it changes, or every Canvas's at once.",
               "default": "view"
             },
             {
@@ -346,14 +425,14 @@
               "type": {
                 "text": "CustomEvent<{ canvasId: string }>"
               },
-              "description": "The reader moved to a Canvas."
+              "description": "The current Canvas changed."
             },
             {
               "name": "clover-manifest-change",
               "type": {
                 "text": "CustomEvent<{ manifestId: string }>"
               },
-              "description": "In a Collection, the reader moved to another Manifest."
+              "description": "In a Collection, another Manifest opened."
             },
             {
               "name": "clover-status-change",
@@ -367,7 +446,7 @@
               "type": {
                 "text": "CustomEvent<{ json: Record<string, unknown>; encoded: string }>"
               },
-              "description": "Where the reader is, as a IIIF content state, each time it settles."
+              "description": "The current view, as a IIIF content state, as it changes: at most every 100ms while it moves, and always its last place."
             }
           ],
           "slots": []
@@ -391,6 +470,14 @@
               "default": "true",
               "fieldName": "controls"
             },
+            {
+              "name": "collapse-controls",
+              "type": {
+                "text": "\"auto\" | \"always\""
+              },
+              "description": "When the view's controls (zoom, the turns, reset, full screen) collapse behind one button, at the end of the controls' one row, so the row fits any width and leaves the media more room: auto, only where the row cannot hold them all; always, wherever there are any. Pressed, the button opens a tray of them beside the rest.",
+              "default": "auto"
+            },
             {
               "name": "navigator",
               "type": {
@@ -412,7 +499,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Glide to a picked annotation, rather than frame it in one cut. A reader who asks for reduced motion gets the cut.",
+              "description": "Glide to a picked annotation, rather than frame it in one cut. Where reduced motion is asked for, it cuts.",
               "default": "false"
             }
           ],
@@ -430,7 +517,7 @@
               "kind": "field",
               "name": "controls",
               "type": {
-                "text": "boolean | { zoom?: boolean; fullPage?: boolean; rotation?: boolean; reset?: boolean; annotations?: boolean; information?: boolean; [option: string]: unknown } | null"
+                "text": "boolean | { zoom?: boolean; fullPage?: boolean; rotation?: boolean; reset?: boolean; annotations?: boolean; information?: boolean; map?: boolean; [option: string]: unknown } | null"
               },
               "description": "Which of the Body's controls it shows, as Canvas's controls takes it: false for none, or some ({ rotation: false }), in place of the attribute."
             },
@@ -467,6 +554,13 @@
               },
               "description": "The view is laid out and fitted: its handle is here, and works from now on."
             },
+            {
+              "name": "clover-content-state-change",
+              "type": {
+                "text": "CustomEvent<{ json: Record<string, unknown>; encoded: string }>"
+              },
+              "description": "The root's view, as a IIIF content state, as it changes, whatever draws it."
+            },
             {
               "name": "clover-annotation-active",
               "type": {
@@ -479,7 +573,7 @@
               "type": {
                 "text": "CustomEvent<{ caption: { id: string; language?: string } | null }>"
               },
-              "description": "The reader chose a caption file in the Captions menu, or Off (null)."
+              "description": "A caption file was chosen in the Captions menu, or Off (null)."
             },
             {
               "name": "clover-ended",
@@ -512,7 +606,7 @@
             {
               "name": "as",
               "type": {
-                "text": "\"span\" | \"p\" | \"div\" | \"strong\" | \"em\" | \"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\""
+                "text": "\"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\" | \"span\" | \"label\" | \"figcaption\" | \"p\" | \"strong\" | \"em\" | \"div\""
               },
               "description": "The element to draw: span, p, div, strong, em, or a heading, h1 to h6, to fit the page's outline.",
               "default": "span"
@@ -552,17 +646,33 @@
             {
               "name": "layout",
               "type": {
-                "text": "\"slider\" | \"list\" | \"grid\" | \"pager\""
+                "text": "\"slider\" | \"list\" | \"grid\" | \"masonry\" | \"pager\""
               },
-              "description": "A scrolling row, a column, a wrapping grid, or a pager: Previous, the position and Next, with no thumbnails.",
+              "description": "A scrolling row, a column, a wrapping grid, masonry (a grid whose pictures keep their proportions, packed in reading order), or a pager: Previous, the position and Next, with no thumbnails.",
               "default": "slider"
             },
+            {
+              "name": "secondary",
+              "type": {
+                "text": "\"summary\" | \"navDate\" | \"none\""
+              },
+              "description": "The line under an item's label, where it has one (a Collection's members do): its summary, its navDate, or none.",
+              "default": "summary"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "\"large\" | \"small\""
+              },
+              "description": "The pager's size: large, round controls; or small, its steps and count as Search's are, for a header's line.",
+              "default": "large"
+            },
             {
               "name": "of",
               "type": {
-                "text": "\"views\" | \"members\""
+                "text": "\"views\" | \"members\" | \"targets\" | \"annotations\""
               },
-              "description": "Inside a root: its views, or the members of the Collection it belongs to.",
+              "description": "Inside a root: its views, the members of the Collection it belongs to, a content state's targets, where it names two or more, each opening its Manifest at its place, or annotations walked as one whole (the AnnotationPage or AnnotationCollection given as the content, else the AnnotationCollection its annotation pages are part of), each picked and framed on its Canvas.",
               "default": "views"
             },
             {
@@ -604,12 +714,28 @@
               "description": "Pixels to ask for each thumbnail's longer side.",
               "default": "200"
             },
+            {
+              "name": "single-item",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Inside a root: its views even where there is only one, as a gallery's grid does. The pager, with nothing to step to, still draws nothing.",
+              "default": "false"
+            },
             {
               "name": "language",
               "type": {
                 "text": "string"
               },
               "description": "Alone: the language to read IIIF text in."
+            },
+            {
+              "name": "high-contrast",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Clover's higher-contrast mode, for what is inside: the accent kept to rings, outlines and marks, never under words or a glyph, where the controls' dark fill takes its place, edged in the accent. On wherever the system asks for more contrast, too.",
+              "default": "false"
             }
           ],
           "members": [
@@ -662,7 +788,7 @@
           "customElement": true,
           "tagName": "clover-position",
           "name": "CloverPositionElement",
-          "description": "Where the reader is, as a count: Item 3 of 12. It keeps the room of its widest count, so nothing beside it moves.",
+          "description": "The current position, as a count: Item 3 of 12. It keeps the room of its widest count, so nothing beside it moves.",
           "superclass": {
             "name": "HTMLElement"
           },
@@ -670,9 +796,9 @@
             {
               "name": "of",
               "type": {
-                "text": "\"views\" | \"members\""
+                "text": "\"views\" | \"members\" | \"targets\""
               },
-              "description": "What it steps through: the root's views, or its Collection's members.",
+              "description": "What it steps through: the root's views, its Collection's members, or a content state's targets.",
               "default": "views"
             },
             {
@@ -701,9 +827,9 @@
             {
               "name": "of",
               "type": {
-                "text": "\"views\" | \"members\""
+                "text": "\"views\" | \"members\" | \"targets\""
               },
-              "description": "What it steps through: the root's views, or its Collection's members.",
+              "description": "What it steps through: the root's views, its Collection's members, or a content state's targets.",
               "default": "views"
             }
           ],
@@ -724,9 +850,9 @@
             {
               "name": "of",
               "type": {
-                "text": "\"views\" | \"members\""
+                "text": "\"views\" | \"members\" | \"targets\""
               },
-              "description": "What it steps through: the root's views, or its Collection's members.",
+              "description": "What it steps through: the root's views, its Collection's members, or a content state's targets.",
               "default": "views"
             }
           ],
@@ -1295,7 +1421,7 @@
           "customElement": true,
           "tagName": "clover-value",
           "name": "CloverValueElement",
-          "description": "Any IIIF language map in the reader's language, read strictly by its format: text/html as sanitized HTML, text/plain as written, text/markdown as Markdown.",
+          "description": "Any IIIF language map in the defined language, read strictly by its format: text/html as sanitized HTML, text/plain as written, text/markdown as Markdown.",
           "superclass": {
             "name": "HTMLElement"
           },
@@ -1371,6 +1497,14 @@
               "description": "\"false\" leaves out the downloads.",
               "default": "true"
             },
+            {
+              "name": "languages",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alone: outside a clover-panel, where what the resource says of itself comes in several languages, a choice of them over what it says, the whole clover-root reading in the one chosen. \"false\" leaves it out.",
+              "default": "true"
+            },
             {
               "name": "thumbnail",
               "type": {
@@ -1542,7 +1676,7 @@
           "customElement": true,
           "tagName": "clover-transcript",
           "name": "CloverTranscriptElement",
-          "description": "The recording's captions as a transcript, following where it plays, and any plain-text transcript after them. Each cue goes to its time; a field over the captions finds words in them, with steps through the cues that have them.",
+          "description": "The recording's captions as a transcript (or its WebVTT transcript, as its annotation provides one), following where it plays, and any plain-text transcript after them. Each cue goes to its time; a field over the captions finds words in them, with steps through the cues that have them.",
           "superclass": {
             "name": "HTMLElement"
           },
@@ -1655,12 +1789,28 @@
               "description": "Zoom with the wheel or a trackpad, which can trap the page's scroll.",
               "default": "false"
             },
+            {
+              "name": "credits",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "\"false\" leaves out the basemap's credits, the ⓘ in the map's lower corner, which a basemap's license may ask for: give them on the page yourself.",
+              "default": "true"
+            },
             {
               "name": "language",
               "type": {
                 "text": "string"
               },
               "description": "Alone: the language to read IIIF text in."
+            },
+            {
+              "name": "high-contrast",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Clover's higher-contrast mode, for what is inside: the accent kept to rings, outlines and marks, never under words or a glyph, where the controls' dark fill takes its place, edged in the accent. On wherever the system asks for more contrast, too.",
+              "default": "false"
             }
           ],
           "members": [
@@ -1746,7 +1896,15 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "\"false\" leaves the downloads out of About.",
+              "description": "About's heading offers the downloads, by a Download button that lists them; \"false\" leaves them out.",
+              "default": "true"
+            },
+            {
+              "name": "languages",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Where what the resource says of itself comes in several languages, About's heading offers them, and the whole clover-root reads in the one chosen. \"false\" leaves the choice out.",
               "default": "true"
             },
             {
@@ -1781,14 +1939,14 @@
               "type": {
                 "text": "CustomEvent<{ value: string }>"
               },
-              "description": "The reader chose a tab, or opened a box."
+              "description": "A tab was chosen, or a box opened."
             },
             {
               "name": "clover-close",
               "type": {
                 "text": "CustomEvent<Record<string, never>>"
               },
-              "description": "The reader closed the panel. Cancel it (preventDefault) to keep it shown."
+              "description": "Its close button was pressed. Cancel it (preventDefault) to keep the panel shown."
             }
           ],
           "slots": []
@@ -1852,7 +2010,7 @@
               "type": {
                 "text": "CustomEvent<{ open: boolean }>"
               },
-              "description": "The reader pressed it, to show (open) or hide what it controls. Cancel it (preventDefault) to leave that as it is."
+              "description": "It was pressed, to show (open) or hide what it controls. Cancel it (preventDefault) to leave that as it is."
             }
           ],
           "slots": []
@@ -1862,7 +2020,7 @@
           "customElement": true,
           "tagName": "clover-split",
           "name": "CloverSplitElement",
-          "description": "Panes side by side, its clover-split-pane children, divided by clover-split-handle bars the reader drags, clicks or moves by keyboard to share the width.",
+          "description": "Panes side by side, its clover-split-pane children, divided by clover-split-handle bars that share the width, dragged, clicked or moved by keyboard.",
           "superclass": {
             "name": "HTMLElement"
           },
@@ -1872,7 +2030,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Remember the sizes the reader chooses in localStorage under this key, so the layout opens at them next time."
+              "description": "Remember the sizes chosen in localStorage under this key, so the layout opens at them next time."
             }
           ],
           "members": [],
@@ -1984,6 +2142,14 @@
               },
               "description": "The language to read IIIF text in."
             },
+            {
+              "name": "high-contrast",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Clover's higher-contrast mode, for what is inside: the accent kept to rings, outlines and marks, never under words or a glyph, where the controls' dark fill takes its place, edged in the accent. On wherever the system asks for more contrast, too.",
+              "default": "false"
+            },
             {
               "name": "controls",
               "type": {
@@ -1993,6 +2159,14 @@
               "default": "true",
               "fieldName": "controls"
             },
+            {
+              "name": "collapse-controls",
+              "type": {
+                "text": "\"auto\" | \"always\""
+              },
+              "description": "When the view's controls (zoom, the turns, reset, full screen) collapse behind one button, at the end of the controls' one row, so the row fits any width and leaves the media more room: auto, only where the row cannot hold them all; always, wherever there are any. Pressed, the button opens a tray of them beside the rest.",
+              "default": "auto"
+            },
             {
               "name": "navigator",
               "type": {
@@ -2022,7 +2196,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Glide to a picked annotation, rather than frame it in one cut. A reader who asks for reduced motion gets the cut.",
+              "description": "Glide to a picked annotation, rather than frame it in one cut. Where reduced motion is asked for, it cuts.",
               "default": "false"
             }
           ],
@@ -2088,7 +2262,7 @@
               "kind": "field",
               "name": "controls",
               "type": {
-                "text": "boolean | { zoom?: boolean; fullPage?: boolean; rotation?: boolean; reset?: boolean; annotations?: boolean; information?: boolean; [option: string]: unknown } | null"
+                "text": "boolean | { zoom?: boolean; fullPage?: boolean; rotation?: boolean; reset?: boolean; annotations?: boolean; information?: boolean; map?: boolean; [option: string]: unknown } | null"
               },
               "description": "Which of the Body's controls it shows, as Canvas's controls takes it: false for none, or some ({ rotation: false }), in place of the attribute."
             }
@@ -2101,12 +2275,19 @@
               },
               "description": "The view is laid out and fitted: its handle is here, and works from now on."
             },
+            {
+              "name": "clover-content-state-change",
+              "type": {
+                "text": "CustomEvent<{ json: Record<string, unknown>; encoded: string }>"
+              },
+              "description": "Where it is, as a IIIF content state, as it changes: the Canvas within its Manifest, and the region in view or the media's time. Only for a Canvas loaded (iiif-content), handed as a property, or the root's."
+            },
             {
               "name": "clover-annotation-select",
               "type": {
                 "text": "CustomEvent<{ id: string | null }>"
               },
-              "description": "The reader picked an annotation, on the Body or in its menu; null when they let it go."
+              "description": "An annotation was picked, on the Body or in its menu; null when it is let go."
             },
             {
               "name": "clover-annotation-active",
@@ -2120,7 +2301,7 @@
               "type": {
                 "text": "CustomEvent<{ caption: { id: string; language?: string } | null }>"
               },
-              "description": "The reader chose a caption file in the Captions menu, or Off (null)."
+              "description": "A caption file was chosen in the Captions menu, or Off (null)."
             },
             {
               "name": "clover-ended",
@@ -2164,6 +2345,14 @@
               },
               "description": "The language to read IIIF text in."
             },
+            {
+              "name": "high-contrast",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Clover's higher-contrast mode, for what is inside: the accent kept to rings, outlines and marks, never under words or a glyph, where the controls' dark fill takes its place, edged in the accent. On wherever the system asks for more contrast, too.",
+              "default": "false"
+            },
             {
               "name": "controls",
               "type": {
@@ -2225,12 +2414,19 @@
             }
           ],
           "events": [
+            {
+              "name": "clover-content-state-change",
+              "type": {
+                "text": "CustomEvent<{ json: Record<string, unknown>; encoded: string }>"
+              },
+              "description": "Where it is, as a IIIF content state, as it changes: the Timeline within its Manifest, and the time once it pauses or seeks."
+            },
             {
               "name": "clover-caption-change",
               "type": {
                 "text": "CustomEvent<{ caption: { id: string; language?: string } | null }>"
               },
-              "description": "The reader chose a caption file in the Body's Captions menu, or Off (null)."
+              "description": "A caption file was chosen in the Body's Captions menu, or Off (null)."
             },
             {
               "name": "clover-ended",
@@ -2274,6 +2470,14 @@
               },
               "description": "The language to read IIIF text in."
             },
+            {
+              "name": "high-contrast",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Clover's higher-contrast mode, for what is inside: the accent kept to rings, outlines and marks, never under words or a glyph, where the controls' dark fill takes its place, edged in the accent. On wherever the system asks for more contrast, too.",
+              "default": "false"
+            },
             {
               "name": "controls",
               "type": {
@@ -2326,7 +2530,15 @@
               "description": "Which of the Body's controls it shows: false for none, or some ({ rotation: false }), in place of the attribute."
             }
           ],
-          "events": [],
+          "events": [
+            {
+              "name": "clover-content-state-change",
+              "type": {
+                "text": "CustomEvent<{ json: Record<string, unknown>; encoded: string }>"
+              },
+              "description": "The Scene shown, within its Manifest, as a IIIF content state, each time that changes. A content state carries no camera, so turning the models leaves it as it is."
+            }
+          ],
           "slots": []
         },
         {