Kinds and generated controls
Block kinds and the generated manifest.ui controls, generated from the SDK validator.
Kinds
| Kind | Behaviour |
|---|---|
task | A Project Type Step. Its primary input and output connect automatically to neighbouring Steps. Use this for almost every Block. |
workspace | A complete project workspace that owns a project document (like Shots or the Editor). Never connected automatically: neighbours only reach it through project context or explicit connections. |
editor-extension | Accepted by the validator; no host behaviour depends on it today. Use task. |
composite | Accepted by the validator; no host behaviour depends on it today. Use task. |
Generated controls
manifest.ui binds generated controls to inputs. A custom view replaces them in the interface, but keep them as the fallback schema.
| Control | Use |
|---|---|
text | Single- or multi-line text for a text-like input. |
number | A number field for number/integer inputs. |
slider | A range slider for a bounded number input. |
checkbox | A toggle for a boolean input. |
asset | A media picker for image, video, audio or asset inputs. |
select | One choice from a list. |
multiselect | Several choices from a list. |
file | An upload for a file or file[] input: PDF, TXT, CSV, Markdown, JSON or ZIP, checked by type and bytes before the Block sees a saved reference. |
date | A date picker for a date input; add time: true for a date and time. |
color | A color picker with a hex field for a color input. |
url | A web address field for a url input (http or https). |
richtext | A Markdown editor with a preview for a document input, or a text input written in Markdown. |
list | An item-by-item editor for text[], number[], integer[], url[], date[] or color[] inputs. |
grid | A grid editor for a table input, with add and remove rows and columns and CSV paste. |
gallery | Presents an image[] output as a gallery. |
before-after | Compares an image output with a declared image input. |
table | Presents a table output as a paged table with a CSV download. |
document | Presents a document or Markdown text output as formatted text. |
chart | Draws a table (optional x and y column names) or number[] output as a bar or line chart (chart). |
code | Presents a text, json or object output as code with a copy button (optional language). |
player | Plays an audio or video output (or a list of them). |
download | Offers a file, file[] or file-bundle output as a download through the host export policy. |