@wix/himalaya-cli 0.1070.0 → 0.1072.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/events/src/index.d.ts

@@ -51,7 +51,9 @@ export interface WixEvent {
     mainImage?: WixEventImage;
     slug?: string;
     about?: string;
-    description?: string;
+    /** Events v3: a Ricos document ({@link WixEventRichContent}), returned only when the `TEXTS`
+     *  fieldset is requested (`getEvent(id, { fields: ["TEXTS"] })`). Older payloads sent a string. */
+    description?: string | WixEventRichContent;
 }
 export interface WixGetEventListResponse {
     events: WixEvent[];
@@ -132,12 +134,26 @@ export declare function decodeEvent(raw: WixEvent): WixEvent;
  *  not just an owner session. (NOT the owner-only GET /events-in-clubs/chunked-events,
  *  which returns an HTML error page for a visitor token.) */
 export declare function queryEvents(opts?: WixQueryEventsOptions): Promise<WixGetEventListResponse>;
+/** Events v3 response fieldsets (`RequestedFields`). A bare read returns the base fieldset;
+ *  each value adds fields: `DETAILS` → `shortDescription`, `mainImage`, `calendarUrls`;
+ *  `TEXTS` → the Ricos `description`; `REGISTRATION` → `registration`; `URLS` → `eventPageUrl`. */
+export type WixEventFieldset = "DETAILS" | "TEXTS" | "REGISTRATION" | "URLS";
+/** A Ricos document (Events v3 `description`). Opaque here: read it with a Ricos walker, and
+ *  write it back whole — a PATCH replaces the entire description. */
+export interface WixEventRichContent {
+    nodes?: unknown[];
+    metadata?: unknown;
+    documentStyle?: unknown;
+}
 /** Get one event — GET /events/v3/events/{eventId}. Response wraps as `{ event }`.
  *  NOTE: this GET returns the Events v3 BASE fieldset — slimmer than `queryEvents`,
  *  which returns the richer default (fields such as `registration` and `calendarUrls`
  *  are absent from a bare `getEvent`). If a detail screen needs those fields for one
- *  event, prefer `queryEvents` and pick the row by id over `getEvent`. */
-export declare function getEvent(eventId: string): Promise<WixGetEventResponse>;
+ *  event, prefer `queryEvents` and pick the row by id over `getEvent`.
+ *  `opts.fields` requests extra v3 fieldsets; `["TEXTS"]` returns `description`. */
+export declare function getEvent(eventId: string, opts?: {
+    fields?: WixEventFieldset[];
+}): Promise<WixGetEventResponse>;
 /** Delete an event — DELETE /events/v3/events/{eventId}. */
 export declare function deleteEvent(eventId: string): Promise<WixDeleteEventResponse>;
 /** Write shape for create/update (Events v3). Verified-minimal: a create needs
@@ -160,6 +176,8 @@ export interface WixEventWrite {
     };
     mainImage?: WixEventImage;
     about?: string;
+    /** Ricos document; replaces the whole description. */
+    description?: WixEventRichContent;
 }
 /** Create an event — POST /events/v3/events → { event }. */
 export declare function createEvent(event: WixEventWrite): Promise<WixGetEventResponse>;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-events.mjs

@@ -301,9 +301,11 @@ async function queryEvents(opts = {}) {
   if (opts.order === "start") events = events.slice().sort((a, b) => eventStartMs(a) - eventStartMs(b));
   return { ...res, events };
 }
