@wix/himalaya-cli 0.1612.0 → 0.1614.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/sdk/ui/src/index.d.ts

@@ -39,37 +39,77 @@ export declare function alert(options: AlertOptions): Promise<AlertResult>;
  *  `warning`, `danger`). Use `danger` for errors; the hosts also accept `error` as an alias of it. */
 export type SnackbarTone = "info" | "success" | "warning" | "danger";
 export interface SnackbarOptions {
+    /** At most two lines on screen; a longer message is ellipsised. */
     message: string;
     /** Default "info". */
     tone?: SnackbarTone;
-    /** Auto-dismiss delay in ms, on every host. Default 3000; 0 or less also means 3000. */
+    /** Auto-dismiss delay in ms, clamped on every host to {@link SNACKBAR_LIMITS} (2–10 s, at least
+     *  4 s with an `action` so it can be reached by VoiceOver / TalkBack before it goes). Absent, 0 or
+     *  less: the default, 3000 (4000 with an `action`). */
     durationMs?: number;
-    /** One action button ("Undo", "View"). Tapping it runs `actionId` with `args`, then dismisses the
-     *  snackbar. The id must be a worker action:
+    /** A thumbnail of the thing the toast is about: a 40 pt square at the leading edge. `https:` on
+     *  every host; a local `file:` URL on iOS and macOS only, whose image pipeline already reads local
+     *  files. Any other URL is ignored (the toast shows without it), and an image that fails to load
+     *  just hides. */
+    imageUrl?: string;
+    /** One action button ("Undo", "View"). Tapping it dismisses the snackbar and resolves the call
+     *  `{ actionTapped: true }`. With an `actionId` the tap also runs that action with `args`. The id
+     *  must be a worker action:
      *  - one of this bundle's own `tier5.<svc>.<action>` ids — run on THIS worker, never another
      *    screen's or the app-level worker's;
      *  - an app service's `app.<svc>.<action>` — needs `app_services` and an exported action (an app
      *    service's own id needs neither). The web host refuses it until it hosts app services.
      *  Any other id (`capability.*`, `himi.*`, a registered handler) is refused when the snackbar is
      *  requested: the call rejects and nothing is shown. A host that cannot tell which worker asked
-     *  (React Native, an embedded web region) refuses every `action` the same way. */
+     *  (React Native, an embedded web region) refuses every `action` the same way. An APP SERVICE
+     *  must name an `actionId`: an awaited result carries no gesture credit (RFC 0074 §7), so its
+     *  View has to run as an action of its own. */
     action?: SnackbarAction;
 }
 export interface SnackbarAction {
-    /** The button's text — also its VoiceOver / TalkBack / screen-reader label. */
+    /** The button's text — also its VoiceOver / TalkBack / screen-reader label. At most 24
+     *  characters; a longer label is ellipsised. */
     label: string;
-    /** What the tap runs: one of this bundle's own `tier5.<svc>.<action>` ids, or `app.<svc>.<action>`. */
-    actionId: string;
+    /** What the tap runs, if anything: one of this bundle's own `tier5.<svc>.<action>` ids, or
+     *  `app.<svc>.<action>`. A screen worker may leave it out and branch on `actionTapped` instead
+     *  ("Undo"); an app service may not. */
+    actionId?: string;
     /** The action's arguments, which the reducer receives as typed JSON. */
     args?: Record<string, unknown>;
 }
