@dextinity/mail-react 10.0.1 → 10.1.0

package/lib/blocks/richText/common.d.ts

@@ -6,8 +6,9 @@ export interface RichTextBlockData {
     draftContent: unknown;
 }
 export type RichTextBlockProps = PropsWithData<RichTextBlockData>;
+export type RichTextListKind = "unordered" | "ordered";
 /**
- * Styling for all draft blocks of one type, applied on top of the base theme text styles.
+ * Styling and list kind for all draft blocks of one type, on top of the base theme text styles.
  *
  * Style props accept plain values only. For responsive styling, use a theme
  * variant, or set a `className` and register responsive CSS via `registerStyles`.
@@ -20,6 +21,8 @@ export type RichTextBlockTypeProps = Omit<TextStyles, "bottomSpacing"> & {
      */
     variant?: VariantName;
     className?: string;
+    /** Renders every draft block of this type as a list of this kind. */
+    list?: RichTextListKind;
 };
 /**
  * Resolves the href of one link block type from the link block's props.
@@ -37,10 +40,11 @@ export type RichTextInlineRenderer = (children: ReactNode, options: {
 }) => ReactNode;
 export interface CreateRichTextBlockOptions<TLinkTypes extends Record<string, unknown> = Record<string, unknown>> {
     /**
-     * Maps draft block types (e.g. `"header-one"`, `"paragraph-standard"`) to the
-     * styling of the text component that renders them.
+     * Maps draft block types (e.g. `"header-one"`, `"paragraph-standard"`) to how
+     * they render.
      *
-     * Unmapped block types render with the base theme text styles.
+     * Unmapped block types render as paragraphs with the base theme text styles,
+     * apart from `unordered-list-item` and `ordered-list-item`.
      */
     blockTypes?: Record<string, RichTextBlockTypeProps>;
     /**

package/lib/blocks/richText/createRichTextRenderers.d.ts

@@ -1,7 +1,8 @@
 import type { ComponentType, PropsWithChildren } from "react";
 import type { Renderers } from "redraft";
 import type { RichTextBlockTypeProps, RichTextInlineRenderer, RichTextLinkHrefResolver } from "./common.js";
-export type BlockTextProps = PropsWithChildren<RichTextBlockTypeProps & {
+type BlockTypeTextProps = Omit<RichTextBlockTypeProps, "list">;
+export type BlockTextProps = PropsWithChildren<BlockTypeTextProps & {
     /** Whether the theme's spacing below the text applies — set for every draft block except the last. */
     bottomSpacing: boolean;
 }>;

package/lib/blocks/richText/createRichTextRenderers.js

@@ -56,23 +56,21 @@ function createListBlockRenderFn({ ordered, blockTextComponent: BlockText, block
         return (_jsx(BlockText, { bottomSpacing: false, ...blockTypeProps, children: _jsx(RichTextList, { ordered: ordered, variant: blockTypeProps.variant, bottomSpacing: !keys.includes(lastBlockKey), depth: depth, items: items }) }, key));
     };
 }
-const listBlockTypes = ["unordered-list-item", "ordered-list-item"];
+const builtInListKinds = {
+    "unordered-list-item": "unordered",
+    "ordered-list-item": "ordered",
+};
 export function createRichTextRenderers({ blockTypes, linkTypes, inline, blockTextComponent, lastBlockKey, }) {
     const blocks = {};
     // "unstyled" is redraft's blockFallback: registering it makes every block type the caller did not configure render with base theme styles.
-    for (const blockType of new Set(["unstyled", ...Object.keys(blockTypes)])) {
-        if (listBlockTypes.includes(blockType)) {
-            continue;
-        }
-        blocks[blockType] = createTextBlockRenderFn({ blockTextComponent, blockTypeProps: blockTypes[blockType] ?? {}, lastBlockKey });
-    }
-    for (const listBlockType of listBlockTypes) {
-        blocks[listBlockType] = createListBlockRenderFn({
-            ordered: listBlockType === "ordered-list-item",
-            blockTextComponent,
-            blockTypeProps: blockTypes[listBlockType] ?? {},
-            lastBlockKey,
-        });
+    for (const blockType of new Set(["unstyled", ...Object.keys(builtInListKinds), ...Object.keys(blockTypes)])) {
+        // `list` selects the renderer; the text component must not receive it.
+        const { list, ...blockTypeProps } = blockTypes[blockType] ?? {};
+        const listKind = list ?? builtInListKinds[blockType];
+        blocks[blockType] =
+            listKind === undefined
+                ? createTextBlockRenderFn({ blockTextComponent, blockTypeProps, lastBlockKey })
+                : createListBlockRenderFn({ ordered: listKind === "ordered", blockTextComponent, blockTypeProps, lastBlockKey });
     }
     return {
         inline: { ...inlineStyleRenderers, ...inline },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dextinity/mail-react",
-  "version": "10.0.1",
+  "version": "10.1.0",
   "description": "Utilities for building HTML emails with React",
   "license": "BSD-2-Clause",
   "type": "module",
@@ -48,8 +48,8 @@
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
     "vitest": "^4.1.8",
-    "@dextinity/cli": "10.0.1",
-    "@dextinity/eslint-config": "10.0.1"
+    "@dextinity/cli": "10.1.0",
+    "@dextinity/eslint-config": "10.1.0"
   },
   "peerDependencies": {
     "react": "^17.0.0 || ^18.0.0 || ^19.0.0",