slackblock 2.0.0-beta.3 → 3.0.0-beta.0

package/dist/index.cjs

@@ -33,24 +33,34 @@ module.exports = __toCommonJS(src_exports);
 
 // src/errors.ts
 var SlackblockValidationError = class extends Error {
-  constructor(message, path, rule) {
-    super(`${path}: ${message}`);
+  constructor(issue) {
+    super(`${issue.path}: ${issue.message}`);
     __publicField(this, "path");
     __publicField(this, "rule");
+    __publicField(this, "subcode");
+    __publicField(this, "component");
+    __publicField(this, "field");
+    __publicField(this, "issue");
     this.name = "SlackblockValidationError";
-    this.path = path;
-    this.rule = rule;
+    this.path = issue.path;
+    this.rule = issue.rule;
+    this.subcode = issue.subcode;
+    this.component = issue.component;
+    this.field = issue.field;
+    this.issue = issue;
   }
 };
 
 // src/utils/validation-context.ts
 var context = {
   mode: "warn",
-  path: []
+  path: [],
+  reporter: void 0
 };
-var initContext = (mode) => {
+var initContext = (mode, reporter) => {
   context.mode = mode;
   context.path = [];
+  context.reporter = reporter;
 };
 var pushPath = (segment) => {
   context.path.push(segment);
@@ -59,26 +69,63 @@ var popPath = () => {
   context.path.pop();
 };
 var getPath = () => context.path.join(" > ");
-var report = (message, rule) => {
+var getCurrentComponent = () => {
+  for (let index = context.path.length - 1; index >= 0; index--) {
+    const segment = context.path[index];
+    if (segment !== "Message") {
+      return segment;
+    }
+  }
+  return context.path.at(-1);
+};
+var toIssue = (input) => {
+  var _a;
+  return {
+    ...input,
+    path: getPath(),
+    component: (_a = input.component) != null ? _a : getCurrentComponent()
+  };
+};
+var report = (input) => {
   if (context.mode === "off") {
     return;
   }
-  const path = getPath();
+  const issue = toIssue(input);
   if (context.mode === "warn") {
-    console.warn(`[slackblock] ${path}: ${message}`);
+    if (context.reporter) {
+      context.reporter(issue);
+    } else {
+      console.warn(`[slackblock] ${issue.path}: ${issue.message}`);
+    }
     return;
   }
-  throw new SlackblockValidationError(message, path, rule);
+  throw new SlackblockValidationError(issue);
 };
 
 // src/utils/validation.ts
 var toKebab = (name) => name.replaceAll(/([A-Z])/g, "-$1").toLowerCase();
+var isMissing = (value) => {
+  if (value === void 0 || value === null) {
+    return true;
+  }
+  if (typeof value === "string") {
+    return value === "";
+  }
+  if (Array.isArray(value)) {
+    return value.length === 0;
+  }
+  return false;
+};
 var warnIfTooLong = (name, value, max) => {
   if (!value) {
     return;
   }
   if (value.length > max) {
-    report(`${name} exceeds ${max} characters.`, "value-too-long");
+    report({
+      message: `${name} exceeds ${max} characters.`,
+      rule: "too-long",
+      subcode: "value-too-long"
+    });
   }
 };
 var warnIfTooMany = (name, values, max) => {
@@ -86,22 +133,42 @@ var warnIfTooMany = (name, values, max) => {
     return;
   }
   if (values.length > max) {
-    report(`${name} exceeds ${max} items.`, "too-many-items");
+    report({
+      message: `${name} exceeds ${max} items.`,
+      rule: "too-many",
+      subcode: "too-many-items"
+    });
   }
 };
 var requireField = (fieldName, value) => {
-  if (value === void 0 || value === null || value === "") {
-    report(`${fieldName} is required.`, `${toKebab(fieldName)}-required`);
+  if (isMissing(value)) {
+    report({
+      message: `${fieldName} is required.`,
+      rule: "required-field",
+      subcode: `${toKebab(fieldName)}-required`,
+      field: fieldName
+    });
   }
 };
+var requireOneOf = (fieldNames, values) => {
+  if (values.some((value) => !isMissing(value))) {
+    return;
+  }
+  report({
+    message: `At least one of ${fieldNames.join(" or ")} is required.`,
+    rule: "invalid-structure",
+    subcode: `${fieldNames.map((fieldName) => toKebab(fieldName)).join("-or-")}-required`
+  });
+};
 
 // src/transformers/block/text.ts
 var transformText = (element) => {
   const { plainText, children, emoji, verbatim } = element.props;
   const res = {
     type: plainText ? "plain_text" : "mrkdwn",
-    text: children
+    text: children != null ? children : ""
   };
+  requireField("text", children);
   if (typeof children === "string") {
     warnIfTooLong("Text", children, 3e3);
   }
@@ -144,7 +211,12 @@ var registry_default = Transformers;
 var transform = (element) => {
   const type = get_type_default(element);
   if (!registry_default[type]) {
-    report(`No transformer for component type '${type}'.`, "unknown-type");
+    report({
+      message: `No transformer for component type '${type}'.`,
+      rule: "unsupported-child",
+      subcode: "unknown-type",
+      component: type
+    });
     return {};
   }
   pushPath(type);
@@ -169,7 +241,10 @@ var MAX_ACTIONS_ELEMENTS = 25;
 var MAX_CONTEXT_ELEMENTS = 10;
 var MAX_CONFIRM_TITLE = 100;
 var MAX_CONFIRM_TEXT = 300;
+var MAX_CONFIRM_BUTTON_TEXT = 30;
 var MAX_BUTTON_TEXT = 75;
+var MAX_BUTTON_ACCESSIBILITY_LABEL = 75;
+var MAX_BUTTON_URL = 3e3;
 var MAX_BUTTON_VALUE = 2e3;
 var MAX_OPTION_TEXT = 75;
 var MAX_OPTION_VALUE = 150;
@@ -177,10 +252,19 @@ var MAX_OPTION_DESCRIPTION = 75;
 var MAX_OPTION_URL = 3e3;
 var MAX_OPTION_GROUP_LABEL = 75;
 var MAX_OPTION_GROUP_OPTIONS = 100;
+var MAX_SELECT_OPTIONS = 100;
+var MAX_SELECT_OPTION_GROUPS = 100;
 var MAX_IMAGE_URL = 3e3;
 var MAX_IMAGE_ALT_TEXT = 2e3;
 var MAX_IMAGE_TITLE = 2e3;
+var MAX_INPUT_LABEL = 2e3;
+var MAX_INPUT_HINT = 2e3;
+var MAX_CHECKBOX_OPTIONS = 10;
+var MAX_RADIO_OPTIONS = 10;
+var MAX_OVERFLOW_OPTIONS = 5;
 var MAX_VIDEO_DESCRIPTION = 200;
+var MAX_VIDEO_TITLE = 200;
+var MAX_VIDEO_AUTHOR_NAME = 50;
 var MAX_BLOCK_ID_LENGTH = 255;
 var MAX_MESSAGE_TEXT = 4e4;
 var RECOMMENDED_MESSAGE_TEXT = 4e3;
@@ -200,14 +284,20 @@ function jsx(type, props) {
 // src/transformers/block/confirmation.tsx
 var transformConfirmation = (child) => {
   const { title, confirm, deny, children } = child.props;
+  requireField("title", title);
+  requireField("confirm", confirm);
+  requireField("deny", deny);
+  requireField("text", children);
   warnIfTooLong("Confirm title", title, MAX_CONFIRM_TITLE);
-  const text = transform(children);
+  warnIfTooLong("Confirm confirm", confirm, MAX_CONFIRM_BUTTON_TEXT);
+  warnIfTooLong("Confirm deny", deny, MAX_CONFIRM_BUTTON_TEXT);
+  const text = transform(children != null ? children : /* @__PURE__ */ jsx(Text, { plainText: true, children: "" }));
   warnIfTooLong("Confirm text", text.text, MAX_CONFIRM_TEXT);
   const res = {
-    title: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: title })),
+    title: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: title != null ? title : "" })),
     text,
-    confirm: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: confirm })),
-    deny: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: deny }))
+    confirm: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: confirm != null ? confirm : "" })),
+    deny: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: deny != null ? deny : "" }))
   };
   return res;
 };
