@teipublisher/pb-components 2.26.1-next.3 → 3.0.0-next-4.1

package/dist/pb-elements.json

@@ -32,7 +32,7 @@
         },
         {
           "name": "view",
-          "type": "PbComponentView"
+          "type": "PbComponentView|null"
         }
       ],
       "slots": [
@@ -111,28 +111,24 @@
       "name": "pb-demo-snippet",
       "path": "./src/docs/pb-demo-snippet.js",
       "description": "Viewer for demo code.",
-      "attributes": [
+      "properties": [
         {
-          "name": "title",
-          "type": "string",
-          "default": "\"TEI Publisher Webcomponents Example\""
+          "name": "properties",
+          "type": "{ title: { type: StringConstructor; }; code: { type: StringConstructor; }; _showCodeLabel: { type: StringConstructor; }; _requirePbTify: { ...; }; }",
+          "default": "{\"title\":{\"type\":\"String\"},\"code\":{\"type\":\"String\"},\"_showCodeLabel\":{\"type\":\"String\"},\"_requirePbTify\":{\"type\":\"Boolean\"}}"
         },
         {
-          "name": "code",
-          "type": "string",
-          "default": "\"Loading ...\""
-        }
-      ],
-      "properties": [
+          "name": "styles",
+          "type": "CSSResult",
+          "default": "\"css`\\n    :host {\\n      display: block;\\n      box-shadow: 0 2px 2px rgba(0, 0, 0, 0.14), 0 1px 5px rgba(0, 0, 0, 0.12),\\n        0 3px 1px -2px rgba(0, 0, 0, 0.2);\\n      padding: 20px;\\n      background: #fff;\\n    }\\n\\n    pb-code-highlight {\\n      display: none;\\n      margin-top: 30px;\\n    }\\n\\n    pb-code-highlight.open {\\n      display: block;\\n    }\\n\\n    .buttons {\\n      display: flex;\\n      justify-content: space-between;\\n      margin-top: 20px;\\n      padding-top: 10px;\\n      border-top: 1px solid var(--google-grey-400, #999);\\n    }\\n\\n    .pretty-button {\\n      cursor: pointer;\\n      display: inline-block;\\n      box-sizing: border-box;\\n      margin: 12px 0;\\n      padding: 13px 44px;\\n      border: 2px solid #2196f3;\\n      background-color: transparent;\\n      font-size: 14px;\\n      font-weight: 500;\\n      color: #2196f3;\\n      text-align: center;\\n      text-decoration: none;\\n      text-transform: uppercase;\\n      border-radius: 0;\\n      appearance: none;\\n    }\\n\\n    .pretty-button:hover,\\n    .pretty-button:active {\\n      background-color: #2196f3;\\n      color: #fff;\\n    }\\n\\n    .pretty-button:disabled {\\n      background-color: transparent;\\n      border-color: #999;\\n      color: #999;\\n    }\\n  `\""
+        },
         {
           "name": "title",
-          "attribute": "title",
           "type": "string",
           "default": "\"TEI Publisher Webcomponents Example\""
         },
         {
           "name": "code",
-          "attribute": "code",
           "type": "string",
           "default": "\"Loading ...\""
         }
@@ -796,59 +792,68 @@
         },
         {
           "name": "pb-authority-lookup",
-          "description": "When received, starts a lookup using the passed in query string and \nauthority type"
+          "description": "When received, starts a lookup using the passed in query string and\nauthority type"
         }
       ]
     },
     {
       "name": "pb-autocomplete",
       "path": "./src/pb-autocomplete.js",
-      "description": "Provides an input with attached autocomplete. The autocomplete suggestions can be read\neither from a static list or a remote endpoint to which the current user input is sent.",
       "attributes": [
-        {
-          "name": "name",
-          "description": "Name of the form field which will be submitted",
-          "type": "string"
-        },
-        {
-          "name": "value",
-          "description": "Value of the form field which will be submitted",
-          "type": "string"
-        },
         {
           "name": "source",
-          "description": "Optional URL to query for suggestions. If relative, it is interpreted\nrelative to the endpoint defined on a surrounding `pb-page`.\n\nUpon autocomplete, the current input by the user will be sent with a query parameter\n`query`. The name/values of form controls nested within `pb-autocomplete` will also be\nappended to the request as parameters. This allows the server side code to distinguish\ndifferent states.",
-          "type": "string"
-        },
-        {
-          "name": "icon",
-          "description": "An icon to display next to the input.",
           "type": "string"
         },
         {
           "name": "placeholder",
-          "description": "Placeholder to display if field is empty",
           "type": "string",
           "default": "\"search.placeholder\""
         },
+        {
+          "name": "label",
+          "type": "string",
+          "default": "\"\""
+        },
         {
           "name": "suggestions",
-          "description": "A static list of suggestions. Use instead of `source`. May either be a flat array of strings,\nor an array containing objects of the form `{\"text\": \"\", \"value\": \"\"}, in which case \"value\" denotes\nthe value to be used when the enclosing form is submitted, and \"text\" is the label to be displayed.",
           "type": "array",
           "default": "[]"
         },
+        {
+          "name": "substring",
+          "type": "boolean",
+          "default": "false"
+        },
         {
           "name": "preload",
-          "description": "If set, the entire list of possible suggestions will be preloaded upon initialization of the\ncomponent.",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "substring",
-          "description": "By default suggestions are filtered by prefix, i.e. only suggestions starting with the prefix\ntyped by the user are shown. Set this property to true to search for the user-provided string\nanywhere within the suggestion text.",
+          "name": "icon",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "helper-text",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "always-float-label",
           "type": "boolean",
           "default": "false"
         },
+        {
+          "name": "value",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "default": "\"\""
+        },
         {
           "name": "subscribe",
           "description": "The name of the channel to subscribe to. Only events on a channel corresponding\nto this property are listened to.",
@@ -882,61 +887,79 @@
         }
       ],
       "properties": [
-        {
-          "name": "name",
-          "attribute": "name",
-          "description": "Name of the form field which will be submitted",
-          "type": "string"
-        },
-        {
-          "name": "value",
-          "attribute": "value",
-          "description": "Value of the form field which will be submitted",
-          "type": "string"
-        },
         {
           "name": "source",
           "attribute": "source",
-          "description": "Optional URL to query for suggestions. If relative, it is interpreted\nrelative to the endpoint defined on a surrounding `pb-page`.\n\nUpon autocomplete, the current input by the user will be sent with a query parameter\n`query`. The name/values of form controls nested within `pb-autocomplete` will also be\nappended to the request as parameters. This allows the server side code to distinguish\ndifferent states.",
-          "type": "string"
-        },
-        {
-          "name": "icon",
-          "attribute": "icon",
-          "description": "An icon to display next to the input.",
           "type": "string"
         },
         {
           "name": "placeholder",
           "attribute": "placeholder",
-          "description": "Placeholder to display if field is empty",
           "type": "string",
           "default": "\"search.placeholder\""
         },
+        {
+          "name": "label",
+          "attribute": "label",
+          "type": "string",
+          "default": "\"\""
+        },
         {
           "name": "suggestions",
           "attribute": "suggestions",
-          "description": "A static list of suggestions. Use instead of `source`. May either be a flat array of strings,\nor an array containing objects of the form `{\"text\": \"\", \"value\": \"\"}, in which case \"value\" denotes\nthe value to be used when the enclosing form is submitted, and \"text\" is the label to be displayed.",
           "type": "array",
           "default": "[]"
         },
         {
-          "name": "lastSelected"
+          "name": "substring",
+          "attribute": "substring",
+          "type": "boolean",
+          "default": "false"
         },
         {
           "name": "preload",
           "attribute": "preload",
-          "description": "If set, the entire list of possible suggestions will be preloaded upon initialization of the\ncomponent.",
           "type": "boolean",
           "default": "false"
         },
         {
-          "name": "substring",
-          "attribute": "substring",
-          "description": "By default suggestions are filtered by prefix, i.e. only suggestions starting with the prefix\ntyped by the user are shown. Set this property to true to search for the user-provided string\nanywhere within the suggestion text.",
+          "name": "icon",
+          "attribute": "icon",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "helperText",
+          "attribute": "helper-text",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "alwaysFloatLabel",
+          "attribute": "always-float-label",
           "type": "boolean",
           "default": "false"
         },
+        {
+          "name": "lastSelected"
+        },
+        {
+          "name": "value",
+          "attribute": "value",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "name",
+          "attribute": "name",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "requestParams",
+          "type": "object",
+          "default": "{}"
+        },
         {
           "name": "subscribe",
           "attribute": "subscribe",
@@ -974,40 +997,12 @@
           "type": "boolean",
           "default": "false"
         }
-      ],
-      "slots": [
-        {
-          "name": "",
-          "description": "default unnamed slot"
-        }
-      ],
-      "cssProperties": [
-        {
-          "name": "--pb-search-label-color",
-          "description": "Color of the label and underline"
-        },
-        {
-          "name": "--pb-search-input-color",
-          "description": "Text color for input field"
-        },
-        {
-          "name": "--pb-search-focus-color",
-          "description": "Color for label and underline if input has focus"
-        },
-        {
-          "name": "--pb-search-suggestions-color",
-          "description": "Color for the labels shown in the suggestions dropdown"
-        },
-        {
-          "name": "--pb-search-suggestions-background",
-          "description": "Background for the suggestions dropdown"
-        }
       ]
     },
     {
       "name": "pb-blacklab-highlight",
       "path": "./src/pb-blacklab-highlight.js",
-      "description": "This component queries the blacklab API of TEI-Publisher for a list of text matches\nin a given document. The query is given as a CQL querystring (see pattern property).\n\n**Note**: There's no demo for this component yet as it would need a blacklab instance. \n\nThe component displays 2 navigation buttons to jump to previous / next match and\na display of the current index and total number of matches.\n\nWhen navigating and the requested match is not on the current page a pb-refresh is dispatched\nto load the correct page. Once the page has dispatch pb-update this component will refresh and trigger\nloading of matches from the API.\n\nHighlighting is accomplished by marking the matched text with the following CSS classes:\n- kwic-start - for the start of the match\n- kwic-end - for the end of the match (might be on the same node as 'kwic-start'\n- kwic-current - to set a different highlight color for the current match\n\nWhen navigating the browser URL will be updated to allow bookmarks for a certain match.\n\nNote: this component does no caching of query results yet. In case of heavier use the data can be taken\nfrom localStorage ('pb-kwic-results') as usually pb-kwic-results has been visited by the user before. For\nstability reasons this was not done in this version.\n\n\nWhen data are present highlights are processed.",
+      "description": "This component queries the blacklab API of TEI-Publisher for a list of text matches\nin a given document. The query is given as a CQL querystring (see pattern property).\n\n**Note**: There's no demo for this component yet as it would need a blacklab instance.\n\nThe component displays 2 navigation buttons to jump to previous / next match and\na display of the current index and total number of matches.\n\nWhen navigating and the requested match is not on the current page a pb-refresh is dispatched\nto load the correct page. Once the page has dispatch pb-update this component will refresh and trigger\nloading of matches from the API.\n\nHighlighting is accomplished by marking the matched text with the following CSS classes:\n- kwic-start - for the start of the match\n- kwic-end - for the end of the match (might be on the same node as 'kwic-start'\n- kwic-current - to set a different highlight color for the current match\n\nWhen navigating the browser URL will be updated to allow bookmarks for a certain match.\n\nNote: this component does no caching of query results yet. In case of heavier use the data can be taken\nfrom localStorage ('pb-kwic-results') as usually pb-kwic-results has been visited by the user before. For\nstability reasons this was not done in this version.\n\n\nWhen data are present highlights are processed.",
       "attributes": [
         {
           "name": "current",
@@ -1475,7 +1470,7 @@
         },
         {
           "name": "use-language",
-          "description": "If set, a parameter \"language\" will be added to the parameter list. \nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
+          "description": "If set, a parameter \"language\" will be added to the parameter list.\nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
           "type": "boolean"
         },
         {
@@ -1678,7 +1673,7 @@
         {
           "name": "useLanguage",
           "attribute": "use-language",
-          "description": "If set, a parameter \"language\" will be added to the parameter list. \nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
+          "description": "If set, a parameter \"language\" will be added to the parameter list.\nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
           "type": "boolean"
         },
         {
@@ -1873,7 +1868,7 @@
     {
       "name": "pb-browse",
       "path": "./src/pb-browse.js",
-      "description": "Extends PbLoad to support browsing collections.\n\nThis is a reduced version of `pb-browse-docs`, which differs\nfrom a plain `pb-load` only in that it scans the returned\ncollection listing for links to subcollections and keeps\ntrack of the current collection. \n\nAll UI elements present in `pb-browse-docs` have been removed.",
+      "description": "Extends PbLoad to support browsing collections.\n\nThis is a reduced version of `pb-browse-docs`, which differs\nfrom a plain `pb-load` only in that it scans the returned\ncollection listing for links to subcollections and keeps\ntrack of the current collection.\n\nAll UI elements present in `pb-browse-docs` have been removed.",
       "attributes": [
         {
           "name": "collection",
@@ -1918,7 +1913,7 @@
         },
         {
           "name": "use-language",
-          "description": "If set, a parameter \"language\" will be added to the parameter list. \nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
+          "description": "If set, a parameter \"language\" will be added to the parameter list.\nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
           "type": "boolean"
         },
         {
@@ -2052,7 +2047,7 @@
         {
           "name": "useLanguage",
           "attribute": "use-language",
-          "description": "If set, a parameter \"language\" will be added to the parameter list. \nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
+          "description": "If set, a parameter \"language\" will be added to the parameter list.\nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
           "type": "boolean"
         },
         {
@@ -2183,7 +2178,7 @@
     {
       "name": "pb-clipboard",
       "path": "./src/pb-clipboard.js",
-      "description": "A component with a button which copies the contained content to the clipboard.\r\nUse for the typical 'quote this content as' hints on a webpage.",
+      "description": "A component with a button which copies the contained content to the clipboard.\nUse for the typical 'quote this content as' hints on a webpage.",
       "attributes": [
         {
           "name": "label",
@@ -2432,16 +2427,16 @@
         }
       ],
       "deprecated": true,
-      "deprecatedMessage": "directly use `jinn-codemirror`/`jinn-xml-editor`/`jinn-epidoc-editor` instead, which are \nincluded in the `pb-code-editor` bundle."
+      "deprecatedMessage": "directly use `jinn-codemirror`/`jinn-xml-editor`/`jinn-epidoc-editor` instead, which are\nincluded in the `pb-code-editor` bundle."
     },
     {
       "name": "pb-code-highlight",
       "path": "./src/pb-code-highlight.js",
-      "description": "Highlight a code snippet. The snippet may either be passed in a template child\r\nelement, which could contain HTML or text. If no template child is present, the\r\ncomponent will take any text content contained in it and highlight it. One can also\r\npass the code to be highlighted in the `code` property.",
+      "description": "Highlight a code snippet. The snippet may either be passed in a template child\nelement, which could contain HTML or text. If no template child is present, the\ncomponent will take any text content contained in it and highlight it. One can also\npass the code to be highlighted in the `code` property.",
       "attributes": [
         {
           "name": "code",
-          "description": "The code to be highlighted as a string. If not set,\r\nthis will be populated from either a template child element\r\nor the element's text content.\r\nThe value of the property can be changed programmatically from JavaScript.",
+          "description": "The code to be highlighted as a string. If not set,\nthis will be populated from either a template child element\nor the element's text content.\nThe value of the property can be changed programmatically from JavaScript.",
           "type": "string"
         },
         {
@@ -2452,7 +2447,7 @@
         },
         {
           "name": "theme",
-          "description": "Highlighting theme to use: 'coy', 'dark', 'funky', 'okaida', 'solarizedlight',\r\n'tomorrow', 'twilight' or 'default'.",
+          "description": "Highlighting theme to use: 'coy', 'dark', 'funky', 'okaida', 'solarizedlight',\n'tomorrow', 'twilight' or 'default'.",
           "type": "string",
           "default": "\"default\""
         },
@@ -2466,7 +2461,7 @@
         {
           "name": "code",
           "attribute": "code",
-          "description": "The code to be highlighted as a string. If not set,\r\nthis will be populated from either a template child element\r\nor the element's text content.\r\nThe value of the property can be changed programmatically from JavaScript.",
+          "description": "The code to be highlighted as a string. If not set,\nthis will be populated from either a template child element\nor the element's text content.\nThe value of the property can be changed programmatically from JavaScript.",
           "type": "string"
         },
         {
@@ -2479,7 +2474,7 @@
         {
           "name": "theme",
           "attribute": "theme",
-          "description": "Highlighting theme to use: 'coy', 'dark', 'funky', 'okaida', 'solarizedlight',\r\n'tomorrow', 'twilight' or 'default'.",
+          "description": "Highlighting theme to use: 'coy', 'dark', 'funky', 'okaida', 'solarizedlight',\n'tomorrow', 'twilight' or 'default'.",
           "type": "string",
           "default": "\"default\""
         },
@@ -2588,14 +2583,13 @@
       "description": "A collapsible block: in collapsed state it only shows a header and expands if clicked.\nThe header should go into slot `collapse-trigger`, the content into `collapse-content`.\nExample:\n\n```html\n<pb-collapse>\n  <div slot=\"collapse-trigger\">\n      Metadata\n  </div>\n  <pb-view slot=\"collapse-content\" src=\"document1\" subscribe=\"transcription\" xpath=\"//teiHeader\"></pb-view>\n</pb-collapse>\n```\n\nBy adding a CSS 'icon-right' to a `pb-collapse` the icon can be placed on the right side\n```\n<pb-collapse class='icon-right'>\n```",
       "attributes": [
         {
-          "name": "horizontal",
-          "type": "boolean",
-          "default": "false",
-          "deprecatedMessage": "Corresponds to the iron-collapse's horizontal property."
+          "name": "icon-sprite",
+          "description": "Optional custom sprite source passed to pb-icon.",
+          "type": "string"
         },
         {
           "name": "no-animation",
-          "description": "Corresponds to the iron-collapse's noAnimation property.",
+          "description": "Whether to disable animations.",
           "type": "boolean",
           "default": "false"
         },
@@ -2607,19 +2601,19 @@
         },
         {
           "name": "expand-icon",
-          "description": "The iron-icon when collapsed. Value must be one of the icons defined by iron-icons",
+          "description": "Icon to show when the collapse is closed.",
           "type": "string",
           "default": "\"icons:expand-more\""
         },
         {
           "name": "collapse-icon",
-          "description": "The icon when expanded.",
+          "description": "Icon to show when the collapse is open.",
           "type": "string",
           "default": "\"icons:expand-less\""
         },
         {
           "name": "no-icons",
-          "description": "Whether to hide the expand/collapse icon.",
+          "description": "Disable icons entirely.",
           "type": "boolean",
           "default": "false"
         },
@@ -2662,17 +2656,21 @@
         }
       ],
       "properties": [
+        {
+          "name": "iconSprite",
+          "attribute": "icon-sprite",
+          "description": "Optional custom sprite source passed to pb-icon.",
+          "type": "string"
+        },
         {
           "name": "horizontal",
-          "attribute": "horizontal",
           "type": "boolean",
-          "default": "false",
-          "deprecatedMessage": "Corresponds to the iron-collapse's horizontal property."
+          "default": "false"
         },
         {
           "name": "noAnimation",
           "attribute": "no-animation",
-          "description": "Corresponds to the iron-collapse's noAnimation property.",
+          "description": "Whether to disable animations.",
           "type": "boolean",
           "default": "false"
         },
@@ -2686,21 +2684,21 @@
         {
           "name": "expandIcon",
           "attribute": "expand-icon",
-          "description": "The iron-icon when collapsed. Value must be one of the icons defined by iron-icons",
+          "description": "Icon to show when the collapse is closed.",
           "type": "string",
           "default": "\"icons:expand-more\""
         },
         {
           "name": "collapseIcon",
           "attribute": "collapse-icon",
-          "description": "The icon when expanded.",
+          "description": "Icon to show when the collapse is open.",
           "type": "string",
           "default": "\"icons:expand-less\""
         },
         {
           "name": "noIcons",
           "attribute": "no-icons",
-          "description": "Whether to hide the expand/collapse icon.",
+          "description": "Disable icons entirely.",
           "type": "boolean",
           "default": "false"
         },
@@ -2768,15 +2766,24 @@
       "cssProperties": [
         {
           "name": "--pb-collapse-icon-padding",
-          "description": "padding in px for the \"caret-down\" icon left to the collapsible item",
-          "default": "\"0 4px 0 0\""
+          "description": "padding left or right of the \"caret\" icon left to the collapsible item",
+          "default": "\".5rem\""
+        },
+        {
+          "name": "--pb-collapse-icon-size",
+          "description": "size of the \"caret\" icon left to the collapsible item",
+          "default": "\".75rem\""
+        },
+        {
+          "name": "--pb-collapse-icon-image",
+          "description": "image of the \"caret\" icon left to the collapsible item"
         }
       ]
     },
     {
       "name": "pb-combo-box",
       "path": "./src/pb-combo-box.js",
-      "description": "Provides a combo box, i.e. a combination of an input with a dropdown.\nItems to select from may be obtained from a remote data source.\n\nThe form control to be used (either a select or input) should be passed \nin the content of the element. If no control is provided, a simple `<input>`\nwill be created.",
+      "description": "Provides a combo box, i.e. a combination of an input with a dropdown.\nItems to select from may be obtained from a remote data source.\n\nThe form control to be used (either a select or input) should be passed\nin the content of the element. If no control is provided, a simple `<input>`\nwill be created.",
       "attributes": [
         {
           "name": "source",
@@ -2987,7 +2994,7 @@
         },
         {
           "name": "use-language",
-          "description": "If set, a parameter \"language\" will be added to the parameter list. \nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
+          "description": "If set, a parameter \"language\" will be added to the parameter list.\nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
           "type": "boolean"
         },
         {
@@ -3114,7 +3121,7 @@
         {
           "name": "useLanguage",
           "attribute": "use-language",
-          "description": "If set, a parameter \"language\" will be added to the parameter list. \nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
+          "description": "If set, a parameter \"language\" will be added to the parameter list.\nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
           "type": "boolean"
         },
         {
@@ -3257,7 +3264,7 @@
     {
       "name": "pb-dialog",
       "path": "./src/pb-dialog.js",
-      "description": "A simple dialog component using the HTML5 <dialog> element (no shadow DOM).",
+      "description": "A simple dialog component using the HTML5 <dialog> element.\n\nAny button with the attribute `rel=\"prev\"` will close the dialog when clicked.",
       "attributes": [
         {
           "name": "open",
@@ -3547,7 +3554,7 @@
       "attributes": [
         {
           "name": "src",
-          "description": "optional id reference to a pb-document. If `url` is not specified, \na correct download URL is constructed using the given document path and parameters.\nOtherwise `url` will be used as main URL.",
+          "description": "optional id reference to a pb-document. If `url` is not specified,\na correct download URL is constructed using the given document path and parameters.\nOtherwise `url` will be used as main URL.",
           "type": "string"
         },
         {
@@ -3562,7 +3569,7 @@
         },
         {
           "name": "dialog",
-          "description": "id of dialog component to show when downloading. A paper-dialog component with this id must\nexist.",
+          "description": "id of dialog component to show when downloading. A `pb-dialog` component with this id must\nexist.",
           "type": "string"
         },
         {
@@ -3623,7 +3630,7 @@
         {
           "name": "src",
           "attribute": "src",
-          "description": "optional id reference to a pb-document. If `url` is not specified, \na correct download URL is constructed using the given document path and parameters.\nOtherwise `url` will be used as main URL.",
+          "description": "optional id reference to a pb-document. If `url` is not specified,\na correct download URL is constructed using the given document path and parameters.\nOtherwise `url` will be used as main URL.",
           "type": "string"
         },
         {
@@ -3641,7 +3648,7 @@
         {
           "name": "dialog",
           "attribute": "dialog",
-          "description": "id of dialog component to show when downloading. A paper-dialog component with this id must\nexist.",
+          "description": "id of dialog component to show when downloading. A `pb-dialog` component with this id must\nexist.",
           "type": "string"
         },
         {
@@ -4014,6 +4021,9 @@
         {
           "name": "pb-end-update",
           "description": "Fired after the element has finished updating its content"
+        },
+        {
+          "name": "submit"
         }
       ]
     },
@@ -4156,9 +4166,9 @@
         },
         {
           "name": "trigger",
-          "description": "Type of event which should trigger the facsimile to display. \nEither 'click' or 'mouseover' (default).",
+          "description": "Type of event which should trigger the facsimile to display.\nEither 'click' or 'mouseover' (default).",
           "type": "string",
-          "default": "\"mouseover\""
+          "default": "\"click\""
         },
         {
           "name": "label",
@@ -4225,9 +4235,9 @@
         {
           "name": "trigger",
           "attribute": "trigger",
-          "description": "Type of event which should trigger the facsimile to display. \nEither 'click' or 'mouseover' (default).",
+          "description": "Type of event which should trigger the facsimile to display.\nEither 'click' or 'mouseover' (default).",
           "type": "string",
-          "default": "\"mouseover\""
+          "default": "\"click\""
         },
         {
           "name": "label",
@@ -4648,6 +4658,84 @@
         }
       ]
     },
+    {
+      "name": "pb-fetch",
+      "path": "./src/pb-fetch.js",
+      "description": "Lightweight replacement for `<iron-ajax>` using the Fetch API.\nProvides a mostly compatible surface for existing components.",
+      "attributes": [
+        {
+          "name": "method",
+          "type": "string"
+        },
+        {
+          "name": "handle-as"
+        },
+        {
+          "name": "with-credentials"
+        },
+        {
+          "name": "content-type"
+        }
+      ],
+      "properties": [
+        {
+          "name": "url",
+          "type": "string"
+        },
+        {
+          "name": "handleAs",
+          "type": "string"
+        },
+        {
+          "name": "withCredentials",
+          "type": "boolean"
+        },
+        {
+          "name": "contentType"
+        },
+        {
+          "name": "method",
+          "attribute": "method",
+          "type": "string"
+        },
+        {
+          "name": "params",
+          "type": "object",
+          "default": "{}"
+        },
+        {
+          "name": "headers",
+          "type": "object",
+          "default": "{}"
+        },
+        {
+          "name": "body",
+          "default": "\"undefined\""
+        },
+        {
+          "name": "loading",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "lastResponse"
+        },
+        {
+          "name": "lastRequest"
+        },
+        {
+          "name": "lastError"
+        }
+      ],
+      "events": [
+        {
+          "name": "error"
+        },
+        {
+          "name": "response"
+        }
+      ]
+    },
     {
       "name": "pb-formula",
       "path": "./src/pb-formula.js",
@@ -4712,7 +4800,7 @@
     {
       "name": "pb-geolocation",
       "path": "./src/pb-geolocation.js",
-      "description": "Represents a geo location. Extends `pb-highlight`, but sends an additional `pb-geolocation` event\non mouseover.\n\nFor `pb-leaflet-map` to show markers for `pb-geolocation` elements, make sure that map subscribes to the channel\ninto which `pb-geolocation`s emit and that map is loaded before the emitting component, e.g. `pb-view`, by specifying \n`wait-for` property.",
+      "description": "Represents a geo location. Extends `pb-highlight`, but sends an additional `pb-geolocation` event\non mouseover.\n\nFor `pb-leaflet-map` to show markers for `pb-geolocation` elements, make sure that map subscribes to the channel\ninto which `pb-geolocation`s emit and that map is loaded before the emitting component, e.g. `pb-view`, by specifying\n`wait-for` property.",
       "attributes": [
         {
           "name": "longitude",
@@ -5322,66 +5410,287 @@
           "type": "string"
         },
         {
-          "name": "disabled",
-          "attribute": "disabled",
-          "description": "Common property to disable the functionality associated with a component.\n`pb-highlight` and `pb-popover` react to this.",
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": "Common property to disable the functionality associated with a component.\n`pb-highlight` and `pb-popover` react to this.",
+          "type": "boolean",
+          "default": "false"
+        }
+      ],
+      "events": [
+        {
+          "name": "pb-highlight-off",
+          "description": "Fires removal of all highlights that might have existed before"
+        },
+        {
+          "name": "pb-highlight-on",
+          "description": "Fires highlight event with a key passed to which other pb-highlight elements with the same key will react"
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "default unnamed slot for highlight content"
+        }
+      ],
+      "cssProperties": [
+        {
+          "name": "--pb-highlight-color",
+          "description": "Background color to highlight an element"
+        }
+      ]
+    },
+    {
+      "name": "pb-i18n",
+      "path": "./src/pb-i18n.js",
+      "description": "Insert translated text somewhere on an HTML page. If no translation is found,\ndisplay the contained content.",
+      "attributes": [
+        {
+          "name": "key",
+          "description": "The i18n key to use for looking up the translation.",
+          "type": "string",
+          "default": "\"missing-key\""
+        },
+        {
+          "name": "options",
+          "description": "Optional interpolation parameters to be passed to the\ntranslation function",
+          "type": "object"
+        }
+      ],
+      "properties": [
+        {
+          "name": "key",
+          "attribute": "key",
+          "description": "The i18n key to use for looking up the translation.",
+          "type": "string",
+          "default": "\"missing-key\""
+        },
+        {
+          "name": "options",
+          "attribute": "options",
+          "description": "Optional interpolation parameters to be passed to the\ntranslation function",
+          "type": "object"
+        }
+      ]
+    },
+    {
+      "name": "pb-icon-button",
+      "path": "./src/pb-icon-button.js",
+      "properties": [
+        {
+          "name": "properties",
+          "type": "{ icon: { type: StringConstructor; }; disabled: { type: BooleanConstructor; reflect: boolean; }; label: { type: StringConstructor; }; toggles: { ...; }; active: { ...; }; }",
+          "default": "{\"icon\":{\"type\":\"String\"},\"disabled\":{\"type\":\"Boolean\",\"reflect\":true},\"label\":{\"type\":\"String\"},\"toggles\":{\"type\":\"Boolean\"},\"active\":{\"type\":\"Boolean\",\"reflect\":true}}"
+        },
+        {
+          "name": "styles",
+          "type": "CSSResult",
+          "default": "\"css`\\n    :host {\\n      display: inline-flex;\\n      box-sizing: border-box;\\n      --pb-icon-button-size: 40px;\\n    }\\n\\n    button {\\n      width: var(--pb-icon-button-size);\\n      height: var(--pb-icon-button-size);\\n      border-radius: 999px;\\n      border: none;\\n      background: transparent;\\n      color: inherit;\\n      padding: 0;\\n      cursor: pointer;\\n      display: inline-flex;\\n      align-items: center;\\n      justify-content: center;\\n      transition: background 0.2s ease-in-out;\\n    }\\n\\n    button:hover:not(:disabled),\\n    button:focus-visible {\\n      background: var(--pb-icon-button-hover-background, rgba(0, 0, 0, 0.05));\\n      outline: none;\\n    }\\n\\n    button:disabled {\\n      opacity: 0.4;\\n      cursor: not-allowed;\\n    }\\n\\n    :host([active]) button {\\n      background: var(--pb-icon-button-active-background, rgba(0, 0, 0, 0.08));\\n    }\\n  `\""
+        },
+        {
+          "name": "icon",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "toggles",
+          "type": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "active",
+          "type": "boolean",
+          "default": "false"
+        }
+      ],
+      "events": [
+        {
+          "name": "active-changed"
+        }
+      ]
+    },
+    {
+      "name": "pb-icon",
+      "path": "./src/pb-icon.js",
+      "description": "A versatile icon component that replaces iron-icon and iron-icons.\nSupports both SVG sprite references and inline SVG content.",
+      "attributes": [
+        {
+          "name": "sprite",
+          "description": "Path or URL to the SVG sprite file. Optional.\nIf not specified, defaults to 'dist/images/icons.svg'.\nIf set to a string starting with '#', uses inline sprite.",
+          "type": "string"
+        },
+        {
+          "name": "icon",
+          "description": "Icon name to display from the icon sprite.\nIf not provided, expects SVG content in the default slot.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "size",
+          "description": "Icon size. Can be a preset (xs, sm, md, lg, xl) or a custom size.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "label",
+          "description": "ARIA label for accessibility. Auto-generated from icon name if not provided.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "decorative",
+          "description": "Whether the icon is decorative (hidden from screen readers).",
+          "type": "boolean",
+          "default": "false"
+        }
+      ],
+      "properties": [
+        {
+          "name": "sprite",
+          "attribute": "sprite",
+          "description": "Path or URL to the SVG sprite file. Optional.\nIf not specified, defaults to 'dist/images/icons.svg'.\nIf set to a string starting with '#', uses inline sprite.",
+          "type": "string"
+        },
+        {
+          "name": "icon",
+          "attribute": "icon",
+          "description": "Icon name to display from the icon sprite.\nIf not provided, expects SVG content in the default slot.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "size",
+          "attribute": "size",
+          "description": "Icon size. Can be a preset (xs, sm, md, lg, xl) or a custom size.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "label",
+          "attribute": "label",
+          "description": "ARIA label for accessibility. Auto-generated from icon name if not provided.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "decorative",
+          "attribute": "decorative",
+          "description": "Whether the icon is decorative (hidden from screen readers).",
           "type": "boolean",
           "default": "false"
         }
       ],
-      "events": [
-        {
-          "name": "pb-highlight-off",
-          "description": "Fires removal of all highlights that might have existed before"
-        },
-        {
-          "name": "pb-highlight-on",
-          "description": "Fires highlight event with a key passed to which other pb-highlight elements with the same key will react"
-        }
-      ],
       "slots": [
         {
           "name": "",
-          "description": "default unnamed slot for highlight content"
+          "description": "Inline SVG content when not using icon name"
         }
       ],
       "cssProperties": [
         {
-          "name": "--pb-highlight-color",
-          "description": "Background color to highlight an element"
+          "name": "--pb-icon-color",
+          "description": "Icon color (defaults to currentColor)"
+        },
+        {
+          "name": "--pb-icon-size",
+          "description": "Icon size (defaults to 1em)"
         }
       ]
     },
     {
-      "name": "pb-i18n",
-      "path": "./src/pb-i18n.js",
-      "description": "Insert translated text somewhere on an HTML page. If no translation is found,\ndisplay the contained content.",
+      "name": "iron-icon",
+      "path": "./src/pb-icon.js",
       "attributes": [
         {
-          "name": "options",
-          "description": "Optional interpolation parameters to be passed to the\ntranslation function",
-          "type": "object"
+          "name": "sprite",
+          "description": "Path or URL to the SVG sprite file. Optional.\nIf not specified, defaults to 'dist/images/icons.svg'.\nIf set to a string starting with '#', uses inline sprite.",
+          "type": "string"
         },
         {
-          "name": "key",
-          "description": "The i18n key to use for looking up the translation.",
+          "name": "icon",
+          "description": "Icon name to display from the icon sprite.\nIf not provided, expects SVG content in the default slot.",
           "type": "string",
-          "default": "\"missing-key\""
+          "default": "\"\""
+        },
+        {
+          "name": "size",
+          "description": "Icon size. Can be a preset (xs, sm, md, lg, xl) or a custom size.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "label",
+          "description": "ARIA label for accessibility. Auto-generated from icon name if not provided.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "decorative",
+          "description": "Whether the icon is decorative (hidden from screen readers).",
+          "type": "boolean",
+          "default": "false"
         }
       ],
       "properties": [
         {
-          "name": "options",
-          "attribute": "options",
-          "description": "Optional interpolation parameters to be passed to the\ntranslation function",
-          "type": "object"
+          "name": "sprite",
+          "attribute": "sprite",
+          "description": "Path or URL to the SVG sprite file. Optional.\nIf not specified, defaults to 'dist/images/icons.svg'.\nIf set to a string starting with '#', uses inline sprite.",
+          "type": "string"
         },
         {
-          "name": "key",
-          "attribute": "key",
-          "description": "The i18n key to use for looking up the translation.",
+          "name": "icon",
+          "attribute": "icon",
+          "description": "Icon name to display from the icon sprite.\nIf not provided, expects SVG content in the default slot.",
           "type": "string",
-          "default": "\"missing-key\""
+          "default": "\"\""
+        },
+        {
+          "name": "size",
+          "attribute": "size",
+          "description": "Icon size. Can be a preset (xs, sm, md, lg, xl) or a custom size.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "label",
+          "attribute": "label",
+          "description": "ARIA label for accessibility. Auto-generated from icon name if not provided.",
+          "type": "string",
+          "default": "\"\""
+        },
+        {
+          "name": "decorative",
+          "attribute": "decorative",
+          "description": "Whether the icon is decorative (hidden from screen readers).",
+          "type": "boolean",
+          "default": "false"
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Inline SVG content when not using icon name"
+        }
+      ],
+      "cssProperties": [
+        {
+          "name": "--pb-icon-color",
+          "description": "Icon color (defaults to currentColor)"
+        },
+        {
+          "name": "--pb-icon-size",
+          "description": "Icon size (defaults to 1em)"
         }
       ]
     },
@@ -5524,6 +5833,12 @@
           "type": "string",
           "default": "\"language\""
         },
+        {
+          "name": "display",
+          "description": "How should the selected value be displayed?\n\n- `text` - Display the text content of the selected option\n- other - Attribute name to use",
+          "type": "string",
+          "default": "\"value\""
+        },
         {
           "name": "subscribe",
           "description": "The name of the channel to subscribe to. Only events on a channel corresponding\nto this property are listened to.",
@@ -5569,6 +5884,13 @@
           "type": "string",
           "default": "\"language\""
         },
+        {
+          "name": "display",
+          "attribute": "display",
+          "description": "How should the selected value be displayed?\n\n- `text` - Display the text content of the selected option\n- other - Attribute name to use",
+          "type": "string",
+          "default": "\"value\""
+        },
         {
           "name": "subscribe",
           "attribute": "subscribe",
@@ -5618,9 +5940,19 @@
         }
       ],
       "slots": [
+        {
+          "name": "select",
+          "description": "Optional select element to use for language selection. If not provided, a default one will be created."
+        },
         {
           "name": "",
-          "description": "unnamed default slot for dropdown menu options given as <option> elements"
+          "description": "unnamed default slot for dropdown menu options"
+        }
+      ],
+      "cssProperties": [
+        {
+          "name": "--pb-lang-input-color",
+          "description": "Color of the text in the language field"
         }
       ]
     },
@@ -5695,7 +6027,7 @@
         },
         {
           "name": "geo-coding",
-          "description": "Enables geocoding: an additional control will allow users to search for a place.\nReverse geocoding is also possible: clicking on the map while pressing ctrl or cmd \nwill request information about the current location.\n\nIn both cases, a `pb-geocode` event will be emitted containing additional information\nabout the place in the event details (see demo).\n\nFor lookups the free OSM/Nominatim service is used.",
+          "description": "Enables geocoding: an additional control will allow users to search for a place.\nReverse geocoding is also possible: clicking on the map while pressing ctrl or cmd\nwill request information about the current location.\n\nIn both cases, a `pb-geocode` event will be emitted containing additional information\nabout the place in the event details (see demo).\n\nFor lookups the free OSM/Nominatim service is used.",
           "type": "boolean",
           "default": "false"
         },
@@ -5815,7 +6147,7 @@
         {
           "name": "geoCoding",
           "attribute": "geo-coding",
-          "description": "Enables geocoding: an additional control will allow users to search for a place.\nReverse geocoding is also possible: clicking on the map while pressing ctrl or cmd \nwill request information about the current location.\n\nIn both cases, a `pb-geocode` event will be emitted containing additional information\nabout the place in the event details (see demo).\n\nFor lookups the free OSM/Nominatim service is used.",
+          "description": "Enables geocoding: an additional control will allow users to search for a place.\nReverse geocoding is also possible: clicking on the map while pressing ctrl or cmd\nwill request information about the current location.\n\nIn both cases, a `pb-geocode` event will be emitted containing additional information\nabout the place in the event details (see demo).\n\nFor lookups the free OSM/Nominatim service is used.",
           "type": "boolean",
           "default": "false"
         },
@@ -5889,7 +6221,7 @@
     {
       "name": "pb-link",
       "path": "./src/pb-link.js",
-      "description": "Create an internal link: clicking it will emit a `pb-refresh`event, \ncausing connected views to update and load the corresponding document fragment defined by the\nproperties.",
+      "description": "Create an internal link: clicking it will emit a `pb-refresh`event,\ncausing connected views to update and load the corresponding document fragment defined by the\nproperties.",
       "attributes": [
         {
           "name": "xml-id",
@@ -6106,7 +6438,7 @@
         },
         {
           "name": "use-language",
-          "description": "If set, a parameter \"language\" will be added to the parameter list. \nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
+          "description": "If set, a parameter \"language\" will be added to the parameter list.\nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
           "type": "boolean"
         },
         {
@@ -6227,7 +6559,7 @@
         {
           "name": "useLanguage",
           "attribute": "use-language",
-          "description": "If set, a parameter \"language\" will be added to the parameter list. \nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
+          "description": "If set, a parameter \"language\" will be added to the parameter list.\nAlso, a refresh will be triggered if a `pb-i18n-update` event is received,\ne.g. due to the user selecting a different interface language.\n\nAlso requires `requireLanguage` to be set on the surrounding `pb-page`.\nSee there for more information.",
           "type": "boolean"
         },
         {
@@ -6698,7 +7030,7 @@
     {
       "name": "pb-map-icon",
       "path": "./src/pb-map-icon.js",
-      "description": "Configure a map icon type to be used for markers. \nShould be nested inside `pb-leaflet-map`.",
+      "description": "Configure a map icon type to be used for markers.\nShould be nested inside `pb-leaflet-map`.",
       "attributes": [
         {
           "name": "icon-size",
@@ -7091,7 +7423,7 @@
     {
       "name": "pb-mei",
       "path": "./src/pb-mei.js",
-      "description": "A viewer and player for MEI musical notation based on [Verovio](https://www.verovio.org/).\nSupports optional MIDI playback using [web-midi-player](https://midi.yvesgurcan.com/).\nBoth libraries are loaded dynamically when the component is used the first time.\n\nViewing options to be selected by the user can be defined via nested `pb-option` elements:\n\n```html\n<pb-mei id=\"viewer\" player url=\"http://www.marenzio.org/mei/M-06-5/M_06_5_01_S_io_parto_i_moro_e_pur_partir_conviene.mei\" \n        footer=\"none\">\n   <pb-option name=\"appXPath\" on=\"./rdg[contains(@label, 'original')]\" off=\"\">Original Clefs</pb-option>\n</pb-mei>\n```\n\nThe MEI document to display can either be given directly in the `data` property or loaded from an URL\nspecified in `url`.",
+      "description": "A viewer and player for MEI musical notation based on [Verovio](https://www.verovio.org/).\nSupports optional MIDI playback using [web-midi-player](https://midi.yvesgurcan.com/).\nBoth libraries are loaded dynamically when the component is used the first time.\n\nViewing options to be selected by the user can be defined via nested `pb-option` elements:\n\n```html\n<pb-mei id=\"viewer\" player url=\"http://www.marenzio.org/mei/M-06-5/M_06_5_01_S_io_parto_i_moro_e_pur_partir_conviene.mei\"\n        footer=\"none\">\n   <pb-option name=\"appXPath\" on=\"./rdg[contains(@label, 'original')]\" off=\"\">Original Clefs</pb-option>\n</pb-mei>\n```\n\nThe MEI document to display can either be given directly in the `data` property or loaded from an URL\nspecified in `url`.",
       "attributes": [
         {
           "name": "data",
@@ -7100,7 +7432,7 @@
         },
         {
           "name": "url",
-          "description": "URL of the MEI file to load. Will be used if no `data` property is present. \nA relative URL would be resolved relative to the TEI Publisher endpoint.",
+          "description": "URL of the MEI file to load. Will be used if no `data` property is present.\nA relative URL would be resolved relative to the TEI Publisher endpoint.",
           "type": "string"
         },
         {
@@ -7188,7 +7520,7 @@
         {
           "name": "url",
           "attribute": "url",
-          "description": "URL of the MEI file to load. Will be used if no `data` property is present. \nA relative URL would be resolved relative to the TEI Publisher endpoint.",
+          "description": "URL of the MEI file to load. Will be used if no `data` property is present.\nA relative URL would be resolved relative to the TEI Publisher endpoint.",
           "type": "string"
         },
         {
@@ -7280,6 +7612,11 @@
           "default": "false"
         }
       ],
+      "events": [
+        {
+          "name": "pb-mei-error"
+        }
+      ],
       "cssProperties": [
         {
           "name": "--pb-mei-min-width",
@@ -7319,6 +7656,11 @@
           "description": "type of message. Can be either 'message' or 'confirm'. In case of confirm the buttons 'yes' and 'no'\nwill be shown and the dialog becomes modal.",
           "type": "string",
           "default": "\"message\""
+        },
+        {
+          "name": "open",
+          "type": "boolean",
+          "default": "false"
         }
       ],
       "properties": [
@@ -7342,6 +7684,12 @@
           "description": "type of message. Can be either 'message' or 'confirm'. In case of confirm the buttons 'yes' and 'no'\nwill be shown and the dialog becomes modal.",
           "type": "string",
           "default": "\"message\""
+        },
+        {
+          "name": "open",
+          "attribute": "open",
+          "type": "boolean",
+          "default": "false"
         }
       ]
     },
@@ -7583,6 +7931,10 @@
       "path": "./src/pb-odd-editor.js",
       "description": "ODD editor component",
       "attributes": [
+        {
+          "name": "tabs",
+          "type": "array"
+        },
         {
           "name": "ident",
           "type": "string",
@@ -7676,11 +8028,6 @@
           "type": "boolean",
           "default": "true"
         },
-        {
-          "name": "tabs",
-          "type": "array",
-          "default": "[]"
-        },
         {
           "name": "tabIndex",
           "type": "number",
@@ -7724,6 +8071,15 @@
         }
       ],
       "properties": [
+        {
+          "name": "tabs",
+          "attribute": "tabs",
+          "type": "array"
+        },
+        {
+          "name": "safeTabs",
+          "type": "array"
+        },
         {
           "name": "ident",
           "attribute": "ident",
@@ -7835,12 +8191,6 @@
           "type": "boolean",
           "default": "true"
         },
-        {
-          "name": "tabs",
-          "attribute": "tabs",
-          "type": "array",
-          "default": "[]"
-        },
         {
           "name": "tabIndex",
           "attribute": "tabIndex",
@@ -7942,7 +8292,7 @@
           "type": "string"
         },
         {
-          "name": "api-version",
+          "name": "apiVersion",
           "type": "string"
         },
         {
@@ -7971,7 +8321,7 @@
         },
         {
           "name": "apiVersion",
-          "attribute": "api-version",
+          "attribute": "apiVersion",
           "type": "string"
         },
         {
@@ -8033,7 +8383,7 @@
           "type": "string"
         },
         {
-          "name": "api-version",
+          "name": "apiVersion",
           "type": "string"
         },
         {
@@ -8119,7 +8469,7 @@
           "default": "\"expand-more\""
         },
         {
-          "name": "has-custom-behaviour",
+          "name": "hasCustomBehaviour",
           "type": "boolean",
           "default": "false"
         }
@@ -8142,7 +8492,7 @@
         },
         {
           "name": "apiVersion",
-          "attribute": "api-version",
+          "attribute": "apiVersion",
           "type": "string"
         },
         {
@@ -8250,7 +8600,7 @@
         },
         {
           "name": "hasCustomBehaviour",
-          "attribute": "has-custom-behaviour",
+          "attribute": "hasCustomBehaviour",
           "type": "boolean",
           "default": "false"
         }
@@ -8285,7 +8635,7 @@
       "description": "represents an odd parameter element for editing",
       "attributes": [
         {
-          "name": "api-version",
+          "name": "apiVersion",
           "type": "string"
         },
         {
@@ -8324,7 +8674,7 @@
       "properties": [
         {
           "name": "apiVersion",
-          "attribute": "api-version",
+          "attribute": "apiVersion",
           "type": "string"
         },
         {
@@ -8405,8 +8755,7 @@
         },
         {
           "name": "scope",
-          "type": "string",
-          "default": "\"\""
+          "type": "string"
         },
         {
           "name": "selected",
@@ -8430,8 +8779,7 @@
         {
           "name": "scope",
           "attribute": "scope",
-          "type": "string",
-          "default": "\"\""
+          "type": "string"
         },
         {
           "name": "selected",
@@ -8469,7 +8817,7 @@
         },
         {
           "name": "locales",
-          "description": "Optional URL pointing to a directory from which additional i18n \nlanguage files will be loaded. The URL should contain placeholders\nfor the language (`lng`) and the namespace (`ns`), e.g.\n\n`resources/i18n/{{ns}}_{{lng}}.json`\n\nor\n\n`resources/i18n/{{ns}}/{{lng}}.json`\n\nThe latter assumes custom language files in a subdirectory, the first\nexpects the namespace to be specified at the start of the file name.\n\nThe default namespace for custom language files is assumed to be `app`,\nbut you can define additional namespaces via `localeFallbackNS`.",
+          "description": "Optional URL pointing to a directory from which additional i18n\nlanguage files will be loaded. The URL should contain placeholders\nfor the language (`lng`) and the namespace (`ns`), e.g.\n\n`resources/i18n/{{ns}}_{{lng}}.json`\n\nor\n\n`resources/i18n/{{ns}}/{{lng}}.json`\n\nThe latter assumes custom language files in a subdirectory, the first\nexpects the namespace to be specified at the start of the file name.\n\nThe default namespace for custom language files is assumed to be `app`,\nbut you can define additional namespaces via `localeFallbackNS`.",
           "type": "string"
         },
         {
@@ -8496,7 +8844,7 @@
         },
         {
           "name": "url-template",
-          "description": "Can be used to define parameters which should be serialized in the\nURL path rather than as query parameters. Expects a url pattern\nrelative to the application root\n(supported patterns are documented in the \n[path-to-regexp](https://www.npmjs.com/package/path-to-regexp) library documentation).\n\nFor example, a pattern `:lang/texts/:path/:id?` would support URLs like \n`en/texts/text1/chapter1`. Whenever components change state – e.g. due to a navigation\nevent – the standard parameters `path`, `lang` and `id` would be serialized into the\nURL path pattern rather than query parameters.",
+          "description": "Can be used to define parameters which should be serialized in the\nURL path rather than as query parameters. Expects a url pattern\nrelative to the application root\n(supported patterns are documented in the\n[path-to-regexp](https://www.npmjs.com/package/path-to-regexp) library documentation).\n\nFor example, a pattern `:lang/texts/:path/:id?` would support URLs like\n`en/texts/text1/chapter1`. Whenever components change state – e.g. due to a navigation\nevent – the standard parameters `path`, `lang` and `id` would be serialized into the\nURL path pattern rather than query parameters.",
           "type": "string"
         },
         {
@@ -8523,7 +8871,7 @@
         },
         {
           "name": "require-language",
-          "description": "If set, the element will wait for a language being set by i18n before\nit sends a `pb-page-ready` event. Elements like `pb-view` will wait\nfor this event before displaying content.\n\nAlso, `pb-view` will pass the configured language to the server endpoint\nwhere it will be available to ODD processing models in variable \n`$parameters?language` and can thus be used to change output depending on\nthe user interface language.\n\nIf you would like `pb-view` to refresh automatically whenever the language\nsetting changes, specify property `useLanguage` on the corresponding `pb-view`.",
+          "description": "If set, the element will wait for a language being set by i18n before\nit sends a `pb-page-ready` event. Elements like `pb-view` will wait\nfor this event before displaying content.\n\nAlso, `pb-view` will pass the configured language to the server endpoint\nwhere it will be available to ODD processing models in variable\n`$parameters?language` and can thus be used to change output depending on\nthe user interface language.\n\nIf you would like `pb-view` to refresh automatically whenever the language\nsetting changes, specify property `useLanguage` on the corresponding `pb-view`.",
           "type": "boolean",
           "default": "false"
         },
@@ -8590,7 +8938,7 @@
         {
           "name": "locales",
           "attribute": "locales",
-          "description": "Optional URL pointing to a directory from which additional i18n \nlanguage files will be loaded. The URL should contain placeholders\nfor the language (`lng`) and the namespace (`ns`), e.g.\n\n`resources/i18n/{{ns}}_{{lng}}.json`\n\nor\n\n`resources/i18n/{{ns}}/{{lng}}.json`\n\nThe latter assumes custom language files in a subdirectory, the first\nexpects the namespace to be specified at the start of the file name.\n\nThe default namespace for custom language files is assumed to be `app`,\nbut you can define additional namespaces via `localeFallbackNS`.",
+          "description": "Optional URL pointing to a directory from which additional i18n\nlanguage files will be loaded. The URL should contain placeholders\nfor the language (`lng`) and the namespace (`ns`), e.g.\n\n`resources/i18n/{{ns}}_{{lng}}.json`\n\nor\n\n`resources/i18n/{{ns}}/{{lng}}.json`\n\nThe latter assumes custom language files in a subdirectory, the first\nexpects the namespace to be specified at the start of the file name.\n\nThe default namespace for custom language files is assumed to be `app`,\nbut you can define additional namespaces via `localeFallbackNS`.",
           "type": "string"
         },
         {
@@ -8626,7 +8974,7 @@
         {
           "name": "urlTemplate",
           "attribute": "url-template",
-          "description": "Can be used to define parameters which should be serialized in the\nURL path rather than as query parameters. Expects a url pattern\nrelative to the application root\n(supported patterns are documented in the \n[path-to-regexp](https://www.npmjs.com/package/path-to-regexp) library documentation).\n\nFor example, a pattern `:lang/texts/:path/:id?` would support URLs like \n`en/texts/text1/chapter1`. Whenever components change state – e.g. due to a navigation\nevent – the standard parameters `path`, `lang` and `id` would be serialized into the\nURL path pattern rather than query parameters.",
+          "description": "Can be used to define parameters which should be serialized in the\nURL path rather than as query parameters. Expects a url pattern\nrelative to the application root\n(supported patterns are documented in the\n[path-to-regexp](https://www.npmjs.com/package/path-to-regexp) library documentation).\n\nFor example, a pattern `:lang/texts/:path/:id?` would support URLs like\n`en/texts/text1/chapter1`. Whenever components change state – e.g. due to a navigation\nevent – the standard parameters `path`, `lang` and `id` would be serialized into the\nURL path pattern rather than query parameters.",
           "type": "string"
         },
         {
@@ -8658,7 +9006,7 @@
         {
           "name": "requireLanguage",
           "attribute": "require-language",
-          "description": "If set, the element will wait for a language being set by i18n before\nit sends a `pb-page-ready` event. Elements like `pb-view` will wait\nfor this event before displaying content.\n\nAlso, `pb-view` will pass the configured language to the server endpoint\nwhere it will be available to ODD processing models in variable \n`$parameters?language` and can thus be used to change output depending on\nthe user interface language.\n\nIf you would like `pb-view` to refresh automatically whenever the language\nsetting changes, specify property `useLanguage` on the corresponding `pb-view`.",
+          "description": "If set, the element will wait for a language being set by i18n before\nit sends a `pb-page-ready` event. Elements like `pb-view` will wait\nfor this event before displaying content.\n\nAlso, `pb-view` will pass the configured language to the server endpoint\nwhere it will be available to ODD processing models in variable\n`$parameters?language` and can thus be used to change output depending on\nthe user interface language.\n\nIf you would like `pb-view` to refresh automatically whenever the language\nsetting changes, specify property `useLanguage` on the corresponding `pb-view`.",
           "type": "boolean",
           "default": "false"
         },
@@ -8751,6 +9099,11 @@
       "path": "./src/pb-paginate.js",
       "description": "Display a pagination control from which the user can select a page to view\nfrom a multi-page collection of resources. To determine the number of pages,\n`pb-paginate` listens for the `pb-results-received` event emitted by `pb-load`.\nIf the user clicks on one of the page indicators, a `pb-load` event is emitted,\nwhich should cause the connected `pb-load` element to refresh.",
       "attributes": [
+        {
+          "name": "show-previous-next",
+          "description": "show or hide (i.e. generate) previous and next buttons,\ndefault value is false, controls are not generated",
+          "type": "boolean"
+        },
         {
           "name": "total",
           "description": "total number of pages",
@@ -8777,13 +9130,13 @@
         },
         {
           "name": "page-count",
-          "description": "the amount of pages",
+          "description": "the amount of pages needed for all items,\ncalculated from total / perPage",
           "type": "number",
           "default": "10"
         },
         {
           "name": "range",
-          "description": "todo",
+          "description": "the amount of page numbers shown within the component",
           "type": "number",
           "default": "5"
         },
@@ -8832,6 +9185,12 @@
         }
       ],
       "properties": [
+        {
+          "name": "showPreviousNext",
+          "attribute": "show-previous-next",
+          "description": "show or hide (i.e. generate) previous and next buttons,\ndefault value is false, controls are not generated",
+          "type": "boolean"
+        },
         {
           "name": "total",
           "attribute": "total",
@@ -8863,14 +9222,14 @@
         {
           "name": "pageCount",
           "attribute": "page-count",
-          "description": "the amount of pages",
+          "description": "the amount of pages needed for all items,\ncalculated from total / perPage",
           "type": "number",
           "default": "10"
         },
         {
           "name": "range",
           "attribute": "range",
-          "description": "todo",
+          "description": "the amount of page numbers shown within the component",
           "type": "number",
           "default": "5"
         },
@@ -9111,7 +9470,7 @@
     {
       "name": "pb-popover",
       "path": "./src/pb-popover.js",
-      "description": "Show a popover. It may either \n\n1. be attached to another element on the page which serves as a trigger. For this the\n`for` property must be specified and should contain the ID of the trigger element. \nThe whole content of the `pb-popover` element will be shown in the popup.\n\n2. if no `for` property is specified, the `pb-popover` acts itself as the trigger. The trigger\ntext is either taken from a slot named `default` - or the default slot (i.e. the content of the element).\nThe content to show in the popup should be supplied in a slot named `alternate`. It is recommended to use an\nHTML `template` to specify the alternate, so it is ignored by the browser:\n\n```html\n<pb-popover theme=\"material\">\n     <span slot=\"default\">ipsum dolor sit amet</span>\n     <template slot=\"alternate\">\n         <p>At vero eos et <strong>accusam</strong> et justo duo dolores<br>\n         et ea rebum.</p>\n     </template>\n</pb-popover>\n```\n\nIf you would like popovers to contain nested popovers, choose approach 1 above and use `for`.\n\nIf property `persistent` is true, the popover will be shown\non click. Otherwise display a tooltip on mouseover.\n\n`pb-popover` uses the tippy.js library for the popup.\n\n## Styling\n\nWhen showing the popup, the popup content will either be added to the parent shadow DOM - if the `pb-popover`\nis located inside the shadow DOM of another element like `pb-view`; or the document body. This has an\neffect on where CSS styles can be defined: within a `pb-view`, only the styles specified inside the\nCSS attached to the ODD are applied.",
+      "description": "Show a popover. It may either\n\n1. be attached to another element on the page which serves as a trigger. For this the\n`for` property must be specified and should contain the ID of the trigger element.\nThe whole content of the `pb-popover` element will be shown in the popup.\n\n2. if no `for` property is specified, the `pb-popover` acts itself as the trigger. The trigger\ntext is either taken from a slot named `default` - or the default slot (i.e. the content of the element).\nThe content to show in the popup should be supplied in a slot named `alternate`. It is recommended to use an\nHTML `template` to specify the alternate, so it is ignored by the browser:\n\n```html\n<pb-popover theme=\"material\">\n     <span slot=\"default\">ipsum dolor sit amet</span>\n     <template slot=\"alternate\">\n         <p>At vero eos et <strong>accusam</strong> et justo duo dolores<br>\n         et ea rebum.</p>\n     </template>\n</pb-popover>\n```\n\nIf you would like popovers to contain nested popovers, choose approach 1 above and use `for`.\n\nIf property `persistent` is true, the popover will be shown\non click. Otherwise display a tooltip on mouseover.\n\n`pb-popover` uses the tippy.js library for the popup.\n\n## Styling\n\nWhen showing the popup, the popup content will either be added to the parent shadow DOM - if the `pb-popover`\nis located inside the shadow DOM of another element like `pb-view`; or the document body. This has an\neffect on where CSS styles can be defined: within a `pb-view`, only the styles specified inside the\nCSS attached to the ODD are applied.",
       "attributes": [
         {
           "name": "remote",
@@ -9495,7 +9854,7 @@
     {
       "name": "pb-progress",
       "path": "./src/pb-progress.js",
-      "description": "A progress bar which becomes active when signal `pb-start-update` is\nbeing sent and is deactivated on `pb-end-update`.",
+      "description": "A progress bar which becomes active when signal `pb-start-update` is\nbeing sent and is deactivated on `pb-end-update`.\n\nUses a native `<progress>` element.",
       "attributes": [
         {
           "name": "subscribe",
@@ -10034,7 +10393,7 @@
     {
       "name": "pb-select-feature",
       "path": "./src/pb-select-feature.js",
-      "description": "Similar to `pb-toggle-feature` but allows you to choose from a list of defined states instead of a simple\non/off toggle. Like `pb-toggle-feature` it can change state server-side as well as client-side. \n\nThe list of states is passed as a JSON array to property `items`:\n\n# Server-side\n\nProperties to be passed to the server are specified as follows:\n\n```javascript\n[\n     {\"name\": \"Diplomatic View\", \"properties\": {\"mode\": \"diplomatic\", \"view\": \"page\"}},\n     {\"name\": \"Normalized View\", \"properties\": {\"mode\": \"norm\", \"view\": \"single\"}}\n]\n```\n\nIf the `name` property references the path to a translated label, the translation will be used instead.\n# Client-side\n\n```javascript\n[\n     {\"name\": \"Diplomatic View\", \"selectors\": [{\"selector\": \".choice,.choice-alternate,br\", \"state\": false},{\"selector\": \".tei-foreign,pb-highlight,pb-popover\", \"command\": \"disable\"}]},\n     {\"name\": \"Normalized View\", \"selectors\": [{\"selector\": \".choice,.choice-alternate,br\", \"state\": true},{\"selector\": \".tei-foreign,pb-highlight,pb-popover\", \"command\": \"disable\"}]},\n     {\"name\": \"Plain Reading View\", \"selectors\": [{\"selector\": \".choice,.choice-alternate,br\", \"state\": true}, {\"selector\": \".tei-foreign,pb-highlight,pb-popover\", \"command\": \"disable\", \"state\": true}]}\n]\n```\n\nEach item in the `selectors` property above defines either a state or a command. *state* will simply add\na css class `.toggle` to the target element when true. If *command* is set to 'disable', it will entirely disable\nthe functionality of selected elements - provided that they are\npublisher components implementing the corresponding `command` method of `pb-mixin`.\n\nClient-side you may also pass an optional property `\"global\": true` to toggle the state of elements which reside\nin the surrounding HTML context below `pb-page` (means: elements which are not inside a `pb-view` or `pb-load`).",
+      "description": "Similar to `pb-toggle-feature` but allows you to choose from a list of defined states instead of a simple\non/off toggle. Like `pb-toggle-feature` it can change state server-side as well as client-side.\n\nThe list of states is passed as a JSON array to property `items`:\n\n# Server-side\n\nProperties to be passed to the server are specified as follows:\n\n```javascript\n[\n     {\"name\": \"Diplomatic View\", \"properties\": {\"mode\": \"diplomatic\", \"view\": \"page\"}},\n     {\"name\": \"Normalized View\", \"properties\": {\"mode\": \"norm\", \"view\": \"single\"}}\n]\n```\n\nIf the `name` property references the path to a translated label, the translation will be used instead.\n# Client-side\n\n```javascript\n[\n     {\"name\": \"Diplomatic View\", \"selectors\": [{\"selector\": \".choice,.choice-alternate,br\", \"state\": false},{\"selector\": \".tei-foreign,pb-highlight,pb-popover\", \"command\": \"disable\"}]},\n     {\"name\": \"Normalized View\", \"selectors\": [{\"selector\": \".choice,.choice-alternate,br\", \"state\": true},{\"selector\": \".tei-foreign,pb-highlight,pb-popover\", \"command\": \"disable\"}]},\n     {\"name\": \"Plain Reading View\", \"selectors\": [{\"selector\": \".choice,.choice-alternate,br\", \"state\": true}, {\"selector\": \".tei-foreign,pb-highlight,pb-popover\", \"command\": \"disable\", \"state\": true}]}\n]\n```\n\nEach item in the `selectors` property above defines either a state or a command. *state* will simply add\na css class `.toggle` to the target element when true. If *command* is set to 'disable', it will entirely disable\nthe functionality of selected elements - provided that they are\npublisher components implementing the corresponding `command` method of `pb-mixin`.\n\nClient-side you may also pass an optional property `\"global\": true` to toggle the state of elements which reside\nin the surrounding HTML context below `pb-page` (means: elements which are not inside a `pb-view` or `pb-load`).",
       "attributes": [
         {
           "name": "name",
@@ -10315,6 +10674,11 @@
           "type": "string",
           "default": "\"document.selectTemplate\""
         },
+        {
+          "name": "name",
+          "type": "string",
+          "default": "\"\""
+        },
         {
           "name": "subscribe",
           "description": "The name of the channel to subscribe to. Only events on a channel corresponding\nto this property are listened to.",
@@ -10361,6 +10725,12 @@
           "type": "string",
           "default": "\"document.selectTemplate\""
         },
+        {
+          "name": "name",
+          "attribute": "name",
+          "type": "string",
+          "default": "\"\""
+        },
         {
           "name": "subscribe",
           "attribute": "subscribe",
@@ -10567,7 +10937,7 @@
     {
       "name": "pb-split-list",
       "path": "./src/pb-split-list.js",
-      "description": "Implements a list which is split into different categories \n(e.g. letters of the alphabet, countries ...).\nOnly one category is shown at a time unless the server reports\nno categories (e.g. if the number of items to display goes below\na defined threshold).\n\nThe server-side API endpoint should return a JSON object with two\nproperties:\n\n+ `categories`: an array of category descriptions: each item should \n be an object with two properties: `category` - containing the name of the category\n and `count` - containing a count of items available under this category.\n+ `items`: an array with the items to be shown for the currently selected\n category. Those may contain HTML markup.\n\nSample JSON object for pb-split-list\n```javascript\n{\n   \"items\": [\n       \"<span><a href='Abegg-Arter Carl?category=A&amp;view=correspondents&amp;search='>Abegg-Arter, Carl</a><span class='dates'> (1836–1912)</span></span>\",\n       \"<span><a href='Abegg Hans Heinrich?category=A&amp;view=correspondents&amp;search='>Abegg, Hans Heinrich</a><span class='dates'> (1805–1874)</span></span>\",\n       \"<span><a href='Abegg Jakob?category=A&amp;view=correspondents&amp;search='>Abegg, Jakob</a><span class='dates'> (1801–1871)</span></span>\",\n       \"<span><a href='Abys Raget?category=A&amp;view=correspondents&amp;search='>Abys, Raget</a><span class='dates'> (1790–1861)</span></span>\",\n       \"<span><a href='Aebli Johann Peter?category=A&amp;view=correspondents&amp;search='>Aebli, Johann Peter</a><span class='dates'> (1804–1879)</span></span>\",\n       \"<span><a href='Aepli Arnold Otto?category=A&amp;view=correspondents&amp;search='>Aepli, Arnold Otto</a><span class='dates'> (1816–1897)</span></span>\",\n       ...\n   ],\n   \"categories\": [\n       {\n           \"category\": \"A\",\n           \"count\": 22\n       },\n       {\n           \"category\": \"B\",\n           \"count\": 77\n       },\n       {\n           \"category\": \"C\",\n           \"count\": 19\n       },\n     ...\n   ]\n}\n```\n\nSample Usage \n```xml\n<pb-split-list url=\"api/people\" subforms=\"#options\" selected=\"A\" emit=\"transcription\" subscribe=\"transcription\"></pb-split-list>\n```\nSee https://www.briefedition.alfred-escher.ch/kontexte/personen/?category=A&search=&view=correspondents for a running sample. The source code of the webpage is here: https://github.com/stazh/briefedition-escher. Relevant files are: \n- [templates/index.html](https://github.com/stazh/briefedition-escher/blob/master/templates/index.html#L223) - usage of pb-timeline\n- [modules/custom-api.json](https://github.com/stazh/briefedition-escher/blob/master/modules/custom-api.json#L1098) - `/api/people` endpoint delivering required JSON object",
+      "description": "Implements a list which is split into different categories\n(e.g. letters of the alphabet, countries ...).\nOnly one category is shown at a time unless the server reports\nno categories (e.g. if the number of items to display goes below\na defined threshold).\n\nThe server-side API endpoint should return a JSON object with two\nproperties:\n\n+ `categories`: an array of category descriptions: each item should\n be an object with two properties: `category` - containing the name of the category\n and `count` - containing a count of items available under this category.\n+ `items`: an array with the items to be shown for the currently selected\n category. Those may contain HTML markup.\n\nSample JSON object for pb-split-list\n```javascript\n{\n   \"items\": [\n       \"<span><a href='Abegg-Arter Carl?category=A&amp;view=correspondents&amp;search='>Abegg-Arter, Carl</a><span class='dates'> (1836–1912)</span></span>\",\n       \"<span><a href='Abegg Hans Heinrich?category=A&amp;view=correspondents&amp;search='>Abegg, Hans Heinrich</a><span class='dates'> (1805–1874)</span></span>\",\n       \"<span><a href='Abegg Jakob?category=A&amp;view=correspondents&amp;search='>Abegg, Jakob</a><span class='dates'> (1801–1871)</span></span>\",\n       \"<span><a href='Abys Raget?category=A&amp;view=correspondents&amp;search='>Abys, Raget</a><span class='dates'> (1790–1861)</span></span>\",\n       \"<span><a href='Aebli Johann Peter?category=A&amp;view=correspondents&amp;search='>Aebli, Johann Peter</a><span class='dates'> (1804–1879)</span></span>\",\n       \"<span><a href='Aepli Arnold Otto?category=A&amp;view=correspondents&amp;search='>Aepli, Arnold Otto</a><span class='dates'> (1816–1897)</span></span>\",\n       ...\n   ],\n   \"categories\": [\n       {\n           \"category\": \"A\",\n           \"count\": 22\n       },\n       {\n           \"category\": \"B\",\n           \"count\": 77\n       },\n       {\n           \"category\": \"C\",\n           \"count\": 19\n       },\n     ...\n   ]\n}\n```\n\nSample Usage\n```xml\n<pb-split-list url=\"api/people\" subforms=\"#options\" selected=\"A\" emit=\"transcription\" subscribe=\"transcription\"></pb-split-list>\n```\nSee https://www.briefedition.alfred-escher.ch/kontexte/personen/?category=A&search=&view=correspondents for a running sample. The source code of the webpage is here: https://github.com/stazh/briefedition-escher. Relevant files are:\n- [templates/index.html](https://github.com/stazh/briefedition-escher/blob/master/templates/index.html#L223) - usage of pb-timeline\n- [modules/custom-api.json](https://github.com/stazh/briefedition-escher/blob/master/modules/custom-api.json#L1098) - `/api/people` endpoint delivering required JSON object",
       "attributes": [
         {
           "name": "url",
@@ -11106,7 +11476,7 @@
       "events": [
         {
           "name": "pb-tab",
-          "description": "fired if selected tab changes. Details contain number of \nselected tab in propery `selected`."
+          "description": "fired if selected tab changes. Details contain number of\nselected tab in propery `selected`."
         }
       ],
       "slots": [
@@ -11136,6 +11506,23 @@
           "description": "URL pointing to a IIIF presentation manifest. Relative paths\nare interpreted relative to the API endpoint.",
           "type": "string"
         },
+        {
+          "name": "initial-view",
+          "description": "The initial view to display. Can be 'toc' (table of contents),\n'thumbnails', 'text', 'info', 'help', 'export', or null for media only.\nDefaults to null (media view only).",
+          "type": "string"
+        },
+        {
+          "name": "enable-navigation",
+          "description": "If true, pb-tify will respond to pb-navigate events to synchronize\nwith navigation buttons. Defaults to true.",
+          "type": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "disable-history",
+          "description": "If set, do not update browser history when navigating.\nDefaults to false (history is enabled).",
+          "type": "boolean",
+          "default": "false"
+        },
         {
           "name": "subscribe",
           "description": "The name of the channel to subscribe to. Only events on a channel corresponding\nto this property are listened to.",
@@ -11175,11 +11562,31 @@
           "description": "URL pointing to a IIIF presentation manifest. Relative paths\nare interpreted relative to the API endpoint.",
           "type": "string"
         },
+        {
+          "name": "initialView",
+          "attribute": "initial-view",
+          "description": "The initial view to display. Can be 'toc' (table of contents),\n'thumbnails', 'text', 'info', 'help', 'export', or null for media only.\nDefaults to null (media view only).",
+          "type": "string"
+        },
         {
           "name": "cssPath",
           "type": "string",
           "default": "\"../css/tify\""
         },
+        {
+          "name": "enableNavigation",
+          "attribute": "enable-navigation",
+          "description": "If true, pb-tify will respond to pb-navigate events to synchronize\nwith navigation buttons. Defaults to true.",
+          "type": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "disableHistory",
+          "attribute": "disable-history",
+          "description": "If set, do not update browser history when navigating.\nDefaults to false (history is enabled).",
+          "type": "boolean",
+          "default": "false"
+        },
         {
           "name": "subscribe",
           "attribute": "subscribe",
@@ -11232,7 +11639,7 @@
     {
       "name": "pb-timeline",
       "path": "./src/pb-timeline.js",
-      "description": "A timeline component to display time series data in a bar chart like view.\n\nTime series data can be displayed in one of 6 different scales:\n\n- by decade (10Y)\n- by 5 years (5Y)\n- by years (Y)\n- by month (M)\n- by week (W)\n- by day (D)\n\nThe endpoint is expected to return a JSON object. Each property should either be a date or the special\nmarker `?`, which indicates undated resources.\nThe value associated with each entry\nshould either correspond to a count of resources or an object with properties `count` and `info`. \n`info` should be an array, containing HTML to be shown in a list within the tooltips.\nExpected JSON: \n```javascript\n{\n \"1852-01-14\": {\n     \"count\": 1,\n     \"info\": [\n       \"<a href='/briefe/B0977' part='tooltip-link'>Alfred Escher an Joseph Wolfgang von Deschwanden, Belvoir (Enge, Zürich), Mittwoch, 14. Januar 1852</a>\"\n    ]\n  },\n\"1874-01-25\": {\n   \"count\": 3,\n    \"info\": [\n        \"<a href='/briefe/B8140' part='tooltip-link'>Alfred Escher an Gustav von Mevissen, Zürich, Sonntag, 25. Januar 1874</a>\",\n        \"<a href='/briefe/B8139' part='tooltip-link'>Alfred Escher an Theodor Weishaupt, Zürich, Sonntag, 25. Januar 1874</a>\",\n        \"<a href='/briefe/B8143' part='tooltip-link'>Alfred Escher an Ludwig August Parcus, Zürich, Sonntag, 25. Januar 1874</a>\"\n    ]\n }\n}\n```\nSample Usage:\n```xml\n<pb-timeline url=\"api/timeline\" scopes=\"['D', 'M', 'Y', '5Y', '10Y']\"\n     resettable=\"\"\n     subscribe=\"docs\" emit=\"timeline\">\n  <span slot=\"label\">Angezeigter Zeitraum: </span>\n</pb-timeline>\n```\nSee https://www.briefedition.alfred-escher.ch/briefe/ for a running sample. The source code of the webpage is here: https://github.com/stazh/briefedition-escher. Relevant files are: \n- [templates/people.html](https://github.com/stazh/briefedition-escher/blob/master/templates/people.html#L91) - usage of pb-timeline\n- [modules/custom-api.json](https://github.com/stazh/briefedition-escher/blob/master/modules/custom-api.json#L1080) - `/api/timeline` endpoint delivering required JSON object",
+      "description": "A timeline component to display time series data in a bar chart like view.\n\nTime series data can be displayed in one of 6 different scales:\n\n- by decade (10Y)\n- by 5 years (5Y)\n- by years (Y)\n- by month (M)\n- by week (W)\n- by day (D)\n\nThe endpoint is expected to return a JSON object. Each property should either be a date or the special\nmarker `?`, which indicates undated resources.\nThe value associated with each entry\nshould either correspond to a count of resources or an object with properties `count` and `info`.\n`info` should be an array, containing HTML to be shown in a list within the tooltips.\nExpected JSON:\n```javascript\n{\n \"1852-01-14\": {\n     \"count\": 1,\n     \"info\": [\n       \"<a href='/briefe/B0977' part='tooltip-link'>Alfred Escher an Joseph Wolfgang von Deschwanden, Belvoir (Enge, Zürich), Mittwoch, 14. Januar 1852</a>\"\n    ]\n  },\n\"1874-01-25\": {\n   \"count\": 3,\n    \"info\": [\n        \"<a href='/briefe/B8140' part='tooltip-link'>Alfred Escher an Gustav von Mevissen, Zürich, Sonntag, 25. Januar 1874</a>\",\n        \"<a href='/briefe/B8139' part='tooltip-link'>Alfred Escher an Theodor Weishaupt, Zürich, Sonntag, 25. Januar 1874</a>\",\n        \"<a href='/briefe/B8143' part='tooltip-link'>Alfred Escher an Ludwig August Parcus, Zürich, Sonntag, 25. Januar 1874</a>\"\n    ]\n }\n}\n```\nSample Usage:\n```xml\n<pb-timeline url=\"api/timeline\" scopes=\"['D', 'M', 'Y', '5Y', '10Y']\"\n     resettable=\"\"\n     subscribe=\"docs\" emit=\"timeline\">\n  <span slot=\"label\">Angezeigter Zeitraum: </span>\n</pb-timeline>\n```\nSee https://www.briefedition.alfred-escher.ch/briefe/ for a running sample. The source code of the webpage is here: https://github.com/stazh/briefedition-escher. Relevant files are:\n- [templates/people.html](https://github.com/stazh/briefedition-escher/blob/master/templates/people.html#L91) - usage of pb-timeline\n- [modules/custom-api.json](https://github.com/stazh/briefedition-escher/blob/master/modules/custom-api.json#L1080) - `/api/timeline` endpoint delivering required JSON object",
       "attributes": [
         {
           "name": "start-date",
@@ -11474,6 +11881,12 @@
         },
         {
           "name": "--pb-timeline-tooltip-font-size"
+        },
+        {
+          "name": "--pb-timeline-tooltip-min-width"
+        },
+        {
+          "name": "--pb-timeline-tooltip-max-width"
         }
       ],
       "cssParts": [
@@ -11500,7 +11913,7 @@
         },
         {
           "name": "selector",
-          "description": "(optional) CSS selector: selects the elements to toggle client side (sets or unsets a \nCSS class `.toggled`). Setting this property will not trigger a reload as everything is\nhandled by javascript.",
+          "description": "(optional) CSS selector: selects the elements to toggle client side (sets or unsets a\nCSS class `.toggled`). Setting this property will not trigger a reload as everything is\nhandled by javascript.",
           "type": "string"
         },
         {
@@ -11551,7 +11964,7 @@
         },
         {
           "name": "global",
-          "description": "If set, toggle the state of elements which reside\nin the surrounding HTML context below `pb-page` \n(means: elements which are not inside a `pb-view` or `pb-load`).",
+          "description": "If set, toggle the state of elements which reside\nin the surrounding HTML context below `pb-page`\n(means: elements which are not inside a `pb-view` or `pb-load`).",
           "type": "boolean",
           "default": "false"
         },
@@ -11597,7 +12010,7 @@
         {
           "name": "selector",
           "attribute": "selector",
-          "description": "(optional) CSS selector: selects the elements to toggle client side (sets or unsets a \nCSS class `.toggled`). Setting this property will not trigger a reload as everything is\nhandled by javascript.",
+          "description": "(optional) CSS selector: selects the elements to toggle client side (sets or unsets a\nCSS class `.toggled`). Setting this property will not trigger a reload as everything is\nhandled by javascript.",
           "type": "string"
         },
         {
@@ -11657,7 +12070,7 @@
         {
           "name": "global",
           "attribute": "global",
-          "description": "If set, toggle the state of elements which reside\nin the surrounding HTML context below `pb-page` \n(means: elements which are not inside a `pb-view` or `pb-load`).",
+          "description": "If set, toggle the state of elements which reside\nin the surrounding HTML context below `pb-page`\n(means: elements which are not inside a `pb-view` or `pb-load`).",
           "type": "boolean",
           "default": "false"
         },
@@ -11910,6 +12323,11 @@
           "description": "The view type to use for paginating the document. Either `page`, `div` or `single`.\nOverwrites the same property specified on `pb-document`. Values have the following meaning:\n\nValue | Displayed content\n------|------------------\n`page` | content is displayed page by page as determined by tei:pb\n`div` | content is displayed by divisions\n`single` | do not paginate but display entire content at once",
           "type": "string"
         },
+        {
+          "name": "fill",
+          "description": "Controls the pagination-by-div algorithm: if a page would have less than\n`fill` elements, it tries to fill\nup the page by pulling following divs in. When set to 0, it will never\nattempt to fill up the page. For the annotation editor this should\nalways be 0.",
+          "type": "number"
+        },
         {
           "name": "node-id",
           "description": "An eXist nodeId. If specified, selects the root of the fragment of the document\nwhich should be displayed. Normally this property is set automatically by pagination.",
@@ -11965,6 +12383,12 @@
           "description": "The relative URL to the script on the server which will be called for loading content.",
           "type": "string"
         },
+        {
+          "name": "read-only-registry",
+          "description": "If set to true, pb-view will only read from the registry and never write to it.\nThis is useful when pb-view is used as a simple receiver of navigation updates\nfrom other components (e.g., pb-tify). When enabled, pb-view will:\n- Still subscribe to registry changes\n- Still read from registry to determine what to display\n- Never call registry.replace or registry.commit after initial connection\n\nThis prevents pb-view from resetting the registry with stale state during navigation,\nwhich can cause bounce-back issues when used with components like pb-tify.\n\nDefault is false (pb-view can write to registry as before).",
+          "type": "boolean",
+          "default": "false"
+        },
         {
           "name": "on-update",
           "description": "If set to true, the component will not load automatically. Instead it will wait until it receives a `pb-update`\nevent. Use this to make one `pb-view` component dependent on another one. Default is 'false'.",
@@ -12019,7 +12443,7 @@
         },
         {
           "name": "no-scroll",
-          "description": "If set, do not scroll the view to target node (e.g. given in URL hash) \nafter content was loaded.",
+          "description": "If set, do not scroll the view to target node (e.g. given in URL hash)\nafter content was loaded.",
           "type": "boolean",
           "default": "false"
         },
@@ -12050,7 +12474,7 @@
         },
         {
           "name": "wait-for",
-          "description": "A selector pointing to other components this component depends on.\nWhen method `wait` is called, it will wait until all referenced\ncomponents signal with a `pb-ready` event that they are ready and listening\nto events.\n\n`pb-view` by default sets this property to select `pb-toggle-feature` and `pb-select-feature` \nelements.",
+          "description": "A selector pointing to other components this component depends on.\nWhen method `wait` is called, it will wait until all referenced\ncomponents signal with a `pb-ready` event that they are ready and listening\nto events.\n\n`pb-view` by default sets this property to select `pb-toggle-feature` and `pb-select-feature`\nelements.",
           "type": "string"
         },
         {
@@ -12098,6 +12522,12 @@
           "description": "The view type to use for paginating the document. Either `page`, `div` or `single`.\nOverwrites the same property specified on `pb-document`. Values have the following meaning:\n\nValue | Displayed content\n------|------------------\n`page` | content is displayed page by page as determined by tei:pb\n`div` | content is displayed by divisions\n`single` | do not paginate but display entire content at once",
           "type": "string"
         },
+        {
+          "name": "fill",
+          "attribute": "fill",
+          "description": "Controls the pagination-by-div algorithm: if a page would have less than\n`fill` elements, it tries to fill\nup the page by pulling following divs in. When set to 0, it will never\nattempt to fill up the page. For the annotation editor this should\nalways be 0.",
+          "type": "number"
+        },
         {
           "name": "nodeId",
           "attribute": "node-id",
@@ -12164,6 +12594,13 @@
           "description": "The relative URL to the script on the server which will be called for loading content.",
           "type": "string"
         },
+        {
+          "name": "readOnlyRegistry",
+          "attribute": "read-only-registry",
+          "description": "If set to true, pb-view will only read from the registry and never write to it.\nThis is useful when pb-view is used as a simple receiver of navigation updates\nfrom other components (e.g., pb-tify). When enabled, pb-view will:\n- Still subscribe to registry changes\n- Still read from registry to determine what to display\n- Never call registry.replace or registry.commit after initial connection\n\nThis prevents pb-view from resetting the registry with stale state during navigation,\nwhich can cause bounce-back issues when used with components like pb-tify.\n\nDefault is false (pb-view can write to registry as before).",
+          "type": "boolean",
+          "default": "false"
+        },
         {
           "name": "onUpdate",
           "attribute": "on-update",
@@ -12233,7 +12670,7 @@
         {
           "name": "noScroll",
           "attribute": "no-scroll",
-          "description": "If set, do not scroll the view to target node (e.g. given in URL hash) \nafter content was loaded.",
+          "description": "If set, do not scroll the view to target node (e.g. given in URL hash)\nafter content was loaded.",
           "type": "boolean",
           "default": "false"
         },
@@ -12270,7 +12707,7 @@
         {
           "name": "waitFor",
           "attribute": "wait-for",
-          "description": "A selector pointing to other components this component depends on.\nWhen method `wait` is called, it will wait until all referenced\ncomponents signal with a `pb-ready` event that they are ready and listening\nto events.\n\n`pb-view` by default sets this property to select `pb-toggle-feature` and `pb-select-feature` \nelements.",
+          "description": "A selector pointing to other components this component depends on.\nWhen method `wait` is called, it will wait until all referenced\ncomponents signal with a `pb-ready` event that they are ready and listening\nto events.\n\n`pb-view` by default sets this property to select `pb-toggle-feature` and `pb-select-feature`\nelements.",
           "type": "string"
         },
         {
@@ -12322,10 +12759,6 @@
           "name": "pb-navigate",
           "description": "When received, navigate forward or backward in the document"
         },
-        {
-          "name": "pb-zoom",
-          "description": "When received, zoom in or out by changing font size of the content"
-        },
         {
           "name": "pb-refresh",
           "description": "When received, refresh the content based on the parameters passed in the event"
@@ -12407,6 +12840,11 @@
           "description": "The view type to use for paginating the document. Either `page`, `div` or `single`.\nOverwrites the same property specified on `pb-document`. Values have the following meaning:\n\nValue | Displayed content\n------|------------------\n`page` | content is displayed page by page as determined by tei:pb\n`div` | content is displayed by divisions\n`single` | do not paginate but display entire content at once",
           "type": "string"
         },
+        {
+          "name": "fill",
+          "description": "Controls the pagination-by-div algorithm: if a page would have less than\n`fill` elements, it tries to fill\nup the page by pulling following divs in. When set to 0, it will never\nattempt to fill up the page. For the annotation editor this should\nalways be 0.",
+          "type": "number"
+        },
         {
           "name": "node-id",
           "description": "An eXist nodeId. If specified, selects the root of the fragment of the document\nwhich should be displayed. Normally this property is set automatically by pagination.",
@@ -12462,6 +12900,12 @@
           "description": "The relative URL to the script on the server which will be called for loading content.",
           "type": "string"
         },
+        {
+          "name": "read-only-registry",
+          "description": "If set to true, pb-view will only read from the registry and never write to it.\nThis is useful when pb-view is used as a simple receiver of navigation updates\nfrom other components (e.g., pb-tify). When enabled, pb-view will:\n- Still subscribe to registry changes\n- Still read from registry to determine what to display\n- Never call registry.replace or registry.commit after initial connection\n\nThis prevents pb-view from resetting the registry with stale state during navigation,\nwhich can cause bounce-back issues when used with components like pb-tify.\n\nDefault is false (pb-view can write to registry as before).",
+          "type": "boolean",
+          "default": "false"
+        },
         {
           "name": "on-update",
           "description": "If set to true, the component will not load automatically. Instead it will wait until it receives a `pb-update`\nevent. Use this to make one `pb-view` component dependent on another one. Default is 'false'.",
@@ -12516,7 +12960,7 @@
         },
         {
           "name": "no-scroll",
-          "description": "If set, do not scroll the view to target node (e.g. given in URL hash) \nafter content was loaded.",
+          "description": "If set, do not scroll the view to target node (e.g. given in URL hash)\nafter content was loaded.",
           "type": "boolean",
           "default": "false"
         },
@@ -12547,7 +12991,7 @@
         },
         {
           "name": "wait-for",
-          "description": "A selector pointing to other components this component depends on.\nWhen method `wait` is called, it will wait until all referenced\ncomponents signal with a `pb-ready` event that they are ready and listening\nto events.\n\n`pb-view` by default sets this property to select `pb-toggle-feature` and `pb-select-feature` \nelements.",
+          "description": "A selector pointing to other components this component depends on.\nWhen method `wait` is called, it will wait until all referenced\ncomponents signal with a `pb-ready` event that they are ready and listening\nto events.\n\n`pb-view` by default sets this property to select `pb-toggle-feature` and `pb-select-feature`\nelements.",
           "type": "string"
         },
         {
@@ -12570,6 +13014,12 @@
           "description": "The view type to use for paginating the document. Either `page`, `div` or `single`.\nOverwrites the same property specified on `pb-document`. Values have the following meaning:\n\nValue | Displayed content\n------|------------------\n`page` | content is displayed page by page as determined by tei:pb\n`div` | content is displayed by divisions\n`single` | do not paginate but display entire content at once",
           "type": "string"
         },
+        {
+          "name": "fill",
+          "attribute": "fill",
+          "description": "Controls the pagination-by-div algorithm: if a page would have less than\n`fill` elements, it tries to fill\nup the page by pulling following divs in. When set to 0, it will never\nattempt to fill up the page. For the annotation editor this should\nalways be 0.",
+          "type": "number"
+        },
         {
           "name": "nodeId",
           "attribute": "node-id",
@@ -12636,6 +13086,13 @@
           "description": "The relative URL to the script on the server which will be called for loading content.",
           "type": "string"
         },
+        {
+          "name": "readOnlyRegistry",
+          "attribute": "read-only-registry",
+          "description": "If set to true, pb-view will only read from the registry and never write to it.\nThis is useful when pb-view is used as a simple receiver of navigation updates\nfrom other components (e.g., pb-tify). When enabled, pb-view will:\n- Still subscribe to registry changes\n- Still read from registry to determine what to display\n- Never call registry.replace or registry.commit after initial connection\n\nThis prevents pb-view from resetting the registry with stale state during navigation,\nwhich can cause bounce-back issues when used with components like pb-tify.\n\nDefault is false (pb-view can write to registry as before).",
+          "type": "boolean",
+          "default": "false"
+        },
         {
           "name": "onUpdate",
           "attribute": "on-update",
@@ -12705,7 +13162,7 @@
         {
           "name": "noScroll",
           "attribute": "no-scroll",
-          "description": "If set, do not scroll the view to target node (e.g. given in URL hash) \nafter content was loaded.",
+          "description": "If set, do not scroll the view to target node (e.g. given in URL hash)\nafter content was loaded.",
           "type": "boolean",
           "default": "false"
         },
@@ -12742,7 +13199,7 @@
         {
           "name": "waitFor",
           "attribute": "wait-for",
-          "description": "A selector pointing to other components this component depends on.\nWhen method `wait` is called, it will wait until all referenced\ncomponents signal with a `pb-ready` event that they are ready and listening\nto events.\n\n`pb-view` by default sets this property to select `pb-toggle-feature` and `pb-select-feature` \nelements.",
+          "description": "A selector pointing to other components this component depends on.\nWhen method `wait` is called, it will wait until all referenced\ncomponents signal with a `pb-ready` event that they are ready and listening\nto events.\n\n`pb-view` by default sets this property to select `pb-toggle-feature` and `pb-select-feature`\nelements.",
           "type": "string"
         },
         {
@@ -12770,10 +13227,6 @@
           "name": "pb-navigate",
           "description": "When received, navigate forward or backward in the document"
         },
-        {
-          "name": "pb-zoom",
-          "description": "When received, zoom in or out by changing font size of the content"
-        },
         {
           "name": "pb-refresh",
           "description": "When received, refresh the content based on the parameters passed in the event"
@@ -12843,20 +13296,20 @@
     {
       "name": "pb-zoom",
       "path": "./src/pb-zoom.js",
-      "description": "Zoom button to enlarge/shrink the font for the views. This component does not\nimplement any functionality itself, but just emits a `pb-zoom` event.",
+      "description": "Zoom button to enlarge/shrink the font for the views. This component manages\nthe global zoom level by setting CSS custom properties on the document root.",
       "attributes": [
-        {
-          "name": "icon",
-          "description": "The icon to use",
-          "type": "string",
-          "default": "\"icons:zoom-in\""
-        },
         {
           "name": "direction",
           "description": "Either 'in' or 'out'",
           "type": "string",
           "default": "\"in\""
         },
+        {
+          "name": "zoom-factor",
+          "description": "The current zoom factor",
+          "type": "number",
+          "default": "1"
+        },
         {
           "name": "subscribe",
           "description": "The name of the channel to subscribe to. Only events on a channel corresponding\nto this property are listened to.",
@@ -12890,13 +13343,6 @@
         }
       ],
       "properties": [
-        {
-          "name": "icon",
-          "attribute": "icon",
-          "description": "The icon to use",
-          "type": "string",
-          "default": "\"icons:zoom-in\""
-        },
         {
           "name": "direction",
           "attribute": "direction",
@@ -12904,6 +13350,13 @@
           "type": "string",
           "default": "\"in\""
         },
+        {
+          "name": "zoomFactor",
+          "attribute": "zoom-factor",
+          "description": "The current zoom factor",
+          "type": "number",
+          "default": "1"
+        },
         {
           "name": "subscribe",
           "attribute": "subscribe",
@@ -12947,6 +13400,20 @@
           "name": "pb-zoom",
           "description": "sends an event for e.g. pb-views to react to"
         }
+      ],
+      "cssProperties": [
+        {
+          "name": "--pb-zoom-factor",
+          "description": "the zoom factor, e.g. 1.0 for normal size, 1.5 for 150%, 0.5 for 50%"
+        },
+        {
+          "name": "--pb-min-zoom",
+          "description": "the minimum zoom factor, e.g. 0.5 for 50%"
+        },
+        {
+          "name": "--pb-max-zoom",
+          "description": "the maximum zoom factor, e.g. 3.0 for 300%"
+        }
       ]
     },
     {