@wix/himalaya-cli 0.1078.0 → 0.1080.0

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.1078.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": "70cae8e9f3455dbda3af632c51aa39b8900dab8e391552018b340702"
+  "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 "";

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

@@ -1,17 +1,10 @@
-// [rico] #3363 — may a plain owner form round-trip this body? Ricos uses owner-post-content's
-// hasRichBody; these cover the Stores HTML description and the FAQ's legacy DraftJS answer.
-// [rico] #3365 moves htmlIsTrivial into @himalaya/wix-rich-content with these exact semantics.
+// May a plain owner form round-trip this body? The Ricos and HTML checks are @himalaya/wix-rich-content's;
+// this file adds the read-only previews the forms show for a locked body, and the FAQ's legacy DraftJS answer.
+// Inside the platform source this import is a relative path, so node test runs resolve it; an app's copy
+// imports "@himalaya/wix-rich-content".
+import { htmlIsTrivial, isPlainRicos } from "@himalaya/wix-rich-content";
 
-/** A tag opener (`<p`, `</p`, `<!--`), as opposed to a bare `<` in prose ("cups < 8 cm"). */
-const TAG = /<[a-z!/?]/i;
-
-/** True when a plain text field can hold this HTML without losing anything: empty, bare text
- *  (no tag — a lone `<` in prose is text), or exactly one attribute-less `<p>…</p>` with no
- *  inner tags. */
-export function htmlIsTrivial(html: string | null | undefined): boolean {
-  const s = (html ?? "").trim();
-  return !s || !TAG.test(s) || /^<p>[^<>]*<\/p>$/.test(s);
-}
+export { htmlIsTrivial };
 
 const ENTITIES: Record<string, string> = { "&nbsp;": " ", "&amp;": "&", "&lt;": "<", "&gt;": ">", "&quot;": "\"", "&#39;": "'" };
 
@@ -23,35 +16,13 @@ export function htmlPreviewText(html: string | null | undefined): string {
     .split("\n").map((l) => l.replace(/\s+/g, " ").trim()).filter(Boolean).join("\n");
 }
 
