@wix/himalaya-cli 0.1404.0 → 0.1406.0

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

@@ -62,6 +62,7 @@ export interface NavigationConfig {
     site?: import("@wix/himalaya/core").SiteNavConfig;
     /** Signed release allowlist for contained browser Tier-5 `_stream` requests. */
     streamPolicy?: StreamPolicy;
+    topBarLogo?: import("@wix/himalaya/core").TopBarLogo;
     splash?: SplashConfig;
     locale?: LocaleConfig;
     backAffordance?: BackAffordanceConfig;

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

@@ -227,6 +227,9 @@ export interface DerivedAppMeta {
     site?: import("@wix/himalaya/core").SiteNavConfig;
     /** Forwarded from AppConfig.navigation.streamPolicy — the signed browser stream allowlist. */
     streamPolicy?: import("@wix/himalaya/core").StreamPolicy;
+    /** Forwarded from AppConfig.navigation.topBarLogo — the app-wide logo for tab-stack roots
+     *  (RFC 0066 amendment "top-bar gap items"). */
+    topBarLogo?: import("@wix/himalaya/core").TopBarLogo;
     /** Forwarded from AppConfig.`splash` — the in-app splash surface. NOTE the
      *  asymmetry with the fields above: this reads the TOP-LEVEL `config.splash`, not
      *  `config.navigation.splash`, because the same block also drives the build-time

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

@@ -640,6 +640,9 @@ export declare function mediaField(props: {
     valuePath: string;
     uploadService: string;
     label?: string;
+    presentation?: string;
+    fallbackTextPath?: string;
+    heading?: string;
 }, opts?: {
     id?: string;
 }): Component;

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

@@ -1656,6 +1656,12 @@ export interface MediaFieldProps {
     uploadService: string;
     /** Empty-well copy (a message key or literal). Default "Add a photo". */
     label?: string;
+    /** Set to "avatar" for a circular picker row; omitted preserves the 160pt image well. */
+    presentation?: string;
+    /** `$service:<svc>.<path>` → initials shown in avatar mode when no photo is set. */
+    fallbackTextPath?: string;
+    /** Optional visible heading in avatar mode; label remains the action caption. */
+    heading?: string;
 }
 /**
  * A formatted, multiline editor that writes HTML into an enclosing Form under `id`.
@@ -2694,6 +2700,8 @@ export interface NavigationConfig {
      *  links resolve as before. Build it with `siteNavConfig()` from
      *  `@himalaya/core/site-shell`; resolution is `resolveSiteLink()`. */
     site?: SiteNavConfig;
+    /** RFC 0066 amendment "top-bar gap items" — app-wide logo for tab-stack roots. */
+    topBarLogo?: TopBarLogo;
     scheme: string;
     deepLinkPatterns: DeepLinkPattern[];
     linkableScreens: LinkableScreen[];
@@ -2897,6 +2905,86 @@ export interface TopBarConfig {
     leading?: string;
     /** Content-under-bar: "" | "opaque" (default) | "transparent" | "immersive". */
     style?: string;
+    /** RFC 0066 §1 — toolbar items (drawn after the legacy `actions`). */
+    items?: ToolbarItem[];
+    /** RFC 0066 §1 — "" / "automatic" (default) | "large" | "inline". */
+    titleDisplay?: string;
+    /** RFC 0066 §1 — the literal subtitle (the fallback for `subtitlePath`). */
+    subtitle?: string;
+    /** RFC 0066 §1 — "" / "visible" (default) | "hidden". */
+    visibility?: string;
+    /** RFC 0066 §1 — bar fill token. iOS 26 keeps the system glass (amendment R12). */
+    background?: TokenRef;
+    /** RFC 0066 amendment — the screen's logo; overrides `NavigationConfig.topBarLogo`. */
+    logo?: TopBarLogo;
+    /** RFC 0066 amendment — the title as a menu. */
+    titleMenu?: TopBarTitleMenu;
+    /** RFC 0066 amendment — live subtitle (`$service:`); `subtitle` is the fallback. */
+    subtitlePath?: string;
+    /** RFC 0066 amendment — "" / "pinned" (default) | "hide_on_scroll". */
+    scrollBehavior?: string;
+    /** RFC 0066 amendment — truthy ⇒ leaving the presentation asks to discard. Unset/unresolved ⇒ false. */
+    dirtyPath?: string;
+}
+/** RFC 0066 §1 (+ its "top-bar gap items" amendment) — one top-bar item. Test id `toolbar.<id>`
+ *  (`toolbar-<id>` on web and React Native). Every tap carries an existing `Action`
+ *  (invariant 15). Bindings are `$service:` sentinels resolved by the screen host. */
+export interface ToolbarItem {
+    id: string;
+    /** "leading" | "trailing" (default) | "principal" | "bottom" | "keyboard" | "overflow". */
+    placement?: string;
+    /** Text button when there is no icon; the accessible name always. */
+    label?: string;
+    icon?: IconRef;
+    onTap?: Action;
+    /** "" | "cancel" | "confirm" | "destructive". */
+    role?: string;
+    disabled?: boolean;
+    /** OR'd with `disabled`. For Save, bind "nothing to save" (e.g. `cannotSave`), never the dirty flag. */
+    disabledPath?: string;
+    /** Non-empty ⇒ the item opens a menu. */
+    menu?: MenuItem[];
+    /** "principal" only: a custom title view. */
+    content?: Component;
+    /** Truthy ⇒ a progress indicator replaces the item. Unset/unresolved ⇒ false. */
+    loadingPath?: string;
+    /** Set ⇒ the item draws an avatar; `label` stays the accessible name ("Profile" by default). */
+    avatar?: ToolbarAvatar;
+    /** Live label; `label` is the fallback. */
+    labelPath?: string;
+}
+/** RFC 0066 amendment — an avatar item. Images are absolute https URLs (resolve a Wix
+ *  media id with `wixMediaUrl` before publishing). */
+export interface ToolbarAvatar {
+    imageUrl?: string;
+    initials?: string;
+    imageUrlPath?: string;
+    initialsPath?: string;
+}
+/** RFC 0066 amendment — the bar logo, per screen (`TopBarConfig.logo`) or app-wide
+ *  (`NavigationConfig.topBarLogo`). `imageUrlPath` resolves by the parent's context: the
+ *  screen host per screen, the nav worker app-wide. */
+export interface TopBarLogo {
+    imageUrl?: string;
+    imageUrlDark?: string;
+    /** Baked asset name; wins over `imageUrl`. */
+    imageAsset?: string;
+    /** Optional business name beside a mark-only logo. */
+    name?: string;
+    /** "" / "title" (default) | "leading" | "none". */
+    placement?: string;
+    imageUrlPath?: string;
+    /** Default: the app's display name. */
+    accessibilityLabel?: string;
+}
+/** RFC 0066 amendment — the title as a menu (switch location or feed). */
+export interface TopBarTitleMenu {
+    items?: MenuItem[];
+    selectedId?: string;
+    /** `selectedId` is the fallback. */
+    selectedIdPath?: string;
+    /** Default "<title>, switch". */
+    accessibilityLabel?: string;
 }
 /** RFC 0010 (top-bar amendment) — one trailing top-bar action. Reuses the
  *  design-system icon name, the `NavBadge` overlay, and the same `Action`

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

@@ -272,6 +272,181 @@ export declare const screenDescriptorSchema: {
                 readonly style: {
                     readonly type: "string";
                 };
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/toolbarItem";
+                    };
+                };
+                readonly titleDisplay: {
+                    readonly type: "string";
+                };
+                readonly subtitle: {
+                    readonly type: "string";
+                };
+                readonly visibility: {
+                    readonly type: "string";
+                };
+                readonly background: {
+                    readonly $ref: "#/$defs/tokenRef";
+                };
+                readonly logo: {
+                    readonly $ref: "#/$defs/topBarLogo";
+                };
+                readonly titleMenu: {
+                    readonly $ref: "#/$defs/topBarTitleMenu";
+                };
+                readonly subtitlePath: {
+                    readonly type: "string";
+                };
+                readonly scrollBehavior: {
+                    readonly type: "string";
+                };
+                readonly dirtyPath: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly toolbarItem: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["id"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly placement: {
+                    readonly type: "string";
+                };
+                readonly label: {
+                    readonly type: "string";
+                };
+                readonly icon: {
+                    readonly type: "string";
+                };
+                readonly onTap: {
+                    readonly $ref: "#/$defs/action";
+                };
+                readonly role: {
+                    readonly type: "string";
+                };
+                readonly disabled: {
+                    readonly type: "boolean";
+                };
+                readonly disabledPath: {
+                    readonly type: "string";
+                };
+                readonly menu: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/topBarMenuItem";
+                    };
+                };
+                readonly content: {
+                    readonly $ref: "#/$defs/component";
+                };
+                readonly loadingPath: {
+                    readonly type: "string";
+                };
+                readonly avatar: {
+                    readonly $ref: "#/$defs/toolbarAvatar";
+                };
+                readonly labelPath: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly toolbarAvatar: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly imageUrl: {
+                    readonly type: "string";
+                };
+                readonly initials: {
+                    readonly type: "string";
+                };
+                readonly imageUrlPath: {
+                    readonly type: "string";
+                };
+                readonly initialsPath: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly topBarLogo: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly imageUrl: {
+                    readonly type: "string";
+                };
+                readonly imageUrlDark: {
+                    readonly type: "string";
+                };
+                readonly imageAsset: {
+                    readonly type: "string";
+                };
+                readonly name: {
+                    readonly type: "string";
+                };
+                readonly placement: {
+                    readonly type: "string";
+                };
+                readonly imageUrlPath: {
+                    readonly type: "string";
+                };
+                readonly accessibilityLabel: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly topBarTitleMenu: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/topBarMenuItem";
+                    };
+                };
+                readonly selectedId: {
+                    readonly type: "string";
+                };
+                readonly selectedIdPath: {
+                    readonly type: "string";
+                };
+                readonly accessibilityLabel: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly topBarMenuItem: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["id", "label"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly label: {
+                    readonly type: "string";
+                };
+                readonly icon: {
+                    readonly type: "string";
+                };
+                readonly destructive: {
+                    readonly type: "boolean";
+                };
+                readonly disabled: {
+                    readonly type: "boolean";
+                };
+                readonly action: {
+                    readonly $ref: "#/$defs/action";
+                };
             };
         };
         readonly topBarAction: {
@@ -1260,6 +1435,181 @@ export declare const widgetSnapshotSchema: {
                 readonly style: {
                     readonly type: "string";
                 };
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/toolbarItem";
+                    };
+                };
+                readonly titleDisplay: {
+                    readonly type: "string";
+                };
+                readonly subtitle: {
+                    readonly type: "string";
+                };
+                readonly visibility: {
+                    readonly type: "string";
+                };
+                readonly background: {
+                    readonly $ref: "#/$defs/tokenRef";
+                };
+                readonly logo: {
+                    readonly $ref: "#/$defs/topBarLogo";
+                };
+                readonly titleMenu: {
+                    readonly $ref: "#/$defs/topBarTitleMenu";
+                };
+                readonly subtitlePath: {
+                    readonly type: "string";
+                };
+                readonly scrollBehavior: {
+                    readonly type: "string";
+                };
+                readonly dirtyPath: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly toolbarItem: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["id"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly placement: {
+                    readonly type: "string";
+                };
+                readonly label: {
+                    readonly type: "string";
+                };
+                readonly icon: {
+                    readonly type: "string";
+                };
+                readonly onTap: {
+                    readonly $ref: "#/$defs/action";
+                };
+                readonly role: {
+                    readonly type: "string";
+                };
+                readonly disabled: {
+                    readonly type: "boolean";
+                };
+                readonly disabledPath: {
+                    readonly type: "string";
+                };
+                readonly menu: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/topBarMenuItem";
+                    };
+                };
+                readonly content: {
+                    readonly $ref: "#/$defs/component";
+                };
+                readonly loadingPath: {
+                    readonly type: "string";
+                };
+                readonly avatar: {
+                    readonly $ref: "#/$defs/toolbarAvatar";
+                };
+                readonly labelPath: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly toolbarAvatar: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly imageUrl: {
+                    readonly type: "string";
+                };
+                readonly initials: {
+                    readonly type: "string";
+                };
+                readonly imageUrlPath: {
+                    readonly type: "string";
+                };
+                readonly initialsPath: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly topBarLogo: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly imageUrl: {
+                    readonly type: "string";
+                };
+                readonly imageUrlDark: {
+                    readonly type: "string";
+                };
+                readonly imageAsset: {
+                    readonly type: "string";
+                };
+                readonly name: {
+                    readonly type: "string";
+                };
+                readonly placement: {
+                    readonly type: "string";
+                };
+                readonly imageUrlPath: {
+                    readonly type: "string";
+                };
+                readonly accessibilityLabel: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly topBarTitleMenu: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/topBarMenuItem";
+                    };
+                };
+                readonly selectedId: {
+                    readonly type: "string";
+                };
+                readonly selectedIdPath: {
+                    readonly type: "string";
+                };
+                readonly accessibilityLabel: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly topBarMenuItem: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["id", "label"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly label: {
+                    readonly type: "string";
+                };
+                readonly icon: {
+                    readonly type: "string";
+                };
+                readonly destructive: {
+                    readonly type: "boolean";
+                };
+                readonly disabled: {
+                    readonly type: "boolean";
+                };
+                readonly action: {
+                    readonly $ref: "#/$defs/action";
+                };
             };
         };
         readonly topBarAction: {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/ai-site-chat/src/extensions.d.ts

@@ -0,0 +1,10 @@
+import type { WixCallOptions, WixStreamMessagesRequest } from "./index.js";
+/** Submits a visitor message (for example a visitor-option selection) to the widget's
+ *  `messages/stream` endpoint. This is a BUFFERED call, not a stream: the endpoint
+ *  answers with an SSE body, but the Wix bridge reads the whole body before it resolves,
+ *  so the promise settles only once the response has ended and the events are not
+ *  delivered as they arrive. The payload is returned opaque, as the bridge hands it
+ *  over. Native clients expose the same buffered call as `streamMessages`. The request
+ *  is sent as the visitor or member session the host supplies; a gateway error rejects.
+ *  @scope visitor — an anonymous visitor session is enough. */
+export declare function streamMessages(req: WixStreamMessagesRequest, opts?: WixCallOptions): Promise<unknown>;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/ai-site-chat/src/index.d.ts

@@ -0,0 +1,102 @@
+declare global {
+    var himalaya: {
+        wixApi?: {
+            call: (method: string, path: string, body?: unknown, headers?: Record<string, string>) => Promise<unknown>;
+        };
+    };
+}
+/** Per-call options. `site` addresses ONE call at a business other than the app's
+ *  active one, so a cross-site rollup can read several businesses concurrently without
+ *  `setActiveSite` moving the whole process between them. Omitted ⇒ the active business,
+ *  byte-identical to a call that never passed options.
+ *
+ *  `site.forSite(msid)` from `@himalaya/wix-platform` returns a value of this shape, so
+ *  it can be passed straight through: `someMethod(req, site.forSite(msid))`. */
+export interface WixCallOptions {
+    site?: string;
+}
+export declare function wixCall<T>(method: string, path: string, body?: unknown, opts?: WixCallOptions): Promise<T>;
+/** `path` with `req` appended as the query string Wix's RPC gateway reads a GET or
+ *  DELETE request from. A nested object flattens to dotted field paths
+ *  (`{ sort: { order: "ASC" } }` → `sort.order=ASC`), an array repeats its key
+ *  (`{ id: ["a", "b"] }` → `id=a&id=b`), and an absent field contributes nothing —
+ *  so an empty request yields the bare path. A field whose value is an array of
+ *  objects has no query-string spelling and is omitted, exactly as Wix's own client
+ *  omits it; such a field has to be sent through a POST sibling endpoint instead.
+ *
+ *  Built from template literals and `encodeURIComponent`, never `URLSearchParams`:
+ *  that is a host global the bare Tier-5 worker runtimes (JSCore / Hermes /
+ *  QuickJS-ng) do not provide, so reaching for it would throw a ReferenceError
+ *  before the request went out rather than degrade.
+ *
+ *  Exported so the hand-written ./extensions sidecar can build the same URLs. */
+export declare function wixQueryPath(path: string, req: unknown): string;
+export interface WixMessage {
+    id?: string;
+    createdDate?: string;
+    sender?: string;
+    conversationId?: string;
+    answerTo?: string;
+    messageType?: string;
+    body?: WixBody;
+    inboxId?: string;
+    visitorOptions?: string[];
+    assistantActions?: string[];
+    visitorOptionsFields?: Record<string, unknown>[];
+    engineStatus?: string;
+}
+export interface WixBody {
+    mainText?: string;
+    footerText?: string;
+    additionalData?: Record<string, unknown>[];
+}
+export interface WixListMessagesRequest {
+    cursorPaging?: WixCursorPaging;
+}
+export interface WixCursorPaging {
+    limit?: number;
+    cursor?: string;
+}
+export interface WixListMessagesResponse {
+    messages?: WixMessage[];
+    pagingMetadata?: WixPagingMetadataV2;
+}
+export interface WixPagingMetadataV2 {
+    count?: number;
+    offset?: number;
+    total?: number;
+    tooManyToCount?: boolean;
+    cursors?: WixCursors;
+    hasNext?: boolean;
+}
+export interface WixCursors {
+    next?: string;
+    prev?: string;
+}
+export interface WixStreamMessagesRequest {
+    message: WixStreamMessage;
+}
+export interface WixStreamMessage {
+    sender: "SITE_VISITOR";
+    messageType: "VISITOR_OPTION_SELECTED";
+    answerTo: string;
+    body: WixStreamMessageBody;
+}
+export interface WixStreamMessageBody {
+    mainText: string;
+    additionalData: WixStreamMessageAdditionalData[];
+}
+export interface WixStreamMessageAdditionalData {
+    id: string;
+    type: "select_option";
+    action: string;
+}
+/**
+ * Lists the messages of the AI Site Chat (Wix Smart Chat) conversation for the active site, paged by cursor via `cursorPaging`. Runs as the site visitor or member session the host supplies; an empty `messages` array means the conversation has no messages yet, and a 4xx/5xx rejects with the gateway error.
+ *
+ * @scope visitor — an anonymous visitor session is enough.
+ *
+ * GET /wix-assistant-widget/v1/messages/list
+ */
+export declare function listMessages(req?: WixListMessagesRequest, opts?: WixCallOptions): Promise<WixListMessagesResponse>;
+export * from "./extensions.js";