Update to Beautiful.ai

{
  "description": "Model reference for Beautiful.ai slides, one document per slide element - the fields each template's root element and its nested elements expect in states[0], allowed values, limits and pitfalls. Use when building or editing a slide model for create_slide or update_slide, before rendering it with render_slide.",
  "included_files": [
    {
      "relative_path": "elements/ActionNumber.md",
      "size_in_bytes": 6120
    },
    {
      "relative_path": "elements/Agenda.md",
      "size_in_bytes": 5214
    },
    {
      "relative_path": "elements/ArrowBars.md",
      "size_in_bytes": 4558
    },
    {
      "relative_path": "elements/AuthoringCanvas.md",
      "size_in_bytes": 7738
    },
    {
      "relative_path": "elements/AuthoringContentElement.md",
      "size_in_bytes": 6278
    },
    {
      "relative_path": "elements/AuthoringElementContainer.md",
      "size_in_bytes": 11654
    },
    {
      "relative_path": "elements/AuthoringPathElement.md",
      "size_in_bytes": 5285
    },
    {
      "relative_path": "elements/AuthoringRadialBar.md",
      "size_in_bytes": 2993
    },
    {
      "relative_path": "elements/AuthoringShapeElement.md",
      "size_in_bytes": 15051
    },
    {
      "relative_path": "elements/AuthoringSvgElement.md",
      "size_in_bytes": 3066
    },
    {
      "relative_path": "elements/AuthoringVideo.md",
      "size_in_bytes": 4240
    },
    {
      "relative_path": "elements/BaseElement.md",
      "size_in_bytes": 6817
    },
    {
      "relative_path": "elements/BigNumbers.md",
      "size_in_bytes": 8085
    },
    {
      "relative_path": "elements/BottomTray.md",
      "size_in_bytes": 10119
    },
    {
      "relative_path": "elements/Calendar.md",
      "size_in_bytes": 8204
    },
    {
      "relative_path": "elements/CalloutElement.md",
      "size_in_bytes": 13029
    },
    {
      "relative_path": "elements/CalloutsCanvas.md",
      "size_in_bytes": 12498
    },
    {
      "relative_path": "elements/CanvasBackground.md",
      "size_in_bytes": 8030
    },
    {
      "relative_path": "elements/Chart.md",
      "size_in_bytes": 17729
    },
    {
      "relative_path": "elements/CollectionElement.md",
      "size_in_bytes": 5378
    },
    {
      "relative_path": "elements/CompareBubble.md",
      "size_in_bytes": 4103
    },
    {
      "relative_path": "elements/CompareHorizontalBar.md",
      "size_in_bytes": 3066
    },
    {
      "relative_path": "elements/CompareRadialBar.md",
      "size_in_bytes": 3132
    },
    {
      "relative_path": "elements/CompareValuesCollection.md",
      "size_in_bytes": 9079
    },
    {
      "relative_path": "elements/CompareVerticalBar.md",
      "size_in_bytes": 3255
    },
    {
      "relative_path": "elements/CompareVerticalPictograph.md",
      "size_in_bytes": 4271
    },
    {
      "relative_path": "elements/ConnectionDiagram.md",
      "size_in_bytes": 8742
    },
    {
      "relative_path": "elements/ConnectorGroup.md",
      "size_in_bytes": 7514
    },
    {
      "relative_path": "elements/ContactInfo.md",
      "size_in_bytes": 7149
    },
    {
      "relative_path": "elements/ContentElement.md",
      "size_in_bytes": 9114
    },
    {
      "relative_path": "elements/ContentItem.md",
      "size_in_bytes": 8350
    },
    {
      "relative_path": "elements/Countdown.md",
      "size_in_bytes": 3457
    },
    {
      "relative_path": "elements/CycleDiagram.md",
      "size_in_bytes": 6549
    },
    {
      "relative_path": "elements/Dashboard.md",
      "size_in_bytes": 9346
    },
    {
      "relative_path": "elements/FlexCircleCallout.md",
      "size_in_bytes": 5015
    },
    {
      "relative_path": "elements/Footer.md",
      "size_in_bytes": 5131
    },
    {
      "relative_path": "elements/FramedMediaElement.md",
      "size_in_bytes": 7173
    },
    {
      "relative_path": "elements/GanttChart.md",
      "size_in_bytes": 7374
    },
    {
      "relative_path": "elements/GridLayoutContainer.md",
      "size_in_bytes": 8338
    },
    {
      "relative_path": "elements/Header.md",
      "size_in_bytes": 7338
    },
    {
      "relative_path": "elements/Headline.md",
      "size_in_bytes": 9781
    },
    {
      "relative_path": "elements/HorizontalFunnel.md",
      "size_in_bytes": 8870
    },
    {
      "relative_path": "elements/HorizontalTaskLists.md",
      "size_in_bytes": 5517
    },
    {
      "relative_path": "elements/HubAndSpoke.md",
      "size_in_bytes": 9617
    },
    {
      "relative_path": "elements/Icon.md",
      "size_in_bytes": 4607
    },
    {
      "relative_path": "elements/IconCircle.md",
      "size_in_bytes": 8398
    },
    {
      "relative_path": "elements/IconTextGrid.md",
      "size_in_bytes": 5653
    },
    {
      "relative_path": "elements/ImageCarousel.md",
      "size_in_bytes": 7179
    },
    {
      "relative_path": "elements/Journey.md",
      "size_in_bytes": 7089
    },
    {
      "relative_path": "elements/LayoutContainerItem.md",
      "size_in_bytes": 8865
    },
    {
      "relative_path": "elements/LogoGrid.md",
      "size_in_bytes": 4879
    },
    {
      "relative_path": "elements/MarkerCallout.md",
      "size_in_bytes": 9775
    },
    {
      "relative_path": "elements/MediaAndTextCallout.md",
      "size_in_bytes": 5864
    },
    {
      "relative_path": "elements/MediaCallout.md",
      "size_in_bytes": 5502
    },
    {
      "relative_path": "elements/MediaElement.md",
      "size_in_bytes": 7089
    },
    {
      "relative_path": "elements/NodeDiagram.md",
      "size_in_bytes": 7619
    },
    {
      "relative_path": "elements/OrgChart.md",
      "size_in_bytes": 8963
    },
    {
      "relative_path": "elements/Ornament.md",
      "size_in_bytes": 3356
    },
    {
      "relative_path": "elements/PhotoCollage.md",
      "size_in_bytes": 8704
    },
    {
      "relative_path": "elements/PhotoTextList.md",
      "size_in_bytes": 6984
    },
    {
      "relative_path": "elements/PictorialCharts.md",
      "size_in_bytes": 6170
    },
    {
      "relative_path": "elements/Picture.md",
      "size_in_bytes": 5977
    },
    {
      "relative_path": "elements/PieChart.md",
      "size_in_bytes": 8282
    },
    {
      "relative_path": "elements/PresentationTitle.md",
      "size_in_bytes": 11588
    },
    {
      "relative_path": "elements/ProcessDiagram.md",
      "size_in_bytes": 3540
    },
    {
      "relative_path": "elements/ProcessDiagramBoxes.md",
      "size_in_bytes": 3312
    },
    {
      "relative_path": "elements/ProcessDiagramChevrons.md",
      "size_in_bytes": 6654
    },
    {
      "relative_path": "elements/ProductScreenshot.md",
      "size_in_bytes": 6128
    },
    {
      "relative_path": "elements/Pyramid.md",
      "size_in_bytes": 7604
    },
    {
      "relative_path": "elements/ROICalculator.md",
      "size_in_bytes": 5970
    },
    {
      "relative_path": "elements/RadialBarChart.md",
      "size_in_bytes": 5483
    },
    {
      "relative_path": "elements/RadialBarInfographic.md",
      "size_in_bytes": 5088
    },
    {
      "relative_path": "elements/Sequence.md",
      "size_in_bytes": 7899
    },
    {
      "relative_path": "elements/ShapeCallout.md",
      "size_in_bytes": 9549
    },
    {
      "relative_path": "elements/SideBarContainer.md",
      "size_in_bytes": 9339
    },
    {
      "relative_path": "elements/SliceChart.md",
      "size_in_bytes": 5043
    },
    {
      "relative_path": "elements/Slide.md",
      "size_in_bytes": 16526
    },
    {
      "relative_path": "elements/SlidePlaceholder.md",
      "size_in_bytes": 2615
    },
    {
      "relative_path": "elements/StackDiagram.md",
      "size_in_bytes": 6648
    },
    {
      "relative_path": "elements/Statistic.md",
      "size_in_bytes": 7579
    },
    {
      "relative_path": "elements/SwotDiagram.md",
      "size_in_bytes": 4608
    },
    {
      "relative_path": "elements/Table.md",
      "size_in_bytes": 11806
    },
    {
      "relative_path": "elements/Target.md",
      "size_in_bytes": 6307
    },
    {
      "relative_path": "elements/Team.md",
      "size_in_bytes": 5437
    },
    {
      "relative_path": "elements/TextAndImage.md",
      "size_in_bytes": 11661
    },
    {
      "relative_path": "elements/TextBoxGrid.md",
      "size_in_bytes": 7220
    },
    {
      "relative_path": "elements/TextCallout.md",
      "size_in_bytes": 4606
    },
    {
      "relative_path": "elements/TextElement.md",
      "size_in_bytes": 17175
    },
    {
      "relative_path": "elements/TextFrame.md",
      "size_in_bytes": 8377
    },
    {
      "relative_path": "elements/TextList.md",
      "size_in_bytes": 11875
    },
    {
      "relative_path": "elements/TextSlide.md",
      "size_in_bytes": 5101
    },
    {
      "relative_path": "elements/Thermometer.md",
      "size_in_bytes": 5891
    },
    {
      "relative_path": "elements/Timeline.md",
      "size_in_bytes": 15106
    },
    {
      "relative_path": "elements/Timer.md",
      "size_in_bytes": 2818
    },
    {
      "relative_path": "elements/UserTestimonial.md",
      "size_in_bytes": 7990
    },
    {
      "relative_path": "elements/VennDiagram.md",
      "size_in_bytes": 5710
    },
    {
      "relative_path": "elements/VerticalTaskLists.md",
      "size_in_bytes": 5956
    },
    {
      "relative_path": "elements/Video.md",
      "size_in_bytes": 4567
    },
    {
      "relative_path": "elements/VideoElement.md",
      "size_in_bytes": 5564
    },
    {
      "relative_path": "elements/WebView.md",
      "size_in_bytes": 4178
    },
    {
      "relative_path": "elements/WordCloudElement.md",
      "size_in_bytes": 5034
    },
    {
      "relative_path": "elements/WorldMap.md",
      "size_in_bytes": 5842
    },
    {
      "relative_path": "elements/XYGraph.md",
      "size_in_bytes": 8765
    }
  ],
  "name": "beautiful-ai-slide-elements",
  "skill_md_contents": "---\nname: beautiful-ai-slide-elements\ndescription: Model reference for Beautiful.ai slides, one document per slide element - the fields each template's root element and its nested elements expect in states[0], allowed values, limits and pitfalls. Use when building or editing a slide model for create_slide or update_slide, before rendering it with render_slide.\n---\n\n# Beautiful.ai slide elements\n\nA slide is rendered by a tree of elements, and the slide model mirrors that tree: `states[0].primary` is the model of the template's root element, and every element the root nests reads its own part of that model (an item of `items[]`, a `childElement`, a text block, a media slot). This skill documents, per element, what that part must contain. The documents are in `elements/<Element>.md` (served as `beautiful-ai://skills/slide-elements/elements/<Element>.md`).\n\nHow to use it:\n\n1. Start with `Slide.md`: the slide model as a whole (`template_id`, `states[0]` and its keys, the `layout` object).\n2. Find the template in the table below and read its root element's document, then the documents in \"Also read\" for the parts you are going to write.\n3. Read the building blocks the first time you write them: `TextElement.md` (every text field is a `{ blocks: [...] }` object), `ContentElement.md` with `Picture.md` / `Icon.md` (every image, logo or icon slot is a `content_type` + `content_value` pair), `CollectionElement.md` (every `items[]` array), `Header.md` and `SideBarContainer.md` (the header and the side tray that most templates allow).\n4. Cross-check with a real model of the template (`get_slide_examples`) and the template's `defaultData` (`list_slide_templates`), build the model, render it (`render_slide`) and fix what the render reports before saving.\n\nThe documents describe the current model. Stored slides also carry computed caches (text `blockBounds`, `textStyles`, …) and bookkeeping fields: never author those, the documents say which fields are yours to write.\n\n## Templates and their elements\n\n| Template id | Root element | Also read |\n|---|---|---|\n| `action-number` | `ActionNumber.md` | |\n| `agenda` | `Agenda.md` | `TextList.md` |\n| `arrow_bars` | `ArrowBars.md` | |\n| `authoring` | `AuthoringCanvas.md` | `AuthoringElementContainer.md`, then per element: `AuthoringShapeElement.md`, `AuthoringPathElement.md`, `AuthoringContentElement.md`, `AuthoringVideo.md` |\n| `big-numbers` | `BigNumbers.md` | |\n| `calendar-month`, `calendar-week` | `Calendar.md` | `VerticalTaskLists.md` (the week view) |\n| `compare_circles` | `CompareBubble.md` | `CompareValuesCollection.md` |\n| `compare_horizontal_bars` | `CompareHorizontalBar.md` | `CompareValuesCollection.md` |\n| `compare_radial_bars` | `CompareRadialBar.md` | `CompareValuesCollection.md`, `RadialBarInfographic.md` (the ring) |\n| `compare_vertical_bars` | `CompareVerticalBar.md` | `CompareValuesCollection.md` |\n| `compare_vertical_pictograph` | `CompareVerticalPictograph.md` | `CompareValuesCollection.md`, `PictorialCharts.md` (the icon grid) |\n| `connection_diagram` | `ConnectionDiagram.md` | `TextAndImage.md` |\n| `contactus` | `ContactInfo.md` | |\n| `countdown` | `Countdown.md` | |\n| `cycle_diagram` | `CycleDiagram.md` | |\n| `dashboard`, `chart_line`, `chart_column`, `chart_bar`, `chart_area`, `chart_waterfall`, `chart_pie`, `table-v2` | `Dashboard.md` | `GridLayoutContainer.md`, `LayoutContainerItem.md`, then per cell: `Chart.md`, `PieChart.md`, `Statistic.md`, `RadialBarInfographic.md`, `RadialBarChart.md`, `Table.md`, `TextAndImage.md` |\n| `flow_chart` | `NodeDiagram.md` | `CalloutsCanvas.md`, `ConnectorGroup.md` |\n| `gantt_chart` | `GanttChart.md` | |\n| `headline2`, `section` | `Headline.md` | `TextFrame.md`, `PhotoCollage.md` (the images) |\n| `horizontal-funnel` | `HorizontalFunnel.md` | `Ornament.md` |\n| `horizontal-task-list` | `HorizontalTaskLists.md` | |\n| `hub_and_spoke` | `HubAndSpoke.md` | `ContentItem.md`, `ConnectorGroup.md` |\n| `image`, `collage` | `PhotoCollage.md` | `GridLayoutContainer.md`, `LayoutContainerItem.md`, `TextAndImage.md` (the cells) |\n| `journey` | `Journey.md` | |\n| `kanban` | `VerticalTaskLists.md` | |\n| `logogrid` | `LogoGrid.md` | |\n| `orgchart` | `OrgChart.md` | |\n| `product_laptop` | `ProductScreenshot.md` | `TextList.md` |\n| `pyramid`, `funnel` | `Pyramid.md` | |\n| `radial_bar_chart` | `RadialBarChart.md` | |\n| `roi_calculator` | `ROICalculator.md` | |\n| `sequence`, `gears`, `puzzle` | `Sequence.md` | |\n| `slicechart` | `SliceChart.md` | `Ornament.md` |\n| `slidePlaceholder` | `SlidePlaceholder.md` | |\n| `stackDiagram` | `StackDiagram.md` | `GridLayoutContainer.md`, `LayoutContainerItem.md`, `TextAndImage.md` |\n| `step_boxes` | `ProcessDiagramBoxes.md` | `ProcessDiagram.md` |\n| `step_chevrons` | `ProcessDiagramChevrons.md` | `ProcessDiagram.md`, `Ornament.md` |\n| `step_circular` | `IconCircle.md` | `ContentItem.md`, `ConnectorGroup.md` |\n| `swot_diagram` | `SwotDiagram.md` | |\n| `target` | `Target.md` | `CalloutsCanvas.md` (annotations) |\n| `team` | `Team.md` | |\n| `text`, `long_bio` | `TextSlide.md` | |\n| `textBoxGrid` | `TextBoxGrid.md` | `Ornament.md` |\n| `textgrid_carousel` | `ImageCarousel.md` | `PhotoCollage.md`, `GridLayoutContainer.md`, `TextAndImage.md` (the cells) |\n| `textgrid_photos` | `PhotoTextList.md` | |\n| `textgrid_vertical_icons` | `IconTextGrid.md` | |\n| `textlist` | `TextList.md` | |\n| `thermometer` | `Thermometer.md` | `CalloutsCanvas.md` (annotations) |\n| `timeline` | `Timeline.md` | `ContentItem.md` (the milestones), `ConnectorGroup.md`, `CalloutsCanvas.md` (annotations) |\n| `timer` | `Timer.md` | |\n| `title` | `PresentationTitle.md` | `TextFrame.md` |\n| `user_testimonial` | `UserTestimonial.md` | |\n| `vennDiagram` | `VennDiagram.md` | |\n| `video` | `Video.md` | |\n| `visual_percentage` | `PictorialCharts.md` | |\n| `web-view` | `WebView.md` | |\n| `wordCloud` | `WordCloudElement.md` | |\n| `world_map` | `WorldMap.md` | |\n| `xygraph` | `XYGraph.md` | `CalloutsCanvas.md` (annotations) |\n\n## Building blocks\n\nShared by many roots; their documents are the reference for the fields they read wherever they appear.\n\n- `Slide.md`: the whole slide model and its `layout` (header position, tray layout, footer, background).\n- `Header.md` (`states[0].header`), `SideBarContainer.md` (`states[0].tray`, the side trays), `BottomTray.md` (the bottom tray and the element text block / attribution), `Footer.md`, `CanvasBackground.md` (`layout.backgroundColor` and friends).\n- `BaseElement.md`: the fields every element reads; `CollectionElement.md`: how `items[]` work (ids, order, counts).\n- `TextElement.md`: text blocks, text styles, list styles (bullets, numbers, checklists, icons); `TextFrame.md`: the framed text block of titles and headlines.\n- `ContentElement.md`: a media slot and how `content_type` picks `Picture.md` (images and logos), `Icon.md` (built-in icons, see `list_icons`), `VideoElement.md`; `MediaElement.md`: the shared crop / scale / filter fields; `FramedMediaElement.md`: a media slot with a frame shape.\n- `TextAndImage.md`: text with an optional image, used by dashboard cells, trays and several diagrams.\n- `GridLayoutContainer.md` and `LayoutContainerItem.md`: the grid of cells behind dashboards, photo collages, stack diagrams and trays; the cell components `Chart.md`, `PieChart.md`, `Statistic.md`, `RadialBarInfographic.md`, `Table.md`.\n- `CalloutsCanvas.md`: free-floating callouts and annotations (on flow charts, targets, thermometers, XY graphs, timelines and the slide itself), whose entries are described by `CalloutElement.md` (the shared contract and the `calloutType` table) and per type by `TextCallout.md`, `MarkerCallout.md` (bullet, numbered, lettered markers), `MediaCallout.md`, `MediaAndTextCallout.md`, `FlexCircleCallout.md` and `ShapeCallout.md` (boxes, diamonds, circles, pills); `AuthoringCanvas.md`: the free-form canvas, whose entries are `AuthoringElementContainer.md` (position, size, rotation, type) around one of `AuthoringShapeElement.md` (shapes and text boxes), `AuthoringPathElement.md` (lines and arrows), `AuthoringContentElement.md` (images and icons), `AuthoringVideo.md`, and the legacy `AuthoringSvgElement.md` / `AuthoringRadialBar.md`; `ConnectorGroup.md`: the connectors between items; `ContentItem.md`: the nodes (text with a dot, number, letter, icon or shape) of hub-and-spoke, icon circle and timeline diagrams.\n- `Ornament.md`: the number / letter / icon badge on the items of step chevrons, slice charts, horizontal funnels and text box grids.\n- `CompareValuesCollection.md`: the shared model of the five compare charts; `ProcessDiagram.md`: the shared model of the step diagrams.\n"
}