@assistant-ui/react-generative-ui 0.0.24 → 0.1.0

package/src/slack/toSlackBlocks.ts

@@ -1,1818 +0,0 @@
-import {
-  MAX_TRAVERSAL_DEPTH,
-  boundSpec,
-  clampReasonDetail,
-} from "../convert/boundSpec";
-import { copyBounded } from "../convert/copyBounded";
-import { isElement } from "../convert/isElement";
-import { takeRun } from "../convert/takeRun";
-import { classifyTemporal, splitTemporalMinutes } from "../temporal";
-import {
-  normalizeSpec,
-  type NormalizedUIElement,
-  type NormalizedUINode,
-} from "../ir";
-import {
-  factTrend,
-  formatFactDelta,
-  formatValue,
-} from "../vocabulary/formatValue";
-import {
-  ACTION_ID_CAP,
-  ACTIONS_ELEMENT_CAP,
-  ALERT_TEXT_CAP,
-  BUTTON_VALUE_CAP,
-  CARD_ACTIONS_CAP,
-  CARD_BODY_CAP,
-  CARD_SUBTEXT_CAP,
-  CARD_TITLE_CAP,
-  CAROUSEL_CARD_CAP,
-  CAROUSEL_CARD_MIN,
-  CHECKBOX_OPTION_CAP,
-  CONTEXT_ELEMENT_CAP,
-  CONTEXT_TEXT_CAP,
-  DATA_TABLE_CHAR_BUDGET,
-  DATA_TABLE_COLUMN_CAP,
-  DATA_TABLE_ROW_CAP,
-  FACT_FIELD_CAP,
-  FACT_FIELD_TEXT_CAP,
-  HEADER_TEXT_CAP,
-  INPUT_LABEL_CAP,
-  INTERACTIVE_TEXT_CAP,
-  MARKDOWN_TEXT_BUDGET,
-  MESSAGE_BLOCK_CAP,
-  MODAL_BLOCK_CAP,
-  PLACEHOLDER_TEXT_CAP,
-  RADIO_OPTION_CAP,
-  SECTION_TEXT_CAP,
-  SELECT_OPTION_CAP,
-  buildAlertBlock,
-  buildAlertFallback,
-  buildBlockBudgetNote,
-  buildCardBlock,
-  buildCarouselBlock,
-  buildDataTableBlock,
-} from "./constants";
-import type {
-  FieldMapping,
-  SlackActionElement,
-  SlackBlock,
-  SlackButtonElement,
-  SlackCardBlock,
-  SlackConversionWarning,
-  SlackDataTableCell,
-  SlackImageBlock,
-  SlackOption,
-  SlackPlainText,
-  SlackTextObject,
-  SlackBlocksResult,
-  ToSlackBlocksOptions,
-} from "./types";
-
-type ConversionContext = {
-  readonly blockCap: number;
-  readonly surface: "message" | "modal";
-  readonly warnings: SlackConversionWarning[];
-  readonly omittedPasswordNames: Set<string>;
-  fieldBlockIdSequence: number;
-  dateTimePairSequence: number;
-  markdownCharacters: number;
-  markdownExhausted: boolean;
-  dataTableCharacters: number;
-};
-
-const SLACK_BLOCK_ID_CAP = 255;
-
-const INTERACTIVE_TYPES = new Set([
-  "Button",
-  "Select",
-  "DatePicker",
-  "Checkbox",
-  "CheckboxGroup",
-  "RadioGroup",
-]);
-
-/**
- * Types whose control disappears when a card is reshaped to text. `Input` and
- * `Form` are not in {@link INTERACTIVE_TYPES} because they emit their own
- * block rather than an actions element, but a reshape loses them the same way,
- * and a `Form` gets a Submit button whether or not it carries an action.
- */
-const CONTROL_TYPES = new Set([
-  ...INTERACTIVE_TYPES,
-  "Input",
-  "Slider",
-  "Form",
-]);
-
-const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
-
-const isRecord = (value: unknown): value is Record<string, unknown> =>
-  typeof value === "object" && value !== null && !Array.isArray(value);
-
-const asString = (value: unknown): string =>
-  typeof value === "string" ? value : "";
-
-const asFiniteNumber = (value: unknown): number | undefined =>
-  typeof value === "number" && Number.isFinite(value) ? value : undefined;
-
-const warn = (
-  context: ConversionContext,
-  code: SlackConversionWarning["code"],
-  component: string,
-  detail: string,
-) => {
-  context.warnings.push({ code, component, detail });
-};
-
-const clampText = (
-  value: string,
-  cap: number,
-  component: string,
-  field: string,
-  context: ConversionContext,
-): string => {
-  if (value.length <= cap) return value;
-  warn(
-    context,
-    "clamped",
-    component,
-    `${field} was clamped to ${cap} characters.`,
-  );
-  return value.slice(0, cap);
-};
-
-const asActionId = (
-  action: unknown,
-  component: string,
-  context: ConversionContext,
-): string =>
-  clampText(
-    isRecord(action) && typeof action["type"] === "string"
-      ? action["type"]
-      : "action",
-    ACTION_ID_CAP,
-    component,
-    "action_id",
-    context,
-  );
-
-const plainText = (text: string): SlackPlainText => ({
-  type: "plain_text",
-  text,
-});
-
-const serializeFieldBlockId = (
-  sequence: number,
-  fields: readonly FieldMapping[],
-): string =>
-  `aui:${sequence}:${JSON.stringify(
-    fields.map(
-      ({ actionId, name, component, inputType, offset, part, pairId }) =>
-        inputType !== undefined
-          ? [
-              actionId,
-              name,
-              component,
-              inputType,
-              offset ?? null,
-              part ?? null,
-              pairId ?? null,
-            ]
-          : component === "Checkbox"
-            ? [actionId, name, "Checkbox"]
-            : [actionId, name],
-    ),
-  )}`;
-
-const fieldBlockId = (
-  fields: readonly FieldMapping[],
-  context: ConversionContext,
-): string | undefined => {
-  if (fields.length === 0) return undefined;
-  const sequence = context.fieldBlockIdSequence++;
-  const blockId = serializeFieldBlockId(sequence, fields);
-  if (blockId.length <= SLACK_BLOCK_ID_CAP) return blockId;
-  for (const field of fields) {
-    warn(
-      context,
-      "dropped",
-      field.component,
-      "name could not be mapped because its Slack block_id exceeded 255 characters.",
-    );
-  }
-  return undefined;
-};
-
-const collectOmittedPasswordNames = (
-  node: NormalizedUINode,
-  names: Set<string>,
-  depth = 0,
-): void => {
-  if (depth > MAX_TRAVERSAL_DEPTH) return;
-  if (Array.isArray(node)) {
-    for (const child of node) {
-      collectOmittedPasswordNames(child, names, depth + 1);
-    }
-  } else if (isElement(node)) {
-    if (
-      node.type === "Input" &&
-      node.props["inputType"] === "password" &&
-      typeof node.props["name"] === "string"
-    ) {
-      names.add(node.props["name"]);
-    }
-    if (node.children !== undefined) {
-      collectOmittedPasswordNames(node.children, names, depth + 1);
-    }
-  }
-};
-
-const withoutOmittedPasswordFallbacks = (
-  value: unknown,
-  names: ReadonlySet<string>,
-  depth = 0,
-): unknown => {
-  if (depth > MAX_TRAVERSAL_DEPTH) {
-    throw new RangeError("Action payload nests too deeply to sanitize.");
-  }
-  if (Array.isArray(value)) {
-    return value.map((item) =>
-      withoutOmittedPasswordFallbacks(item, names, depth + 1),
-    );
-  }
-  if (!isRecord(value)) return value;
-  if (
-    typeof value["$field"] === "string" &&
-    names.has(value["$field"]) &&
-    Object.keys(value).every((key) => key === "$field" || key === "fallback")
-  ) {
-    return { $field: value["$field"] };
-  }
-  return Object.fromEntries(
-    Object.entries(value).map(([key, item]) => [
-      key,
-      withoutOmittedPasswordFallbacks(item, names, depth + 1),
-    ]),
-  );
-};
-
-const actionValue = (
-  action: unknown,
-  context: ConversionContext,
-): string | undefined => {
-  if (!isRecord(action)) return undefined;
-  const { type: _type, ...payload } = action;
-  if (Object.keys(payload).length === 0) return undefined;
-  const serialized = JSON.stringify(
-    context.omittedPasswordNames.size === 0
-      ? payload
-      : withoutOmittedPasswordFallbacks(payload, context.omittedPasswordNames),
-  );
-  return serialized === "{}" ? undefined : serialized;
-};
-
-const buttonElement = (
-  label: string,
-  buttonStyle: unknown,
-  action: unknown,
-  component: string,
-  context: ConversionContext,
-): SlackButtonElement => {
-  let value: string | undefined;
-  try {
-    value = actionValue(action, context);
-  } catch {
-    warn(
-      context,
-      "dropped",
-      component,
-      "value was dropped because the action payload could not be serialized.",
-    );
-  }
-  if (value !== undefined && value.length > BUTTON_VALUE_CAP) {
-    warn(
-      context,
-      "dropped",
-      component,
-      "value was dropped because the action payload was too large to round-trip.",
-    );
-    value = undefined;
-  }
-  const style =
-    buttonStyle === "primary" || buttonStyle === "danger"
-      ? buttonStyle
-      : undefined;
-  return {
-    type: "button",
-    text: plainText(
-      clampText(label, INTERACTIVE_TEXT_CAP, component, "label", context),
-    ),
-    action_id: asActionId(action, component, context),
-    ...(value !== undefined ? { value } : {}),
-    ...(style !== undefined ? { style } : {}),
-  };
-};
-
-const optionFrom = (
-  value: unknown,
-  component: string,
-  context: ConversionContext,
-): SlackOption | undefined => {
-  if (
-    !isRecord(value) ||
-    typeof value["label"] !== "string" ||
-    typeof value["value"] !== "string"
-  ) {
-    return undefined;
-  }
-  const description = asString(value["description"]);
-  return {
-    text: plainText(
-      clampText(
-        value["label"],
-        INTERACTIVE_TEXT_CAP,
-        component,
-        "option label",
-        context,
-      ),
-    ),
-    value: value["value"],
-    ...(description
-      ? {
-          description: plainText(
-            clampText(
-              description,
-              INTERACTIVE_TEXT_CAP,
-              component,
-              "option description",
-              context,
-            ),
-          ),
-        }
-      : {}),
-  } as SlackOption;
-};
-
-const warnDroppedOptions = (
-  kept: number,
-  taken: number,
-  component: string,
-  context: ConversionContext,
-) => {
-  const dropped = taken - kept;
-  if (dropped === 0) return;
-  warn(
-    context,
-    "dropped",
-    component,
-    `${dropped} ${dropped === 1 ? "option was" : "options were"} dropped for want of a string label and value.`,
-  );
-};
-
-const toActionElement = (
-  element: NormalizedUIElement,
-  context: ConversionContext,
-): SlackActionElement | SlackActionElement[] | undefined => {
-  const { props, action } = element;
-  switch (element.type) {
-    case "Button":
-      return buttonElement(
-        asString(props["label"]),
-        props["buttonStyle"],
-        action,
-        "Button",
-        context,
-      );
-    case "Select": {
-      const rawOptions = Array.isArray(props["options"])
-        ? props["options"]
-        : [];
-      const { items: takenOptions, truncated } = copyBounded(
-        rawOptions,
-        SELECT_OPTION_CAP,
-      );
-      if (truncated) {
-        warn(
-          context,
-          "clamped",
-          "Select",
-          `options were clamped to ${SELECT_OPTION_CAP} entries.`,
-        );
-      }
-      const options = takenOptions
-        .map((option) => optionFrom(option, "Select", context))
-        .filter((option): option is SlackOption => option !== undefined);
-      warnDroppedOptions(
-        options.length,
-        takenOptions.length,
-        "Select",
-        context,
-      );
-      const placeholder = clampText(
-        asString(props["placeholder"]),
-        PLACEHOLDER_TEXT_CAP,
-        "Select",
-        "placeholder",
-        context,
-      );
-      const defaultValue = props["defaultValue"];
-      const initialOption =
-        typeof defaultValue === "string"
-          ? options.find((option) => option.value === defaultValue)
-          : undefined;
-      return {
-        type: "static_select",
-        action_id: asActionId(action, "Select", context),
-        options,
-        ...(initialOption !== undefined
-          ? { initial_option: initialOption }
-          : {}),
-        ...(placeholder ? { placeholder: plainText(placeholder) } : {}),
-      };
-    }
-    case "DatePicker": {
-      const rawDate = asString(props["value"]);
-      const inputType = props["inputType"];
-      if (inputType === "time" || inputType === "datetime") {
-        const actionId = asActionId(action, "DatePicker", context);
-        const temporal = classifyTemporal(rawDate);
-        const parts = splitTemporalMinutes(rawDate);
-        if (
-          (inputType === "time" && temporal.kind === "time") ||
-          (inputType === "datetime" && temporal.kind === "floating")
-        ) {
-          if (parts?.droppedPrecision) {
-            warn(
-              context,
-              "dropped",
-              "DatePicker",
-              "Seconds were dropped because Slack timepickers only support minute precision.",
-            );
-          }
-          const timePicker: SlackActionElement = {
-            type: "timepicker",
-            action_id: actionId,
-            initial_time: parts!.time,
-          };
-          return inputType === "time"
-            ? timePicker
-            : [
-                {
-                  type: "datepicker",
-                  action_id: actionId,
-                  initial_date: parts!.date!,
-                },
-                timePicker,
-              ];
-        }
-        if (inputType === "datetime" && temporal.kind === "instant") {
-          if (
-            temporal.epochMs % 1000 !== 0 ||
-            /[1-9]/.test(temporal.subMillisecondDigits ?? "")
-          ) {
-            warn(
-              context,
-              "dropped",
-              "DatePicker",
-              "Fractional seconds were dropped because Slack datetimepickers only support second precision.",
-            );
-          }
-          return {
-            type: "datetimepicker",
-            action_id: actionId,
-            initial_date_time: Math.floor(temporal.epochMs / 1000),
-          };
-        }
-        if (rawDate)
-          warn(
-            context,
-            "dropped",
-            "DatePicker",
-            `value did not match the ${inputType} format and was dropped.`,
-          );
-        return {
-          type: inputType === "time" ? "timepicker" : "datetimepicker",
-          action_id: actionId,
-        };
-      }
-      const initialDate = DATE_PATTERN.test(rawDate) ? rawDate : undefined;
-      if (rawDate && initialDate === undefined) {
-        warn(
-          context,
-          "dropped",
-          "DatePicker",
-          "value did not match the YYYY-MM-DD format and was dropped.",
-        );
-      }
-      return {
-        type: "datepicker",
-        action_id: asActionId(action, "DatePicker", context),
-        ...(initialDate !== undefined ? { initial_date: initialDate } : {}),
-      };
-    }
-    case "Checkbox": {
-      const label = clampText(
-        asString(props["label"]),
-        INTERACTIVE_TEXT_CAP,
-        "Checkbox",
-        "label",
-        context,
-      );
-      const name = asString(props["name"]);
-      const option: SlackOption = {
-        text: plainText(label),
-        value: name || label,
-      };
-      return {
-        type: "checkboxes",
-        action_id: asActionId(action, "Checkbox", context),
-        options: [option],
-        ...(props["defaultChecked"] === true
-          ? { initial_options: [option] }
-          : {}),
-      };
-    }
-    case "CheckboxGroup": {
-      const rawOptions = Array.isArray(props["options"])
-        ? props["options"]
-        : [];
-      const { items: takenOptions, truncated } = copyBounded(
-        rawOptions,
-        CHECKBOX_OPTION_CAP,
-      );
-      if (truncated) {
-        warn(
-          context,
-          "clamped",
-          "CheckboxGroup",
-          `options were clamped to ${CHECKBOX_OPTION_CAP} entries.`,
-        );
-      }
-      const options = takenOptions
-        .map((option) => optionFrom(option, "CheckboxGroup", context))
-        .filter((option): option is SlackOption => option !== undefined);
-      warnDroppedOptions(
-        options.length,
-        takenOptions.length,
-        "CheckboxGroup",
-        context,
-      );
-      const defaultValue = Array.isArray(props["defaultValue"])
-        ? props["defaultValue"]
-        : [];
-      const initialOptions = options.filter((option) =>
-        defaultValue.includes(option.value),
-      );
-      return {
-        type: "checkboxes",
-        action_id: asActionId(action, "CheckboxGroup", context),
-        options,
-        ...(initialOptions.length > 0
-          ? { initial_options: initialOptions }
-          : {}),
-      };
-    }
-    case "RadioGroup": {
-      const rawOptions = Array.isArray(props["options"])
-        ? props["options"]
-        : [];
-      const { items: takenOptions, truncated } = copyBounded(
-        rawOptions,
-        RADIO_OPTION_CAP,
-      );
-      if (truncated) {
-        warn(
-          context,
-          "clamped",
-          "RadioGroup",
-          `options were clamped to ${RADIO_OPTION_CAP} entries.`,
-        );
-      }
-      const options = takenOptions
-        .map((option) => optionFrom(option, "RadioGroup", context))
-        .filter((option): option is SlackOption => option !== undefined);
-      warnDroppedOptions(
-        options.length,
-        takenOptions.length,
-        "RadioGroup",
-        context,
-      );
-      const selectedValue =
-        typeof props["value"] === "string"
-          ? props["value"]
-          : asString(props["defaultValue"]);
-      const initialOption = options.find(
-        (option) => option.value === selectedValue,
-      );
-      return {
-        type: "radio_buttons",
-        action_id: asActionId(action, "RadioGroup", context),
-        options,
-        ...(initialOption !== undefined
-          ? { initial_option: initialOption }
-          : {}),
-      };
-    }
-    default:
-      return undefined;
-  }
-};
-
-const normalizedList = (
-  node: NormalizedUINode | undefined,
-): NormalizedUINode[] => {
-  if (node === undefined || node === null) return [];
-  if (!Array.isArray(node)) return [node];
-  return node.flatMap((child) => normalizedList(child));
-};
-
-const convertFacts = (
-  facts: readonly NormalizedUIElement[],
-  context: ConversionContext,
-): SlackBlock[] => {
-  const fields = facts.map((fact) => {
-    const label = asString(fact.props["label"]);
-    const value = asString(fact.props["value"]);
-    const delta = fact.props["delta"];
-    const deltaText =
-      typeof delta === "string"
-        ? formatFactDelta(delta, factTrend(delta, fact.props["trend"]))
-        : undefined;
-    return {
-      type: "mrkdwn" as const,
-      text: clampText(
-        `*${label}*\n${deltaText === undefined ? value : `${value} (${deltaText})`}`,
-        FACT_FIELD_TEXT_CAP,
-        "Fact",
-        "field",
-        context,
-      ),
-    };
-  });
-  const blocks: SlackBlock[] = [];
-  for (let index = 0; index < fields.length; index += FACT_FIELD_CAP) {
-    blocks.push({
-      type: "section",
-      fields: fields.slice(index, index + FACT_FIELD_CAP),
-    });
-  }
-  return blocks;
-};
-
-const convertActions = (
-  elements: readonly NormalizedUIElement[],
-  context: ConversionContext,
-): SlackBlock[] => {
-  const converted = elements.flatMap((source) => {
-    const result = toActionElement(source, context);
-    if (result === undefined) return [];
-    const controls = Array.isArray(result) ? result : [result];
-    const inputType =
-      source.type === "DatePicker" ? source.props["inputType"] : undefined;
-    const temporal =
-      inputType === "datetime"
-        ? classifyTemporal(asString(source.props["value"]))
-        : undefined;
-    const pairId =
-      controls.length > 1 ? context.dateTimePairSequence++ : undefined;
-    return controls.map((element) => {
-      const name = asString(source.props["name"]);
-      const field: FieldMapping | undefined =
-        inputType === "time" || inputType === "datetime"
-          ? {
-              actionId: element.action_id,
-              name,
-              component: source.type,
-              inputType,
-              ...(temporal?.kind === "instant"
-                ? { offset: temporal.offset }
-                : {}),
-              ...(pairId !== undefined
-                ? ({
-                    part: element.type === "datepicker" ? "date" : "time",
-                    pairId,
-                  } as const)
-                : {}),
-            }
-          : name
-            ? { actionId: element.action_id, name, component: source.type }
-            : undefined;
-      return { element, field };
-    });
-  });
-  const blocks: SlackBlock[] = [];
-  const groups: (typeof converted)[] = [];
-  let group: typeof converted = [];
-  let actionIds = new Set<string>();
-  const fieldsFor = (entries: typeof converted): FieldMapping[] =>
-    entries.flatMap(({ field }) => (field === undefined ? [] : [field]));
-  for (const entry of converted) {
-    const repeatedMappedActionId =
-      actionIds.has(entry.element.action_id) &&
-      (entry.field !== undefined ||
-        group.some(
-          (candidate) =>
-            candidate.element.action_id === entry.element.action_id &&
-            candidate.field !== undefined,
-        ));
-    if (group.length === ACTIONS_ELEMENT_CAP || repeatedMappedActionId) {
-      groups.push(group);
-      group = [];
-      actionIds = new Set();
-    }
-    group.push(entry);
-    actionIds.add(entry.element.action_id);
-  }
-  if (group.length > 0) groups.push(group);
-  const mappedGroups: (typeof converted)[] = [];
-  let nextSequence = context.fieldBlockIdSequence;
-  for (const entries of groups) {
-    let current: typeof converted = [];
-    for (const entry of entries) {
-      const candidate = [...current, entry];
-      const fields = fieldsFor(candidate);
-      const blockId =
-        fields.length > 0
-          ? serializeFieldBlockId(nextSequence, fields)
-          : undefined;
-      if (
-        current.length > 0 &&
-        fields.length > fieldsFor(current).length &&
-        blockId !== undefined &&
-        blockId.length > SLACK_BLOCK_ID_CAP
-      ) {
-        mappedGroups.push(current);
-        if (fieldsFor(current).length > 0) nextSequence += 1;
-        current = [entry];
-      } else {
-        current = candidate;
-      }
-    }
-    if (current.length > 0) {
-      mappedGroups.push(current);
-      if (fieldsFor(current).length > 0) nextSequence += 1;
-    }
-  }
-  for (const group of mappedGroups) {
-    const fields = fieldsFor(group);
-    const blockId = fieldBlockId(fields, context);
-    blocks.push({
-      type: "actions",
-      ...(blockId !== undefined ? { block_id: blockId } : {}),
-      elements: group.map(({ element }) => element),
-    });
-  }
-  return blocks;
-};
-
-const cardActionButtons = (
-  props: Readonly<Record<string, unknown>>,
-  context: ConversionContext,
-): SlackButtonElement[] => {
-  const buttons: SlackButtonElement[] = [];
-  for (const key of ["confirm", "cancel"] as const) {
-    const footer = props[key];
-    if (!isRecord(footer)) continue;
-    buttons.push(
-      buttonElement(
-        asString(footer["label"]),
-        key === "confirm" ? "primary" : undefined,
-        footer["$action"],
-        "Card",
-        context,
-      ),
-    );
-  }
-  return buttons;
-};
-
-const cardTitleText = (
-  props: Readonly<Record<string, unknown>>,
-  context: ConversionContext,
-): string | undefined => {
-  const rawTitle = asString(props["title"]);
-  return rawTitle
-    ? clampText(rawTitle, CARD_TITLE_CAP, "Card", "title", context)
-    : undefined;
-};
-
-const isCardNoOp = (node: NormalizedUINode): boolean =>
-  isElement(node) && (node.type === "Spacer" || node.type === "Icon");
-
-const collectText = (
-  node: NormalizedUINode | undefined,
-  depth: number,
-): string[] => {
-  if (node === undefined || node === null || depth > MAX_TRAVERSAL_DEPTH) {
-    return [];
-  }
-  if (typeof node === "string" || typeof node === "number") {
-    return [String(node)];
-  }
-  if (Array.isArray(node)) {
-    return node.flatMap((child) => collectText(child, depth + 1));
-  }
-  const element = node as NormalizedUIElement;
-  const own = ["text", "value", "label", "title", "description"]
-    .map((key) => element.props[key])
-    .filter((value): value is string => typeof value === "string");
-  return [...own, ...collectText(element.children, depth + 1)];
-};
-
-type CardFields = {
-  readonly heroImage: SlackImageBlock | undefined;
-  readonly bodyRaw: string | undefined;
-  readonly subtextRaw: string | undefined;
-  readonly leftover: readonly NormalizedUINode[];
-};
-
-/**
- * Scans a card's children for the pieces the native card block shape can
- * carry (a hero image, body text, and subtext), each taken from the first
- * matching child. Anything left over means the card cannot map cleanly onto
- * the native shape.
- */
-const extractCardFields = (element: NormalizedUIElement): CardFields => {
-  const children = normalizedList(element.children);
-  let heroImage: SlackImageBlock | undefined;
-  let bodyRaw: string | undefined;
-  let subtextRaw: string | undefined;
-  const leftover: NormalizedUINode[] = [];
-  for (const child of children) {
-    if (heroImage === undefined && isElement(child) && child.type === "Image") {
-      heroImage = {
-        type: "image",
-        image_url: asString(child.props["src"]),
-        alt_text: asString(child.props["alt"]),
-      };
-      continue;
-    }
-    if (
-      bodyRaw === undefined &&
-      isElement(child) &&
-      (child.type === "Text" || child.type === "Markdown")
-    ) {
-      bodyRaw = asString(child.props["value"]);
-      continue;
-    }
-    if (
-      subtextRaw === undefined &&
-      isElement(child) &&
-      child.type === "Caption"
-    ) {
-      subtextRaw = asString(child.props["value"]);
-      continue;
-    }
-    if (isCardNoOp(child)) continue;
-    leftover.push(child);
-  }
-  return { heroImage, bodyRaw, subtextRaw, leftover };
-};
-
-/** Assembles a native card block, clamping its body and subtext text. */
-const assembleCleanCard = (
-  titleText: string | undefined,
-  fields: CardFields,
-  buttons: readonly SlackButtonElement[],
-  context: ConversionContext,
-): SlackCardBlock => {
-  const body: SlackTextObject | undefined =
-    fields.bodyRaw !== undefined
-      ? {
-          type: "mrkdwn",
-          text: clampText(
-            fields.bodyRaw,
-            CARD_BODY_CAP,
-            "Card",
-            "body",
-            context,
-          ),
-        }
-      : undefined;
-  const subtext: SlackTextObject | undefined =
-    fields.subtextRaw !== undefined
-      ? {
-          type: "mrkdwn",
-          text: clampText(
-            fields.subtextRaw,
-            CARD_SUBTEXT_CAP,
-            "Card",
-            "subtext",
-            context,
-          ),
-        }
-      : undefined;
-  const { items: boundedButtons, truncated } = copyBounded(
-    buttons,
-    CARD_ACTIONS_CAP,
-  );
-  if (truncated) {
-    warn(
-      context,
-      "clamped",
-      "Card",
-      `actions were clamped to ${CARD_ACTIONS_CAP} entries.`,
-    );
-  }
-  return buildCardBlock({
-    ...(fields.heroImage !== undefined ? { heroImage: fields.heroImage } : {}),
-    ...(titleText !== undefined
-      ? { title: { type: "mrkdwn", text: titleText } }
-      : {}),
-    ...(body !== undefined ? { body } : {}),
-    ...(subtext !== undefined ? { subtext } : {}),
-    ...(boundedButtons.length > 0 ? { actions: boundedButtons } : {}),
-  });
-};
-
-/**
- * A card requires at least one of `hero_image`, `title`, `body`, or `actions`
- * (see {@link SlackCardBlock}); a card with none of them is not a valid
- * native block and must be dropped instead of emitted.
- */
-const isEmptyCard = (card: SlackCardBlock): boolean =>
-  card.hero_image === undefined &&
-  card.title === undefined &&
-  card.body === undefined &&
-  (card.actions === undefined || card.actions.length === 0);
-
-const convertCard = (
-  element: NormalizedUIElement,
-  context: ConversionContext,
-  depth: number,
-): SlackBlock[] => {
-  const titleText = cardTitleText(element.props, context);
-  const fields = extractCardFields(element);
-  const buttons = cardActionButtons(element.props, context);
-
-  if (fields.leftover.length > 0) {
-    warn(
-      context,
-      "fallback",
-      "Card",
-      "A card with content beyond hero_image, body, subtext, and actions was rendered inline.",
-    );
-    return [
-      ...(titleText
-        ? [{ type: "header" as const, text: plainText(titleText) }]
-        : []),
-      ...convertSequence(element.children, context, depth + 1),
-      ...(buttons.length > 0
-        ? [{ type: "actions" as const, elements: buttons }]
-        : []),
-    ];
-  }
-  const card = assembleCleanCard(titleText, fields, buttons, context);
-  if (isEmptyCard(card)) {
-    warn(
-      context,
-      "dropped",
-      "Card",
-      "A card with none of hero_image, title, body, or actions was dropped.",
-    );
-    return [];
-  }
-  return [card];
-};
-
-/** The content kinds a reshaped carousel card cannot carry, in report order. */
-const LOST_CONTENT_KINDS = ["images", "tables", "charts", "controls"] as const;
-
-const listPhrase = (items: readonly string[]): string =>
-  items.length <= 1
-    ? (items[0] ?? "")
-    : `${items.slice(0, -1).join(", ")} and ${items[items.length - 1]}`;
-
-/**
- * Collects the kinds of content a reshape drops, walking the same tree
- * {@link collectText} does so a node nested below the top level counts too.
- * These are exactly the pieces text cannot represent: an image has no text, a
- * table and a chart carry theirs in array props, and a control is behavior,
- * whether or not it carries an action of its own. An `$action` counts only on
- * a node that renders a control from it, since a `Box` or a `Row` carrying one
- * renders no control on the clean path either.
- */
-const scanLostContent = (
-  node: NormalizedUINode | undefined,
-  into: Set<string>,
-  depth: number,
-): void => {
-  if (depth > MAX_TRAVERSAL_DEPTH) return;
-  if (Array.isArray(node)) {
-    for (const child of node) scanLostContent(child, into, depth + 1);
-    return;
-  }
-  if (node === undefined || !isElement(node)) return;
-  if (
-    CONTROL_TYPES.has(node.type) ||
-    (node.type === "ListViewItem" && isRecord(node.action)) ||
-    (node.type === "Card" &&
-      (isRecord(node.props["confirm"]) || isRecord(node.props["cancel"])))
-  ) {
-    into.add("controls");
-  }
-  if (node.type === "Image") into.add("images");
-  if (node.type === "Table") into.add("tables");
-  if (node.type === "Chart") into.add("charts");
-  scanLostContent(node.children, into, depth + 1);
-};
-
-/**
- * Degrades a card that cannot map cleanly into a title-and-body card block.
- * A carousel cannot fall back to a block sequence like a standalone card can,
- * so the card is reshaped to the two text fields the block has. Text reachable
- * by {@link collectText} survives at any depth; an image, a table, a chart,
- * and a control do not, and are reported separately from the reshape itself.
- */
-const degradeCard = (
-  element: NormalizedUIElement,
-  context: ConversionContext,
-  depth: number,
-): SlackCardBlock => {
-  const rawTitle = asString(element.props["title"]);
-  const textChunks = collectText(element.children, depth + 1);
-  const titleSource = rawTitle || textChunks[0] || "";
-  const bodyChunks = rawTitle ? textChunks : textChunks.slice(1);
-  const titleText = clampText(
-    titleSource,
-    CARD_TITLE_CAP,
-    "Card",
-    "title",
-    context,
-  );
-  const bodyText = clampText(
-    bodyChunks.join("\n"),
-    CARD_BODY_CAP,
-    "Card",
-    "body",
-    context,
-  );
-  warn(
-    context,
-    "fallback",
-    "Card",
-    "A card inside a carousel was reshaped to title and body.",
-  );
-  const lostKinds = new Set<string>();
-  if (isRecord(element.props["confirm"]) || isRecord(element.props["cancel"])) {
-    lostKinds.add("controls");
-  }
-  scanLostContent(element.children, lostKinds, depth + 1);
-  const lost = LOST_CONTENT_KINDS.filter((kind) => lostKinds.has(kind));
-  if (lost.length > 0) {
-    warn(
-      context,
-      "dropped",
-      "Card",
-      `A reshaped carousel card's ${listPhrase(lost)} were dropped.`,
-    );
-  }
-  return buildCardBlock({
-    ...(titleText ? { title: { type: "mrkdwn", text: titleText } } : {}),
-    ...(bodyText ? { body: { type: "mrkdwn", text: bodyText } } : {}),
-  });
-};
-
-const convertCarouselCard = (
-  element: NormalizedUIElement,
-  context: ConversionContext,
-  depth: number,
-): SlackCardBlock | undefined => {
-  const fields = extractCardFields(element);
-  const card =
-    fields.leftover.length === 0
-      ? assembleCleanCard(
-          cardTitleText(element.props, context),
-          fields,
-          cardActionButtons(element.props, context),
-          context,
-        )
-      : degradeCard(element, context, depth);
-  if (isEmptyCard(card)) {
-    warn(
-      context,
-      "dropped",
-      "Card",
-      "A card with none of hero_image, title, body, or actions was dropped.",
-    );
-    return undefined;
-  }
-  return card;
-};
-
-const isBadgeOrCaption = (
-  node: NormalizedUINode,
-): node is NormalizedUIElement =>
-  isElement(node) && (node.type === "Badge" || node.type === "Caption");
-
-const contextRow = (
-  element: NormalizedUIElement,
-  context: ConversionContext,
-): SlackBlock[] | undefined => {
-  const allChildren = normalizedList(element.children);
-  const children = allChildren.filter(isBadgeOrCaption);
-  if (allChildren.length === 0 || children.length !== allChildren.length) {
-    return undefined;
-  }
-  const { items: boundedChildren, truncated } = copyBounded(
-    children,
-    CONTEXT_ELEMENT_CAP,
-  );
-  if (truncated) {
-    warn(
-      context,
-      "clamped",
-      "Row",
-      `context elements were clamped to ${CONTEXT_ELEMENT_CAP} entries.`,
-    );
-  }
-  return [
-    {
-      type: "context",
-      elements: boundedChildren.map((child) => ({
-        type: "mrkdwn",
-        text: clampText(
-          asString(child.props["value"]),
-          CONTEXT_TEXT_CAP,
-          child.type,
-          "value",
-          context,
-        ),
-      })),
-    },
-  ];
-};
-
-const convertListItem = (
-  element: NormalizedUIElement,
-  context: ConversionContext,
-  depth: number,
-): SlackBlock => {
-  const text = clampText(
-    collectText(element.children, depth + 1).join("\n"),
-    SECTION_TEXT_CAP,
-    "ListViewItem",
-    "text",
-    context,
-  );
-  const accessory = isRecord(element.action)
-    ? buttonElement("Open", undefined, element.action, "ListViewItem", context)
-    : undefined;
-  return {
-    type: "section",
-    text: { type: "mrkdwn", text },
-    ...(accessory !== undefined ? { accessory } : {}),
-  };
-};
-
-/**
- * Converts a child whose output is thrown away, and reports whether anything
- * was lost with it. A scratch context keeps the throwaway out of the shared
- * markdown and data-table budgets that surviving blocks still need; only its
- * `dropped` warnings are forwarded, because those describe the tree the caller
- * wrote, while a clamp or a fallback would describe content never delivered.
- */
-const discardedChild = (
-  child: NormalizedUINode,
-  context: ConversionContext,
-  depth: number,
-): boolean => {
-  const scratch: ConversionContext = { ...context, warnings: [] };
-  const produced = convertSequence(child, scratch, depth).length > 0;
-  const lost = scratch.warnings.filter((warning) => warning.code === "dropped");
-  context.warnings.push(...lost);
-  return produced || lost.length > 0;
-};
-
-const convertListView = (
-  element: NormalizedUIElement,
-  context: ConversionContext,
-  depth: number,
-): SlackBlock[] => {
-  const items: NormalizedUIElement[] = [];
-  let discarded = 0;
-  for (const child of normalizedList(element.children)) {
-    if (isElement(child) && child.type === "ListViewItem") {
-      items.push(child);
-      continue;
-    }
-    if (discardedChild(child, context, depth + 1)) discarded += 1;
-  }
-  if (discarded > 0) {
-    warn(
-      context,
-      "dropped",
-      "ListView",
-      `${discarded} non-item ${discarded === 1 ? "child was" : "children were"} dropped.`,
-    );
-  }
-  return items.flatMap((item, index) => [
-    ...(index > 0 ? [{ type: "divider" as const }] : []),
-    convertListItem(item, context, depth + 1),
-  ]);
-};
-
-const convertCarousel = (
-  element: NormalizedUIElement,
-  context: ConversionContext,
-  depth: number,
-): SlackBlock[] => {
-  const cardChildren: NormalizedUIElement[] = [];
-  let droppedCards = 0;
-  for (const child of normalizedList(element.children)) {
-    if (isElement(child) && child.type === "Card") {
-      cardChildren.push(child);
-      continue;
-    }
-    if (discardedChild(child, context, depth + 1)) droppedCards += 1;
-  }
-  if (droppedCards > 0) {
-    warn(
-      context,
-      "dropped",
-      "Carousel",
-      `${droppedCards} non-card ${droppedCards === 1 ? "child was" : "children were"} dropped.`,
-    );
-  }
-  const { items: boundedCards, truncated } = copyBounded(
-    cardChildren,
-    CAROUSEL_CARD_CAP,
-  );
-  if (truncated) {
-    warn(
-      context,
-      "clamped",
-      "Carousel",
-      `cards were clamped to ${CAROUSEL_CARD_CAP} entries.`,
-    );
-  }
-  const cards = boundedCards
-    .map((card) => convertCarouselCard(card, context, depth + 1))
-    .filter((card): card is SlackCardBlock => card !== undefined);
-  if (cards.length < CAROUSEL_CARD_MIN) {
-    warn(
-      context,
-      "dropped",
-      "Carousel",
-      "A carousel without renderable cards was dropped.",
-    );
-    return [];
-  }
-  return [buildCarouselBlock(cards)];
-};
-
-const toDataTableCell = (
-  value: unknown,
-  format: unknown,
-): SlackDataTableCell | undefined => {
-  if (typeof value === "number" && format === undefined) {
-    return { type: "raw_number", text: String(value) };
-  }
-  if (typeof value === "string" || typeof value === "boolean") {
-    return { type: "raw_text", text: formatValue(value, format) };
-  }
-  if (typeof value === "number") {
-    return { type: "raw_text", text: formatValue(value, format) };
-  }
-  return undefined;
-};
-
-const rowCharacters = (row: readonly SlackDataTableCell[]): number =>
-  row.reduce((sum, cell) => sum + cell.text.length, 0);
-
-const convertTable = (
-  element: NormalizedUIElement,
-  context: ConversionContext,
-): SlackBlock[] => {
-  const rawColumns = Array.isArray(element.props["columns"])
-    ? element.props["columns"]
-    : [];
-  const rawRows = Array.isArray(element.props["rows"])
-    ? element.props["rows"]
-    : [];
-  const { items: takenColumns, truncated: columnsTruncated } = copyBounded(
-    rawColumns,
-    DATA_TABLE_COLUMN_CAP,
-  );
-  const { items: takenRows, truncated: rowsTruncated } = copyBounded(
-    rawRows,
-    DATA_TABLE_ROW_CAP,
-  );
-  if (columnsTruncated) {
-    warn(
-      context,
-      "clamped",
-      "Table",
-      `columns were clamped to ${DATA_TABLE_COLUMN_CAP} entries.`,
-    );
-  }
-  if (rowsTruncated) {
-    warn(
-      context,
-      "clamped",
-      "Table",
-      `rows were clamped to ${DATA_TABLE_ROW_CAP} entries.`,
-    );
-  }
-
-  const unlabeled = takenColumns.filter(
-    (column) => !isRecord(column) || typeof column["label"] !== "string",
-  ).length;
-  if (unlabeled > 0) {
-    warn(
-      context,
-      "dropped",
-      "Table",
-      `${unlabeled} column ${unlabeled === 1 ? "header was" : "headers were"} left blank for want of a string label.`,
-    );
-  }
-  const columnHeaderRow: SlackDataTableCell[] = takenColumns.map((column) => ({
-    type: "raw_text" as const,
-    text: isRecord(column) ? asString(column["label"]) : "",
-  }));
-  const dataRows: SlackDataTableCell[][] = takenRows.map((row) =>
-    (Array.isArray(row)
-      ? copyBounded(row, DATA_TABLE_COLUMN_CAP).items
-      : []
-    ).map(
-      (value, index) =>
-        toDataTableCell(
-          value,
-          isRecord(takenColumns[index])
-            ? takenColumns[index]["format"]
-            : undefined,
-        ) ?? { type: "raw_text" as const, text: "" },
-    ),
-  );
-  const width = Math.max(
-    columnHeaderRow.length,
-    0,
-    ...dataRows.map((row) => row.length),
-  );
-  const padRow = (row: SlackDataTableCell[]): SlackDataTableCell[] =>
-    row.length >= width
-      ? row
-      : [
-          ...row,
-          ...Array.from({ length: width - row.length }, () => ({
-            type: "raw_text" as const,
-            text: "",
-          })),
-        ];
-  const headerRow = padRow(columnHeaderRow);
-
-  const headerCharacters = rowCharacters(headerRow);
-  if (context.dataTableCharacters + headerCharacters > DATA_TABLE_CHAR_BUDGET) {
-    warn(
-      context,
-      "dropped",
-      "Table",
-      `the table was dropped because its header row exceeds the ${DATA_TABLE_CHAR_BUDGET}-character table budget.`,
-    );
-    return [];
-  }
-
-  const kept: SlackDataTableCell[][] = [headerRow];
-  let tableCharacters = headerCharacters;
-  let budgetClamped = false;
-  for (const row of dataRows.map(padRow)) {
-    const chars = rowCharacters(row);
-    if (
-      context.dataTableCharacters + tableCharacters + chars >
-      DATA_TABLE_CHAR_BUDGET
-    ) {
-      budgetClamped = true;
-      break;
-    }
-    kept.push(row);
-    tableCharacters += chars;
-  }
-  context.dataTableCharacters += tableCharacters;
-  if (budgetClamped) {
-    warn(
-      context,
-      "clamped",
-      "Table",
-      `rows were clamped to fit the ${DATA_TABLE_CHAR_BUDGET}-character table budget.`,
-    );
-  }
-
-  return [buildDataTableBlock(kept)];
-};
-
-const convertElement = (
-  element: NormalizedUIElement,
-  context: ConversionContext,
-  depth: number,
-): SlackBlock[] => {
-  const { props } = element;
-  switch (element.type) {
-    case "Header":
-      return [
-        {
-          type: "header",
-          text: plainText(
-            clampText(
-              asString(props["text"]),
-              HEADER_TEXT_CAP,
-              "Header",
-              "text",
-              context,
-            ),
-          ),
-        },
-      ];
-    case "Text":
-      return [
-        {
-          type: "section",
-          text: {
-            type: "mrkdwn",
-            text: clampText(
-              asString(props["value"]),
-              SECTION_TEXT_CAP,
-              "Text",
-              "value",
-              context,
-            ),
-          },
-        },
-      ];
-    case "Caption":
-    case "Badge":
-      return [
-        {
-          type: "context",
-          elements: [
-            {
-              type: "mrkdwn",
-              text: clampText(
-                asString(props["value"]),
-                CONTEXT_TEXT_CAP,
-                element.type,
-                "value",
-                context,
-              ),
-            },
-          ],
-        },
-      ];
-    case "Fact":
-      return convertFacts([element], context);
-    case "Image":
-      return [
-        {
-          type: "image",
-          image_url: asString(props["src"]),
-          alt_text: asString(props["alt"]),
-        },
-      ];
-    case "Divider":
-      return [{ type: "divider" }];
-    case "Button":
-    case "Select":
-    case "DatePicker":
-    case "Checkbox":
-    case "CheckboxGroup":
-    case "RadioGroup":
-      return convertActions([element], context);
-    case "Slider": {
-      const label = clampText(
-        asString(props["label"]),
-        INPUT_LABEL_CAP,
-        "Slider",
-        "label",
-        context,
-      );
-      const min = asFiniteNumber(props["min"]);
-      const max = asFiniteNumber(props["max"]);
-      const step = asFiniteNumber(props["step"]);
-      const defaultValue = asFiniteNumber(props["defaultValue"]);
-      const actionId = asActionId(element.action, "Slider", context);
-      const name = props["name"];
-      const blockId = fieldBlockId(
-        typeof name === "string" && name.length > 0
-          ? [{ actionId, name, component: "Slider" }]
-          : [],
-        context,
-      );
-      return [
-        {
-          type: "input",
-          ...(blockId !== undefined ? { block_id: blockId } : {}),
-          label: plainText(label),
-          element: {
-            type: "number_input",
-            action_id: actionId,
-            ...(min !== undefined ? { min_value: min } : {}),
-            ...(max !== undefined ? { max_value: max } : {}),
-            ...(defaultValue !== undefined
-              ? { initial_value: defaultValue }
-              : {}),
-            ...([step, min, max, defaultValue].some(
-              (value) => value !== undefined && !Number.isInteger(value),
-            )
-              ? { is_decimal_allowed: true }
-              : {}),
-          },
-        } as unknown as SlackBlock,
-      ];
-    }
-    case "Input": {
-      if (props["inputType"] === "password") {
-        warn(
-          context,
-          "dropped",
-          "Input",
-          "Password input was replaced by a Slack omission note.",
-        );
-        return [
-          {
-            type: "context",
-            elements: [
-              { type: "mrkdwn", text: "Password input omitted on Slack." },
-            ],
-          },
-        ];
-      }
-      const label = clampText(
-        asString(props["label"]),
-        INPUT_LABEL_CAP,
-        "Input",
-        "label",
-        context,
-      );
-      const placeholder = clampText(
-        asString(props["placeholder"]),
-        PLACEHOLDER_TEXT_CAP,
-        "Input",
-        "placeholder",
-        context,
-      );
-      const actionId = asActionId(element.action, "Input", context);
-      const name = props["name"];
-      const blockId = fieldBlockId(
-        typeof name === "string" && name.length > 0
-          ? [{ actionId, name, component: "Input" }]
-          : [],
-        context,
-      );
-      const defaultValue = props["defaultValue"];
-      return [
-        {
-          type: "input",
-          ...(blockId !== undefined ? { block_id: blockId } : {}),
-          label: plainText(label),
-          element: {
-            type: "plain_text_input",
-            action_id: actionId,
-            ...(props["multiline"] === true &&
-            (props["inputType"] === undefined || props["inputType"] === "text")
-              ? { multiline: true }
-              : {}),
-            ...(typeof defaultValue === "string" && defaultValue
-              ? { initial_value: defaultValue }
-              : {}),
-            ...(placeholder ? { placeholder: plainText(placeholder) } : {}),
-          },
-        },
-      ];
-    }
-    case "Alert": {
-      const tone =
-        props["tone"] === "success" ||
-        props["tone"] === "warning" ||
-        props["tone"] === "danger"
-          ? props["tone"]
-          : "info";
-      const titleText = asString(props["title"]);
-      const description = asString(props["description"]);
-      if (context.surface === "modal") {
-        const combined = [titleText, description].filter(Boolean).join("\n");
-        return [
-          buildAlertBlock(
-            clampText(combined, ALERT_TEXT_CAP, "Alert", "text", context),
-            tone,
-          ),
-        ];
-      }
-      warn(
-        context,
-        "fallback",
-        "Alert",
-        "Alert was rendered with message-surface fallback blocks.",
-      );
-      return [
-        ...buildAlertFallback(
-          titleText,
-          clampText(
-            description,
-            SECTION_TEXT_CAP,
-            "Alert",
-            "description",
-            context,
-          ),
-          tone,
-        ),
-      ];
-    }
-    case "Card":
-      return convertCard(element, context, depth);
-    case "Carousel":
-      return convertCarousel(element, context, depth);
-    case "Col":
-    case "Box":
-      return convertSequence(element.children, context, depth + 1);
-    case "Row":
-      return (
-        contextRow(element, context) ??
-        convertSequence(element.children, context, depth + 1)
-      );
-    case "Spacer":
-    case "Icon":
-      return [];
-    case "Table":
-      return convertTable(element, context);
-    case "Markdown": {
-      const value = asString(props["value"]);
-      if (
-        !context.markdownExhausted &&
-        context.markdownCharacters + value.length <= MARKDOWN_TEXT_BUDGET
-      ) {
-        context.markdownCharacters += value.length;
-        return [{ type: "markdown", text: value }];
-      }
-      context.markdownExhausted = true;
-      warn(
-        context,
-        "fallback",
-        "Markdown",
-        `The ${MARKDOWN_TEXT_BUDGET}-character markdown budget was exceeded.`,
-      );
-      return [
-        {
-          type: "section",
-          text: {
-            type: "mrkdwn",
-            text: clampText(
-              value,
-              SECTION_TEXT_CAP,
-              "Markdown",
-              "fallback text",
-              context,
-            ),
-          },
-        },
-      ];
-    }
-    case "Chart":
-      warn(
-        context,
-        "dropped",
-        "Chart",
-        "Chart was replaced by a Slack omission note.",
-      );
-      return [
-        {
-          type: "context",
-          elements: [{ type: "mrkdwn", text: "Chart omitted on Slack." }],
-        },
-      ];
-    case "ListView":
-      return convertListView(element, context, depth);
-    case "ListViewItem":
-      return [convertListItem(element, context, depth)];
-    case "Form":
-      return [
-        ...convertSequence(element.children, context, depth + 1),
-        {
-          type: "actions",
-          elements: [
-            buttonElement("Submit", "primary", element.action, "Form", context),
-          ],
-        },
-      ];
-    default:
-      warn(
-        context,
-        "dropped",
-        element.type,
-        "Unknown component type was dropped.",
-      );
-      return [];
-  }
-};
-
-function convertSequence(
-  node: NormalizedUINode | undefined,
-  context: ConversionContext,
-  depth: number,
-): SlackBlock[] {
-  if (node === undefined || node === null || depth > MAX_TRAVERSAL_DEPTH) {
-    return [];
-  }
-  const nodes = Array.isArray(node) ? node : [node];
-  const blocks: SlackBlock[] = [];
-  for (let index = 0; index < nodes.length;) {
-    const current = nodes[index];
-    if (current === undefined || current === null) {
-      index += 1;
-      continue;
-    }
-    if (isElement(current) && current.type === "Fact") {
-      const { run: facts, next } = takeRun(
-        nodes,
-        index,
-        (candidate) => candidate.type === "Fact",
-      );
-      index = next;
-      blocks.push(...convertFacts(facts, context));
-      continue;
-    }
-    if (isElement(current) && INTERACTIVE_TYPES.has(current.type)) {
-      const { run: controls, next } = takeRun(nodes, index, (candidate) =>
-        INTERACTIVE_TYPES.has(candidate.type),
-      );
-      index = next;
-      blocks.push(...convertActions(controls, context));
-      continue;
-    }
-    if (typeof current === "string" || typeof current === "number") {
-      blocks.push({
-        type: "section",
-        text: {
-          type: "mrkdwn",
-          text: clampText(
-            String(current),
-            SECTION_TEXT_CAP,
-            "Text",
-            "value",
-            context,
-          ),
-        },
-      });
-    } else if (Array.isArray(current)) {
-      blocks.push(...convertSequence(current, context, depth + 1));
-    } else {
-      blocks.push(
-        ...convertElement(current as NormalizedUIElement, context, depth + 1),
-      );
-    }
-    index += 1;
-  }
-  return blocks;
-}
-
-/** Converts a generative-UI tree into Slack Block Kit JSON and downgrade warnings. */
-export function toSlackBlocks(
-  node: unknown,
-  options?: ToSlackBlocksOptions,
-): SlackBlocksResult {
-  const surface = options?.surface === "modal" ? "modal" : "message";
-  const context: ConversionContext = {
-    blockCap: surface === "modal" ? MODAL_BLOCK_CAP : MESSAGE_BLOCK_CAP,
-    surface,
-    warnings: [],
-    omittedPasswordNames: new Set(),
-    fieldBlockIdSequence: 0,
-    dateTimePairSequence: 0,
-    markdownCharacters: 0,
-    markdownExhausted: false,
-    dataTableCharacters: 0,
-  };
-  try {
-    const bounded = boundSpec(node, (reason) =>
-      warn(context, "clamped", "Root", clampReasonDetail(reason)),
-    );
-    const { root } = normalizeSpec(bounded as never);
-    collectOmittedPasswordNames(root, context.omittedPasswordNames);
-    const converted = convertSequence(root, context, 0);
-    if (converted.length <= context.blockCap) {
-      return { blocks: converted, warnings: context.warnings };
-    }
-    const kept = converted.slice(0, context.blockCap - 1);
-    const omitted = converted.length - kept.length;
-    warn(
-      context,
-      "clamped",
-      "Root",
-      `${omitted} ${omitted === 1 ? "block was" : "blocks were"} omitted.`,
-    );
-    return {
-      blocks: [...kept, buildBlockBudgetNote(omitted)],
-      warnings: context.warnings,
-    };
-  } catch {
-    return {
-      blocks: [],
-      warnings: [
-        {
-          code: "dropped",
-          component: "Root",
-          detail: "Input could not be converted.",
-        },
-      ],
-    };
-  }
-}