@wix/himalaya-cli 0.1145.0 → 0.1147.0

package/templates/beauty-salon/tier5-src/himi-store-product/index.ts

@@ -10,6 +10,8 @@ import { cleanTitle } from "../_shared/himi-text.js";
 import { stashCopy, copyParam, copyTemplate } from "../_shared/himi-copy.js";
 import { isBridgeUnavailable } from "../_shared/owner-load-error.js";
 import { isProductSaved, toggleSavedProduct } from "../_shared/himi-store-saved.js";
+import { openRichLink } from "../_shared/rich-content-link.js";
+import { richBody } from "../_shared/rich-body.js";
 
 // Offline-first (data-offline): the detail is a public READ-THROUGH — when the live
 // product fetch fails (offline) fall back to the last-synced row the catalog cached
@@ -120,11 +122,27 @@ function optionsHint(groups: StoreOption[], selection: StoreOptionSelection): st
   return copyTemplate("product.optionsChoose", "Choose {options}", { options: missing.join(", ") });
 }
 
+/** The description pair. V3's `description` is a Ricos OBJECT (the HTML `plainText` would throw on it): it
+ *  becomes the RichContent document, and `plainDescription` (or the document's own text) the plain copy. A V1
+ *  `description` is an HTML string: stripped text, no document. */
+function productBody(p: StoreProduct): { description: string; descriptionJson: string } {
+  const raw = (p as { description?: unknown }).description;
+  const html = plainText(p.plainDescription || (typeof raw === "string" ? raw : ""));
+  const { bodyJson, bodyText } = richBody(typeof raw === "string" ? null : raw, html);
+  return { description: html || bodyText, descriptionJson: bodyJson };
+}
+
 interface S {
   status: "loading" | "ready" | "error";
   name: string;
   price: string;
+  /** The plain-text description: RichContent's fallback, and what shows with no document. */
   description: string;
+  /** [rico] #3372 — a V3 product's Ricos `description` (read with `fields=DESCRIPTION`) as ONE document string
+   *  for RichContent; "" for a V1 HTML description, none, or a document the encoder rejected. */
+  descriptionJson: string;
+  /** descriptionJson !== "" — gates the plain text, because RichContent draws nothing for "". */
+  hasDescriptionJson: boolean;
   image: string;
   /** FULL media gallery (media.items[] with the main image first) — the detail
    *  screen renders a Carousel over it when 2+ images exist. */
@@ -253,6 +271,7 @@ function derive(s: S): S {
   const overflow = groups.length > OPTION_SLOTS;
   return {
     ...s,
+    hasDescriptionJson: s.descriptionJson !== "",
     ...slotsOf(groups, s.selection),
     hasOptions: groups.length > 0,
     noOptions: groups.length === 0,
@@ -296,12 +315,16 @@ const svc = defineService<S, {
   setCartCount: (s: S, arg?: unknown) => S;
   share: (s: S) => Promise<S>;
   toggleSave: (s: S) => S;
+  /** [rico] #3372 — RichContent's on_link: `{ url }` of the tapped link. */
+  openLink: (s: S, arg?: unknown) => Promise<S>;
 }>("himiStoreProduct", {
   state: derive({
     status: "loading",
     name: "",
     price: "",
     description: "",
+    descriptionJson: "",
+    hasDescriptionJson: false,
     image: "",
     gallery: [],
     hasGallery: false,
@@ -354,7 +377,7 @@ const svc = defineService<S, {
       if (!id) {
         lastProduct = undefined;
         lastLoadedId = undefined;
-        return derive({ ...s, status: "ready", quantity: 1, optionGroups: [], selection: {}, optionsUnknown: false, emptyText: copyParam("product.notFoundText", "Product not found.") });
+        return derive({ ...s, status: "ready", quantity: 1, optionGroups: [], selection: {}, optionsUnknown: false, descriptionJson: "", emptyText: copyParam("product.notFoundText", "Product not found.") });
       }
       // The cart count only feeds the top-bar badge: ask for it NOW, beside the product, instead
       // of after it — it used to add a whole cart round trip before the page could paint.
@@ -365,7 +388,8 @@ const svc = defineService<S, {
       void cartCount.then((n) => { cartKnown = n; }, () => {});
       // The live product read goes out FIRST too — the local-db read below must never delay it.
       // Settled into a value so a failure is handled where it is awaited, never unhandled.
-      const live = getStoreProduct(id).then(
+      // DESCRIPTION widens the default fieldset with the V3 Ricos description (a V1 catalog ignores it).
+      const live = getStoreProduct(id, ["DESCRIPTION"]).then(
         (r) => ({ ok: true as const, r }),
         () => ({ ok: false as const }),
       );
@@ -424,7 +448,7 @@ const svc = defineService<S, {
           optionsUnknown: false,
           name,
           price: productPrice(p),
-          description: plainText(p.plainDescription || p.description),
+          ...productBody(p),
           image,
           gallery: productGallery(p),
           initial: (name[0] || "#").toUpperCase(),
@@ -455,6 +479,7 @@ const svc = defineService<S, {
           name,
           price: String(synced.subtitle ?? ""),
           description: "",
+          descriptionJson: "",
           image,
           initial: String(synced.initial ?? "") || (name[0] || "#").toUpperCase(),
           cartHint: copyParam("product.cartHintOffline", "Reconnect to choose options and add this to your cart."),
@@ -464,7 +489,7 @@ const svc = defineService<S, {
       }
       lastProduct = undefined;
       lastLoadedId = undefined;
-      return derive({ ...s, status: "error", optionGroups: [], selection: {}, optionsUnknown: false, emptyText: copyParam("product.errorText", "Product could not load.") });
+      return derive({ ...s, status: "error", optionGroups: [], selection: {}, optionsUnknown: false, descriptionJson: "", emptyText: copyParam("product.errorText", "Product could not load.") });
     },
     // The stepper fires onChange with { value } on every tap; clamp 1–99 and
     // ignore unparsable/garbage args instead of silently zeroing the quantity.
@@ -519,6 +544,7 @@ const svc = defineService<S, {
         name,
         price: String(row.subtitle ?? ""),
         description: "",
+        descriptionJson: "",
         image: String(row.image ?? ""),
         gallery: [],
         initial: String(row.initial ?? "") || (name[0] || "#").toUpperCase(),
@@ -605,6 +631,11 @@ const svc = defineService<S, {
         return derive({ ...s, added: false, cartHint: copyParam("product.shareUnavailable", "Sharing is not available on this device.") });
       }
     },
+    // Only http(s), mailto and tel links reach open_url; a refused link, or one nothing opened, says so in the
+    // hint line (`added: false`, as for share, so it never renders inside the add-to-cart confirmation).
+    openLink: async (s, arg) => ((await openRichLink(arg))
+      ? s
+      : derive({ ...s, added: false, cartHint: copyParam("product.linkOpenFailed", "This link could not be opened.") })),
   },
 });
 

package/templates/beauty-salon-owner/tier5-src/_shared/rich-body.ts

@@ -14,15 +14,21 @@ export interface RichBody {
   bodyText: string;
 }
 
+/** [rico] #3372 — the media width for a document drawn in a LIST row (a feed post, a comment, a CMS item): the
+ *  list-image size (WIX_LIST_IMAGE), so a scrolling list never downloads every image at detail size. */
+export const ROW_IMAGE_WIDTH = 1000;
+
 /** Prepares `richContent` (a Ricos document, as a Wix API returns it, or its JSON string). No document, or one
  *  that is not a document, gives `{ bodyJson: "", bodyText: fallback }`. A document past the viewer's limits
  *  gives bodyJson "" and its plain text — except one rejected as too deep, which is not walked again (the
- *  plain-text walk has no depth limit), so `fallback` stands in for it. */
-export function richBody(richContent: unknown, fallback = ""): RichBody {
+ *  plain-text walk has no depth limit), so `fallback` stands in for it. `imageWidth` sizes its media (default
+ *  the 1400 px detail budget). */
+export function richBody(richContent: unknown, fallback = "", imageWidth = 1400): RichBody {
   const doc = parseRicosJson(richContent);
   if (!doc) return { bodyJson: "", bodyText: fallback };
-  // 1400 px — the detail-image budget, which is also the encoder's maximum.
-  const { json, rejected } = encodeRichContent(doc, { imageWidth: 1400 });
+  // 1400 px by default — the detail-image budget, which is also the encoder's maximum; list rows pass
+  // ROW_IMAGE_WIDTH.
+  const { json, rejected } = encodeRichContent(doc, { imageWidth });
   const text = rejected === "too_deep" ? "" : ricosToPlainText(doc);
   return { bodyJson: json, bodyText: text || fallback };
 }

package/templates/beauty-salon-owner/tier5-src/himi-owner-lite-home/index.ts

@@ -309,7 +309,12 @@ async function measuredRevenue7d(
     if (typeof measure.total === "number") return measure.total;
     const values = measure.values ?? [];
     return values.length ? values.reduce((sum, v) => sum + (v.value || 0), 0) : undefined;
-  } catch {
+  } catch (e) {
+    // The fallback is silent on screen (Home shows the order-row sum), so say it where
+    // an agent looks: the DEV panel's Console tab and `himi logs`. The status only — a Wix
+    // failure's message carries part of the upstream body, which may hold personal data.
+    const status = (e as { status?: unknown } | null)?.status ?? /\bHTTP (\d{3})\b/.exec(String(e))?.[1];
+    console.warn("[home.revenue] analytics failed; showing the order-row sum", status !== undefined ? `HTTP ${String(status)}` : "");
     return undefined;
   }
 }

package/templates/branded-lite/dev/index.ts

@@ -28190,7 +28190,32 @@ const SCREENS = runtimeSetting({
                               }
                             },
                             {
-                              "id": "",
+                              "id": "feed_body_$item.id",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "RichContent",
+                                "props": {
+                                  "documentJsonPath": "$item.bodyJson",
+                                  "onLink": {
+                                    "actionId": "tier5.himiBrandedFeed.openLink"
+                                  },
+                                  "fallback": {
+                                    "id": "",
+                                    "body": {
+                                      "package": "himalaya",
+                                      "type": "Text",
+                                      "props": {
+                                        "text": "$item.text",
+                                        "style": "body",
+                                        "maxLines": 6
+                                      }
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "id": "feed_body_text_$item.id",
                               "body": {
                                 "package": "himalaya",
                                 "type": "Text",
@@ -28199,6 +28224,9 @@ const SCREENS = runtimeSetting({
                                   "style": "body",
                                   "maxLines": 6
                                 }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$item.hasBodyJson"
                               }
                             },
                             {
@@ -28392,7 +28420,8 @@ const SCREENS = runtimeSetting({
       "integrity": "",
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
-        "wix_api"
+        "wix_api",
+        "open_url"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -48300,7 +48329,32 @@ const SCREENS = runtimeSetting({
                       }
                     },
                     {
-                      "id": "",
+                      "id": "forum_body",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "RichContent",
+                        "props": {
+                          "documentJsonPath": "$service:spacesForumPost.bodyJson",
+                          "onLink": {
+                            "actionId": "tier5.spacesForumPost.openLink"
+                          },
+                          "fallback": {
+                            "id": "",
+                            "body": {
+                              "package": "himalaya",
+                              "type": "Text",
+                              "props": {
+                                "text": "$service:spacesForumPost.body",
+                                "style": "body",
+                                "collapseWhenEmpty": true
+                              }
+                            }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      "id": "forum_body_text",
                       "body": {
                         "package": "himalaya",
                         "type": "Text",
@@ -48309,6 +48363,9 @@ const SCREENS = runtimeSetting({
                           "style": "body",
                           "collapseWhenEmpty": true
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:spacesForumPost.hasBodyJson"
                       }
                     }
                   ]
@@ -48584,7 +48641,8 @@ const SCREENS = runtimeSetting({
       "integrity": "",
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
-        "wix_api"
+        "wix_api",
+        "open_url"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -57815,7 +57873,32 @@ const SCREENS = runtimeSetting({
                                           "expandedPath": "$item.expanded",
                                           "content": [
                                             {
-                                              "id": "",
+                                              "id": "faq_answer_$item.id",
+                                              "body": {
+                                                "package": "himalaya",
+                                                "type": "RichContent",
+                                                "props": {
+                                                  "documentJsonPath": "$item.answerJson",
+                                                  "onLink": {
+                                                    "actionId": "tier5.himiBrandedFaq.openLink"
+                                                  },
+                                                  "fallback": {
+                                                    "id": "",
+                                                    "body": {
+                                                      "package": "himalaya",
+                                                      "type": "Text",
+                                                      "props": {
+                                                        "text": "$item.answer",
+                                                        "style": "body",
+                                                        "color": "textSecondary"
+                                                      }
+                                                    }
+                                                  }
+                                                }
+                                              }
+                                            },
+                                            {
+                                              "id": "faq_answer_text_$item.id",
                                               "body": {
                                                 "package": "himalaya",
                                                 "type": "Text",
@@ -57824,6 +57907,9 @@ const SCREENS = runtimeSetting({
                                                   "style": "body",
                                                   "color": "textSecondary"
                                                 }
+                                              },
+                                              "modifiers": {
+                                                "hiddenPath": "$item.hasAnswerJson"
                                               }
                                             }
                                           ],
@@ -58127,7 +58213,8 @@ const SCREENS = runtimeSetting({
       "integrity": "",
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
-        "wix_api"
+        "wix_api",
+        "open_url"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -79110,6 +79197,48 @@ const SCREENS = runtimeSetting({
                                   ]
                                 }
                               }
+                            },
+                            {
+                              "id": "cms_body_$item.id",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "RichContent",
+                                "props": {
+                                  "documentJsonPath": "$item.bodyJson",
+                                  "onLink": {
+                                    "actionId": "tier5.himiBrandedCmsCollection.openLink"
+                                  },
+                                  "fallback": {
+                                    "id": "",
+                                    "body": {
+                                      "package": "himalaya",
+                                      "type": "Text",
+                                      "props": {
+                                        "text": "$item.bodyText",
+                                        "style": "body",
+                                        "color": "textSecondary",
+                                        "collapseWhenEmpty": true
+                                      }
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "id": "cms_body_text_$item.id",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "$item.bodyText",
+                                  "style": "body",
+                                  "color": "textSecondary",
+                                  "collapseWhenEmpty": true
+                                }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$item.hasBodyJson"
+                              }
                             }
                           ]
                         }
@@ -79212,7 +79341,8 @@ const SCREENS = runtimeSetting({
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
         "wix_api",
-        "local_database"
+        "local_database",
+        "open_url"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -80501,7 +80631,33 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                               }
                             },
                             {
-                              "id": "",
+                              "id": "product_body",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "RichContent",
+                                "props": {
+                                  "documentJsonPath": "$service:himiStoreProduct.descriptionJson",
+                                  "onLink": {
+                                    "actionId": "tier5.himiStoreProduct.openLink"
+                                  },
+                                  "fallback": {
+                                    "id": "",
+                                    "body": {
+                                      "package": "himalaya",
+                                      "type": "Text",
+                                      "props": {
+                                        "text": "$service:himiStoreProduct.description",
+                                        "style": "body",
+                                        "color": "textSecondary",
+                                        "collapseWhenEmpty": true
+                                      }
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "id": "product_body_text",
                               "body": {
                                 "package": "himalaya",
                                 "type": "Text",
@@ -80511,6 +80667,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                   "color": "textSecondary",
                                   "collapseWhenEmpty": true
                                 }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$service:himiStoreProduct.hasDescriptionJson"
                               }
                             }
                           ]
@@ -81005,7 +81164,8 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
       "declaredCapabilities": [
         "wix_api",
         "share",
-        "local_database"
+        "local_database",
+        "open_url"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -84329,7 +84489,33 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                               }
                             },
                             {
-                              "id": "",
+                              "id": "event_body",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "RichContent",
+                                "props": {
+                                  "documentJsonPath": "$service:himiEventDetail.descriptionJson",
+                                  "onLink": {
+                                    "actionId": "tier5.himiEventDetail.openLink"
+                                  },
+                                  "fallback": {
+                                    "id": "",
+                                    "body": {
+                                      "package": "himalaya",
+                                      "type": "Text",
+                                      "props": {
+                                        "text": "$service:himiEventDetail.description",
+                                        "style": "body",
+                                        "color": "textSecondary",
+                                        "collapseWhenEmpty": true
+                                      }
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "id": "event_body_text",
                               "body": {
                                 "package": "himalaya",
                                 "type": "Text",
@@ -84339,6 +84525,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                   "color": "textSecondary",
                                   "collapseWhenEmpty": true
                                 }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$service:himiEventDetail.hasDescriptionJson"
                               }
                             }
                           ]
@@ -86233,7 +86422,33 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                       }
                                     },
                                     {
-                                      "id": "",
+                                      "id": "comment_body_$item.id",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "RichContent",
+                                        "props": {
+                                          "documentJsonPath": "$item.bodyJson",
+                                          "onLink": {
+                                            "actionId": "tier5.himiBlogPost.openLink"
+                                          },
+                                          "fallback": {
+                                            "id": "",
+                                            "body": {
+                                              "package": "himalaya",
+                                              "type": "Text",
+                                              "props": {
+                                                "text": "$item.text",
+                                                "style": "body",
+                                                "color": "textSecondary",
+                                                "collapseWhenEmpty": true
+                                              }
+                                            }
+                                          }
+                                        }
+                                      }
+                                    },
+                                    {
+                                      "id": "comment_body_text_$item.id",
                                       "body": {
                                         "package": "himalaya",
                                         "type": "Text",
@@ -86243,6 +86458,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                           "color": "textSecondary",
                                           "collapseWhenEmpty": true
                                         }
+                                      },
+                                      "modifiers": {
+                                        "hiddenPath": "$item.hasBodyJson"
                                       }
                                     }
                                   ]
@@ -87029,6 +87247,48 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                   ]
                                 }
                               }
+                            },
+                            {
+                              "id": "cms_body_$item.id",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "RichContent",
+                                "props": {
+                                  "documentJsonPath": "$item.bodyJson",
+                                  "onLink": {
+                                    "actionId": "tier5.himiBrandedCmsCollection.openLink"
+                                  },
+                                  "fallback": {
+                                    "id": "",
+                                    "body": {
+                                      "package": "himalaya",
+                                      "type": "Text",
+                                      "props": {
+                                        "text": "$item.bodyText",
+                                        "style": "body",
+                                        "color": "textSecondary",
+                                        "collapseWhenEmpty": true
+                                      }
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "id": "cms_body_text_$item.id",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "$item.bodyText",
+                                  "style": "body",
+                                  "color": "textSecondary",
+                                  "collapseWhenEmpty": true
+                                }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$item.hasBodyJson"
+                              }
                             }
                           ]
                         }
@@ -87131,7 +87391,8 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
         "wix_api",
-        "local_database"
+        "local_database",
+        "open_url"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"

package/templates/branded-lite/tier5-src/_shared/rich-body.ts

@@ -14,15 +14,21 @@ export interface RichBody {
   bodyText: string;
 }
 
+/** [rico] #3372 — the media width for a document drawn in a LIST row (a feed post, a comment, a CMS item): the
+ *  list-image size (WIX_LIST_IMAGE), so a scrolling list never downloads every image at detail size. */
+export const ROW_IMAGE_WIDTH = 1000;
+
 /** Prepares `richContent` (a Ricos document, as a Wix API returns it, or its JSON string). No document, or one
  *  that is not a document, gives `{ bodyJson: "", bodyText: fallback }`. A document past the viewer's limits
  *  gives bodyJson "" and its plain text — except one rejected as too deep, which is not walked again (the
- *  plain-text walk has no depth limit), so `fallback` stands in for it. */
-export function richBody(richContent: unknown, fallback = ""): RichBody {
+ *  plain-text walk has no depth limit), so `fallback` stands in for it. `imageWidth` sizes its media (default
+ *  the 1400 px detail budget). */
+export function richBody(richContent: unknown, fallback = "", imageWidth = 1400): RichBody {
   const doc = parseRicosJson(richContent);
   if (!doc) return { bodyJson: "", bodyText: fallback };
-  // 1400 px — the detail-image budget, which is also the encoder's maximum.
-  const { json, rejected } = encodeRichContent(doc, { imageWidth: 1400 });
+  // 1400 px by default — the detail-image budget, which is also the encoder's maximum; list rows pass
+  // ROW_IMAGE_WIDTH.
+  const { json, rejected } = encodeRichContent(doc, { imageWidth });
   const text = rejected === "too_deep" ? "" : ricosToPlainText(doc);
   return { bodyJson: json, bodyText: text || fallback };
 }

package/templates/branded-lite/tier5-src/himi-blog-post/index.ts

@@ -8,7 +8,7 @@ import { isSavedId, toggleSavedId } from "../_shared/himi-blog-saved";
 import { stashCopy, copyParam, copyTemplate } from "../_shared/himi-copy.js";
 import { formatDateMedium, formatMonthDay } from "../_shared/engine-intl.js";
 import { openRichLink } from "../_shared/rich-content-link.js";
-import { richBody } from "../_shared/rich-body.js";
+import { richBody, ROW_IMAGE_WIDTH } from "../_shared/rich-body.js";
 
 // Offline-first (data-offline): the post body is a public read-through — when the
 // live fetch fails (offline) fall back to the last-synced row the feed cached under
@@ -23,8 +23,14 @@ async function readCachedPost(id: string): Promise<DbEntity | null> {
 interface CommentRow {
   id: string;
   authorName: string;
+  /** The comment's plain text: the row RichContent's fallback. */
   text: string;
   meta: string;
+  /** [rico] #3372 — the comment's Ricos document as ONE string for the row's RichContent; "" when it has none
+   *  or the encoder rejected it. */
+  bodyJson: string;
+  /** bodyJson !== "" — gates the row's plain text, because RichContent draws nothing for "". */
+  hasBodyJson: boolean;
 }
 
 interface S {
@@ -168,11 +174,15 @@ function commentMeta(row: WixBlogCommentRow): string {
 }
 
 function toCommentRow(row: WixBlogCommentRow): CommentRow {
+  // The plain text is the document's own (runs joined as written, not space-separated) when it has one.
+  const { bodyJson, bodyText } = richBody(row.richContent, row.text || "Comment", ROW_IMAGE_WIDTH);
   return {
     id: row.id,
     authorName: row.authorName || "Member",
-    text: row.text || "Comment",
+    text: bodyText,
     meta: commentMeta(row),
+    bodyJson,
+    hasBodyJson: bodyJson !== "",
   };
 }