@wix/himalaya-cli 0.1173.0 → 0.1175.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

@@ -24519,6 +24519,7 @@ function shouldRevealError(args) {
 var EMAIL_RE, URL_HOST_RE, INTEGER_RE, NUMBER_RE;
 var init_validation = __esm({
   "../../core/ts/src/validation.ts"() {
+    "use strict";
     EMAIL_RE = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}$/;
     URL_HOST_RE = /^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*(:[0-9]+)?$/;
     INTEGER_RE = /^[+-]?[0-9]+$/;
@@ -25178,6 +25179,7 @@ function validateWorkerSubtree(raw, slotId, policy, actionCatalog) {
 var WORKER_SUBTREE_CEILINGS, ID_PART, ACTION_ID;
 var init_worker_subtree = __esm({
   "../../core/ts/src/worker-subtree.ts"() {
+    "use strict";
     init_worker_subtree_safe_types_generated();
     WORKER_SUBTREE_CEILINGS = Object.freeze({
       maxEncodedBytes: 65536,
@@ -30829,6 +30831,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 +30882,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 +31381,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 +31652,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;
@@ -35233,6 +35255,12 @@ function renderInner(node, ctx) {
         }
       );
       const fieldLabel = asBoundText(props.label, ctx);
+      if (isTextKind && typeof props.label === "string" && props.label) {
+        inner.modifiers = { accessibilityLabel: props.label };
+      }
+      if (isTextKind && typeof props.helpText === "string" && props.helpText) {
+        inner.modifiers = { ...inner.modifiers ?? {}, accessibilityHint: props.helpText };
+      }
       const showOwnError = !isTextKind && props.errorMessage;
       return /* @__PURE__ */ jsxs5("div", { style: { width: "100%", ...wrap }, children: [
         (fieldLabel || props.required) && /* @__PURE__ */ jsxs5("div", { style: { fontFamily: bodyFont(ctx), fontWeight: 600, fontSize: pxToRem(13), color: C("textPrimary", "#111"), marginBottom: 6 }, children: [
@@ -35761,13 +35789,18 @@ var init_renderNode = __esm({
     AUTOCAPITALIZE_VALUES = /* @__PURE__ */ new Set(["none", "words", "sentences", "characters"]);
     ENTER_KEY_HINTS = /* @__PURE__ */ new Set(["done", "go", "next", "send", "search"]);
     AUTOGROW_CEILING = 12;
-    EditableField = ({ props, ctx, wrap, multiline, id: htmlId, "data-component-id": componentId, "data-component-type": componentType, tabIndex: tabIndexProp, "data-hm-synthetic-tabindex": tabIndexIsSynthetic, "data-himalaya-initial-focus": initialFocusMarker, "aria-live": ariaLive, "aria-atomic": ariaAtomic, "aria-relevant": ariaRelevant, "aria-label": ariaLabelProp }) => {
+    EditableField = ({ props, ctx, wrap, multiline, id: htmlId, "data-component-id": componentId, "data-component-type": componentType, tabIndex: tabIndexProp, "data-hm-synthetic-tabindex": tabIndexIsSynthetic, "data-himalaya-initial-focus": initialFocusMarker, "aria-live": ariaLive, "aria-atomic": ariaAtomic, "aria-relevant": ariaRelevant, "aria-label": ariaLabelProp, "aria-describedby": describedByProp }) => {
       const tabIndex = tabIndexIsSynthetic === true ? void 0 : tabIndexProp;
       const a11yFwd = { tabIndex, "data-himalaya-initial-focus": initialFocusMarker, "aria-live": ariaLive, "aria-atomic": ariaAtomic, "aria-relevant": ariaRelevant };
       const C = ctx.color;
       const ctrl = props.text ?? props.value;
       const cfg = ctrl && typeof ctrl === "object" ? ctrl : {};
-      const placeholder2 = String(props.placeholder ?? cfg.placeholder ?? "Type here\u2026");
+      const rawPlaceholder = props.placeholder ?? cfg.placeholder;
+      const resolvedPlaceholder = useResolvedScalar(rawPlaceholder, ctx);
+      const placeholderIsBinding = isBinding(rawPlaceholder);
+      const placeholder2 = rawPlaceholder == null || placeholderIsBinding && resolvedPlaceholder == null ? "Type here\u2026" : placeholderIsBinding ? asTextL10n(resolvedPlaceholder, ctx) : asText2(rawPlaceholder);
+      const prefixText = useBoundString(props.prefix, ctx);
+      const suffixText = useBoundString(props.suffix, ctx);
       const valueBinding = typeof ctrl === "string" ? ctrl : cfg.value;
       const onChangeAction = props.onChange ?? cfg.onChange;
       const borderless = props.borderless === true || cfg.borderless === true;
@@ -35806,10 +35839,18 @@ var init_renderNode = __esm({
       const errorBindingRaw = props.errorPath ?? cfg.errorPath;
       const errorBinding = typeof errorBindingRaw === "string" && isBinding(errorBindingRaw) ? errorBindingRaw : "";
       const boundError = useBoundValue(ctx, errorBinding);
-      const workerError = typeof boundError === "string" ? boundError : props.errorText ?? cfg.errorText;
+      const errorTextRaw = props.errorText ?? cfg.errorText;
+      const errorTextResolved = useBoundString(errorTextRaw, ctx);
+      const workerError = typeof boundError === "string" ? boundError : errorTextRaw == null ? void 0 : errorTextResolved;
       const [touched, setTouched] = React7.useState(false);
       const [isFocused, setIsFocused] = React7.useState(false);
-      const message = errorMessageFor({ rule, value: local, workerError });
+      const validationCatalog = React7.useMemo(
+        () => ctx.catalog ? new Proxy({}, { get: (_t, k) => typeof k === "string" ? ctx.catalog.get(k) : void 0 }) : void 0,
+        [ctx.catalog]
+      );
+      const rawMessage = errorMessageFor({ rule, value: local, workerError, catalog: validationCatalog });
+      const resolvedMessage = useBoundString(rawMessage ?? "", ctx);
+      const message = rawMessage === null || !resolvedMessage.trim() ? null : resolvedMessage;
       const revealed = message !== null && shouldRevealError({
         rule,
         hasWorkerError: Boolean(workerError && workerError.trim()),
@@ -35907,9 +35948,9 @@ var init_renderNode = __esm({
       return /* @__PURE__ */ jsxs5("div", { style: { display: "flex", flexDirection: "column", gap: 4, width: "100%" }, children: [
         /* @__PURE__ */ jsxs5("div", { style: box, children: [
           props.leadingIcon && accIcon(props.leadingIcon),
-          props.prefix && /* @__PURE__ */ jsx8("span", { style: { color: muted, flex: "none" }, children: String(props.prefix) }),
-          multilineBox ? /* @__PURE__ */ jsx8("textarea", { "data-component-id": componentId, id: htmlId, "data-component-type": componentType, ...a11yFwd, ref: inputRef, value: local, onChange: onInput, onFocus: onFieldFocus, onBlur: onFieldBlur, placeholder: placeholder2, rows: 2, "aria-label": ariaLabelProp ?? placeholder2, "aria-invalid": errored || void 0, "aria-describedby": errorId, inputMode, autoCapitalize, maxLength, autoCorrect: suggestOff ? "off" : suggestOn ? "on" : void 0, spellCheck: suggestOff ? false : suggestOn ? true : void 0, autoComplete: suggestOff ? "off" : void 0, style: inputBase }) : /* @__PURE__ */ jsx8("input", { "data-component-id": componentId, id: htmlId, "data-component-type": componentType, ...a11yFwd, ref: inputRef, type: secure ? "password" : "text", value: local, onChange: onInput, onKeyDown, onFocus: onFieldFocus, onBlur: onFieldBlur, placeholder: placeholder2, "aria-label": ariaLabelProp ?? placeholder2, "aria-invalid": errored || void 0, "aria-describedby": errorId, inputMode, autoCapitalize, maxLength, autoCorrect: suggestOff ? "off" : suggestOn ? "on" : void 0, spellCheck: suggestOff ? false : suggestOn ? true : void 0, autoComplete: suggestOff ? "off" : void 0, enterKeyHint, style: inputBase }),
-          props.suffix && /* @__PURE__ */ jsx8("span", { style: { color: muted, flex: "none" }, children: String(props.suffix) }),
+          prefixText && /* @__PURE__ */ jsx8("span", { style: { color: muted, flex: "none" }, children: prefixText }),
+          multilineBox ? /* @__PURE__ */ jsx8("textarea", { "data-component-id": componentId, id: htmlId, "data-component-type": componentType, ...a11yFwd, ref: inputRef, value: local, onChange: onInput, onFocus: onFieldFocus, onBlur: onFieldBlur, placeholder: placeholder2, rows: 2, "aria-label": ariaLabelProp ?? placeholder2, "aria-invalid": errored || void 0, "aria-describedby": [errorId, describedByProp].filter(Boolean).join(" ") || void 0, inputMode, autoCapitalize, maxLength, autoCorrect: suggestOff ? "off" : suggestOn ? "on" : void 0, spellCheck: suggestOff ? false : suggestOn ? true : void 0, autoComplete: suggestOff ? "off" : void 0, style: inputBase }) : /* @__PURE__ */ jsx8("input", { "data-component-id": componentId, id: htmlId, "data-component-type": componentType, ...a11yFwd, ref: inputRef, type: secure ? "password" : "text", value: local, onChange: onInput, onKeyDown, onFocus: onFieldFocus, onBlur: onFieldBlur, placeholder: placeholder2, "aria-label": ariaLabelProp ?? placeholder2, "aria-invalid": errored || void 0, "aria-describedby": [errorId, describedByProp].filter(Boolean).join(" ") || void 0, inputMode, autoCapitalize, maxLength, autoCorrect: suggestOff ? "off" : suggestOn ? "on" : void 0, spellCheck: suggestOff ? false : suggestOn ? true : void 0, autoComplete: suggestOff ? "off" : void 0, enterKeyHint, style: inputBase }),
+          suffixText && /* @__PURE__ */ jsx8("span", { style: { color: muted, flex: "none" }, children: suffixText }),
           props.clearButton && local && /* @__PURE__ */ jsx8("span", { onClick: () => {
             setLocal("");
             emit("");
@@ -36094,6 +36135,7 @@ var init_renderNode = __esm({
             bag.markSubmitAttempted();
             return;
           }
+          bag.beforeSubmit();
           const merged = { ...action?.args ?? {}, ...bag.values };
           ctx.onAction?.({ ...action, args: merged });
         }
@@ -38439,6 +38481,7 @@ var init_renderNode = __esm({
       return /* @__PURE__ */ jsxs5("div", { ...{ [A11Y_PART]: "root" }, style: { width: "100%", ...wrap }, children: [
         /* @__PURE__ */ jsxs5("div", { style: { position: "relative", height: Math.min(props.expandedHeight ?? 120, 160), borderRadius: ctx.radius("md", 10), overflow: "hidden", background: imageUrl ? void 0 : `linear-gradient(135deg, ${C("accentPrimary", "#116DFF")}, ${C("accentSecondary", "#0E5FE3")})` }, children: [
           imageUrl && /* @__PURE__ */ jsx8("img", { src: imageUrl, alt: "", style: { width: "100%", height: "100%", objectFit: "cover" } }),
+          imageUrl && /* @__PURE__ */ jsx8("div", { "data-testid": "collapsing-header-scrim", "aria-hidden": "true", style: { position: "absolute", left: 0, right: 0, bottom: 0, height: "60%", background: "linear-gradient(to bottom, rgba(0,0,0,0), rgba(0,0,0,0.45))", pointerEvents: "none" } }),
           /* @__PURE__ */ jsxs5("div", { style: { position: "absolute", left: 14, bottom: 12, color: "#fff", textShadow: "0 1px 4px rgba(0,0,0,.5)" }, children: [
             /* @__PURE__ */ jsx8("div", { ...{ [A11Y_PART]: "node" }, role: "heading", "aria-level": 2, style: { fontFamily: ctx.font("title1").family || ctx.idiom && ctx.idiom !== "base" ? fontStack(ctx.font("title1").family, ctx.idiom) : '"Wix Madefor Display", system-ui', fontWeight: 700, fontSize: pxToRem(20) }, children: txt(props.title, ctx) }),
             props.subtitle && /* @__PURE__ */ jsx8("div", { style: { fontSize: pxToRem(13), opacity: 0.9 }, children: txt(props.subtitle, ctx) })
@@ -60243,21 +60286,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-DfY-tQ6i.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1132878, sha256: "3d63b2fab780ecf40caeff8f5576743a1dade0dd92e7cbc4fa9ee26a60985b7e" },
+      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1132886, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
+      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1137496, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1626080, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1717004, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1807988, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1898968, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 1989840, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 2080820, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2189456, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2298540, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2407588, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2515288, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2603396, length: 4947, sha256: "4c476f213d92ec00b1f5e5fe4f88d458ccdd9cf6c6e7684f49f115f70930f9bb" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2608343, 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.1175.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": "999c69dbc38f54c8d50554c6b57cd8fea4e4c0dcafad92b33458e139"
 }

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

@@ -21353,50 +21353,72 @@ const SCREENS = runtimeSetting({
                       }
                     },
                     {
-                      "id": "himi_create_post.title_field",
+                      "id": "himi_create_post.form",
                       "body": {
                         "package": "himalaya",
-                        "type": "TextField",
-                        "props": {
-                          "placeholder": "Title",
-                          "value": "",
-                          "submitLabel": "next",
-                          "onSubmit": {
-                            "actionId": "tier5.spacesCreatePost.focusBody"
-                          },
-                          "onChange": {
-                            "actionId": "tier5.spacesCreatePost.setTitle"
-                          }
-                        }
-                      }
-                    },
-                    {
-                      "id": "himi_create_post.body_field",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "TextField",
+                        "type": "Form",
                         "props": {
-                          "placeholder": "Write something…",
-                          "value": "",
-                          "multilineMaxLines": 6,
-                          "focusPath": "$service:spacesCreatePost.bodyFocus",
-                          "onChange": {
-                            "actionId": "tier5.spacesCreatePost.setBody"
-                          }
-                        }
-                      }
-                    },
-                    {
-                      "id": "himi_create_post.submit",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Button",
-                        "props": {
-                          "title": "Post",
-                          "style": "primary",
-                          "fullWidth": true,
-                          "action": {
-                            "actionId": "tier5.spacesCreatePost.submit"
+                          "id": "himiCreatePostForm",
+                          "fields": [
+                            {
+                              "id": "himi_create_post.title_field",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "FormField",
+                                "props": {
+                                  "id": "title",
+                                  "label": "Title",
+                                  "kind": "text",
+                                  "text": {
+                                    "placeholder": "Add a title",
+                                    "value": "",
+                                    "submitLabel": "next",
+                                    "onSubmit": {
+                                      "actionId": "tier5.spacesCreatePost.focusBody"
+                                    },
+                                    "onChange": {
+                                      "actionId": "tier5.spacesCreatePost.setTitle"
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "id": "himi_create_post.body_field",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "FormField",
+                                "props": {
+                                  "id": "body",
+                                  "label": "Your post",
+                                  "kind": "text",
+                                  "text": {
+                                    "placeholder": "Write something…",
+                                    "value": "",
+                                    "multilineMaxLines": 6,
+                                    "focusPath": "$service:spacesCreatePost.bodyFocus",
+                                    "onChange": {
+                                      "actionId": "tier5.spacesCreatePost.setBody"
+                                    }
+                                  }
+                                }
+                              }
+                            }
+                          ],
+                          "submitButton": {
+                            "id": "himi_create_post.submit",
+                            "body": {
+                              "package": "himalaya",
+                              "type": "Button",
+                              "props": {
+                                "title": "Post",
+                                "style": "primary",
+                                "fullWidth": true,
+                                "action": {
+                                  "actionId": "tier5.spacesCreatePost.submit"
+                                }
+                              }
+                            }
                           }
                         }
                       }