@wix/himalaya-cli 0.1416.0 → 0.1417.0

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

@@ -964,6 +964,8 @@ export declare function menu(props: {
     itemsPath?: string;
     /** RFC 0058 §4 — focus-trap tri-state; absent takes the Menu's default: modal. */
     modal?: boolean;
+    /** Lifted above a `style: "context"` menu while it is open; ignored by the other styles. */
+    preview?: Component;
 }, opts?: {
     id?: string;
 }): Component;

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

@@ -22,6 +22,25 @@ export type Value = null | string | number | boolean | Value[] | {
     [key: string]: Value;
 };
 export type Presentation = "push" | "sheet" | "replace" | "dismiss" | "back" | "full_screen" | "alert" | "snackbar";
+/** `args` of a `{ actionId: "himi.lightbox" }` action — a full-screen image viewer. A reserved
+ *  action id, not a `presentation` value: an older binary treats it as an unhandled action
+ *  instead of failing to decode the screen. */
+export interface LightboxImage {
+    url: string;
+    /** Spoken name of the image (and its fallback when it fails to load). */
+    alt?: string;
+    /** Shown under the image. */
+    caption?: string;
+}
+export interface LightboxArgs {
+    /** The images to page through: a list, or a `$service:` / `$item.` binding to one. A bare url string is accepted per entry. */
+    images: (LightboxImage | string)[] | string;
+    /** 0-based page the viewer opens on. Default 0. */
+    startIndex?: number | string;
+    /** The tapped image's `modifiers.transitionId`. Carried for a future zoom from/back to the source:
+     *  today every surface opens the viewer with a fade and a small scale-in. */
+    transitionId?: string;
+}
 export interface Action {
     actionId: string;
     /** Backwards-compatible string-only params. Prefer `args` for typed payloads. */
@@ -1362,6 +1381,10 @@ export interface MenuProps {
      *  `aria-modal`). TRI-STATE: absent takes the Menu's default — MODAL,
      *  from the one shared overlay default table — and an explicit `false` opts out. */
     modal?: boolean;
+    /** A preview lifted above the menu while a `style: "context"` menu is open (iOS
+     *  `.contextMenu(menuItems:preview:)`; Android and web draw it as a card over a scrim).
+     *  Absent ⇒ the anchor itself lifts. Ignored by the other styles. */
+    preview?: Component;
 }
 export interface TooltipProps {
     anchor?: Component;

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

@@ -255,31 +255,93 @@ export declare const screenDescriptorSchema: {
                     readonly enum: readonly ["push", "sheet", "replace", "dismiss", "back", "full_screen", "alert", "snackbar"];
                 };
             };
-            readonly if: {
-                readonly properties: {
-                    readonly presentation: {
-                        readonly const: "sheet";
+            readonly allOf: readonly [{
+                readonly if: {
+                    readonly properties: {
+                        readonly presentation: {
+                            readonly const: "sheet";
+                        };
                     };
+                    readonly required: readonly ["presentation"];
                 };
-                readonly required: readonly ["presentation"];
-            };
-            readonly then: {
-                readonly properties: {
-                    readonly args: {
-                        readonly properties: {
-                            readonly detents: {
-                                readonly type: "array";
-                                readonly items: {
-                                    readonly type: "number";
-                                    readonly exclusiveMinimum: 0;
-                                    readonly maximum: 1;
+                readonly then: {
+                    readonly properties: {
+                        readonly args: {
+                            readonly properties: {
+                                readonly detents: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "number";
+                                        readonly exclusiveMinimum: 0;
+                                        readonly maximum: 1;
+                                    };
+                                    readonly minItems: 1;
                                 };
-                                readonly minItems: 1;
                             };
                         };
                     };
                 };
-            };
+            }, {
+                readonly if: {
+                    readonly properties: {
+                        readonly actionId: {
+                            readonly const: "himi.lightbox";
+                        };
+                    };
+                    readonly required: readonly ["actionId"];
+                };
+                readonly then: {
+                    readonly required: readonly ["args"];
+                    readonly properties: {
+                        readonly args: {
+                            readonly required: readonly ["images"];
+                            readonly properties: {
+                                readonly images: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\$(service:|item\\.)";
+                                    }, {
+                                        readonly type: "array";
+                                        readonly minItems: 1;
+                                        readonly items: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                                readonly minLength: 1;
+                                            }, {
+                                                readonly type: "object";
+                                                readonly required: readonly ["url"];
+                                                readonly properties: {
+                                                    readonly url: {
+                                                        readonly type: "string";
+                                                        readonly minLength: 1;
+                                                    };
+                                                    readonly alt: {
+                                                        readonly type: "string";
+                                                    };
+                                                    readonly caption: {
+                                                        readonly type: "string";
+                                                    };
+                                                };
+                                            }];
+                                        };
+                                    }];
+                                };
+                                readonly startIndex: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "integer";
+                                        readonly minimum: 0;
+                                    }, {
+                                        readonly type: "string";
+                                    }];
+                                };
+                                readonly transitionId: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                    };
+                };
+            }];
         };
         readonly topBarConfig: {
             readonly type: "object";
@@ -1443,31 +1505,93 @@ export declare const widgetSnapshotSchema: {
                     readonly enum: readonly ["push", "sheet", "replace", "dismiss", "back", "full_screen", "alert", "snackbar"];
                 };
             };
