@wix/himalaya-cli 0.1173.0 → 0.1174.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/stores-v1/src/extensions.d.ts

@@ -1,18 +1,28 @@
 import type { WixProductWrite, WixCreateProductResponse, WixUpdateProductResponse, WixDeleteProductResponse } from "./index.js";
 import type { WixQueryProductsRequest, WixQueryProductsResponse, WixGetProductResponse } from "./index.js";
+import { type V3RichContent } from "./products-v3.js";
+/** [rico] #3373 — the Catalog-V3 Ricos description. */
+export type WixProductRichContent = V3RichContent;
+export type WixProductRichWrite = WixProductWrite & {
+    richDescription?: WixProductRichContent;
+};
 /** Query products from whichever catalog this site runs. The V1 request shape
  *  (`{query:{paging:{limit,offset}}}`) is the SDK's contract; the V3 arm maps it
  *  onto cursor paging and reshapes each product back to the V1 layout. */
 export declare function queryProducts(req?: WixQueryProductsRequest): Promise<WixQueryProductsResponse>;
-/** Read one product from whichever catalog this site runs. */
-export declare function getProduct(productId: string): Promise<WixGetProductResponse>;
+/** Read one product from whichever catalog this site runs. `opts.richDescription` (Catalog V3) also asks
+ *  for the Ricos `description` and returns it as `product.richDescription` (null when the product has
+ *  none). The key is ABSENT on a V1 catalog, which has no Ricos description, and without the option. */
+export declare function getProduct(productId: string, opts?: {
+    richDescription?: boolean;
+}): Promise<WixGetProductResponse>;
 /** Create a product. V1: `POST /stores/v1/products`. V3: `POST /stores/v3/products`
  *  with the write model mapped onto V3's variants shape (see products-v3.ts). */
 export declare function createProduct(product: WixProductWrite): Promise<WixCreateProductResponse>;
 /** Update a product. V1: a plain `PATCH` of the supplied fields. V3: requires the
  *  CURRENT `revision`, and rewrites the whole variants array when the patch reaches
  *  a variant-level field (price/sku) — so that arm reads the product first. */
-export declare function updateProduct(productId: string, product: WixProductWrite): Promise<WixUpdateProductResponse>;
+export declare function updateProduct(productId: string, product: WixProductRichWrite): Promise<WixUpdateProductResponse>;
 /** Delete a product — `DELETE /stores/v{1,3}/products/{id}`; same shape either way. */
 export declare function deleteProduct(productId: string): Promise<WixDeleteProductResponse>;
 export interface WixInventoryVariant {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/stores-v1/src/products-v3.d.ts

@@ -12,6 +12,13 @@ export interface V3Variant {
     };
     choices?: unknown[];
 }
