@wix/himalaya-cli 0.1456.0 → 0.1458.0

package/guides/component-reference.json

@@ -6,7 +6,10 @@
   "notImplementedComponents": [
     "Text",
     "Icon",
+    "Carousel",
+    "Pager",
     "Snackbar",
+    "WebView",
     "Slider",
     "SelectionControl",
     "ActivityIndicator",
@@ -509,14 +512,38 @@
       "bindings": [
         "itemsPath"
       ],
-      "propsSource": "export interface CarouselProps {\n  items: Component[];\n  currentIndex?: number;\n  onChange?: Action;\n  autoplayIntervalMs?: number;\n  /** `$service:` binding → a live array to render as slides (overrides `items`). */\n  itemsPath?: string;\n}"
+      "notImplemented": {
+        "props": [
+          "liveWindow"
+        ],
+        "platforms": [
+          "ios",
+          "android",
+          "web"
+        ],
+        "severity": "styling",
+        "note": "Declared ahead of its runtime: every page stays mounted until Pager/Carousel live_window lands on each renderer (W8, #4630)."
+      },
+      "propsSource": "export interface CarouselProps {\n  items: Component[];\n  currentIndex?: number;\n  onChange?: Action;\n  autoplayIntervalMs?: number;\n  /** `$service:` binding → a live array to render as slides (overrides `items`). */\n  itemsPath?: string;\n  /** 0 (default) = all slides mounted; N ⇒ mount current ± N, unmount the rest. */\n  liveWindow?: number;\n}"
     },
     {
       "name": "Pager",
       "category": "Navigation primitives",
       "propsType": "PagerProps",
       "bindings": [],
-      "propsSource": "export interface PagerProps {\n  pages: Component[];\n  currentIndex?: number;\n  onChange?: Action;\n  showIndicator?: boolean;\n}"
+      "notImplemented": {
+        "props": [
+          "liveWindow"
+        ],
+        "platforms": [
+          "ios",
+          "android",
+          "web"
+        ],
+        "severity": "styling",
+        "note": "Declared ahead of its runtime: every page stays mounted until Pager/Carousel live_window lands on each renderer (W8, #4630)."
+      },
+      "propsSource": "export interface PagerProps {\n  pages: Component[];\n  currentIndex?: number;\n  onChange?: Action;\n  showIndicator?: boolean;\n  /** As {@link CarouselProps.liveWindow}. */\n  liveWindow?: number;\n}"
     },
     {
       "name": "StepIndicator",
@@ -589,7 +616,25 @@
       "category": "Embeddable WebView (web-in-SDUI)",
       "propsType": "WebViewProps",
       "bindings": [],
-      "propsSource": "export interface WebViewProps {\n  url?: string;\n  /** Inline HTML to load instead of `url` (mutually exclusive). */\n  inlineHtml?: string;\n  /** Fixed height in points/dp; set this OR `aspectRatio`. */\n  height?: number;\n  /** width:height ratio; used when `height` is unset. */\n  aspectRatio?: number;\n  /** Keep the WebView's own scrolling (default false). */\n  scrollEnabled?: boolean;\n  config?: WebViewConfig;\n  capabilitiesRequired?: string[];\n}"
+      "notImplemented": {
+        "props": [
+          "bridge",
+          "instanceId",
+          "activePath",
+          "mutedPath",
+          "reloadKeyPath",
+          "heightPath",
+          "fill"
+        ],
+        "platforms": [
+          "ios",
+          "android",
+          "web"
+        ],
+        "severity": "styling",
+        "note": "The embedded worker-bridged WebView contract is declared ahead of its runtime: no channel, instance identity, fill layout, bound height or active/muted/reload binding until the hosts implement it (iOS/macOS #4624/#4625, Android #4626/#4627, web #4628/#4629)."
+      },
+      "propsSource": "export interface WebViewProps {\n  url?: string;\n  /** Inline HTML to load instead of `url` (mutually exclusive). */\n  inlineHtml?: string;\n  /** Fixed height in points/dp; set this OR `aspectRatio`. */\n  height?: number;\n  /** width:height ratio; used when `height` is unset. */\n  aspectRatio?: number;\n  /** Keep the WebView's own scrolling (default false). */\n  scrollEnabled?: boolean;\n  config?: WebViewConfig;\n  capabilitiesRequired?: string[];\n  // Embedded worker-bridged WebViews\n  /** `\"\"` (default, no channel) | `\"worker\"` — channel to the owning screen's worker. */\n  bridge?: \"\" | \"worker\";\n  /** Channel + storage identity; default `<screenId>?<args>/<Component.id>` (§4.1, `effectiveWebViewInstanceId`). */\n  instanceId?: string;\n  /** `$service:` bool — false ⇒ inactive (§5.4); unset ⇒ active. */\n  activePath?: string;\n  /** `$service:` bool — true ⇒ all page media muted. */\n  mutedPath?: string;\n  /** `$service:` scalar — any change remounts the document. */\n  reloadKeyPath?: string;\n  /** Take the parent's proposed size (works with weight); beats `height` / `aspectRatio`. */\n  fill?: boolean;\n  /** `$service:` number — live height in points/dp; beats `height`. */\n  heightPath?: string;\n}"
     },
     {
       "name": "ListItem",
@@ -1360,13 +1405,14 @@
       "notImplemented": {
         "props": [
           "anchorDatePath",
-          "onRangeChange"
+          "onRangeChange",
+          "onCreate"
         ],
         "platforms": [
           "android"
         ],
         "severity": "category",
-        "note": "`anchorDatePath` does not bind and `onRangeChange` never fires."
+        "note": "`anchorDatePath` does not bind, and `onRangeChange` and `onCreate` never fire."
       },
       "propsSource": "export interface TimeGridProps {\n  mode?: \"day\" | \"3day\" | \"week\";\n  anchorDate?: string;\n  anchorDatePath?: string;\n  events?: CalendarEvent[];\n  eventsPath?: string;\n  startHour?: number;\n  endHour?: number;\n  firstWeekday?: number;\n  showNowLine?: boolean;\n  onSelectEvent?: Action;\n  onRangeChange?: Action;\n  /** Per-event body, `$item.*`-substituted per event. Absent ⇒ the built-in block. */\n  eventTemplate?: Component;\n  /** RESOURCE lanes: staff, rooms, chairs, courts. Overlap packing already splits\n   *  concurrent events into ANONYMOUS sub-columns; lanes make a column MEAN\n   *  something. Single-day modes only — a week of resource columns is a 2-D grid\n   *  that does not fit a phone, so `mode: \"week\"` ignores them. */\n  resources?: TimeGridResource[];\n  resourcesPath?: string;\n  /** EDITING. Opt-in, default off, so no existing read-only\n   *  grid can regress into one that moves bookings when a user meant to scroll. */\n  editable?: boolean;\n  /** Snap grid in minutes (default 15). A drag landing on 10:07 is almost never\n   *  what anyone meant, and no scheduling system accepts it. */\n  snapMinutes?: number;\n  /** Moved or resized → args{id, start, end}. The component REPORTS; the worker\n   *  decides. An edit that must be rejected has to be able to fail. */\n  onEventChange?: Action;\n  /** Empty space long-pressed → args{start, end} for one `snapMinutes` slot. */\n  onCreate?: Action;\n  /** Labels for the non-drag equivalents. Drag is unreachable by VoiceOver,\n   *  TalkBack and keyboard, so these are how editing stays operable at all. */\n  moveActionLabel?: string;\n  resizeActionLabel?: string;\n}"
     },

