@wix/himalaya-cli 0.1079.0 → 0.1080.0

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

@@ -0,0 +1,344 @@
+// ../../stdlib/wix-sdk/media/src/index.ts
+var WIX_LIST_IMAGE = { width: 1e3, height: 1e3, quality: 85 };
+var WIX_DETAIL_IMAGE = { width: 1400, height: 1400, quality: 85 };
+var WIX_MEDIA = /^https?:\/\/static\.wixstatic\.com\/media\/[^/]/;
+var WIX_IMAGE = /^wix:image:\/\/v1\/([^/]+)/i;
+var WIX_TRANSFORM = /^(https?:\/\/static\.wixstatic\.com\/media\/[^/]+\/v1\/)([^/]+)\/([^/?#]+)(?:\/([^/?#]+))?([?#].*)?$/i;
+var SIZING_PARAM = /^(w|h|q)_\d+$/i;
+var WEB_URL = /^https?:\/\//i;
+var RESIZABLE_MODES = /* @__PURE__ */ new Set(["fit", "fill"]);
+var OWNED_PARAM = /^(w|h|q)_/i;
+var DROPPED_PARAM = /^enc_/i;
+function wixMediaId(reference) {
+  return WIX_IMAGE.exec(reference)?.[1] ?? (reference.includes("/") || reference.includes(":") ? "" : reference);
+}
+function resolveWixMediaReference(reference) {
+  const mediaId = wixMediaId(reference);
+  return mediaId ? `https://static.wixstatic.com/media/${mediaId}` : reference;
+}
+function requestedParams(size) {
+  return [`w_${size.width}`, `h_${size.height}`, `q_${size.quality ?? 85}`];
+}
+function fittedParams(size, source, mode) {
+  const quality = `q_${size.quality ?? 85}`;
+  const { width: sourceWidth, height: sourceHeight } = source;
+  if (sourceWidth && sourceHeight) {
+    if (mode.toLowerCase() === "fill") {
+      const scale = Math.min(size.width / sourceWidth, size.height / sourceHeight, 1);
+      return [
+        `w_${Math.max(1, Math.round(sourceWidth * scale))}`,
+        `h_${Math.max(1, Math.round(sourceHeight * scale))}`,
+        quality
+      ];
+    }
+    return [
+      `w_${Math.min(sourceWidth, size.width)}`,
+      `h_${Math.min(sourceHeight, size.height)}`,
+      quality
+    ];
+  }
+  if (sourceWidth) return [`w_${Math.min(sourceWidth, size.width)}`, quality];
+  if (sourceHeight) return [`h_${Math.min(sourceHeight, size.height)}`, quality];
+  return requestedParams(size);
+}
+function resizeWixTransform(url, size) {
+  const transform = WIX_TRANSFORM.exec(url);
+  if (!transform || !RESIZABLE_MODES.has(transform[2].toLowerCase())) return url;
+  const [, base, mode, rawParams, filename, suffix] = transform;
+  const source = rawParams.split(",").filter(Boolean);
+  if (!filename && !source.some((param) => SIZING_PARAM.test(param))) return url;
+  const dimensions = dimensionsOf(source);
+  if (mode.toLowerCase() === "fill" && !dimensions.width && !dimensions.height) return url;
+  const stated = [dimensions.width, dimensions.height].filter((d) => d !== void 0);
+  if (stated.length > 0 && (dimensions.width ?? 0) <= size.width && (dimensions.height ?? 0) <= size.height) return url;
+  const carried = source.filter((p) => !OWNED_PARAM.test(p) && !DROPPED_PARAM.test(p));
+  const params = [...fittedParams(size, dimensions, mode), ...carried];
+  return `${base}${mode}/${params.join(",")}/image.jpg${suffix ?? ""}`;
+}
+function wixTransformDimension(params, name) {
+  const match = params.find((param) => new RegExp(`^${name}_\\d+$`, "i").test(param));
+  return match ? Number(match.slice(2)) : void 0;
+}
+function dimensionsOf(params) {
+  return {
+    width: wixTransformDimension(params, "w"),
+    height: wixTransformDimension(params, "h")
+  };
+}
+function wixMediaUrl(value, size = WIX_LIST_IMAGE) {
+  const reference = typeof value === "string" ? value.trim() : "";
+  if (!reference) return "";
+  const resolvedUrl = resolveWixMediaReference(reference);
+  if (!WEB_URL.test(resolvedUrl)) return "";
+  if (size === null) return resolvedUrl;
+  if (!WIX_MEDIA.test(resolvedUrl)) return resolvedUrl;
+  const base = resolvedUrl.split(/[?#]/)[0];
+  if (base.includes("/v1/")) return resizeWixTransform(resolvedUrl, size);
+  const suffix = resolvedUrl.slice(base.length);
+  return `${base}/v1/fit/${requestedParams(size).join(",")}/image.jpg${suffix}`;
+}
+
+// ../../stdlib/wix-sdk/rich-content/src/display.ts
+var HTTPS = /^https:\/\/[^\s/?#]\S*$/i;
+var LINK = /^(https?:\/\/[^\s/?#]\S*|mailto:\S+|tel:\S+)$/i;
+var HTTP_HOST = /^https?:\/\/([^\s/?#]+)/i;
+var VIDEO_CARD_HOST = /^(?:(?:www\.|m\.)?youtube\.com|youtu\.be|(?:www\.|player\.)?vimeo\.com)$/;
+function trimAscii(s) {
+  return s.replace(/^[\t\n\v\f\r ]+|[\t\n\v\f\r ]+$/g, "");
+}
+function normalizeMediaRef(s) {
+  return s.trim().replace(/^http:\/\/(static|video)\.wixstatic\.com\//i, (_all, sub) => `https://${sub.toLowerCase()}.wixstatic.com/`);
+}
+var hostOf = (url) => HTTP_HOST.exec(url)?.[1]?.toLowerCase().replace(/:\d+$/, "");
+function cleanLink(url) {
+  if (typeof url !== "string") return void 0;
+  const t = trimAscii(url);
+  return LINK.test(t) ? t : void 0;
+}
+function ricosImageUrl(holder, width) {
+  const src = holder?.image?.src;
+  const fromUrl = typeof src?.url === "string" ? normalizeMediaRef(src.url) : "";
+  const ref = fromUrl !== "" ? fromUrl : typeof src?.id === "string" ? normalizeMediaRef(src.id) : src?.id;
+  const url = wixMediaUrl(ref, { width, height: width, quality: 85 });
+  return HTTPS.test(url) ? url : "";
+}
+function ricosVideoUrl(src) {
+  if (!src || typeof src !== "object") return "";
+  const { url, id } = src;
+  if (typeof url === "string" && url.trim() !== "") {
+    const link = cleanLink(url);
+    const linkHost = link === void 0 ? void 0 : hostOf(link);
+    if (link !== void 0 && linkHost !== void 0 && VIDEO_CARD_HOST.test(linkHost)) return link;
+    const media = normalizeMediaRef(url);
+    const mediaHost = hostOf(media);
+    return HTTPS.test(media) && !(mediaHost !== void 0 && VIDEO_CARD_HOST.test(mediaHost)) ? media : "";
+  }
+  const ref = typeof id === "string" ? id.trim().replace(/^video\//, "") : "";
+  if (/^\w[\w~.-]*$/.test(ref)) return `https://video.wixstatic.com/video/${ref}/file`;
+  if (/^\w[\w~.-]*\/[\w~./-]+$/.test(ref)) return `https://video.wixstatic.com/video/${ref}`;
+  return "";
+}
+
+// ../../stdlib/wix-sdk/rich-content/src/index.ts
+var RICH_CONTENT_LIMITS = { maxBytes: 262144, maxNodes: 5e3, maxDepth: 16 };
+var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+function parseRicosJson(value) {
+  let v = value;
+  if (typeof v === "string") {
+    if (v.trim() === "") return null;
+    try {
+      v = JSON.parse(v);
+    } catch {
+      return null;
+    }
+  }
+  return isObj(v) && Array.isArray(v.nodes) ? v : null;
+}
+function ricosToPlainText(doc) {
+  const kids = (v) => Array.isArray(v) ? v.filter(isObj) : [];
+  const inline = (node) => typeof node.textData?.text === "string" ? node.textData.text : kids(node.nodes).map(inline).join("");
+  const blocks = (nodes) => nodes.flatMap((node) => node.type === "PARAGRAPH" || node.type === "HEADING" || node.type === "TEXT" ? [inline(node)] : blocks(kids(node.nodes)));
+  return blocks(kids(doc?.nodes)).join("\n\n");
+}
+function plainTextToRicos(text) {
+  return { nodes: text.split("\n\n").map((t) => ({ type: "PARAGRAPH", nodes: [{ type: "TEXT", textData: { text: t, decorations: [] } }] })) };
+}
+var onlyKeys = (o, allowed) => Object.keys(o).every((k) => allowed.includes(k));
+var emptyObject = (v) => v === void 0 || v === null || typeof v === "object" && Object.keys(v).length === 0;
+function defaultParagraphData(pd) {
+  if (pd === void 0) return true;
+  if (!pd || typeof pd !== "object" || !onlyKeys(pd, ["textStyle", "indentation"])) return false;
+  const { textStyle, indentation } = pd;
+  if (indentation !== void 0 && indentation !== 0) return false;
+  if (textStyle === void 0) return true;
+  if (!textStyle || typeof textStyle !== "object" || !onlyKeys(textStyle, ["textAlignment"])) return false;
+  const align = textStyle.textAlignment;
+  return align === void 0 || align === "AUTO";
+}
+function plainRun(raw) {
+  if (!raw || typeof raw !== "object") return false;
+  const t = raw;
+  return t.type === "TEXT" && onlyKeys(t, ["type", "id", "textData", "nodes"]) && (t.nodes === void 0 || Array.isArray(t.nodes) && t.nodes.length === 0) && !(Array.isArray(t.textData?.decorations) && t.textData.decorations.length > 0);
+}
+function isPlainRicos(doc) {
+  if (doc === null || doc === void 0) return true;
+  if (typeof doc !== "object" || Array.isArray(doc)) return false;
+  if (!emptyObject(doc.documentStyle)) return false;
+  if (doc.nodes !== void 0 && !Array.isArray(doc.nodes)) return false;
+  const nodes = Array.isArray(doc.nodes) ? doc.nodes : [];
+  return nodes.every((raw) => {
+    if (!raw || typeof raw !== "object") return false;
+    const n = raw;
+    if (n.nodes !== void 0 && !Array.isArray(n.nodes)) return false;
+    return n.type === "PARAGRAPH" && onlyKeys(n, ["type", "id", "nodes", "paragraphData"]) && defaultParagraphData(n.paragraphData) && (Array.isArray(n.nodes) ? n.nodes : []).every(plainRun);
+  });
+}
+var HTML_TAG = /<[a-z!/?]/i;
+function htmlIsTrivial(html) {
+  const s = (html ?? "").trim();
+  return !s || !HTML_TAG.test(s) || /^<p>[^<>]*<\/p>$/.test(s);
+}
+function encodeRichContent(doc, opts = {}) {
+  if (doc === null || doc === void 0) return { json: "" };
+  if (!isObj(doc) || !Array.isArray(doc.nodes)) return { json: "", rejected: "not_a_document" };
+  const w = opts.imageWidth;
+  const imageWidth = typeof w === "number" && Number.isInteger(w) && w > 0 ? Math.min(w, WIX_DETAIL_IMAGE.width) : WIX_DETAIL_IMAGE.width;
+  const ctx = {
+    imageWidth,
+    // Gallery tiles and video posters are half-width at most, so the list budget caps them.
+    tileWidth: Math.min(imageWidth, WIX_LIST_IMAGE.width),
+    // Serialized nesting allowed: each node level is a node and its `nodes` array, plus generous room for type
+    // data. Past it the document is rejected rather than overflowing the worker's stack.
+    maxJsonDepth: RICH_CONTENT_LIMITS.maxDepth * 2 + 64,
+    ids: /* @__PURE__ */ new Set()
+  };
+  let nodes;
+  let json;
+  try {
+    nodes = cleanNodes(doc.nodes, "", 1, ctx, void 0);
+    if (nodes.length === 0) return { json: "" };
+    const out = { nodes };
+    if (doc.documentStyle !== void 0) out.documentStyle = doc.documentStyle;
+    if (doc.metadata !== void 0) out.metadata = doc.metadata;
+    json = canonicalJson(out, 0, ctx.maxJsonDepth);
+  } catch (e) {
+    if (e === TOO_DEEP) return { json: "", rejected: "too_deep" };
+    throw e;
+  }
+  if (utf8Length(json) > RICH_CONTENT_LIMITS.maxBytes) return { json: "", rejected: "too_large" };
+  if (countNodes(nodes) > RICH_CONTENT_LIMITS.maxNodes) return { json: "", rejected: "too_many_nodes" };
+  return { json };
+}
+var TOO_DEEP = { reason: "too_deep" };
+var PATH_SHAPED = /^[0-9.]+$/;
+var isWrapper = (t) => t === "COLLAPSIBLE_LIST" || t === "COLLAPSIBLE_ITEM" || t === "COLLAPSIBLE_ITEM_TITLE" || t === "COLLAPSIBLE_ITEM_BODY";
+var holdsBlocks = (t) => t === void 0 || t === "BULLETED_LIST" || t === "ORDERED_LIST" || t === "LIST_ITEM" || t === "BLOCKQUOTE" || isWrapper(t);
+var LINK_FIELDS = {
+  EMBED: [["embedData", "oembed", "url"], ["embedData", "src"]],
+  HTML: [["htmlData", "url"]],
+  APP_EMBED: [["appEmbedData", "url"]],
+  LINK_PREVIEW: [["linkPreviewData", "link", "url"]],
+  FILE: [["fileData", "src", "url"]],
+  AUDIO: [["audioData", "audio", "src", "url"]],
+  GIF: [["gifData", "original", "gif"]],
+  IMAGE: [["imageData", "link", "url"]]
+};
+function rewriteAt(v, path, fix) {
+  if (!isObj(v) || !(path[0] in v)) return v;
+  const [k, ...rest] = path;
+  if (rest.length > 0) return { ...v, [k]: rewriteAt(v[k], rest, fix) };
+  const next = fix(v[k]);
+  if (next === v[k]) return v;
+  const { [k]: _old, ...kept } = v;
+  return next === void 0 ? kept : { ...kept, [k]: next };
+}
+function getAt(v, path) {
+  let cur = v;
+  for (const k of path) cur = isObj(cur) ? cur[k] : void 0;
+  return cur;
+}
+var drop = () => void 0;
+var LINK_DECORATION_URL = ["linkData", "link", "url"];
+var BUTTON_URL = ["link", "url"];
+function cleanNodes(nodes, base, depth, ctx, parentType) {
+  const out = [];
+  for (const raw of nodes) {
+    if (!isObj(raw)) continue;
+    if (depth > RICH_CONTENT_LIMITS.maxDepth) throw TOO_DEEP;
+    const path = base === "" ? String(out.length) : `${base}.${out.length}`;
+    const node = cleanNode({ ...raw }, path, depth, ctx, parentType);
+    if (node) out.push(node);
+  }
+  return out;
+}
+function cleanNode(node, path, depth, ctx, parentType) {
+  if (node.type === "TEXT") {
+    const decorations = node.textData?.decorations;
+    if (Array.isArray(decorations)) {
+      const kept = decorations.flatMap((d) => {
+        if (!(isObj(d) && d.type === "LINK")) return [d];
+        const next = rewriteAt(d, LINK_DECORATION_URL, cleanLink);
+        return getAt(next, LINK_DECORATION_URL) === void 0 ? [] : [next];
+      });
+      node.textData = { ...node.textData, decorations: kept };
+    }
+  } else if (node.type === "IMAGE") {
+    const data = isObj(node.imageData) ? node.imageData : {};
+    const url = ricosImageUrl(data, ctx.imageWidth);
+    if (!url) return null;
+    node.imageData = { ...data, image: { ...isObj(data.image) ? data.image : {}, src: { url } } };
+  } else if (node.type === "GALLERY") {
+    const data = isObj(node.galleryData) ? node.galleryData : {};
+    const items = (Array.isArray(data.items) ? data.items : []).flatMap((item) => {
+      if (!isObj(item) || !isObj(item.image)) return [];
+      const media = isObj(item.image.media) ? item.image.media : {};
+      const url = ricosImageUrl({ image: media }, ctx.tileWidth);
+      return url ? [{ ...item, image: { ...item.image, media: { ...media, src: { url } } } }] : [];
+    });
+    if (items.length === 0) return null;
+    node.galleryData = { ...data, items };
+  } else if (node.type === "VIDEO") {
+    const data = isObj(node.videoData) ? { ...node.videoData } : {};
+    const video = isObj(data.video) ? data.video : {};
+    const url = ricosVideoUrl(video.src);
+    if (!url) return null;
+    data.video = { ...video, src: { url } };
+    const poster = ricosImageUrl({ image: data.thumbnail }, ctx.tileWidth);
+    if (poster) data.thumbnail = { ...data.thumbnail, src: { url: poster } };
+    else delete data.thumbnail;
+    node.videoData = data;
+  } else if (node.type === "BUTTON" || node.type === "LINK_BUTTON") {
+    node.buttonData = rewriteAt(node.buttonData, BUTTON_URL, cleanLink);
+    if (getAt(node.buttonData, BUTTON_URL) === void 0) return null;
+  } else if (node.type === "HTML") {
+    node.htmlData = rewriteAt(node.htmlData, ["html"], drop);
+  } else if (node.type === "EMBED") {
+    node.embedData = rewriteAt(node.embedData, ["oembed", "html"], drop);
+  }
+  for (const [field, ...rest] of (typeof node.type === "string" ? LINK_FIELDS[node.type] : void 0) ?? []) {
+    if (field in node) node[field] = rewriteAt(node[field], rest, cleanLink);
+  }
+  const inBlocks = holdsBlocks(parentType);
+  if (node.type !== "TEXT" || inBlocks) {
+    const own = typeof node.id === "string" ? node.id : "";
+    const usable = own !== "" && !PATH_SHAPED.test(own);
+    if (inBlocks && !isWrapper(node.type)) {
+      if (usable && !ctx.ids.has(own)) ctx.ids.add(own);
+      else node.id = path;
+    } else if (!usable) node.id = path;
+  }
+  if (Array.isArray(node.nodes)) node.nodes = cleanNodes(node.nodes, path, depth + 1, ctx, typeof node.type === "string" ? node.type : "");
+  return node;
+}
+function countNodes(nodes) {
+  return nodes.reduce((n, node) => isObj(node) ? n + 1 + (Array.isArray(node.nodes) ? countNodes(node.nodes) : 0) : n, 0);
+}
+function canonicalJson(v, depth, max) {
+  if (depth > max) throw TOO_DEEP;
+  if (Array.isArray(v)) return `[${v.map((x) => x === void 0 ? "null" : canonicalJson(x, depth + 1, max)).join(",")}]`;
+  if (isObj(v)) return `{${Object.keys(v).sort().filter((k) => v[k] !== void 0).map((k) => `${JSON.stringify(k)}:${canonicalJson(v[k], depth + 1, max)}`).join(",")}}`;
+  return JSON.stringify(v) ?? "null";
+}
+function utf8Length(s) {
+  let bytes = 0;
+  for (let i = 0; i < s.length; i++) {
+    const c = s.charCodeAt(i);
+    if (c < 128) bytes += 1;
+    else if (c < 2048) bytes += 2;
+    else if (c >= 55296 && c <= 56319 && i + 1 < s.length && s.charCodeAt(i + 1) >= 56320 && s.charCodeAt(i + 1) <= 57343) {
+      bytes += 4;
+      i++;
+    } else bytes += 3;
+  }
+  return bytes;
+}
+export {
+  RICH_CONTENT_LIMITS,
+  encodeRichContent,
+  htmlIsTrivial,
+  isPlainRicos,
+  parseRicosJson,
+  plainTextToRicos,
+  ricosToPlainText
+};
+//# sourceMappingURL=wix-rich-content.mjs.map

package/dist/authoring-runtime/node_modules/@wix/himalaya/package.json

@@ -434,6 +434,10 @@
       "types": "./dist/_types/stdlib/wix-sdk/reviews/src/index.d.ts",
       "import": "./dist/wix-reviews.mjs"
     },
+    "./wix-rich-content": {
+      "types": "./dist/_types/stdlib/wix-sdk/rich-content/src/index.d.ts",
+      "import": "./dist/wix-rich-content.mjs"
+    },
     "./wix-seo": {
       "types": "./dist/_types/stdlib/wix-sdk/seo-v1/src/index.d.ts",
       "import": "./dist/wix-seo.mjs"

package/dist/cli.mjs

@@ -4964,6 +4964,7 @@ var init_build_lib = __esm({
       // Cross-vertical media sizing. Not a generated domain client — the one place a
       // Wix media handle becomes a fetchable URL, so no vertical re-derives it.
       "@himalaya/wix-media": SDK("media"),
+      "@himalaya/wix-rich-content": SDK("rich-content"),
       "@himalaya/wix-stores": SDK("stores-v1"),
       "@himalaya/wix-ecom": SDK("ecom"),
       "@himalaya/wix-redirects": SDK("redirects-v1"),
@@ -7592,9 +7593,17 @@ var init_validator = __esm({
             hideHostedSiteHeader: { type: "boolean" },
             immersive: { type: "boolean" },
             showCloseButton: { type: "boolean" },
-            // Keep the native WebView instance warm across re-presentations (covers reload cold
-            // otherwise). iOS-implemented; Android ignores it (cold-loads) for now.
-            keepAlive: { type: "boolean" }
+            // Keep the native WebView instance warm across re-presentations and tab switches
+            // (per screen id, LRU — WebViewKeepAliveStore on both platforms).
+            keepAlive: { type: "boolean" },
+            // Hosted-site polish — native hosts honoured these before the validator knew them.
+            pinHostedHeader: { type: "boolean" },
+            internalLinksAsScreens: { type: "boolean" },
+            respectHttpCache: { type: "boolean" },
+            coverBandColor: { type: "string" },
+            // RFC 0062 — binary-shipped chrome hiding for a hosted site (no page script over the air).
+            hideWixAds: { type: "boolean" },
+            hideHostedSiteFooter: { type: "boolean" }
           }
         }
       }
@@ -12495,7 +12504,6 @@ function resolveIdiom(tokens, ctx = {}) {
 var IDIOM_CONTEXTS, UNSAFE_KEYS;
 var init_idiom = __esm({
   "../../core/ts/src/idiom.ts"() {
-    "use strict";
     IDIOM_CONTEXTS = {
       ios: { native: ["ios"] },
       android: { native: ["material"] },

package/guides/importable-sdks.md

@@ -111,6 +111,7 @@ direction the platform is heading — recommended, not required). Usage is unifo
 - `@himalaya/wix-redirects` — Wix redirects — typed REST client
 - `@himalaya/wix-restaurants` — Restaurants — menus and orders
 - `@himalaya/wix-reviews` — Product and site reviews
+- `@himalaya/wix-rich-content` — Ricos rich content — encode a post body for the RichContent viewer; plain-text helpers
 - `@himalaya/wix-seo` — Wix seo — typed REST client
 - `@himalaya/wix-site-list` — The user's Wix sites
 - `@himalaya/wix-site-media` — Wix site media — typed REST client

package/guides/sdk-reference.json

@@ -907,7 +907,7 @@
         "name": "SplashConfig",
         "kind": "interface",
         "jsdoc": "/**\n * The IN-APP splash — the brand surface between the OS splash handing off and the\n * app being ready. The *OS* splash is generated at build time from the same\n * `splash` block in config.ts and can never be OTA (iOS reads `UILaunchScreen`\n * before any app code runs); this layer is OTA. Artwork stays baked in the binary\n * — `logoAsset` / `backgroundImageAsset` name a baked asset, so only the\n * composition travels.\n */",
-        "decl": "export interface SplashConfig {\n  /** Master switch / kill-switch. Absent or false ⇒ no surface. */\n  enabled?: boolean;\n  /** Background color TOKEN name (e.g. \"accentPrimary\"). */\n  backgroundColor?: TokenName;\n  /** Gradient token name; wins over `backgroundColor`. */\n  backgroundGradient?: TokenName;\n  /** BAKED asset name for a full-bleed background image; wins over color/gradient. */\n  backgroundImageAsset?: string;\n  /** BAKED asset name for the centered logo (e.g. \"LaunchLogo\"). */\n  logoAsset?: string;\n  /** Logo width in pt/dp. 0 / absent ⇒ 96. */\n  logoWidth?: number;\n  /** Optional wordmark line. NOTE: a literal string, so an OTA edit bypasses\n   *  localization (same caveat as `NavTabItem.label`). */\n  caption?: string;\n  /** Typography token for the caption. Absent ⇒ \"title1\". */\n  captionStyle?: TokenName;\n  /** Color token for the caption. Absent ⇒ \"textOnAccent\". */\n  captionColor?: TokenName;\n  /** Absent / unknown ⇒ \"centered\". */\n  layout?: SplashLayout;\n  /** Anti-flash floor, ms. Clamped client-side to [0, 2000]. */\n  minVisibleMs?: number;\n  /** Hard ceiling on the readiness hold, ms — a stuck boot can never wedge the\n   *  UI. 0 / absent ⇒ 3000. Clamped client-side to [0, 8000]. */\n  maxHoldMs?: number;\n}"
+        "decl": "export interface SplashConfig {\n  /** Master switch / kill-switch. Absent or false ⇒ no surface. */\n  enabled?: boolean;\n  /** Background color TOKEN name (e.g. \"accentPrimary\"). */\n  backgroundColor?: TokenName;\n  /** Gradient token name; wins over `backgroundColor`. */\n  backgroundGradient?: TokenName;\n  /** BAKED asset name for a full-bleed background image; wins over color/gradient. */\n  backgroundImageAsset?: string;\n  /** BAKED asset name for the centered logo (e.g. \"LaunchLogo\"). */\n  logoAsset?: string;\n  /** Logo width in pt/dp. 0 / absent ⇒ 96. */\n  logoWidth?: number;\n  /** Optional wordmark line. NOTE: a literal string, so an OTA edit bypasses\n   *  localization (same caveat as `NavTabItem.label`). */\n  caption?: string;\n  /** Typography token for the caption. Absent ⇒ \"title1\". */\n  captionStyle?: TokenName;\n  /** Color token for the caption. Absent ⇒ \"textOnAccent\". */\n  captionColor?: TokenName;\n  /** Absent / unknown ⇒ \"centered\". */\n  layout?: SplashLayout;\n  /** Anti-flash floor, ms. Clamped client-side to [0, 2000]. */\n  minVisibleMs?: number;\n  /** Hard ceiling on the readiness hold, ms — a stuck boot can never wedge the\n   *  UI. 0 / absent ⇒ 3000. Clamped client-side to [0, 8000]. */\n  maxHoldMs?: number;\n  /** What readiness waits for beyond the seed. Absent / \"\" ⇒ seeded is\n   *  enough. \"first_content\" ⇒ also the first WebView page (a site shell), still\n   *  under `maxHoldMs`. Unknown coalesces to \"\" on device. */\n  readySignal?: SplashReadySignal;\n}"
       },
       {
         "name": "OrientationConfig",
@@ -20943,6 +20943,79 @@
       }
     ]
   },
+  {
+    "name": "@himalaya/wix-rich-content",
+    "source": "stdlib/wix-sdk/rich-content/src/index.ts",
+    "description": "Ricos rich content — encode a post body for the RichContent viewer; plain-text helpers",
+    "api": [
+      {
+        "name": "RicosNode",
+        "kind": "type",
+        "jsdoc": "/** One Ricos node: a block (PARAGRAPH, HEADING, IMAGE, …) or an inline TEXT run. Type-specific data\n *  (`imageData`, `headingData`, …) rides along as extra keys. */",
+        "decl": "export type RicosNode = { type?: string; id?: string; nodes?: RicosNode[]; textData?: { text?: string; decorations?: { type: string; linkData?: { link?: { url?: string } } }[] }; [k: string]: unknown };"
+      },
+      {
+        "name": "RicosDocument",
+        "kind": "type",
+        "jsdoc": "/** A Ricos document with its `nodes` checked to be an array (what parseRicosJson and plainTextToRicos return). */",
+        "decl": "export type RicosDocument = { nodes: RicosNode[]; metadata?: unknown; documentStyle?: unknown };"
+      },
+      {
+        "name": "RicosInput",
+        "kind": "type",
+        "jsdoc": "/** Any Ricos-shaped value, as Wix APIs return it (a blog post's `richContent`, an event's description) — their\n *  generated types declare `nodes` loosely, so the helpers accept it as is and check the shape at runtime. */",
+        "decl": "export type RicosInput = { nodes?: unknown; metadata?: unknown; documentStyle?: unknown };"
+      },
+      {
+        "name": "RejectReason",
+        "kind": "type",
+        "jsdoc": "/** Why a document is not shown: the viewer draws its fallback instead and reports only this code. */",
+        "decl": "export type RejectReason = \"invalid_json\" | \"too_large\" | \"too_many_nodes\" | \"too_deep\" | \"not_a_document\";"
+      },
+      {
+        "name": "RICH_CONTENT_LIMITS",
+        "kind": "const",
+        "jsdoc": "/** The RichContent viewer's ceilings; every renderer rejects a document past any of them. Kept equal to the platform limits file by a test. */",
+        "decl": "export const RICH_CONTENT_LIMITS = { maxBytes: 262144, maxNodes: 5000, maxDepth: 16 } as const;"
+      },
+      {
+        "name": "parseRicosJson",
+        "kind": "function",
+        "jsdoc": "/** Reads a Ricos document from a JSON string or an already-parsed object (page messages arrive as either,\n *  depending on the platform). Returns null for empty input, invalid JSON, or anything without a `nodes` array. */",
+        "decl": "export function parseRicosJson(value: unknown): RicosDocument | null;"
+      },
+      {
+        "name": "ricosToPlainText",
+        "kind": "function",
+        "jsdoc": "/** Plain text of a document. Paragraphs, headings and loose text runs are blocks joined by a blank line; runs\n *  inside a block join with nothing between them, so a word split across bold and plain runs stays one word.\n *  Media and other nodes contribute only the text nested inside them. Malformed parts (a non-object node, a\n *  `nodes` that is not an array) contribute nothing — it never throws. */",
+        "decl": "export function ricosToPlainText(doc: RicosInput | null | undefined): string;"
+      },
+      {
+        "name": "plainTextToRicos",
+        "kind": "function",
+        "jsdoc": "/** A document of undecorated paragraphs, one per blank-line-separated block of `text` — the inverse of\n *  ricosToPlainText for plain text. An empty string gives one empty paragraph. */",
+        "decl": "export function plainTextToRicos(text: string): RicosDocument;"
+      },
+      {
+        "name": "isPlainRicos",
+        "kind": "function",
+        "jsdoc": "/** True when a plain-text editor can rewrite the document without losing anything: no document styling, and\n *  only paragraphs of undecorated text runs whose paragraph settings are the defaults a plain paragraph carries\n *  (`{ textStyle: { textAlignment: \"AUTO\" }, indentation: 0 }`, or none). A heading, list, link, bold run,\n *  media node, alignment or indent makes it rich. A missing or empty document (no `nodes`, or `[]`) is plain —\n *  there is nothing in it to lose. Anything malformed is not: a value that is not a document object (a JSON\n *  string, an array), or `nodes` that is not an array, so a caller holding the wrong shape never overwrites it. */",
+        "decl": "export function isPlainRicos(doc: RicosInput | null | undefined): boolean;"
+      },
+      {
+        "name": "htmlIsTrivial",
+        "kind": "function",
+        "jsdoc": "/** True when an HTML description has no formatting to protect: empty, text with no tag in it (a lone `<` in\n *  prose is text), or exactly one attribute-free `<p>` around text with no inner tags. A form that edits plain\n *  text may overwrite only these. */",
+        "decl": "export function htmlIsTrivial(html: string | null | undefined): boolean;"
+      },
+      {
+        "name": "encodeRichContent",
+        "kind": "function",
+        "jsdoc": "/** Prepares a Ricos document for the RichContent viewer; bind the returned `json` as `documentJsonPath`.\n *  Wix media ids become sized https URLs (`imageWidth`, default and maximum 1400 px; galleries and posters at most\n *  1000). Block ids follow the viewer's own rule on the encoded document — a block's missing, all-digits-and-dots\n *  or repeated id becomes its path index there (\"0.2.1\") — so every renderer shows the same ids and encoding twice\n *  changes nothing. Images, galleries and videos without https media (an http YouTube or Vimeo link is kept: the\n *  viewer shows it as a card), buttons without an http(s)/mailto/tel link, any other link url with a disallowed\n *  scheme (link decorations, card and image links) and inline HTML (`htmlData.html`, an embed's `oembed.html`) are\n *  removed; an allowed link is emitted trimmed of surrounding whitespace, as the viewer emits it. Text is never\n *  changed. Keys are sorted, so equal documents encode to equal strings. The input is not\n *  modified. A missing or empty document gives `{ json: \"\" }`; a non-document or one past the viewer's limits gives\n *  `{ json: \"\", rejected }` (checked in the order not_a_document, too_deep, too_large, too_many_nodes). */",
+        "decl": "export function encodeRichContent(doc: RicosInput | null | undefined, opts: { imageWidth?: number } = {}): { json: string; rejected?: RejectReason };"
+      }
+    ]
+  },
   {
     "name": "@himalaya/wix-seo",
     "source": "stdlib/wix-sdk/seo-v1/src/index.ts",

package/guides/splash-screens.md

@@ -148,6 +148,7 @@ splash: {
   layout: "centeredStacked",     // centered | centeredStacked | logoOnly
   minVisibleMs: 600,             // anti-flash floor,  clamped ≤ 2000
   maxHoldMs: 3000,               // hard ceiling,      clamped ≤ 8000
+  readySignal: "",               // "" | "first_content" — see "Readiness, not a timer"
 }
 ```
 
@@ -163,13 +164,24 @@ A `splashScreenId` pointing at an OTA descriptor fails at exactly the moment it'
 render the generic `ProgressView` + literal `"Loading…"` on precisely the launch we're fixing.
 It would also invert boot ordering (`applyProdServeFromCache` and `LocaleStore.initShared` must
 precede any fetch) and put descriptor-shaped payload inside `NavigationConfig`, where a single
-strict-decode throw disables **all** OTA. Proto field 13+ is reserved should that ever change.
+strict-decode throw disables **all** OTA. Proto field 14+ is reserved should that ever change
+(13 is `ready_signal`).
 
 ### Readiness, not a timer
 
 `BootReadiness` (iOS + Android, one tested implementation each) decides when the surface may
 go: **seeded AND past the anti-flash floor, OR the hard ceiling elapsed.**
 
+`readySignal: "first_content"` adds one
+condition to "seeded": the first WebView page has finished loading. It exists for a site shell
+(`himi-brandy`), where every tab is the customer's website and a splash that leaves on `seeded`
+fades into a blank WebView. Each native WebView host calls `BootReadiness.markFirstContent()` on
+a real page load (not on an error page or a cancelled navigation), and the shell re-evaluates
+on it: `BootReadiness.firstContentNotification` on iOS, the `firstContent` `StateFlow` on
+Android. The shell must also MOUNT its content under the splash, not after it, or there is no
+page to wait for. The ceiling still applies, and a launch it releases while waiting for content
+reports `splash_timeout`. Unknown values read as `""` on device; `defineApp` rejects them in source.
+
 The ceiling is the load-bearing part. The app must always become interactive, so `maxHoldMs`
 dismisses the splash even if readiness is never reported — a failed seed prefill, a slow disk,
 or a bug in boot cannot wedge the UI behind a splash. `effectiveReady` is **monotonic**: once

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1079.0",
+  "version": "0.1080.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": "d5eb7481dca2d7a6272424f6a9a08ddc1bca8661f0a9a11443e2ca45"
+  "falconPackageHash": "1e0c05f97a07293123b9d983e46d508913e929db4fde75461f56a065"
 }

package/templates/beauty-salon-owner/tier5-src/_shared/owner-post-content.ts

@@ -1,35 +1,16 @@
 import type { WixRichContent } from "@himalaya/wix-blog";
+// The rich-content helpers. 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 { ricosToPlainText, isPlainRicos, plainTextToRicos } from "@himalaya/wix-rich-content";
 import { wixMediaUrl, WIX_DETAIL_IMAGE } from "./himi-store.js";
 
-type Node = { type?: string; nodes?: Node[]; textData?: { text?: string; decorations?: unknown[] }; [key: string]: unknown };
+// Thin wrappers keep the WixRichContent signatures callers compile against.
 /** Join inline runs without adding paragraph breaks between bold/plain spans. */
-export function postBodyText(rich: WixRichContent | null | undefined): string {
-  const inline = (node: Node): string => typeof node.textData?.text === "string"
-    ? node.textData.text : (node.nodes ?? []).map(inline).join("");
-  const blocks = (nodes: Node[]): string[] => nodes.flatMap(node =>
-    node.type === "PARAGRAPH" || node.type === "HEADING" || node.type === "TEXT"
-      ? [inline(node)] : blocks(node.nodes ?? []));
-  return blocks((rich?.nodes ?? []) as Node[]).join("\n\n");
-}
+export const postBodyText = (rich: WixRichContent | null | undefined): string => ricosToPlainText(rich);
 /** The plain editor must not overwrite formatting or any opaque media node.
  *  Rich drafts remain editable for title/excerpt/cover; body stays untouched. */
-export function hasRichBody(rich: WixRichContent | null | undefined): boolean {
-  return (rich?.nodes ?? []).some(raw => {
-    if (!raw || typeof raw !== "object") return true;
-    const node = raw as Node;
-    if (node.type !== "PARAGRAPH") return true;
-    if (Object.keys(node).some(key => !["type", "id", "nodes", "paragraphData"].includes(key))) return true;
-    if (node.paragraphData && Object.keys(node.paragraphData as object).length) return true;
-    return (node.nodes ?? []).some(child => child.type !== "TEXT"
-      || !!child.textData?.decorations?.length
-      || Object.keys(child).some(key => !["type", "id", "textData", "nodes"].includes(key)));
-  });
-}
-export function plainPostBody(body: string): WixRichContent {
-  return { nodes: body.split("\n\n").map(text => ({
-    type: "PARAGRAPH", nodes: [{ type: "TEXT", textData: { text, decorations: [] } }],
-  })) };
-}
+export const hasRichBody = (rich: WixRichContent | null | undefined): boolean => !isPlainRicos(rich);
+export const plainPostBody = (body: string): WixRichContent => plainTextToRicos(body);
 /** Current Blog media shape plus older coverImage projections. */
 export function postCoverUrl(raw: Record<string, any> | null | undefined): string {
   if (!raw) return "";