+/** What a snackbar call resolves with. */
+export interface SnackbarResult {
+    /** The user tapped the action. Always false for a snackbar without one (resolved on
+     *  presentation); with one, false when it was dismissed any other way — timed out, swiped, closed,
+     *  or replaced by a newer snackbar. */
+    actionTapped: boolean;
+}
+/** #4661 — the constraints that keep a snackbar a toast, enforced here and again by every host. */
+export declare const SNACKBAR_LIMITS: {
+    readonly messageLines: 2;
+    readonly labelChars: 24;
+    readonly minDurationMs: 2000;
+    /** The floor with an action: long enough to reach it with a screen reader. */
+    readonly minActionDurationMs: 4000;
+    readonly maxDurationMs: 10000;
+    /** The thumbnail's side, in pt / dp / CSS px. */
+    readonly imageSize: 40;
+};
+/** The duration a host shows a snackbar for: absent / non-finite / 0 or less → undefined (the host
+ *  default applies), else clamped to {@link SNACKBAR_LIMITS}. */
+export declare function snackbarDurationMs(durationMs: number | undefined, hasAction: boolean): number | undefined;
+/** An action label as every host draws it: at most {@link SNACKBAR_LIMITS}.labelChars characters
+ *  (by code point, so an emoji is never cut in half), the last one an ellipsis when it was cut. */
+export declare function snackbarLabel(label: string): string;
 /** Show a transient snackbar toast: it floats above the tab bar, slides and fades in and out
- *  (fades only under reduced motion), queues behind one that is already showing, and is read
- *  by VoiceOver / TalkBack. Resolves once it is PRESENTED (not after it auto-dismisses).
+ *  (fades only under reduced motion), queues behind one that is already showing, and is announced
+ *  by VoiceOver / TalkBack / the screen reader. Without an `action` it resolves
+ *  `{ actionTapped: false }` once it is queued, as before; with one it resolves when the snackbar
+ *  goes, `{ actionTapped: true }` only if the action was tapped (see {@link SnackbarResult}).
  *  Rejects with `no_ui_host` if no presenter is attached; with an `action`, also with
- *  `invalid_action` (empty label or id), `action_not_allowed` (not one of this bundle's
- *  actions), or, for an `app.*` id, `undeclared` (no `app_services`), `not_exported`, `no_service`,
- *  `no_action`, `not_booted` or `unavailable`. */
-export declare function snackbar(options: SnackbarOptions): Promise<void>;
+ *  `invalid_action` (empty label), `action_id_required` (an app service with no `actionId`),
+ *  `action_not_allowed` (not one of this bundle's actions), or, for an `app.*` id, `undeclared` (no
+ *  `app_services`), `not_exported`, `no_service`, `no_action`, `not_booted` or `unavailable`. */
+export declare function snackbar(options: SnackbarOptions): Promise<SnackbarResult>;
 /** Capability version, for bundles that gate on min binary version. */
 export declare const version = 1;

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[];
@@ -1321,6 +1332,9 @@ export interface SnackbarProps {
     severity?: Severity;
     /** #1059 — action label; overridable for localized hosts. Default "Take action". */
     actionLabel?: string;
+    /** #4661 — a 40 pt/dp thumbnail at the leading edge (`https:` or a local file/asset URL; any
+     *  other is ignored), drawn by the same presenter as a worker's `ui.snackbar({ imageUrl })`. */
+    imageUrl?: string;
 }
 export interface AlertDialogProps {
     title: 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;

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

@@ -28,22 +28,48 @@ async function alert(options) {
   const r = await dispatch("capability.ui.alert", params);
   return { confirmed: r?.confirmed === true || r?.confirmed === "true" };
 }
+var SNACKBAR_LIMITS = {
+  messageLines: 2,
+  labelChars: 24,
+  minDurationMs: 2e3,
+  /** The floor with an action: long enough to reach it with a screen reader. */
+  minActionDurationMs: 4e3,
+  maxDurationMs: 1e4,
+  /** The thumbnail's side, in pt / dp / CSS px. */
+  imageSize: 40
+};
+function snackbarDurationMs(durationMs, hasAction) {
+  if (typeof durationMs !== "number" || !Number.isFinite(durationMs) || durationMs <= 0) return void 0;
+  const min = hasAction ? SNACKBAR_LIMITS.minActionDurationMs : SNACKBAR_LIMITS.minDurationMs;
+  return Math.min(SNACKBAR_LIMITS.maxDurationMs, Math.max(min, Math.trunc(durationMs)));
+}
+function snackbarLabel(label) {
+  const chars = Array.from(label ?? "");
+  return chars.length <= SNACKBAR_LIMITS.labelChars ? chars.join("") : `${chars.slice(0, SNACKBAR_LIMITS.labelChars - 1).join("")}\u2026`;
+}
 async function snackbar(options) {
   const params = { message: options.message ?? "" };
   if (options.tone) params.tone = options.tone;
-  if (typeof options.durationMs === "number" && Number.isFinite(options.durationMs)) {
-    params.durationMs = Math.min(2147483647, Math.max(0, Math.trunc(options.durationMs)));
-  }
+  const durationMs = snackbarDurationMs(options.durationMs, !!options.action);
+  if (durationMs !== void 0) params.durationMs = durationMs;
+  if (typeof options.imageUrl === "string" && options.imageUrl.trim()) params.imageUrl = options.imageUrl.trim();
   if (options.action) {
     const { label, actionId, args } = options.action;
-    params.action = JSON.stringify(args === void 0 ? { label, actionId } : { label, actionId, args });
+    const action = { label: snackbarLabel(label) };
+    if (actionId) action.actionId = actionId;
+    if (args !== void 0) action.args = args;
+    params.action = JSON.stringify(action);
   }
-  await dispatch("capability.ui.snackbar", params);
+  const r = await dispatch("capability.ui.snackbar", params);
+  return { actionTapped: r?.actionTapped === true || r?.actionTapped === "true" };
 }
 var version = 1;
 export {
+  SNACKBAR_LIMITS,
   alert,
   snackbar,
+  snackbarDurationMs,
+  snackbarLabel,
   version
 };
 //# sourceMappingURL=ui.mjs.map