@wix/himalaya-cli 0.1582.0 → 0.1584.0

package/templates/nonprofit-cause-owner/tier5-src/himi-owner-lite-service-form/index.ts

@@ -1,3 +1,6 @@
+import { descriptionBody } from "../_shared/rich-body.js";
+import { htmlIsTrivial, htmlPreviewText } from "../_shared/owner-rich-guard.js";
+import { parseRicosJson } from "@himalaya/wix-rich-content";
 // Tier-5 bundle: __HIMI_APP_NAME__ — edit Bookings service (the CRUD "U").
 // Opened from the service detail ("Edit"). EDIT-ONLY — the Bookings v2
 // service-create needs a full nested structure the generated client doesn't
@@ -31,6 +34,10 @@ interface ServiceFormState {
   heading: string;
   name: string;
   description: string;
+  originalDescription: unknown;
+  descriptionProtected: boolean;
+  descriptionEditable: boolean;
+  descriptionNote: string;
   category: string;
   status: "idle" | "loading" | "saving" | "saved" | "error";
   writeBusy: boolean;
@@ -79,6 +86,16 @@ function categoryName(s: WixService): string {
   return "";
 }
 
+function descriptionFields(value: unknown, known = true) {
+  const body = descriptionBody(value);
+  const protectedBody = !known || (value != null && (typeof value !== "string" || !!parseRicosJson(value)
+    || !htmlIsTrivial(value) || (!!htmlPreviewText(value).trim() && !body.bodyText)));
+  return { description: body.bodyText, originalDescription: known ? value ?? "" : undefined, descriptionProtected: protectedBody,
+    descriptionEditable: !protectedBody, descriptionNote: protectedBody
+      ? known ? copyParam("ownerServiceForm.richDescriptionNote", "This description has formatting or media. Edit it in your site dashboard to keep that content intact; the name can be changed here.")
+        : copyParam("ownerServiceForm.descriptionNotLoaded", "The description is not available yet. The name can be changed here.") : "" };
+}
+
 function shape(s: Partial<ServiceFormState>): ServiceFormState {
   const id = typeof s.id === "string" ? s.id : "";
   const savedId = typeof s.savedId === "string" ? s.savedId : id;
@@ -89,6 +106,10 @@ function shape(s: Partial<ServiceFormState>): ServiceFormState {
     heading: s.heading ?? copyParam("ownerServiceForm.headingEdit", "Edit service"),
     name: s.name ?? "",
     description: s.description ?? "",
+    originalDescription: s.originalDescription,
+    descriptionProtected: s.descriptionProtected ?? true,
+    descriptionEditable: s.descriptionProtected === false,
+    descriptionNote: s.descriptionNote ?? copyParam("ownerServiceForm.descriptionNotLoaded", "The description is not available yet. The name can be changed here."),
     category: s.category ?? "",
     status: s.status ?? "idle",
     writeBusy: s.writeBusy ?? false,
@@ -117,6 +138,8 @@ const svc = defineService<ServiceFormState, {
   submit: (s: ServiceFormState, values?: Record<string, unknown>) => Promise<ServiceFormState>;
 }>("himiOwnerLiteServiceForm", {
   state: shape({ id: initialId }),
+  notHydrated: ["originalDescription", "descriptionProtected", "descriptionEditable", "descriptionNote"],
+  perVisit: ["originalDescription", "descriptionProtected", "descriptionEditable", "descriptionNote"],
   actions: {
     load: async (s, arg): Promise<ServiceFormState | undefined> => landsOnLive(svc, s, await (async () => {
       stashCopy(arg); // absorb the descriptor's onAppear copy-pack param
@@ -130,7 +153,7 @@ const svc = defineService<ServiceFormState, {
           if (d) {
             return shape({
               ...s, id, heading: copyParam("ownerServiceForm.headingEdit", "Edit service"),
-              name: d.name, description: d.description, category: d.category,
+              name: d.name, ...descriptionFields(d.description), category: d.category,
               status: "idle", error: "", savedMessage: "", demoNote: copyParam("ownerCommon.demoNote", DEMO_NOTE),
             });
           }
@@ -144,7 +167,7 @@ const svc = defineService<ServiceFormState, {
           ...s, id, heading: copyParam("ownerServiceForm.headingEdit", "Edit service"),
           revision: String((svcObj as any).revision ?? ""),
           name: (svcObj as any).name ?? "",
-          description: (svcObj as any).description ?? "",
+          ...descriptionFields((svcObj as any).description),
           category: categoryName(svcObj),
           status: "idle", error: "", savedMessage: "",
         });
@@ -155,7 +178,7 @@ const svc = defineService<ServiceFormState, {
           return shape({
             ...s, id, heading: "Edit service",
             name: String(cached.name ?? cached.title ?? ""),
-            description: String(cached.description ?? ""),
+            ...descriptionFields(cached.description, Object.hasOwn(cached, "description")),
             category: String(cached.category ?? ""),
             status: "idle", error: "", savedMessage: "",
           });
@@ -165,7 +188,7 @@ const svc = defineService<ServiceFormState, {
           if (d) {
             return shape({
               ...s, id, heading: copyParam("ownerServiceForm.headingEdit", "Edit service"),
-              name: d.name, description: d.description, category: d.category,
+              name: d.name, ...descriptionFields(d.description), category: d.category,
               status: "idle", error: "", savedMessage: "", demoNote: copyParam("ownerCommon.demoNote", DEMO_NOTE),
             });
           }
@@ -177,25 +200,42 @@ const svc = defineService<ServiceFormState, {
       if (isOwnerPreviewDemo() || s.demoNote) return demoRefusal(s);
       const v = values ?? {};
       const targetId = s.id || (typeof v.id === "string" ? v.id : "");
+      const cached = !s.id && targetId ? await cacheGet(targetId) : null;
+      // Legacy queued payloads arrive without a loaded form. Read the current body before
+      // accepting their text, so replay cannot replace a rich description blindly.
+      if (!s.id && targetId) {
+        try {
+          const service = (await getService(targetId)).service;
+          if (!service?.id) return shape({ ...s, status: "error", error: copyParam("ownerServiceForm.errorNotFound", "Service not found") });
+          s = shape({ ...s, id: targetId, revision: String(service.revision ?? ""),
+            ...descriptionFields(service.description), category: categoryName(service) || String(cached?.category ?? "") });
+        } catch (error) {
+          return shape({ ...s, status: "error", error: ownerWriteError(error), savedMessage: "" });
+        }
+      }
       const name = String(v.name ?? s.name).trim();
       const description = String(v.description ?? s.description).trim();
+      const descriptionEdited = description !== descriptionBody(s.originalDescription).bodyText.trim();
+      if (s.descriptionProtected && descriptionEdited) return shape({ ...s, status: "error", error: s.descriptionNote, savedMessage: "" });
       if (!name) return shape({ ...s, status: "error", error: copyParam("ownerServiceForm.nameRequired", "Name is required"), savedMessage: "" });
       if (!targetId) return shape({ ...s, status: "error", error: copyParam("ownerServiceForm.errorNoService", "No service to edit."), savedMessage: "" });
 
-      const cached = !s.id ? await cacheGet(targetId) : null;
-      const localRow: DbEntity = { ...(cached ?? {}), id: targetId, name, title: name, description, category: s.category || String(cached?.category ?? "") };
+      const localRow: DbEntity = { ...(cached ?? {}), id: targetId, name, title: name,
+        ...(descriptionEdited || s.originalDescription !== undefined ? { description: descriptionEdited ? description : s.originalDescription } : {}),
+        category: s.category || String(cached?.category ?? "") };
       try {
         // v2 PATCH is a masked update requiring the current `revision` (optimistic
         // concurrency), captured from the getService on load. The response wraps
         // the UPDATED entity ({ service }) with its bumped revision — carry it
         // into state, or the SECOND consecutive save would send the stale
         // load-time revision and reject.
-        const res = await updateService(targetId, { name, ...(description ? { description } : {}), ...(s.revision ? { revision: s.revision } : {}) });
+        const res = await updateService(targetId, { name, ...(!s.descriptionProtected && descriptionEdited ? { description } : {}), ...(s.revision ? { revision: s.revision } : {}) });
         const bumped = String((res?.service as { revision?: unknown } | undefined)?.revision ?? "");
         // The local row follows only what Wix confirmed.
         await cachePut(localRow);
         return shape({
           ...s, id: targetId, name, description,
+          originalDescription: descriptionEdited ? description : s.originalDescription,
           revision: bumped || s.revision,
           status: "saved", error: "", savedMessage: copyParam("ownerServiceForm.savedMessage", "Service saved."),
           savedId: targetId,
@@ -211,4 +251,10 @@ const svc = defineService<ServiceFormState, {
   },
 });
 
+// Older binaries ignore notHydrated. Their restored preview must also stay read-only until load.
+if (!(globalThis as { himalaya?: { hydrationOptOut?: boolean } }).himalaya?.hydrationOptOut) {
+  Object.assign(svc.getState(), { originalDescription: undefined, descriptionProtected: true, descriptionEditable: false,
+    descriptionNote: copyParam("ownerServiceForm.descriptionNotLoaded", "The description is not available yet. The name can be changed here.") });
+}
+
 export { svc };

package/templates/nonprofit-cause-owner/tier5-src/himi-owner-lite-services/index.ts

@@ -8,7 +8,7 @@ import { queryServices, type WixService } from "@himalaya/wix-bookings";
 import { ownerLoadError, isOwnerPreviewDemo, ownerDemoFallback } from "../_shared/owner-load-error.js";
 import { DEMO_SERVICES, DEMO_NOTE } from "../_shared/owner-preview-demo.js";
 import { copyParam } from "../_shared/himi-copy.js";
-import { getAll, upsert, type DbEntity } from "../_shared/owner-local-db.js";
+import { get, getAll, upsert, type DbEntity } from "../_shared/owner-local-db.js";
 
 // Last-synced rows are an explicitly incomplete fallback for an unfiltered
 // request during an outage. Filtered pages never claim this cache is complete.
@@ -17,8 +17,10 @@ const ENTITY = "owner_services";
 async function readCachedRows(): Promise<ServiceRow[]> {
   try { return (await getAll(ENTITY)) as unknown as ServiceRow[]; } catch { return []; }
 }
+// A list row carries no description. Merge it over the stored row so a normal refresh keeps the
+// rich body the service form cached, as Products and Events do.
 async function writeCachedRows(rows: ServiceRow[]): Promise<void> {
-  try { for (const r of rows) await upsert(ENTITY, r as unknown as DbEntity); } catch { /* capability not granted → online-only */ }
+  try { for (const r of rows) await upsert(ENTITY, { ...await get(ENTITY, r.id), ...r } as unknown as DbEntity); } catch { /* capability not granted → online-only */ }
 }
 
 interface ServiceRow {

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

@@ -85225,6 +85225,35 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                 }
               }
             },
+            {
+              "id": "service_form.description_note",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteServiceForm.descriptionNote",
+                  "style": "footnote",
+                  "color": "textSecondary",
+                  "collapseWhenEmpty": true
+                }
+              }
+            },
+            {
+              "id": "service_form.description_preview",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteServiceForm.description",
+                  "style": "body",
+                  "maxLines": 8,
+                  "collapseWhenEmpty": true
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiOwnerLiteServiceForm.descriptionEditable"
+              }
+            },
             {
               "id": "service_form.form",
               "body": {
@@ -85269,6 +85298,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                             "multilineMaxLines": 3
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteServiceForm.descriptionProtected"
                       }
                     }
                   ],
@@ -87649,6 +87681,51 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                         }
                       }
                     },
+                    {
+                      "id": "product_body",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "RichContent",
+                        "props": {
+                          "documentJsonPath": "$service:himiOwnerLiteProduct.bodyJson",
+                          "onLink": {
+                            "actionId": "tier5.himiOwnerLiteProduct.openLink"
+                          },
+                          "fallback": {
+                            "id": "",
+                            "body": {
+                              "package": "himalaya",
+                              "type": "Text",
+                              "props": {
+                                "text": "$service:himiOwnerLiteProduct.bodyText",
+                                "style": "body",
+                                "color": "textPrimary",
+                                "collapseWhenEmpty": true
+                              }
+                            }
+                          }
+                        }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteProduct.noBodyJson"
+                      }
+                    },
+                    {
+                      "id": "product_body_text",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Text",
+                        "props": {
+                          "text": "$service:himiOwnerLiteProduct.bodyText",
+                          "style": "body",
+                          "color": "textPrimary",
+                          "collapseWhenEmpty": true
+                        }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteProduct.hasBodyJson"
+                      }
+                    },
                     {
                       "id": "product_info_card",
                       "body": {
@@ -88070,7 +88147,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"
@@ -88650,6 +88728,51 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                         }
                       }
                     },
+                    {
+                      "id": "service_body",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "RichContent",
+                        "props": {
+                          "documentJsonPath": "$service:himiOwnerLiteService.bodyJson",
+                          "onLink": {
+                            "actionId": "tier5.himiOwnerLiteService.openLink"
+                          },
+                          "fallback": {
+                            "id": "",
+                            "body": {
+                              "package": "himalaya",
+                              "type": "Text",
+                              "props": {
+                                "text": "$service:himiOwnerLiteService.bodyText",
+                                "style": "body",
+                                "color": "textPrimary",
+                                "collapseWhenEmpty": true
+                              }
+                            }
+                          }
+                        }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteService.noBodyJson"
+                      }
+                    },
+                    {
+                      "id": "service_body_text",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Text",
+                        "props": {
+                          "text": "$service:himiOwnerLiteService.bodyText",
+                          "style": "body",
+                          "color": "textPrimary",
+                          "collapseWhenEmpty": true
+                        }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteService.hasBodyJson"
+                      }
+                    },
                     {
                       "id": "service_info_card",
                       "body": {
@@ -88837,70 +88960,6 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                               "modifiers": {
                                 "hiddenPath": "$service:himiOwnerLiteService.capacityBlank"
                               }
-                            },
-                            {
-                              "id": "",
-                              "body": {
-                                "package": "himalaya",
-                                "type": "Divider",
-                                "props": {}
-                              },
-                              "modifiers": {
-                                "hiddenPath": "$service:himiOwnerLiteService.descriptionNoDivider"
-                              }
-                            },
-                            {
-                              "id": "service_row_description",
-                              "body": {
-                                "package": "himalaya",
-                                "type": "HStack",
-                                "props": {
-                                  "spacing": 0,
-                                  "children": [
-                                    {
-                                      "id": "",
-                                      "body": {
-                                        "package": "himalaya",
-                                        "type": "Text",
-                                        "props": {
-                                          "text": "Description",
-                                          "style": "footnote",
-                                          "color": "textSecondary"
-                                        }
-                                      },
-                                      "modifiers": {
-                                        "padding": {
-                                          "trailing": 10
-                                        }
-                                      }
-                                    },
-                                    {
-                                      "id": "",
-                                      "body": {
-                                        "package": "himalaya",
-                                        "type": "Spacer",
-                                        "props": {}
-                                      }
-                                    },
-                                    {
-                                      "id": "",
-                                      "body": {
-                                        "package": "himalaya",
-                                        "type": "Text",
-                                        "props": {
-                                          "text": "$service:himiOwnerLiteService.description",
-                                          "style": "bodyEmphasis",
-                                          "maxLines": 1,
-                                          "collapseWhenEmpty": true
-                                        }
-                                      }
-                                    }
-                                  ]
-                                }
-                              },
-                              "modifiers": {
-                                "hiddenPath": "$service:himiOwnerLiteService.descriptionBlank"
-                              }
                             }
                           ]
                         }
