slackblock 1.0.1 → 2.0.0-beta.0

package/dist/index.cjs

@@ -1,9 +1,9 @@
-var __create = Object.create;
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -16,53 +16,69 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  default: () => renderer_default
+  SlackblockValidationError: () => SlackblockValidationError,
+  blockKitBuilderUrl: () => blockKitBuilderUrl,
+  default: () => renderer_default,
+  escapeMrkdwn: () => escapeMrkdwn,
+  renderToBlocks: () => renderToBlocks,
+  renderToMessage: () => render
 });
 module.exports = __toCommonJS(src_exports);
 
-// src/utils/get-type.ts
-var getType = (element) => {
-  if (typeof element === "string") {
-    return "string";
+// src/errors.ts
+var SlackblockValidationError = class extends Error {
+  constructor(message, path, rule) {
+    super(`${path}: ${message}`);
+    __publicField(this, "path");
+    __publicField(this, "rule");
+    this.name = "SlackblockValidationError";
+    this.path = path;
+    this.rule = rule;
   }
-  if (element === null || element === void 0 || typeof element === "boolean") {
-    return "null";
-  }
-  if (Array.isArray(element)) {
-    throw new TypeError("Cannot type arrays");
+};
+
+// src/utils/validation-context.ts
+var context = {
+  mode: "warn",
+  path: []
+};
+var initContext = (mode) => {
+  context.mode = mode;
+  context.path = [];
+};
+var pushPath = (segment) => {
+  context.path.push(segment);
+};
+var popPath = () => {
+  context.path.pop();
+};
+var getPath = () => context.path.join(" > ");
+var report = (message, rule) => {
+  if (context.mode === "off") {
+    return;
   }
-  const { type } = element;
-  if (typeof type === "string") {
-    return type;
+  const path = getPath();
+  if (context.mode === "warn") {
+    console.warn(`[slackblock] ${path}: ${message}`);
+    return;
   }
-  const { slackType, displayName, name } = type;
-  return slackType || displayName || name || type;
+  throw new SlackblockValidationError(message, path, rule);
 };
-var get_type_default = getType;
 
 // src/utils/validation.ts
-var warn = (message) => {
-  console.warn(message);
-};
+var toKebab = (name) => name.replaceAll(/([A-Z])/g, "-$1").toLowerCase();
 var warnIfTooLong = (name, value, max) => {
   if (!value) {
     return;
   }
   if (value.length > max) {
-    warn(`${name} exceeds ${max} characters.`);
+    report(`${name} exceeds ${max} characters.`, "value-too-long");
   }
 };
 var warnIfTooMany = (name, values, max) => {
@@ -70,20 +86,18 @@ var warnIfTooMany = (name, values, max) => {
     return;
   }
   if (values.length > max) {
-    warn(`${name} exceeds ${max} items.`);
+    report(`${name} exceeds ${max} items.`, "too-many-items");
+  }
+};
+var requireField = (fieldName, value) => {
+  if (value === void 0 || value === null || value === "") {
+    report(`${fieldName} is required.`, `${toKebab(fieldName)}-required`);
   }
 };
 
 // src/transformers/block/text.ts
 var transformText = (element) => {
-  const {
-    props: {
-      plainText,
-      children,
-      emoji,
-      verbatim
-    }
-  } = element;
+  const { plainText, children, emoji, verbatim } = element.props;
   const res = {
     type: plainText ? "plain_text" : "mrkdwn",
     text: children
@@ -101,40 +115,116 @@ var transformText = (element) => {
 };
 var text_default = transformText;
 
-// src/transformers/block/confirmation.tsx
-var import_react2 = __toESM(require("react"));
+// src/utils/get-type.ts
+var getType = (element) => {
+  var _a, _b;
+  if (typeof element === "string") {
+    return "string";
+  }
+  if (element === null || element === void 0 || typeof element === "boolean") {
+    return "null";
+  }
+  if (Array.isArray(element)) {
+    throw new TypeError("Cannot type arrays");
+  }
+  const { type } = element;
+  if (typeof type === "string") {
+    return type;
+  }
+  const { slackType, displayName, name } = type;
+  return (_b = (_a = slackType != null ? slackType : displayName) != null ? _a : name) != null ? _b : type;
+};
+var get_type_default = getType;
+
+// src/transformers/registry.ts
+var Transformers = {};
+var registry_default = Transformers;
+
+// src/transformers/transform.ts
+var transform = (element) => {
+  const type = get_type_default(element);
+  if (!registry_default[type]) {
+    report(`No transformer for component type '${type}'.`, "unknown-type");
+    return {};
+  }
+  pushPath(type);
+  try {
+    return registry_default[type](element);
+  } finally {
+    popPath();
+  }
+};
 
 // src/components/block/text.tsx
-var import_react = __toESM(require("react"));
-var Text = class extends import_react.default.Component {
+var Text = class {
 };
-Text.slackType = "Text";
+__publicField(Text, "slackType", "Text");
+
+// src/constants/limits.ts
+var MAX_BLOCKS = 50;
+var MAX_HEADER_TEXT = 150;
+var MAX_SECTION_FIELDS = 10;
+var MAX_SECTION_FIELD_TEXT = 2e3;
+var MAX_ACTIONS_ELEMENTS = 25;
+var MAX_CONTEXT_ELEMENTS = 10;
+var MAX_CONFIRM_TITLE = 100;
+var MAX_CONFIRM_TEXT = 300;
+var MAX_BUTTON_TEXT = 75;
+var MAX_BUTTON_VALUE = 2e3;
+var MAX_OPTION_TEXT = 75;
+var MAX_OPTION_VALUE = 150;
+var MAX_OPTION_DESCRIPTION = 75;
+var MAX_OPTION_URL = 3e3;
+var MAX_OPTION_GROUP_LABEL = 75;
+var MAX_OPTION_GROUP_OPTIONS = 100;
+var MAX_IMAGE_URL = 3e3;
+var MAX_IMAGE_ALT_TEXT = 2e3;
+var MAX_IMAGE_TITLE = 2e3;
+var MAX_VIDEO_DESCRIPTION = 200;
+var MAX_BLOCK_ID_LENGTH = 255;
+var MAX_MESSAGE_TEXT = 4e4;
+var RECOMMENDED_MESSAGE_TEXT = 4e3;
+var MAX_ACTION_ID_LENGTH = 255;
+var MAX_PLACEHOLDER_LENGTH = 150;
+
+// src/jsx-runtime.ts
+function jsx(type, props) {
+  const { children } = props;
+  return {
+    type,
+    props,
+    children: Array.isArray(children) ? children : children === void 0 ? [] : [children]
+  };
+}
 
 // src/transformers/block/confirmation.tsx
 var transformConfirmation = (child) => {
   const { title, confirm, deny, children } = child.props;
+  warnIfTooLong("Confirm title", title, MAX_CONFIRM_TITLE);
+  const text = transform(children);
+  warnIfTooLong("Confirm text", text.text, MAX_CONFIRM_TEXT);
   const res = {
-    title: transform(/* @__PURE__ */ import_react2.default.createElement(Text, { plainText: true }, title)),
-    text: transform(children),
-    confirm: transform(/* @__PURE__ */ import_react2.default.createElement(Text, { plainText: true }, confirm)),
-    deny: transform(/* @__PURE__ */ import_react2.default.createElement(Text, { plainText: true }, deny))
+    title: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: title })),
+    text,
+    confirm: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: confirm })),
+    deny: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: deny }))
   };
   return res;
 };
 var confirmation_default = transformConfirmation;
 
 // src/transformers/block/button.tsx
