@wix/himalaya-cli 0.1582.0 → 0.1584.0

package/templates/beauty-salon/tier5-src/himi-branded-lite-notifsettings/index.ts

@@ -0,0 +1,173 @@
+import { withOnlineWrites } from "../_shared/online-actions.js";
+// himi-branded-lite-notifsettings — reads the site's notification topics + the member's preferences.
+// a failed query is an error with Retry (or Sign in when Wix refuses the
+// visitor) and an empty one is a real empty state — never sample rows presented as
+// the customer's own. Samples appear only in the host's explicit sample preview
+// (_shared/branded-load-state.ts).
+// any exist. INTERACTIVE: tapping a row toggles that topic On/Off — optimistic +
+// best-effort upsertMyNotificationPreferences (a no-op on sample rows).
+import { defineService as registerService } from "@himalaya/state";
+import { withEmptyFlags } from "../_shared/empty-flags.js";
+import { stashCopy } from "../_shared/himi-copy.js";
+import { memberAccess, assertMemberAccess, type MemberAccess } from "../_shared/member-access.js";
+import { LOADING, loaded, loadFailed, type LoadCopy, type LoadFlags } from "../_shared/branded-load-state.js";
+import {
+  getNotificationTopics,
+  getMyNotificationPreferences,
+  upsertMyNotificationPreferences,
+  muteStatusFor,
+  readTopics,
+  readPreferences,
+  isDeliveredNow,
+  isLocked,
+  preferenceFor,
+  type NotificationTopicDefinition,
+  type PreferenceInfo,
+} from "@himalaya/wix-notification-preferences";
+
+/** The channel this surface delivers on — read for the row state, written on toggle.
+ *  One constant, so the read and the write cannot drift apart. */
+const CHANNEL = "MOBILE";
+
+/** `note` is the line under a row's switch — only a locked topic has one. */
+interface Row { id: string; name: string; subtitle: string; note: string; on: boolean; locked: boolean;
+  /** Inverse of `locked` (hiddenWhen hides on TRUE) and the plain On/Off a locked row shows. */
+  notLocked: boolean; stateLabel: string }
+interface S extends LoadFlags {
+  preferencesMember: MemberAccess | null;
+  topics: Row[]; emptyText: string; actionMessage: string;
+  isMock: boolean; notMock: boolean; /** #2849 — hiddenWhen() hides on TRUE, so these are inverted: the empty-state banner
+   *  shows only when the site really has none, and the unavailable one only when the
+   *  query failed. A failed query must never render the sentence that claims the
+   *  customer has no content. */
+  notMockEmpty: boolean; notMockUnavailable: boolean;
+}
+
+/** Whether this topic is actually being DELIVERED — not merely what the recipient
+ *  asked for. `isDeliveredNow` prefers the server's `granted` verdict, so a topic the
+ *  member unmuted under a channel-wide mute renders OFF instead of promising a
+ *  notification that will never arrive. No preference row at all ⇒ the topic's default,
+ *  which is delivery. */
+function isOn(topicId: string, prefs: PreferenceInfo[]): boolean {
+  const p = preferenceFor(topicId, prefs, CHANNEL);
+  if (!p) return true;
+  return isDeliveredNow(p.stateData);
+}
+
+/** A row the server says cannot be changed here (a broader rule overrides it). */
+function locked(topicId: string, prefs: PreferenceInfo[]): boolean {
+  return isLocked(preferenceFor(topicId, prefs, CHANNEL)?.stateData);
+}
+
+/** Row subtitle doubles as an affordance: current state + how to change it. */
+function subtitleFor(on: boolean): string {
+  return on ? "On · tap to mute" : "Off · tap to enable";
+}
+
+function row(id: string, name: string, on: boolean): Row {
+  return { id, name, subtitle: subtitleFor(on), note: "", on, locked: false, notLocked: true, stateLabel: on ? "On" : "Off" };
+}
+
+function norm(t: NotificationTopicDefinition, prefs: PreferenceInfo[]): Row {
+  const name = (t.displayName || "Notification").trim() || "Notification";
+  const id = t.topicId || name;
+  const r = row(id, name, isOn(id, prefs));
+  // An overridden row says so instead of offering a toggle that cannot take effect.
+  return locked(id, prefs)
+    ? { ...r, locked: true, notLocked: false, subtitle: "Managed by your channel settings", note: "Managed by your channel settings" }
+    : r;
+}
+
+const MOCK: Row[] = [
+  row("sample-orders", "Order updates", true),
+  row("sample-bookings", "Bookings & reminders", true),
+  row("sample-promos", "Promotions & offers", false),
+  row("sample-community", "Community activity", true),
+];
+
+/** sample rows reach the screen ONLY in the host's explicit sample preview;
+ *  a failed or empty query is an honest error / empty state (branded-load-state.ts). */
+const COPY: LoadCopy<Row> = {
+  prefix: "notifsettings",
+  empty: "No notification topics to manage yet.",
+  error: "Notification settings couldn't be loaded.",
+  signIn: "Sign in to manage your notifications.",
+  sample: () => MOCK.map((r) => ({ ...r })),
+};
+
+const defineService = withOnlineWrites(registerService, ["toggle"], { messageFields: ["actionMessage"] });
+const INITIAL = { ...LOADING, topics: [] as Row[], emptyText: "", actionMessage: "", preferencesMember: null };
+const signInRequired = () => new Error("Unauthenticated: sign in to manage notifications");
+let loadVersion = 0;
+const svc = defineService<S, {
+  prepare: (s: S) => S;
+  load: (s: S, arg?: unknown) => Promise<S | undefined>;
+  toggle: (s: S, p?: { id?: string; value?: unknown }) => Promise<S | undefined>;
+}>("himiBrandedNotifSettings", withEmptyFlags({
+  state: INITIAL,
+  actions: {
+    prepare: (s) => ({ ...s, ...INITIAL }),
+    load: async (s, arg): Promise<S | undefined> => {
+      stashCopy(arg);
+      const version = ++loadVersion;
+      await svc.prepare();
+      try {
+        const member = await memberAccess();
+        if (!member.email) throw signInRequired();
+        const [topicsRes, prefsRes] = await Promise.all([
+          getNotificationTopics(),
+          getMyNotificationPreferences(),
+        ]);
+        await assertMemberAccess(member);
+        const prefs = readPreferences(prefsRes);
+        const topics = readTopics(topicsRes).map((t) => norm(t, prefs));
+        return version === loadVersion ? { ...s, ...loaded("topics", topics, COPY), preferencesMember: member, actionMessage: "" } : undefined;
+      } catch {
+        const member = await memberAccess();
+        // An authenticated denial is not repaired by an endless sign-in loop.
+        const failure = member.email ? new Error(COPY.error) : signInRequired();
+        return version === loadVersion ? { ...s, ...loadFailed("topics", failure, COPY), preferencesMember: null, actionMessage: "" } : undefined;
+      }
+    },
+    // Flip one topic's On/Off. Optimistic (updates the row immediately); the real
+    // upsert is best-effort and a no-op on sample rows.
+    toggle: async (s, p): Promise<S | undefined> => {
+      const id = p?.id;
+      const target = s.topics.find((r) => r.id === id);
+      if (s.busy || !id || !target || target.locked) return undefined;
+      if (!s.isMock) {
+        try {
+          if (!s.preferencesMember) return undefined;
+          await assertMemberAccess(s.preferencesMember);
+          if (svc.getState().preferencesMember !== s.preferencesMember) return undefined;
+        } catch {
+          await svc.load();
+          return undefined;
+        }
+      }
+      let nextOn = true;
+      const topics = s.topics.map((r) => {
+        if (r.id !== id) return r;
+        // A Toggle sends the NEXT state as `value` (action-payload contract); honour it so
+        // a repeated event can never flip the row the wrong way. A bare tap still flips.
+        nextOn = typeof p?.value === "boolean" ? p.value : !r.on;
+        return { ...r, on: nextOn, subtitle: subtitleFor(nextOn), stateLabel: nextOn ? "On" : "Off" };
+      });
+      if (!s.isMock && !id.startsWith("sample-")) {
+        try {
+          // `stateData.state` is a SCALAR enum — the old nested `{ muteStatus }` was a
+          // shape this service does not have, so every write was malformed.
+          await upsertMyNotificationPreferences([
+            { topicId: id, channel: CHANNEL, stateData: { state: muteStatusFor(nextOn) } },
+          ]);
+        } catch { /* keep the optimistic state */ }
+        try { await assertMemberAccess(s.preferencesMember!); }
+        catch { await svc.load(); return undefined; }
+      }
+      return svc.getState().preferencesMember === s.preferencesMember ? { ...svc.getState(), topics } : undefined;
+    },
+  },
+}, { topics: "noTopics" }));
+svc.prepare();
+svc.load();
+export { svc };

