@wix/himalaya-cli 0.1612.0 → 0.1613.0

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

@@ -910,6 +910,7 @@ export declare function segmentedControl(props: {
 export declare function carousel(props: {
     items: Component[];
     paged?: boolean;
+    /** #4673 — `$service:` page index, two-way with onChange (literal or `paged` bound pages). */
     currentIndexPath?: string;
     currentIndex?: number;
     onChange?: ActionShape;
@@ -925,6 +926,10 @@ export declare function pager(props: {
     onChange?: ActionShape;
     showIndicator?: boolean;
     liveWindow?: number;
+    /** #4673 — `$service:` page index, two-way with onChange. */
+    currentIndexPath?: string;
+    /** #4673 — `$service:` array; pages[0] is the page template ($item.* substitution). */
+    pagesPath?: string;
 }, opts?: {
     id?: string;
 }): Component;

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

@@ -1278,7 +1278,12 @@ export interface SegmentedControlProps {
 export interface CarouselProps {
     /** Opt-in paging for itemsPath; absent preserves the horizontal card rail. */
     paged?: boolean;
-    /** Worker-driven page index; clamped to the current page count. */
+    /** #4673 — `$service:` path to the page index, two-way with `onChange`: a CHANGE of the resolved
+     *  value animates the carousel there (instantly under reduced motion); a swipe still fires
+     *  `onChange` with `args.index`, which the worker writes back. Out of range ⇒ clamped; not an
+     *  integer ⇒ ignored; equal to the current page ⇒ nothing; a move the binding made fires no
+     *  `onChange`. Drives literal `items` and `paged` bound ones; inside a bound row a substituted
+     *  literal places the page like `currentIndex`. A rail (`itemsPath` without `paged`) ignores it. */
     currentIndexPath?: string;
     items: Component[];
     currentIndex?: number;
@@ -1296,6 +1301,12 @@ export interface PagerProps {
     showIndicator?: boolean;
     /** RFC 0073 §4.5 — as {@link CarouselProps.liveWindow}. */
     liveWindow?: number;
+    /** #4673 — as {@link CarouselProps.currentIndexPath}: a worker-driven page, two-way with `onChange`. */
+    currentIndexPath?: string;
+    /** #4673 — `$service:` path to an array: `pages[0]` is the page TEMPLATE, instantiated once per
+     *  element with `$item.` substitution (as `Carousel.itemsPath`). Pages are keyed by `$item.id`, so
+     *  the page on screen stays on screen when items are inserted before it. */
+    pagesPath?: string;
 }
 export interface StepIndicatorProps {
     steps: string[];

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

@@ -14883,6 +14883,7 @@ var propsOf = (c) => {
   return isRec(p) ? p : {};
 };
 var hasItemsPath = (props) => typeof props.itemsPath === "string" && props.itemsPath !== "";
+var hasPagesPath = (props) => typeof props.pagesPath === "string" && /^\$(service|app):/.test(props.pagesPath);
 function childComponents(value, path, inTemplate, out) {
   if (Array.isArray(value)) {
     value.forEach((v, i) => childComponents(v, `${path}[${i}]`, inTemplate, out));
@@ -14899,9 +14900,10 @@ function childrenOf(c, path, inTemplate) {
   const props = propsOf(c);
   const type = typeOf(c);
   const boundList = (type === "LazyList" || type === "Grid" || type === "Carousel") && hasItemsPath(props);
+  const boundPages = type === "Pager" && hasPagesPath(props);
   const out = [];
   for (const [k, v] of Object.entries(props)) {
-    const templ = inTemplate || /Template$/.test(k) || boundList && k === "items";
+    const templ = inTemplate || /Template$/.test(k) || boundList && k === "items" || boundPages && k === "pages";
     childComponents(v, `${path}.body.props.${k}`, templ, out);
   }
   return out;
@@ -14949,7 +14951,7 @@ function mountable(c, inTemplate = false) {
     const pages = type === "Carousel" ? props.items : props.pages;
     const perPage = Array.isArray(pages) ? pages.map((p) => isComponent(p) ? mountable(p) : 0) : [];
     const window = typeof props.liveWindow === "number" && props.liveWindow > 0 ? Math.floor(props.liveWindow) : 0;
-    const bound = type === "Carousel" && hasItemsPath(props);
+    const bound = type === "Carousel" ? hasItemsPath(props) : hasPagesPath(props);
     if (bound) {
       const template = perPage[0] ?? 0;
       if (template === 0) return 0;