@wix/himalaya-cli 0.1189.0 → 0.1190.0

package/dist/cli.mjs

@@ -6818,6 +6818,7 @@ function walk(node, registry, path2, out2) {
 var SYSTEM_FONT_FAMILY, TONAL_ELEVATION_ALPHA, COLOR_TOKEN_PROPS, TYPOGRAPHY_TOKEN_PROPS;
 var init_tokens = __esm({
   "../../core/ts/src/tokens.ts"() {
+    "use strict";
     SYSTEM_FONT_FAMILY = "$system";
     TONAL_ELEVATION_ALPHA = [0, 0.05, 0.08, 0.11, 0.12, 0.14];
     COLOR_TOKEN_PROPS = {
@@ -25224,6 +25225,7 @@ function shouldRevealError(args) {
 var EMAIL_RE, URL_HOST_RE, INTEGER_RE, NUMBER_RE;
 var init_validation = __esm({
   "../../core/ts/src/validation.ts"() {
+    "use strict";
     EMAIL_RE = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}$/;
     URL_HOST_RE = /^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*(:[0-9]+)?$/;
     INTEGER_RE = /^[+-]?[0-9]+$/;
@@ -25883,6 +25885,7 @@ function validateWorkerSubtree(raw, slotId, policy, actionCatalog) {
 var WORKER_SUBTREE_CEILINGS, ID_PART, ACTION_ID;
 var init_worker_subtree = __esm({
   "../../core/ts/src/worker-subtree.ts"() {
+    "use strict";
     init_worker_subtree_safe_types_generated();
     WORKER_SUBTREE_CEILINGS = Object.freeze({
       maxEncodedBytes: 65536,

package/guides/component-reference.json

@@ -4,11 +4,16 @@
   "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": 84,
   "notImplementedComponents": [
-    "FieldError",
+    "Text",
     "Picker",
     "Tabs",
+    "Carousel",
+    "CollapsingHeader",
+    "Banner",
     "Snackbar",
+    "WebView",
     "Slider",
+    "SelectionControl",
     "ActivityIndicator",
     "BottomSheet",
     "Menu",
@@ -16,7 +21,12 @@
     "Popover",
     "ChipsInput",
     "OtpInput",
-    "Video"
+    "Map",
+    "Video",
+    "PdfView",
+    "MediaPlayer",
+    "TimeGrid",
+    "Agenda"
   ],
   "components": [
     {
@@ -100,6 +110,17 @@
       "bindings": [
         "text"
       ],
+      "notImplemented": {
+        "props": [
+          "textDirection",
+          "animateReveal"
+        ],
+        "platforms": [
+          "web"
+        ],
+        "severity": "styling",
+        "note": "`textDirection` sets no `dir`. `animateReveal` does not animate."
+      },
       "propsSource": "export type TextProps = TextContent & {\n  style?: TokenName;\n  /** Foreground color token (default \"textPrimary\"). */\n  color?: TokenName;\n  /** Tail-truncate after N lines (absent = unlimited). */\n  maxLines?: number;\n  /** Lever D — a live time value (countdown/relative) the OS ticks with no refresh.\n   *  When present it OVERRIDES `text`. Widget-safe render only. */\n  timeRef?: WidgetTimeRef;\n  /** Render `text` as a constrained Markdown subset. */\n  markdown?: boolean;\n  /** Capability enrichments. */\n  textAlign?: \"leading\" | \"center\" | \"trailing\" | \"justify\";\n  /** Base writing direction. \"auto\" (or \"rtl\") makes a bidi paragraph resolve +\n   *  align by its own strong-directional content (Hebrew/Arabic → right-aligned,\n   *  RTL layout), matching per-message direction in chat bubbles. Absent/\"ltr\" =\n   *  the current left-to-right behavior. Both renderers honor it (parity). */\n  textDirection?: \"auto\" | \"ltr\" | \"rtl\";\n  decoration?: \"underline\" | \"strikethrough\";\n  /** EXTRA SPACE BETWEEN LINES, in points/px — added ON TOP of the line height the `style`\n   *  token already sets. It is NOT a multiple: `lineSpacing: 6` means six points of extra\n   *  leading, not six times the font size, and every renderer agrees on that. To\n   *  change the line height as a ratio of the font size, set the typography token's `line`\n   *  instead; that is where a body style's 1.4/1.7 lives. Absent/0 = the token's own line\n   *  height, which is the right answer for almost every screen. */\n  lineSpacing?: number;\n  /** Per-item gate (usually an `$item.` field pre-substituted per row): when it\n   *  resolves empty, the text collapses to zero size instead of taking layout. */\n  collapseWhenEmpty?: boolean;\n  /** Motion grammar (Batch 1, item 4) — count-up tween for a numeric value on\n   *  change; non-numeric values render instantly. Gated by reduced motion. */\n  animateValue?: boolean;\n  /** Motion grammar — reveal the (post-substitution literal) text word-by-word,\n   *  once per distinct content, like a chat assistant \"typing\" its reply. Each\n   *  content animates a single time (progress is remembered), so list re-renders\n   *  and scrolls don't restart it. Gated by reduced motion (snaps to full).\n   *  Both renderers honor it (parity). Default nil/false. */\n  animateReveal?: boolean;\n};"
     },
     {
@@ -295,16 +316,6 @@
       "bindings": [
         "textPath"
       ],
-      "notImplemented": {
-        "props": [
-          "severity"
-        ],
-        "platforms": [
-          "ios"
-        ],
-        "severity": "styling",
-        "note": "`severity: \"warning\"` still paints `danger` red."
-      },
       "propsSource": "export interface FieldErrorProps {\n  /** LITERAL - every renderer paints this verbatim. Bind `textPath` instead. */\n  text: string;\n  severity?: \"error\" | \"warning\";\n  /** `$service:`/`$item.` binding -> the error text. Overrides `text`; resolving\n   *  to empty COLLAPSES the node, so one `FieldError` can sit permanently in the\n   *  tree and appear only when it has something to say (the same contract as\n   *  `TextProps.collapseWhenEmpty`). Before this, `FieldError` could not show\n   *  worker state at all, so apps hand-rolled a danger-colored `Text` instead. */\n  textPath?: string;\n  /** Explicit visibility override; `false` collapses the node. */\n  visible?: boolean;\n}"
     },
     {
@@ -339,7 +350,7 @@
           "ios"
         ],
         "severity": "styling",
-        "note": "`optionsPath` does not bind options; `placeholder` is not shown."
+        "note": "Standalone Picker: `optionsPath` does not bind (it does inside a FormField); `placeholder` is only the accessible name, never shown."
       },
       "propsSource": "export interface PickerProps {\n  options: PickerOption[];\n  selectedId?: string;\n  onChange?: Action;\n  placeholder?: string;\n  /** \"$service:\" sentinel → worker array of {id,label}; `options` is the fallback. */\n  optionsPath?: string;\n}"
     },
@@ -464,7 +475,6 @@
       "propsType": "TabsProps",
       "bindings": [
         "optionsPath",
-        "activeColorPath",
         "selectedId"
       ],
       "dispatches": [
@@ -474,16 +484,39 @@
           "encoding": "string"
         }
       ],
-      "notImplemented": {
-        "props": [
-          "style"
-        ],
-        "platforms": [
-          "ios"
-        ],
-        "severity": "styling",
-        "note": "The tab bar itself renders — only `style` is inert: `swipe` still renders as top tabs."
-      },
+      "notImplemented": [
+        {
+          "props": [
+            "style"
+          ],
+          "platforms": [
+            "ios"
+          ],
+          "severity": "styling",
+          "note": "`style: \"swipe\"` renders as plain top tabs."
+        },
+        {
+          "props": [
+            "activeColorPath"
+          ],
+          "platforms": [
+            "android"
+          ],
+          "severity": "styling",
+          "note": "`activeColorPath` does not tint the active tab."
+        },
+        {
+          "props": [
+            "activeColorPath",
+            "style"
+          ],
+          "platforms": [
+            "web"
+          ],
+          "severity": "styling",
+          "note": "`activeColorPath` does not tint the active tab. `style: \"swipe\"` renders as plain top tabs."
+        }
+      ],
       "propsSource": "export interface TabsProps {\n  tabs: TabItem[];\n  /** Literal id, or a binding-aware `$service:`/`$item.` live selection. */\n  selectedId: string;\n  onChange?: Action;\n  style?: \"top\" | \"swipe\";\n  /** `$service:` binding → a live tabs array (overrides `tabs`). */\n  optionsPath?: string;\n  /** `$service:` binding → a token name for the active-tab color. */\n  activeColorPath?: string;\n}"
     },
     {
@@ -510,6 +543,17 @@
       "bindings": [
         "itemsPath"
       ],
+      "notImplemented": {
+        "props": [
+          "autoplayIntervalMs"
+        ],
+        "platforms": [
+          "android",
+          "web"
+        ],
+        "severity": "styling",
+        "note": "No autoplay."
+      },
       "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}"
     },
     {
@@ -531,6 +575,30 @@
       "category": "Navigation primitives",
       "propsType": "CollapsingHeaderProps",
       "bindings": [],
+      "notImplemented": [
+        {
+          "props": [
+            "imageAsset",
+            "collapsedHeight",
+            "parallaxFactor"
+          ],
+          "platforms": [
+            "web"
+          ],
+          "severity": "styling",
+          "note": "A static hero: `imageAsset`, `collapsedHeight` and `parallaxFactor` are inert (only `imageUrl` is read)."
+        },
+        {
+          "props": [
+            "imageAsset"
+          ],
+          "platforms": [
+            "android"
+          ],
+          "severity": "styling",
+          "note": "`imageAsset` (a baked asset name) is not resolved — only `imageUrl` paints the hero."
+        }
+      ],
       "propsSource": "export interface CollapsingHeaderProps {\n  /** Hero image URL (`$service:`-resolvable upstream). */\n  imageUrl?: string;\n  /** Bundle asset fallback. */\n  imageAsset?: string;\n  /** Required; scales & fades with collapse. */\n  title: string;\n  subtitle?: string;\n  /** Initial height in points (default 280). */\n  expandedHeight?: number;\n  /** Final height when fully scrolled (default 64). */\n  collapsedHeight?: number;\n  /** Body content that scrolls under the header. */\n  children?: Component[];\n  /** 0.0 = static, 1.0 = full parallax (default 0.5). */\n  parallaxFactor?: number;\n}"
     },
     {
@@ -550,6 +618,16 @@
         "title",
         "message"
       ],
+      "notImplemented": {
+        "props": [
+          "dismissible"
+        ],
+        "platforms": [
+          "web"
+        ],
+        "severity": "styling",
+        "note": "No dismiss control."
+      },
       "propsSource": "export interface BannerProps {\n  severity: Severity;\n  /** Banner headline — binding-aware (\"$item.\"/\"$service:\") on web, iOS and Android. */\n  title: string;\n  /** Banner body — binding-aware (\"$item.\"/\"$service:\") on web, iOS and Android. */\n  message?: string;\n  action?: Action;\n  dismissible?: boolean;\n  /** #1059 — action label; overridable for localized hosts. Default \"Take action\". */\n  actionLabel?: string;\n}"
     },
     {
@@ -562,10 +640,12 @@
           "durationMs"
         ],
         "platforms": [
-          "ios"
+          "ios",
+          "android",
+          "web"
         ],
         "severity": "styling",
-        "note": "`durationMs` does not control the auto-dismiss timeout."
+        "note": "The Snackbar component renders inline, so `durationMs` does nothing (the `snackbar` presentation verb is the working toast)."
       },
       "propsSource": "export interface SnackbarProps {\n  message: string;\n  action?: Action;\n  durationMs?: number;\n  severity?: Severity;\n  /** #1059 — action label; overridable for localized hosts. Default \"Take action\". */\n  actionLabel?: string;\n}"
     },
@@ -588,6 +668,17 @@
       "category": "Embeddable WebView (web-in-SDUI)",
       "propsType": "WebViewProps",
       "bindings": [],
+      "notImplemented": {
+        "props": [
+          "scrollEnabled",
+          "config"
+        ],
+        "platforms": [
+          "web"
+        ],
+        "severity": "styling",
+        "note": "The iframe always scrolls. `config` (the native WebView options: cookies, bridge, zoom…) is not applied to the iframe."
+      },
       "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}"
     },
     {
@@ -641,10 +732,11 @@
           "debounceMs"
         ],
         "platforms": [
-          "ios"
+          "ios",
+          "web"
         ],
         "severity": "styling",
-        "note": "`debounceMs` does not throttle the onChange stream."
+        "note": "`debounceMs` does not throttle onChange."
       },
       "propsSource": "export interface SliderProps {\n  value?: number;\n  min?: number;\n  max?: number;\n  /** 0 = continuous; >0 snaps. */\n  step?: number;\n  onChange?: Action;\n  /** Two-thumb range mode. */\n  range?: boolean;\n  upperValue?: number;\n  /** \"$service:\"/\"$item.\" binding → number (overrides `value`). */\n  valuePath?: string;\n  tint?: TokenName;\n  debounceMs?: number;\n  disabled?: boolean;\n}"
     },
@@ -680,6 +772,17 @@
           ]
         }
       ],
+      "notImplemented": {
+        "props": [
+          "groupId"
+        ],
+        "platforms": [
+          "android",
+          "web"
+        ],
+        "severity": "styling",
+        "note": "Radios sharing a `groupId` are not mutually exclusive."
+      },
       "propsSource": "export interface SelectionControlProps {\n  label?: string;\n  value?: boolean;\n  kind?: \"checkbox\" | \"radio\";\n  /** Radios sharing a `groupId` are mutually exclusive. */\n  groupId?: string;\n  onChange?: Action;\n  /** \"$service:\"/\"$item.\" binding → bool (overrides `value`). */\n  valuePath?: string;\n  disabled?: boolean;\n  /** Checkbox tri-state (renders a dash); ignored for radio. */\n  indeterminate?: boolean;\n}"
     },
     {
@@ -694,10 +797,12 @@
           "ring"
         ],
         "platforms": [
-          "ios"
+          "ios",
+          "android",
+          "web"
         ],
         "severity": "styling",
-        "note": "The `ring` style is decoded but never selected."
+        "note": "The `ring` style is never selected (determinate vs indeterminate follows `value`)."
       },
       "propsSource": "export interface ActivityIndicatorProps {\n  /** 0..1 (determinate); ignored when `indeterminate`. */\n  value?: number;\n  /** `$service:`/`$item.` binding → a live 0..1 fraction (overrides `value`). */\n  valuePath?: string;\n  indeterminate?: boolean;\n  size?: number;\n  tint?: TokenName;\n  /** Determinate ring vs. arc spinner. */\n  ring?: boolean;\n}"
     },
