@wix/himalaya-cli 0.1078.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" }
           }
         }
       }
@@ -17090,6 +17099,79 @@ struct GeneratedLiveActivityBundle: WidgetBundle {
   }
 });
 
+// ../native-config/localweb.ts
+function resourcesDirOf(projectYml) {
+  const m = /^\s*-\s*path:\s*(\S+)\/Resources\/seed\s*$/m.exec(projectYml);
+  return m ? `${m[1]}/Resources` : null;
+}
+function renderLocalWebYaml(resourcesDir, declared) {
+  return (indent) => declared && resourcesDir ? [`${indent}- path: ${resourcesDir}/localweb`, `${indent}  type: folder`, `${indent}  optional: true`] : [];
+}
+function assertLocalWebBlockLanded(app, declared, path2, outcome) {
+  if (!declared || outcome !== "skipped") return;
+  throw new Error(
+    `${app}: config.ts declares richContentEditor: true, but ${path2} has no "# >>> ${LABEL_LOCALWEB}" markers. Add the markers and a "- Resources/localweb" exclude (core/rich-content-editor/README.md, "Opting an app in"); otherwise gen.sh copies the engine page into Resources/ and the .app never contains it.`
+  );
+}
+var LABEL_LOCALWEB;
+var init_localweb = __esm({
+  "../native-config/localweb.ts"() {
+    LABEL_LOCALWEB = "himalaya:localweb";
+  }
+});
+
+// ../../core/rich-content-editor/prebuild.mjs
+function codeOnly(src) {
+  let out2 = "";
+  let i = 0;
+  const n = src.length;
+  while (i < n) {
+    const c = src[i], d = src[i + 1];
+    if (c === "/" && d === "/") {
+      while (i < n && src[i] !== "\n") i++;
+      continue;
+    }
+    if (c === "/" && d === "*") {
+      i += 2;
+      while (i < n && !(src[i] === "*" && src[i + 1] === "/")) {
+        if (src[i] === "\n") out2 += "\n";
+        i++;
+      }
+      i += 2;
+      continue;
+    }
+    if (c === '"' || c === "'" || c === "`") {
+      out2 += c;
+      i++;
+      while (i < n && src[i] !== c) {
+        if (src[i] === "\\") {
+          i += 2;
+          continue;
+        }
+        if (c !== "`" && src[i] === "\n") break;
+        out2 += src[i] === "\n" ? "\n" : " ";
+        i++;
+      }
+      if (i < n && src[i] === c) {
+        out2 += c;
+        i++;
+      }
+      continue;
+    }
+    out2 += c;
+    i++;
+  }
+  return out2;
+}
+function declaresRichContentEditor(configTs) {
+  return /^\s*richContentEditor\s*:\s*true\s*,?\s*$/m.test(codeOnly(String(configTs ?? "")));
+}
+var init_prebuild = __esm({
+  "../../core/rich-content-editor/prebuild.mjs"() {
+    "use strict";
+  }
+});
+
 // ../native-config/gen-native-config.ts
 var gen_native_config_exports = {};
 __export(gen_native_config_exports, {
@@ -17396,6 +17478,13 @@ function genNativeConfig(app, opts = {}) {
     // apps that hand-author their own launch screen are untouched.
     applyToFile(iosProjectYml(app), "yaml", LABEL_IOS_SPLASH, renderSplashYaml, check)
   ];
+  const rce = declaresRichContentEditor(configTs);
+  for (const yml of [iosYml, macosProjectYml(app)]) {
+    const text6 = existsSync26(yml) ? readFileSync26(yml, "utf8") : "";
+    const r = applyToFile(yml, "yaml", LABEL_LOCALWEB, renderLocalWebYaml(resourcesDirOf(text6), rce), check);
+    if (existsSync26(yml)) assertLocalWebBlockLanded(app, rce, yml, r.outcome);
+    files.push(r);
+  }
   if (targetManaged) {
     const plan = live2;
     files.push(applyToFile(iosYml, "yaml", LABEL_LIVE_TARGET, (i) => plan.target.map((line) => i + line), check));
@@ -17425,6 +17514,8 @@ var init_gen_native_config = __esm({
     init_icon2();
     init_live_activity();
     init_car();
+    init_localweb();
+    init_prebuild();
     init_src2();
     LABEL_IOS_INFO = "himalaya:capabilities:info";
     LABEL_IOS_ENTITLEMENTS = "himalaya:capabilities:entitlements";
@@ -23946,7 +24037,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]+$/;
@@ -27567,7 +27657,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,
@@ -54113,10 +54202,16 @@ function previewResponse(pathname, assets, mount = "/preview", creds, handoverAt
         headers: { "content-type": "text/html; charset=utf-8", "cache-control": "public, max-age=31536000, immutable", "content-security-policy": T5_FRAME_CSP }
       });
     }
+    if (key2 === RICOS_EDITOR_KEY) {
+      return new Response(assetBytes(hit), {
+        status: 200,
+        headers: { "content-type": "text/html; charset=utf-8", "cache-control": "no-cache", "content-security-policy": RICOS_EDITOR_CSP, "x-content-type-options": "nosniff" }
+      });
+    }
     const immutable = key2.startsWith("assets/");
     return bytes(hit, immutable ? "public, max-age=31536000, immutable" : "no-cache");
   }
-  if (key2.startsWith("assets/")) {
+  if (key2.startsWith("assets/") || key2.startsWith("__himi/")) {
     return new Response(JSON.stringify({ error: "preview_asset_not_found", key: key2 }), {
       status: 404,
       headers: { "content-type": "application/json; charset=utf-8" }
@@ -54129,10 +54224,12 @@ function previewResponse(pathname, assets, mount = "/preview", creds, handoverAt
     headers: { "content-type": "application/json; charset=utf-8" }
   });
 }
-var T5_FRAME_CSP, PREVIEW_BASE_JS, PREVIEW_ENTRY_RECOVERY_JS, MOUNT_STRIP;
+var T5_FRAME_CSP, RICOS_EDITOR_KEY, RICOS_EDITOR_CSP, PREVIEW_BASE_JS, PREVIEW_ENTRY_RECOVERY_JS, MOUNT_STRIP;
 var init_preview3 = __esm({
   "../../packages/serve/src/preview.ts"() {
     T5_FRAME_CSP = "default-src 'none'; script-src 'unsafe-inline' 'unsafe-eval'; connect-src 'none'; img-src 'none'; media-src 'none'; style-src 'unsafe-inline'; base-uri 'none'; form-action 'none'; sandbox allow-scripts";
+    RICOS_EDITOR_KEY = "__himi/ricos/editor.html";
+    RICOS_EDITOR_CSP = "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src https: data: blob:; media-src https: blob:";
     PREVIEW_BASE_JS = // Both serve mounts (/preview framed + /app unframed — RFC 0051 track D) serve the SAME
     // embedded artifact, so one shim derives whichever mount the browser is on. Non-greedy:
     // the EARLIEST mount segment wins, mirroring the SPA's own deployBase (an app literally

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",