-type RicosNode = { type?: unknown; nodes?: unknown; textData?: { decorations?: unknown }; paragraphData?: unknown; [key: string]: unknown };
-const onlyKeys = (o: object, allowed: string[]) => Object.keys(o).every((k) => allowed.includes(k));
-const emptyObject = (v: unknown) => v === undefined || (!!v && typeof v === "object" && Object.keys(v as object).length === 0);
-
-/** The paragraph styling a PLAIN paragraph still carries on the Ricos wire (Events v3 sends
- *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). */
-function defaultParagraphData(pd: unknown): boolean {
-  if (pd === undefined) return true;
-  if (!pd || typeof pd !== "object" || !onlyKeys(pd, ["textStyle", "indentation"])) return false;
-  const { textStyle, indentation } = pd as { textStyle?: unknown; indentation?: unknown };
-  if (indentation !== undefined && indentation !== 0) return false;
-  if (textStyle === undefined) return true;
-  if (!textStyle || typeof textStyle !== "object" || !onlyKeys(textStyle, ["textAlignment"])) return false;
-  const align = (textStyle as { textAlignment?: unknown }).textAlignment;
-  return align === undefined || align === "AUTO";
-}
-
 /** True when a plain text field can round-trip this Ricos document: no document styling, and
- *  only paragraphs of undecorated text whose paragraph data is the wire default. Anything else —
- *  a heading, list, link, bold run, media node, alignment or indent — is rich. */
-export function ricosIsPlain(doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean {
-  if (!doc || !emptyObject(doc.documentStyle)) return false;
-  const nodes = Array.isArray(doc.nodes) ? (doc.nodes as RicosNode[]) : [];
-  return nodes.every((n) => !!n && typeof n === "object" && n.type === "PARAGRAPH"
-    && onlyKeys(n, ["type", "id", "nodes", "paragraphData"]) && defaultParagraphData(n.paragraphData)
-    && (Array.isArray(n.nodes) ? (n.nodes as RicosNode[]) : []).every((t) => !!t && typeof t === "object" && t.type === "TEXT"
-      && onlyKeys(t, ["type", "id", "textData", "nodes"]) && (!Array.isArray(t.nodes) || t.nodes.length === 0)
-      && !(Array.isArray(t.textData?.decorations) && t.textData.decorations.length)));
-}
+ *  only paragraphs of undecorated text whose paragraph data is the wire default (Events v3 sends
+ *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). Anything else —
+ *  a heading, list, link, bold run, media node, alignment or indent — is rich, and so is a missing
+ *  document (callers decide what an absent body means). */
+export const ricosIsPlain = (doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean =>
+  !!doc && isPlainRicos(doc);
 
 /** Preview text for a legacy DraftJS document: its `blocks[].text` joined by a blank line, or ""
  *  when the payload is not DraftJS JSON (never a throw). */

package/templates/community-club-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 "";

package/templates/community-club-owner/tier5-src/_shared/owner-rich-guard.ts

@@ -1,17 +1,10 @@
-// [rico] #3363 — may a plain owner form round-trip this body? Ricos uses owner-post-content's
-// hasRichBody; these cover the Stores HTML description and the FAQ's legacy DraftJS answer.
-// [rico] #3365 moves htmlIsTrivial into @himalaya/wix-rich-content with these exact semantics.
+// May a plain owner form round-trip this body? The Ricos and HTML checks are @himalaya/wix-rich-content's;
+// this file adds the read-only previews the forms show for a locked body, and the FAQ's legacy DraftJS answer.
+// Inside the platform source this import is a relative path, so node test runs resolve it; an app's copy
+// imports "@himalaya/wix-rich-content".
+import { htmlIsTrivial, isPlainRicos } from "@himalaya/wix-rich-content";
 
-/** A tag opener (`<p`, `</p`, `<!--`), as opposed to a bare `<` in prose ("cups < 8 cm"). */
-const TAG = /<[a-z!/?]/i;
-
-/** True when a plain text field can hold this HTML without losing anything: empty, bare text
- *  (no tag — a lone `<` in prose is text), or exactly one attribute-less `<p>…</p>` with no
- *  inner tags. */
-export function htmlIsTrivial(html: string | null | undefined): boolean {
-  const s = (html ?? "").trim();
-  return !s || !TAG.test(s) || /^<p>[^<>]*<\/p>$/.test(s);
-}
+export { htmlIsTrivial };
 
 const ENTITIES: Record<string, string> = { "&nbsp;": " ", "&amp;": "&", "&lt;": "<", "&gt;": ">", "&quot;": "\"", "&#39;": "'" };
 
@@ -23,35 +16,13 @@ export function htmlPreviewText(html: string | null | undefined): string {
     .split("\n").map((l) => l.replace(/\s+/g, " ").trim()).filter(Boolean).join("\n");
 }
 
-type RicosNode = { type?: unknown; nodes?: unknown; textData?: { decorations?: unknown }; paragraphData?: unknown; [key: string]: unknown };
-const onlyKeys = (o: object, allowed: string[]) => Object.keys(o).every((k) => allowed.includes(k));
-const emptyObject = (v: unknown) => v === undefined || (!!v && typeof v === "object" && Object.keys(v as object).length === 0);
-
-/** The paragraph styling a PLAIN paragraph still carries on the Ricos wire (Events v3 sends
- *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). */
-function defaultParagraphData(pd: unknown): boolean {
-  if (pd === undefined) return true;
-  if (!pd || typeof pd !== "object" || !onlyKeys(pd, ["textStyle", "indentation"])) return false;
-  const { textStyle, indentation } = pd as { textStyle?: unknown; indentation?: unknown };
-  if (indentation !== undefined && indentation !== 0) return false;
-  if (textStyle === undefined) return true;
-  if (!textStyle || typeof textStyle !== "object" || !onlyKeys(textStyle, ["textAlignment"])) return false;
-  const align = (textStyle as { textAlignment?: unknown }).textAlignment;
-  return align === undefined || align === "AUTO";
-}
-
 /** True when a plain text field can round-trip this Ricos document: no document styling, and
- *  only paragraphs of undecorated text whose paragraph data is the wire default. Anything else —
- *  a heading, list, link, bold run, media node, alignment or indent — is rich. */
-export function ricosIsPlain(doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean {
-  if (!doc || !emptyObject(doc.documentStyle)) return false;
-  const nodes = Array.isArray(doc.nodes) ? (doc.nodes as RicosNode[]) : [];
-  return nodes.every((n) => !!n && typeof n === "object" && n.type === "PARAGRAPH"
-    && onlyKeys(n, ["type", "id", "nodes", "paragraphData"]) && defaultParagraphData(n.paragraphData)
-    && (Array.isArray(n.nodes) ? (n.nodes as RicosNode[]) : []).every((t) => !!t && typeof t === "object" && t.type === "TEXT"
-      && onlyKeys(t, ["type", "id", "textData", "nodes"]) && (!Array.isArray(t.nodes) || t.nodes.length === 0)
-      && !(Array.isArray(t.textData?.decorations) && t.textData.decorations.length)));
-}
+ *  only paragraphs of undecorated text whose paragraph data is the wire default (Events v3 sends
+ *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). Anything else —
+ *  a heading, list, link, bold run, media node, alignment or indent — is rich, and so is a missing
+ *  document (callers decide what an absent body means). */
+export const ricosIsPlain = (doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean =>
+  !!doc && isPlainRicos(doc);
 
 /** Preview text for a legacy DraftJS document: its `blocks[].text` joined by a blank line, or ""
  *  when the payload is not DraftJS JSON (never a throw). */

package/templates/community-club-owner/tier5-src/himi-owner-lite-event-form/index.ts

@@ -10,8 +10,8 @@ import { defineService } from "@himalaya/state";
 import { getEvent, updateEvent, type WixEvent } from "@himalaya/wix-events";
 import { normalizeEvent } from "../_shared/himi-events.js";
 import { postBodyText, plainPostBody } from "../_shared/owner-post-content.js";
-// Not owner-post-content's hasRichBody: Events v3 sends default paragraphData on EVERY paragraph
-// (which hasRichBody reads as formatting) and a documentStyle it never looks at.
+// Events v3 sends default paragraphData on EVERY paragraph and an empty documentStyle; ricosIsPlain
+// reads both as plain.
 import { ricosIsPlain } from "../_shared/owner-rich-guard.js";
 import { ownerLoadError, isBridgeUnavailable, isOwnerPreviewDemo, shouldQueueOwnerWrite } from "../_shared/owner-load-error.js";
 import { DEMO_EVENTS, DEMO_NOTE, DEMO_SAVE_NOTE, demoRefusalPatch } from "../_shared/owner-preview-demo.js";

package/templates/events-meetups-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 "";

package/templates/events-meetups-owner/tier5-src/_shared/owner-rich-guard.ts

@@ -1,17 +1,10 @@
-// [rico] #3363 — may a plain owner form round-trip this body? Ricos uses owner-post-content's
-// hasRichBody; these cover the Stores HTML description and the FAQ's legacy DraftJS answer.
-// [rico] #3365 moves htmlIsTrivial into @himalaya/wix-rich-content with these exact semantics.
+// May a plain owner form round-trip this body? The Ricos and HTML checks are @himalaya/wix-rich-content's;
+// this file adds the read-only previews the forms show for a locked body, and the FAQ's legacy DraftJS answer.
+// Inside the platform source this import is a relative path, so node test runs resolve it; an app's copy
+// imports "@himalaya/wix-rich-content".
+import { htmlIsTrivial, isPlainRicos } from "@himalaya/wix-rich-content";
 
-/** A tag opener (`<p`, `</p`, `<!--`), as opposed to a bare `<` in prose ("cups < 8 cm"). */
-const TAG = /<[a-z!/?]/i;
-
-/** True when a plain text field can hold this HTML without losing anything: empty, bare text
- *  (no tag — a lone `<` in prose is text), or exactly one attribute-less `<p>…</p>` with no
- *  inner tags. */
-export function htmlIsTrivial(html: string | null | undefined): boolean {
-  const s = (html ?? "").trim();
-  return !s || !TAG.test(s) || /^<p>[^<>]*<\/p>$/.test(s);
-}
+export { htmlIsTrivial };
 
 const ENTITIES: Record<string, string> = { "&nbsp;": " ", "&amp;": "&", "&lt;": "<", "&gt;": ">", "&quot;": "\"", "&#39;": "'" };
 
@@ -23,35 +16,13 @@ export function htmlPreviewText(html: string | null | undefined): string {
     .split("\n").map((l) => l.replace(/\s+/g, " ").trim()).filter(Boolean).join("\n");
 }
 
-type RicosNode = { type?: unknown; nodes?: unknown; textData?: { decorations?: unknown }; paragraphData?: unknown; [key: string]: unknown };
-const onlyKeys = (o: object, allowed: string[]) => Object.keys(o).every((k) => allowed.includes(k));
-const emptyObject = (v: unknown) => v === undefined || (!!v && typeof v === "object" && Object.keys(v as object).length === 0);
-
-/** The paragraph styling a PLAIN paragraph still carries on the Ricos wire (Events v3 sends
- *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). */
-function defaultParagraphData(pd: unknown): boolean {
-  if (pd === undefined) return true;
-  if (!pd || typeof pd !== "object" || !onlyKeys(pd, ["textStyle", "indentation"])) return false;
-  const { textStyle, indentation } = pd as { textStyle?: unknown; indentation?: unknown };
-  if (indentation !== undefined && indentation !== 0) return false;
-  if (textStyle === undefined) return true;
-  if (!textStyle || typeof textStyle !== "object" || !onlyKeys(textStyle, ["textAlignment"])) return false;
-  const align = (textStyle as { textAlignment?: unknown }).textAlignment;
-  return align === undefined || align === "AUTO";
-}
-
 /** True when a plain text field can round-trip this Ricos document: no document styling, and
- *  only paragraphs of undecorated text whose paragraph data is the wire default. Anything else —
- *  a heading, list, link, bold run, media node, alignment or indent — is rich. */
-export function ricosIsPlain(doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean {
-  if (!doc || !emptyObject(doc.documentStyle)) return false;
-  const nodes = Array.isArray(doc.nodes) ? (doc.nodes as RicosNode[]) : [];
-  return nodes.every((n) => !!n && typeof n === "object" && n.type === "PARAGRAPH"
-    && onlyKeys(n, ["type", "id", "nodes", "paragraphData"]) && defaultParagraphData(n.paragraphData)
-    && (Array.isArray(n.nodes) ? (n.nodes as RicosNode[]) : []).every((t) => !!t && typeof t === "object" && t.type === "TEXT"
-      && onlyKeys(t, ["type", "id", "textData", "nodes"]) && (!Array.isArray(t.nodes) || t.nodes.length === 0)
-      && !(Array.isArray(t.textData?.decorations) && t.textData.decorations.length)));
-}
+ *  only paragraphs of undecorated text whose paragraph data is the wire default (Events v3 sends
+ *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). Anything else —
+ *  a heading, list, link, bold run, media node, alignment or indent — is rich, and so is a missing
+ *  document (callers decide what an absent body means). */
+export const ricosIsPlain = (doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean =>
+  !!doc && isPlainRicos(doc);
 
 /** Preview text for a legacy DraftJS document: its `blocks[].text` joined by a blank line, or ""
  *  when the payload is not DraftJS JSON (never a throw). */

package/templates/events-meetups-owner/tier5-src/himi-owner-lite-event-form/index.ts

@@ -10,8 +10,8 @@ import { defineService } from "@himalaya/state";
 import { getEvent, updateEvent, type WixEvent } from "@himalaya/wix-events";
 import { normalizeEvent } from "../_shared/himi-events.js";
 import { postBodyText, plainPostBody } from "../_shared/owner-post-content.js";
-// Not owner-post-content's hasRichBody: Events v3 sends default paragraphData on EVERY paragraph
-// (which hasRichBody reads as formatting) and a documentStyle it never looks at.
+// Events v3 sends default paragraphData on EVERY paragraph and an empty documentStyle; ricosIsPlain
+// reads both as plain.
 import { ricosIsPlain } from "../_shared/owner-rich-guard.js";
 import { ownerLoadError, isBridgeUnavailable, isOwnerPreviewDemo, shouldQueueOwnerWrite } from "../_shared/owner-load-error.js";
 import { DEMO_EVENTS, DEMO_NOTE, DEMO_SAVE_NOTE, demoRefusalPatch } from "../_shared/owner-preview-demo.js";

package/templates/gym-fitness-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 "";

package/templates/gym-fitness-owner/tier5-src/_shared/owner-rich-guard.ts

@@ -1,17 +1,10 @@
-// [rico] #3363 — may a plain owner form round-trip this body? Ricos uses owner-post-content's
-// hasRichBody; these cover the Stores HTML description and the FAQ's legacy DraftJS answer.
-// [rico] #3365 moves htmlIsTrivial into @himalaya/wix-rich-content with these exact semantics.
+// May a plain owner form round-trip this body? The Ricos and HTML checks are @himalaya/wix-rich-content's;
+// this file adds the read-only previews the forms show for a locked body, and the FAQ's legacy DraftJS answer.
+// Inside the platform source this import is a relative path, so node test runs resolve it; an app's copy
+// imports "@himalaya/wix-rich-content".
+import { htmlIsTrivial, isPlainRicos } from "@himalaya/wix-rich-content";
 
-/** A tag opener (`<p`, `</p`, `<!--`), as opposed to a bare `<` in prose ("cups < 8 cm"). */
-const TAG = /<[a-z!/?]/i;
-
-/** True when a plain text field can hold this HTML without losing anything: empty, bare text
- *  (no tag — a lone `<` in prose is text), or exactly one attribute-less `<p>…</p>` with no
- *  inner tags. */
-export function htmlIsTrivial(html: string | null | undefined): boolean {
-  const s = (html ?? "").trim();
-  return !s || !TAG.test(s) || /^<p>[^<>]*<\/p>$/.test(s);
-}
+export { htmlIsTrivial };
 
 const ENTITIES: Record<string, string> = { "&nbsp;": " ", "&amp;": "&", "&lt;": "<", "&gt;": ">", "&quot;": "\"", "&#39;": "'" };
 
@@ -23,35 +16,13 @@ export function htmlPreviewText(html: string | null | undefined): string {
     .split("\n").map((l) => l.replace(/\s+/g, " ").trim()).filter(Boolean).join("\n");
 }
 
-type RicosNode = { type?: unknown; nodes?: unknown; textData?: { decorations?: unknown }; paragraphData?: unknown; [key: string]: unknown };
-const onlyKeys = (o: object, allowed: string[]) => Object.keys(o).every((k) => allowed.includes(k));
-const emptyObject = (v: unknown) => v === undefined || (!!v && typeof v === "object" && Object.keys(v as object).length === 0);
-
-/** The paragraph styling a PLAIN paragraph still carries on the Ricos wire (Events v3 sends
- *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). */
-function defaultParagraphData(pd: unknown): boolean {
-  if (pd === undefined) return true;
-  if (!pd || typeof pd !== "object" || !onlyKeys(pd, ["textStyle", "indentation"])) return false;
-  const { textStyle, indentation } = pd as { textStyle?: unknown; indentation?: unknown };
-  if (indentation !== undefined && indentation !== 0) return false;
-  if (textStyle === undefined) return true;
-  if (!textStyle || typeof textStyle !== "object" || !onlyKeys(textStyle, ["textAlignment"])) return false;
-  const align = (textStyle as { textAlignment?: unknown }).textAlignment;
-  return align === undefined || align === "AUTO";
-}
-
 /** True when a plain text field can round-trip this Ricos document: no document styling, and
- *  only paragraphs of undecorated text whose paragraph data is the wire default. Anything else —
- *  a heading, list, link, bold run, media node, alignment or indent — is rich. */
-export function ricosIsPlain(doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean {
-  if (!doc || !emptyObject(doc.documentStyle)) return false;
-  const nodes = Array.isArray(doc.nodes) ? (doc.nodes as RicosNode[]) : [];
-  return nodes.every((n) => !!n && typeof n === "object" && n.type === "PARAGRAPH"
-    && onlyKeys(n, ["type", "id", "nodes", "paragraphData"]) && defaultParagraphData(n.paragraphData)
-    && (Array.isArray(n.nodes) ? (n.nodes as RicosNode[]) : []).every((t) => !!t && typeof t === "object" && t.type === "TEXT"
-      && onlyKeys(t, ["type", "id", "textData", "nodes"]) && (!Array.isArray(t.nodes) || t.nodes.length === 0)
-      && !(Array.isArray(t.textData?.decorations) && t.textData.decorations.length)));
-}
+ *  only paragraphs of undecorated text whose paragraph data is the wire default (Events v3 sends
+ *  `{ textStyle: { textAlignment: "AUTO" }, indentation: 0 }` on every paragraph). Anything else —
+ *  a heading, list, link, bold run, media node, alignment or indent — is rich, and so is a missing
+ *  document (callers decide what an absent body means). */
+export const ricosIsPlain = (doc: { nodes?: unknown; documentStyle?: unknown } | null | undefined): boolean =>
+  !!doc && isPlainRicos(doc);
 
 /** Preview text for a legacy DraftJS document: its `blocks[].text` joined by a blank line, or ""
  *  when the payload is not DraftJS JSON (never a throw). */

package/templates/gym-fitness-owner/tier5-src/himi-owner-lite-event-form/index.ts

@@ -10,8 +10,8 @@ import { defineService } from "@himalaya/state";
 import { getEvent, updateEvent, type WixEvent } from "@himalaya/wix-events";
 import { normalizeEvent } from "../_shared/himi-events.js";
 import { postBodyText, plainPostBody } from "../_shared/owner-post-content.js";
-// Not owner-post-content's hasRichBody: Events v3 sends default paragraphData on EVERY paragraph
-// (which hasRichBody reads as formatting) and a documentStyle it never looks at.
+// Events v3 sends default paragraphData on EVERY paragraph and an empty documentStyle; ricosIsPlain
+// reads both as plain.
 import { ricosIsPlain } from "../_shared/owner-rich-guard.js";
 import { ownerLoadError, isBridgeUnavailable, isOwnerPreviewDemo, shouldQueueOwnerWrite } from "../_shared/owner-load-error.js";
 import { DEMO_EVENTS, DEMO_NOTE, DEMO_SAVE_NOTE, demoRefusalPatch } from "../_shared/owner-preview-demo.js";

package/templates/nonprofit-cause-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 "";