@@ -705,22 +810,45 @@
       "name": "BottomSheet",
       "category": "Overlays & menus",
       "propsType": "BottomSheetProps",
-      "bindings": [],
-      "notImplemented": {
-        "props": [
-          "detents",
-          "dismissible",
-          "onDismiss",
-          "presented",
-          "presentedPath",
-          "edge"
-        ],
-        "platforms": [
-          "ios"
-        ],
-        "severity": "category",
-        "note": "Presentation is not implemented — BottomSheet renders as an always-visible inline surface, never a dismissible sheet. All six presentation props are dead. Use the WORKING alternative instead: present the content as its own screen with `presentation: \"sheet\"` on the navigating `Action` — that is a real dismissible sheet on every platform. Reach for BottomSheet only when an always-visible inline surface is what you actually want."
-      },
+      "bindings": [
+        "presentedPath"
+      ],
+      "notImplemented": [
+        {
+          "props": [
+            "edge"
+          ],
+          "platforms": [
+            "ios"
+          ],
+          "severity": "category",
+          "note": "`edge` (side sheet) is ignored — it always opens from the bottom."
+        },
+        {
+          "props": [
+            "detents",
+            "edge"
+          ],
+          "platforms": [
+            "android"
+          ],
+          "severity": "category",
+          "note": "`detents` are ignored (opens full height). `edge` (side sheet) is ignored — it always opens from the bottom."
+        },
+        {
+          "props": [
+            "detents",
+            "dismissible",
+            "onDismiss",
+            "edge"
+          ],
+          "platforms": [
+            "web"
+          ],
+          "severity": "category",
+          "note": "`detents` are ignored (opens full height). No scrim tap / Escape to close, so `onDismiss` never fires — for a dismissible sheet here, present the content as its own screen with `presentation: \"sheet\"` on the navigating `Action`. `edge` (side sheet) is ignored — it always opens from the bottom."
+        }
+      ],
       "propsSource": "export interface BottomSheetProps {\n  /** Place the sheet as a root-payload sibling (normally the final child), not\n   * inside the trigger row, so its presented overlay can cover the whole screen. */\n  content?: Component;\n  /** Fractional heights, e.g. [0.3, 0.9]. */\n  detents?: number[];\n  dismissible?: boolean;\n  showGrabber?: boolean;\n  onDismiss?: Action;\n  presented?: boolean;\n  /** \"$service:\" binding → bool (overrides `presented`). */\n  presentedPath?: string;\n  edge?: \"bottom\" | \"leading\" | \"trailing\";\n  /** The overlay traps focus and hides the rest of the tree from AT while\n   *  presented (iOS `accessibilityViewIsModal`, Android `isTraversalGroup`, ARIA\n   *  `aria-modal`). TRI-STATE: absent takes this component's default (**true**), an\n   *  explicit `false` opts it out. */\n  modal?: boolean;\n}"
     },
     {
@@ -728,17 +856,30 @@
       "category": "Overlays & menus",
       "propsType": "MenuProps",
       "bindings": [],
-      "notImplemented": {
-        "props": [
-          "style",
-          "itemsPath"
-        ],
-        "platforms": [
-          "ios"
-        ],
-        "severity": "category",
-        "note": "`action_sheet`/`context` render as an always-open inline list; `itemsPath` does not bind items."
-      },
+      "notImplemented": [
+        {
+          "props": [
+            "itemsPath"
+          ],
+          "platforms": [
+            "ios"
+          ],
+          "severity": "category",
+          "note": "`itemsPath` does not bind items."
+        },
+        {
+          "props": [
+            "style",
+            "itemsPath"
+          ],
+          "platforms": [
+            "android",
+            "web"
+          ],
+          "severity": "category",
+          "note": "`style` is ignored — `context`/`action_sheet` render as a dropdown. `itemsPath` does not bind items."
+        }
+      ],
       "propsSource": "export interface MenuProps {\n  anchor?: Component;\n  items?: MenuItem[];\n  style?: \"dropdown\" | \"context\" | \"action_sheet\";\n  /** \"$service:\" binding → MenuItem[]. */\n  itemsPath?: string;\n  /** The overlay traps focus and hides the rest of the tree from AT while\n   *  presented (iOS `accessibilityViewIsModal`, Android `isTraversalGroup`, ARIA\n   *  `aria-modal`). TRI-STATE: absent takes the Menu's default — MODAL,\n   *  from the one shared overlay default table — and an explicit `false` opts out. */\n  modal?: boolean;\n}"
     },
     {
@@ -753,10 +894,12 @@
           "onDismiss"
         ],
         "platforms": [
-          "ios"
+          "ios",
+          "android",
+          "web"
         ],
         "severity": "category",
