@wix/himalaya-cli 0.1080.0 → 0.1082.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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1080.0",
+  "version": "0.1082.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": "1e0c05f97a07293123b9d983e46d508913e929db4fde75461f56a065"
+  "falconPackageHash": "2de158374281e46bbd2976601d42e40436b4f87a2f4836dcab980ceb"
 }