@wix/himalaya-cli 0.1145.0 → 0.1146.0

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

@@ -2,8 +2,12 @@ export declare const BLOG_COMMENTS_APP_ID = "14bcded7-0066-7c35-14d7-466cb3f0910
 export type WixBlogCommentRow = {
     id: string;
     authorName: string;
+    /** The comment's plain text (every text run, space-joined). */
     text: string;
     createdDate: string;
+    /** [rico] #3372 — the comment's Ricos document (`content.richContent`) as the API returned it, for a
+     *  RichContent row; undefined when the comment has none. */
+    richContent?: unknown;
 };
 type BlogCommentLike = {
     id?: string;

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

@@ -3,6 +3,16 @@ import type { WixPost } from "./index.js";
 export interface WixPostResponse {
     post?: WixPost;
 }
+/** A forum post's Ricos body (`content`). Opaque here: render it with RichContent (`@himalaya/wix-rich-content`
+ *  prepares it); `contentText` stays the plain-text copy. */
+export interface WixForumRichContent {
+    nodes?: unknown[];
+    metadata?: unknown;
+    documentStyle?: unknown;
+}
+/** [rico] #3372 — the post's Ricos `content` document (an object, or its JSON string), or null when it has none
+ *  or it is not a document. */
+export declare function forumPostContent(post: WixPost | null | undefined): WixForumRichContent | null;
 /** Delete a post — DELETE /forum/v1/posts/{postId}. Irreversible. */
 export declare function deletePost(id: string): Promise<WixPostResponse>;
 /** Pin a post to the top of its category — PUT /forum/v1/posts/{postId}/pin → { post }. */

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

@@ -33,6 +33,7 @@ var commentText = (comment) => {
   const text = readRichText(richContent);
   return text || "Comment";
 };
+var commentRichContent = (comment) => comment.content?.richContent;
 var commentAuthor = (comment) => {
   const author = comment.author;
   return author?.name ?? author?.nickname ?? "Member";
@@ -43,7 +44,8 @@ function blogCommentRow(comment) {
     id: c.id ?? "comment",
     authorName: commentAuthor(c),
     text: commentText(c),
-    createdDate: c.createdDate ?? (/* @__PURE__ */ new Date()).toISOString()
+    createdDate: c.createdDate ?? (/* @__PURE__ */ new Date()).toISOString(),
+    richContent: commentRichContent(c)
   };
 }
 async function createBlogComment(postId, text) {
@@ -82,7 +84,8 @@ async function listBlogComments(postId) {
     id: comment.id ?? "comment",
     authorName: commentAuthor(comment),
     text: commentText(comment),
-    createdDate: comment.createdDate ?? ""
+    createdDate: comment.createdDate ?? "",
+    richContent: commentRichContent(comment)
   }));
   const instantOf = (row) => {
     if (!row.createdDate) return Number.POSITIVE_INFINITY;

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

@@ -1,4 +1,16 @@
 // ../../stdlib/wix-sdk/forum/src/extensions.ts
+function forumPostContent(post) {
+  let c = post?.content;
+  if (typeof c === "string") {
+    try {
+      c = JSON.parse(c);
+    } catch {
+      return null;
+    }
+  }
+  const doc = c;
+  return doc && typeof doc === "object" && Array.isArray(doc.nodes) ? doc : null;
+}
 function deletePost(id) {
   if (!id) throw new Error("deletePost: id is required");
   return wixCall("DELETE", `/forum/v1/posts/${encodeURIComponent(id)}`);
@@ -126,6 +138,7 @@ export {
   deletePost,
   disablePostCommenting,
   enablePostCommenting,
+  forumPostContent,
   getCategory,
   getPost,
   listForumBffCategories,

package/dist/cli.mjs

@@ -23567,7 +23567,6 @@ 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]+$/;
@@ -24227,7 +24226,6 @@ 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,

package/guides/sdk-reference.json

@@ -10436,7 +10436,7 @@
         "name": "WixBlogCommentRow",
         "kind": "type",
         "jsdoc": "",
-        "decl": "export type WixBlogCommentRow = {\n  id: string;\n  authorName: string;\n  text: string;\n  createdDate: string;\n};"
+        "decl": "export type WixBlogCommentRow = {\n  id: string;\n  authorName: string;\n  /** The comment's plain text (every text run, space-joined). */\n  text: string;\n  createdDate: string;\n  /** [rico] #3372 — the comment's Ricos document (`content.richContent`) as the API returned it, for a\n   *  RichContent row; undefined when the comment has none. */\n  richContent?: unknown;\n};"
       },
       {
         "name": "blogCommentRow",
@@ -17506,6 +17506,18 @@
         "jsdoc": "/** Response of pin/unpin/delete — the mutated post (may be absent for delete). */",
         "decl": "export interface WixPostResponse {\n  post?: WixPost;\n}"
       },
+      {
+        "name": "WixForumRichContent",
+        "kind": "interface",
+        "jsdoc": "/** A forum post's Ricos body (`content`). Opaque here: render it with RichContent (`@himalaya/wix-rich-content`\n *  prepares it); `contentText` stays the plain-text copy. */",
+        "decl": "export interface WixForumRichContent { nodes?: unknown[]; metadata?: unknown; documentStyle?: unknown }"
+      },
+      {
+        "name": "forumPostContent",
+        "kind": "function",
+        "jsdoc": "/** [rico] #3372 — the post's Ricos `content` document (an object, or its JSON string), or null when it has none\n *  or it is not a document. */",
+        "decl": "export function forumPostContent(post: WixPost | null | undefined): WixForumRichContent | null;"
+      },
       {
         "name": "deletePost",
         "kind": "function",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1145.0",
+  "version": "0.1146.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": "7d92bfb40f295121fe145451b71e6d7d5f3bbba165b18f60bc10d4eb"
+  "falconPackageHash": "da1d9d3e46786000c48c49145c2ea2b1212f236db2110b68775d29ee"
 }

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

@@ -25845,7 +25845,33 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                               }
                             },
                             {
-                              "id": "",
+                              "id": "product_body",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "RichContent",
+                                "props": {
+                                  "documentJsonPath": "$service:himiStoreProduct.descriptionJson",
+                                  "onLink": {
+                                    "actionId": "tier5.himiStoreProduct.openLink"
+                                  },
+                                  "fallback": {
+                                    "id": "",
+                                    "body": {
+                                      "package": "himalaya",
+                                      "type": "Text",
+                                      "props": {
+                                        "text": "$service:himiStoreProduct.description",
+                                        "style": "body",
+                                        "color": "textSecondary",
+                                        "collapseWhenEmpty": true
+                                      }
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "id": "product_body_text",
                               "body": {
                                 "package": "himalaya",
                                 "type": "Text",
@@ -25855,6 +25881,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                   "color": "textSecondary",
                                   "collapseWhenEmpty": true
                                 }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$service:himiStoreProduct.hasDescriptionJson"
                               }
                             }
                           ]
@@ -26349,7 +26378,8 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
       "declaredCapabilities": [
         "wix_api",
         "share",
-        "local_database"
+        "local_database",
+        "open_url"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -28860,7 +28890,33 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                       }
                                     },
                                     {
-                                      "id": "",
+                                      "id": "comment_body_$item.id",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "RichContent",
+                                        "props": {
+                                          "documentJsonPath": "$item.bodyJson",
+                                          "onLink": {
+                                            "actionId": "tier5.himiBlogPost.openLink"
+                                          },
+                                          "fallback": {
+                                            "id": "",
+                                            "body": {
+                                              "package": "himalaya",
+                                              "type": "Text",
+                                              "props": {
+                                                "text": "$item.text",
+                                                "style": "body",
+                                                "color": "textSecondary",
+                                                "collapseWhenEmpty": true
+                                              }
+                                            }
+                                          }
+                                        }
+                                      }
+                                    },
+                                    {
+                                      "id": "comment_body_text_$item.id",
                                       "body": {
                                         "package": "himalaya",
                                         "type": "Text",
@@ -28870,6 +28926,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                           "color": "textSecondary",
                                           "collapseWhenEmpty": true
                                         }
+                                      },
+                                      "modifiers": {
+                                        "hiddenPath": "$item.hasBodyJson"
                                       }
                                     }
                                   ]

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