-        "note": "Not an overlay — renders always-expanded inline; `trigger` and dismissal are inert."
+        "note": "Not an overlay — renders always-expanded inline; `edge`, `trigger` and dismissal are inert."
       },
       "propsSource": "export interface TooltipProps {\n  anchor?: Component;\n  text?: string;\n  /** Present → rich tooltip. */\n  title?: string;\n  edge?: \"top\" | \"bottom\" | \"leading\" | \"trailing\" | \"auto\";\n  trigger?: \"tap\" | \"long_press\" | \"auto\";\n  onDismiss?: Action;\n}"
     },
@@ -775,7 +918,7 @@
           "ios"
         ],
         "severity": "category",
-        "note": "Presentation follows `presented` / `presentedPath` (a gated popover shows its bubble only while presented, and is modal then), but the bubble is drawn in the screen's flow under its anchor, not floating over it: `edge` placement is not implemented. It closes when its gate closes, or on the VoiceOver escape gesture, which fires `onDismiss` so a worker can clear the gate."
+        "note": "The bubble is drawn in flow under its anchor; `edge` placement is not implemented."
       },
       "propsSource": "export interface PopoverProps {\n  anchor?: Component;\n  content?: Component;\n  edge?: \"top\" | \"bottom\" | \"leading\" | \"trailing\" | \"auto\";\n  presented?: boolean;\n  presentedPath?: string;\n  onDismiss?: Action;\n  /** The overlay traps focus and hides the rest of the tree from AT while\n   *  presented (iOS `accessibilityViewIsModal`, Android `isTraversalGroup`, ARIA\n   *  `aria-modal`). TRI-STATE: absent takes the Popover's default — MODAL,\n   *  from the one shared overlay default table — and an explicit `false` opts out. Applies to a\n   *  popover presented through `presented` / `presentedPath`; one with neither is an\n   *  inline callout, and never modal. */\n  modal?: boolean;\n}"
     },