package/templates/beauty-salon/tier5-src/himi-branded-lite-plans/index.ts

@@ -1,3 +1,4 @@
+import { descriptionBody } from "../_shared/rich-body.js";
 import { paymentSetupMessage } from "../_shared/payment-setup.js";
 import { offlineWriteMessage, offlineWritesEnabled, withOnlineWrites } from "../_shared/online-actions.js";
 import { connectivity } from "@himalaya/state";
@@ -140,7 +141,7 @@ function planRow(plan: WixPlan): PlanRow {
   return {
     id: plan.id || "",
     name,
-    description: (plan.description ?? "").trim(),
+    description: descriptionBody(plan.description).bodyText,
     trialBadge,
     noTrialBadge: !trialBadge,
     priceLine: money(plan),

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

@@ -16,6 +16,7 @@ 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 { descriptionBody } from "../_shared/rich-body.js";
+import { PRODUCT_DETAIL_FIELDS, productInfoSections, type ProductInfoSection } from "../_shared/store-product-info.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
@@ -231,6 +232,7 @@ interface S {
   wasPriceEmpty: boolean;
   noSku: boolean;
   skuLabel: string;
+  infoSections: ProductInfoSection[];
   returnPolicyBody: string;
   shippingInfoBody: string;
   noReturnPolicyBody: boolean;
@@ -544,6 +546,7 @@ const svc = defineService<S, {
     wasPriceEmpty: false,
     skuLabel: "",
     noSku: true,
+    infoSections: [],
     returnPolicyBody: "",
     shippingInfoBody: "",
     noReturnPolicyBody: true,
@@ -631,7 +634,7 @@ const svc = defineService<S, {
         // Storage problems must not prevent browsing or buying a product.
         let saved = false;
         try { saved = isProductSaved(id); } catch { /* save action reports a retryable error */ }
-        s = { ...s, saved, saveHint: "", shareHint: "", adding: false, added: false, addedSheetPresented: false, quantity: 1, showOptionErrors: false, optionValidationRequest: 0, optionValidationTarget: "", galleryIndex: 0, returnPolicyExpanded: false, shippingInfoExpanded: false };
+        s = { ...s, saved, saveHint: "", shareHint: "", adding: false, added: false, addedSheetPresented: false, quantity: 1, showOptionErrors: false, optionValidationRequest: 0, optionValidationTarget: "", galleryIndex: 0, returnPolicyExpanded: false, shippingInfoExpanded: false, ...(id !== lastLoadedId ? { infoSections: [] } : {}) };
         // A fresh navigation into the product resets any quantity left over
         // from a previous visit to the same worker instance.
         if (!id) {
@@ -648,8 +651,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.
-        // DESCRIPTION widens the default fieldset with the V3 Ricos description (a V1 catalog ignores it).
-        const live = getStoreProduct(id, ["DESCRIPTION", "PRODUCT_CHOICES_DISPLAY_IMAGE"]).then(
+        // Widen the default fieldset with the V3 Ricos description, the Product Info sections and choice-linked images (a V1 catalog ignores them).
+        const live = getStoreProduct(id, [...PRODUCT_DETAIL_FIELDS, "PRODUCT_CHOICES_DISPLAY_IMAGE"]).then(
           (r) => ({ ok: true as const, r }),
           () => ({ ok: false as const }),
         );
@@ -712,6 +715,7 @@ const svc = defineService<S, {
             ...sale,
             commercePrice: sale.price,
             skuLabel: skuOf(p) ? `SKU: ${skuOf(p)}` : "",
+            infoSections: productInfoSections(p, base.infoSections),
             returnPolicyBody: productPolicyBody(p, "returns") || copyParam("product.returnPolicyBody", "") || copyParam("product.policyUnavailable", "Policy details have not been provided by this store."),
             shippingInfoBody: productPolicyBody(p, "shipping") || copyParam("product.shippingInfoBody", "") || copyParam("product.policyUnavailable", "Policy details have not been provided by this store."),
             ...productBody(p),
@@ -746,6 +750,7 @@ const svc = defineService<S, {
             price: String(synced.subtitle ?? ""),
             wasPrice: "",
             skuLabel: "",
+            infoSections: [],
             returnPolicyBody: "",
             shippingInfoBody: "",
             description: "",
@@ -768,6 +773,12 @@ const svc = defineService<S, {
       const quantity = parseQuantity(argValue(arg, "value"));
       return quantity ? derive({ ...s, quantity }) : s;
     },
+    toggleInfoSection: (s, arg) => {
+      const id = argValue(arg, "id");
+      if (!s.infoSections.some(section => section.id === id && !section.noTitle)) return s;
+      return derive({ ...s, infoSections: s.infoSections.map(section => section.id === id
+        ? { ...section, expanded: !section.expanded, collapsed: section.expanded } : section) });
+    },
     toggleReturnPolicy: s => derive({ ...s, returnPolicyExpanded: !s.returnPolicyExpanded }),
     toggleShippingInfo: s => derive({ ...s, shippingInfoExpanded: !s.shippingInfoExpanded }),
     // One chip row per option group. `group` is the descriptor slot ("1".."3");

package/templates/beauty-salon/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/beauty-salon/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/beauty-salon-owner/dev/index.ts

@@ -80795,6 +80795,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": {
@@ -80839,6 +80868,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                             "multilineMaxLines": 3
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteServiceForm.descriptionProtected"
                       }
                     }
                   ],
@@ -82857,6 +82889,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": {
@@ -83279,7 +83356,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"
@@ -83859,6 +83937,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": {
@@ -84046,70 +84169,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"
-                              }
                             }
                           ]
                         }
@@ -84230,7 +84289,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"
@@ -84695,6 +84755,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                             }
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLitePost.noBodyJson"
                       }
                     },
                     {

package/templates/beauty-salon-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/beauty-salon-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 };