@@ -89020,7 +89079,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"
@@ -89485,6 +89545,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                             }
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteEvent.noBodyJson"
                       }
                     },
                     {
@@ -90493,6 +90556,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                             }
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLitePost.noBodyJson"
                       }
                     },
                     {

package/templates/owner-lite/tier5-src/_shared/collection-contract.ts

@@ -19,6 +19,8 @@ export interface CollectionConfig {
   /** Numeric 0–5 row field rendered as a Rating (accessible "N out of 5") instead of
    *  folding a "★★★★☆" glyph string into the metadata line, so screen readers get a value. */
   rating?: string;
+  /** Domain-provided calendar text and its unavailable flag, kept separate from media. */
+  dateBadge?: { text: string; hidden: string };
   sectioned?: boolean;
   view: 'list' | 'grid';
   backendQuery?: boolean;
@@ -38,7 +40,13 @@ export interface CollectionConfig {
   /** The card's primary verb, shown as a visible button beside the overflow.
    * `screenId` opens that screen with the row id; without it the verb reuses the
    * row's own tap action (the detail screen that owns the verb). */
-  primaryVerb?: { label: string; screenId?: string };
+  primaryVerb?: { label: string; screenId?: string;
+    /** A row field holding THIS row's verb label (Register, RSVP, Buy Tickets…); `label` stays the fallback copy. */
+    labelPath?: string;
+    /** A row boolean that hides the verb on rows that offer no action (an event with no registration). */
+    hiddenPath?: string };
+  /** The worker action that shares a row (`tier5.<service>.<name>` with `{ id }`): adds Share to the card's overflow menu. */
+  shareAction?: string;
   /** A TIME-BOUND entity (an event, a booking, a reservation): the boolean row field the
    *  DOMAIN sets once the record has finished — computed by the same rule as the row's own
    *  "Past" label, in the same place, so the two cannot disagree. A finished
@@ -73,7 +81,7 @@ export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiBookingBookings: { rows: 'rows', title: 'title', subtitle: 'subtitle', metadata: ['status'], view: 'list', backendQuery: true,
     defaultFilter: 'value:Upcoming', searchPlaceholder: 'Search by booking ID', countNoun: ['booking', 'bookings'], filterValues: ['Upcoming', 'Past', 'Cancelled'],
     sortLabels: { default: 'Soonest', az: 'Oldest', za: 'Latest' } },
-  himiEvents: { rows: 'results', title: 'title', subtitle: 'dateLine', image: 'image', view: 'grid', backendQuery: true, defaultFilter: 'value:Upcoming', searchPlaceholder: 'Search events', countNoun: ['event', 'events'], filterValues: ['Upcoming', 'Past'], sortLabels: { default: 'Date', az: 'Title A–Z', za: 'Title Z–A' }, primaryVerb: { label: 'Register' }, endedWhen: 'isPast' },
+  himiEvents: { rows: 'results', title: 'title', subtitle: 'dateLine', image: 'image', dateBadge: { text: 'dateBadge', hidden: 'noDateBadge' }, gridColumns: 1, view: 'grid', backendQuery: true, defaultFilter: 'value:Upcoming', searchPlaceholder: 'Search events', countNoun: ['event', 'events'], filterValues: ['Upcoming', 'Past'], sortLabels: { default: 'Date', az: 'Title A–Z', za: 'Title Z–A' }, primaryVerb: { label: 'Register', labelPath: 'actionLabel', hiddenPath: 'noAction' }, shareAction: 'share', endedWhen: 'isPast' },
   himiBlogFeed: { rows: 'posts', title: 'title', subtitle: 'excerpt', image: 'image', filter: 'category', filterValuesFrom: 'categories', view: 'grid', narrowedBy: 'selectedCategoryId' },
   himiOwnerLiteProducts: { rows: 'products', title: 'name', subtitle: 'price', image: 'image', view: 'grid', backendQuery: true, countNoun: ['product', 'products'] },
   himiOwnerModules: { instanceInput: 'module', rows: 'rows', title: 'title', subtitle: 'subtitle', image: 'image', filter: 'statusLabel', view: 'list', paged: true, reviewAction: 'prepareRecord', reviewSelectedAction: 'prepareSelected' },
@@ -208,7 +216,15 @@ export function projectCollection(source: CollectionRow[], config: CollectionCon
       ...(config.endedWhen ? (() => {
         const ended = row[config.endedWhen] === true || (config.endedWhen === 'isPast' && row.statusLabel === 'Past');
         return { collectionEnded: ended, collectionNotEnded: !ended };
-      })() : {}) })),
+      })() : {}),
+      // A row restored from state saved by an older build has no badge flag. An unset hidden flag
+      // fails open and would paint an empty chip, so it reads as "no badge" until a refresh.
+      ...(config.dateBadge && typeof row[config.dateBadge.hidden] !== 'boolean'
+        ? { [config.dateBadge.text]: '', [config.dateBadge.hidden]: true } : {}),
+      // Same for a per-row verb: an unset hidden flag fails open and would show a verb with an unresolved
+      // label, so a row without the flag offers no action until a refresh establishes one.
+      ...(config.primaryVerb?.hiddenPath && typeof row[config.primaryVerb.hiddenPath] !== 'boolean'
+        ? { ...(config.primaryVerb.labelPath ? { [config.primaryVerb.labelPath]: '' } : {}), [config.primaryVerb.hiddenPath]: true } : {}) })),
     filters, loaded: rows.length,
   };
 }

package/templates/owner-lite/tier5-src/himi-owner-lite-event/index.ts

@@ -12,7 +12,7 @@ import { ownerLoadError, isOwnerPreviewDemo, ownerDemoFallback, ownerWriteError,
 import { DEMO_EVENTS, DEMO_NOTE, DEMO_SAVE_NOTE } from "../_shared/owner-preview-demo.js";
 import { stashCopy, copyParam } from "../_shared/himi-copy.js";
 import { openRichLink } from "../_shared/rich-content-link.js";
-import { richBody } from "../_shared/rich-body.js";
+import { descriptionBody } from "../_shared/rich-body.js";
 import { get as dbGet, upsert as dbUpsert, remove as dbRemove, type DbEntity } from "../_shared/owner-local-db.js";
 import { blankFlags } from "../_shared/detail-facts.js";
 
@@ -41,6 +41,7 @@ interface EventState {
   bodyJson: string;
   /** bodyJson !== "" — gates the plain text, because RichContent draws nothing for "". */
   hasBodyJson: boolean;
+  noBodyJson: boolean;
   /** The description's plain text (the document's own text, else the legacy description). */
   bodyText: string;
   initial: string;
@@ -68,15 +69,15 @@ interface EventState {
 }
 
 /* eslint-disable @typescript-eslint/no-explicit-any */
-/** [rico] #3499 — keep the description's plain text with the event's cached row, so the offline detail shows it.
+/** [rico] #3499 — keep the description pair with the event's cached row, so the offline detail shows it.
  *  Merged into the row the events list (or the form) wrote rather than replacing it; with no row yet, the
  *  loaded detail's own fields become one. */
 async function cacheBodyText(s: EventState): Promise<void> {
   if (s.status !== "ready" || !s.id) return;
   const prev = await cacheGet(s.id);
-  await cachePut(prev ? { ...prev, bodyText: s.bodyText } : {
+  await cachePut(prev ? { ...prev, bodyText: s.bodyText, bodyJson: s.bodyJson } : {
     id: s.id, title: s.title, subtitle: s.subtitle, image: s.image, dateLine: s.dateLine, location: s.location,
-    statusLabel: s.statusLabel, registration: s.registration, bodyText: s.bodyText,
+    statusLabel: s.statusLabel, registration: s.registration, bodyText: s.bodyText, bodyJson: s.bodyJson,
   });
 }
 function idFrom(arg: unknown, fallback = ""): string {
@@ -132,6 +133,7 @@ function shapeFields(s: Partial<EventState>): EventState {
     summary: s.summary ?? "",
     bodyJson: s.bodyJson ?? "",
     hasBodyJson: !!s.bodyJson,
+    noBodyJson: !s.bodyJson,
     bodyText: s.bodyText ?? "",
     initial: s.initial ?? "?",
     image,
@@ -186,6 +188,7 @@ function cachedDetail(s: EventState, row: DbEntity): EventState {
   const title = String(row.title ?? row.name ?? "");
   const dateLine = String(row.dateLine ?? row.when ?? "");
   const location = String(row.location ?? "");
+  const body = descriptionBody(row.bodyJson || row.description, descriptionBody(row.bodyText ?? row.summary).bodyText);
   return shape({
     ...s,
     id: String(row.id),
@@ -193,8 +196,8 @@ function cachedDetail(s: EventState, row: DbEntity): EventState {
     title,
     subtitle: String(row.subtitle ?? [dateLine, location].filter((x) => x && x !== "—").join(" · ")),
     summary: "",
-    bodyJson: "",
-    bodyText: String(row.bodyText ?? row.summary ?? row.description ?? ""),
+    bodyJson: body.bodyJson,
+    bodyText: body.bodyText,
     initial: String(row.initial ?? (title[0] || "?")).slice(0, 1).toUpperCase(),
     image: String(row.image ?? ""),
     dateLine: dateLine || "—",
@@ -216,9 +219,9 @@ async function refresh(prev: EventState, id: string): Promise<EventState> {
   }
   const row = normalizeEvent(ev); // reuses date/location/status normalization
   const image = /^https?:\/\//.test(row.image) ? row.image : "";
-  const { bodyJson, bodyText } = richBody((ev as unknown as { description?: unknown }).description, (eventDescription(ev) || "").trim());
+  const { bodyJson, bodyText } = descriptionBody((ev as unknown as { description?: unknown }).description, descriptionBody(eventDescription({ ...ev, description: undefined })).bodyText);
   // The teaser stays above the body only when it says something the body does not.
-  const teaser = String((ev as any).shortDescription ?? "").trim();
+  const teaser = descriptionBody((ev as any).shortDescription).bodyText;
   return shape({
     ...prev,
     id,
@@ -358,4 +361,9 @@ if ((globalThis as { himalaya?: { hydrationOptOut?: unknown } }).himalaya?.hydra
   if (booted && typeof booted === "object") Object.assign(booted, { deletePending: false, noDeleteConfirmation: true });
 }
 
+// Hydration shallow-merges older snapshots over defaults; derive both body gates from
+// the restored document before the first paint, without waiting for a load action.
+const bootedBody = svc.getState();
+Object.assign(bootedBody, { hasBodyJson: !!bootedBody.bodyJson, noBodyJson: !bootedBody.bodyJson });
+
 export { svc };

package/templates/owner-lite/tier5-src/himi-owner-lite-event-form/index.ts

@@ -1,3 +1,4 @@
+import { descriptionBody } from "../_shared/rich-body.js";
 // Tier-5 bundle: __HIMI_APP_NAME__ — Events event EDIT form (the CRUD "U" only).
 // Modeled on himi-blog-owner-editor. Opened from the event detail ("Edit").
 //
@@ -222,12 +223,16 @@ const svc = defineService<EventFormState, {
           // this form never writes, so showing them here would invite an edit that lands elsewhere.
           ...(() => {
             const raw = (ev as unknown as { description?: unknown }).description;
-            const doc = raw && typeof raw === "object" && Array.isArray((raw as { nodes?: unknown }).nodes) ? raw as Parameters<typeof postBodyText>[0] : null;
-            const text = doc ? postBodyText(doc) : typeof raw === "string" ? raw.trim() : "";
+            const doc = parseRicosJson(raw);
+            const text = descriptionBody(raw).bodyText;
             // Edited in the RichContentEditor, seeded with the event's own document byte for byte (never
             // re-encoded); a legacy string seeds as paragraphs, and none seeds an empty editor.
-            return { ...DESCRIPTION_LOADED, description: text, originalDescription: text, descriptionMode: "editor" as const,
-              descriptionJson: doc ? JSON.stringify(raw) : text ? docJson(plainPostBody(text)) : "" };
+            // A description that looks like a serialized document but does not read as one (malformed JSON,
+            // or an object that is not a document) is locked, as on the Product form: an empty editor would
+            // let a save replace it. A blank or tag-only string stays editable so the owner can write the first one.
+            const unreadable = !doc && !text && raw != null && (typeof raw !== "string" || /^\s*[{[]/.test(raw));
+            return { ...DESCRIPTION_LOADED, description: text, originalDescription: text, descriptionMode: unreadable ? "locked" as const : "editor" as const,
+              descriptionJson: unreadable ? "" : doc ? JSON.stringify(doc) : text ? docJson(plainPostBody(text)) : "" };
           })(),
           when: row.dateLine || "—",
           location: row.location || "—",
@@ -239,14 +244,18 @@ const svc = defineService<EventFormState, {
         // Offline: prefill from the last-synced local cache before the demo/error fallbacks.
         const cached = await cacheGet(id);
         if (cached) {
+          // Only `descriptionJson` is the document as Wix returned it. The detail's `bodyJson` is the encoder's
+          // DISPLAY copy (media resized to urls), so it feeds the preview text and never seeds the editor.
+          const doc = parseRicosJson(cached.descriptionJson);
+          const description = descriptionBody(doc ?? cached.bodyJson, descriptionBody(cached.description ?? cached.bodyText ?? cached.summary).bodyText).bodyText;
           return shape({
             ...s, mode, id, heading: "Edit event",
             title: String(cached.title ?? cached.name ?? ""),
-            description: String(cached.description ?? ""),
-            originalDescription: String(cached.description ?? ""), ...DESCRIPTION_LOADED,
+            description,
+            originalDescription: description, ...DESCRIPTION_LOADED,
             // A row cached with its document reopens in the editor. An older row has none, so its verdict
             // decides: plain when it was plain, else locked (it carries no verdict either: fail closed).
-            ...(cached.descriptionJson ? { descriptionMode: "editor" as const, descriptionJson: String(cached.descriptionJson) }
+            ...(doc ? { descriptionMode: "editor" as const, descriptionJson: JSON.stringify(doc) }
               : { descriptionMode: cached.descriptionProtected === "false" ? "plain" as const : "locked" as const, descriptionJson: "" }),
             when: String(cached.when ?? cached.dateLine ?? "—"),
             location: String(cached.location ?? "—"),

package/templates/owner-lite/tier5-src/himi-owner-lite-events/index.ts

@@ -9,7 +9,7 @@ import { normalizeEvent, type EventRow } from "../_shared/himi-events.js";
 import { ownerLoadError, isOwnerPreviewDemo, ownerDemoFallback } from "../_shared/owner-load-error.js";
 import { DEMO_EVENTS, DEMO_NOTE } from "../_shared/owner-preview-demo.js";
 import { copyParam } from "../_shared/himi-copy.js";
-import { getAll, upsert, type DbEntity } from "../_shared/owner-local-db.js";
+import { get, getAll, upsert, type DbEntity } from "../_shared/owner-local-db.js";
 
 // Last-synced rows are an explicitly incomplete fallback for an unfiltered
 // request during an outage. Filtered pages never claim this cache is complete.
@@ -19,7 +19,9 @@ async function readCachedRows(): Promise<EventRow[]> {
   try { return (await getAll(ENTITY)) as unknown as EventRow[]; } catch { return []; }
 }
 async function writeCachedRows(rows: EventRow[]): Promise<void> {
-  try { for (const r of rows) await upsert(ENTITY, r as unknown as DbEntity); } catch { /* capability not granted → online-only */ }
+  try {
+    for (const r of rows) await upsert(ENTITY, { ...await get(ENTITY, r.id), ...r } as unknown as DbEntity);
+  } catch { /* capability not granted → online-only */ }
 }
 
 interface EventsState {