@wix/himalaya-cli 0.1079.0 → 0.1081.0

package/guides/component-reference.json

@@ -2,7 +2,7 @@
   "_comment": "GENERATED by core/web-embed/authoring/gen-reference.mjs from core/ts/src/schema.ts — do not hand-edit. The schema is the source of truth; regenerate on schema changes.",
   "schemaSource": "core/ts/src/schema.ts",
   "bindingGrammar": "$service:<service>.<path> (worker state) · $item.<field> (list row) · $flag:<key> (feature flag) · $env:<key> (client environment — #1056). Bindings resolve in the text/value props marked 'binding-aware' below — INCLUDING Modifiers token refs — but only `background` and `border.color`, which are the two whose token a binding actually fills: a worker can drive per-item theming (e.g. a game board's per-square color), not just text. `shadow` is NOT binding-aware on any renderer, and a gradient is driven by its own `backgroundGradientPath` prop resolving to a gradient token NAME, not by a binding inside a token ref — so `shadow: { token: \"$item.x\" }` and `backgroundGradient: { token: \"$item.x\" }` keep the sentinel and silently lose the per-item styling. Colour slots split by LEVEL, not by component: inside modifiers a colour is a TokenRef OBJECT ({ token: \"…\" }), inside props it is a bare TokenName STRING — there is no modifiers.color or modifiers.tint (see the 'Token slots' section in component-reference.md). A few input props render the LITERAL and are NOT binding-aware — notably SearchField.placeholder and Chip.label; SearchField.value is live and binding-aware like other content props. Bindings also CANNOT target strict-enum fields (style, size, alignment, severity, presentation, contentMode, …) — those fail at render, not validation. $env: is client-resolved (no worker) and valid in modifiers.hiddenPath and FragmentSlot.casePath ONLY — keys reduceMotion/colorScheme/sizeClass/isRTL, e.g. hiddenPath:\"$env:reduceMotion\" or hiddenPath:\"$env:colorScheme==light\", casePath:\"$env:colorScheme\"; unknown key fails open (shown / defaultCase).",
-  "componentCount": 82,
+  "componentCount": 83,
   "notImplementedComponents": [
     "FieldError",
     "Picker",
@@ -981,6 +981,15 @@
       ],
       "propsSource": "export interface DataTableProps {\n  columns?: DataTableColumn[];\n  rows?: DataTableRow[];\n  /**\n   * `$service:` ONLY → an array of OBJECTS keyed by `column.key`. An array of\n   * arrays (positional, like the literal `rows`) is also accepted.\n   */\n  rowsPath?: string;\n  /**\n   * `hideHeader`, not `showHeader`: the proto field is a bool that defaults to\n   * false, so the affirmative spelling would default a table to headerless.\n   */\n  hideHeader?: boolean;\n  totals?: DataTableRow;\n  /** `$service:` ONLY → one row object. */\n  totalsPath?: string;\n  /** 0 / absent ⇒ unbounded */\n  maxRows?: number;\n  zebra?: boolean;\n}"
     },