-async function getEvent(eventId) {
+async function getEvent(eventId, opts = {}) {
   if (!eventId) throw new Error("getEvent: eventId is required");
-  const res = await wixCall("GET", `/events/v3/events/${encodeURIComponent(eventId)}`);
+  const fields = (opts.fields ?? []).map((f) => `fields=${encodeURIComponent(f)}`).join("&");
+  const query = fields ? `?${fields}` : "";
+  const res = await wixCall("GET", `/events/v3/events/${encodeURIComponent(eventId)}${query}`);
   return { ...res, event: decodeEvent(res.event) };
 }
 function deleteEvent(eventId) {

package/guides/sdk-reference.json

@@ -14370,7 +14370,7 @@
         "name": "WixEvent",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixEvent {\n  id: string;\n  title?: string;\n  /** Normally one of `WixEventStatus` — `UPCOMING` (published and scheduled to start),\n   *  `STARTED`, `ENDED`, `CANCELED`, `DRAFT`. Events v1 called the first of those `SCHEDULED`,\n   *  and this SDK reads v3, so a row here never carries `SCHEDULED`.\n   *\n   *  Deliberately NOT narrowed to that union: `decodeEvent` fills this from the server's\n   *  `status` and passes a value it does not recognise straight through, because dropping or\n   *  rewriting one would lose a real event. A union here would be a claim this SDK cannot\n   *  enforce. Compare against `WixEventStatus` when you need the set it knows. */\n  eventStatus?: string;\n  /** EventType: RSVP | TICKETS | EXTERNAL | NO_REGISTRATION */\n  eventType?: string;\n  scheduling?: WixEventScheduling;\n  location?: WixEventLocation;\n  mainImage?: WixEventImage;\n  slug?: string;\n  about?: string;\n  description?: string;\n}"
+        "decl": "export interface WixEvent {\n  id: string;\n  title?: string;\n  /** Normally one of `WixEventStatus` — `UPCOMING` (published and scheduled to start),\n   *  `STARTED`, `ENDED`, `CANCELED`, `DRAFT`. Events v1 called the first of those `SCHEDULED`,\n   *  and this SDK reads v3, so a row here never carries `SCHEDULED`.\n   *\n   *  Deliberately NOT narrowed to that union: `decodeEvent` fills this from the server's\n   *  `status` and passes a value it does not recognise straight through, because dropping or\n   *  rewriting one would lose a real event. A union here would be a claim this SDK cannot\n   *  enforce. Compare against `WixEventStatus` when you need the set it knows. */\n  eventStatus?: string;\n  /** EventType: RSVP | TICKETS | EXTERNAL | NO_REGISTRATION */\n  eventType?: string;\n  scheduling?: WixEventScheduling;\n  location?: WixEventLocation;\n  mainImage?: WixEventImage;\n  slug?: string;\n  about?: string;\n  /** Events v3: a Ricos document ({@link WixEventRichContent}), returned only when the `TEXTS`\n   *  fieldset is requested (`getEvent(id, { fields: [\"TEXTS\"] })`). Older payloads sent a string. */\n  description?: string | WixEventRichContent;\n}"
       },
       {
         "name": "WixGetEventListResponse",
@@ -14421,12 +14421,24 @@
         "decl": "export async function queryEvents(opts: WixQueryEventsOptions = {}): Promise<WixGetEventListResponse>;",
         "http": "POST /events/v3/events/query"
       },
+      {
+        "name": "WixEventFieldset",
+        "kind": "type",
+        "jsdoc": "/** Events v3 response fieldsets (`RequestedFields`). A bare read returns the base fieldset;\n *  each value adds fields: `DETAILS` → `shortDescription`, `mainImage`, `calendarUrls`;\n *  `TEXTS` → the Ricos `description`; `REGISTRATION` → `registration`; `URLS` → `eventPageUrl`. */",
+        "decl": "export type WixEventFieldset = \"DETAILS\" | \"TEXTS\" | \"REGISTRATION\" | \"URLS\";"
+      },
+      {
+        "name": "WixEventRichContent",
+        "kind": "interface",
+        "jsdoc": "/** A Ricos document (Events v3 `description`). Opaque here: read it with a Ricos walker, and\n *  write it back whole — a PATCH replaces the entire description. */",
+        "decl": "export interface WixEventRichContent { nodes?: unknown[]; metadata?: unknown; documentStyle?: unknown }"
+      },
       {
         "name": "getEvent",
         "kind": "function",
-        "jsdoc": "/** Get one event — GET /events/v3/events/{eventId}. Response wraps as `{ event }`.\n *  NOTE: this GET returns the Events v3 BASE fieldset — slimmer than `queryEvents`,\n *  which returns the richer default (fields such as `registration` and `calendarUrls`\n *  are absent from a bare `getEvent`). If a detail screen needs those fields for one\n *  event, prefer `queryEvents` and pick the row by id over `getEvent`. */",
-        "decl": "export async function getEvent(eventId: string): Promise<WixGetEventResponse>;",
-        "http": "GET /events/v3/events/{…}"
+        "jsdoc": "/** Get one event — GET /events/v3/events/{eventId}. Response wraps as `{ event }`.\n *  NOTE: this GET returns the Events v3 BASE fieldset — slimmer than `queryEvents`,\n *  which returns the richer default (fields such as `registration` and `calendarUrls`\n *  are absent from a bare `getEvent`). If a detail screen needs those fields for one\n *  event, prefer `queryEvents` and pick the row by id over `getEvent`.\n *  `opts.fields` requests extra v3 fieldsets; `[\"TEXTS\"]` returns `description`. */",
+        "decl": "export async function getEvent(eventId: string, opts: { fields?: WixEventFieldset[] } = {}): Promise<WixGetEventResponse>;",
+        "http": "GET /events/v3/events/{…}{…}"
       },
       {
         "name": "deleteEvent",
@@ -14439,7 +14451,7 @@
         "name": "WixEventWrite",
         "kind": "interface",
         "jsdoc": "/** Write shape for create/update (Events v3). Verified-minimal: a create needs\n *  BOTH `name` and `title`, a `dateAndTimeSettings` window, a `location`, and a\n *  `registration.initialType` (RSVP | TICKETS | RSVP_AND_TICKETS). */",
-        "decl": "export interface WixEventWrite {\n  name?: string;\n  title?: string;\n  dateAndTimeSettings?: { startDate?: string; endDate?: string; timeZoneId?: string };\n  location?: { type?: string; name?: string };\n  registration?: { initialType?: string };\n  mainImage?: WixEventImage;\n  about?: string;\n}"
+        "decl": "export interface WixEventWrite {\n  name?: string;\n  title?: string;\n  dateAndTimeSettings?: { startDate?: string; endDate?: string; timeZoneId?: string };\n  location?: { type?: string; name?: string };\n  registration?: { initialType?: string };\n  mainImage?: WixEventImage;\n  about?: string;\n  /** Ricos document; replaces the whole description. */\n  description?: WixEventRichContent;\n}"
       },
       {
         "name": "createEvent",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1070.0",
+  "version": "0.1072.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -65,5 +65,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "b3464e0a47e693d91e6dbd693f88f764b6d30aa4f5f10fee0c3eb098"
+  "falconPackageHash": "18f2e2636552474acd27ddb5b45d00aa4507785ea72311c47c6039ae"
 }

package/templates/beauty-salon-owner/dev/index.ts

@@ -73953,6 +73953,35 @@ const SCREENS = runtimeSetting({
                 }
               }
             },
