@wix/himalaya-cli 0.1582.0 → 0.1584.0

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

@@ -35,8 +35,10 @@ import {
   type EventRow,
 } from "../_shared/himi-events";
 import { stashCopy, copyParam } from "../_shared/himi-copy.js";
+import { eventPageUrlOf, eventStatus, registrationKindOf, registrationUi, registrationUrlOf, type RegistrationKind } from "../_shared/event-registration.js";
+export { eventPageUrlOf, registrationKindOf, registrationUrlOf, type RegistrationKind };
 import { openRichLink } from "../_shared/rich-content-link.js";
-import { richBody } from "../_shared/rich-body.js";
+import { descriptionBody } from "../_shared/rich-body.js";
 import { mayUseRegularTicketCheckout } from "../_shared/iap-attendance.js";
 import { ATTENDANCE_INITIAL, ATTENDANCE_NOT_HYDRATED, createAttendancePurchase, type AttendancePurchaseFields } from "../_shared/iap-attendance-purchase.js";
 import { resetUnhydratedKeysOnOlderRuntime } from "../_shared/iap-worker.js";
@@ -88,9 +90,6 @@ interface TicketTierRow {
   notAvailable?: boolean;
 }
 
-/** Registration CTA kind derived from the event's registration/eventType. */
-export type RegistrationKind = "rsvp" | "tickets" | "external" | "none";
-
 // Offline-first (data-offline): the event detail is a read-through single-item read —
 // it shares the `events` entity written by the list, and also write-throughs its own
 // fetched row so a deep-linked detail is cached for the next offline open. On a failed
@@ -302,7 +301,7 @@ function loadedTiers(defs: WixAvailableTicket[]): { rows: TicketTierRow[]; ticke
       const ticket = tickets.get(row.ticketDefinitionId ?? row.id);
       if (!ticket) return { ...row, quantity: 0, description: "", feeNote: "", policy: "", noPolicy: true, notAvailable: !row.available, notGuestPrice: !row.isGuestPrice, maxQuantity: 0 };
       const policy = (ticket as unknown as { policy?: string; policyText?: string }).policyText || (ticket as unknown as { policy?: string }).policy || "";
-      return { ...row, quantity: 0, description: ticket.description || "", feeNote: ((ticket as unknown as { wixFeeConfig?: { type?: string }; feeType?: string }).wixFeeConfig?.type ?? (ticket as unknown as { feeType?: string }).feeType) === "FEE_ADDED_AT_CHECKOUT" ? detailCopy("event.serviceFee", "+ ticket service fee") : "", policy, noPolicy: !policy, notAvailable: !row.available, notGuestPrice: !row.isGuestPrice, priceAmount: row.priceAmount ?? Number(ticket.price?.amount ?? 0), rowLimit: row.available ? ticket.limitPerCheckout ?? 99 : 0, maxQuantity: row.available ? ticket.limitPerCheckout ?? 99 : 0 };
+      return { ...row, quantity: 0, description: descriptionBody(ticket.description).bodyText, feeNote: ((ticket as unknown as { wixFeeConfig?: { type?: string }; feeType?: string }).wixFeeConfig?.type ?? (ticket as unknown as { feeType?: string }).feeType) === "FEE_ADDED_AT_CHECKOUT" ? detailCopy("event.serviceFee", "+ ticket service fee") : "", policy, noPolicy: !policy, notAvailable: !row.available, notGuestPrice: !row.isGuestPrice, priceAmount: row.priceAmount ?? Number(ticket.price?.amount ?? 0), rowLimit: row.available ? ticket.limitPerCheckout ?? 99 : 0, maxQuantity: row.available ? ticket.limitPerCheckout ?? 99 : 0 };
     });
     return { rows, tickets };
 }
