@wix/himalaya-cli 0.1405.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/ts/src/schema.d.ts

@@ -2700,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[];
@@ -2903,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/core.mjs

@@ -8271,7 +8271,88 @@ var screenDescriptorSchema = {
       properties: {
         actions: { type: "array", items: { $ref: "#/$defs/topBarAction" } },
         leading: { type: "string" },
-        style: { type: "string" }
+        style: { type: "string" },
+        // RFC 0066 §1 (fields 4–8) + the "top-bar gap items" amendment (#4414, fields
+        // 10–14). Discriminators stay free strings (invariant 6). Field 9 (`searchable`)
+        // arrives with the RFC 0010 search implementation.
+        items: { type: "array", items: { $ref: "#/$defs/toolbarItem" } },
+        titleDisplay: { type: "string" },
+        subtitle: { type: "string" },
+        visibility: { type: "string" },
+        background: { $ref: "#/$defs/tokenRef" },
+        logo: { $ref: "#/$defs/topBarLogo" },
+        titleMenu: { $ref: "#/$defs/topBarTitleMenu" },
+        subtitlePath: { type: "string" },
+        scrollBehavior: { type: "string" },
+        dirtyPath: { type: "string" }
+      }
+    },
+    toolbarItem: {
+      type: "object",
+      additionalProperties: false,
+      required: ["id"],
+      properties: {
+        id: { type: "string", minLength: 1 },
+        placement: { type: "string" },
+        label: { type: "string" },
+        icon: { type: "string" },
+        onTap: { $ref: "#/$defs/action" },
+        role: { type: "string" },
+        disabled: { type: "boolean" },
+        disabledPath: { type: "string" },
+        menu: { type: "array", items: { $ref: "#/$defs/topBarMenuItem" } },
+        content: { $ref: "#/$defs/component" },
+        loadingPath: { type: "string" },
+        avatar: { $ref: "#/$defs/toolbarAvatar" },
+        labelPath: { type: "string" }
+      }
+    },
+    toolbarAvatar: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        imageUrl: { type: "string" },
+        initials: { type: "string" },
+        imageUrlPath: { type: "string" },
+        initialsPath: { type: "string" }
+      }
+    },
+    topBarLogo: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        imageUrl: { type: "string" },
+        imageUrlDark: { type: "string" },
+        imageAsset: { type: "string" },
+        name: { type: "string" },
+        placement: { type: "string" },
+        imageUrlPath: { type: "string" },
+        accessibilityLabel: { type: "string" }
+      }
+    },
+    topBarTitleMenu: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        items: { type: "array", items: { $ref: "#/$defs/topBarMenuItem" } },
+        selectedId: { type: "string" },
+        selectedIdPath: { type: "string" },
+        accessibilityLabel: { type: "string" }
+      }
+    },
+    // The proto `MenuItem` (id, label, icon, destructive, disabled, action), as the
+    // top bar carries it outside a Menu component's props.
+    topBarMenuItem: {
+      type: "object",
+      additionalProperties: false,
+      required: ["id", "label"],
+      properties: {
+        id: { type: "string", minLength: 1 },
+        label: { type: "string" },
+        icon: { type: "string" },
+        destructive: { type: "boolean" },
+        disabled: { type: "boolean" },
+        action: { $ref: "#/$defs/action" }
       }
     },
     topBarAction: {

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

@@ -7141,7 +7141,88 @@ var screenDescriptorSchema = {
       properties: {
         actions: { type: "array", items: { $ref: "#/$defs/topBarAction" } },
         leading: { type: "string" },
-        style: { type: "string" }
+        style: { type: "string" },
+        // RFC 0066 §1 (fields 4–8) + the "top-bar gap items" amendment (#4414, fields
+        // 10–14). Discriminators stay free strings (invariant 6). Field 9 (`searchable`)
+        // arrives with the RFC 0010 search implementation.
+        items: { type: "array", items: { $ref: "#/$defs/toolbarItem" } },
+        titleDisplay: { type: "string" },
+        subtitle: { type: "string" },
+        visibility: { type: "string" },
+        background: { $ref: "#/$defs/tokenRef" },
+        logo: { $ref: "#/$defs/topBarLogo" },
+        titleMenu: { $ref: "#/$defs/topBarTitleMenu" },
+        subtitlePath: { type: "string" },
+        scrollBehavior: { type: "string" },
+        dirtyPath: { type: "string" }
+      }
+    },
+    toolbarItem: {
+      type: "object",
+      additionalProperties: false,
+      required: ["id"],
+      properties: {
+        id: { type: "string", minLength: 1 },
+        placement: { type: "string" },
+        label: { type: "string" },
+        icon: { type: "string" },
+        onTap: { $ref: "#/$defs/action" },
+        role: { type: "string" },
+        disabled: { type: "boolean" },
+        disabledPath: { type: "string" },
+        menu: { type: "array", items: { $ref: "#/$defs/topBarMenuItem" } },
+        content: { $ref: "#/$defs/component" },
+        loadingPath: { type: "string" },
+        avatar: { $ref: "#/$defs/toolbarAvatar" },
+        labelPath: { type: "string" }
+      }
+    },
+    toolbarAvatar: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        imageUrl: { type: "string" },
+        initials: { type: "string" },
+        imageUrlPath: { type: "string" },
+        initialsPath: { type: "string" }
+      }
+    },
+    topBarLogo: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        imageUrl: { type: "string" },
+        imageUrlDark: { type: "string" },
+        imageAsset: { type: "string" },
+        name: { type: "string" },
+        placement: { type: "string" },
+        imageUrlPath: { type: "string" },
+        accessibilityLabel: { type: "string" }
+      }
+    },
+    topBarTitleMenu: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        items: { type: "array", items: { $ref: "#/$defs/topBarMenuItem" } },
+        selectedId: { type: "string" },
+        selectedIdPath: { type: "string" },
+        accessibilityLabel: { type: "string" }
+      }
+    },
+    // The proto `MenuItem` (id, label, icon, destructive, disabled, action), as the
+    // top bar carries it outside a Menu component's props.
+    topBarMenuItem: {
+      type: "object",
+      additionalProperties: false,
+      required: ["id", "label"],
+      properties: {
+        id: { type: "string", minLength: 1 },
+        label: { type: "string" },
+        icon: { type: "string" },
+        destructive: { type: "boolean" },
+        disabled: { type: "boolean" },
+        action: { $ref: "#/$defs/action" }
       }
     },
     topBarAction: {
@@ -9114,6 +9195,7 @@ function deriveAppMeta(name, m, platforms = {}, provisioning = {}) {
     appIconBadgeSources: config.navigation?.appIconBadgeSources,
     site: config.navigation?.site,
     streamPolicy: config.navigation?.streamPolicy,
+    topBarLogo: config.navigation?.topBarLogo,
     splash: config.splash,
     locale: config.locale,
     deepLinkPatterns: config.navigation?.deepLinkPatterns,

package/dist/cli.mjs

@@ -7314,6 +7314,7 @@ function deriveAppMeta(name, m2, platforms = {}, provisioning = {}) {
     appIconBadgeSources: config.navigation?.appIconBadgeSources,
     site: config.navigation?.site,
     streamPolicy: config.navigation?.streamPolicy,
+    topBarLogo: config.navigation?.topBarLogo,
     splash: config.splash,
     locale: config.locale,
     deepLinkPatterns: config.navigation?.deepLinkPatterns,
@@ -8107,7 +8108,88 @@ var init_validator = __esm({
           properties: {
             actions: { type: "array", items: { $ref: "#/$defs/topBarAction" } },
             leading: { type: "string" },
-            style: { type: "string" }
+            style: { type: "string" },
+            // RFC 0066 §1 (fields 4–8) + the "top-bar gap items" amendment (#4414, fields
+            // 10–14). Discriminators stay free strings (invariant 6). Field 9 (`searchable`)
+            // arrives with the RFC 0010 search implementation.
+            items: { type: "array", items: { $ref: "#/$defs/toolbarItem" } },
+            titleDisplay: { type: "string" },
+            subtitle: { type: "string" },
+            visibility: { type: "string" },
+            background: { $ref: "#/$defs/tokenRef" },
+            logo: { $ref: "#/$defs/topBarLogo" },
+            titleMenu: { $ref: "#/$defs/topBarTitleMenu" },
+            subtitlePath: { type: "string" },
+            scrollBehavior: { type: "string" },
+            dirtyPath: { type: "string" }
+          }
+        },
+        toolbarItem: {
+          type: "object",
+          additionalProperties: false,
+          required: ["id"],
+          properties: {
+            id: { type: "string", minLength: 1 },
+            placement: { type: "string" },
+            label: { type: "string" },
+            icon: { type: "string" },
+            onTap: { $ref: "#/$defs/action" },
+            role: { type: "string" },
+            disabled: { type: "boolean" },
+            disabledPath: { type: "string" },
+            menu: { type: "array", items: { $ref: "#/$defs/topBarMenuItem" } },
+            content: { $ref: "#/$defs/component" },
+            loadingPath: { type: "string" },
+            avatar: { $ref: "#/$defs/toolbarAvatar" },
+            labelPath: { type: "string" }
+          }
+        },
+        toolbarAvatar: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            imageUrl: { type: "string" },
+            initials: { type: "string" },
+            imageUrlPath: { type: "string" },
+            initialsPath: { type: "string" }
+          }
+        },
+        topBarLogo: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            imageUrl: { type: "string" },
+            imageUrlDark: { type: "string" },
+            imageAsset: { type: "string" },
+            name: { type: "string" },
+            placement: { type: "string" },
+            imageUrlPath: { type: "string" },
+            accessibilityLabel: { type: "string" }
+          }
+        },
+        topBarTitleMenu: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            items: { type: "array", items: { $ref: "#/$defs/topBarMenuItem" } },
+            selectedId: { type: "string" },
+            selectedIdPath: { type: "string" },
+            accessibilityLabel: { type: "string" }
+          }
+        },
+        // The proto `MenuItem` (id, label, icon, destructive, disabled, action), as the
+        // top bar carries it outside a Menu component's props.
+        topBarMenuItem: {
+          type: "object",
+          additionalProperties: false,
+          required: ["id", "label"],
+          properties: {
+            id: { type: "string", minLength: 1 },
+            label: { type: "string" },
+            icon: { type: "string" },
+            destructive: { type: "boolean" },
+            disabled: { type: "boolean" },
+            action: { $ref: "#/$defs/action" }
           }
         },
         topBarAction: {
@@ -9986,6 +10068,8 @@ __export(validate_descriptor_core_exports, {
   findSkipDerive: () => findSkipDerive,
   installedActionEvaluator: () => installedActionEvaluator,
   installedBootEvaluator: () => installedBootEvaluator,
+  isInLenientTopBarBlock: () => isInLenientTopBarBlock,
+  isLenientTopBarSubtree: () => isLenientTopBarSubtree,
   isOpaqueAuthorJson: () => isOpaqueAuthorJson,
   loadBundleServicesLive: () => loadBundleServicesLive,
   nativeRequiredFindings: () => nativeRequiredFindings,
@@ -10000,6 +10084,7 @@ __export(validate_descriptor_core_exports, {
   setActionEvaluator: () => setActionEvaluator,
   setBootEvaluator: () => setBootEvaluator,
   setDefaultEvaluator: () => setDefaultEvaluator,
+  topBarFindings: () => topBarFindings,
   validateScreenDescriptor: () => validateScreenDescriptor,
   workerSubtreeAllowed: () => workerSubtreeAllowed
 });
@@ -10744,6 +10829,13 @@ function pathCrossesOpaqueAuthorJson(path2) {
   if (typeof path2 !== "string") return false;
   return /^\$\.input(?:[.[]|$)/.test(path2) || /\.args(?:[.[]|$)/.test(path2);
 }
+function isLenientTopBarSubtree(parentPath, key2) {
+  return parentPath === "topBar" && LENIENT_TOP_BAR_BLOCKS.has(key2);
+}
+function isInLenientTopBarBlock(path2) {
+  const m2 = /^topBar\.([A-Za-z]+)(?:[.[]|$)/.exec(path2);
+  return !!m2 && LENIENT_TOP_BAR_BLOCKS.has(m2[1]);
+}
 function nativeRequiredFindings(descriptor) {
   const out2 = [];
   const shapeOf = (ref) => ref.startsWith("list:") ? "an array" : ref.startsWith("map:") ? "an object keyed by name" : "an object";
@@ -10860,6 +10952,7 @@ function nativeRequiredFindings(descriptor) {
     }
     for (const [k2, v2] of Object.entries(record2)) {
       if (isOpaqueAuthorJson(k2, v2, at2 === "")) continue;
+      if (isLenientTopBarSubtree(at2, k2)) continue;
       walk2(v2, at2 ? `${at2}.${k2}` : k2);
     }
   };
@@ -11450,6 +11543,52 @@ function bottomSheetFindings(descriptor) {
   visit(descriptor, "", true);
   return out2;
 }
+function topBarFindings(descriptor) {
+  const out2 = [];
+  const bar = descriptor?.topBar;
+  if (!bar || typeof bar !== "object") return out2;
+  const b2 = bar;
+  const legacy = Array.isArray(b2.actions) ? b2.actions.length : 0;
+  const items = Array.isArray(b2.items) ? b2.items : [];
+  const trailingItems = items.filter((i2) => i2 && typeof i2 === "object" && !TOP_BAR_NON_TRAILING.has(String(i2.placement ?? "")));
+  const hasOverflow = items.some((i2) => i2?.placement === "overflow");
+  if (legacy > TOP_BAR_TRAILING_LIMIT) {
+    out2.push({ path: "topBar.actions", message: `The top bar has ${legacy} legacy actions. The guideline shows at most two trailing slots; legacy actions are never moved, so all ${legacy} still draw. Move the extra ones into \`items\` with \`placement: "overflow"\`` });
+  } else if (legacy + trailingItems.length + (hasOverflow ? 1 : 0) > TOP_BAR_TRAILING_LIMIT) {
+    out2.push({ path: "topBar.items", message: `The top bar declares ${legacy + trailingItems.length + (hasOverflow ? 1 : 0)} trailing slots; at most two show. The shell moves the extra items into More Actions in authored order (RFC 0066 amendment R2)` });
+  }
+  const logo = b2.logo;
+  const logoInTitle = logo && typeof logo === "object" && logo.placement !== "leading" && logo.placement !== "none";
+  if (b2.titleMenu && logoInTitle) {
+    out2.push({ path: "topBar.titleMenu", message: 'The top bar sets both `titleMenu` and a title-placement `logo`. The title position holds one control, so the shell draws the title menu and not the logo (R7). Remove the logo, or set `logo.placement: "leading"`' });
+  }
+  if (typeof b2.dirtyPath === "string" && b2.dirtyPath !== "") {
+    items.forEach((i2, idx) => {
+      if (i2?.role === "confirm" && i2.disabledPath === b2.dirtyPath) {
+        out2.push({ path: `topBar.items[${idx}].disabledPath`, message: `This confirm item's \`disabledPath\` is the same binding as \`topBar.dirtyPath\` (${JSON.stringify(b2.dirtyPath)}), so it is disabled exactly when there are changes to save. Bind \`disabledPath\` to "nothing to save" (for example \`$service:form.cannotSave\`) (R3)` });
+      }
+    });
+  }
+  const notHttps = (v2) => {
+    if (typeof v2 !== "string" || v2 === "") return false;
+    if (!/^https:\/\/[^/?#\s]/i.test(v2)) return true;
+    try {
+      return new URL(v2).hostname === "";
+    } catch {
+      return true;
+    }
+  };
+  items.forEach((i2, idx) => {
+    const avatar = i2?.avatar;
+    if (avatar && notHttps(avatar.imageUrl)) out2.push({ path: `topBar.items[${idx}].avatar.imageUrl`, message: `Avatar imageUrl ${JSON.stringify(avatar.imageUrl)} is not an absolute https URL; resolve a Wix media id with wixMediaUrl before publishing it` });
+  });
+  if (logo && typeof logo === "object") {
+    for (const key2 of ["imageUrl", "imageUrlDark"]) {
+      if (notHttps(logo[key2])) out2.push({ path: `topBar.logo.${key2}`, message: `Logo ${key2} ${JSON.stringify(logo[key2])} is not an absolute https URL; resolve a Wix media id with wixMediaUrl before publishing it` });
+    }
+  }
+  return out2;
+}
 function buttonVariantFindings(descriptor) {
   const out2 = [];
   const visit = (v2, path2, atRoot) => {
@@ -11655,6 +11794,9 @@ function validateScreenDescriptor(screenId, descriptor, opts = {}) {
   for (const finding of bottomSheetFindings(descriptor)) {
     issues.push({ severity: "error", pass: "bottom-sheet", path: finding.path, message: finding.message });
   }
+  for (const finding of topBarFindings(descriptor)) {
+    issues.push({ severity: "warning", pass: "top-bar", path: finding.path, message: finding.message });
+  }
   const bindings = collectServiceBindings(descriptor);
   const descriptorActions = collectDescriptorActions(descriptor);
   const workerActions = descriptorActions.filter(({ actionId }) => actionId.startsWith("tier5."));
@@ -11879,6 +12021,7 @@ function validateScreenDescriptor(screenId, descriptor, opts = {}) {
     for (const [k2, val] of Object.entries(node)) {
       if (isOpaqueAuthorJson(k2, val, at2 === "")) continue;
       if (k2 === "params" && typeof node.actionId === "string") continue;
+      if (isLenientTopBarSubtree(at2, k2)) continue;
       const here = at2 ? `${at2}.${k2}` : k2;
       const allowed2 = own3(NATIVE_PROP_ENUMS, k2);
       if (typeof val === "string" && enums.has(k2) && DYNAMIC_PLACEHOLDER.test(val)) {
@@ -11917,7 +12060,7 @@ function validateScreenDescriptor(screenId, descriptor, opts = {}) {
   const propFindings = componentPropFindings(descriptor);
   for (const finding of [
     ...nativeRequiredFindings(descriptor),
-    ...propFindings.filter((f2) => f2.kind === "decode")
+    ...propFindings.filter((f2) => f2.kind === "decode" && !isInLenientTopBarBlock(f2.path))
   ]) {
     const candidates = (schemaIssuesAt.get(finding.path) ?? []).filter((i2) => !consumed.has(i2) && !superseded.has(i2));
     const [duplicate, ...alsoAboutThisField] = candidates;
@@ -12153,7 +12296,7 @@ function validateScreenDescriptor(screenId, descriptor, opts = {}) {
     services: Object.keys(services)
   };
 }
-var CRAWL_BLOCKING_PASSES, BOOT_EVAL_TIMEOUT_MS, DRIFT_PROBES, DEVICE_PARITY_WITHHELD, defaultEvaluator, bootEvaluator, actionEvaluator, NATIVE_PROP_ENUMS, KNOWN_PROPS, IN_ARRAY_BINDING_PROPS, SERVICE_SIGIL, INTEGER_PROPS, NATIVE_REQUIRED_PROPS, bareNestedClass, NATIVE_NESTED_CLASSES, NATIVE_MODIFIERS_CLASS, NATIVE_DESCRIPTOR_CLASS, NATIVE_DESCRIPTOR_NESTED, NATIVE_NESTED_PROPS, MODIFIER_KEYS, INTEGER_MODIFIERS, MODIFIER_KINDS, SCHEMA_SCORED_NODES, CORE_PACKAGES, LEGACY_UNSCORED_KEYS, DYNAMIC_PLACEHOLDER, LITERAL_ONLY_PROPS, SERVICE_ONLY_BINDING_PROPS, WHOLE_VALUE_BINDING, EMBEDDED_BINDING, OPTIONS_BINDING_PROPS, EDITOR_SERVICE_NAME, SHEET_PLACEMENTS, BUTTON_STYLES, EMPTY_STATE_ACTION_STYLES, EMPTY_STATE_ACTION_SIZES;
+var CRAWL_BLOCKING_PASSES, BOOT_EVAL_TIMEOUT_MS, DRIFT_PROBES, DEVICE_PARITY_WITHHELD, defaultEvaluator, bootEvaluator, actionEvaluator, NATIVE_PROP_ENUMS, KNOWN_PROPS, IN_ARRAY_BINDING_PROPS, SERVICE_SIGIL, INTEGER_PROPS, NATIVE_REQUIRED_PROPS, bareNestedClass, NATIVE_NESTED_CLASSES, NATIVE_MODIFIERS_CLASS, NATIVE_DESCRIPTOR_CLASS, NATIVE_DESCRIPTOR_NESTED, NATIVE_NESTED_PROPS, LENIENT_TOP_BAR_BLOCKS, MODIFIER_KEYS, INTEGER_MODIFIERS, MODIFIER_KINDS, SCHEMA_SCORED_NODES, CORE_PACKAGES, LEGACY_UNSCORED_KEYS, DYNAMIC_PLACEHOLDER, LITERAL_ONLY_PROPS, SERVICE_ONLY_BINDING_PROPS, WHOLE_VALUE_BINDING, EMBEDDED_BINDING, OPTIONS_BINDING_PROPS, EDITOR_SERVICE_NAME, SHEET_PLACEMENTS, TOP_BAR_TRAILING_LIMIT, TOP_BAR_NON_TRAILING, BUTTON_STYLES, EMPTY_STATE_ACTION_STYLES, EMPTY_STATE_ACTION_SIZES;
 var init_validate_descriptor_core = __esm({
   "../../core/dev-server/src/validate-descriptor.core.ts"() {
     init_validator();
@@ -13072,6 +13215,7 @@ var init_validate_descriptor_core = __esm({
       WheelPicker: { options: "list:PickerOption", onChange: "Action" },
       WorkerSubtree: { policy: "WorkerSubtreePolicy" }
     };
+    LENIENT_TOP_BAR_BLOCKS = /* @__PURE__ */ new Set(["items", "titleMenu", "logo", "background"]);
     MODIFIER_KEYS = new Set(
       Object.keys(screenDescriptorSchema.$defs.modifiers.properties)
     );
@@ -13143,6 +13287,8 @@ var init_validate_descriptor_core = __esm({
     OPTIONS_BINDING_PROPS = /* @__PURE__ */ new Set(["optionsPath"]);
     EDITOR_SERVICE_NAME = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
     SHEET_PLACEMENTS = /* @__PURE__ */ new Set(["overlay", "inline"]);
+    TOP_BAR_TRAILING_LIMIT = 2;
+    TOP_BAR_NON_TRAILING = /* @__PURE__ */ new Set(["leading", "principal", "bottom", "keyboard", "overflow"]);
     BUTTON_STYLES = /* @__PURE__ */ new Set(["filled", "tonal", "outlined", "text", "elevated", "bordered", "prominent", "plain", "glass", "primary", "secondary", "tertiary", "link", "destructive"]);
     EMPTY_STATE_ACTION_STYLES = /* @__PURE__ */ new Set(["primary", "secondary", "plain"]);
     EMPTY_STATE_ACTION_SIZES = /* @__PURE__ */ new Set(["sm", "md"]);
@@ -13697,6 +13843,8 @@ __export(validate_descriptor_exports, {
   findSkipDerive: () => findSkipDerive,
   installedActionEvaluator: () => installedActionEvaluator,
   installedBootEvaluator: () => installedBootEvaluator,
+  isInLenientTopBarBlock: () => isInLenientTopBarBlock,
+  isLenientTopBarSubtree: () => isLenientTopBarSubtree,
   isOpaqueAuthorJson: () => isOpaqueAuthorJson,
   loadAllowedComponents: () => loadAllowedComponents,
   loadBundleServicesLive: () => loadBundleServicesLive,
@@ -13717,6 +13865,7 @@ __export(validate_descriptor_exports, {
   setActionEvaluator: () => setActionEvaluator,
   setBootEvaluator: () => setBootEvaluator,
   setDefaultEvaluator: () => setDefaultEvaluator,
+  topBarFindings: () => topBarFindings,
   validateScreenDescriptor: () => validateScreenDescriptor,
   workerSubtreeAllowed: () => workerSubtreeAllowed
 });
@@ -29343,6 +29492,7 @@ function deriveNavigationConfig(app, bundleCtx) {
   if (app.appIconBadgeSources !== void 0) config.appIconBadgeSources = app.appIconBadgeSources;
   if (app.site !== void 0) config.site = app.site;
   if (app.streamPolicy !== void 0) config.streamPolicy = app.streamPolicy;
+  if (app.topBarLogo !== void 0) config.topBarLogo = app.topBarLogo;
   if (app.splash !== void 0) config.splash = app.splash;
   if (app.locale !== void 0) config.locale = app.locale;
   if (app.homeScreenId) config.homeScreenId = app.homeScreenId;
@@ -151722,6 +151872,7 @@ var init_nav_lint = __esm({
       "appIconBadgeSources",
       "streamPolicy",
       "site",
+      "topBarLogo",
       "scheme",
       "deepLinkPatterns",
       "linkableScreens"
@@ -151747,6 +151898,7 @@ var init_nav_lint = __esm({
       "appIconBadgeSources",
       "streamPolicy",
       "site",
+      "topBarLogo",
       "scheme",
       "deepLinkPatterns",
       "linkableScreens"

package/guides/sdk-reference.json

@@ -1053,7 +1053,7 @@
         "name": "NavigationConfig",
         "kind": "interface",
         "jsdoc": "/** Per-app navigation/deep-link config, served OTA at GET /v1/app-config/:appName. */",
-        "decl": "export interface NavigationConfig {\n  /** Tab-bar structure (which tabs; their icons/labels/badges). */\n  tabBar?: TabBarConfig;\n  /** Slide-in drawer / hamburger-menu destinations. */\n  drawer?: DrawerConfig;\n  /** Navigation chrome the shell draws.\n   *  Omitted ⇒ \"bottomTabs\". The shell (not the descriptor) reads this. */\n  navKind?: NavKind;\n  /** Destinations for \"sidebar\" mode.\n   *  Absent ⇒ the shell derives the rail from `tabBar.items`. */\n  sidebar?: SidebarConfig;\n  /** App-level default top bar; a per-screen\n   *  `ScreenDescriptor.topBar` fully replaces it (override, not merge). */\n  topBarDefault?: TopBarConfig;\n  /** The post-OS-splash brand surface (see `SplashConfig`). Absent / not enabled\n   * ⇒ today's behavior. Operational per (live-flippable). */\n  splash?: SplashConfig;\n  /** App-level default locale. Operational per so a Hebrew (or Spanish)\n   *  branded app can pin RTL/l10n OTA without a launch flag. `default` is a\n   *  BCP-47 primary subtag; clients coerce unknown tags rather than failing the\n   *  envelope. `pin: true` skips the device/browser language; in-app `locale.set`\n   *  still wins. Absent ⇒ today's device-then-en behavior. */\n  locale?: LocaleConfig;\n  /** Effective orientations, resolved INSIDE\n   *  the binary's build-time envelope (config.ts `orientationEnvelope`). The\n   *  envelope is the ceiling and can never be OTA (iOS reads the plist before\n   *  any app code runs); this narrows within it. Always intersected with the\n   *  envelope — it can never widen it. Absent/empty ⇒ the envelope itself. */\n  orientation?: OrientationConfig;\n  /** Per-surface nav projection, keyed by catalog\n   *  surface id (`phone` | `tablet` | `desktop` | `mac` | `watch` | `wear` | `rn`).\n   *  Keyed the way `orientation` is keyed by device family and narrowed the same\n   *  way: a key outside the app's `platforms.json` envelope is DROPPED, never\n   *  honored (see `resolveSurfaceNav`). Absent key ⇒ that surface uses the default\n   *  projection, so an app that never thinks about surfaces is unaffected. */\n  surfaces?: Record<string, SurfaceNavConfig>;\n  /** The APP-LEVEL nav worker\n   *  that feeds every `*Path` binding on `NavTabItem` / `DrawerItem` /\n   *  `TopBarAction`. App-level, not a screen's worker, because chrome outlives\n   *  every screen: a cart badge must survive leaving the cart, and a flag-hidden\n   *  tab must stay hidden three pushes deep in another stack. Absent ⇒ paths stay\n   *  unresolved and the literals render — the worker enriches, it never gates. */\n  navLogicBundle?: LogicBundleRef;\n  /** Which nav badges ALSO drive the OS app-icon\n   *  badge. Each entry is `\"<kind>:<id>\"` (`tab` | `drawer` | `topBarAction`, the\n   *  spelling `navKey` uses); the icon shows the SUM of those slots' resolved counts.\n   *  Empty/absent ⇒ no mirroring. An entry naming a slot this build does not have is\n   *  ignored, never a blanked badge. Requires the `push` capability — `defineApp`\n   *  rejects the combination, because the badge would be set and never shown. */\n  appIconBadgeSources?: string[];\n  /** Signed release allowlist for contained browser Tier-5 `_stream` requests. */\n  streamPolicy?: StreamPolicy;\n  /** A site shell's URL space. A push tap, app link or\n   *  custom-scheme link whose URL is an https page on one of `site.origins` opens the\n   *  screen owning its path, and that screen's WebView loads the full URL. Absent ⇒\n   *  links resolve as before. Build it with `siteNavConfig()` from\n   *  `@himalaya/core/site-shell`; resolution is `resolveSiteLink()`. */\n  site?: SiteNavConfig;\n  scheme: string;\n  deepLinkPatterns: DeepLinkPattern[];\n  linkableScreens: LinkableScreen[];\n}"
+        "decl": "export interface NavigationConfig {\n  /** Tab-bar structure (which tabs; their icons/labels/badges). */\n  tabBar?: TabBarConfig;\n  /** Slide-in drawer / hamburger-menu destinations. */\n  drawer?: DrawerConfig;\n  /** Navigation chrome the shell draws.\n   *  Omitted ⇒ \"bottomTabs\". The shell (not the descriptor) reads this. */\n  navKind?: NavKind;\n  /** Destinations for \"sidebar\" mode.\n   *  Absent ⇒ the shell derives the rail from `tabBar.items`. */\n  sidebar?: SidebarConfig;\n  /** App-level default top bar; a per-screen\n   *  `ScreenDescriptor.topBar` fully replaces it (override, not merge). */\n  topBarDefault?: TopBarConfig;\n  /** The post-OS-splash brand surface (see `SplashConfig`). Absent / not enabled\n   * ⇒ today's behavior. Operational per (live-flippable). */\n  splash?: SplashConfig;\n  /** App-level default locale. Operational per so a Hebrew (or Spanish)\n   *  branded app can pin RTL/l10n OTA without a launch flag. `default` is a\n   *  BCP-47 primary subtag; clients coerce unknown tags rather than failing the\n   *  envelope. `pin: true` skips the device/browser language; in-app `locale.set`\n   *  still wins. Absent ⇒ today's device-then-en behavior. */\n  locale?: LocaleConfig;\n  /** Effective orientations, resolved INSIDE\n   *  the binary's build-time envelope (config.ts `orientationEnvelope`). The\n   *  envelope is the ceiling and can never be OTA (iOS reads the plist before\n   *  any app code runs); this narrows within it. Always intersected with the\n   *  envelope — it can never widen it. Absent/empty ⇒ the envelope itself. */\n  orientation?: OrientationConfig;\n  /** Per-surface nav projection, keyed by catalog\n   *  surface id (`phone` | `tablet` | `desktop` | `mac` | `watch` | `wear` | `rn`).\n   *  Keyed the way `orientation` is keyed by device family and narrowed the same\n   *  way: a key outside the app's `platforms.json` envelope is DROPPED, never\n   *  honored (see `resolveSurfaceNav`). Absent key ⇒ that surface uses the default\n   *  projection, so an app that never thinks about surfaces is unaffected. */\n  surfaces?: Record<string, SurfaceNavConfig>;\n  /** The APP-LEVEL nav worker\n   *  that feeds every `*Path` binding on `NavTabItem` / `DrawerItem` /\n   *  `TopBarAction`. App-level, not a screen's worker, because chrome outlives\n   *  every screen: a cart badge must survive leaving the cart, and a flag-hidden\n   *  tab must stay hidden three pushes deep in another stack. Absent ⇒ paths stay\n   *  unresolved and the literals render — the worker enriches, it never gates. */\n  navLogicBundle?: LogicBundleRef;\n  /** Which nav badges ALSO drive the OS app-icon\n   *  badge. Each entry is `\"<kind>:<id>\"` (`tab` | `drawer` | `topBarAction`, the\n   *  spelling `navKey` uses); the icon shows the SUM of those slots' resolved counts.\n   *  Empty/absent ⇒ no mirroring. An entry naming a slot this build does not have is\n   *  ignored, never a blanked badge. Requires the `push` capability — `defineApp`\n   *  rejects the combination, because the badge would be set and never shown. */\n  appIconBadgeSources?: string[];\n  /** Signed release allowlist for contained browser Tier-5 `_stream` requests. */\n  streamPolicy?: StreamPolicy;\n  /** A site shell's URL space. A push tap, app link or\n   *  custom-scheme link whose URL is an https page on one of `site.origins` opens the\n   *  screen owning its path, and that screen's WebView loads the full URL. Absent ⇒\n   *  links resolve as before. Build it with `siteNavConfig()` from\n   *  `@himalaya/core/site-shell`; resolution is `resolveSiteLink()`. */\n  site?: SiteNavConfig;\n  /** amendment \"top-bar gap items\" — app-wide logo for tab-stack roots. */\n  topBarLogo?: TopBarLogo;\n  scheme: string;\n  deepLinkPatterns: DeepLinkPattern[];\n  linkableScreens: LinkableScreen[];\n}"
       },
       {
         "name": "NavKind",
@@ -1095,7 +1095,7 @@
         "name": "TopBarConfig",
         "kind": "interface",
         "jsdoc": "/** The shell-owned top bar. The shell paints\n *  `ScreenDescriptor.title` and computes the leading slot (back XOR menu) from\n *  nav depth; this adds the trailing action cluster + leading/style overrides.\n *  Lives on `ScreenDescriptor.topBar` (authoritative) and\n *  `NavigationConfig.topBarDefault` (app-level fallback, fully replaced). */",
-        "decl": "export interface TopBarConfig {\n  /** Trailing (right-edge) actions, authored order = leading→trailing. */\n  actions?: TopBarAction[];\n  /** Leading override: \"\" | \"auto\" (shell-computed) | \"back\" | \"menu\" | \"none\". */\n  leading?: string;\n  /** Content-under-bar: \"\" | \"opaque\" (default) | \"transparent\" | \"immersive\". */\n  style?: string;\n}"
+        "decl": "export interface TopBarConfig {\n  /** Trailing (right-edge) actions, authored order = leading→trailing. */\n  actions?: TopBarAction[];\n  /** Leading override: \"\" | \"auto\" (shell-computed) | \"back\" | \"menu\" | \"none\". */\n  leading?: string;\n  /** Content-under-bar: \"\" | \"opaque\" (default) | \"transparent\" | \"immersive\". */\n  style?: string;\n  /** Toolbar items (drawn after the legacy `actions`). */\n  items?: ToolbarItem[];\n  /** \"\" / \"automatic\" (default) | \"large\" | \"inline\". */\n  titleDisplay?: string;\n  /** The literal subtitle (the fallback for `subtitlePath`). */\n  subtitle?: string;\n  /** \"\" / \"visible\" (default) | \"hidden\". */\n  visibility?: string;\n  /** Bar fill token. iOS 26 keeps the system glass (amendment R12). */\n  background?: TokenRef;\n  // Field 9 (`searchable`) belongs to the \"Native top-bar search\" implementation.\n  /** amendment — the screen's logo; overrides `NavigationConfig.topBarLogo`. */\n  logo?: TopBarLogo;\n  /** amendment — the title as a menu. */\n  titleMenu?: TopBarTitleMenu;\n  /** amendment — live subtitle (`$service:`); `subtitle` is the fallback. */\n  subtitlePath?: string;\n  /** amendment — \"\" / \"pinned\" (default) | \"hide_on_scroll\". */\n  scrollBehavior?: string;\n  /** amendment — truthy ⇒ leaving the presentation asks to discard. Unset/unresolved ⇒ false. */\n  dirtyPath?: string;\n}"
       },
       {
         "name": "SplashConfig",
@@ -1151,6 +1151,30 @@
         "jsdoc": "/** One entry of {@link SiteNavConfig.routes}. */",
         "decl": "export interface SiteRoute {\n  /** Site-relative path prefix: `\"/\"`, `\"/shop\"`, `\"/blog\"`. */\n  path: string;\n  /** The screen whose WebView loads the URL. */\n  screenId: string;\n}"
       },
+      {
+        "name": "TopBarLogo",
+        "kind": "interface",
+        "jsdoc": "/** amendment — the bar logo, per screen (`TopBarConfig.logo`) or app-wide\n *  (`NavigationConfig.topBarLogo`). `imageUrlPath` resolves by the parent's context: the\n *  screen host per screen, the nav worker app-wide. */",
+        "decl": "export interface TopBarLogo {\n  imageUrl?: string;\n  imageUrlDark?: string;\n  /** Baked asset name; wins over `imageUrl`. */\n  imageAsset?: string;\n  /** Optional business name beside a mark-only logo. */\n  name?: string;\n  /** \"\" / \"title\" (default) | \"leading\" | \"none\". */\n  placement?: string;\n  imageUrlPath?: string;\n  /** Default: the app's display name. */\n  accessibilityLabel?: string;\n}"
+      },
+      {
+        "name": "ToolbarItem",
+        "kind": "interface",
+        "jsdoc": "/** One top-bar item. Test id `toolbar.<id>`\n *  (`toolbar-<id>` on web and React Native). Every tap carries an existing `Action`\n *. Bindings are `$service:` sentinels resolved by the screen host. */",
+        "decl": "export interface ToolbarItem {\n  id: string;\n  /** \"leading\" | \"trailing\" (default) | \"principal\" | \"bottom\" | \"keyboard\" | \"overflow\". */\n  placement?: string;\n  /** Text button when there is no icon; the accessible name always. */\n  label?: string;\n  icon?: IconRef;\n  onTap?: Action;\n  /** \"\" | \"cancel\" | \"confirm\" | \"destructive\". */\n  role?: string;\n  disabled?: boolean;\n  /** OR'd with `disabled`. For Save, bind \"nothing to save\" (e.g. `cannotSave`), never the dirty flag. */\n  disabledPath?: string;\n  /** Non-empty ⇒ the item opens a menu. */\n  menu?: MenuItem[];\n  /** \"principal\" only: a custom title view. */\n  content?: Component;\n  /** Truthy ⇒ a progress indicator replaces the item. Unset/unresolved ⇒ false. */\n  loadingPath?: string;\n  /** Set ⇒ the item draws an avatar; `label` stays the accessible name (\"Profile\" by default). */\n  avatar?: ToolbarAvatar;\n  /** Live label; `label` is the fallback. */\n  labelPath?: string;\n}"
+      },
+      {
+        "name": "ToolbarAvatar",
+        "kind": "interface",
+        "jsdoc": "/** amendment — an avatar item. Images are absolute https URLs (resolve a Wix\n *  media id with `wixMediaUrl` before publishing). */",
+        "decl": "export interface ToolbarAvatar {\n  imageUrl?: string;\n  initials?: string;\n  imageUrlPath?: string;\n  initialsPath?: string;\n}"
+      },
+      {
+        "name": "TopBarTitleMenu",
+        "kind": "interface",
+        "jsdoc": "/** amendment — the title as a menu (switch location or feed). */",
+        "decl": "export interface TopBarTitleMenu {\n  items?: MenuItem[];\n  selectedId?: string;\n  /** `selectedId` is the fallback. */\n  selectedIdPath?: string;\n  /** Default \"<title>, switch\". */\n  accessibilityLabel?: string;\n}"
+      },
       {
         "name": "LocaleConfig",
         "kind": "interface",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1405.0",
+  "version": "0.1406.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -71,5 +71,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "0a22f58e5c6c241689ced19f73766e414c3004bb061a6c6b8f738a92"
+  "falconPackageHash": "964966afc4bcb743188c9fdf21d84de92fb1d9a392e0a48b0644a39a"
 }