+            {
+              "id": "product_form.description_note",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteProductForm.descriptionNote",
+                  "style": "footnote",
+                  "color": "textSecondary",
+                  "collapseWhenEmpty": true
+                }
+              }
+            },
+            {
+              "id": "product_form.description_preview",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteProductForm.description",
+                  "style": "body",
+                  "maxLines": 8,
+                  "collapseWhenEmpty": true
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionEditable"
+              }
+            },
             {
               "id": "product_form.form",
               "body": {
@@ -74039,6 +74068,9 @@ const SCREENS = runtimeSetting({
                             "multilineMaxLines": 3
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionProtected"
                       }
                     }
                   ],
@@ -74566,6 +74598,35 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                 }
               }
             },
+            {
+              "id": "product_form.description_note",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteProductForm.descriptionNote",
+                  "style": "footnote",
+                  "color": "textSecondary",
+                  "collapseWhenEmpty": true
+                }
+              }
+            },
+            {
+              "id": "product_form.description_preview",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteProductForm.description",
+                  "style": "body",
+                  "maxLines": 8,
+                  "collapseWhenEmpty": true
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionEditable"
+              }
+            },
             {
               "id": "product_form.form",
               "body": {
@@ -74652,6 +74713,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                             "multilineMaxLines": 3
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionProtected"
                       }
                     }
                   ],

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