@@ -451,29 +450,6 @@ function calendarFallbackUrl(s: S, end: number): string {
  *  shortDescription: REGISTRATION fills eventType, which skips the query enrichment that used to supply them. */
 export const EVENT_DETAIL_FIELDSETS: WixEventFieldset[] = ["DETAILS", "TEXTS", "REGISTRATION", "URLS", "FORM", "AGENDA"];
 
-/** Map registration status and decoded eventType onto the CTA variant. The decoded
- *  `eventType` already folds registration.type / registration.initialType /
- *  the legacy flat `type` (decodeEvent, #478). Without a recognized type or
- *  status there is no registration action to offer. */
-export function registrationKindOf(e: WixEvent): RegistrationKind {
-  const raw = e as unknown as { registration?: { type?: string; initialType?: string; status?: string } };
-  const value = (raw.registration?.type ?? e.eventType ?? raw.registration?.initialType ?? "").toUpperCase();
-  if (value === "NONE" || value.includes("NO_REGISTRATION")) return "none";
-  // Open statuses select the footer action, so they must also select the
-  // inventory read and action guards when type metadata is absent or stale.
-  switch (raw.registration?.status?.toUpperCase()) {
-    case "OPEN_TICKETS": return "tickets";
-    case "OPEN_EXTERNAL": return "external";
-    case "OPEN_RSVP":
-    case "OPEN_RSVP_WAITLIST_ONLY":
-    case "SCHEDULED_RSVP": return "rsvp";
-  }
-  if (value.includes("EXTERNAL")) return "external";
-  if (value.includes("TICKET")) return "tickets";
-  if (value.includes("RSVP")) return "rsvp";
-  return "none";
-}
-
 function detailCopy(key: string, fallback: string): string { return copyParam(key, fallback); }
 
 function detailDate(e: WixEvent): { line: string; zone: string; start: number; end: number } {
@@ -536,69 +512,17 @@ function detailPlace(e: WixEvent): { value: string; mapUrl: string; hideMapTap:
   return { value, mapUrl: mapped, hideMapTap: !mapped, icon: "location" };
 }
 
-function eventStatus(e: WixEvent): string {
-  const raw = e as unknown as { status?: string };
-  return (raw.status ?? e.eventStatus ?? "").toUpperCase();
-}
-
-function registrationUi(e: WixEvent, now: number): { state: string; label: string; action: string; caption: string; notice: string } {
-  const raw = e as unknown as { registration?: { status?: string; registrationPaused?: boolean; registrationDisabled?: boolean; allowedGuestTypes?: string; rsvp?: { startDate?: string }; tickets?: { soldOut?: boolean }; external?: { url?: string } }; form?: { messages?: { registrationClosed?: { message?: string; exploreEventsActionLabel?: string }; ticketsUnavailable?: { message?: string; exploreEventsActionLabel?: string } } } };
-  const r = raw.registration ?? {};
-  const status = eventStatus(e);
-  const type = registrationKindOf(e);
-  if (status === "CANCELED") return { state: "notice", label: "", action: "", caption: "", notice: detailCopy("event.canceledNotice", "This event was canceled.") };
-  if (status === "ENDED") return { state: "notice", label: "", action: "", caption: "", notice: detailCopy("event.endedNotice", "This event has ended.") };
-  if (type === "none" || r.registrationDisabled) return { state: "none", label: "", action: "", caption: "", notice: "" };
-  const ownerClosed = raw.form?.messages?.registrationClosed?.message;
-  const ownerSold = raw.form?.messages?.ticketsUnavailable?.message;
-  if (["CLOSED_AUTOMATICALLY", "CLOSED_MANUALLY"].includes(r.status || "") || r.registrationPaused) return { state: "notice", label: "", action: "", caption: "", notice: ownerClosed || detailCopy("event.closedNotice", "Registration is closed.") };
-  if (type === "tickets" && r.tickets?.soldOut) return { state: "notice", label: "", action: "", caption: "", notice: ownerSold || detailCopy("event.soldOutNotice", "Tickets are sold out.") };
-  if (r.status === "SCHEDULED_RSVP") return { state: "scheduled", label: detailCopy("event.rsvpCta", "RSVP"), action: "", caption: detailCopy("event.opensCaption", "RSVP opens {date}.").replace("{date}", r.rsvp?.startDate ? formatWeekdayDateTime(new Date(r.rsvp.startDate)) : ""), notice: "" };
-  if (r.status === "OPEN_RSVP_WAITLIST_ONLY") return { state: "waitlist", label: detailCopy("event.waitlistCta", "Join Waitlist"), action: "himi.open", caption: detailCopy("event.fullCaption", "This event is full."), notice: "" };
-  if (r.status === "OPEN_TICKETS" || type === "tickets") return { state: "tickets", label: detailCopy("event.ticketsCta", "Buy Tickets"), action: "openTickets", caption: "", notice: "" };
-  if (r.status === "OPEN_EXTERNAL" || type === "external") return registrationUrlOf(e)
-    ? { state: "external", label: detailCopy("event.externalCta", "Register"), action: "openRegistration", caption: "", notice: "" }
-    : { state: "none", label: "", action: "", caption: "", notice: "" };
-  if (type === "rsvp" && r.status === "OPEN_RSVP") return { state: "rsvp", label: detailCopy("event.rsvpCta", "RSVP"), action: "himi.open", caption: "", notice: "" };
-  if (r.status === "OPEN_RSVP" || (type === "rsvp" && !r.status)) return { state: "rsvp", label: detailCopy("event.rsvpCta", "RSVP"), action: "himi.open", caption: "", notice: "" };
-  void now;
-  return { state: "none", label: "", action: "", caption: "", notice: "" };
-}
-
-/** External registration URL / event page URL from the raw payload ("" when absent). */
-export function registrationUrlOf(e: WixEvent): string {
-  const raw = e as unknown as {
-    registration?: { external?: { registration?: string; url?: string } };
-    eventPageUrl?: { base?: string; path?: string } | string;
-  };
-  const external = raw.registration?.external?.registration ?? raw.registration?.external?.url;
-  if (typeof external === "string" && /^https?:\/\//i.test(external)) return external;
-  return eventPageUrlOf(e);
-}
-
 /** Event slug for createRedirectSession({ eventsCheckout }) — "" when absent. */
 export function eventSlugOf(e: WixEvent): string {
   const slug = e.slug ?? (e as unknown as { slug?: string }).slug;
   return typeof slug === "string" ? slug.trim() : "";
 }
 
-/** The event's public page URL when the payload carries one ("" otherwise). */
-export function eventPageUrlOf(e: WixEvent): string {
-  const raw = e as unknown as { eventPageUrl?: { base?: string; path?: string } | string };
-  const page = raw.eventPageUrl;
-  if (typeof page === "string" && /^https?:\/\//i.test(page)) return page;
-  if (page && typeof page === "object" && typeof page.base === "string" && page.base) {
-    const path = typeof page.path === "string" ? page.path : "";
-    return `${page.base.replace(/\/$/, "")}${path && !path.startsWith("/") ? "/" : ""}${path}`;
-  }
-  return "";
-}
-
 /** 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);
+  const legacy = eventDescription({ ...e, description: undefined });
+  const { bodyJson, bodyText } = descriptionBody((e as unknown as { description?: unknown }).description, descriptionBody(legacy).bodyText);
   return { description: bodyText, descriptionJson: bodyJson };
 }
 
@@ -1132,6 +1056,8 @@ const svc: ReturnType<typeof defineService<S, DetailActions>> = defineService<S,
             }).sort((a, b) => (eventStartMillis(a) ?? 0) - (eventStartMillis(b) ?? 0)).map((item) => ({ id: item.id ?? "", date: eventWhen(item) })).filter((item) => !!item.id);
           } catch { moreDates = []; optionalReadFailed = true; }
         }
+        const body = eventBody(e);
+        const shortDescription = descriptionBody(rawEvent.shortDescription).bodyText;
         const readyState = derive({
           ...s,
           status: "ready",
@@ -1153,9 +1079,9 @@ const svc: ReturnType<typeof defineService<S, DetailActions>> = defineService<S,
           price,
           zone: dates.zone,
           mapUrl: place.mapUrl,
-          shortDescription: rawEvent.shortDescription || "",
-          noShortDescription: !rawEvent.shortDescription || rawEvent.shortDescription === eventBody(e).description,
-          noDescription: !eventBody(e).description && !eventBody(e).descriptionJson,
+          shortDescription,
+          noShortDescription: !shortDescription || shortDescription === body.description,
+          noDescription: !body.description && !body.descriptionJson,
           noDate: !dates.line,
           registrationState: registration.state,
           footerLabel: registration.label,
@@ -1177,7 +1103,7 @@ const svc: ReturnType<typeof defineService<S, DetailActions>> = defineService<S,
           noMoreDates: moreDates.length === 0,
           // The Ricos description when the event has one (its own text is the plain copy); the legacy
           // string fields otherwise.
-          ...eventBody(e),
+          ...body,
           image,
           hasImage: !!image,
           noImage: !image,

package/templates/podcast-creator/tier5-src/himi-events-list/index.ts

@@ -5,6 +5,8 @@ import { getAll, upsert, type DbEntity } from "@himalaya/local-db";
 import { normalizeEvent, type EventRow } from "../_shared/himi-events";
 import { offsetPage } from "../_shared/offset-page.js";
 import { copyParam } from "../_shared/himi-copy.js";
+import { eventPageUrlOf, registrationUi } from "../_shared/event-registration.js";
+import { share as shareSheet } from "@himalaya/share";
 
 // Offline-first (data-offline): the public events list is a read-through catalog —
 // paint the last-synced rows from the on-device store first (instant, works offline),
@@ -13,8 +15,37 @@ import { copyParam } from "../_shared/himi-copy.js";
 // (+ declared the `events` entity in its dataSchema) just falls back to today's
 // online-only path — the try/catch is the seam that keeps this shared bundle safe.
 const ENTITY = "events";
-async function readCached(): Promise<EventRow[]> {
-  try { return (await getAll(ENTITY)) as unknown as EventRow[]; } catch { return []; }
+interface ListEventRow extends EventRow {
+  dateBadge: string; noDateBadge: boolean;
+  /** This card's verb (Register / RSVP / Buy Tickets / Join Waitlist) from the SAME rule the detail uses; hidden when none applies. */
+  actionLabel: string; noAction: boolean;
+  /** The event page URL (when the payload carries one) for Share. */
+  shareUrl: string;
+}
+
+// The day monogram is a title initial for undated events. Only an actual calendar
+// date becomes a badge; derive it for old cached rows too, without a cache migration.
+// The month must be the three-letter abbreviation: rows cached by an older worker on an
+// Intl-less engine can hold a whole "11/10/2030, 12:00:00 PM" there.
+function withDateBadge(row: EventRow): ListEventRow {
+  const dated = typeof row.month === "string" && /^[A-Z]{3}$/.test(row.month)
+    && /^(?:[1-9]|[12]\d|3[01])$/.test(row.day);
+  const known = row as Partial<ListEventRow>;
+  // Rows cached by an older build carry no registration data: they show no verb until a refresh, never a wrong one.
+  return { ...row, dateBadge: dated ? `${row.day}\n${row.month}` : "", noDateBadge: !dated,
+    actionLabel: known.actionLabel ?? "", noAction: known.noAction ?? true, shareUrl: known.shareUrl ?? "" };
+}
+
+/** The card's action, from the event's own registration (REGISTRATION + URLS fieldsets). Cancelled, ended,
+ *  closed, sold-out and registration-less events offer none, so a card never promises "Register" the detail refuses. */
+function withRegistration(raw: WixEvent, row: ListEventRow): ListEventRow {
+  const ui = registrationUi(raw, Date.now());
+  const offers = ui.state !== "notice" && ui.state !== "none" && ui.state !== "scheduled" && !!ui.label;
+  return { ...row, actionLabel: offers ? ui.label : "", noAction: !offers, shareUrl: eventPageUrlOf(raw) };
+}
+
+async function readCached(): Promise<ListEventRow[]> {
+  try { return ((await getAll(ENTITY)) as unknown as EventRow[]).map(withDateBadge); } catch { return []; }
 }
 async function writeCached(rows: EventRow[]): Promise<void> {
   try { for (const r of rows) await upsert(ENTITY, r as unknown as DbEntity); } catch { /* capability not granted → online-only */ }
@@ -22,12 +53,12 @@ async function writeCached(rows: EventRow[]): Promise<void> {
 
 interface S {
   status: "loading" | "ready";
-  query: string; all: EventRow[]; results: EventRow[]; emptyText: string; countLabel: string;
+  query: string; all: ListEventRow[]; results: ListEventRow[]; emptyText: string; countLabel: string;
   errored: boolean; notErrored: boolean; isLoading: boolean; notLoading: boolean; noEmpty: boolean;
   nextCursor?: string; complete?: boolean; total?: number; loadingMore?: boolean; pageError?: boolean; fromCache?: boolean;
 }
 let queryNow = new Date().toISOString();
-const svc = defineBackendCollection<S, EventRow>("himiEvents", {
+const svc = defineBackendCollection<S, ListEventRow>("himiEvents", {
   restorePagesOnLoad: true,
   state: { status: "loading", query: "", all: [], results: [], emptyText: "", countLabel: "", errored: false, notErrored: true,
     isLoading: true, notLoading: false, noEmpty: true },
@@ -62,10 +93,10 @@ const svc = defineBackendCollection<S, EventRow>("himiEvents", {
         ];
       }
       if (criteria.filter === "value:Past") filter["dateAndTimeSettings.startDate"] = { $lt: queryNow };
-      const res = await queryEvents({ limit: 50, offset: Number(cursor || 0), query: { filter,
+      const res = await queryEvents({ limit: 50, offset: Number(cursor || 0), fields: ["DETAILS", "REGISTRATION", "URLS"], query: { filter,
         sort: [{ fieldName: criteria.sort === "default" ? "dateAndTimeSettings.startDate" : "title", order: criteria.sort === "za" ? "DESC" : "ASC" }, { fieldName: "id", order: "ASC" }] } });
       const raw = res.events ?? [];
-      const items = raw.filter(row => !!row.id).map(normalizeEvent);
+      const items = raw.filter(row => !!row.id).map(row => withRegistration(row, withDateBadge(normalizeEvent(row))));
       await writeCached(items);
       const metadata = (res as { pagingMetadata?: { total?: number } }).pagingMetadata;
       return { items, ...offsetPage(cursor, raw.length, 50, metadata), metadata: { fromCache: false } };
@@ -78,6 +109,16 @@ const svc = defineBackendCollection<S, EventRow>("himiEvents", {
       fromCache: page.metadata?.fromCache === true, errored, notErrored: !errored, isLoading: loading, notLoading: !loading,
       noEmpty: true, countLabel: "", emptyText: errored ? copyParam("events.errorText", "Events could not be loaded.") : "" };
   },
+  actions: {
+    // Share a card's event: its title and date line, plus the event page when the payload carried one.
+    share: async (s, arg) => {
+      const id = typeof arg === "string" ? arg : String((arg as { id?: unknown } | undefined)?.id ?? "");
+      const row = s.results.find(item => item.id === id);
+      if (!row) return undefined;
+      try { await shareSheet({ subject: row.title, text: [row.title, row.dateLine].filter(Boolean).join(" — "), ...(row.shareUrl ? { url: row.shareUrl } : {}) }); } catch { /* the sheet is best-effort: nothing to undo */ }
+      return undefined;
+    },
+  },
 });
 svc.load();
 export { svc };

package/templates/podcast-creator/tier5-src/wix-spaces-plan-detail/index.ts

@@ -1,3 +1,4 @@
+import { descriptionBody } from "../_shared/rich-body.js";
 // Tier-5 bundle: Wix Spaces clone — Pricing plan detail (ON-DEVICE, site-scoped).
 // himalaya.input.id carries the plan id.
 //
@@ -53,7 +54,7 @@ const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesPlanDetail",
         const p = await readPlan(id);
         if (!p) return { ...s, status: "ready", ...presence("missing") };
         const perks = (p.perks?.values ?? []).map((v) => `• ${v}`).join("\n");
-        return { status: "ready", name: p.name || "Plan", price: priceOf(p), description: p.description || "", perks, ...presence("found") };
+        return { status: "ready", name: p.name || "Plan", price: priceOf(p), description: descriptionBody(p.description).bodyText, perks, ...presence("found") };
       } catch (e) { return { ...s, status: "ready", ...presenceAfterError(e) }; }
     },
   },

package/templates/podcast-creator/tier5-src/wix-spaces-whats-new/index.ts

@@ -1,3 +1,4 @@
+import { descriptionBody } from "../_shared/rich-body.js";
 // Tier-5 bundle: Wix Spaces clone — What's New (ON-DEVICE, account-level).
 import { defineService } from "@himalaya/state";
 import { withEmptyFlags } from "../_shared/empty-flags.js";
@@ -8,7 +9,7 @@ interface S { status: "loading" | "ready"; items: Row[]; emptyText: string; /**
 
 function norm(a: WixAnnouncement, i: number): Row {
   const aa = a as unknown as { id?: string; title?: string; bodyText?: string; description?: string };
-  return { id: aa.id || `a${i}`, name: aa.title || "Announcement", subtitle: aa.description || aa.bodyText || "" };
+  return { id: aa.id || `a${i}`, name: aa.title || "Announcement", subtitle: descriptionBody(aa.description, descriptionBody(aa.bodyText).bodyText).bodyText };
 }
 
 const svc = defineService<S, { load: (s: S) => Promise<S> }>("spacesWhatsNew", withEmptyFlags({

package/templates/podcast-creator-owner/dev/index.ts

@@ -81718,6 +81718,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": {
@@ -82140,7 +82185,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"
@@ -82744,6 +82790,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                             }
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteEvent.noBodyJson"
                       }
                     },
                     {
@@ -83753,6 +83802,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                             }
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLitePost.noBodyJson"
                       }
                     },
                     {

package/templates/podcast-creator-owner/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/podcast-creator-owner/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/podcast-creator-owner/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/podcast-creator-owner/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 {

package/templates/podcast-creator-owner/tier5-src/himi-owner-lite-post/index.ts

@@ -55,6 +55,7 @@ interface PostState {
   bodyJson: string;
   /** bodyJson !== "" — gates the plain text, because RichContent draws nothing for "". */
   hasBodyJson: boolean;
+  noBodyJson: boolean;
   /** Plain text of the body: RichContent's `fallback`, and the offline copy's body. */
   bodyText: string;
   // Info rows
@@ -151,6 +152,7 @@ function shapeFields(s: Partial<PostState>): PostState {
     image,
     bodyJson: s.bodyJson ?? "",
     hasBodyJson: !!s.bodyJson,
+    noBodyJson: !s.bodyJson,
     bodyText: s.bodyText ?? "",
     postStatus: s.postStatus ?? statusLabel(raw),
     category: s.category ?? "—",
@@ -485,4 +487,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 };