-var import_react3 = __toESM(require("react"));
 var transformButton = (child) => {
   const { actionId, children, url, value, style, confirm, accessibilityLabel } = child.props;
-  warnIfTooLong("Button action_id", actionId, 255);
+  requireField("actionId", actionId);
+  warnIfTooLong("Button action_id", actionId, MAX_ACTION_ID_LENGTH);
   if (typeof children === "string") {
-    warnIfTooLong("Button text", children, 75);
+    warnIfTooLong("Button text", children, MAX_BUTTON_TEXT);
   }
-  warnIfTooLong("Button value", value, 2e3);
+  warnIfTooLong("Button value", value, MAX_BUTTON_VALUE);
   const res = {
     type: "button",
-    text: transform(/* @__PURE__ */ import_react3.default.createElement(Text, { plainText: true }, children)),
+    text: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children })),
     action_id: actionId
   };
   if (url) {
@@ -167,7 +257,7 @@ var transformImage = (child) => {
 };
 var image_default = transformImage;
 
-// src/transformers/layout/container.ts
+// src/utils/normalize-children.ts
 var normalizeChildren = (children) => {
   const result = [];
   const stack = Array.isArray(children) ? [...children] : [children];
@@ -184,24 +274,20 @@ var normalizeChildren = (children) => {
   }
   return result;
 };
+var normalize_children_default = normalizeChildren;
+
+// src/transformers/layout/container.ts
 var transformContainer = (child) => {
   const { children } = child.props;
-  const elements = normalizeChildren(children);
+  const elements = normalize_children_default(children);
   return elements.map((element) => transform(element));
 };
 var container_default = transformContainer;
 
 // src/transformers/layout/section.ts
 var transformSection = (element) => {
-  const {
-    props: {
-      text,
-      blockId,
-      children,
-      accessory
-    }
-  } = element;
-  warnIfTooLong("block_id", blockId, 255);
+  const { text, blockId, children, accessory } = element.props;
+  warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
   const res = {
     type: "section",
     text: transform(text)
@@ -221,10 +307,11 @@ var transformSection = (element) => {
     for (const field of fields) {
       if (field) {
         const t = transform(field);
+        warnIfTooLong("Section field text", t.text, MAX_SECTION_FIELD_TEXT);
         res.fields.push(t);
       }
     }
-    warnIfTooMany("Section fields", res.fields, 10);
+    warnIfTooMany("Section fields", res.fields, MAX_SECTION_FIELDS);
   }
   return res;
 };
@@ -233,7 +320,7 @@ var section_default = transformSection;
 // src/transformers/layout/actions.ts
 var transformActions = (child) => {
   const { children, blockId } = child.props;
-  warnIfTooLong("block_id", blockId, 255);
+  warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
   let elements = children;
   if (!Array.isArray(elements)) {
     elements = [elements];
@@ -245,7 +332,7 @@ var transformActions = (child) => {
   if (blockId) {
     res.block_id = blockId;
   }
-  warnIfTooMany("Actions elements", res.elements, 25);
+  warnIfTooMany("Actions elements", res.elements, MAX_ACTIONS_ELEMENTS);
   return res;
 };
 var actions_default = transformActions;
@@ -253,7 +340,7 @@ var actions_default = transformActions;
 // src/transformers/layout/context.ts
 var transformContext = (child) => {
   const { children, blockId } = child.props;
-  warnIfTooLong("block_id", blockId, 255);
+  warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
   let elements = children;
   if (!Array.isArray(elements)) {
     elements = [elements];
@@ -265,7 +352,7 @@ var transformContext = (child) => {
   if (blockId) {
     res.block_id = blockId;
   }
-  warnIfTooMany("Context elements", res.elements, 10);
+  warnIfTooMany("Context elements", res.elements, MAX_CONTEXT_ELEMENTS);
   return res;
 };
 var context_default = transformContext;
@@ -299,13 +386,14 @@ var transformFile = (child) => {
 var file_default = transformFile;
 
 // src/transformers/layout/header.tsx
-var import_react4 = __toESM(require("react"));
 var transformHeader = (child) => {
   const { text, blockId, emoji } = child.props;
-  warnIfTooLong("block_id", blockId, 255);
+  requireField("text", text);
+  warnIfTooLong("Header text", text, MAX_HEADER_TEXT);
+  warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
   const res = {
     type: "header",
-    text: transform(/* @__PURE__ */ import_react4.default.createElement(Text, { plainText: true, emoji }, text))
+    text: transform(/* @__PURE__ */ jsx(Text, { plainText: true, emoji, children: text }))
   };
   if (blockId) {
     res.block_id = blockId;
@@ -315,17 +403,19 @@ var transformHeader = (child) => {
 var header_default = transformHeader;
 
 // src/transformers/layout/image.tsx
-var import_react5 = __toESM(require("react"));
 var transformImageLayout = (child) => {
   const { url, alt, title, blockId } = child.props;
-  warnIfTooLong("block_id", blockId, 255);
+  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
   };
   if (title) {
-    res.title = transform(/* @__PURE__ */ import_react5.default.createElement(Text, { plainText: true }, title));
+    warnIfTooLong("Image title", title, MAX_IMAGE_TITLE);
+    res.title = transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: title }));
   }
   if (blockId) {
     res.block_id = blockId;
@@ -335,17 +425,16 @@ var transformImageLayout = (child) => {
 var image_default2 = transformImageLayout;
 
 // src/transformers/layout/input.tsx
-var import_react6 = __toESM(require("react"));
 var transformInput = (child) => {
   const { label, element, hint, optional, blockId } = child.props;
   warnIfTooLong("block_id", blockId, 255);
   const res = {
     type: "input",
-    label: transform(/* @__PURE__ */ import_react6.default.createElement(Text, { plainText: true }, label)),
+    label: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: label })),
     element: transform(element)
   };
   if (hint) {
-    res.hint = transform(/* @__PURE__ */ import_react6.default.createElement(Text, { plainText: true }, hint));
+    res.hint = transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: hint }));
   }
   if (optional) {
     res.optional = true;
@@ -412,7 +501,6 @@ var transformRichText = (child) => {
 var rich_text_default = transformRichText;
 
 // src/transformers/layout/video.tsx
-var import_react7 = __toESM(require("react"));
 var transformVideo = (child) => {
   const {
     title,
@@ -426,10 +514,10 @@ var transformVideo = (child) => {
     providerIconUrl,
     blockId
   } = child.props;
-  warnIfTooLong("block_id", blockId, 255);
+  warnIfTooLong("block_id", blockId, MAX_BLOCK_ID_LENGTH);
   const res = {
     type: "video",
-    title: transform(/* @__PURE__ */ import_react7.default.createElement(Text, { plainText: true }, title)),
+    title: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: title })),
     video_url: videoUrl,
     thumbnail_url: thumbnailUrl,
     alt_text: altText
@@ -438,7 +526,8 @@ var transformVideo = (child) => {
     res.title_url = titleUrl;
   }
   if (description) {
-    res.description = transform(/* @__PURE__ */ import_react7.default.createElement(Text, { plainText: true }, description));
+    warnIfTooLong("Video description", description, MAX_VIDEO_DESCRIPTION);
+    res.description = transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: description }));
   }
   if (authorName) {
     res.author_name = authorName;
@@ -457,7 +546,6 @@ var transformVideo = (child) => {
 var video_default = transformVideo;
 
 // src/transformers/input/text.tsx
-var import_react8 = __toESM(require("react"));
 var transformTextInput = (child) => {
   const {
     actionId,
@@ -478,7 +566,7 @@ var transformTextInput = (child) => {
     action_id: actionId
   };
   if (placeholder) {
-    res.placeholder = transform(/* @__PURE__ */ import_react8.default.createElement(Text, { plainText: true }, placeholder));
+    res.placeholder = transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: placeholder }));
   }
   if (initial) {
     res.initial_value = initial;
@@ -507,7 +595,8 @@ var text_default2 = transformTextInput;
 // src/transformers/input/date-time-picker.ts
 var transformDateTimePicker = (child) => {
   const { actionId, initialDateTime, confirm, focusOnLoad } = child.props;
-  warnIfTooLong("DateTimePicker action_id", actionId, 255);
+  requireField("actionId", actionId);
+  warnIfTooLong("DateTimePicker action_id", actionId, MAX_ACTION_ID_LENGTH);
   const res = {
     type: "datetimepicker",
     action_id: actionId
@@ -529,7 +618,6 @@ var transformDateTimePicker = (child) => {
 var date_time_picker_default = transformDateTimePicker;
 
 // src/transformers/input/date-picker.tsx
-var import_react9 = __toESM(require("react"));
 var isValidDateString = (value) => {
   const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
   if (!match) {
@@ -546,20 +634,21 @@ var isValidDateString = (value) => {
 };
 var transformDatePicker = (child) => {
   const { actionId, placeholder, initialDate, confirm, focusOnLoad } = child.props;
-  warnIfTooLong("DatePicker action_id", actionId, 255);
+  requireField("actionId", actionId);
+  warnIfTooLong("DatePicker action_id", actionId, MAX_ACTION_ID_LENGTH);
   if (placeholder) {
-    warnIfTooLong("DatePicker placeholder", placeholder, 150);
+    warnIfTooLong("DatePicker placeholder", placeholder, MAX_PLACEHOLDER_LENGTH);
   }
   const res = {
     type: "datepicker",
     action_id: actionId
   };
   if (placeholder) {
-    res.placeholder = transform(/* @__PURE__ */ import_react9.default.createElement(Text, { plainText: true }, placeholder));
+    res.placeholder = transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: placeholder }));
   }
   if (initialDate) {
     if (!isValidDateString(initialDate)) {
-      throw new Error("Date must be valid and in format YYYY-MM-DD.");
+      report("Date must be valid and in format YYYY-MM-DD.", "invalid-date-format");
     }
     res.initial_date = initialDate;
   }
@@ -576,7 +665,8 @@ var date_picker_default = transformDatePicker;
 // src/transformers/input/checkboxes.ts
 var transformCheckboxes = (child) => {
   const { actionId, children, initialOptions, confirm, focusOnLoad } = child.props;
-  warnIfTooLong("Checkboxes action_id", actionId, 255);
+  requireField("actionId", actionId);
+  warnIfTooLong("Checkboxes action_id", actionId, MAX_ACTION_ID_LENGTH);
   let elements = children;
   if (!Array.isArray(elements)) {
     elements = [elements];
@@ -599,11 +689,7 @@ var transformCheckboxes = (child) => {
 };
 var checkboxes_default = transformCheckboxes;
 
-// src/transformers/input/select.tsx
-var import_react11 = __toESM(require("react"));
-
 // src/components/input/select.tsx
-var import_react10 = __toESM(require("react"));
 var selectTypes = {
   STATIC: "static",
   EXTERNAL: "external",
@@ -611,9 +697,6 @@ var selectTypes = {
   CONVERSATION: "conversation",
   CHANNEL: "channel"
 };
-var Select = class extends import_react10.default.Component {
-};
-Select.slackType = "Select";
 
 // src/transformers/input/select.tsx
 var OPTION = "Option";
@@ -643,11 +726,9 @@ var assignStaticOptions = (elements, result) => {
     throw new TypeError("Only allowed types are Option OR OptionGroup");
   }
   if (elementType === OPTION) {
-    const options = elements;
-    result.options = options.map((element) => transform(element));
+    result.options = elements.map((element) => transform(element));
   } else if (elementType === OPTION_GROUP) {
-    const optionGroups = elements;
-    result.option_groups = optionGroups.map((element) => transform(element));
+    result.option_groups = elements.map((element) => transform(element));
   }
 };
 var applyInitialSelections = (type, isMulti, result, initialValues) => {
@@ -718,11 +799,13 @@ var transformSelect = (child) => {
   } = child.props;
   const type = typeProperty != null ? typeProperty : selectTypes.STATIC;
   const typeString = `${multi ? MULTI_PREFIX : ""}${types[type]}`;
-  warnIfTooLong("Select action_id", actionId, 255);
-  warnIfTooLong("Select placeholder", placeholder, 150);
+  requireField("actionId", actionId);
+  requireField("placeholder", placeholder);
+  warnIfTooLong("Select action_id", actionId, MAX_ACTION_ID_LENGTH);
+  warnIfTooLong("Select placeholder", placeholder, MAX_PLACEHOLDER_LENGTH);
   const result = {
     type: typeString,
-    placeholder: transform(/* @__PURE__ */ import_react11.default.createElement(Text, { plainText: true }, placeholder)),
+    placeholder: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: placeholder })),
     action_id: actionId
   };
   const elements = normalizeElements(children);
@@ -775,18 +858,19 @@ var transformSelect = (child) => {
 var select_default = transformSelect;
 
 // src/transformers/input/option.tsx
-var import_react12 = __toESM(require("react"));
 var transformOption = (child) => {
   const { children: text, value, url, description } = child.props;
-  warnIfTooLong("Option text", text, 75);
-  warnIfTooLong("Option value", value, 75);
-  warnIfTooLong("Option description", description, 75);
+  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__ */ import_react12.default.createElement(Text, { plainText: true }, text)),
+    text: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: text })),
     value
   };
   if (description) {
-    res.description = transform(/* @__PURE__ */ import_react12.default.createElement(Text, { plainText: true }, description));
+    res.description = transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: description }));
   }
   if (url) {
     res.url = url;
@@ -796,16 +880,16 @@ var transformOption = (child) => {
 var option_default = transformOption;
 
 // src/transformers/input/option-group.tsx
-var import_react13 = __toESM(require("react"));
 var transformOptionGroup = (child) => {
   const { label, children } = child.props;
-  warnIfTooLong("OptionGroup label", label, 75);
+  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__ */ import_react13.default.createElement(Text, { plainText: true }, label)),
+    label: transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: label })),
     options: options.map((option) => transform(option))
   };
 };
