{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://kaltura.github.io/a2ui/v3/catalog.json",
  "protocolVersion": "1.0",
  "title": "Kaltura Experience Components Catalog",
  "description": "A2UI 1.0 catalog for Kaltura Experience Components: Player v7, Flashcards, Media Manager, and more. Lists the A2UI basic components and functions (copied from the A2UI basic catalog), the 12 Kaltura components and the Kaltura function copyToClipboard. A surface uses one catalog, so register only this one. Refs point at common_types.json, which ships next to this file.",
  "catalogId": "https://kaltura.github.io/a2ui/v3/catalog.json",
  "metadata": {
    "extensions": {
      "com_kaltura_adapters": {
        "description": "Where tier-1 A2UI clients can load the renderers backing this catalog's components. Served by jsDelivr from the git tags of github.com/kaltura/kaltura-a2ui-components. Not on npm.",
        "package": "@kaltura/a2ui-react",
        "repository": "https://github.com/kaltura/kaltura-a2ui-components",
        "react": {
          "description": "ESM bundle. React is an external peer. The host provides it. Register kalturaReactCatalog alone (see buildKalturaCatalog). It already holds the basic components. The module imports a second file, the SSR stub at stubCdn. Pin it with stubIntegrity too.",
          "format": "esm",
          "install": "npm i github:kaltura/kaltura-a2ui-components#v0.8.0",
          "cdn": "https://cdn.jsdelivr.net/gh/kaltura/kaltura-a2ui-components@v0.8.0/dist/kaltura-react.mjs",
          "integrity": "sha384-pbB2yAodmj3HWUbRG8llyZey4H+5KiYxyowU87vmam8VuFL6y1G4bCJhK8CTD3e1",
          "stubCdn": "https://cdn.jsdelivr.net/gh/kaltura/kaltura-a2ui-components@v0.8.0/dist/html-element-stub.mjs",
          "stubIntegrity": "sha384-Dc9GWtYTNZaNIJo5k7EAixYtSzJ8H7JOc1NqRGYwl9MTrZIQfkMkaRg+obwttiYp",
          "exports": ["kalturaReactCatalog", "buildKalturaCatalog", "loadKalturaCatalog", "kalturaComponentImpls", "kalturaClientFunctions"]
        },
        "webcomponent": {
          "description": "Self-contained IIFE (React inlined, CSS-in-JS). Drop in via <script> on plain-HTML hosts; registers all Kaltura custom elements on load. Verify with the integrity hash.",
          "format": "iife",
          "cdn": "https://cdn.jsdelivr.net/gh/kaltura/kaltura-a2ui-components@v0.8.0/dist/kaltura-wc.js",
          "integrity": "sha384-O0JhllBJfv06cUuHk1KjscZGs+dFpz4Ff/OpuWDc47ulmINZ60IE1+v1Cdo/ad7M",
          "crossorigin": "anonymous",
          "customElements": [
            "kaltura-player",
            "kaltura-flashcards",
            "kaltura-media-manager",
            "kaltura-analytics",
            "kaltura-captions-editor",
            "kaltura-recorder",
            "kaltura-avatar",
            "kaltura-genie-widget",
            "kaltura-content-lab",
            "kaltura-agents-widget",
            "kaltura-vod-avatar-wc",
            "kaltura-chart"
          ]
        }
      }
    }
  },
  "instructions": "1. Use one Kaltura component per user need. Do not rebuild a widget from basic components.\n2. Never invent IDs, URLs or keys. Take partnerId, uiconfId and entryId from the user, the host or earlier tool results.\n3. Media URLs must be on the host's allowed Kaltura domains. Anything else renders nothing.\n4. Never put a Kaltura Session (KS) in a message. The host adds it.\n5. Components that need a KS fail without a host-supplied KS. Say so to the user instead of retrying.\n6. To play a manual playlist use playlistId. Set exactly one of entryId and playlistId.\n7. Reply in plain text when the client does not list this catalog id.",
  "components": {
    "Text": {
      "type": "object",
      "properties": {
        "component": {
          "const": "Text"
        },
        "text": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "The text content to display. While simple Markdown formatting is supported (i.e. without HTML, images, or links), utilizing dedicated UI components is generally preferred for a richer and more structured presentation."
        },
        "variant": {
          "type": "string",
          "description": "A hint for the base text style.",
          "enum": [
            "caption",
            "body"
          ],
          "default": "body"
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "text"
      ]
    },
    "Image": {
      "type": "object",
      "properties": {
        "component": {
          "const": "Image"
        },
        "url": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "The URL of the image to display."
        },
        "description": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Accessibility text for the image."
        },
        "fit": {
          "type": "string",
          "description": "Specifies how the image should be resized to fit its container. This corresponds to the CSS 'object-fit' property.",
          "enum": [
            "contain",
            "cover",
            "fill",
            "none",
            "scaleDown"
          ],
          "default": "fill"
        },
        "variant": {
          "type": "string",
          "description": "A hint for the image size and style.",
          "enum": [
            "icon",
            "avatar",
            "smallFeature",
            "mediumFeature",
            "largeFeature",
            "header"
          ],
          "default": "mediumFeature"
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "url"
      ]
    },
    "Icon": {
      "type": "object",
      "properties": {
        "component": {
          "const": "Icon"
        },
        "name": {
          "description": "The name of the icon to display.",
          "oneOf": [
            {
              "type": "string",
              "enum": [
                "accountCircle",
                "add",
                "arrowBack",
                "arrowForward",
                "attachFile",
                "calendarToday",
                "call",
                "camera",
                "check",
                "close",
                "delete",
                "download",
                "edit",
                "event",
                "error",
                "fastForward",
                "favorite",
                "favoriteOff",
                "folder",
                "help",
                "home",
                "info",
                "locationOn",
                "lock",
                "lockOpen",
                "mail",
                "menu",
                "moreVert",
                "moreHoriz",
                "notificationsOff",
                "notifications",
                "pause",
                "payment",
                "person",
                "phone",
                "photo",
                "play",
                "print",
                "refresh",
                "rewind",
                "search",
                "send",
                "settings",
                "share",
                "shoppingCart",
                "skipNext",
                "skipPrevious",
                "star",
                "starHalf",
                "starOff",
                "stop",
                "upload",
                "visibility",
                "visibilityOff",
                "volumeDown",
                "volumeMute",
                "volumeOff",
                "volumeUp",
                "warning"
              ]
            },
            {
              "type": "object",
              "properties": {
                "svgPath": {
                  "$ref": "common_types.json#/$defs/DynamicString"
                }
              },
              "required": [
                "svgPath"
              ],
              "additionalProperties": false
            },
            {
              "$ref": "common_types.json#/$defs/DataBinding"
            }
          ]
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "name"
      ]
    },
    "Video": {
      "type": "object",
      "properties": {
        "component": {
          "const": "Video"
        },
        "url": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "The URL of the video to display."
        },
        "posterUrl": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "The URL of the poster image to display before the video plays."
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "url"
      ]
    },
    "AudioPlayer": {
      "type": "object",
      "properties": {
        "component": {
          "const": "AudioPlayer"
        },
        "url": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "The URL of the audio to be played."
        },
        "description": {
          "description": "A description of the audio, such as a title or summary.",
          "$ref": "common_types.json#/$defs/DynamicString"
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "url"
      ]
    },
    "Row": {
      "type": "object",
      "description": "A layout component that arranges its children horizontally. To create a grid layout, nest Columns within this Row.",
      "properties": {
        "component": {
          "const": "Row"
        },
        "children": {
          "description": "Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list. Children cannot be defined inline, they must be referred to by ID.",
          "$ref": "common_types.json#/$defs/ChildList"
        },
        "justify": {
          "type": "string",
          "description": "Defines the arrangement of children along the main axis (horizontally). Use 'spaceBetween' to push items to the edges, or 'start'/'end'/'center' to pack them together.",
          "enum": [
            "center",
            "end",
            "spaceAround",
            "spaceBetween",
            "spaceEvenly",
            "start",
            "stretch"
          ],
          "default": "start"
        },
        "align": {
          "type": "string",
          "description": "Defines the alignment of children along the cross axis (vertically). This is similar to the CSS 'align-items' property, but uses camelCase values (e.g., 'start').",
          "enum": [
            "start",
            "center",
            "end",
            "stretch"
          ],
          "default": "stretch"
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "children"
      ]
    },
    "Column": {
      "type": "object",
      "description": "A layout component that arranges its children vertically. To create a grid layout, nest Rows within this Column.",
      "properties": {
        "component": {
          "const": "Column"
        },
        "children": {
          "description": "Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list. Children cannot be defined inline, they must be referred to by ID.",
          "$ref": "common_types.json#/$defs/ChildList"
        },
        "justify": {
          "type": "string",
          "description": "Defines the arrangement of children along the main axis (vertically). Use 'spaceBetween' to push items to the edges (e.g. header at top, footer at bottom), or 'start'/'end'/'center' to pack them together.",
          "enum": [
            "start",
            "center",
            "end",
            "spaceBetween",
            "spaceAround",
            "spaceEvenly",
            "stretch"
          ],
          "default": "start"
        },
        "align": {
          "type": "string",
          "description": "Defines the alignment of children along the cross axis (horizontally). This is similar to the CSS 'align-items' property.",
          "enum": [
            "center",
            "end",
            "start",
            "stretch"
          ],
          "default": "stretch"
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "children"
      ]
    },
    "List": {
      "type": "object",
      "properties": {
        "component": {
          "const": "List"
        },
        "children": {
          "description": "Defines the children. Use an array of strings for a fixed set of children, or a template object to generate children from a data list.",
          "$ref": "common_types.json#/$defs/ChildList"
        },
        "direction": {
          "type": "string",
          "description": "The direction in which the list items are laid out.",
          "enum": [
            "vertical",
            "horizontal"
          ],
          "default": "vertical"
        },
        "align": {
          "type": "string",
          "description": "Defines the alignment of children along the cross axis.",
          "enum": [
            "start",
            "center",
            "end",
            "stretch"
          ],
          "default": "stretch"
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "children"
      ]
    },
    "Card": {
      "type": "object",
      "properties": {
        "component": {
          "const": "Card"
        },
        "child": {
          "$ref": "common_types.json#/$defs/Child",
          "description": "The ID of the single child component to be rendered inside the card. To display multiple elements, you MUST wrap them in a layout component (like Column or Row) and pass that container's ID here. Do NOT pass multiple IDs or a non-existent ID."
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "child"
      ]
    },
    "Tabs": {
      "type": "object",
      "properties": {
        "component": {
          "const": "Tabs"
        },
        "tabs": {
          "type": "array",
          "description": "An array of objects, where each object defines a tab with a title and a child component.",
          "minItems": 1,
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "description": "The tab title.",
                "$ref": "common_types.json#/$defs/DynamicString"
              },
              "child": {
                "$ref": "common_types.json#/$defs/Child",
                "description": "The ID of the child component."
              }
            },
            "required": [
              "title",
              "child"
            ],
            "additionalProperties": false
          }
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "tabs"
      ]
    },
    "Modal": {
      "type": "object",
      "properties": {
        "component": {
          "const": "Modal"
        },
        "trigger": {
          "$ref": "common_types.json#/$defs/Child",
          "description": "The ID of the component that opens the modal when interacted with (e.g., a button)."
        },
        "content": {
          "$ref": "common_types.json#/$defs/Child",
          "description": "The ID of the component to be displayed inside the modal."
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component",
        "trigger",
        "content"
      ]
    },
    "Divider": {
      "type": "object",
      "properties": {
        "component": {
          "const": "Divider"
        },
        "axis": {
          "type": "string",
          "description": "The orientation of the divider.",
          "enum": [
            "horizontal",
            "vertical"
          ],
          "default": "horizontal"
        },
        "weight": {
          "$ref": "#/$defs/Weight"
        }
      },
      "required": [
        "component"
      ]
    },
    "Button": {
      "type": "object",
      "allOf": [
        {
          "$ref": "common_types.json#/$defs/Checkable"
        },
        {
          "type": "object",
          "properties": {
            "component": {
              "const": "Button"
            },
            "child": {
              "$ref": "common_types.json#/$defs/Child",
              "description": "The ID of the child component. Use a 'Text' component for a labeled button. Only use an 'Icon' if the requirements explicitly ask for an icon-only button."
            },
            "variant": {
              "type": "string",
              "description": "A hint for the button style. If omitted, a default button style is used. 'primary' indicates this is the main call-to-action button. 'borderless' means the button has no visual border or background, making its child content appear like a clickable link.",
              "enum": [
                "default",
                "primary",
                "borderless"
              ],
              "default": "default"
            },
            "action": {
              "$ref": "common_types.json#/$defs/Action"
            },
            "weight": {
              "$ref": "#/$defs/Weight"
            }
          },
          "required": [
            "component",
            "child",
            "action"
          ]
        }
      ]
    },
    "TextField": {
      "type": "object",
      "allOf": [
        {
          "$ref": "common_types.json#/$defs/Checkable"
        },
        {
          "type": "object",
          "properties": {
            "component": {
              "const": "TextField"
            },
            "label": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "The text label for the input field."
            },
            "value": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "The value of the text field."
            },
            "placeholder": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "The placeholder text for the input field."
            },
            "variant": {
              "type": "string",
              "description": "The type of input field to display.",
              "enum": [
                "longText",
                "number",
                "shortText",
                "obscured"
              ],
              "default": "shortText"
            },
            "weight": {
              "$ref": "#/$defs/Weight"
            }
          },
          "required": [
            "component",
            "label"
          ]
        }
      ]
    },
    "CheckBox": {
      "type": "object",
      "allOf": [
        {
          "$ref": "common_types.json#/$defs/Checkable"
        },
        {
          "type": "object",
          "properties": {
            "component": {
              "const": "CheckBox"
            },
            "label": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "The text to display next to the checkbox."
            },
            "value": {
              "$ref": "common_types.json#/$defs/DynamicBoolean",
              "description": "The current state of the checkbox (true for checked, false for unchecked)."
            },
            "weight": {
              "$ref": "#/$defs/Weight"
            }
          },
          "required": [
            "component",
            "label",
            "value"
          ]
        }
      ]
    },
    "ChoicePicker": {
      "type": "object",
      "description": "A component that allows selecting one or more options from a list.",
      "allOf": [
        {
          "$ref": "common_types.json#/$defs/Checkable"
        },
        {
          "type": "object",
          "properties": {
            "component": {
              "const": "ChoicePicker"
            },
            "label": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "The label for the group of options."
            },
            "variant": {
              "type": "string",
              "description": "A hint for how the choice picker should be displayed and behave.",
              "enum": [
                "multipleSelection",
                "mutuallyExclusive"
              ],
              "default": "mutuallyExclusive"
            },
            "options": {
              "type": "array",
              "description": "The list of available options to choose from.",
              "items": {
                "type": "object",
                "properties": {
                  "label": {
                    "description": "The text to display for this option.",
                    "$ref": "common_types.json#/$defs/DynamicString"
                  },
                  "value": {
                    "type": "string",
                    "description": "The stable value associated with this option."
                  }
                },
                "required": [
                  "label",
                  "value"
                ],
                "additionalProperties": false
              }
            },
            "value": {
              "$ref": "common_types.json#/$defs/DynamicStringList",
              "description": "The list of currently selected values. This should be bound to a string array in the data model."
            },
            "displayStyle": {
              "type": "string",
              "description": "The display style of the component.",
              "enum": [
                "checkbox",
                "chips"
              ],
              "default": "checkbox"
            },
            "filterable": {
              "type": "boolean",
              "description": "If true, displays a search input to filter the options.",
              "default": false
            },
            "weight": {
              "$ref": "#/$defs/Weight"
            }
          },
          "required": [
            "component",
            "options",
            "value"
          ]
        }
      ]
    },
    "Slider": {
      "type": "object",
      "allOf": [
        {
          "$ref": "common_types.json#/$defs/Checkable"
        },
        {
          "type": "object",
          "properties": {
            "component": {
              "const": "Slider"
            },
            "label": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "The label for the slider."
            },
            "min": {
              "type": "number",
              "description": "The minimum value of the slider.",
              "default": 0
            },
            "max": {
              "type": "number",
              "description": "The maximum value of the slider."
            },
            "value": {
              "$ref": "common_types.json#/$defs/DynamicNumber",
              "description": "The current value of the slider."
            },
            "steps": {
              "type": "integer",
              "minimum": 1,
              "description": "The number of discrete divisions in the slider range. If specified, the slider will snap to discrete values."
            },
            "weight": {
              "$ref": "#/$defs/Weight"
            }
          },
          "required": [
            "component",
            "value",
            "max"
          ]
        }
      ]
    },
    "DateTimeInput": {
      "type": "object",
      "allOf": [
        {
          "$ref": "common_types.json#/$defs/Checkable"
        },
        {
          "type": "object",
          "properties": {
            "component": {
              "const": "DateTimeInput"
            },
            "value": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "The selected date and/or time value in ISO 8601 format. If not yet set, initialize with an empty string."
            },
            "enableDate": {
              "type": "boolean",
              "description": "If true, allows the user to select a date.",
              "default": false
            },
            "enableTime": {
              "type": "boolean",
              "description": "If true, allows the user to select a time.",
              "default": false
            },
            "min": {
              "allOf": [
                {
                  "$ref": "common_types.json#/$defs/DynamicString"
                },
                {
                  "if": {
                    "type": "string"
                  },
                  "then": {
                    "oneOf": [
                      {
                        "format": "date"
                      },
                      {
                        "format": "time"
                      },
                      {
                        "format": "date-time"
                      }
                    ]
                  }
                }
              ],
              "description": "The minimum allowed date/time in ISO 8601 format."
            },
            "max": {
              "allOf": [
                {
                  "$ref": "common_types.json#/$defs/DynamicString"
                },
                {
                  "if": {
                    "type": "string"
                  },
                  "then": {
                    "oneOf": [
                      {
                        "format": "date"
                      },
                      {
                        "format": "time"
                      },
                      {
                        "format": "date-time"
                      }
                    ]
                  }
                }
              ],
              "description": "The maximum allowed date/time in ISO 8601 format."
            },
            "label": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "The text label for the input field."
            },
            "weight": {
              "$ref": "#/$defs/Weight"
            }
          },
          "required": [
            "component",
            "value"
          ]
        }
      ]
    },
    "KalturaPlayer": {
      "type": "object",
      "description": "Plays one entry or one manual playlist with the player (uiConf) the host allows.",
      "properties": {
        "component": { "const": "KalturaPlayer" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Integer, not a string, not a binding."
        },
        "uiconfId": {
          "type": "integer",
          "description": "Player (uiConf) ID. Integer, not a string, not a binding."
        },
        "entryId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Entry to play, a string like '0_abc123'. Set exactly one of entryId and playlistId."
        },
        "playlistId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Manual playlist to play, a string like '1_abc123'. Set exactly one of entryId and playlistId. startTime, clipFrom and clipTo do not apply to a playlist."
        },
        "autoplay": {
          "$ref": "common_types.json#/$defs/DynamicBoolean",
          "description": "Auto-start playback. Requires muted=true per browser policy. Default: false.",
          "default": false
        },
        "muted": {
          "$ref": "common_types.json#/$defs/DynamicBoolean",
          "description": "Start muted. Must be true when autoplay is true. Default: false.",
          "default": false
        },
        "startTime": {
          "$ref": "common_types.json#/$defs/DynamicNumber",
          "description": "Start playback at this position (seconds). The whole entry stays available and the timeline shows its full length. Use it for 'start at 30 seconds'. With clipFrom, it counts from the clip start."
        },
        "clipFrom": {
          "$ref": "common_types.json#/$defs/DynamicNumber",
          "description": "Cut the video so it starts at this position (seconds). The timeline starts at 0 and ends at the clip length. Use it with clipTo to show only a segment, such as the part a flashcard came from. Works only for entries with an HLS or DASH stream."
        },
        "clipTo": {
          "$ref": "common_types.json#/$defs/DynamicNumber",
          "description": "Cut the video so it ends at this position (seconds). The timeline ends there, or at the clip length when clipFrom is set."
        },
        "aspectRatio": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Container aspect ratio (e.g. '16/9', '4/3'). Default: '16/9'.",
          "default": "16/9"
        },
        "entryName": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional entry name shown in the player title."
        },
        "entryDescription": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional entry description shown under the player. HTML tags are stripped."
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        }
      },
      "required": ["component", "partnerId", "uiconfId"]
    },
    "KalturaFlashcards": {
      "type": "object",
      "description": "A deck of study cards. Each card can have video clips. The cards are literal: to change them, send the component again.",
      "properties": {
        "component": { "const": "KalturaFlashcards" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Needed to play the clips. Integer, not a string, not a binding."
        },
        "uiconfId": {
          "type": "integer",
          "description": "Player (uiConf) ID used to play the clips. Integer, not a string, not a binding."
        },
        "title": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Title of the flashcard deck."
        },
        "summary": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Brief summary or description of the flashcard deck."
        },
        "cards": {
          "type": "array",
          "description": "Ordered list of cards. Literal only, no data binding: to change the cards, send the component again. When the host app supplies the KS, the clips of all cards name at most 20 different entries. More makes the whole deck fail.",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "$ref": "common_types.json#/$defs/DynamicString",
                "description": "Card title (front of card)."
              },
              "subtitle": {
                "$ref": "common_types.json#/$defs/DynamicString",
                "description": "Optional subtitle or category label."
              },
              "content": {
                "$ref": "common_types.json#/$defs/DynamicString",
                "description": "Markdown body content (back of card)."
              },
              "clips": {
                "type": "array",
                "description": "Video clips relevant to this card.",
                "items": {
                  "type": "object",
                  "properties": {
                    "entryId": {
                      "type": "string",
                      "description": "Kaltura media entry ID."
                    },
                    "startTime": {
                      "type": "number",
                      "description": "Clip start time in seconds. The player plays only the segment, and its timeline runs from 0 to the clip length. A progressive-only entry (no HLS or DASH stream) is cut at the end only."
                    },
                    "endTime": {
                      "type": "number",
                      "description": "Clip end time in seconds. Use the segment of the video the card came from."
                    },
                    "title": { "type": "string", "description": "Optional clip title." },
                    "thumbnail": {
                      "type": "string",
                      "description": "Optional thumbnail URL for the clip."
                    }
                  },
                  "required": ["entryId", "startTime", "endTime"],
                  "additionalProperties": false
                }
              }
            },
            "required": ["title", "content"],
            "additionalProperties": false
          }
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        }
      },
      "required": ["component", "title", "cards"]
    },
    "KalturaMediaManager": {
      "type": "object",
      "description": "Library browser for the account's media. In 'select' mode the user picks entries and the action gets their IDs. 'manage' mode also lets the user edit them.",
      "properties": {
        "component": { "const": "KalturaMediaManager" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Integer, not a string, not a binding."
        },
        "serverUrl": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional. Leave it out to use the Unisphere host of the app's region. Otherwise a Kaltura Unisphere URL (e.g. 'https://unisphere.nvp1.ovp.kaltura.com/v1'). Only Kaltura hosts are accepted (regions nvp1, irp2, frp2, cap2, syp2). Other hosts are refused."
        },
        "theme": {
          "type": "string",
          "enum": ["dark", "light"],
          "description": "UI theme mode. Default: the page theme (data-theme, an a2ui-dark or a2ui-light class, then the system setting)."
        },
        "mode": {
          "type": "string",
          "enum": ["select", "manage"],
          "description": "Interaction mode. 'select' shows the select button. 'manage' hides it. What the user can change comes from the KS role. Default: 'select'.",
          "default": "select"
        },
        "multiSelect": {
          "type": "boolean",
          "description": "Allow picking up to 5 entries. Default: false.",
          "default": false
        },
        "contextId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "ID of the content scope (e.g. category ID to browse). Digits only, up to 12."
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        }
      },
      "required": ["component", "partnerId"]
    },
    "KalturaAnalytics": {
      "type": "object",
      "description": "Kaltura Analytics: shows one view of the analytics app, for a media entry, category, playlist, virtual event or report type, over a date range. The host supplies the Kaltura Session, so there is no ks prop.",
      "properties": {
        "component": { "const": "KalturaAnalytics" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Integer, not a string, not a binding."
        },
        "entryId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional media entry ID. Shows the analytics of that entry. Wins over reportType. Use at most one of entryId, categoryId, playlistId and virtualEventId."
        },
        "categoryId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional category ID (digits only, up to 12). Shows the analytics of that category. Wins over reportType."
        },
        "playlistId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional playlist ID. Shows the analytics of that playlist. Wins over reportType."
        },
        "virtualEventId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional virtual event ID (digits only, up to 12). Shows the analytics of that virtual event. Wins over reportType."
        },
        "reportType": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Dashboard view for the whole account. It is ignored when entryId, categoryId, playlistId or virtualEventId is set, so leave those out to switch views. One of: engagement (plays, watch time, drop-off), content-interactions (clicks, hotspots, polls, calls to action), technology (devices, browsers, operating systems), geo-location (countries and regions), contributors (who uploads), overview (account summary, storage, bandwidth and usage), publisher, enduser or live (live streaming). Default: engagement."
        },
        "fromDate": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Start of the date range, as YYYY-MM-DD. Needs toDate. Default range: the last 30 days."
        },
        "toDate": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "End of the date range, as YYYY-MM-DD. Needs fromDate."
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        }
      },
      "required": ["component", "partnerId"]
    },
    "KalturaCaptionsEditor": {
      "type": "object",
      "description": "Kaltura Captions editor: edits the captions of one media entry.",
      "properties": {
        "component": { "const": "KalturaCaptionsEditor" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Integer, not a string, not a binding."
        },
        "entryId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Media entry ID whose captions to edit."
        },
        "assetId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional. Caption asset ID to open, a string like '1_abc123'. It must belong to the entry. Leave it out to let the editor pick."
        },
        "uiconfId": {
          "type": "integer",
          "description": "Optional. uiConf ID of the editor's own player. Integer, not a string, not a binding."
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        }
      },
      "required": ["component", "partnerId", "entryId"]
    },
    "KalturaRecorder": {
      "type": "object",
      "description": "Kaltura Recorder: records webcam, audio or screen in the browser and uploads the recording to the account as a new entry.",
      "properties": {
        "component": { "const": "KalturaRecorder" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Integer, not a string, not a binding."
        },
        "uiconfId": {
          "type": "integer",
          "description": "Player (uiConf) ID. The recorder uses it to load the player for the recorded entry. Integer, not a string, not a binding."
        },
        "entryName": {
          "type": "string",
          "maxLength": 256,
          "description": "Name for the new entry. Plain text."
        },
        "allowVideo": {
          "type": "boolean",
          "description": "Allow webcam video recording."
        },
        "allowAudio": {
          "type": "boolean",
          "description": "Allow audio-only recording."
        },
        "allowScreenShare": {
          "type": "boolean",
          "description": "Allow screen recording."
        },
        "maxRecordingTime": {
          "type": "integer",
          "description": "Longest recording in seconds. At most 86400."
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        },
        "orientation": {
          "type": "string",
          "enum": ["portrait", "landscape"],
          "description": "Optional. Fixes the capture orientation and hides the user's control. Use portrait for vertical video. Leave it out to let the user choose."
        },
        "prompterText": { "type": "string", "maxLength": 27000, "description": "Optional. A script that opens in the recorder's teleprompter. The user can edit it. Never invent one." }
      },
      "required": ["component", "partnerId", "uiconfId"]
    },
    "KalturaAvatar": {
      "type": "object",
      "description": "Kaltura Avatar: a live conversational AI agent with a video avatar, voice and captions, loaded through the Unisphere embeds API. The host's Kaltura Session picks the agent, so there is no agent or avatar ID prop. The browser asks the user for the microphone when a session starts.",
      "properties": {
        "component": { "const": "KalturaAvatar" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Integer, not a string, not a binding."
        },
        "serverUrl": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional. Leave it out to use the Unisphere host of the app's region. Otherwise a Kaltura Unisphere URL (e.g. 'https://unisphere.nvp1.ovp.kaltura.com/v1'). Only Kaltura hosts are accepted (regions nvp1, irp2, frp2, cap2, syp2). Other hosts are refused."
        },
        "autoConnect": {
          "type": "boolean",
          "description": "Start the session as soon as the avatar loads. Default: false, the user clicks to start."
        },
        "openingPhrase": {
          "type": "string",
          "description": "What the agent says first. Plain text. Default: the agent's own greeting.",
          "maxLength": 500
        },
        "captions": {
          "type": "boolean",
          "description": "Show captions of what the agent says. Default: the agent's setting."
        },
        "theme": {
          "type": "string",
          "enum": ["light", "dark", "studio"],
          "description": "Colour theme. Default: the page theme (data-theme, an a2ui-dark or a2ui-light class, then the system setting)."
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        }
      },
      "required": ["component", "partnerId"]
    },
    "KalturaGenie": {
      "type": "object",
      "description": "Kaltura Genie: AI search and Q&A over the account's video content.",
      "properties": {
        "component": { "const": "KalturaGenie" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Integer, not a string, not a binding."
        },
        "serverUrl": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional. Leave it out to use the Unisphere host of the app's region. Otherwise a Kaltura Unisphere URL (e.g. 'https://unisphere.nvp1.ovp.kaltura.com/v1'). Only Kaltura hosts are accepted (regions nvp1, irp2, frp2, cap2, syp2). Other hosts are refused."
        },
        "categoryId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional category ID (digits only, up to 12) to scope the Genie content context."
        },
        "language": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "UI language code, for example 'de'. Default: English."
        },
        "uiconfId": {
          "type": "integer",
          "description": "Optional and ignored. Genie no longer needs a player ID. Integer, not a string, not a binding."
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        }
      },
      "required": ["component", "partnerId"]
    },
    "KalturaContentLab": {
      "type": "object",
      "description": "Kaltura Content Lab: AI studio that creates and enriches content for one media entry.",
      "properties": {
        "component": { "const": "KalturaContentLab" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Integer, not a string, not a binding."
        },
        "serverUrl": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional. Leave it out to use the Unisphere host of the app's region. Otherwise a Kaltura Unisphere URL (e.g. 'https://unisphere.nvp1.ovp.kaltura.com/v1'). Only Kaltura hosts are accepted (regions nvp1, irp2, frp2, cap2, syp2). Other hosts are refused."
        },
        "entryId": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Media entry ID that Content Lab opens."
        },
        "uiconfId": {
          "type": "integer",
          "description": "Player (uiConf) ID for the video preview. Integer, not a string, not a binding."
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        }
      },
      "required": ["component", "partnerId", "uiconfId", "entryId"]
    },
    "KalturaAgentsWidget": {
      "type": "object",
      "description": "Kaltura AI Agents: the account's AI agents interface.",
      "properties": {
        "component": { "const": "KalturaAgentsWidget" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Integer, not a string, not a binding."
        },
        "serverUrl": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional. Leave it out to use the Unisphere host of the app's region. Otherwise a Kaltura Unisphere URL (e.g. 'https://unisphere.nvp1.ovp.kaltura.com/v1'). Only Kaltura hosts are accepted (regions nvp1, irp2, frp2, cap2, syp2). Other hosts are refused."
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        }
      },
      "required": ["component", "partnerId"]
    },
    "KalturaVodAvatar": {
      "type": "object",
      "description": "Kaltura VOD Avatar: the avatar video studio.",
      "properties": {
        "component": { "const": "KalturaVodAvatar" },
        "partnerId": {
          "type": "integer",
          "description": "Kaltura partner (account) ID. Integer, not a string, not a binding."
        },
        "serverUrl": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Optional. Leave it out to use the Unisphere host of the app's region. Otherwise a Kaltura Unisphere URL (e.g. 'https://unisphere.nvp1.ovp.kaltura.com/v1'). Only Kaltura hosts are accepted (regions nvp1, irp2, frp2, cap2, syp2). Other hosts are refused."
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." },
        "region": {
          "type": "string",
          "description": "Optional. The Kaltura region of this widget's account: nvp1 (US), irp2 (EU), frp2 (DE), cap2 (CA), syp2 (AP), sgp2 (SG), or a name the host app defined. Leave it out to use the app's region. Lowercase letters, digits and hyphens. A region the host app does not allow is refused. sgp2 has no Unisphere host, so Genie, Media Manager, Content Lab, Agents Widget, VOD Avatar, Avatar and Captions Editor refuse it. With serverUrl, both must name the same region."
        },
        "initialView": {
          "type": "string",
          "enum": ["videoLibrary", "editVideo", "projectBuilder"],
          "description": "Optional. The first screen: 'videoLibrary' (default), 'editVideo' or 'projectBuilder' (the new-video menu)."
        },
        "additionalEsearchFilters": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "fieldName": {
                "type": "string",
                "description": "KalturaESearchEntryFieldName value, such as 'name'."
              },
              "itemType": {
                "type": "integer",
                "description": "KalturaESearchItemType number: 1 exactMatch, 2 partial, 3 startsWith, 4 exists, 5 range."
              },
              "searchTerm": {
                "type": ["string", "number"],
                "description": "The value to match."
              }
            },
            "required": ["fieldName", "itemType", "searchTerm"],
            "additionalProperties": false
          },
          "description": "Optional. Extra eSearch conditions for the entry picker of the new-video flow. They are ANDed with the built-in ones."
        }
      },
      "required": ["component", "partnerId"]
    },
    "KalturaChart": {
      "type": "object",
      "description": "Kaltura Chart: 12 chart types (line, bar, area, pie, scatter, geo, wordcloud, treemap, heatmap, radar, sankey, funnel). The data is literal: to update the chart, send the component again.",
      "properties": {
        "component": { "const": "KalturaChart" },
        "chartType": {
          "type": "string",
          "enum": ["line", "bar", "area", "pie", "scatter", "geo", "wordcloud", "treemap", "heatmap", "radar", "sankey", "funnel"],
          "description": "Chart type. It sets how rows are read. line, bar, area, scatter, radar: xKey is the category, yKeys are the numeric series. pie, treemap, funnel, wordcloud, geo: yKeys[0] is the value, and rows with a value of 0 or less are dropped (wordcloud draws the top 80). geo: xKey is a country name or an ISO alpha-2 code. sankey: one row per link, xKey is the source and yKeys is [target, value]. heatmap: one row per cell, xKey is the column and yKeys is [value, row]."
        },
        "data": {
          "type": "array",
          "items": { "type": "object" },
          "description": "Rows to draw, as objects. Literal only, no data binding: to update the chart, send the component again. At most 500 rows are drawn. Row shape depends on chartType."
        },
        "sourceData": {
          "type": "array",
          "items": { "type": "object" },
          "description": "Full dataset for table/export view when chart shows a summary subset."
        },
        "title": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Chart title displayed above the visualization."
        },
        "xKey": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Key of the x-axis or category value in each row. Default: 'name' (pie), 'text' (wordcloud), 'country' (geo), 'source' (sankey), else the first key with a non-number value."
        },
        "yKeys": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Keys of the value series. Default: every key except xKey. For pie, treemap, funnel, wordcloud, geo, sankey and heatmap the order matters. See chartType."
        },
        "yLabels": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Human-readable labels for the yKeys series (legend labels)."
        },
        "xLabel": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Label for the x-axis."
        },
        "yLabel": {
          "$ref": "common_types.json#/$defs/DynamicString",
          "description": "Label for the y-axis."
        },
        "colors": {
          "type": "array",
          "items": { "type": "string", "maxLength": 64 },
          "description": "Optional color overrides for chart series (hex or CSS color strings)."
        },
        "height": {
          "$ref": "common_types.json#/$defs/DynamicNumber",
          "description": "Chart height in pixels. Default: 300."
        },
        "annotations": {
          "type": "array",
          "description": "Vertical annotation markers on cartesian charts (line, bar, area, scatter).",
          "items": {
            "type": "object",
            "properties": {
              "x": {
                "type": ["string", "number"],
                "description": "x-axis value to annotate."
              },
              "label": {
                "type": "string",
                "description": "Annotation label text."
              },
              "color": {
                "type": "string",
                "maxLength": 64,
                "description": "Annotation color (hex or CSS). Default: accent color."
              }
            },
            "required": ["x", "label"],
            "additionalProperties": false
          }
        },
        "action": { "$ref": "common_types.json#/$defs/Action", "description": "Optional. Tells the agent about this widget's errors and events, with fixed fields only (never the KS or remote text)." }
      },
      "required": ["component", "chartType", "data"]
    }
  },
  "functions": {
    "required": {
      "type": "object",
      "description": "Checks that the value is not null, undefined, or empty.",
      "returnType": "validationResult",
      "properties": {
        "@call": {
          "const": "required"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "description": "The value to check."
            }
          },
          "required": [
            "value"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "regex": {
      "type": "object",
      "description": "Checks that the value matches a regular expression string.",
      "returnType": "validationResult",
      "properties": {
        "@call": {
          "const": "regex"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "common_types.json#/$defs/DynamicString"
            },
            "pattern": {
              "type": "string",
              "description": "The regex pattern to match against."
            }
          },
          "required": [
            "value",
            "pattern"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "length": {
      "type": "object",
      "description": "Checks string length constraints.",
      "returnType": "validationResult",
      "properties": {
        "@call": {
          "const": "length"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "common_types.json#/$defs/DynamicString"
            },
            "min": {
              "type": "integer",
              "minimum": 0,
              "description": "The minimum allowed length."
            },
            "max": {
              "type": "integer",
              "minimum": 0,
              "description": "The maximum allowed length."
            }
          },
          "required": [
            "value"
          ],
          "anyOf": [
            {
              "required": [
                "min"
              ]
            },
            {
              "required": [
                "max"
              ]
            }
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "numeric": {
      "type": "object",
      "description": "Checks numeric range constraints.",
      "returnType": "validationResult",
      "properties": {
        "@call": {
          "const": "numeric"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "common_types.json#/$defs/DynamicNumber"
            },
            "min": {
              "type": "number",
              "description": "The minimum allowed value."
            },
            "max": {
              "type": "number",
              "description": "The maximum allowed value."
            }
          },
          "required": [
            "value"
          ],
          "anyOf": [
            {
              "required": [
                "min"
              ]
            },
            {
              "required": [
                "max"
              ]
            }
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "email": {
      "type": "object",
      "description": "Checks that the value is a valid email address.",
      "returnType": "validationResult",
      "properties": {
        "@call": {
          "const": "email"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "common_types.json#/$defs/DynamicString"
            }
          },
          "required": [
            "value"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "formatString": {
      "type": "object",
      "description": "Performs string interpolation of data model values and other functions in the catalog functions list and returns the resulting string. The value string can contain interpolated expressions in the `${expression}` format. Supported expression types include: JSON Pointer paths to the data model (e.g., `${/absolute/path}` or `${relative/path}`), and renderer-side function calls (e.g., `${now()}`). Function arguments must be named (e.g., `${formatDate(value:${/currentDate}, format:'MM-dd')}`). To include a literal `${` sequence, escape it as `\\${`.",
      "returnType": "string",
      "properties": {
        "@call": {
          "const": "formatString"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "common_types.json#/$defs/DynamicString"
            }
          },
          "required": [
            "value"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "formatNumber": {
      "type": "object",
      "description": "Formats a number with the specified grouping and decimal precision.",
      "returnType": "string",
      "properties": {
        "@call": {
          "const": "formatNumber"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "common_types.json#/$defs/DynamicNumber",
              "description": "The number to format."
            },
            "decimals": {
              "$ref": "common_types.json#/$defs/DynamicNumber",
              "description": "Optional. The number of decimal places to show. Defaults to 0 or 2 depending on locale."
            },
            "grouping": {
              "$ref": "common_types.json#/$defs/DynamicBoolean",
              "description": "Optional. If true, uses locale-specific grouping separators (e.g. '1,000'). If false, returns raw digits (e.g. '1000'). Defaults to true."
            }
          },
          "required": [
            "value"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "formatCurrency": {
      "type": "object",
      "description": "Formats a number as a currency string.",
      "returnType": "string",
      "properties": {
        "@call": {
          "const": "formatCurrency"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "common_types.json#/$defs/DynamicNumber",
              "description": "The monetary amount."
            },
            "currency": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "The ISO 4217 currency code (e.g., 'USD', 'EUR')."
            },
            "decimals": {
              "$ref": "common_types.json#/$defs/DynamicNumber",
              "description": "Optional. The number of decimal places to show. Defaults to 0 or 2 depending on locale."
            },
            "grouping": {
              "$ref": "common_types.json#/$defs/DynamicBoolean",
              "description": "Optional. If true, uses locale-specific grouping separators (e.g. '1,000'). If false, returns raw digits (e.g. '1000'). Defaults to true."
            }
          },
          "required": [
            "currency",
            "value"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "formatDate": {
      "type": "object",
      "description": "Formats a timestamp into a string using a pattern.",
      "returnType": "string",
      "properties": {
        "@call": {
          "const": "formatDate"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "common_types.json#/$defs/DynamicValue",
              "description": "The date to format."
            },
            "format": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "A Unicode TR35 date pattern string.\n\nToken Reference:\n- Year: 'yy' (26), 'yyyy' (2026)\n- Month: 'M' (1), 'MM' (01), 'MMM' (Jan), 'MMMM' (January)\n- Day: 'd' (1), 'dd' (01), 'E' (Tue), 'EEEE' (Tuesday)\n- Hour (12h): 'h' (1-12), 'hh' (01-12) - requires 'a' for AM/PM\n- Hour (24h): 'H' (0-23), 'HH' (00-23) - Military Time\n- Minute: 'mm' (00-59)\n- Second: 'ss' (00-59)\n- Period: 'a' (AM/PM)\n\nExamples:\n- 'MMM dd, yyyy' -> 'Jan 16, 2026'\n- 'HH:mm' -> '14:30' (Military)\n- 'h:mm a' -> '2:30 PM'\n- 'EEEE, d MMMM' -> 'Friday, 16 January'"
            }
          },
          "required": [
            "format",
            "value"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "pluralize": {
      "type": "object",
      "description": "Returns a localized string based on the Common Locale Data Repository (CLDR) plural category of the count (zero, one, two, few, many, other). Requires an 'other' fallback. For English, just use 'one' and 'other'.",
      "returnType": "string",
      "properties": {
        "@call": {
          "const": "pluralize"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "common_types.json#/$defs/DynamicNumber",
              "description": "The numeric value used to determine the plural category."
            },
            "zero": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "String for the 'zero' category (e.g., 0 items)."
            },
            "one": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "String for the 'one' category (e.g., 1 item)."
            },
            "two": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "String for the 'two' category (used in Arabic, Welsh, etc.)."
            },
            "few": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "String for the 'few' category (e.g., small groups in Slavic languages)."
            },
            "many": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "String for the 'many' category (e.g., large groups in various languages)."
            },
            "other": {
              "$ref": "common_types.json#/$defs/DynamicString",
              "description": "The default/fallback string (used for general plural cases)."
            }
          },
          "required": [
            "value",
            "other"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "openUrl": {
      "type": "object",
      "description": "Opens the specified URL in a browser or handler (requires user activation). This function has no return value.",
      "returnType": "void",
      "requiresUserActivation": true,
      "properties": {
        "@call": {
          "const": "openUrl"
        },
        "args": {
          "type": "object",
          "properties": {
            "url": {
              "description": "The URL to open.",
              "oneOf": [
                {
                  "type": "string",
                  "format": "uri"
                },
                {
                  "$ref": "common_types.json#/$defs/DataBinding"
                },
                {
                  "$ref": "common_types.json#/$defs/FunctionCall"
                }
              ]
            }
          },
          "required": [
            "url"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "and": {
      "type": "object",
      "description": "Performs a logical AND operation on a list of boolean values.",
      "returnType": "boolean",
      "properties": {
        "@call": {
          "const": "and"
        },
        "args": {
          "type": "object",
          "properties": {
            "values": {
              "type": "array",
              "description": "The list of boolean values to evaluate.",
              "items": {
                "$ref": "common_types.json#/$defs/DynamicBoolean"
              },
              "minItems": 2
            }
          },
          "required": [
            "values"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "or": {
      "type": "object",
      "description": "Performs a logical OR operation on a list of boolean values.",
      "returnType": "boolean",
      "properties": {
        "@call": {
          "const": "or"
        },
        "args": {
          "type": "object",
          "properties": {
            "values": {
              "type": "array",
              "description": "The list of boolean values to evaluate.",
              "items": {
                "$ref": "common_types.json#/$defs/DynamicBoolean"
              },
              "minItems": 2
            }
          },
          "required": [
            "values"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "not": {
      "type": "object",
      "description": "Performs a logical NOT operation on a boolean value.",
      "returnType": "boolean",
      "properties": {
        "@call": {
          "const": "not"
        },
        "args": {
          "type": "object",
          "properties": {
            "value": {
              "$ref": "common_types.json#/$defs/DynamicBoolean",
              "description": "The boolean value to negate."
            }
          },
          "required": [
            "value"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    },
    "copyToClipboard": {
      "type": "object",
      "description": "Copies the text to the clipboard. Does nothing for empty text. This function has no return value.",
      "returnType": "void",
      "allowedCallers": "rendererOnly",
      "requiresUserActivation": true,
      "properties": {
        "@call": {
          "const": "copyToClipboard"
        },
        "args": {
          "type": "object",
          "properties": {
            "text": {
              "type": "string",
              "description": "The text to copy to the clipboard."
            }
          },
          "required": [
            "text"
          ],
          "unevaluatedProperties": false
        }
      },
      "required": [
        "@call",
        "args"
      ]
    }
  },
  "$defs": {
    "anyComponent": {
      "oneOf": [
        {
          "$ref": "#/components/Text"
        },
        {
          "$ref": "#/components/Image"
        },
        {
          "$ref": "#/components/Icon"
        },
        {
          "$ref": "#/components/Video"
        },
        {
          "$ref": "#/components/AudioPlayer"
        },
        {
          "$ref": "#/components/Row"
        },
        {
          "$ref": "#/components/Column"
        },
        {
          "$ref": "#/components/List"
        },
        {
          "$ref": "#/components/Card"
        },
        {
          "$ref": "#/components/Tabs"
        },
        {
          "$ref": "#/components/Modal"
        },
        {
          "$ref": "#/components/Divider"
        },
        {
          "$ref": "#/components/Button"
        },
        {
          "$ref": "#/components/TextField"
        },
        {
          "$ref": "#/components/CheckBox"
        },
        {
          "$ref": "#/components/ChoicePicker"
        },
        {
          "$ref": "#/components/Slider"
        },
        {
          "$ref": "#/components/DateTimeInput"
        },
        {
          "$ref": "#/components/KalturaPlayer"
        },
        {
          "$ref": "#/components/KalturaFlashcards"
        },
        {
          "$ref": "#/components/KalturaMediaManager"
        },
        {
          "$ref": "#/components/KalturaAnalytics"
        },
        {
          "$ref": "#/components/KalturaCaptionsEditor"
        },
        {
          "$ref": "#/components/KalturaRecorder"
        },
        {
          "$ref": "#/components/KalturaAvatar"
        },
        {
          "$ref": "#/components/KalturaGenie"
        },
        {
          "$ref": "#/components/KalturaContentLab"
        },
        {
          "$ref": "#/components/KalturaAgentsWidget"
        },
        {
          "$ref": "#/components/KalturaVodAvatar"
        },
        {
          "$ref": "#/components/KalturaChart"
        }
      ],
      "discriminator": {
        "propertyName": "component"
      }
    },
    "anyFunction": {
      "oneOf": [
        {
          "$ref": "#/functions/required"
        },
        {
          "$ref": "#/functions/regex"
        },
        {
          "$ref": "#/functions/length"
        },
        {
          "$ref": "#/functions/numeric"
        },
        {
          "$ref": "#/functions/email"
        },
        {
          "$ref": "#/functions/formatString"
        },
        {
          "$ref": "#/functions/formatNumber"
        },
        {
          "$ref": "#/functions/formatCurrency"
        },
        {
          "$ref": "#/functions/formatDate"
        },
        {
          "$ref": "#/functions/pluralize"
        },
        {
          "$ref": "#/functions/openUrl"
        },
        {
          "$ref": "#/functions/and"
        },
        {
          "$ref": "#/functions/or"
        },
        {
          "$ref": "#/functions/not"
        },
        {
          "$ref": "#/functions/copyToClipboard"
        }
      ]
    },
    "Weight": {
      "type": "number",
      "description": "The relative weight of this component within a Row or Column. This is similar to the CSS 'flex-grow' property. Note: this may ONLY be set when the component is a direct descendant of a Row or Column."
    }
  }
}