+/** [rico] #3373 — Catalog V3's Ricos `description`. `plainDescription` is the SAME field rendered as HTML:
+ *  V3 derives one from the other, so a write sends only `description`. */
+export interface V3RichContent {
+    nodes?: unknown[];
+    metadata?: unknown;
+    documentStyle?: unknown;
+}
 export interface V3Product {
     id?: string;
     revision?: string;
@@ -20,6 +27,7 @@ export interface V3Product {
     productType?: string;
     physicalProperties?: Record<string, unknown>;
     plainDescription?: string;
+    description?: V3RichContent;
     visible?: boolean;
     variantsInfo?: {
         variants?: V3Variant[];
@@ -43,6 +51,8 @@ export declare const V3_WRITE_FIELDS: readonly ["CURRENCY", "PLAIN_DESCRIPTION"]
  * `"MEDIA_ITEMS_INFO"` to the `fields` array.
  */
 export declare const V3_READ_FIELDS: readonly ["CURRENCY", "URL", "PLAIN_DESCRIPTION", "MEDIA_ITEMS_INFO"];
+/** A single-product read that also carries the Ricos `description` (an owner product form). */
+export declare const V3_DETAIL_READ_FIELDS: readonly ["CURRENCY", "URL", "PLAIN_DESCRIPTION", "MEDIA_ITEMS_INFO", "DESCRIPTION"];
 /** Most a single V3 products query will return. Bounds the offset emulation in
  *  `queryProducts` (V3 pages by cursor; the SDK's callers page by offset). */
 export declare const V3_MAX_QUERY_LIMIT = 100;
@@ -123,4 +133,6 @@ export declare function touchesVariant(p: WixProductWrite): boolean;
  * delete the others), and `options` must ride along because variants and options
  * are mutually dependent.
  */
-export declare function toV3Update(productId: string, patch: WixProductWrite, current: V3Product): V3Product;
+export declare function toV3Update(productId: string, patch: WixProductWrite & {
+    richDescription?: V3RichContent;
+}, current: V3Product): V3Product;

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

@@ -134,6 +134,7 @@ async function resolveCatalogVersion() {
 // ../../stdlib/wix-sdk/stores-v1/src/products-v3.ts
 var V3_WRITE_FIELDS = ["CURRENCY", "PLAIN_DESCRIPTION"];
 var V3_READ_FIELDS = ["CURRENCY", "URL", "PLAIN_DESCRIPTION", "MEDIA_ITEMS_INFO"];
+var V3_DETAIL_READ_FIELDS = [...V3_READ_FIELDS, "DESCRIPTION"];
 var V3_MAX_QUERY_LIMIT = 100;
 var V3_VARIANT_READ_FIELDS = ["VARIANT_OPTION_CHOICE_NAMES", "CURRENCY"];
 function toV3ProductType(productType) {
@@ -193,9 +194,11 @@ function touchesVariant(p) {
   return p.priceData?.price !== void 0 || p.sku !== void 0;
 }
 function toV3Update(productId, patch, current) {
+  if (patch.description !== void 0 && patch.richDescription !== void 0) throw new Error("updateProduct: send description OR richDescription, not both (Catalog V3 derives one from the other)");
   const out = { id: productId, revision: current.revision };
   if (patch.name !== void 0) out.name = patch.name;
   if (patch.description !== void 0) out.plainDescription = patch.description;
+  if (patch.richDescription !== void 0) out.description = patch.richDescription;
   if (patch.visible !== void 0) out.visible = patch.visible;
   if (touchesVariant(patch)) {
     const existing = current.variantsInfo?.variants ?? [];
@@ -724,16 +727,19 @@ function queryProducts(req = {}) {
     return { products: page.map(fromV3Product) };
   });
 }
-function getProduct(productId) {
+function getProduct(productId, opts = {}) {
   if (!productId) throw new Error("getProduct: productId is required");
   const id = encodeURIComponent(productId);
+  const fields = opts.richDescription ? V3_DETAIL_READ_FIELDS : V3_READ_FIELDS;
   return readWithCatalogFallback(async (v) => {
     if (v === "v1") return wixCall("GET", `/stores/v1/products/${id}`);
     const res = await wixCall(
       "GET",
-      `/stores/v3/products/${id}?${V3_READ_FIELDS.map((f) => `fields=${f}`).join("&")}`
+      `/stores/v3/products/${id}?${fields.map((f) => `fields=${f}`).join("&")}`
     );
-    return { product: res.product ? fromV3Product(res.product) : void 0 };
+    if (!res.product) return { product: void 0 };
+    const product = fromV3Product(res.product);
+    return { product: opts.richDescription ? { ...product, richDescription: res.product.description ?? null } : product };
   });
 }
 async function createProduct(product) {
@@ -747,6 +753,7 @@ async function createProduct(product) {
 }
 async function updateProduct(productId, product) {
   if (await resolveCatalogVersion() === "v1") {
+    if (product.richDescription !== void 0) throw new Error("updateProduct: richDescription is Catalog V3 only (a V1 description is HTML)");
     return wixCall("PATCH", `/stores/v1/products/${productId}`, { product });
   }
   const current = await wixCall(

package/dist/cli.mjs

@@ -30829,6 +30829,7 @@ function hasContributed(bag, fieldId) {
 }
 function createFormBag() {
   const subs = /* @__PURE__ */ new Set();
+  const preSubmit = /* @__PURE__ */ new Set();
   const notify = () => {
     bag.version++;
     for (const cb of subs) cb();
@@ -30879,6 +30880,15 @@ function createFormBag() {
       return () => {
         subs.delete(cb);
       };
+    },
+    onBeforeSubmit(cb) {
+      preSubmit.add(cb);
+      return () => {
+        preSubmit.delete(cb);
+      };
+    },
+    beforeSubmit() {
+      for (const cb of Array.from(preSubmit)) cb();
     }
   };
   return bag;
@@ -31369,6 +31379,12 @@ function createRicosHostSession(o) {
         o.send({ v: 1, type: "requestContent", requestId: requestId2 });
       });
     },
+    flushOnChange() {
+      if (dirtyTimer === null || disposed || state.unavailable) return;
+      t.clearTimeout(dirtyTimer);
+      dirtyTimer = null;
+      o.onDirty();
+    },
     focus() {
       if (state.ready) o.send({ v: 1, type: "focus" });
     },
@@ -31634,7 +31650,11 @@ function RichContentEditorView({ props, ctx, wrap, nodeId, renderChild, ...dom }
     bag.register(name, void 0);
     const current = sessionRef.current?.currentContent();
     if (current != null) bag.set(name, current);
-    return () => bag.unregister(name);
+    const off = bag.onBeforeSubmit(() => sessionRef.current?.flushOnChange());
+    return () => {
+      off();
+      bag.unregister(name);
+    };
   }, [bag, name]);
   const fireOnChange = () => {
     const act = onChangeRef.current;
@@ -36094,6 +36114,7 @@ var init_renderNode = __esm({
             bag.markSubmitAttempted();
             return;
           }
+          bag.beforeSubmit();
           const merged = { ...action?.args ?? {}, ...bag.values };
           ctx.onAction?.({ ...action, args: merged });
         }
@@ -60243,21 +60264,21 @@ var init_preview_assets_generated = __esm({
   "../../packages/serve/src/preview-assets.generated.ts"() {
     init_preview_assets_format();
     PREVIEW_ASSET_MANIFEST = [
-      { key: "assets/index-B1fE1B9T.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1131811, sha256: "ead747f6e5d3d289965dc0d3486f678d999616cec487643300b3103983bc9462" },
-      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1131819, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
-      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1136429, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
-      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1625013, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
-      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1715937, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
-      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1806921, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
-      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1897901, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
-      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1988773, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
-      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 2079753, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
-      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2188389, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
-      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2297473, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
-      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2406521, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
-      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2514221, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
-      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2602329, length: 4947, sha256: "4c3de9771721e41385e297f5e97c0ecd9a76e557a3584d3e6e7820e4bc615c96" },
-      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2607276, length: 17344, sha256: "d057298d75e7373e5e2c4d11b7d1bcbea88e03af555ba63d97641c78509c58e4" }
+      { key: "assets/index-Ctt1n3e8.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1132082, sha256: "58a8eb07cd4a6bf0fb735b45cc42f1a2014647bbcc385425be2d867b289fce19" },
+      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1132090, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
+      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1136700, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1625284, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1716208, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1807192, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1898172, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1989044, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 2080024, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2188660, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2297744, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2406792, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2514492, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2602600, length: 4947, sha256: "35d5f5e7975e3975dd3efac82d1c12f81c6e29fd16fe74247b9ebf881b0e6d31" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2607547, length: 17344, sha256: "d057298d75e7373e5e2c4d11b7d1bcbea88e03af555ba63d97641c78509c58e4" }
     ];
   }
 });

package/guides/sdk-reference.json

@@ -22202,6 +22202,18 @@
         "decl": "export function addProductMedia(\n  productId: string,\n  opts?: WixCallOptions,\n): Promise<WixAddProductMediaResponse>;",
         "http": "POST /stores/v1/products/{…}/media"
       },
+      {
+        "name": "WixProductRichContent",
+        "kind": "type",
+        "jsdoc": "/** [rico] #3373 — the Catalog-V3 Ricos description. */",
+        "decl": "export type WixProductRichContent = V3RichContent;"
+      },
+      {
+        "name": "WixProductRichWrite",
+        "kind": "type",
+        "jsdoc": "",
+        "decl": "export type WixProductRichWrite = WixProductWrite & { richDescription?: WixProductRichContent };"
+      },
       {
         "name": "queryProducts",
         "kind": "function",
@@ -22212,8 +22224,8 @@
       {
         "name": "getProduct",
         "kind": "function",
-        "jsdoc": "/** Read one product from whichever catalog this site runs. */",
-        "decl": "export function getProduct(productId: string): Promise<WixGetProductResponse>;",
+        "jsdoc": "/** Read one product from whichever catalog this site runs. `opts.richDescription` (Catalog V3) also asks\n *  for the Ricos `description` and returns it as `product.richDescription` (null when the product has\n *  none). The key is ABSENT on a V1 catalog, which has no Ricos description, and without the option. */",
+        "decl": "export function getProduct(productId: string, opts: { richDescription?: boolean } = {}): Promise<WixGetProductResponse>;",
         "http": "GET /stores/v1/products/{…}"
       },
       {
@@ -22227,7 +22239,7 @@
         "name": "updateProduct",
         "kind": "function",
         "jsdoc": "/** Update a product. V1: a plain `PATCH` of the supplied fields. V3: requires the\n *  CURRENT `revision`, and rewrites the whole variants array when the patch reaches\n *  a variant-level field (price/sku) — so that arm reads the product first. */",
-        "decl": "export async function updateProduct(productId: string, product: WixProductWrite): Promise<WixUpdateProductResponse>;",
+        "decl": "export async function updateProduct(productId: string, product: WixProductRichWrite): Promise<WixUpdateProductResponse>;",
         "http": "PATCH /stores/v1/products/{…}"
       },
       {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1173.0",
+  "version": "0.1174.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": [
@@ -67,5 +67,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "fc977b9009025546041cea5d65a9071a51a3cf6949cc0ce3419d2f24"
+  "falconPackageHash": "67d51a3995755dd7861ad74fab421d09ed2ecd3590c2d5df555e0068"
 }

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

@@ -74057,7 +74057,7 @@ const SCREENS = runtimeSetting({
                         "package": "himalaya",
                         "type": "FormField",
                         "props": {
-                          "id": "description",
+                          "id": "descriptionText",
                           "label": "Description",
                           "kind": "text",
                           "text": {
@@ -74070,7 +74070,90 @@ const SCREENS = runtimeSetting({
                         }
                       },
                       "modifiers": {
-                        "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionProtected"
+                        "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionFieldHidden"
+                      }
+                    },
+                    {
+                      "id": "product_form.description_slot",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "VStack",
+                        "props": {
+                          "spacing": 6,
+                          "alignment": "leading",
+                          "children": [
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "Description",
+                                  "style": "bodyEmphasis"
+                                }
+                              }
+                            },
+                            {
+                              "id": "product_description_editor",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "RichContentEditor",
+                                "props": {
+                                  "name": "description",
+                                  "documentPath": "$service:himiOwnerLiteProductForm.descriptionJson",
+                                  "placeholder": "Optional",
+                                  "uploadService": "himiOwnerLiteProductFormUploads",
+                                  "onChange": {
+                                    "actionId": "tier5.himiOwnerLiteProductForm.descriptionChanged"
+                                  },
+                                  "minHeight": 200,
+                                  "fallback": {
+                                    "id": "product_form.description_unavailable",
+                                    "body": {
+                                      "package": "himalaya",
+                                      "type": "VStack",
+                                      "props": {
+                                        "spacing": 4,
+                                        "alignment": "leading",
+                                        "children": [
+                                          {
+                                            "id": "",
+                                            "body": {
+                                              "package": "himalaya",
+                                              "type": "Text",
+                                              "props": {
+                                                "text": "Editor unavailable",
+                                                "style": "title3"
+                                              }
+                                            }
+                                          },
+                                          {
+                                            "id": "",
+                                            "body": {
+                                              "package": "himalaya",
+                                              "type": "Text",
+                                              "props": {
+                                                "text": "The description can’t be edited here right now. Name, price and SKU still save, and the description stays as it is.",
+                                                "style": "footnote",
+                                                "color": "textSecondary"
+                                              }
+                                            }
+                                          }
+                                        ]
+                                      }
+                                    }
+                                  }
+                                }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionPending"
+                              }
+                            }
+                          ]
+                        }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionEditorHidden"
                       }
                     }
                   ],
@@ -74339,7 +74422,7 @@ const SCREENS = runtimeSetting({
                                   "onChange": {
                                     "actionId": "tier5.himiOwnerLitePostForm.bodyChanged"
                                   },
-                                  "minHeight": 360,
+                                  "minHeight": 240,
                                   "fallback": {
                                     "id": "post_form.body_unavailable",
                                     "body": {
@@ -74796,7 +74879,7 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                         "package": "himalaya",
                         "type": "FormField",
                         "props": {
-                          "id": "description",
+                          "id": "descriptionText",
                           "label": "Description",
                           "kind": "text",
                           "text": {
@@ -74809,7 +74892,90 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                         }
                       },
                       "modifiers": {
-                        "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionProtected"
+                        "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionFieldHidden"
+                      }
+                    },
+                    {
+                      "id": "product_form.description_slot",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "VStack",
+                        "props": {
+                          "spacing": 6,
+                          "alignment": "leading",
+                          "children": [
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "Description",
+                                  "style": "bodyEmphasis"
+                                }
+                              }
+                            },
+                            {
+                              "id": "product_description_editor",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "RichContentEditor",
+                                "props": {
+                                  "name": "description",
+                                  "documentPath": "$service:himiOwnerLiteProductForm.descriptionJson",
+                                  "placeholder": "Optional",
+                                  "uploadService": "himiOwnerLiteProductFormUploads",
+                                  "onChange": {
+                                    "actionId": "tier5.himiOwnerLiteProductForm.descriptionChanged"
+                                  },
+                                  "minHeight": 200,
+                                  "fallback": {
+                                    "id": "product_form.description_unavailable",
+                                    "body": {
+                                      "package": "himalaya",
+                                      "type": "VStack",
+                                      "props": {
+                                        "spacing": 4,
+                                        "alignment": "leading",
+                                        "children": [
+                                          {
+                                            "id": "",
+                                            "body": {
+                                              "package": "himalaya",
+                                              "type": "Text",
+                                              "props": {
+                                                "text": "Editor unavailable",
+                                                "style": "title3"
+                                              }
+                                            }
+                                          },
+                                          {
+                                            "id": "",
+                                            "body": {
+                                              "package": "himalaya",
+                                              "type": "Text",
+                                              "props": {
+                                                "text": "The description can’t be edited here right now. Name, price and SKU still save, and the description stays as it is.",
+                                                "style": "footnote",
+                                                "color": "textSecondary"
+                                              }
+                                            }
+                                          }
+                                        ]
+                                      }
+                                    }
+                                  }
+                                }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionPending"
+                              }
+                            }
+                          ]
+                        }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteProductForm.descriptionEditorHidden"
                       }
                     }
                   ],
@@ -75324,7 +75490,7 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                   "onChange": {
                                     "actionId": "tier5.himiOwnerLitePostForm.bodyChanged"
                                   },
-                                  "minHeight": 360,
+                                  "minHeight": 240,
                                   "fallback": {
                                     "id": "post_form.body_unavailable",
                                     "body": {

package/templates/beauty-salon-owner/tier5-src/_shared/owner-editor-value.ts

@@ -8,7 +8,7 @@
 // drops nodes the owner never touched).
 // Inside the platform source this import is a relative path, so node test runs resolve it; an app's
 // copy imports "@himalaya/wix-rich-content".
-import { parseRicosJson, RICH_CONTENT_LIMITS, type RicosDocument } from "@himalaya/wix-rich-content";
+import { parseRicosJson, isPlainRicos, RICH_CONTENT_LIMITS, type RicosDocument } from "@himalaya/wix-rich-content";
 
 export type EditorValue =
   | { kind: "absent" }                                  // leave the stored body untouched
@@ -45,12 +45,78 @@ function overLimits(doc: RicosDocument): boolean {
   return false;
 }
 
-/** `raw` is `values[name]`; `seededJson` is the string the form published as the editor's seed. */
-export function editorValue(raw: unknown, seededJson: string): EditorValue {
-  if (typeof raw !== "string" || raw === "") return { kind: "absent" };
-  if (seededJson !== "" && raw === seededJson) return { kind: "unchanged" };
+const TEXT_ONLY = new Set(["PARAGRAPH", "TEXT", "HEADING", "BULLETED_LIST", "ORDERED_LIST", "LIST_ITEM", "BLOCKQUOTE", "CODE_BLOCK"]);
+/** No visible text and no non-text node (an image, a divider, an embed…): an empty body. */
+export function isEmptyDocument(doc: RicosDocument): boolean {
+  const empty = (nodes: RicosDocument["nodes"] | undefined): boolean => (nodes ?? []).every((n) =>
+    TEXT_ONLY.has(String(n?.type)) && !String(n.textData?.text ?? "").trim() && empty(n.nodes));
+  return empty(doc.nodes);
+}
+
+/** A Ricos JSON string checked as every viewer would: the limits first, then the shape. */
+function checkedDocument(raw: string): EditorValue {
   if (utf8Bytes(raw) > RICH_CONTENT_LIMITS.maxBytes) return { kind: "too_large" };
   const doc = parseRicosJson(raw);
   if (!doc) return { kind: "invalid" };
   return overLimits(doc) ? { kind: "too_large" } : { kind: "doc", doc, json: raw };
 }
+
+/** `raw` is `values[name]`; `seededJson` is the string the form published as the editor's seed. */
+export function editorValue(raw: unknown, seededJson: string): EditorValue {
+  if (typeof raw !== "string" || raw === "") return { kind: "absent" };
+  if (seededJson !== "" && raw === seededJson) return { kind: "unchanged" };
+  const checked = checkedDocument(raw);
+  // An empty editor over no body (a record that had none) writes nothing, rather than an empty document.
+  if (checked.kind === "doc" && seededJson === "" && isEmptyDocument(checked.doc)) return { kind: "unchanged" };
+  return checked;
+}
+
+// ── The per-field editor machinery every owner form shares (post body, event / product description,
+// FAQ answer). Each form keeps `<key>Json` (the seed), `<key>Pending` and `<key>Dirty` in its state.
+
+/** `<key>Pending`: until this run's load lands, the descriptor hides the editor — it seeds ONCE, so a
+ *  provisional editor the owner typed into would keep that text over the real document.
+ *  `<key>Dirty`: the editor's on_change fired since the field was loaded or saved. Once ready the bag
+ *  ALWAYS holds a document — the engine's own re-serialization of the seed, not byte-equal to it — so
+ *  only this says the owner edited the field. Every arm fires a pending on_change before it releases a
+ *  Form submit, so an edit made inside the debounce window is reported before the submit reads it. */
+export interface EditorGate { pending: boolean; dirty: boolean }
+
+/** What a live submit does with `values[name]`: only an edit the editor reported counts. */
+export function editorSubmitValue(raw: unknown, seededJson: string, gate: EditorGate): EditorValue {
+  return gate.pending || !gate.dirty ? { kind: "absent" } : editorValue(raw, seededJson);
+}
+
+/** A queued write's document. A replay runs in a FRESH worker with no editor, so the string is checked
+ *  again (shape and limits); "absent" when the item carries none. Never "unchanged": it was an edit. */
+export function queuedDocument(raw: unknown): EditorValue {
+  return typeof raw === "string" && raw !== "" ? checkedDocument(raw) : { kind: "absent" };
+}
+
+/** The editor's on_change: the field is now edited, and a confirmation of an earlier save is stale.
+ *  No timing window: an arm fires the pending on_change BEFORE it releases a submit, so any on_change
+ *  that arrives after a save carries an edit that save did not write. */
+export function editorChanged<S extends { status: string; savedMessage: string }>(s: S): Pick<S, "status" | "savedMessage"> {
+  return { status: s.status === "saved" ? "idle" : s.status, savedMessage: "" };
+}
+
+/** The offline cache's verdict on the stored body (`<key>Protected`): rich unless KNOWN plain. From the
+ *  document when the form knows it; otherwise plain only when the record was loaded as plain. A bundle
+ *  rolled back past the editor reads this flag to decide whether its plain field may overwrite the body. */
+export function cachedRichVerdict(doc: RicosDocument | null, knownPlain: boolean): "true" | "false" {
+  if (doc) return isPlainRicos(doc) ? "false" : "true";
+  return knownPlain ? "false" : "true";
+}
+
+/** Cold boot: the runtime lays this service's last persisted snapshot over its declared state, so the
+ *  editor's first seed would be the document as it was when the screen last ran — and a Save after
+ *  typing would write it over whatever the record holds now. Blank the hydrated seed and reset the gate
+ *  before anything renders, in place (no action has run yet). `extra` resets further UI state. */
+export function resetHydratedEditor(svc: unknown, keys: { json: string; pending: string; dirty: string }, pendingAtBoot: boolean, extra: Record<string, unknown> = {}): void {
+  const booted = (svc as { getState?: () => Record<string, unknown> | undefined }).getState?.();
+  if (!booted || typeof booted !== "object") return;
+  if (booted[keys.json]) booted[keys.json] = "";
+  booted[keys.pending] = pendingAtBoot;
+  booted[keys.dirty] = false;
+  Object.assign(booted, extra);
+}

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

@@ -2,7 +2,7 @@
 // this file adds the read-only previews the forms show for a locked body, and the FAQ's legacy DraftJS answer.
 // Inside the platform source this import is a relative path, so node test runs resolve it; an app's copy
 // imports "@himalaya/wix-rich-content".
-import { htmlIsTrivial, isPlainRicos } from "@himalaya/wix-rich-content";
+import { htmlIsTrivial } from "@himalaya/wix-rich-content";
 
 export { htmlIsTrivial };
 
@@ -16,14 +16,6 @@ export function htmlPreviewText(html: string | null | undefined): string {
     .split("\n").map((l) => l.replace(/\s+/g, " ").trim()).filter(Boolean).join("\n");
 }
 
-/** 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 (Events v3 sends
- *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). Anything else —
- *  a heading, list, link, bold run, media node, alignment or indent — is rich, and so is a missing
- *  document (callers decide what an absent body means). */
-export const ricosIsPlain = (doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean =>
-  !!doc && isPlainRicos(doc);
-
 /** 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 {