@wix/himalaya-cli 0.1145.0 → 0.1146.0

package/templates/restaurant/tier5-src/himi-events-detail/index.ts

@@ -35,6 +35,8 @@ import {
 } from "../_shared/himi-events";
 import { initials } from "../_shared/himi-text.js";
 import { stashCopy, copyParam, copyTemplate } from "../_shared/himi-copy.js";
+import { openRichLink } from "../_shared/rich-content-link.js";
+import { richBody } from "../_shared/rich-body.js";
 
 interface MapMarker {
   latitude: number;
@@ -88,7 +90,13 @@ interface S {
   initial: string;
   when: string;
   location: string;
+  /** The plain-text description: RichContent's fallback, the calendar notes, and what shows with no document. */
   description: string;
+  /** [rico] #3372 — the v3 Ricos `description` (read with `fields=TEXTS`) as ONE document string for
+   *  RichContent; "" when the event has none or the encoder rejected it. */
+  descriptionJson: string;
+  /** descriptionJson !== "" — gates the plain text, because RichContent draws nothing for "". */
+  hasDescriptionJson: boolean;
   image: string;
   hasImage: boolean;
   noImage: boolean;
@@ -212,6 +220,7 @@ function derive(s: S): S {
   const hasAttendees = s.attendeeAvatars.length > 0;
   return {
     ...s,
+    hasDescriptionJson: s.descriptionJson !== "",
     noMap: !s.mapUrl,
     hasMapMarkers,
     noMapMarkers: !hasMapMarkers,
@@ -357,6 +366,14 @@ async function attendeeSummary(eventId: string): Promise<{ goingLabel: string; a
   }
 }
 
+/** The description pair: the v3 Ricos `description` for RichContent, and its plain text. A string description
+ *  (or none) keeps `eventDescription`'s legacy read, with no document. */
+function eventBody(e: WixEvent): { description: string; descriptionJson: string } {
+  const legacy = eventDescription(e);
+  const { bodyJson, bodyText } = richBody((e as unknown as { description?: unknown }).description, legacy);
+  return { description: bodyText, descriptionJson: bodyJson };
+}
+
 /** getEvent returns the slim BASE fieldset (no `registration`); enrich from the
  *  richer query when the type is unknown — best-effort, find-by-id. */
 async function enrichRegistration(id: string, e: WixEvent): Promise<WixEvent> {
@@ -364,7 +381,11 @@ async function enrichRegistration(id: string, e: WixEvent): Promise<WixEvent> {
   try {
     const list = await queryEvents({ limit: 100 });
     const match = (list.events ?? []).find((candidate) => candidate.id === id);
-    return match ?? e;
+    if (!match) return e;
+    // [rico] #3372 — the query's rows are read without TEXTS, so they carry no Ricos `description`: keep the
+    // one this detail fetched, or the enrichment would silently drop the document on every real site.
+    const description = (e as unknown as { description?: unknown }).description;
+    return description === undefined ? match : ({ ...match, description } as unknown as WixEvent);
   } catch {
     return e;
   }
@@ -377,6 +398,8 @@ const svc = defineService<S, {
   openRegistration: (s: S) => Promise<S>;
   share: (s: S) => Promise<S>;
   addToCalendar: (s: S) => Promise<S>;
+  /** [rico] #3372 — RichContent's on_link: `{ url }` of the tapped link. */
+  openLink: (s: S, arg?: unknown) => Promise<S>;
 }>("himiEventDetail", {
   state: derive({
     status: "loading",
@@ -386,6 +409,8 @@ const svc = defineService<S, {
     when: "",
     location: "",
     description: "",
+    descriptionJson: "",
+    hasDescriptionJson: false,
     image: "",
     hasImage: false,
     noImage: true,
@@ -433,7 +458,8 @@ const svc = defineService<S, {
       const id = s.id || inputId();
       if (!id) return derive({ ...s, status: "ready", errored: true });
       try {
-        const res = await getEvent(id);
+        // TEXTS adds the Ricos `description` to the base fieldset (a bare read returns none).
+        const res = await getEvent(id, { fields: ["TEXTS"] });
         let e = ((res as unknown as { event?: WixEvent }).event ?? res) as WixEvent;
         e = await enrichRegistration(id, e);
         const attendees = await attendeeSummary(id);
@@ -460,7 +486,9 @@ const svc = defineService<S, {
           initial: (title.trim()[0] || "E").toUpperCase(),
           when: eventWhen(e),
           location: eventLocation(e),
-          description: eventDescription(e),
+          // The Ricos description when the event has one (its own text is the plain copy); the legacy
+          // string fields otherwise.
+          ...eventBody(e),
           image,
           hasImage: !!image,
           noImage: !image,
@@ -491,6 +519,9 @@ const svc = defineService<S, {
             initial: (title.trim()[0] || "E").toUpperCase(),
             when: cached.dateLine,
             location: cached.location,
+            // The cached list row carries no description: an offline retry of THIS event keeps the pair it
+            // already shows, and any other event's is cleared together, so neither half can linger alone.
+            ...(s.id === id ? {} : { description: "", descriptionJson: "" }),
             image: cached.image,
             hasImage: !!cached.image,
             noImage: !cached.image,
@@ -665,6 +696,12 @@ const svc = defineService<S, {
         return derive({ ...s, actionMessage: copyParam("event.calendarAddFailed", "Could not add this event to calendar."), isAddingCalendar: false });
       }
     },
+    // Only http(s), mailto and tel links reach open_url; a refused link, or one nothing opened, says so, and a
+    // link that opens clears an earlier message.
+    openLink: async (s, arg) => derive({
+      ...s,
+      actionMessage: (await openRichLink(arg)) ? "" : copyParam("event.linkOpenFailed", "This link could not be opened."),
+    }),
   },
 });
 svc.load();

package/templates/restaurant-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/retail-store/dev/index.ts

@@ -15643,7 +15643,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",
@@ -15653,6 +15679,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                   "color": "textSecondary",
                                   "collapseWhenEmpty": true
                                 }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$service:himiStoreProduct.hasDescriptionJson"
                               }
                             }
                           ]
@@ -16147,7 +16176,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"
@@ -17040,7 +17070,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",
@@ -17050,6 +17106,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                           "color": "textSecondary",
                                           "collapseWhenEmpty": true
                                         }
+                                      },
+                                      "modifiers": {
+                                        "hiddenPath": "$item.hasBodyJson"
                                       }
                                     }
                                   ]

package/templates/retail-store/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/retail-store/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 !== "",
   };
 }
 

package/templates/retail-store/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/retail-store-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/yoga-studio/dev/index.ts

@@ -26279,7 +26279,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",
@@ -26289,6 +26315,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                   "color": "textSecondary",
                                   "collapseWhenEmpty": true
                                 }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$service:himiEventDetail.hasDescriptionJson"
                               }
                             }
                           ]
@@ -28183,7 +28212,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",
@@ -28193,6 +28248,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                           "color": "textSecondary",
                                           "collapseWhenEmpty": true
                                         }
+                                      },
+                                      "modifiers": {
+                                        "hiddenPath": "$item.hasBodyJson"
                                       }
                                     }
                                   ]

package/templates/yoga-studio/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/yoga-studio/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 !== "",
   };
 }