@@ -0,0 +1,64 @@
+// [rico] #3363 — may a plain owner form round-trip this body? Ricos uses owner-post-content's
+// hasRichBody; these cover the Stores HTML description and the FAQ's legacy DraftJS answer.
+// [rico] #3365 moves htmlIsTrivial into @himalaya/wix-rich-content with these exact semantics.
+
+/** A tag opener (`<p`, `</p`, `<!--`), as opposed to a bare `<` in prose ("cups < 8 cm"). */
+const TAG = /<[a-z!/?]/i;
+
+/** True when a plain text field can hold this HTML without losing anything: empty, bare text
+ *  (no tag — a lone `<` in prose is text), or exactly one attribute-less `<p>…</p>` with no
+ *  inner tags. */
+export function htmlIsTrivial(html: string | null | undefined): boolean {
+  const s = (html ?? "").trim();
+  return !s || !TAG.test(s) || /^<p>[^<>]*<\/p>$/.test(s);
+}
+
+const ENTITIES: Record<string, string> = { "&nbsp;": " ", "&amp;": "&", "&lt;": "<", "&gt;": ">", "&quot;": "\"", "&#39;": "'" };
+
+/** Read-only preview text for an HTML body: block closes become lines, tags are stripped (a bare
+ *  `<` in prose is kept), the basic entities decode, and blank lines drop. */
+export function htmlPreviewText(html: string | null | undefined): string {
+  return (html ?? "").replace(/<br\s*\/?>/gi, "\n").replace(/<\/(p|h[1-6]|li|div|blockquote|pre|tr)>/gi, "\n")
+    .replace(/<\/?[a-z!?][^>]*>/gi, "").replace(/&(nbsp|amp|lt|gt|quot|#39);/g, (m) => ENTITIES[m] ?? m)
+    .split("\n").map((l) => l.replace(/\s+/g, " ").trim()).filter(Boolean).join("\n");
+}
+
+type RicosNode = { type?: unknown; nodes?: unknown; textData?: { decorations?: unknown }; paragraphData?: unknown; [key: string]: unknown };
+const onlyKeys = (o: object, allowed: string[]) => Object.keys(o).every((k) => allowed.includes(k));
+const emptyObject = (v: unknown) => v === undefined || (!!v && typeof v === "object" && Object.keys(v as object).length === 0);
+
+/** The paragraph styling a PLAIN paragraph still carries on the Ricos wire (Events v3 sends
+ *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). */
+function defaultParagraphData(pd: unknown): boolean {
+  if (pd === undefined) return true;
+  if (!pd || typeof pd !== "object" || !onlyKeys(pd, ["textStyle", "indentation"])) return false;
+  const { textStyle, indentation } = pd as { textStyle?: unknown; indentation?: unknown };
+  if (indentation !== undefined && indentation !== 0) return false;
+  if (textStyle === undefined) return true;
+  if (!textStyle || typeof textStyle !== "object" || !onlyKeys(textStyle, ["textAlignment"])) return false;
+  const align = (textStyle as { textAlignment?: unknown }).textAlignment;
+  return align === undefined || align === "AUTO";
+}
+
+/** True when a plain text field can round-trip this Ricos document: no document styling, and
+ *  only paragraphs of undecorated text whose paragraph data is the wire default. Anything else —
+ *  a heading, list, link, bold run, media node, alignment or indent — is rich. */
+export function ricosIsPlain(doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean {
+  if (!doc || !emptyObject(doc.documentStyle)) return false;
+  const nodes = Array.isArray(doc.nodes) ? (doc.nodes as RicosNode[]) : [];
+  return nodes.every((n) => !!n && typeof n === "object" && n.type === "PARAGRAPH"
+    && onlyKeys(n, ["type", "id", "nodes", "paragraphData"]) && defaultParagraphData(n.paragraphData)
+    && (Array.isArray(n.nodes) ? (n.nodes as RicosNode[]) : []).every((t) => !!t && typeof t === "object" && t.type === "TEXT"
+      && onlyKeys(t, ["type", "id", "textData", "nodes"]) && (!Array.isArray(t.nodes) || t.nodes.length === 0)
+      && !(Array.isArray(t.textData?.decorations) && t.textData.decorations.length)));
+}
+
+/** Preview text for a legacy DraftJS document: its `blocks[].text` joined by a blank line, or ""
+ *  when the payload is not DraftJS JSON (never a throw). */
+export function draftjsText(raw: string | null | undefined): string {
+  try {
+    const doc = JSON.parse(raw ?? "") as { blocks?: Array<{ text?: unknown }> } | null;
+    const blocks = Array.isArray(doc?.blocks) ? doc.blocks : [];
+    return blocks.map((b) => (typeof b?.text === "string" ? b.text : "")).join("\n\n").trim();
+  } catch { return ""; }
+}

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

@@ -16,7 +16,7 @@ import {
   type WixProductWrite,
 } from "@himalaya/wix-stores";
 import { get as dbGet, upsert as dbUpsert, remove as dbRemove, enqueue as dbEnqueue, type DbEntity } from "../_shared/owner-local-db.js";
-import { plainText } from "../_shared/himi-store.js";
+import { htmlIsTrivial, htmlPreviewText } from "../_shared/owner-rich-guard.js";
 import { ownerLoadError, isBridgeUnavailable, isOwnerPreviewDemo, shouldQueueOwnerWrite } from "../_shared/owner-load-error.js";
 import { DEMO_PRODUCTS, DEMO_NOTE, DEMO_SAVE_NOTE, demoRefusalPatch, editablePrice } from "../_shared/owner-preview-demo.js";
 import { stashCopy, copyParam } from "../_shared/himi-copy.js";
@@ -46,6 +46,14 @@ interface ProductFormState {
   price: string;
   sku: string;
   description: string;
+  /** [rico] #3363 — the description as loaded (or last saved). A save sends `description` only
+   *  when the submitted value differs from it, so an untouched body is never re-written. */
+  originalDescription: string;
+  /** A rich HTML description (more than one bare `<p>`) the plain field would flatten: it loads
+   *  locked, the descriptor shows `description` as a preview + `descriptionNote`, and an edit is refused. */
+  descriptionProtected: boolean;
+  descriptionEditable: boolean;
+  descriptionNote: string;
   visible: string;
   status: "idle" | "loading" | "saving" | "saved" | "error";
   error: string;
@@ -115,6 +123,10 @@ function shape(s: Partial<ProductFormState>): ProductFormState {
     price: s.price ?? "",
     sku: s.sku ?? "",
     description: s.description ?? "",
+    originalDescription: s.originalDescription ?? s.description ?? "",
+    descriptionProtected: s.descriptionProtected ?? false,
+    descriptionEditable: !(s.descriptionProtected ?? false),
+    descriptionNote: s.descriptionProtected ? copyParam("ownerProductForm.richDescriptionNote", "This description has formatting or media. Edit it in your site dashboard to keep that content intact; name, price and SKU can be changed here.") : "",
     visible: s.visible ?? "true",
     status: s.status ?? "idle",
     error: s.error ?? "",
@@ -177,7 +189,7 @@ const svc = defineService<ProductFormState, {
           name: (p as any).name ?? "",
           price: priceOf(p),
           sku: (p as any).sku ?? "",
-          description: plainText((p as any).description || ""),
+          ...((html: string) => ({ description: htmlPreviewText(html), originalDescription: htmlPreviewText(html), descriptionProtected: !htmlIsTrivial(html) }))(String((p as any).description ?? "")),
           visible: (p as any).visible !== false ? "true" : "false",
           status: "idle",
           error: "",
@@ -190,6 +202,8 @@ const svc = defineService<ProductFormState, {
           return shape({
             ...s, mode: "edit", id, heading: "Edit product",
             name: String(cached.name ?? ""), price: editablePrice(String(cached.price ?? "")), sku: String(cached.sku ?? ""),
+            // An older cached row carries no verdict, so it stays locked: fail closed.
+            description: String(cached.description ?? ""), originalDescription: String(cached.description ?? ""), descriptionProtected: cached.descriptionProtected !== "false",
             visible: cached.visible === "false" ? "false" : "true",
             status: "idle", error: "", savedMessage: "",
           });
@@ -217,6 +231,9 @@ const svc = defineService<ProductFormState, {
       const price = editablePrice(rawPrice);
       const sku = String(v.sku ?? s.sku).trim();
       const description = String(v.description ?? s.description).trim();
+      // A queue replay boots a FRESH worker (empty baseline), so it carries the original verdict.
+      const descriptionEdited = typeof v.descriptionEdited === "string" ? v.descriptionEdited === "true" : description !== s.originalDescription.trim();
+      if (descriptionEdited && s.descriptionProtected) return shape({ ...s, status: "error", savedMessage: "", error: copyParam("ownerProductForm.richDescriptionError", "This description has formatting or media. Edit it in your site dashboard to keep that content intact.") });
       const visible = boolString(v.visible, s.visible) === "true";
       if (!name) return shape({ ...s, status: "error", error: copyParam("ownerProductForm.nameRequired", "Name is required"), savedMessage: "" });
       const priceNum = Number(price);
@@ -232,12 +249,12 @@ const svc = defineService<ProductFormState, {
         priceData: { price: priceNum, currency: CURRENCY },
         visible,
         ...(sku ? { sku } : {}),
-        ...(description ? { description } : {}),
+        ...(descriptionEdited ? { description } : {}),
         ...(s.mode === "edit" && s.id ? {} : { productType: "physical" }),
       };
 
       // Optimistic local write — the list repaints from cache immediately (offline or not).
-      const localRow = (id: string): DbEntity => ({ id, name, price, sku, visible: visible ? "true" : "false", statusLabel: visible ? "Visible" : "Hidden" });
+      const localRow = (id: string): DbEntity => ({ id, name, price, sku, description, descriptionProtected: s.descriptionProtected ? "true" : "false", visible: visible ? "true" : "false", statusLabel: visible ? "Visible" : "Hidden" });
       const localId = s.mode === "edit" && s.id ? s.id : `local-${Date.now()}`;
       await cachePut(localRow(localId));
       try {
@@ -259,6 +276,7 @@ const svc = defineService<ProductFormState, {
           price,
           sku,
           description,
+          originalDescription: descriptionEdited ? description : s.originalDescription,
           visible: visible ? "true" : "false",
           status: "saved",
           error: "",
@@ -273,9 +291,10 @@ const svc = defineService<ProductFormState, {
           if (s.demoNote) return demoRefusal(s);
           // Real device offline: the optimistic cache row already shows; queue the
           // write to replay (WriteQueue, idempotent) when connectivity returns.
-          await queueWrite("tier5.himiOwnerLiteProductForm.submit", { id: s.id, name, price, sku, visible: String(visible), mode: s.mode });
+          await queueWrite("tier5.himiOwnerLiteProductForm.submit", { id: s.id, name, price, sku, description, descriptionEdited: String(descriptionEdited), visible: String(visible), mode: s.mode });
           return shape({
             ...s, mode: "edit", id: localId, name, price, sku, description,
+            originalDescription: descriptionEdited ? description : s.originalDescription,
             visible: visible ? "true" : "false", status: "saved", error: "",
             savedMessage: copyParam("ownerProductForm.savedOffline", "Saved offline — will sync when you reconnect."),
             savedId: localId,

package/templates/community-club-owner/dev/index.ts

@@ -72939,6 +72939,35 @@ const SCREENS = runtimeSetting({
                 }
               }
             },
+            {
+              "id": "product_form.description_note",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteProductForm.descriptionNote",
+                  "style": "footnote",
+                  "color": "textSecondary",
+                  "collapseWhenEmpty": true
+                }
+              }
+            },
+            {
+              "id": "product_form.description_preview",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteProductForm.description",
+                  "style": "body",
+                  "maxLines": 8,
+                  "collapseWhenEmpty": true
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionEditable"
+              }
+            },
             {
               "id": "product_form.form",
               "body": {
@@ -73025,6 +73054,9 @@ const SCREENS = runtimeSetting({
                             "multilineMaxLines": 3
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionProtected"
                       }
                     }
                   ],
@@ -73553,6 +73585,35 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                 }
               }
             },
+            {
+              "id": "product_form.description_note",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteProductForm.descriptionNote",
+                  "style": "footnote",
+                  "color": "textSecondary",
+                  "collapseWhenEmpty": true
+                }
+              }
+            },
+            {
+              "id": "product_form.description_preview",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteProductForm.description",
+                  "style": "body",
+                  "maxLines": 8,
+                  "collapseWhenEmpty": true
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionEditable"
+              }
+            },
             {
               "id": "product_form.form",
               "body": {
@@ -73639,6 +73700,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                             "multilineMaxLines": 3
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionProtected"
                       }
                     }
                   ],
@@ -73836,6 +73900,35 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                 }
               }
             },