package/guides/component-reference.md

@@ -118,16 +118,19 @@ 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: 16 of 86 components, all of them android / web / ios-only** — every other component/platform pair reads every prop it decodes. The list splits in two, and the halves mean different things:
+**Scope: 19 of 86 components, all of them android / web / ios-only** — every other component/platform pair reads every prop it decodes. The list splits in two, and the halves mean different things:
 
 - **`category` (7: `Menu`, `Tooltip`, `Popover`, `ChipsInput`, `OtpInput`, `MediaPlayer`, `TimeGrid`)** — 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.
-- **`styling` (9: `Text`, `Icon`, `Snackbar`, `Slider`, `SelectionControl`, `ActivityIndicator`, `Video`, `PdfView`, `Agenda`)** — 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.
+- **`styling` (12: `Text`, `Icon`, `Carousel`, `Pager`, `Snackbar`, `WebView`, `Slider`, `SelectionControl`, `ActivityIndicator`, `Video`, `PdfView`, `Agenda`)** — 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.
 
 | Component | Unread props | Platform | Kind | Note |
 |---|---|---|---|---|
 | `Text` | `minimumScaleFactor`, `truncation` | android, web | styling | Compose 1.7.5 and web retain tail truncation and their existing text size. Monospaced digits work; Apple supports shrinking and head/middle truncation. React Native maps its native text API, with Android multiline ellipsis limited to tail. |
 | `Icon` | `renderingMode`, `weight`, `variableValue` | android, web | styling | Fixed catalog vectors have no SF layers, font-weight axis or variable fills. Bounce and pulse animate the whole glyph; variableColor remains static. React Native uses the same catalog fallback. |