@@ -818,9 +961,11 @@
           "onAdd"
         ],
         "platforms": [
-          "ios"
+          "ios",
+          "android",
+          "web"
         ],
-        "severity": "styling",
+        "severity": "category",
         "note": "`onAdd` never dispatches."
       },
       "propsSource": "export interface ChipsInputProps {\n  values?: string[];\n  /** \"$service:\" binding → string[]. */\n  valuesPath?: string;\n  placeholder?: string;\n  onAdd?: Action;\n  onRemove?: Action;\n  disabled?: boolean;\n}"
@@ -1139,14 +1284,16 @@
       ],
       "notImplemented": {
         "props": [
-          "onChange",
-          "onComplete"
+          "onComplete",
+          "onChange"
         ],
         "platforms": [
-          "ios"
+          "ios",
+          "android",
+          "web"
         ],
-        "severity": "styling",
-        "note": "Neither callback dispatches."
+        "severity": "category",
+        "note": "Neither `onChange` nor `onComplete` dispatches."
       },
       "propsSource": "export interface OtpInputProps {\n  length?: number;\n  /** LITERAL code. A `$service:` sentinel here paints the raw token into the\n   *  boxes — bind `valuePath` instead. */\n  value?: string;\n  /** `$service:`/`$item.` binding → the live code (overrides `value`), so a\n   *  worker that clears it after submit empties the boxes. */\n  valuePath?: string;\n  onChange?: Action;\n  onComplete?: Action;\n  secure?: boolean;\n}"
     },
@@ -1167,6 +1314,17 @@
         "cameraPath",
         "shapesPath"
       ],
+      "notImplemented": {
+        "props": [
+          "followUserLocation"
+        ],
+        "platforms": [
+          "android",
+          "web"
+        ],
+        "severity": "styling",
+        "note": "`followUserLocation` does not track."
+      },
       "propsSource": "export interface MapProps {\n  latitude?: number;\n  longitude?: number;\n  zoom?: number;\n  markers?: MapMarker[];\n  /** `$service:` binding → a live markers array (overrides `markers`). */\n  markersPath?: string;\n  height?: number;\n  interactive?: boolean;\n  /**\n   * Polyline waypoints — a recorded GPS track, or a delivery route. Drawn in order, so\n   * pass the fixes chronologically (`@himalaya/location`'s `watch()` yields them that way).\n   */\n  route?: MapMarker[];\n  /**\n   * How a `route` is drawn. Default `\"tile\"` — the polyline over REAL map tiles, which is\n   * what a track/navigation screen wants. `\"schematic\"` keeps the normalized,\n   * projection-free mini-map (no tile fetch, so no flicker) that suits a small\n   * delivery/route CARD. Strict enum: a `$service:` binding here fails at render time,\n   * not validation.\n   */\n  routeMode?: \"tile\" | \"schematic\";\n  /** Draw the live device-position dot. Silently inert without location permission. */\n  showUserLocation?: boolean;\n  /** Keep the camera following the user. Implies `showUserLocation`. */\n  followUserLocation?: boolean;\n  /** Frame the viewport to `markers` ∪ `route` instead of `latitude`/`longitude` + `zoom`. */\n  fitToContent?: boolean;\n  /**\n   * Imagery style: `\"standard\"` (default) | `\"satellite\"` | `\"hybrid\"` (satellite + labels).\n   * Strict enum — a `$service:` binding here fails at render, not validation.\n   *\n   * HONORED ON THE MAPKIT SURFACES (iOS + macOS). MapKit ships first-party satellite/hybrid\n   * imagery (MKMapType), and the tile-route arm has a macOS representable, so a Mac gets it too. The Android + web tile arms draw OSM raster tiles, and OSM has no satellite\n   * layer — serving one would mean bundling a third-party imagery provider with its own\n   * attribution terms and usage limits, which is an app's licensing decision rather than the\n   * platform's. Those arms normalize the value and keep drawing standard tiles.\n   *\n   * For satellite/topo on EVERY surface, use the app-scoped `TrailMap` component\n   * and point its `styleUrl` at a vector style you have rights to.\n   */\n  mapStyle?: \"standard\" | \"satellite\" | \"hybrid\";\n  /**\n   * Tap on the map surface. The event payload is merged into the Action's `args` — exactly\n   * like Slider/SelectionControl merge `value` — so a Tier-5 reducer reads\n   * `{latitude, longitude}` with no new dispatch contract.\n   *\n   * Honored on the TILE arms, which have real geography. The schematic mini-map draws a\n   * normalized, projection-free polyline with no meaningful coordinate to report, so it\n   * fires `onMarkerTap` only. `interactive` governs pan/zoom, not taps: a deliberately\n   * non-interactive map still reports them.\n   */\n  onMapTap?: Action;\n  /**\n   * Tap on a marker. `args`: `{index, label?, latitude, longitude}`, where `index` is into\n   * the RESOLVED marker array (`markersPath` when bound, else `markers`) so the worker can\n   * look the item back up in its own state. `label` is OMITTED for an unlabeled pin rather\n   * than sent as `\"\"`. A tap that landed on a pin is a marker tap only — never also a map tap.\n   */\n  onMarkerTap?: Action;\n  /**\n   * Camera settled after a pan/zoom — fired on gesture END, never per frame.\n   * `args`: `{latitude, longitude, zoom, north, south, east, west}`, so a worker can fetch\n   * \"trails in view\" without re-deriving the viewport. Programmatic camera moves\n   * (e.g. a `fitToContent` re-frame) do NOT fire it, or a worker that refetches on region\n   * change would loop against its own camera.\n   */\n  onRegionChange?: Action;\n  /**\n   * `$service:` binding → a live route array (overrides `route`), mirroring `markersPath`.\n   * Without it a growing recorded track had to re-push the whole descriptor for every fix;\n   * with it the polyline follows worker state. Defaults to the TILE arm, not the schematic\n   * one — a bound route is a recorded track, which is why the binding exists.\n   */\n  routePath?: string;\n  /**\n   * `$service:` binding → `{latitude, longitude, zoom}`: the camera, driven by the WORKER.\n   *\n   * `latitude`/`longitude`/`zoom` are numbers, so a `$service:` sentinel cannot go in them —\n   * which meant a worker could not move the camera at all (\"fly to this search result\" was\n   * inexpressible without re-pushing the descriptor).\n   *\n   * Precedence: a resolved `cameraPath` wins, then `fitToContent`, then the static\n   * `latitude`/`longitude`/`zoom`. A NEW value also overrides the user's own pan; an unchanged\n   * one leaves it alone. Applying it is programmatic, so it never echoes back through\n   * `onRegionChange`. Partial objects are honored — `{zoom}` re-zooms in place.\n   */\n  cameraPath?: string;\n  /** Overlays beyond the single `route`: lines, polygons, circles. */\n  shapes?: MapShape[];\n  /** `$service:` binding → a live shapes array (overrides `shapes`). */\n  shapesPath?: string;\n  /**\n   * Tap on a drawn shape. `args`: `{id?, index, kind}`. Hit-tested before the surface and after\n   * markers — a pin on top of a polygon belongs to the pin.\n   */\n  onShapeTap?: Action;\n  /** App-supplied basemap tiles. Absent ⇒ each arm's default (OSM raster, or Apple's imagery). */\n  tileSource?: MapTileSource;\n}"
     },
     {
@@ -1182,7 +1340,7 @@
           "ios"
         ],
         "severity": "styling",
