@wix/himalaya-cli 0.819.0 → 0.820.0

package/guides/tier-5-add-a-screen.md

@@ -101,20 +101,41 @@ The first arg after `state` is the action's payload object: the descriptor's `Ac
 
 | Component | Its `Action` prop | What the reducer's payload contains |
 |---|---|---|
-| `TextField` / `RichTextField` | `onChange` | `{ value }` — the current text (fires per keystroke) |
-| `Slider` | `onChange` | `{ value }` — the numeric value (as a string) |
-| `Rating` | `onChange` | `{ value }` — the selected rating (`"1".."5"`) |
+| `TextField` / `RichTextField` | `onChange`, `onSubmit` | `{ value }` — the current text (onChange fires per keystroke) |
+| `SearchField` | `onChange`, `onSubmit` | `{ value }` — the query, debounced by `debounceMs` |
+| `Picker` / `SegmentedControl` / `Tabs` / `WheelPicker` | `onChange` | `{ selectedId }` — the id of the newly selected option |
+| `FilterChips` | `onChange` | `{ selectedIds }` — the **array** of ids selected *after* the tap (honors `multiSelect`) |
+| `Toggle` | `onChange` | `{ value }` — the next state, as a boolean |
+| `SelectionControl` | `onChange` | `{ value }` — the next checked state, as a boolean |
+| `Stepper` | `onChange` | `{ value }` — the clamped next value, as an int |
+| `Slider` | `onChange` | `{ value }` — a double (range mode adds `upperValue`) |
+| `Rating` | `onChange` | `{ value }` — the 1-based star index |
 | `ColorPicker` | `onChange` | `{ value }` — the hex string |
-| `Toggle` / `Switch` | `onChange` | `{ value }` — `"true"`/`"false"` |
-| `SegmentedControl` / `Tabs` | `onChange` | `{ selectedId }` — the id of the newly selected option |
-| `FilterChips` | `onChange` | `{ selectedIds }` — the **array** of option ids selected *after* the tap (honors `multiSelect`) |
+| `DatePicker` | `onChange` | `{ value }` — unix **seconds**, string-encoded |
+| `OtpInput` | `onChange`, `onComplete` | `{ value }` — the assembled code (dispatched on React Native today; the other renderers show the boxes read-only) |
+| `ChipsInput` | `onRemove` | `{ value }` — the removed chip |
 | `Button` / `ListItem` | `action` / `onTap` | exactly the descriptor's `params` (no injected value) |
 
+The payload rides in **`args`**. Some arms also mirror it into `params`; that is permitted only
+for string-encoded values, because `Action.params` is `map<string,string>` in the proto. Every
+host merges `{...params, ...args}` (args winning) before invoking the reducer, so a worker sees
+one object either way.
+
+> **Not every arm honors this yet.** The table above is the *contract*, not a report of current
+> behaviour — several controls diverge per renderer today (web's `Toggle`, `Slider` and
+> `SelectionControl` inject nothing; `DatePicker` differs on three arms; `Rating` ships three
+> encodings). The platform keeps a machine-checked record of what each arm actually does, and
+> what is still outstanding, in its action-payload contract — a cross-renderer parity gate holds
+> the two in step. Until that divergence list is empty, defensive reducers
+> (`String(p?.value ?? p?.text ?? "")`) remain the safe way to read a payload.
+
 So a text-input reducer is `setDraft: (s, { value }) => ({ ...s, draft: value })`, bound with `onChange: { actionId: "tier5.notes.setDraft" }`.
 
 **Per-row actions carry `$item` fields.** In a bound list/grid, `$item.<field>` substitutes into an action's `params` per row — so a per-row delete is `action: { actionId: "tier5.notes.remove", params: { id: "$item.id" } }`, and the reducer reads `remove: (s, { id }) => …`. (`$item` also substitutes into any prop string, e.g. `text: "$item.title"`.)
 
-> These payload shapes are the SDUI protocol contract (verified against the reference web renderer); iOS/Android honor the same shape (parity).
+> These payload shapes are the SDUI protocol contract. Parity across the four renderers is
+> enforced by a gate that reads the action-payload contract, which also records every arm that
+> does not conform yet — this line previously asserted a parity that did not hold.
 
 ### 2. Build the bundle
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.819.0",
+  "version": "0.820.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": [
@@ -63,5 +63,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "9904e31a5fc7489d78a6e0ca31e3ec4db753c28ec23f75d302115502"
+  "falconPackageHash": "043a4884aa2e1dd120db9847ffc6bd72eee22779ef9556c5a0386f14"
 }