@@ -217,14 +307,17 @@ var confirmation_default = transformConfirmation;
 var transformButton = (child) => {
   const { actionId, children, url, value, style, confirm, accessibilityLabel } = child.props;
   requireField("actionId", actionId);
+  requireField("text", children);
   warnIfTooLong("Button action_id", actionId, MAX_ACTION_ID_LENGTH);
   if (typeof children === "string") {
     warnIfTooLong("Button text", children, MAX_BUTTON_TEXT);
   }
+  warnIfTooLong("Button url", url, MAX_BUTTON_URL);
   warnIfTooLong("Button value", value, MAX_BUTTON_VALUE);
+  warnIfTooLong("Button accessibility_label", accessibilityLabel, MAX_BUTTON_ACCESSIBILITY_LABEL);
   const res = {
     type: "button",
-    text: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children })),
+    text: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: children != null ? children : "" })),
     action_id: actionId
   };
   if (url) {
@@ -249,10 +342,14 @@ var button_default = transformButton;
 // src/transformers/block/image.ts
 var transformImage = (child) => {
   const { url, alt } = child.props;
+  requireField("url", url);
+  requireField("alt", alt);
+  warnIfTooLong("Image image_url", url, MAX_IMAGE_URL);
+  warnIfTooLong("Image alt_text", alt, MAX_IMAGE_ALT_TEXT);
   return {
     type: "image",
-    image_url: url,
-    alt_text: alt
+    image_url: url != null ? url : "",
+    alt_text: alt != null ? alt : ""
   };
 };
 var image_default = transformImage;
@@ -285,34 +382,63 @@ var transformContainer = (child) => {
 var container_default = transformContainer;
 
 // src/transformers/layout/section.ts
+var toTextElement = (value) => {
+  if (typeof value === "string") {
+    return {
+      children: [],
+      type: Text,
+      props: { children: value }
+    };
+  }
+  return value;
+};
+var normalizeFields = (values) => {
+  if (!values) {
+    return [];
+  }
+  return Array.isArray(values) ? values : [values];
+};
 var transformSection = (element) => {
-  const { text, blockId, children, accessory } = element.props;
+  const {
+    text,
+    fields,
+    blockId,
+    children,
+    accessory,
+    expand
+  } = element.props;
+  const normalizedFields = [...normalizeFields(fields), ...normalizeFields(children)];
   warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
   const res = {
-    type: "section",
-    text: transform(text)
+    type: "section"
   };
+  if (text !== void 0) {
+    res.text = transform(toTextElement(text));
+  }
   if (blockId) {
     res.block_id = blockId;
   }
   if (accessory) {
     res.accessory = transform(accessory);
   }
-  if (children) {
+  if (expand !== void 0) {
+    res.expand = expand;
+  }
+  if (normalizedFields.length > 0) {
     res.fields = [];
-    let fields = children;
-    if (!Array.isArray(fields)) {
-      fields = [fields];
-    }
-    for (const field of fields) {
+    for (const field of normalizedFields) {
       if (field) {
-        const t = transform(field);
+        const t = transform(toTextElement(field));
         warnIfTooLong("Section field text", t.text, MAX_SECTION_FIELD_TEXT);
         res.fields.push(t);
       }
     }
     warnIfTooMany("Section fields", res.fields, MAX_SECTION_FIELDS);
+    if (res.fields.length === 0) {
+      delete res.fields;
+    }
   }
+  requireOneOf(["text", "fields"], [res.text, res.fields]);
   return res;
 };
 var section_default = transformSection;
@@ -321,10 +447,8 @@ var section_default = transformSection;
 var transformActions = (child) => {
   const { children, blockId } = child.props;
   warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
-  let elements = children;
-  if (!Array.isArray(elements)) {
-    elements = [elements];
-  }
+  const elements = children ? Array.isArray(children) ? children : [children] : [];
+  requireField("elements", elements);
   const res = {
     type: "actions",
     elements: elements.map((element) => transform(element))
@@ -341,10 +465,8 @@ var actions_default = transformActions;
 var transformContext = (child) => {
   const { children, blockId } = child.props;
   warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
-  let elements = children;
-  if (!Array.isArray(elements)) {
-    elements = [elements];
-  }
+  const elements = children ? Array.isArray(children) ? children : [children] : [];
+  requireField("elements", elements);
   const res = {
     type: "context",
     elements: elements.map((element) => transform(element))
@@ -372,11 +494,12 @@ var divider_default = transformDivider;
 // src/transformers/layout/file.ts
 var transformFile = (child) => {
   const { externalId, blockId } = child.props;
+  requireField("externalId", externalId);
   warnIfTooLong("block_id", blockId, 255);
   const res = {
     type: "file",
     source: "remote",
-    external_id: externalId
+    external_id: externalId != null ? externalId : ""
   };
   if (blockId) {
     res.block_id = blockId;
@@ -393,7 +516,7 @@ var transformHeader = (child) => {
   warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
   const res = {
     type: "header",
-    text: transform(/* @__PURE__ */ jsx(Text, { plainText: true, emoji, children: text }))
+    text: transform(/* @__PURE__ */ jsx(Text, { plainText: true, emoji, children: text != null ? text : "" }))
   };
   if (blockId) {
     res.block_id = blockId;
@@ -405,13 +528,15 @@ var header_default = transformHeader;
 // src/transformers/layout/image.tsx
 var transformImageLayout = (child) => {
   const { url, alt, title, blockId } = child.props;
+  requireField("url", url);
+  requireField("alt", alt);
   warnIfTooLong("Image image_url", url, MAX_IMAGE_URL);
   warnIfTooLong("Image alt_text", alt, MAX_IMAGE_ALT_TEXT);
   warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
   const res = {
     type: "image",
-    image_url: url,
-    alt_text: alt
+    image_url: url != null ? url : "",
+    alt_text: alt != null ? alt : ""
   };
   if (title) {
     warnIfTooLong("Image title", title, MAX_IMAGE_TITLE);
@@ -427,11 +552,16 @@ var image_default2 = transformImageLayout;
 // src/transformers/layout/input.tsx
 var transformInput = (child) => {
   const { label, element, hint, optional, blockId } = child.props;
-  warnIfTooLong("block_id", blockId, 255);
+  const resolvedElement = element ? transform(element) : { type: "plain_text_input", action_id: "" };
+  requireField("label", label);
+  requireField("element", element);
+  warnIfTooLong("Input label", label, MAX_INPUT_LABEL);
+  warnIfTooLong("Input hint", hint, MAX_INPUT_HINT);
+  warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
   const res = {
     type: "input",
-    label: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: label })),
-    element: transform(element)
+    label: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: label != null ? label : "" })),
+    element: resolvedElement
   };
   if (hint) {
     res.hint = transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: hint }));
@@ -488,10 +618,12 @@ var toBlockElements = (children) => {
 // src/transformers/layout/rich-text.ts
 var transformRichText = (child) => {
   const { elements, children, blockId } = child.props;
+  const richTextElements = elements != null ? elements : toBlockElements(children);
   warnIfTooLong("block_id", blockId, 255);
+  requireField("elements", richTextElements);
   const res = {
     type: "rich_text",
-    elements: elements != null ? elements : toBlockElements(children)
+    elements: richTextElements
   };
   if (blockId) {
     res.block_id = blockId;
@@ -514,13 +646,19 @@ var transformVideo = (child) => {
     providerIconUrl,
     blockId
   } = child.props;
+  requireField("title", title);
+  requireField("videoUrl", videoUrl);
+  requireField("thumbnailUrl", thumbnailUrl);
+  requireField("altText", altText);
+  warnIfTooLong("Video title", title, MAX_VIDEO_TITLE);
+  warnIfTooLong("Video author_name", authorName, MAX_VIDEO_AUTHOR_NAME);
   warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
   const res = {
     type: "video",
-    title: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: title })),
-    video_url: videoUrl,
-    thumbnail_url: thumbnailUrl,
-    alt_text: altText
+    title: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: title != null ? title : "" })),
+    video_url: videoUrl != null ? videoUrl : "",
+    thumbnail_url: thumbnailUrl != null ? thumbnailUrl : "",
+    alt_text: altText != null ? altText : ""
   };
   if (titleUrl) {
     res.title_url = titleUrl;
@@ -557,9 +695,10 @@ var transformTextInput = (child) => {
     focusOnLoad,
     dispatchActionConfig
   } = child.props;
-  warnIfTooLong("TextInput action_id", actionId, 255);
+  requireField("actionId", actionId);
+  warnIfTooLong("TextInput action_id", actionId, MAX_ACTION_ID_LENGTH);
   if (placeholder) {
-    warnIfTooLong("TextInput placeholder", placeholder, 150);
+    warnIfTooLong("TextInput placeholder", placeholder, MAX_PLACEHOLDER_LENGTH);
   }
   const res = {
     type: "plain_text_input",
@@ -648,7 +787,12 @@ var transformDatePicker = (child) => {
   }
   if (initialDate) {
     if (!isValidDateString(initialDate)) {
-      report("Date must be valid and in format YYYY-MM-DD.", "invalid-date-format");
+      report({
+        message: "Date must be valid and in format YYYY-MM-DD.",
+        rule: "invalid-format",
+        subcode: "invalid-date-format",
+        field: "initialDate"
+      });
     }
     res.initial_date = initialDate;
   }
@@ -667,15 +811,14 @@ var transformCheckboxes = (child) => {
   const { actionId, children, initialOptions, confirm, focusOnLoad } = child.props;
   requireField("actionId", actionId);
   warnIfTooLong("Checkboxes action_id", actionId, MAX_ACTION_ID_LENGTH);
-  let elements = children;
-  if (!Array.isArray(elements)) {
-    elements = [elements];
-  }
+  const elements = Array.isArray(children) ? children : [children];
+  requireField("options", elements);
   const res = {
     type: "checkboxes",
     action_id: actionId,
     options: elements.map((element) => transform(element))
   };
+  warnIfTooMany("Checkboxes options", res.options, MAX_CHECKBOX_OPTIONS);
   if (initialOptions && initialOptions.length > 0) {
     res.initial_options = initialOptions.map((option) => transform(option));
   }
@@ -731,6 +874,31 @@ var assignStaticOptions = (elements, result) => {
     result.option_groups = elements.map((element) => transform(element));
   }
 };
+var applyConversationSettings = (result, settings) => {
+  const { defaultToCurrentConversation, responseUrlEnabled, filter } = settings;
+  if (defaultToCurrentConversation !== void 0) {
+    result.default_to_current_conversation = defaultToCurrentConversation;
+  }
+  if (responseUrlEnabled !== void 0) {
+    result.response_url_enabled = responseUrlEnabled;
+  }
+  if (!filter) {
+    return;
+  }
+  const filterValue = {};
+  if (filter.include && filter.include.length > 0) {
+    filterValue.include = filter.include;
+  }
+  if (filter.excludeExternalSharedChannels !== void 0) {
+    filterValue.exclude_external_shared_channels = filter.excludeExternalSharedChannels;
+  }
+  if (filter.excludeBotUsers !== void 0) {
+    filterValue.exclude_bot_users = filter.excludeBotUsers;
+  }
+  if (Object.keys(filterValue).length > 0) {
+    result.filter = filterValue;
+  }
+};
 var applyInitialSelections = (type, isMulti, result, initialValues) => {
   const { initialOptions, initialUsers, initialConversations, initialChannels } = initialValues;
   switch (type) {
@@ -805,12 +973,15 @@ var transformSelect = (child) => {
   warnIfTooLong("Select placeholder", placeholder, MAX_PLACEHOLDER_LENGTH);
   const result = {
     type: typeString,
-    placeholder: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: placeholder })),
+    placeholder: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: placeholder != null ? placeholder : "" })),
     action_id: actionId
   };
   const elements = normalizeElements(children);
   if (type === selectTypes.STATIC) {
-    assignStaticOptions(elements, result);
+    requireField("options", elements);
+    if (elements.length > 0) {
+      assignStaticOptions(elements, result);
+    }
   }
   if (confirm) {
     result.confirm = transform(confirm);
@@ -831,27 +1002,13 @@ var transformSelect = (child) => {
     result.min_query_length = minQueryLength;
   }
   if (type === selectTypes.CONVERSATION) {
-    if (defaultToCurrentConversation !== void 0) {
-      result.default_to_current_conversation = defaultToCurrentConversation;
-    }
-    if (responseUrlEnabled !== void 0) {
-      result.response_url_enabled = responseUrlEnabled;
-    }
-    if (filter) {
-      const filterValue = {};
-      if (filter.include && filter.include.length > 0) {
-        filterValue.include = filter.include;
-      }
-      if (filter.excludeExternalSharedChannels !== void 0) {
-        filterValue.exclude_external_shared_channels = filter.excludeExternalSharedChannels;
-      }
-      if (filter.excludeBotUsers !== void 0) {
-        filterValue.exclude_bot_users = filter.excludeBotUsers;
-      }
-      if (Object.keys(filterValue).length > 0) {
-        result.filter = filterValue;
-      }
-    }
+    applyConversationSettings(result, { defaultToCurrentConversation, responseUrlEnabled, filter });
+  }
+  if (result.options) {
+    warnIfTooMany("Select options", result.options, MAX_SELECT_OPTIONS);
+  }
+  if (result.option_groups) {
+    warnIfTooMany("Select option_groups", result.option_groups, MAX_SELECT_OPTION_GROUPS);
   }
   return result;
 };
@@ -860,13 +1017,14 @@ var select_default = transformSelect;
 // src/transformers/input/option.tsx
 var transformOption = (child) => {
   const { children: text, value, url, description } = child.props;
+  requireField("text", text);
   requireField("value", value);
   warnIfTooLong("Option text", text, MAX_OPTION_TEXT);
   warnIfTooLong("Option value", value, MAX_OPTION_VALUE);
   warnIfTooLong("Option description", description, MAX_OPTION_DESCRIPTION);
   warnIfTooLong("Option url", url, MAX_OPTION_URL);
   const res = {
-    text: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: text })),
+    text: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: text != null ? text : "" })),
     value
   };
   if (description) {
@@ -882,14 +1040,13 @@ var option_default = transformOption;
 // src/transformers/input/option-group.tsx
 var transformOptionGroup = (child) => {
   const { label, children } = child.props;
+  const options = Array.isArray(children) ? children : [children];
+  requireField("label", label);
+  requireField("options", options);
   warnIfTooLong("OptionGroup label", label, MAX_OPTION_GROUP_LABEL);
-  let options = children;
-  if (!Array.isArray(options)) {
-    options = [options];
-  }
   warnIfTooMany("OptionGroup options", options, MAX_OPTION_GROUP_OPTIONS);
   return {
-    label: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: label })),
+    label: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: label != null ? label : "" })),
     options: options.map((option) => transform(option))
   };
 };