+    {
+      "name": "RichContent",
+      "category": "Rich content",
+      "propsType": "RichContentProps",
+      "bindings": [
+        "documentJsonPath"
+      ],
+      "propsSource": "export interface RichContentProps {\n  /** `$service:<svc>.<path>` or `$item.<field>` → the UTF-8 JSON of `{ nodes, metadata?, documentStyle? }`. */\n  documentJsonPath?: string;\n  /** Literal document JSON (seed / offline). */\n  documentJson?: string;\n  /** Dispatched on a link, button or card tap with `args.url`. Absent ⇒ http(s) opens the in-app browser. */\n  onLink?: Action;\n  /** Rendered when the document is rejected (over budget / invalid). Absent ⇒ nothing. */\n  fallback?: Component;\n}"
+    },
     {
       "name": "VoiceNote",
       "category": "Recorded-audio bubble (messenger design G4)",

package/guides/component-reference.md

@@ -3,7 +3,7 @@
 > GENERATED from `core/ts/src/schema.ts` by `core/web-embed/authoring/gen-reference.mjs`.
 > The schema is the source of truth — regenerate on schema changes; do not hand-edit.
 
-**82 core component types.** Every component body is `{ "package": "himalaya", "type": "<Type>", "props": { … } }`.
+**83 core component types.** Every component body is `{ "package": "himalaya", "type": "<Type>", "props": { … } }`.
 Binding grammar: `$service:<service>.<path>` (worker state) · `$item.<field>` (list row template) · `$flag:<key>` (feature flag) · `$env:<key>` (client environment — #1056).
 Bindings resolve in the text/value props marked **binding-aware** below — **including two `Modifiers` token refs**, `background` and `border.color`, which are the only two whose token a binding actually fills: a worker can drive per-item **theming** (e.g. a game board's per-square color, `background: { token: "$item.bg" }`), not just text content. `shadow` and `backgroundGradient` are `TokenRef`s but are **not** binding-aware on any renderer — `shadow: { token: "$item.x" }` keeps the sentinel as a literal token name and silently loses the per-item styling, and a gradient is driven by its own `backgroundGradientPath` prop resolving to a gradient token NAME, not by a binding inside a token ref.
 `$env:` is **client-resolved** (no worker) and valid in `modifiers.hiddenPath` and `FragmentSlot.casePath` **only** — keys `reduceMotion` / `colorScheme` / `sizeClass` / `isRTL`, with an optional `==`/`!=` comparison (e.g. `hiddenPath: "$env:reduceMotion"`, `hiddenPath: "$env:colorScheme==light"`, `casePath: "$env:colorScheme"`). An unknown key fails open (shown / `defaultCase`).
@@ -92,6 +92,7 @@ See also **[Modifiers](#modifiers)** (the `modifiers` block) and **[Actions](#ac
 | `DonutChart` | Analytics data-viz | `slicesPath` |
 | `Legend` | Analytics data-viz | `itemsPath` |
 | `DataTable` | Analytics data-viz | `rowsPath`, `totalsPath` |
+| `RichContent` | Rich content | `documentJsonPath` |
 | `VoiceNote` | Recorded-audio bubble (messenger design G4) | `waveformPath`, `durationMsPath`, `positionMsPath`, `statePath`, `deliveryPath`, `ratePath` |
 | `Marquee` | Recorded-audio bubble (messenger design G4) | — |
 | `Timeline` | Recorded-audio bubble (messenger design G4) | `entriesPath` |
@@ -114,7 +115,7 @@ See also **[Modifiers](#modifiers)** (the `modifiers` block) and **[Actions](#ac
 
 These props are accepted by the schema and pass validation, but the named platform's renderer never reads them — they silently do nothing (no warning, no log). Prefer a prop NOT listed here, or drive the behaviour from a worker.
 
-**Scope: 14 of 82 components, all of them ios-only** — every other component/platform pair reads every prop it decodes. The list splits in two, and the halves mean different things:
+**Scope: 14 of 83 components, all of them ios-only** — every other component/platform pair reads every prop it decodes. The list splits in two, and the halves mean different things:
 
 - **`category` (4: `BottomSheet`, `Menu`, `Tooltip`, `Popover`)** — the prop changes the component's *kind*. These genuinely are **not implemented**: an overlay renders always-visible inline, so the component does not do the job its name implies. Check the row's note for a working alternative — for a dismissible sheet it is `presentation: "sheet"` on the navigating `Action`, not `BottomSheet`.
 - **`styling` (10: `FieldError`, `Picker`, `DatePicker`, `Tabs`, `Snackbar`, `Slider`, `ActivityIndicator`, `ChipsInput`, `OtpInput`, `Video`)** — the component itself **works**; only the listed prop is inert. `Slider` on iOS is a working slider whose `debounceMs` does not throttle — not a broken `Slider`. Use the component; just do not depend on that one prop.
@@ -1597,6 +1598,23 @@ export interface DataTableProps {
 }
 ```
 
+### Rich content
+
+#### RichContent
+
+```ts
+export interface RichContentProps {
+  /** `$service:<svc>.<path>` or `$item.<field>` → the UTF-8 JSON of `{ nodes, metadata?, documentStyle? }`. */
+  documentJsonPath?: string;
+  /** Literal document JSON (seed / offline). */
+  documentJson?: string;
+  /** Dispatched on a link, button or card tap with `args.url`. Absent ⇒ http(s) opens the in-app browser. */
+  onLink?: Action;
+  /** Rendered when the document is rejected (over budget / invalid). Absent ⇒ nothing. */
+  fallback?: Component;
+}
+```
+
 ### Recorded-audio bubble (messenger design G4)
 
 #### VoiceNote

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/index.json

@@ -1,7 +1,7 @@
 {
   "_comment": "AUTO-GENERATED by tools/authoring-kit/bundle.mjs — DO NOT EDIT. Regenerate with: npm run authoring:gen",
   "schemaStamp": {
-    "componentCount": 82,
+    "componentCount": 83,
     "schemaSource": "core/ts/src/schema.ts"
   },
   "portalUrl": "https://apps.wix.com/_api/himi-serve/docs",

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.1081.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": "fabad058e08298bebcb3bacb89f82255ed6b92c6ee395d7b444c7fd3"
 }

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). */