-            readonly if: {
-                readonly properties: {
-                    readonly presentation: {
-                        readonly const: "sheet";
+            readonly allOf: readonly [{
+                readonly if: {
+                    readonly properties: {
+                        readonly presentation: {
+                            readonly const: "sheet";
+                        };
                     };
+                    readonly required: readonly ["presentation"];
                 };
-                readonly required: readonly ["presentation"];
-            };
-            readonly then: {
-                readonly properties: {
-                    readonly args: {
-                        readonly properties: {
-                            readonly detents: {
-                                readonly type: "array";
-                                readonly items: {
-                                    readonly type: "number";
-                                    readonly exclusiveMinimum: 0;
-                                    readonly maximum: 1;
+                readonly then: {
+                    readonly properties: {
+                        readonly args: {
+                            readonly properties: {
+                                readonly detents: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "number";
+                                        readonly exclusiveMinimum: 0;
+                                        readonly maximum: 1;
+                                    };
+                                    readonly minItems: 1;
                                 };
-                                readonly minItems: 1;
                             };
                         };
                     };
                 };
-            };
+            }, {
+                readonly if: {
+                    readonly properties: {
+                        readonly actionId: {
+                            readonly const: "himi.lightbox";
+                        };
+                    };
+                    readonly required: readonly ["actionId"];
+                };
+                readonly then: {
+                    readonly required: readonly ["args"];
+                    readonly properties: {
+                        readonly args: {
+                            readonly required: readonly ["images"];
+                            readonly properties: {
+                                readonly images: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\$(service:|item\\.)";
+                                    }, {
+                                        readonly type: "array";
+                                        readonly minItems: 1;
+                                        readonly items: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                                readonly minLength: 1;
+                                            }, {
+                                                readonly type: "object";
+                                                readonly required: readonly ["url"];
+                                                readonly properties: {
+                                                    readonly url: {
+                                                        readonly type: "string";
+                                                        readonly minLength: 1;
+                                                    };
+                                                    readonly alt: {
+                                                        readonly type: "string";
+                                                    };
+                                                    readonly caption: {
+                                                        readonly type: "string";
+                                                    };
+                                                };
+                                            }];
+                                        };
+                                    }];
+                                };
+                                readonly startIndex: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "integer";
+                                        readonly minimum: 0;
+                                    }, {
+                                        readonly type: "string";
+                                    }];
+                                };
+                                readonly transitionId: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                    };
+                };
+            }];
         };
         readonly topBarConfig: {
             readonly type: "object";

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

@@ -8265,16 +8265,59 @@ var screenDescriptorSchema = {
       // key: every router reads it as numbers, so a string list would silently present the default
       // sheet. Only a sheet reads it — on any other action `detents` is opaque payload, like the
       // rest of `args`, and must not reject the descriptor.
-      if: { properties: { presentation: { const: "sheet" } }, required: ["presentation"] },
-      then: {
-        properties: {
-          args: {
+      allOf: [
+        {
+          if: { properties: { presentation: { const: "sheet" } }, required: ["presentation"] },
+          then: {
             properties: {
-              detents: { type: "array", items: { type: "number", exclusiveMinimum: 0, maximum: 1 }, minItems: 1 }
+              args: {
+                properties: {
+                  detents: { type: "array", items: { type: "number", exclusiveMinimum: 0, maximum: 1 }, minItems: 1 }
+                }
+              }
+            }
+          }
+        },
+        // A LIGHTBOX (`actionId: "himi.lightbox"`, a reserved id rather than a presentation verb)
+        // has no screenId; its content is `args.images`. Every router drops it without them, so a
+        // lightbox with no images is an authoring error, not a silent no-op.
+        // `images` is a list of {url, alt?, caption?} (or bare urls), or one `$service:` /
+        // `$item.` binding the renderer resolves to that list.
+        {
+          if: { properties: { actionId: { const: "himi.lightbox" } }, required: ["actionId"] },
+          then: {
+            required: ["args"],
+            properties: {
+              args: {
+                required: ["images"],
+                properties: {
+                  images: {
+                    anyOf: [
+                      { type: "string", pattern: "^\\$(service:|item\\.)" },
+                      {
+                        type: "array",
+                        minItems: 1,
+                        items: {
+                          anyOf: [
+                            { type: "string", minLength: 1 },
+                            {
+                              type: "object",
+                              required: ["url"],
+                              properties: { url: { type: "string", minLength: 1 }, alt: { type: "string" }, caption: { type: "string" } }
+                            }
+                          ]
+                        }
+                      }
+                    ]
+                  },
+                  startIndex: { anyOf: [{ type: "integer", minimum: 0 }, { type: "string" }] },
+                  transitionId: { type: "string" }
+                }
+              }
             }
           }
         }
-      }
+      ]
     },
     // RFC 0010 (top-bar amendment) — shell-owned top bar + its trailing actions.
     // `leading`/`style` are free strings (safe-decode; the shell coalesces

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

@@ -7135,16 +7135,59 @@ var screenDescriptorSchema = {
       // key: every router reads it as numbers, so a string list would silently present the default
       // sheet. Only a sheet reads it — on any other action `detents` is opaque payload, like the
       // rest of `args`, and must not reject the descriptor.
-      if: { properties: { presentation: { const: "sheet" } }, required: ["presentation"] },
-      then: {
-        properties: {
-          args: {
+      allOf: [
+        {
+          if: { properties: { presentation: { const: "sheet" } }, required: ["presentation"] },
+          then: {
             properties: {
-              detents: { type: "array", items: { type: "number", exclusiveMinimum: 0, maximum: 1 }, minItems: 1 }
+              args: {
+                properties: {
+                  detents: { type: "array", items: { type: "number", exclusiveMinimum: 0, maximum: 1 }, minItems: 1 }
+                }
+              }
+            }
+          }
+        },
+        // A LIGHTBOX (`actionId: "himi.lightbox"`, a reserved id rather than a presentation verb)
+        // has no screenId; its content is `args.images`. Every router drops it without them, so a
+        // lightbox with no images is an authoring error, not a silent no-op.
+        // `images` is a list of {url, alt?, caption?} (or bare urls), or one `$service:` /
+        // `$item.` binding the renderer resolves to that list.
+        {
+          if: { properties: { actionId: { const: "himi.lightbox" } }, required: ["actionId"] },
+          then: {
+            required: ["args"],
+            properties: {
+              args: {
+                required: ["images"],
+                properties: {
+                  images: {
+                    anyOf: [
+                      { type: "string", pattern: "^\\$(service:|item\\.)" },
+                      {
+                        type: "array",
+                        minItems: 1,
+                        items: {
+                          anyOf: [
+                            { type: "string", minLength: 1 },
+                            {
+                              type: "object",
+                              required: ["url"],
+                              properties: { url: { type: "string", minLength: 1 }, alt: { type: "string" }, caption: { type: "string" } }
+                            }
+                          ]
+                        }
+                      }
+                    ]
+                  },
+                  startIndex: { anyOf: [{ type: "integer", minimum: 0 }, { type: "string" }] },
+                  transitionId: { type: "string" }
+                }
+              }
             }
           }
         }
-      }
+      ]
     },
     // RFC 0010 (top-bar amendment) — shell-owned top bar + its trailing actions.
     // `leading`/`style` are free strings (safe-decode; the shell coalesces