-        "note": "`poster` (pre-play frame) is not shown."
+        "note": "`poster` is not shown."
       },
       "propsSource": "export interface VideoProps {\n  url?: string;\n  poster?: string;\n  autoplay?: boolean;\n  controls?: boolean;\n  loop?: boolean;\n  muted?: boolean;\n  height?: number;\n  aspectRatio?: number;\n}"
     },
@@ -1191,6 +1349,31 @@
       "category": "Cross-cutting & media",
       "propsType": "PdfViewProps",
       "bindings": [],
+      "notImplemented": [
+        {
+          "props": [
+            "showPageControls",
+            "startPage"
+          ],
+          "platforms": [
+            "android"
+          ],
+          "severity": "styling",
+          "note": "No page controls. `startPage` is ignored."
+        },
+        {
+          "props": [
+            "showPageControls",
+            "zoomable",
+            "allowShare"
+          ],
+          "platforms": [
+            "web"
+          ],
+          "severity": "styling",
+          "note": "No page controls. The browser PDF viewer ignores `zoomable` and `allowShare`."
+        }
+      ],
       "propsSource": "export interface PdfViewProps {\n  url?: string;\n  height?: number;\n  showPageControls?: boolean;\n  /** 1-based; 0/absent ⇒ page 1. */\n  startPage?: number;\n  zoomable?: boolean;\n  allowShare?: boolean;\n}"
     },
     {
@@ -1200,6 +1383,56 @@
       "bindings": [
         "itemsPath"
       ],
+      "notImplemented": [
+        {
+          "props": [
+            "autoplayVisibilityThreshold",
+            "preload",
+            "playbackRates",
+            "showQueue",
+            "showChapters",
+            "showTranscript"
+          ],
+          "platforms": [
+            "ios"
+          ],
+          "severity": "category",
+          "note": "`autoplayVisibilityThreshold` is ignored (whenVisible = once on appear). `preload` is ignored. `playbackRates` is ignored, and the queue/chapters/transcript panels never render."
+        },
+        {
+          "props": [
+            "externalPlayback",
+            "appearance",
+            "allowCellular",
+            "preload",
+            "playbackRates",
+            "showQueue",
+            "showChapters",
+            "showTranscript"
+          ],
+          "platforms": [
+            "android"
+          ],
+          "severity": "category",
+          "note": "`externalPlayback` is forced off. `appearance` is ignored. `allowCellular` is ignored. `preload` is ignored. `playbackRates` is ignored, and the queue/chapters/transcript panels never render."
+        },
+        {
+          "props": [
+            "allowCellular",
+            "forwardSkipSeconds",
+            "backwardSkipSeconds",
+            "playbackRates",
+            "showQueue",
+            "showChapters",
+            "showTranscript"
+          ],
+          "platforms": [
+            "web"
+          ],
+          "severity": "category",
+          "note": "`allowCellular` is ignored. Skip buttons ignore `forwardSkipSeconds`/`backwardSkipSeconds`. `playbackRates` is ignored, and the queue/chapters/transcript panels never render."
+        }
+      ],
       "propsSource": "export interface MediaPlayerProps {\n  sessionId?: string;\n  items?: MediaItem[];\n  startIndex?: number;\n  startPositionSeconds?: number;\n  presentation?: MediaPresentation;\n  controls?: MediaControls;\n  autoplay?: MediaAutoplay;\n  autoplayVisibilityThreshold?: number;\n  muted?: boolean;\n  loop?: MediaLoop;\n  fullscreen?: Exclude<MediaPolicy, \"automatic\" | \"audioOnly\">;\n  pictureInPicture?: Extract<MediaPolicy, \"disabled\" | \"allowed\" | \"automatic\">;\n  backgroundPlayback?: Extract<MediaPolicy, \"disabled\" | \"allowed\" | \"audioOnly\">;\n  externalPlayback?: Exclude<MediaPolicy, \"automatic\" | \"audioOnly\">;\n  playbackRates?: number[];\n  forwardSkipSeconds?: number;\n  backwardSkipSeconds?: number;\n  showQueue?: boolean;\n  showChapters?: boolean;\n  showTranscript?: boolean;\n  height?: number;\n  aspectRatio?: number;\n  contentMode?: \"fit\" | \"fill\";\n  posterUrl?: string;\n  appearance?: MediaPlayerAppearance;\n  slots?: MediaPlayerSlots;\n  onReady?: Action;\n  onPlay?: Action;\n  onPause?: Action;\n  onEnd?: Action;\n  onError?: Action;\n  onProgress?: Action;\n  onFullscreenChange?: Action;\n  onItemChange?: Action;\n  allowCellular?: boolean;\n  preload?: boolean;\n  /**\n   * `$service:` binding → a live `MediaItem[]`: the worker-driven QUEUE, resolved\n   * through the same list-binding seam as `LazyList.itemsPath` / `Map.markersPath`.\n   * `items` is `MediaItem[]`, so a value binding there is a type mismatch — this\n   * companion string carries the binding and OVERRIDES the literal `items` when set.\n   * Each resolved item's own scalar fields (url/title/artist/artworkUrl) still resolve\n   * per-field through the media-source seam.\n   */\n  itemsPath?: string;\n}"
     },
     {
@@ -1235,10 +1468,20 @@
       "category": "Rich vector & celebration (motion grammar Batch 4)",
       "propsType": "TimeGridProps",
       "bindings": [
-        "anchorDatePath",
         "eventsPath",
         "resourcesPath"
       ],
+      "notImplemented": {
+        "props": [
+          "anchorDatePath",
+          "onRangeChange"
+        ],
+        "platforms": [
+          "android"
+        ],
+        "severity": "category",
+        "note": "`anchorDatePath` does not bind and `onRangeChange` never fires."
+      },
       "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}"
     },
     {
@@ -1249,6 +1492,16 @@
         "eventsPath",
         "scrollToDatePath"
       ],