@@ -14,15 +14,21 @@ export interface RichBody {
   bodyText: string;
 }
 
+/** [rico] #3372 — the media width for a document drawn in a LIST row (a feed post, a comment, a CMS item): the
+ *  list-image size (WIX_LIST_IMAGE), so a scrolling list never downloads every image at detail size. */
+export const ROW_IMAGE_WIDTH = 1000;
+
 /** Prepares `richContent` (a Ricos document, as a Wix API returns it, or its JSON string). No document, or one
  *  that is not a document, gives `{ bodyJson: "", bodyText: fallback }`. A document past the viewer's limits
  *  gives bodyJson "" and its plain text — except one rejected as too deep, which is not walked again (the
- *  plain-text walk has no depth limit), so `fallback` stands in for it. */
-export function richBody(richContent: unknown, fallback = ""): RichBody {
+ *  plain-text walk has no depth limit), so `fallback` stands in for it. `imageWidth` sizes its media (default
+ *  the 1400 px detail budget). */
+export function richBody(richContent: unknown, fallback = "", imageWidth = 1400): RichBody {
   const doc = parseRicosJson(richContent);
   if (!doc) return { bodyJson: "", bodyText: fallback };
-  // 1400 px — the detail-image budget, which is also the encoder's maximum.
-  const { json, rejected } = encodeRichContent(doc, { imageWidth: 1400 });
+  // 1400 px by default — the detail-image budget, which is also the encoder's maximum; list rows pass
+  // ROW_IMAGE_WIDTH.
+  const { json, rejected } = encodeRichContent(doc, { imageWidth });
   const text = rejected === "too_deep" ? "" : ricosToPlainText(doc);
   return { bodyJson: json, bodyText: text || fallback };
 }

