@wix/himalaya-cli 0.1320.0 → 0.1322.0

package/guides/webview-page-sdk.md

@@ -70,6 +70,17 @@ logicBundle: {
 }
 ```
 
+Every worker built on `exposeCapabilitiesToPage` also answers the page's handshake,
+`call("himalaya", "capabilities")`, with exactly the allowlist it was given
+(`{ v: 1, capabilities: { health: ["availability", …] } }`); the page client's
+`enabledCapabilities()` and `isEnabled()` (in both the pasted guide client and
+`@wix/himalaya/webview-page`) read it, so a page hides what is off without calling a method or
+waiting out a timeout. They share one question per page, re-asked every 0.5 s until answered or the latest caller's deadline (at most two messages a second, however many controls check), since a worker that is still
+booting drops the first messages. `isEnabled()` never calls the method: with no list (an app built
+before the handshake) it answers `false`, and a page that must support such a build calls
+`probe()` — which does call the method — with a read-only one. `himalaya` is reserved: exposing a capability under that name
+throws.
+
 Do not build one worker that imports every SDK. Static bundle scanning would correctly conclude
 that the release uses every capability, forcing unrelated permissions and native modules into the
 binary. One app-specific worker imports exactly the app’s selected subset.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1320.0",
+  "version": "0.1322.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": "551309f221b2f15b7f02099f9470e8021a0e0de81fba7b30dea7434b"
+  "falconPackageHash": "bb7cc4c5d0d0841cd11950b890b11f51d812396f8f4a0649727b0501"
 }

package/templates/beauty-salon/dev/index.ts

@@ -8634,6 +8634,498 @@ const SCREENS = runtimeSetting({
                 "hiddenPath": "$service:spacesCollectionDetail.noEntity"
               }
             },
+            {
+              "id": "",
+              "body": {
+                "package": "himalaya",
+                "type": "VStack",
+                "props": {
+                  "spacing": 10,
+                  "children": [
+                    {
+                      "id": "himi_collection.skeleton_1",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "ZStack",
+                        "props": {
+                          "alignment": "center",
+                          "children": []
+                        }
+                      },
+                      "modifiers": {
+                        "height": 96,
+                        "background": {
+                          "token": "surfaceSecondary"
+                        },
+                        "border": {
+                          "width": 1,
+                          "color": {
+                            "token": "border"
+                          }
+                        },
+                        "cornerRadius": 8
+                      }
+                    },
+                    {
+                      "id": "himi_collection.skeleton_2",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "ZStack",
+                        "props": {
+                          "alignment": "center",
+                          "children": []
+                        }
+                      },
+                      "modifiers": {
+                        "height": 96,
+                        "background": {
+                          "token": "surfaceSecondary"
+                        },
+                        "border": {
+                          "width": 1,
+                          "color": {
+                            "token": "border"
+                          }
+                        },
+                        "cornerRadius": 8
+                      }
+                    },
+                    {
+                      "id": "himi_collection.skeleton_3",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "ZStack",
+                        "props": {
+                          "alignment": "center",
+                          "children": []
+                        }
+                      },
+                      "modifiers": {
+                        "height": 96,
+                        "background": {
+                          "token": "surfaceSecondary"
+                        },
+                        "border": {
+                          "width": 1,
+                          "color": {
+                            "token": "border"
+                          }
+                        },
+                        "cornerRadius": 8
+                      }
+                    }
+                  ]
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:spacesCollectionDetail.hideProductsLoading"
+              }
+            },
+            {
+              "id": "himi_collection.products_retry.block",
+              "body": {
+                "package": "himalaya",
+                "type": "VStack",
+                "props": {
+                  "spacing": 12,
+                  "alignment": "leading",
+                  "children": [
+                    {
+                      "id": "",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "HStack",
+                        "props": {
+                          "spacing": 10,
+                          "children": [
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Icon",
+                                "props": {
+                                  "name": "warning",
+                                  "size": 18,
+                                  "tint": "accentPrimary"
+                                }
+                              },
+                              "modifiers": {
+                                "accessibilityRole": "decorative"
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "Something did not load.",
+                                  "style": "bodyEmphasis"
+                                }
+                              }
+                            }
+                          ]
+                        }
+                      }
+                    },
+                    {
+                      "id": "",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Text",
+                        "props": {
+                          "text": "Try again when the connection settles.",
+                          "style": "body",
+                          "color": "textSecondary"
+                        }
+                      }
+                    },
+                    {
+                      "id": "himi_collection.products_retry",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Button",
+                        "props": {
+                          "title": "Try again",
+                          "style": "secondary",
+                          "action": {
+                            "actionId": "tier5.spacesCollectionDetail.retryProducts"
+                          }
+                        }
+                      }
+                    }
+                  ]
+                }
+              },
+              "modifiers": {
+                "background": {
+                  "token": "surfaceElevated"
+                },
+                "border": {
+                  "width": 1,
+                  "color": {
+                    "token": "border"
+                  }
+                },
+                "cornerRadius": 8,
+                "padding": {
+                  "leading": 14,
+                  "trailing": 14,
+                  "top": 14,
+                  "bottom": 14
+                },
+                "hiddenPath": "$service:spacesCollectionDetail.productsNotErrored"
+              }
+            },
+            {
+              "id": "himi_collection.products",
+              "body": {
+                "package": "himalaya",
+                "type": "LazyList",
+                "props": {
+                  "spacing": 10,
+                  "itemsPath": "$service:spacesCollectionDetail.products",
+                  "items": [
+                    {
+                      "id": "himi_collection.row",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "VStack",
+                        "props": {
+                          "spacing": 9,
+                          "alignment": "leading",
+                          "children": [
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Image",
+                                "props": {
+                                  "url": "$item.image",
+                                  "fillWidth": true,
+                                  "height": 168,
+                                  "contentMode": "fill",
+                                  "contentDescription": "$item.name"
+                                }
+                              },
+                              "modifiers": {
+                                "cornerRadius": 8,
+                                "fillMaxWidth": true,
+                                "hiddenPath": "$item.noImage"
+                              }
+                            },
+                            {
+                              "id": "himi_collection.row.monogram",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "ZStack",
+                                "props": {
+                                  "alignment": "center",
+                                  "children": [
+                                    {
+                                      "id": "",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "Text",
+                                        "props": {
+                                          "text": "$item.initial",
+                                          "style": "display",
+                                          "color": "textOnAccent",
+                                          "maxLines": 1
+                                        }
+                                      }
+                                    }
+                                  ]
+                                }
+                              },
+                              "modifiers": {
+                                "fillMaxWidth": true,
+                                "height": 168,
+                                "background": {
+                                  "token": "accentPrimary"
+                                },
+                                "cornerRadius": 8,
+                                "hiddenPath": "$item.hasImage"
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "$item.name",
+                                  "style": "bodyEmphasis",
+                                  "maxLines": 2
+                                }
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "$item.subtitle",
+                                  "style": "footnote",
+                                  "color": "accentPrimary",
+                                  "maxLines": 1,
+                                  "collapseWhenEmpty": true
+                                }
+                              }
+                            }
+                          ]
+                        }
+                      },
+                      "modifiers": {
+                        "background": {
+                          "token": "surfaceElevated"
+                        },
+                        "border": {
+                          "width": 1,
+                          "color": {
+                            "token": "border"
+                          }
+                        },
+                        "cornerRadius": 8,
+                        "padding": {
+                          "leading": 12,
+                          "trailing": 12,
+                          "top": 12,
+                          "bottom": 12
+                        },
+                        "onTap": {
+                          "actionId": "himi.open",
+                          "params": {
+                            "screenId": "$item.detailScreenId",
+                            "id": "$item.id"
+                          }
+                        },
+                        "pressFeedback": "scale",
+                        "haptic": "light",
+                        "accessibilityLabel": "$item.name"
+                      }
+                    }
+                  ],
+                  "onPullToRefresh": {
+                    "actionId": "tier5.spacesCollectionDetail.load"
+                  },
+                  "pagination": {
+                    "cursor": "$service:spacesCollectionDetail.productsCursor",
+                    "onLoadMore": {
+                      "actionId": "tier5.spacesCollectionDetail.loadMoreProducts"
+                    },
+                    "pageSize": 50
+                  }
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:spacesCollectionDetail.hideProducts"
+              }
+            },
+            {
+              "id": "himi_collection.products_more_retry.block",
+              "body": {
+                "package": "himalaya",
+                "type": "VStack",
+                "props": {
+                  "spacing": 12,
+                  "alignment": "leading",
+                  "children": [
+                    {
+                      "id": "",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "HStack",
+                        "props": {
+                          "spacing": 10,
+                          "children": [
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Icon",
+                                "props": {
+                                  "name": "warning",
+                                  "size": 18,
+                                  "tint": "accentPrimary"
+                                }
+                              },
+                              "modifiers": {
+                                "accessibilityRole": "decorative"
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "Something did not load.",
+                                  "style": "bodyEmphasis"
+                                }
+                              }
+                            }
+                          ]
+                        }
+                      }
+                    },
+                    {
+                      "id": "",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Text",
+                        "props": {
+                          "text": "Try again when the connection settles.",
+                          "style": "body",
+                          "color": "textSecondary"
+                        }
+                      }
+                    },
+                    {
+                      "id": "himi_collection.products_more_retry",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Button",
+                        "props": {
+                          "title": "Try again",
+                          "style": "secondary",
+                          "action": {
+                            "actionId": "tier5.spacesCollectionDetail.retryProducts"
+                          }
+                        }
+                      }
+                    }
+                  ]
+                }
+              },
+              "modifiers": {
+                "background": {
+                  "token": "surfaceElevated"
+                },
+                "border": {
+                  "width": 1,
+                  "color": {
+                    "token": "border"
+                  }
+                },
+                "cornerRadius": 8,
+                "padding": {
+                  "leading": 14,
+                  "trailing": 14,
+                  "top": 14,
+                  "bottom": 14
+                },
+                "hiddenPath": "$service:spacesCollectionDetail.productsNoPageError"
+              }
+            },
+            {
+              "id": "",
+              "body": {
+                "package": "himalaya",
+                "type": "VStack",
+                "props": {
+                  "spacing": 12,
+                  "alignment": "center",
+                  "children": [
+                    {
+                      "id": "",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Icon",
+                        "props": {
+                          "name": "bag",
+                          "size": 34,
+                          "tint": "textTertiary"
+                        }
+                      },
+                      "modifiers": {
+                        "accessibilityRole": "decorative"
+                      }
+                    },
+                    {
+                      "id": "",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Text",
+                        "props": {
+                          "text": "No products in this category yet.",
+                          "style": "bodyEmphasis",
+                          "color": "textSecondary",
+                          "collapseWhenEmpty": true
+                        }
+                      }
+                    },
+                    {
+                      "id": "himi_collection.products_empty.cta",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Button",
+                        "props": {
+                          "title": "Back to categories",
+                          "style": "secondary",
+                          "action": {
+                            "actionId": "himi.open",
+                            "params": {
+                              "screenId": "himi_collections"
+                            }
+                          }
+                        }
+                      }
+                    }
+                  ]
+                }
+              },
+              "modifiers": {
+                "padding": {
+                  "leading": 24,
+                  "trailing": 24,
+                  "top": 24,
+                  "bottom": 24
+                },
+                "hiddenPath": "$service:spacesCollectionDetail.noEmpty"
+              }
+            },
             {
               "id": "",
               "body": {