@wix/himalaya-cli 0.1581.0 → 0.1583.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/dev-server/src/builder.d.ts

@@ -1350,6 +1350,9 @@ export declare function agenda(props: {
      *  an Agenda without silently inverting its own sort. Flips the day GROUPS and
      *  the events within each group together. */
     descending?: boolean;
+    /** `{ date }` when the day at the top of the visible area changes by the user's scroll (not a
+     *  `scrollToDate` jump): a calendar above the list can follow it. */
+    onVisibleDateChange?: ActionShape;
 }, opts?: {
     id?: string;
 }): Component;
@@ -1689,6 +1692,11 @@ export declare function lazyList(props: {
     itemsPath?: string;
     /** Animate insert/remove/reorder as the bound array changes (needs stable ids). */
     animateItems?: boolean;
+    /** `$service:` path naming a row by its item `id` ("id" or "id|nonce"): a change scrolls that
+     *  row to the top of the visible area. Section anchors. */
+    scrollToItemPath?: string;
+    /** `{ id }` when the row at the top of the visible area changes by the user's scroll. */
+    onTopItemChange?: ActionShape;
 }, opts?: {
     id?: string;
 }): Component;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/schema.d.ts

@@ -531,6 +531,20 @@ export interface LazyListProps {
      */
     contentInsetTop?: number;
     contentInsetBottom?: number;
+    /**
+     * Jump to a row of a bound (`itemsPath`) list: a `$service:` path whose value names a row by
+     * its item's `id`. When the value CHANGES to a non-empty one, the row's top is brought to the
+     * top of the visible area (the list's scroll, or the screen's when the list sits in it).
+     * Only the part before the first "|" is the id, so a worker can re-trigger the same row
+     * ("cat:yoga|2"). Unknown id ⇒ nothing.
+     */
+    scrollToItemPath?: string;
+    /**
+     * Fired with args `{ id }` when the bound row at the top of the visible area changes because
+     * the user scrolled: on a change only, after the scroll settles, never for a
+     * `scrollToItemPath` jump, not on first render. Rows with no `id` are skipped.
+     */
+    onTopItemChange?: Action;
 }
 export interface GridProps {
     items: Component[];
@@ -2408,7 +2422,10 @@ export interface AgendaProps {
     events?: CalendarEvent[];
     eventsPath?: string;
     scrollToDate?: string;
-    /** Worker-driven jump target (a literal `scrollToDate` is frozen in the descriptor). */
+    /** Worker-driven jump target (a literal `scrollToDate` is frozen in the descriptor). Either may be
+     *  "YYYY-MM-DD|<anything>": the day is the part before "|", and a change of the whole value jumps
+     *  again, also to the same day. A suffix-less value equal to the day last reported through
+     *  `onVisibleDateChange` is an echo of the user's own scroll and does not move the list. */
     scrollToDatePath?: string;
     stickyHeaders?: boolean;
     emptyText?: string;
@@ -2422,6 +2439,11 @@ export interface AgendaProps {
      *  (an owner's orders, recent activity) could not become an Agenda without
      *  silently inverting itself — every arm sorted ascending unconditionally. */
     descending?: boolean;
+    /** Fired with args `{ date: "YYYY-MM-DD" }` when the day group at the top of the visible area
+     *  changes because the user scrolled (the agenda's own scroll, or the screen's): on a change
+     *  only, after the scroll settles, never for a `scrollToDate` jump, not on first render. Lets a
+     *  calendar above the list follow it. */
+    onVisibleDateChange?: Action;
 }
 export type CoreComponentBody = {
     package: "himalaya";
@@ -3178,7 +3200,9 @@ export interface TopBarAction {
     badge?: NavBadge;
     /** Live bindings against `NavigationConfig.navLogicBundle` — see `NavTabItem`.
      *  `hiddenPath` drops the action from the trailing cluster, which is how "hide
-     *  Checkout while the cart is empty" is said without publishing two top bars. */
+     *  Checkout while the cart is empty" is said without publishing two top bars.
+     *  A screen's own top-bar action binds the same nav worker; runtime 1.8.0 and later
+     *  watch those paths (an older one shows the action). */
     hiddenPath?: string;
     labelPath?: string;
     iconPath?: string;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/validator.d.ts

@@ -708,6 +708,15 @@ export declare const screenDescriptorSchema: {
                 readonly badge: {
                     readonly $ref: "#/$defs/navBadge";
                 };
+                readonly hiddenPath: {
+                    readonly type: "string";
+                };
+                readonly labelPath: {
+                    readonly type: "string";
+                };
+                readonly iconPath: {
+                    readonly type: "string";
+                };
             };
         };
         readonly navBadge: {
@@ -2137,6 +2146,15 @@ export declare const widgetSnapshotSchema: {
                 readonly badge: {
                     readonly $ref: "#/$defs/navBadge";
                 };
+                readonly hiddenPath: {
+                    readonly type: "string";
+                };
+                readonly labelPath: {
+                    readonly type: "string";
+                };
+                readonly iconPath: {
+                    readonly type: "string";
+                };
             };
         };
         readonly navBadge: {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/core.mjs

@@ -8794,7 +8794,11 @@ var screenDescriptorSchema = {
         label: { type: "string" },
         accessibilityLabel: { type: "string" },
         onTap: { $ref: "#/$defs/action" },
-        badge: { $ref: "#/$defs/navBadge" }
+        badge: { $ref: "#/$defs/navBadge" },
+        // RFC 0010 slot bindings (core.proto TopBarAction 7–9): they bind the app's nav worker.
+        hiddenPath: { type: "string" },
+        labelPath: { type: "string" },
+        iconPath: { type: "string" }
       }
     },
     navBadge: {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/sdui.mjs

@@ -7366,7 +7366,11 @@ var screenDescriptorSchema = {
         label: { type: "string" },
         accessibilityLabel: { type: "string" },
         onTap: { $ref: "#/$defs/action" },
-        badge: { $ref: "#/$defs/navBadge" }
+        badge: { $ref: "#/$defs/navBadge" },
+        // RFC 0010 slot bindings (core.proto TopBarAction 7–9): they bind the app's nav worker.
+        hiddenPath: { type: "string" },
+        labelPath: { type: "string" },
+        iconPath: { type: "string" }
       }
     },
     navBadge: {