@@ -898,16 +1055,16 @@ var option_group_default = transformOptionGroup;
 // src/transformers/input/overflow.ts
 var transformOverflow = (child) => {
   const { actionId, children, confirm } = child.props;
-  warnIfTooLong("Overflow action_id", actionId, 255);
-  let elements = children;
-  if (!Array.isArray(elements)) {
-    elements = [elements];
-  }
+  const elements = Array.isArray(children) ? children : [children];
+  requireField("actionId", actionId);
+  requireField("options", elements);
+  warnIfTooLong("Overflow action_id", actionId, MAX_ACTION_ID_LENGTH);
   const res = {
     type: "overflow",
     action_id: actionId,
     options: elements.map((element) => transform(element))
   };
+  warnIfTooMany("Overflow options", res.options, MAX_OVERFLOW_OPTIONS);
   if (confirm) {
     res.confirm = transform(confirm);
   }
@@ -920,15 +1077,14 @@ var transformRadioGroup = (child) => {
   const { actionId, children, initialOption, confirm, focusOnLoad } = child.props;
   requireField("actionId", actionId);
   warnIfTooLong("RadioGroup action_id", actionId, MAX_ACTION_ID_LENGTH);
-  let elements = children;
-  if (!Array.isArray(elements)) {
-    elements = [elements];
-  }
+  const elements = Array.isArray(children) ? children : [children];
+  requireField("options", elements);
   const res = {
     type: "radio_buttons",
     action_id: actionId,
     options: elements.map((element) => transform(element))
   };
+  warnIfTooMany("RadioGroup options", res.options, MAX_RADIO_OPTIONS);
   if (initialOption) {
     res.initial_option = transform(initialOption);
   }
@@ -968,7 +1124,12 @@ var transformTimePicker = (child) => {
   }
   if (initialTime) {
     if (!isValidTimeString(initialTime)) {
-      report("Time must be valid and in format HH:MM.", "invalid-time-format");
+      report({
+        message: "Time must be valid and in format HH:MM.",
+        rule: "invalid-format",
+        subcode: "invalid-time-format",
+        field: "initialTime"
+      });
     }
     res.initial_time = initialTime;
   }
@@ -1194,7 +1355,12 @@ var parseChildren = (children) => {
         popPath();
       }
     } else if (type !== "null") {
-      report(`No transformer for component type '${type}'.`, "unknown-type");
+      report({
+        message: `No transformer for component type '${type}'.`,
+        rule: "unsupported-child",
+        subcode: "unknown-type",
+        component: type
+      });
     }
   }
   if (transformedBlocks.length === 0) {
@@ -1207,7 +1373,7 @@ var parser_default = parseChildren;
 // src/renderer/index.ts
 var renderToBlocks = (element, options) => {
   var _a, _b;
-  initContext((_a = options == null ? void 0 : options.validate) != null ? _a : "warn");
+  initContext((_a = options == null ? void 0 : options.validate) != null ? _a : "warn", options == null ? void 0 : options.onValidation);
   const child = typeof element === "object" && element !== null && !Array.isArray(element) && element.type === "fragment" ? element.props.children : element;
   const result = parser_default(child);
   return (_b = result.blocks) != null ? _b : [];
@@ -1240,7 +1406,7 @@ var applyMessageMetadata = (json, properties) => {
 };
 function render(element, options) {
   var _a, _b, _c, _d, _e;
-  initContext((_a = options == null ? void 0 : options.validate) != null ? _a : "warn");
+  initContext((_a = options == null ? void 0 : options.validate) != null ? _a : "warn", options == null ? void 0 : options.onValidation);
   const properties = element.props;
   const typeName = get_type_default(element);
   if (typeName !== "Message") {