@@ -834,7 +918,8 @@ var overflow_default = transformOverflow;
 // src/transformers/input/radio-group.ts
 var transformRadioGroup = (child) => {
   const { actionId, children, initialOption, confirm, focusOnLoad } = child.props;
-  warnIfTooLong("RadioGroup action_id", actionId, 255);
+  requireField("actionId", actionId);
+  warnIfTooLong("RadioGroup action_id", actionId, MAX_ACTION_ID_LENGTH);
   let elements = children;
   if (!Array.isArray(elements)) {
     elements = [elements];
@@ -858,7 +943,6 @@ var transformRadioGroup = (child) => {
 var radio_group_default = transformRadioGroup;
 
 // src/transformers/input/time-picker.tsx
-var import_react14 = __toESM(require("react"));
 var isValidTimeString = (value) => {
   const match = /^(\d{2}):(\d{2})$/.exec(value);
   if (!match) {
@@ -870,20 +954,21 @@ var isValidTimeString = (value) => {
 };
 var transformTimePicker = (child) => {
   const { actionId, placeholder, initialTime, confirm, focusOnLoad } = child.props;
-  warnIfTooLong("TimePicker action_id", actionId, 255);
+  requireField("actionId", actionId);
+  warnIfTooLong("TimePicker action_id", actionId, MAX_ACTION_ID_LENGTH);
   if (placeholder) {
-    warnIfTooLong("TimePicker placeholder", placeholder, 150);
+    warnIfTooLong("TimePicker placeholder", placeholder, MAX_PLACEHOLDER_LENGTH);
   }
   const res = {
     type: "timepicker",
     action_id: actionId
   };
   if (placeholder) {
-    res.placeholder = transform(/* @__PURE__ */ import_react14.default.createElement(Text, { plainText: true }, placeholder));
+    res.placeholder = transform(/* @__PURE__ */ jsx(Text, { plainText: true, children: placeholder }));
   }
   if (initialTime) {
     if (!isValidTimeString(initialTime)) {
-      throw new Error("Time must be valid and in format HH:MM.");
+      report("Time must be valid and in format HH:MM.", "invalid-time-format");
     }
     res.initial_time = initialTime;
   }
@@ -1008,17 +1093,13 @@ var emoji_default = transformRichTextEmoji;
 
 // src/transformers/rich-text/date.ts
 var transformRichTextDate = (child) => {
-  const { timestamp, format, fallback, link } = child.props;
-  const res = {
+  const { timestamp, format, fallback } = child.props;
+  return {
     type: "date",
     timestamp,
     format,
     fallback
   };
-  if (link) {
-    res.link = link;
-  }
-  return res;
 };
 var date_default = transformRichTextDate;
 
@@ -1043,7 +1124,7 @@ var transformRichTextUserGroup = (child) => {
 var user_group_default = transformRichTextUserGroup;
 
 // src/transformers/index.ts
-var Transformers = {
+Object.assign(registry_default, {
   Container: container_default,
   Section: section_default,
   Actions: actions_default,
@@ -1081,33 +1162,9 @@ var Transformers = {
   RichTextDate: date_default,
   RichTextBroadcast: broadcast_default,
   RichTextUserGroup: user_group_default
-};
-var transformers_default = Transformers;
-var transform = (element) => {
-  const type = get_type_default(element);
-  if (!Transformers[type]) {
-    throw new Error(`No transformer exists for type '${type}'`);
-  }
-  return Transformers[type](element);
-};
+});
 
 // src/parser/index.ts
-var normalizeChildren2 = (children) => {
-  const result = [];
-  const stack = Array.isArray(children) ? [...children] : [children];
-  while (stack.length > 0) {
-    const child = stack.shift();
-    if (child === null || child === void 0 || typeof child === "boolean") {
-      continue;
-    }
-    if (Array.isArray(child)) {
-      stack.unshift(...child);
-      continue;
-    }
-    result.push(child);
-  }
-  return result;
-};
 var appendTransformed = (value, blocks) => {
   if (value === null || value === void 0 || typeof value === "boolean") {
     return;
@@ -1124,15 +1181,20 @@ var parseChildren = (children) => {
   if (typeof children === "string") {
     return { text: children };
   }
-  const normalizedChildren = normalizeChildren2(children);
+  const normalizedChildren = normalize_children_default(children);
   const transformedBlocks = [];
   for (const child of normalizedChildren) {
     const type = get_type_default(child);
-    const transformer = transformers_default[type];
+    const transformer = registry_default[type];
     if (transformer) {
-      appendTransformed(transformer(child), transformedBlocks);
+      pushPath(type);
+      try {
+        appendTransformed(transformer(child), transformedBlocks);
+      } finally {
+        popPath();
+      }
     } else if (type !== "null") {
-      console.warn(`No transformer for child type '${type}' exists and will be ignored.`);
+      report(`No transformer for component type '${type}'.`, "unknown-type");
     }
   }
   if (transformedBlocks.length === 0) {
@@ -1143,23 +1205,14 @@ var parseChildren = (children) => {
 var parser_default = parseChildren;
 
 // src/renderer/index.ts
-var render = (element) => {
-  const { props: properties = {} } = element || {};
-  const typeName = get_type_default(element);
-  if (typeName !== "Message") {
-    throw new TypeError("Provided top-level element must be a Message type.");
-  }
-  if (!properties.children) {
-    throw new Error("Cannot render a Message with no children.");
-  }
-  const json = { ...parser_default(properties.children) };
-  if (properties.replyTo) {
-    json.thread_ts = properties.replyTo;
-  }
-  if (properties.markdown !== void 0) {
-    json.mrkdwn = properties.markdown;
-  }
-  json.text = properties.text || "";
+var renderToBlocks = (element, options) => {
+  var _a, _b;
+  initContext((_a = options == null ? void 0 : options.validate) != null ? _a : "warn");
+  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 : [];
+};
+var applyMessageMetadata = (json, properties) => {
   if (properties.iconEmoji) {
     json.icon_emoji = properties.iconEmoji;
   }
@@ -1184,20 +1237,66 @@ var render = (element) => {
   if (properties.unfurlMedia !== void 0) {
     json.unfurl_media = properties.unfurlMedia;
   }
-  if (properties.color && json.blocks) {
-    json.attachments = [
-      {
-        fallback: json.text,
-        color: properties.color,
-        blocks: json.blocks
-      }
-    ];
-    delete json.blocks;
+};
+var render = (element, options) => {
+  var _a, _b;
+  initContext((_a = options == null ? void 0 : options.validate) != null ? _a : "warn");
+  const properties = element.props;
+  const typeName = get_type_default(element);
+  if (typeName !== "Message") {
+    throw new TypeError("Provided top-level element must be a Message type.");
   }
-  if (json.blocks) {
-    warnIfTooMany("Message blocks", json.blocks, 50);
+  if (!properties.children) {
+    throw new Error("Cannot render a Message with no children.");
+  }
+  pushPath("Message");
+  let json;
+  try {
+    json = { ...parser_default(properties.children) };
+    if (properties.replyTo) {
+      json.thread_ts = properties.replyTo;
+    }
+    if (properties.markdown !== void 0) {
+      json.mrkdwn = properties.markdown;
+    }
+    json.text = (_b = properties.text) != null ? _b : "";
+    if (properties.text && properties.text.length > MAX_MESSAGE_TEXT) {
+      warnIfTooLong(`Message text (Slack will truncate beyond ${MAX_MESSAGE_TEXT} chars)`, properties.text, MAX_MESSAGE_TEXT);
+    } else if (properties.text) {
+      warnIfTooLong("Message text (recommended max for best results)", properties.text, RECOMMENDED_MESSAGE_TEXT);
+    }
+    applyMessageMetadata(json, properties);
+    if (properties.color && json.blocks) {
+      json.attachments = [
+        {
+          fallback: json.text,
+          color: properties.color,
+          blocks: json.blocks
+        }
+      ];
+      delete json.blocks;
+    }
+    if (json.blocks) {
+      warnIfTooMany("Message blocks", json.blocks, MAX_BLOCKS);
+    }
+  } finally {
+    popPath();
   }
   return json;
 };
 var renderer_default = render;
+
+// src/utils/escape-mrkdwn.ts
+var escapeMrkdwn = (text) => text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll(/[*_~`]/g, "\u200B$&");
+
+// src/utils/block-kit-builder.ts
+var blockKitBuilderUrl = (blocks) => `https://app.slack.com/block-kit-builder#${JSON.stringify({ blocks })}`;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SlackblockValidationError,
+  blockKitBuilderUrl,
+  escapeMrkdwn,
+  renderToBlocks,
+  renderToMessage
+});
 //# sourceMappingURL=index.cjs.map