package/templates/beauty-salon/tier5-src/himi-blog-post/index.ts

@@ -8,7 +8,7 @@ import { isSavedId, toggleSavedId } from "../_shared/himi-blog-saved";
 import { stashCopy, copyParam, copyTemplate } from "../_shared/himi-copy.js";
 import { formatDateMedium, formatMonthDay } from "../_shared/engine-intl.js";
 import { openRichLink } from "../_shared/rich-content-link.js";
-import { richBody } from "../_shared/rich-body.js";
+import { richBody, ROW_IMAGE_WIDTH } from "../_shared/rich-body.js";
 
 // Offline-first (data-offline): the post body is a public read-through — when the
 // live fetch fails (offline) fall back to the last-synced row the feed cached under
@@ -23,8 +23,14 @@ async function readCachedPost(id: string): Promise<DbEntity | null> {
 interface CommentRow {
   id: string;
   authorName: string;
+  /** The comment's plain text: the row RichContent's fallback. */
   text: string;
   meta: string;
+  /** [rico] #3372 — the comment's Ricos document as ONE string for the row's RichContent; "" when it has none
+   *  or the encoder rejected it. */
+  bodyJson: string;
+  /** bodyJson !== "" — gates the row's plain text, because RichContent draws nothing for "". */
+  hasBodyJson: boolean;
 }
 
 interface S {
@@ -168,11 +174,15 @@ function commentMeta(row: WixBlogCommentRow): string {
 }
 
 function toCommentRow(row: WixBlogCommentRow): CommentRow {
+  // The plain text is the document's own (runs joined as written, not space-separated) when it has one.
+  const { bodyJson, bodyText } = richBody(row.richContent, row.text || "Comment", ROW_IMAGE_WIDTH);
   return {
     id: row.id,
     authorName: row.authorName || "Member",
-    text: row.text || "Comment",
+    text: bodyText,
     meta: commentMeta(row),
+    bodyJson,
+    hasBodyJson: bodyJson !== "",
   };
 }
 

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

@@ -10,6 +10,8 @@ import { cleanTitle } from "../_shared/himi-text.js";
 import { stashCopy, copyParam, copyTemplate } from "../_shared/himi-copy.js";
 import { isBridgeUnavailable } from "../_shared/owner-load-error.js";
 import { isProductSaved, toggleSavedProduct } from "../_shared/himi-store-saved.js";
+import { openRichLink } from "../_shared/rich-content-link.js";
+import { richBody } from "../_shared/rich-body.js";
 
 // Offline-first (data-offline): the detail is a public READ-THROUGH — when the live
 // product fetch fails (offline) fall back to the last-synced row the catalog cached
@@ -120,11 +122,27 @@ function optionsHint(groups: StoreOption[], selection: StoreOptionSelection): st
   return copyTemplate("product.optionsChoose", "Choose {options}", { options: missing.join(", ") });
 }
 
+/** The description pair. V3's `description` is a Ricos OBJECT (the HTML `plainText` would throw on it): it
+ *  becomes the RichContent document, and `plainDescription` (or the document's own text) the plain copy. A V1
+ *  `description` is an HTML string: stripped text, no document. */
+function productBody(p: StoreProduct): { description: string; descriptionJson: string } {
+  const raw = (p as { description?: unknown }).description;
+  const html = plainText(p.plainDescription || (typeof raw === "string" ? raw : ""));
+  const { bodyJson, bodyText } = richBody(typeof raw === "string" ? null : raw, html);
+  return { description: html || bodyText, descriptionJson: bodyJson };
+}
+
 interface S {
   status: "loading" | "ready" | "error";
   name: string;
   price: string;
+  /** The plain-text description: RichContent's fallback, and what shows with no document. */
   description: string;
+  /** [rico] #3372 — a V3 product's Ricos `description` (read with `fields=DESCRIPTION`) as ONE document string
+   *  for RichContent; "" for a V1 HTML description, none, or a document the encoder rejected. */
+  descriptionJson: string;
+  /** descriptionJson !== "" — gates the plain text, because RichContent draws nothing for "". */
+  hasDescriptionJson: boolean;
   image: string;
   /** FULL media gallery (media.items[] with the main image first) — the detail
    *  screen renders a Carousel over it when 2+ images exist. */
@@ -253,6 +271,7 @@ function derive(s: S): S {
   const overflow = groups.length > OPTION_SLOTS;
   return {
     ...s,
+    hasDescriptionJson: s.descriptionJson !== "",
     ...slotsOf(groups, s.selection),
     hasOptions: groups.length > 0,
     noOptions: groups.length === 0,
@@ -296,12 +315,16 @@ const svc = defineService<S, {
   setCartCount: (s: S, arg?: unknown) => S;
   share: (s: S) => Promise<S>;
   toggleSave: (s: S) => S;
+  /** [rico] #3372 — RichContent's on_link: `{ url }` of the tapped link. */
+  openLink: (s: S, arg?: unknown) => Promise<S>;
 }>("himiStoreProduct", {
   state: derive({
     status: "loading",
     name: "",
     price: "",
     description: "",
+    descriptionJson: "",
+    hasDescriptionJson: false,
     image: "",
     gallery: [],
     hasGallery: false,
@@ -354,7 +377,7 @@ const svc = defineService<S, {
       if (!id) {
         lastProduct = undefined;
         lastLoadedId = undefined;
-        return derive({ ...s, status: "ready", quantity: 1, optionGroups: [], selection: {}, optionsUnknown: false, emptyText: copyParam("product.notFoundText", "Product not found.") });
+        return derive({ ...s, status: "ready", quantity: 1, optionGroups: [], selection: {}, optionsUnknown: false, descriptionJson: "", emptyText: copyParam("product.notFoundText", "Product not found.") });
       }
       // The cart count only feeds the top-bar badge: ask for it NOW, beside the product, instead
       // of after it — it used to add a whole cart round trip before the page could paint.
@@ -365,7 +388,8 @@ const svc = defineService<S, {
       void cartCount.then((n) => { cartKnown = n; }, () => {});
       // The live product read goes out FIRST too — the local-db read below must never delay it.
       // Settled into a value so a failure is handled where it is awaited, never unhandled.
-      const live = getStoreProduct(id).then(
+      // DESCRIPTION widens the default fieldset with the V3 Ricos description (a V1 catalog ignores it).
+      const live = getStoreProduct(id, ["DESCRIPTION"]).then(
         (r) => ({ ok: true as const, r }),
         () => ({ ok: false as const }),
       );
@@ -424,7 +448,7 @@ const svc = defineService<S, {
           optionsUnknown: false,
           name,
           price: productPrice(p),
-          description: plainText(p.plainDescription || p.description),
+          ...productBody(p),
           image,
           gallery: productGallery(p),
           initial: (name[0] || "#").toUpperCase(),
@@ -455,6 +479,7 @@ const svc = defineService<S, {
           name,
           price: String(synced.subtitle ?? ""),
           description: "",
+          descriptionJson: "",
           image,
           initial: String(synced.initial ?? "") || (name[0] || "#").toUpperCase(),
           cartHint: copyParam("product.cartHintOffline", "Reconnect to choose options and add this to your cart."),
@@ -464,7 +489,7 @@ const svc = defineService<S, {
       }
       lastProduct = undefined;
       lastLoadedId = undefined;
-      return derive({ ...s, status: "error", optionGroups: [], selection: {}, optionsUnknown: false, emptyText: copyParam("product.errorText", "Product could not load.") });
+      return derive({ ...s, status: "error", optionGroups: [], selection: {}, optionsUnknown: false, descriptionJson: "", emptyText: copyParam("product.errorText", "Product could not load.") });
     },
     // The stepper fires onChange with { value } on every tap; clamp 1–99 and
     // ignore unparsable/garbage args instead of silently zeroing the quantity.
@@ -519,6 +544,7 @@ const svc = defineService<S, {
         name,
         price: String(row.subtitle ?? ""),
         description: "",
+        descriptionJson: "",
         image: String(row.image ?? ""),
         gallery: [],
         initial: String(row.initial ?? "") || (name[0] || "#").toUpperCase(),
@@ -605,6 +631,11 @@ const svc = defineService<S, {
         return derive({ ...s, added: false, cartHint: copyParam("product.shareUnavailable", "Sharing is not available on this device.") });
       }
     },
+    // Only http(s), mailto and tel links reach open_url; a refused link, or one nothing opened, says so in the
+    // hint line (`added: false`, as for share, so it never renders inside the add-to-cart confirmation).
+    openLink: async (s, arg) => ((await openRichLink(arg))
+      ? s
+      : derive({ ...s, added: false, cartHint: copyParam("product.linkOpenFailed", "This link could not be opened.") })),
   },
 });
 

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

@@ -14,15 +14,21 @@ export interface RichBody {
   bodyText: string;
 }
 
+/** [rico] #3372 — the media width for a document drawn in a LIST row (a feed post, a comment, a CMS item): the
+ *  list-image size (WIX_LIST_IMAGE), so a scrolling list never downloads every image at detail size. */
+export const ROW_IMAGE_WIDTH = 1000;
+
 /** Prepares `richContent` (a Ricos document, as a Wix API returns it, or its JSON string). No document, or one
  *  that is not a document, gives `{ bodyJson: "", bodyText: fallback }`. A document past the viewer's limits
  *  gives bodyJson "" and its plain text — except one rejected as too deep, which is not walked again (the
- *  plain-text walk has no depth limit), so `fallback` stands in for it. */
-export function richBody(richContent: unknown, fallback = ""): RichBody {
+ *  plain-text walk has no depth limit), so `fallback` stands in for it. `imageWidth` sizes its media (default
+ *  the 1400 px detail budget). */
+export function richBody(richContent: unknown, fallback = "", imageWidth = 1400): RichBody {
   const doc = parseRicosJson(richContent);
   if (!doc) return { bodyJson: "", bodyText: fallback };
-  // 1400 px — the detail-image budget, which is also the encoder's maximum.
-  const { json, rejected } = encodeRichContent(doc, { imageWidth: 1400 });
+  // 1400 px by default — the detail-image budget, which is also the encoder's maximum; list rows pass
+  // ROW_IMAGE_WIDTH.
+  const { json, rejected } = encodeRichContent(doc, { imageWidth });
   const text = rejected === "too_deep" ? "" : ricosToPlainText(doc);
   return { bodyJson: json, bodyText: text || fallback };
 }