+| `Carousel` | `liveWindow` | ios, android, web | styling | Declared ahead of its runtime: every page stays mounted until Pager/Carousel live_window lands on each renderer (W8, #4630). |
+| `Pager` | `liveWindow` | ios, android, web | styling | Declared ahead of its runtime: every page stays mounted until Pager/Carousel live_window lands on each renderer (W8, #4630). |
 | `Snackbar` | `durationMs` | ios, android, web | styling | The Snackbar component renders inline, so `durationMs` does nothing (the `snackbar` presentation verb is the working toast). |
+| `WebView` | `bridge`, `instanceId`, `activePath`, `mutedPath`, `reloadKeyPath`, `heightPath`, `fill` | ios, android, web | styling | The embedded worker-bridged WebView contract is declared ahead of its runtime: no channel, instance identity, fill layout, bound height or active/muted/reload binding until the hosts implement it (iOS/macOS #4624/#4625, Android #4626/#4627, web #4628/#4629). |
 | `Slider` | `debounceMs` | ios, web | styling | `debounceMs` does not throttle onChange. |
 | `SelectionControl` | `groupId` | android, web | styling | Radios sharing a `groupId` are not mutually exclusive. |
 | `ActivityIndicator` | `ring` | ios, android, web | styling | The `ring` style is never selected (determinate vs indeterminate follows `value`). |
@@ -143,7 +146,7 @@ These props are accepted by the schema and pass validation, but the named platfo
 | `MediaPlayer` | `autoplayVisibilityThreshold`, `preload`, `playbackRates`, `showQueue`, `showChapters`, `showTranscript` | ios | category | `autoplayVisibilityThreshold` is ignored (whenVisible = once on appear). `preload` is ignored. `playbackRates` is ignored, and the queue/chapters/transcript panels never render. |
 | `MediaPlayer` | `externalPlayback`, `appearance`, `allowCellular`, `preload`, `playbackRates`, `showQueue`, `showChapters`, `showTranscript` | android | category | `externalPlayback` is forced off. `appearance` is ignored. `allowCellular` is ignored. `preload` is ignored. `playbackRates` is ignored, and the queue/chapters/transcript panels never render. |
 | `MediaPlayer` | `allowCellular`, `forwardSkipSeconds`, `backwardSkipSeconds`, `playbackRates`, `showQueue`, `showChapters`, `showTranscript` | web | category | `allowCellular` is ignored. Skip buttons ignore `forwardSkipSeconds`/`backwardSkipSeconds`. `playbackRates` is ignored, and the queue/chapters/transcript panels never render. |
-| `TimeGrid` | `anchorDatePath`, `onRangeChange` | android | category | `anchorDatePath` does not bind and `onRangeChange` never fires. |
+| `TimeGrid` | `anchorDatePath`, `onRangeChange`, `onCreate` | android | category | `anchorDatePath` does not bind, and `onRangeChange` and `onCreate` never fire. |
 | `Agenda` | `stickyHeaders` | android | styling | Day headers do not pin. |
 
 ## Token slots: `TokenRef` object vs bare `TokenName` string
@@ -1034,9 +1037,13 @@ export interface CarouselProps {
   autoplayIntervalMs?: number;
   /** `$service:` binding → a live array to render as slides (overrides `items`). */
   itemsPath?: string;
+  /** 0 (default) = all slides mounted; N ⇒ mount current ± N, unmount the rest. */
+  liveWindow?: number;
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on ios, android, web:** `liveWindow` — Declared ahead of its runtime: every page stays mounted until Pager/Carousel live_window lands on each renderer (W8, #4630).
+
 #### Pager
 
 ```ts
@@ -1045,9 +1052,13 @@ export interface PagerProps {
   currentIndex?: number;
   onChange?: Action;
   showIndicator?: boolean;
+  /** As {@link CarouselProps.liveWindow}. */
+  liveWindow?: number;
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on ios, android, web:** `liveWindow` — Declared ahead of its runtime: every page stays mounted until Pager/Carousel live_window lands on each renderer (W8, #4630).
+
 #### StepIndicator
 
 ```ts
@@ -1191,9 +1202,26 @@ export interface WebViewProps {
   scrollEnabled?: boolean;
   config?: WebViewConfig;
   capabilitiesRequired?: string[];
+  // Embedded worker-bridged WebViews
+  /** `""` (default, no channel) | `"worker"` — channel to the owning screen's worker. */
+  bridge?: "" | "worker";
+  /** Channel + storage identity; default `<screenId>?<args>/<Component.id>` (§4.1, `effectiveWebViewInstanceId`). */
+  instanceId?: string;
+  /** `$service:` bool — false ⇒ inactive (§5.4); unset ⇒ active. */
+  activePath?: string;
+  /** `$service:` bool — true ⇒ all page media muted. */
+  mutedPath?: string;
+  /** `$service:` scalar — any change remounts the document. */
+  reloadKeyPath?: string;
+  /** Take the parent's proposed size (works with weight); beats `height` / `aspectRatio`. */
+  fill?: boolean;
+  /** `$service:` number — live height in points/dp; beats `height`. */
+  heightPath?: string;
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on ios, android, web:** `bridge`, `instanceId`, `activePath`, `mutedPath`, `reloadKeyPath`, `heightPath`, `fill` — The embedded worker-bridged WebView contract is declared ahead of its runtime: no channel, instance identity, fill layout, bound height or active/muted/reload binding until the hosts implement it (iOS/macOS #4624/#4625, Android #4626/#4627, web #4628/#4629).
+
 ### Controls & cells
 
 #### ListItem
@@ -2237,7 +2265,7 @@ export interface TimeGridProps {
 }
 ```
 
-> ⚠️ **Not implemented on android:** `anchorDatePath`, `onRangeChange` — `anchorDatePath` does not bind and `onRangeChange` never fires.
+> ⚠️ **Not implemented on android:** `anchorDatePath`, `onRangeChange`, `onCreate` — `anchorDatePath` does not bind, and `onRangeChange` and `onCreate` never fire.
 
 #### Agenda
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1456.0",
+  "version": "0.1458.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": [
@@ -71,5 +71,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "6a9425d0ac743f2ada10d1e2e6c84f4ef1ce790732d9fff33a36c315"
+  "falconPackageHash": "9dd290be2b59a0845d75b156a968a16e615c0d3de4e9dc4a0f01cda6"
 }