+            {
+              "id": "event_form.description_note",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteEventForm.descriptionNote",
+                  "style": "footnote",
+                  "color": "textSecondary",
+                  "collapseWhenEmpty": true
+                }
+              }
+            },
+            {
+              "id": "event_form.description_preview",
+              "body": {
+                "package": "himalaya",
+                "type": "Text",
+                "props": {
+                  "text": "$service:himiOwnerLiteEventForm.description",
+                  "style": "body",
+                  "maxLines": 8,
+                  "collapseWhenEmpty": true
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiOwnerLiteEventForm.descriptionEditable"
+              }
+            },
             {
               "id": "event_form.form",
               "body": {
@@ -73880,6 +73973,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                             "multilineMaxLines": 3
                           }
                         }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteEventForm.descriptionProtected"
                       }
                     }
                   ],

package/templates/community-club-owner/tier5-src/_shared/owner-rich-guard.ts

@@ -0,0 +1,64 @@
+// [rico] #3363 — may a plain owner form round-trip this body? Ricos uses owner-post-content's
+// hasRichBody; these cover the Stores HTML description and the FAQ's legacy DraftJS answer.
+// [rico] #3365 moves htmlIsTrivial into @himalaya/wix-rich-content with these exact semantics.
+
+/** A tag opener (`<p`, `</p`, `<!--`), as opposed to a bare `<` in prose ("cups < 8 cm"). */
+const TAG = /<[a-z!/?]/i;
+
+/** True when a plain text field can hold this HTML without losing anything: empty, bare text
+ *  (no tag — a lone `<` in prose is text), or exactly one attribute-less `<p>…</p>` with no
+ *  inner tags. */
+export function htmlIsTrivial(html: string | null | undefined): boolean {
+  const s = (html ?? "").trim();
+  return !s || !TAG.test(s) || /^<p>[^<>]*<\/p>$/.test(s);
+}
+
+const ENTITIES: Record<string, string> = { "&nbsp;": " ", "&amp;": "&", "&lt;": "<", "&gt;": ">", "&quot;": "\"", "&#39;": "'" };
+
+/** Read-only preview text for an HTML body: block closes become lines, tags are stripped (a bare
+ *  `<` in prose is kept), the basic entities decode, and blank lines drop. */
+export function htmlPreviewText(html: string | null | undefined): string {
+  return (html ?? "").replace(/<br\s*\/?>/gi, "\n").replace(/<\/(p|h[1-6]|li|div|blockquote|pre|tr)>/gi, "\n")
+    .replace(/<\/?[a-z!?][^>]*>/gi, "").replace(/&(nbsp|amp|lt|gt|quot|#39);/g, (m) => ENTITIES[m] ?? m)
+    .split("\n").map((l) => l.replace(/\s+/g, " ").trim()).filter(Boolean).join("\n");
+}
+
+type RicosNode = { type?: unknown; nodes?: unknown; textData?: { decorations?: unknown }; paragraphData?: unknown; [key: string]: unknown };
+const onlyKeys = (o: object, allowed: string[]) => Object.keys(o).every((k) => allowed.includes(k));
+const emptyObject = (v: unknown) => v === undefined || (!!v && typeof v === "object" && Object.keys(v as object).length === 0);
+
+/** The paragraph styling a PLAIN paragraph still carries on the Ricos wire (Events v3 sends
+ *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). */
+function defaultParagraphData(pd: unknown): boolean {
+  if (pd === undefined) return true;
+  if (!pd || typeof pd !== "object" || !onlyKeys(pd, ["textStyle", "indentation"])) return false;
+  const { textStyle, indentation } = pd as { textStyle?: unknown; indentation?: unknown };
+  if (indentation !== undefined && indentation !== 0) return false;
+  if (textStyle === undefined) return true;
+  if (!textStyle || typeof textStyle !== "object" || !onlyKeys(textStyle, ["textAlignment"])) return false;
+  const align = (textStyle as { textAlignment?: unknown }).textAlignment;
+  return align === undefined || align === "AUTO";
+}
+
+/** True when a plain text field can round-trip this Ricos document: no document styling, and
+ *  only paragraphs of undecorated text whose paragraph data is the wire default. Anything else —
+ *  a heading, list, link, bold run, media node, alignment or indent — is rich. */
+export function ricosIsPlain(doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean {
+  if (!doc || !emptyObject(doc.documentStyle)) return false;
+  const nodes = Array.isArray(doc.nodes) ? (doc.nodes as RicosNode[]) : [];
+  return nodes.every((n) => !!n && typeof n === "object" && n.type === "PARAGRAPH"
+    && onlyKeys(n, ["type", "id", "nodes", "paragraphData"]) && defaultParagraphData(n.paragraphData)
+    && (Array.isArray(n.nodes) ? (n.nodes as RicosNode[]) : []).every((t) => !!t && typeof t === "object" && t.type === "TEXT"
+      && onlyKeys(t, ["type", "id", "textData", "nodes"]) && (!Array.isArray(t.nodes) || t.nodes.length === 0)
+      && !(Array.isArray(t.textData?.decorations) && t.textData.decorations.length)));
+}
+
+/** Preview text for a legacy DraftJS document: its `blocks[].text` joined by a blank line, or ""
+ *  when the payload is not DraftJS JSON (never a throw). */
+export function draftjsText(raw: string | null | undefined): string {
+  try {
+    const doc = JSON.parse(raw ?? "") as { blocks?: Array<{ text?: unknown }> } | null;
+    const blocks = Array.isArray(doc?.blocks) ? doc.blocks : [];
+    return blocks.map((b) => (typeof b?.text === "string" ? b.text : "")).join("\n\n").trim();
+  } catch { return ""; }
+}