+      "notImplemented": {
+        "props": [
+          "stickyHeaders"
+        ],
+        "platforms": [
+          "android"
+        ],
+        "severity": "styling",
+        "note": "Day headers do not pin."
+      },
       "propsSource": "export interface AgendaProps {\n  events?: CalendarEvent[];\n  eventsPath?: string;\n  scrollToDate?: string;\n  /** Worker-driven jump target (a literal `scrollToDate` is frozen in the descriptor). */\n  scrollToDatePath?: string;\n  stickyHeaders?: boolean;\n  emptyText?: string;\n  onSelectEvent?: Action;\n  /** Per-event row body, `$item.*`-substituted per event. Closes the gap that made\n   *  `agendaList()` (the LazyList-backed PRESET, which takes a `rowTemplate`) more\n   *  expressive than this component. Absent ⇒ the built-in row. */\n  eventTemplate?: Component;\n  /** Newest-first. Absent/false ⇒ ascending. Applies to the day GROUPS and to the\n   *  events within each group. Without it a list whose default sort is \"Newest\"\n   *  (an owner's orders, recent activity) could not become an Agenda without\n   *  silently inverting itself — every arm sorted ascending unconditionally. */\n  descending?: boolean;\n}"
     }
   ],

package/guides/component-reference.md

@@ -59,7 +59,7 @@ See also **[Modifiers](#modifiers)** (the `modifiers` block) and **[Actions](#ac
 | `WorkerSubtree` | Bounded worker-authored component tree | `treeJsonPath` |
 | `SearchField` | Search & filter | — |
 | `FilterChips` | Search & filter | `optionsPath`, `selectedIds` |
-| `Tabs` | Navigation primitives | `optionsPath`, `activeColorPath`, `selectedId` |
+| `Tabs` | Navigation primitives | `optionsPath`, `selectedId` |
 | `SegmentedControl` | Navigation primitives | `optionsPath`, `selectedId` |
 | `Carousel` | Navigation primitives | `itemsPath` |
 | `Pager` | Navigation primitives | — |
@@ -75,7 +75,7 @@ See also **[Modifiers](#modifiers)** (the `modifiers` block) and **[Actions](#ac
 | `Slider` | Controls & cells | `valuePath` |
 | `SelectionControl` | Controls & cells | `valuePath` |
 | `ActivityIndicator` | Controls & cells | `valuePath` |
-| `BottomSheet` | Overlays & menus | — |
+| `BottomSheet` | Overlays & menus | `presentedPath` |
 | `Menu` | Overlays & menus | — |
 | `Tooltip` | Overlays & menus | — |
 | `Popover` | Overlays & menus | `presentedPath` |
@@ -109,33 +109,52 @@ See also **[Modifiers](#modifiers)** (the `modifiers` block) and **[Actions](#ac
 | `Lottie` | Rich vector & celebration (motion grammar Batch 4) | — |
 | `Rive` | Rich vector & celebration (motion grammar Batch 4) | — |
 | `MonthCalendar` | Rich vector & celebration (motion grammar Batch 4) | `selectedDatePath`, `decorationsPath`, `yearPath`, `monthPath`, `selectedStartDatePath`, `selectedEndDatePath` |
-| `TimeGrid` | Rich vector & celebration (motion grammar Batch 4) | `anchorDatePath`, `eventsPath`, `resourcesPath` |
+| `TimeGrid` | Rich vector & celebration (motion grammar Batch 4) | `eventsPath`, `resourcesPath` |
 | `Agenda` | Rich vector & celebration (motion grammar Batch 4) | `eventsPath`, `scrollToDatePath` |
 
 ## Not implemented (decoded but never read)
 
 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: 13 of 84 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: 23 of 84 components, all of them web / ios / android-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` (9: `FieldError`, `Picker`, `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.
+- **`category` (8: `BottomSheet`, `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 — for a dismissible sheet it is `presentation: "sheet"` on the navigating `Action`, not `BottomSheet`.
+- **`styling` (15: `Text`, `Picker`, `Tabs`, `Carousel`, `CollapsingHeader`, `Banner`, `Snackbar`, `WebView`, `Slider`, `SelectionControl`, `ActivityIndicator`, `Map`, `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 |
 |---|---|---|---|---|
-| `FieldError` | `severity` | ios | styling | `severity: "warning"` still paints `danger` red. |
-| `Picker` | `optionsPath`, `placeholder` | ios | styling | `optionsPath` does not bind options; `placeholder` is not shown. |
-| `Tabs` | `style` | ios | styling | The tab bar itself renders — only `style` is inert: `swipe` still renders as top tabs. |
-| `Snackbar` | `durationMs` | ios | styling | `durationMs` does not control the auto-dismiss timeout. |
-| `Slider` | `debounceMs` | ios | styling | `debounceMs` does not throttle the onChange stream. |
-| `ActivityIndicator` | `ring` | ios | styling | The `ring` style is decoded but never selected. |
-| `BottomSheet` | `detents`, `dismissible`, `onDismiss`, `presented`, `presentedPath`, `edge` | ios | category | Presentation is not implemented — BottomSheet renders as an always-visible inline surface, never a dismissible sheet. All six presentation props are dead. Use the WORKING alternative instead: present the content as its own screen with `presentation: "sheet"` on the navigating `Action` — that is a real dismissible sheet on every platform. Reach for BottomSheet only when an always-visible inline surface is what you actually want. |
-| `Menu` | `style`, `itemsPath` | ios | category | `action_sheet`/`context` render as an always-open inline list; `itemsPath` does not bind items. |
-| `Tooltip` | `edge`, `trigger`, `onDismiss` | ios | category | Not an overlay — renders always-expanded inline; `trigger` and dismissal are inert. |
-| `Popover` | `edge` | ios | category | Presentation follows `presented` / `presentedPath` (a gated popover shows its bubble only while presented, and is modal then), but the bubble is drawn in the screen's flow under its anchor, not floating over it: `edge` placement is not implemented. It closes when its gate closes, or on the VoiceOver escape gesture, which fires `onDismiss` so a worker can clear the gate. |
-| `ChipsInput` | `onAdd` | ios | styling | `onAdd` never dispatches. |
-| `OtpInput` | `onChange`, `onComplete` | ios | styling | Neither callback dispatches. |
-| `Video` | `poster` | ios | styling | `poster` (pre-play frame) is not shown. |
+| `Text` | `textDirection`, `animateReveal` | web | styling | `textDirection` sets no `dir`. `animateReveal` does not animate. |
+| `Picker` | `optionsPath`, `placeholder` | ios | styling | Standalone Picker: `optionsPath` does not bind (it does inside a FormField); `placeholder` is only the accessible name, never shown. |
+| `Tabs` | `style` | ios | styling | `style: "swipe"` renders as plain top tabs. |
+| `Tabs` | `activeColorPath` | android | styling | `activeColorPath` does not tint the active tab. |
+| `Tabs` | `activeColorPath`, `style` | web | styling | `activeColorPath` does not tint the active tab. `style: "swipe"` renders as plain top tabs. |
+| `Carousel` | `autoplayIntervalMs` | android, web | styling | No autoplay. |
+| `CollapsingHeader` | `imageAsset`, `collapsedHeight`, `parallaxFactor` | web | styling | A static hero: `imageAsset`, `collapsedHeight` and `parallaxFactor` are inert (only `imageUrl` is read). |
+| `CollapsingHeader` | `imageAsset` | android | styling | `imageAsset` (a baked asset name) is not resolved — only `imageUrl` paints the hero. |
+| `Banner` | `dismissible` | web | styling | No dismiss control. |
+| `Snackbar` | `durationMs` | ios, android, web | styling | The Snackbar component renders inline, so `durationMs` does nothing (the `snackbar` presentation verb is the working toast). |
+| `WebView` | `scrollEnabled`, `config` | web | styling | The iframe always scrolls. `config` (the native WebView options: cookies, bridge, zoom…) is not applied to the iframe. |
+| `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`). |
+| `BottomSheet` | `edge` | ios | category | `edge` (side sheet) is ignored — it always opens from the bottom. |
+| `BottomSheet` | `detents`, `edge` | android | category | `detents` are ignored (opens full height). `edge` (side sheet) is ignored — it always opens from the bottom. |
+| `BottomSheet` | `detents`, `dismissible`, `onDismiss`, `edge` | web | category | `detents` are ignored (opens full height). No scrim tap / Escape to close, so `onDismiss` never fires — for a dismissible sheet here, present the content as its own screen with `presentation: "sheet"` on the navigating `Action`. `edge` (side sheet) is ignored — it always opens from the bottom. |
+| `Menu` | `itemsPath` | ios | category | `itemsPath` does not bind items. |
+| `Menu` | `style`, `itemsPath` | android, web | category | `style` is ignored — `context`/`action_sheet` render as a dropdown. `itemsPath` does not bind items. |
+| `Tooltip` | `edge`, `trigger`, `onDismiss` | ios, android, web | category | Not an overlay — renders always-expanded inline; `edge`, `trigger` and dismissal are inert. |
+| `Popover` | `edge` | ios | category | The bubble is drawn in flow under its anchor; `edge` placement is not implemented. |
+| `ChipsInput` | `onAdd` | ios, android, web | category | `onAdd` never dispatches. |
+| `OtpInput` | `onComplete`, `onChange` | ios, android, web | category | Neither `onChange` nor `onComplete` dispatches. |
+| `Map` | `followUserLocation` | android, web | styling | `followUserLocation` does not track. |
+| `Video` | `poster` | ios | styling | `poster` is not shown. |
+| `PdfView` | `showPageControls`, `startPage` | android | styling | No page controls. `startPage` is ignored. |
+| `PdfView` | `showPageControls`, `zoomable`, `allowShare` | web | styling | No page controls. The browser PDF viewer ignores `zoomable` and `allowShare`. |
+| `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. |
+| `Agenda` | `stickyHeaders` | android | styling | Day headers do not pin. |
 
 ## Token slots: `TokenRef` object vs bare `TokenName` string
 
@@ -432,6 +451,8 @@ export type TextProps = TextContent & {
 };
 ```
 
+> ⚠️ **Implemented, but these props are inert on web:** `textDirection`, `animateReveal` — `textDirection` sets no `dir`. `animateReveal` does not animate.
+
 #### Image
 
 ```ts
@@ -779,8 +800,6 @@ export interface FieldErrorProps {
 }
 ```
 
-> ⚠️ **Implemented, but these props are inert on ios:** `severity` — `severity: "warning"` still paints `danger` red.
-
 #### Picker
 
 ```ts
@@ -794,7 +813,7 @@ export interface PickerProps {
 }
 ```
 
-> ⚠️ **Implemented, but these props are inert on ios:** `optionsPath`, `placeholder` — `optionsPath` does not bind options; `placeholder` is not shown.
+> ⚠️ **Implemented, but these props are inert on ios:** `optionsPath`, `placeholder` — Standalone Picker: `optionsPath` does not bind (it does inside a FormField); `placeholder` is only the accessible name, never shown.
 
 **Dispatches** — see [What a control sends](#what-a-control-sends-action-payloads):
 
@@ -952,7 +971,11 @@ export interface TabsProps {
 }
 ```
 
-> ⚠️ **Implemented, but these props are inert on ios:** `style` — The tab bar itself renders — only `style` is inert: `swipe` still renders as top tabs.
+> ⚠️ **Implemented, but these props are inert on ios:** `style` — `style: "swipe"` renders as plain top tabs.
+
+> ⚠️ **Implemented, but these props are inert on android:** `activeColorPath` — `activeColorPath` does not tint the active tab.
+
+> ⚠️ **Implemented, but these props are inert on web:** `activeColorPath`, `style` — `activeColorPath` does not tint the active tab. `style: "swipe"` renders as plain top tabs.
 
 **Dispatches** — see [What a control sends](#what-a-control-sends-action-payloads):
 
@@ -992,6 +1015,8 @@ export interface CarouselProps {
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on android, web:** `autoplayIntervalMs` — No autoplay.
+
 #### Pager
 
 ```ts
@@ -1035,6 +1060,10 @@ export interface CollapsingHeaderProps {
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on web:** `imageAsset`, `collapsedHeight`, `parallaxFactor` — A static hero: `imageAsset`, `collapsedHeight` and `parallaxFactor` are inert (only `imageUrl` is read).
+
+> ⚠️ **Implemented, but these props are inert on android:** `imageAsset` — `imageAsset` (a baked asset name) is not resolved — only `imageUrl` paints the hero.
+
 #### AvatarStrip
 
 ```ts
@@ -1081,6 +1110,8 @@ export interface BannerProps {
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on web:** `dismissible` — No dismiss control.
+
 #### Snackbar
 
 ```ts
@@ -1094,7 +1125,7 @@ export interface SnackbarProps {
 }
 ```
 
-> ⚠️ **Implemented, but these props are inert on ios:** `durationMs` — `durationMs` does not control the auto-dismiss timeout.
+> ⚠️ **Implemented, but these props are inert on ios, android, web:** `durationMs` — The Snackbar component renders inline, so `durationMs` does nothing (the `snackbar` presentation verb is the working toast).
 
 #### AlertDialog
 
@@ -1148,6 +1179,8 @@ export interface WebViewProps {
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on web:** `scrollEnabled`, `config` — The iframe always scrolls. `config` (the native WebView options: cookies, bridge, zoom…) is not applied to the iframe.
+
 ### Controls & cells
 
 #### ListItem
@@ -1198,7 +1231,7 @@ export interface SliderProps {
 }
 ```
 
-> ⚠️ **Implemented, but these props are inert on ios:** `debounceMs` — `debounceMs` does not throttle the onChange stream.
+> ⚠️ **Implemented, but these props are inert on ios, web:** `debounceMs` — `debounceMs` does not throttle onChange.
 
 **Dispatches** — see [What a control sends](#what-a-control-sends-action-payloads):
 
@@ -1230,6 +1263,8 @@ export interface SelectionControlProps {
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on android, web:** `groupId` — Radios sharing a `groupId` are not mutually exclusive.
+
 **Dispatches** — see [What a control sends](#what-a-control-sends-action-payloads):
 
 | callback | key | type |
@@ -1258,7 +1293,7 @@ export interface ActivityIndicatorProps {
 }
 ```
 
-> ⚠️ **Implemented, but these props are inert on ios:** `ring` — The `ring` style is decoded but never selected.
+> ⚠️ **Implemented, but these props are inert on ios, android, web:** `ring` — The `ring` style is never selected (determinate vs indeterminate follows `value`).
 
 ### Overlays & menus
 
@@ -1286,7 +1321,11 @@ export interface BottomSheetProps {
 }
 ```
 
-> ⚠️ **Not implemented on ios:** `detents`, `dismissible`, `onDismiss`, `presented`, `presentedPath`, `edge` — Presentation is not implemented — BottomSheet renders as an always-visible inline surface, never a dismissible sheet. All six presentation props are dead. Use the WORKING alternative instead: present the content as its own screen with `presentation: "sheet"` on the navigating `Action` — that is a real dismissible sheet on every platform. Reach for BottomSheet only when an always-visible inline surface is what you actually want.
+> ⚠️ **Not implemented on ios:** `edge` — `edge` (side sheet) is ignored — it always opens from the bottom.
+
+> ⚠️ **Not implemented on android:** `detents`, `edge` — `detents` are ignored (opens full height). `edge` (side sheet) is ignored — it always opens from the bottom.
+
+> ⚠️ **Not implemented on web:** `detents`, `dismissible`, `onDismiss`, `edge` — `detents` are ignored (opens full height). No scrim tap / Escape to close, so `onDismiss` never fires — for a dismissible sheet here, present the content as its own screen with `presentation: "sheet"` on the navigating `Action`. `edge` (side sheet) is ignored — it always opens from the bottom.
 
 #### Menu
 
@@ -1305,7 +1344,9 @@ export interface MenuProps {
 }
 ```
 
-> ⚠️ **Not implemented on ios:** `style`, `itemsPath` — `action_sheet`/`context` render as an always-open inline list; `itemsPath` does not bind items.
+> ⚠️ **Not implemented on ios:** `itemsPath` — `itemsPath` does not bind items.
+
+> ⚠️ **Not implemented on android, web:** `style`, `itemsPath` — `style` is ignored — `context`/`action_sheet` render as a dropdown. `itemsPath` does not bind items.
 
 #### Tooltip
 
@@ -1321,7 +1362,7 @@ export interface TooltipProps {
 }
 ```
 
-> ⚠️ **Not implemented on ios:** `edge`, `trigger`, `onDismiss` — Not an overlay — renders always-expanded inline; `trigger` and dismissal are inert.
+> ⚠️ **Not implemented on ios, android, web:** `edge`, `trigger`, `onDismiss` — Not an overlay — renders always-expanded inline; `edge`, `trigger` and dismissal are inert.
 
 #### Popover
 
@@ -1343,7 +1384,7 @@ export interface PopoverProps {
 }
 ```
 
-> ⚠️ **Not implemented on ios:** `edge` — Presentation follows `presented` / `presentedPath` (a gated popover shows its bubble only while presented, and is modal then), but the bubble is drawn in the screen's flow under its anchor, not floating over it: `edge` placement is not implemented. It closes when its gate closes, or on the VoiceOver escape gesture, which fires `onDismiss` so a worker can clear the gate.
+> ⚠️ **Not implemented on ios:** `edge` — The bubble is drawn in flow under its anchor; `edge` placement is not implemented.
 
 ### Chips & selection
 
@@ -1383,7 +1424,7 @@ export interface ChipsInputProps {
 }
 ```
 
-> ⚠️ **Implemented, but these props are inert on ios:** `onAdd` — `onAdd` never dispatches.
+> ⚠️ **Not implemented on ios, android, web:** `onAdd` — `onAdd` never dispatches.
 
 **Dispatches** — see [What a control sends](#what-a-control-sends-action-payloads):
 
@@ -1783,7 +1824,7 @@ export interface OtpInputProps {
 }
 ```
 
-> ⚠️ **Implemented, but these props are inert on ios:** `onChange`, `onComplete` — Neither callback dispatches.
+> ⚠️ **Not implemented on ios, android, web:** `onComplete`, `onChange` — Neither `onChange` nor `onComplete` dispatches.
 
 **Dispatches** — see [What a control sends](#what-a-control-sends-action-payloads):
 
@@ -1919,6 +1960,8 @@ export interface MapProps {
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on android, web:** `followUserLocation` — `followUserLocation` does not track.
+
 #### Video
 
 ```ts
@@ -1934,7 +1977,7 @@ export interface VideoProps {
 }
 ```
 
-> ⚠️ **Implemented, but these props are inert on ios:** `poster` — `poster` (pre-play frame) is not shown.
+> ⚠️ **Implemented, but these props are inert on ios:** `poster` — `poster` is not shown.
 
 #### PdfView
 
@@ -1950,6 +1993,10 @@ export interface PdfViewProps {
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on android:** `showPageControls`, `startPage` — No page controls. `startPage` is ignored.
+
+> ⚠️ **Implemented, but these props are inert on web:** `showPageControls`, `zoomable`, `allowShare` — No page controls. The browser PDF viewer ignores `zoomable` and `allowShare`.
+
 #### MediaPlayer
 
 ```ts
@@ -2002,6 +2049,12 @@ export interface MediaPlayerProps {
 }
 ```
 
+> ⚠️ **Not implemented on ios:** `autoplayVisibilityThreshold`, `preload`, `playbackRates`, `showQueue`, `showChapters`, `showTranscript` — `autoplayVisibilityThreshold` is ignored (whenVisible = once on appear). `preload` is ignored. `playbackRates` is ignored, and the queue/chapters/transcript panels never render.
+
+> ⚠️ **Not implemented on android:** `externalPlayback`, `appearance`, `allowCellular`, `preload`, `playbackRates`, `showQueue`, `showChapters`, `showTranscript` — `externalPlayback` is forced off. `appearance` is ignored. `allowCellular` is ignored. `preload` is ignored. `playbackRates` is ignored, and the queue/chapters/transcript panels never render.
+
+> ⚠️ **Not implemented on web:** `allowCellular`, `forwardSkipSeconds`, `backwardSkipSeconds`, `playbackRates`, `showQueue`, `showChapters`, `showTranscript` — `allowCellular` is ignored. Skip buttons ignore `forwardSkipSeconds`/`backwardSkipSeconds`. `playbackRates` is ignored, and the queue/chapters/transcript panels never render.
+
 ### Rich vector & celebration (motion grammar Batch 4)
 
 #### Lottie
@@ -2109,6 +2162,8 @@ export interface TimeGridProps {
 }
 ```
 
+> ⚠️ **Not implemented on android:** `anchorDatePath`, `onRangeChange` — `anchorDatePath` does not bind and `onRangeChange` never fires.
+
 #### Agenda
 
 ```ts
@@ -2133,6 +2188,8 @@ export interface AgendaProps {
 }
 ```
 
+> ⚠️ **Implemented, but these props are inert on android:** `stickyHeaders` — Day headers do not pin.
+
 ## Screen descriptor shape
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1189.0",
+  "version": "0.1190.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": "6cdd1d60a3c8d77a450fac977716f1d7ded301af4e074c978148513e"
+  "falconPackageHash": "9372e1bc93fb23ce8d6d5db9c0d7574d95632af38bcce8830a656813"
 }