@wix/himalaya-cli 0.1311.0 → 0.1312.0

package/dist/cli.mjs

@@ -7530,6 +7530,7 @@ function buttonVariant(style) {
 var SYSTEM_FONT_FAMILY, TONAL_ELEVATION_ALPHA, BUTTON_MIN_HIT_TARGET, nonNegative, nonEmpty, own, COLOR_TOKEN_PROPS, TYPOGRAPHY_TOKEN_PROPS, BUTTON_VARIANTS;
 var init_tokens = __esm({
   "../../core/ts/src/tokens.ts"() {
+    "use strict";
     SYSTEM_FONT_FAMILY = "$system";
     TONAL_ELEVATION_ALPHA = [0, 0.05, 0.08, 0.11, 0.12, 0.14];
     BUTTON_MIN_HIT_TARGET = 44;
@@ -123277,7 +123278,8 @@ var init_renderNode = __esm({
         };
       }, [open]);
       const modal = isOverlayModal("Menu", props.modal);
-      const anchorLabel = props.anchor?.modifiers?.accessibilityLabel || "More actions";
+      const rawAnchorLabel = props.anchor?.modifiers?.accessibilityLabel;
+      const anchorLabel = String((typeof rawAnchorLabel === "string" && rawAnchorLabel.startsWith("$item") ? resolveItemDeep2(rawAnchorLabel, ctx) : rawAnchorLabel) || "More actions");
       const flexGrow = typeof wrap?.flex === "string" ? parseFloat(wrap.flex) : typeof wrap?.flex === "number" ? wrap.flex : Number(wrap?.flexGrow ?? 0);
       const fill = wrap?.width === "100%" || Number.isFinite(flexGrow) && flexGrow > 0;
       const popupPlacement = fill ? { position: "absolute", top: "100%", left: 0, right: 0, zIndex: 20, marginTop: 4 } : { position: "absolute", top: "100%", right: 0, zIndex: 20, marginTop: 4 };
@@ -128991,6 +128993,9 @@ import { readFileSync as readFileSync49, existsSync as existsSync45, watch, mkdi
 import { basename as basename10, dirname as dirname28, extname as extname2, join as join44, relative as relative8, resolve as resolve37, normalize as normalize3, sep as sep10 } from "node:path";
 import { createHash as createHash20, randomUUID as randomUUID5 } from "node:crypto";
 import { fileURLToPath as fileURLToPath20, pathToFileURL as pathToFileURL6 } from "node:url";
+function readLogicBundle(read, tier5Dir, name) {
+  return read(tier5Dir ?? TIER5_ROOT2, name) ?? (tier5Dir && tier5Dir !== TIER5_ROOT2 ? read(TIER5_ROOT2, name) : void 0);
+}
 function deepMerge3(base, patch) {
   if (patch === null || typeof patch !== "object" || Array.isArray(patch)) return patch;
   const out2 = Array.isArray(base) ? [...base] : { ...base };
@@ -129143,7 +129148,7 @@ async function runScreenDiagnostics(state, screenId, descriptor) {
   const nativeActions = await nativeActionsFor(state);
   const lb = descriptor.logicBundle;
   const bundleName = lb?.url ? /\/v1\/bundles\/([A-Za-z0-9_-]+)/.exec(lb.url)?.[1] : void 0;
-  const bundleJs = bundleName ? readBuiltBundle2(state.tier5Dir ?? TIER5_ROOT2, bundleName) : void 0;
+  const bundleJs = bundleName ? readLogicBundle(readBuiltBundle2, state.tier5Dir, bundleName) : void 0;
   const appWorkerActions = appWorkerActionsFor2(
     state.app?.module.config,
     state.tier5Dir ?? TIER5_ROOT2
@@ -131050,7 +131055,7 @@ async function handleAdminPlayground(req, res, state) {
     const nativeActions = await nativeActionsFor(state);
     const lb = descriptor.logicBundle;
     const bundleName = lb?.url ? /\/v1\/bundles\/([A-Za-z0-9_-]+)/.exec(lb.url)?.[1] : void 0;
-    const bundleJs = bundleName ? readBuiltBundle2(state.tier5Dir ?? TIER5_ROOT2, bundleName) : void 0;
+    const bundleJs = bundleName ? readLogicBundle(readBuiltBundle2, state.tier5Dir, bundleName) : void 0;
     const appWorkerActions = appWorkerActionsFor2(
       state.app?.module.config,
       state.tier5Dir ?? TIER5_ROOT2
@@ -135694,6 +135699,20 @@ function readTokensForLint(preloaded) {
 async function buildFromLoaded(preloaded, dest, opts = {}) {
   const app = preloaded.name;
   const tier5Dir = opts.tier5Dir ?? TIER5_DIR;
+  const bundlePath = (name) => {
+    const own4 = join45(tier5Dir, `${name}.bundle.js`);
+    if (existsSync46(own4)) return own4;
+    const shared = join45(TIER5_DIR, `${name}.bundle.js`);
+    return resolve38(tier5Dir) !== TIER5_DIR && existsSync46(shared) ? shared : void 0;
+  };
+  const bundleDirFor = (name) => {
+    const path2 = name ? bundlePath(name) : void 0;
+    return path2 ? dirname29(path2) : tier5Dir;
+  };
+  const readBundle = (name) => {
+    const path2 = bundlePath(name);
+    return path2 ? readFileSync50(path2, "utf8") : void 0;
+  };
   const collect2 = opts.collect;
   const config = preloaded.module.config;
   if (isFunctionsOnlyConfig(config)) {
@@ -135771,7 +135790,7 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
     let mockBootFailed;
     let mockUnserved;
     if (collect2?.render?.live) {
-      const bundleJs = bundleName ? readBuiltBundle(tier5Dir, bundleName) : void 0;
+      const bundleJs = bundleName ? readBundle(bundleName) : void 0;
       if (!bundleJs) {
         base2 = null;
       } else {
@@ -135788,14 +135807,14 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
         liveReturned = counting.returned();
         liveErrors = live3.errors;
       }
-    } else if (collect2?.render?.mocks && collect2.render.hydrate !== false && bundleName && readBuiltBundle(tier5Dir, bundleName)) {
+    } else if (collect2?.render?.mocks && collect2.render.hydrate !== false && bundleName && readBundle(bundleName)) {
       const calls = [];
       const unserved = [];
       const snap = await bootAndSnapshotState({
         screenId: renderedScreenId ?? String(descriptor?.screenId ?? bundleName),
         // `--input` rides on the descriptor's own input, as a navigator hands it over.
         descriptor: collect2.render.input && descriptor && typeof descriptor === "object" ? { ...descriptor, input } : descriptor,
-        bundleJs: readBuiltBundle(tier5Dir, bundleName),
+        bundleJs: readBundle(bundleName),
         knownScreenIds: /* @__PURE__ */ new Set(),
         rules: collect2.render.mocks.rules ?? null,
         ...collect2.render.mocks.cmsSeed ? { cmsSeed: collect2.render.mocks.cmsSeed } : {},
@@ -135818,11 +135837,11 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
         mockUnserved = unserved;
       } else {
         mockBootFailed = true;
-        base2 = hydrationServices(tier5Dir, bundleName, input);
+        base2 = hydrationServices(bundleDirFor(bundleName), bundleName, input);
       }
     } else {
       base2 = collect2?.render?.hydrate === false ? null : hydrationServices(
-        tier5Dir,
+        bundleDirFor(bundleName),
         bundleName,
         input
       );
@@ -135877,7 +135896,9 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
     if (addrCache.has(name)) return addrCache.get(name);
     let bytes2;
     try {
-      bytes2 = readFileSync50(join45(tier5Dir, `${name}.bundle.js`));
+      const path2 = bundlePath(name);
+      if (!path2) return null;
+      bytes2 = readFileSync50(path2);
     } catch {
       return null;
     }
@@ -136104,12 +136125,12 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
           descriptor: JSON.parse(json6),
           descriptorJson: json6,
           bundleName,
-          bundleJs: bundleName ? readBuiltBundle(tier5Dir, bundleName) ?? null : null,
+          bundleJs: bundleName ? readBundle(bundleName) ?? null : null,
           ...bundleMapFor(tier5Dir, bundleName ?? void 0)
         });
       }
       if (collect2?.lint) {
-        const bundleJs = bundleName ? readBuiltBundle(tier5Dir, bundleName) : void 0;
+        const bundleJs = bundleName ? readBundle(bundleName) : void 0;
         const report3 = validateScreenDescriptor(screenId, descriptor, {
           tokens: lintTokens,
           allowedComponents,
@@ -136141,7 +136162,7 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
         const lb = logicBundleOf(descriptor);
         const bundleName = lb ? bundleNameFromUrl(lb.url) : null;
         if (collect2?.lint) {
-          const bundleJs = bundleName ? readBuiltBundle(tier5Dir, bundleName) : void 0;
+          const bundleJs = bundleName ? readBundle(bundleName) : void 0;
           const report3 = validateScreenDescriptor(wantedRender, descriptor, {
             tokens: lintTokens,
             allowedComponents,
@@ -136257,7 +136278,7 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
               // for ANY of its screens.
               descriptorJson: json6,
               bundleName,
-              bundleJs: bundleName ? readBuiltBundle(tier5Dir, bundleName) ?? null : null,
+              bundleJs: bundleName ? readBundle(bundleName) ?? null : null,
               ...bundleMapFor(tier5Dir, bundleName ?? void 0)
             });
           }
@@ -136363,7 +136384,7 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
   if (store.putDoc) {
     for (const [name, meta] of Object.entries(bundles)) {
       if (name.startsWith("__handlers__")) continue;
-      const js2 = readBuiltBundle(tier5Dir, name);
+      const js2 = readBundle(name);
       if (!js2) continue;
       try {
         const input = bundleInputs.get(name);
@@ -136430,7 +136451,7 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
   if (collect2?.lint) {
     for (const name of Object.keys(bundles)) {
       if (name.startsWith("__handlers__")) continue;
-      const js2 = readBuiltBundle(tier5Dir, name);
+      const js2 = readBundle(name);
       if (!js2) continue;
       const input = bundleInputs.get(name);
       const drifting = bundles[name]?.servicesHash ? nondeterministicServices(js2, input ? { input } : {}) : [];
@@ -155758,25 +155779,25 @@ var init_preview_assets_generated = __esm({
   "../../packages/serve/src/preview-assets.generated.ts"() {
     init_preview_assets_format();
     PREVIEW_ASSET_MANIFEST = [
-      { key: "assets/index-BGnhry40.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1257479, sha256: "9dae9495031ad4b3f58da8b01d402b9bf1a8849fbbcc5c1a92c2fef67714e298" },
-      { key: "assets/pdf-BiYGtkj7.js", contentType: "application/javascript; charset=utf-8", offset: 1257487, length: 488199, sha256: "186b07ee58a3a152bd51eb3a45b0d31c391a41345c6a18212fdc1947d43f83db" },
-      { key: "assets/pdf.worker.min-BQa_JDET.js", contentType: "application/javascript; charset=utf-8", offset: 1745686, length: 73, sha256: "41bcfda4f3c8c0a81c785ea87c69afc8e7d0ed8c333324aee94c273d881bb6aa" },
-      { key: "assets/pdf.worker.min-BmVo14Nb.mjs", contentType: "application/javascript; charset=utf-8", offset: 1745759, length: 1317034, sha256: "a33cfe728c584fdba4fcc1fd54bcdc2f9f2f13889ddbb5b2bd1d0f8cbe49b84e" },
-      { key: "assets/pdfDocument-CmrdgHk3.js", contentType: "application/javascript; charset=utf-8", offset: 3062793, length: 2858, sha256: "16b5f066b672011380ee7739ffca3db572877072bdbac1ec1931b619be10b90b" },
-      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 3065651, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
-      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 3070261, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
-      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 3558845, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
-      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 3649769, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
-      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 3740753, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
-      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 3831733, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
-      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 3922605, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
-      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 4013585, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
-      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 4122221, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
-      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 4231305, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
-      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 4340353, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
-      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 4448053, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
-      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 4536161, length: 4947, sha256: "2b2b2ec5619e33c93b438fa5a4091d3ef5bafd728558b2cd3a194579e56b525f" },
-      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 4541108, length: 17344, sha256: "d057298d75e7373e5e2c4d11b7d1bcbea88e03af555ba63d97641c78509c58e4" }
+      { key: "assets/index-BIlXpj1h.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1257735, sha256: "6d808a71fd48dfe402d9cdace4e2a6ce1a8d686068d1812eb08ef418f2284533" },
+      { key: "assets/pdf-DKCzctsR.js", contentType: "application/javascript; charset=utf-8", offset: 1257743, length: 488199, sha256: "580e24333dcc9b041e8720577be50a8da5a50800f4d5e948e28edf9c8dd7d9e0" },
+      { key: "assets/pdf.worker.min-BQa_JDET.js", contentType: "application/javascript; charset=utf-8", offset: 1745942, length: 73, sha256: "41bcfda4f3c8c0a81c785ea87c69afc8e7d0ed8c333324aee94c273d881bb6aa" },
+      { key: "assets/pdf.worker.min-BmVo14Nb.mjs", contentType: "application/javascript; charset=utf-8", offset: 1746015, length: 1317034, sha256: "a33cfe728c584fdba4fcc1fd54bcdc2f9f2f13889ddbb5b2bd1d0f8cbe49b84e" },
+      { key: "assets/pdfDocument-DCdoA9nd.js", contentType: "application/javascript; charset=utf-8", offset: 3063049, length: 2858, sha256: "ea99eb8d79920cd5c7ca2c83faa495c5287ff04d1c96bbfe3d034b8925075ad2" },
+      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 3065907, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
+      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 3070517, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 3559101, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 3650025, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 3741009, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 3831989, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 3922861, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 4013841, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 4122477, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 4231561, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 4340609, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 4448309, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 4536417, length: 4947, sha256: "31a68c99003ad579052a0dccccfa5d861146fe209bbc6ea0c264162026d7b35f" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 4541364, length: 17344, sha256: "d057298d75e7373e5e2c4d11b7d1bcbea88e03af555ba63d97641c78509c58e4" }
     ];
   }
 });

package/guides/web-page-native-sdk.md

@@ -15,13 +15,13 @@ your page → window.HimalayaWorker → the app's companion worker → native iO
 ## Before you start: what the app owner must enable
 
 Your page can only use capabilities the **app owner** turned on for your site. In a Brandy app
-that is the `webSdk` block of the app's provisioning file:
+(an app that wraps a website) that is the `webSdk` block of the app's provisioning — its
+`provisioning.json`:
 
 ```json
 {
   "webSdk": {
-    "bundle": "my-site-capabilities",
-    "capabilities": ["health", "haptic"],
+    "capabilities": ["health", "haptic", "share"],
     "permissionCopy": {
       "health": "Show your daily steps and save the workouts you finish."
     }
@@ -33,8 +33,13 @@ that is the `webSdk` block of the app's provisioning file:
   [Web page SDK reference](https://apps.wix.com/_api/himi-serve/docs/web-page-sdk-reference.md) for every id and method).
 - `permissionCopy` — the sentence the phone shows when it asks the user for permission. Write it
   for the end user, about what *they* get.
-- `bundle` — the app's companion worker, which allowlists exactly which methods your page may
-  call. A health-only site can omit it; any other set needs one.
+- No worker code is needed. Brandy generates the companion worker that answers your page from
+  `capabilities`, allowing every method the capability's page lists — except
+  `presigned_upload.putFile`, which reads a device file and is allowed only when `files` is enabled
+  too. (An owner who wants a
+  narrower allowlist can still name their own worker in `bundle`.)
+- Enabling a capability changes the app's native permissions, so the owner ships a **new app
+  build** with it before your page can call it. Until then the call times out.
 
 When you hand work to the app owner, give them the list as `capability.method` pairs, for example
 `health.availability`, `health.requestPermission`, `health.query`, `haptic.play`. A method that is
@@ -209,7 +214,10 @@ export function StepsCard() {
   if (state === "off") return null; // no health store, or Health not enabled for this site — hide it
   if (state === "denied") return <p>Health access is off. You can turn it on in your phone's Settings.</p>;
   if (state === "failed") return <button onClick={connect}>Couldn't load your steps — try again</button>;
-  return steps === null ? <button onClick={connect}>Show today's steps</button> : <p>{steps} steps today</p>;
+  if (steps === null) return <button onClick={connect}>Show today's steps</button>;
+  // iOS never says a Health read was denied: a denied read returns no samples, like a day with no data.
+  if (steps === 0) return <p>No steps yet today. If you turned off Health access, enable it in the Health app.</p>;
+  return <p>{steps} steps today</p>;
 }
 ```
 
@@ -221,7 +229,9 @@ The same page must keep working in an ordinary browser (and in Base44 / Lovable
 - **Ask for permission only from a user action** (a button tap), after explaining the benefit on
   screen. Never prompt on page load.
 - **Handle "no" and "not available".** Every permission can be denied; Health may not exist on the
-  device (`availability()` tells you). Show a calm fallback, not an error.
+  device (`availability()` tells you). Show a calm fallback, not an error. On iOS a denied Health
+  **read** is not reported as `not_authorized`: the read succeeds with no samples, exactly like a
+  day with no data. Word an empty result so it also covers "access is off".
 - **Hide features the app doesn't enable.** Probe once with `isEnabled(...)` on a read-only method
   and hide the UI when it is `false`. `true` only means the method is enabled — still read its
   answer (`availability()` can say `{ available: false }`).
@@ -333,7 +343,7 @@ if (photo) {
 
 For larger files, or to keep a copy on your server, upload straight from the device with
 `presigned_upload.putFile(url, handle)` and use the uploaded URL. Going the other way, a page
-cannot send large content in: see the size rules below.
+cannot send large content in: see *Keep what you send small* under *Rules that keep a page working*.
 
 ## Reference
 

package/guides/webview-page-sdk.md

@@ -76,7 +76,8 @@ binary. One app-specific worker imports exactly the app’s selected subset.
 
 ## Brandy
 
-Health has a built-in proof worker, so it needs no custom bundle name:
+Name the capabilities; Brandy supplies the companion worker. Health has a hand-written proof
+worker:
 
 ```json
 {
@@ -89,12 +90,13 @@ Health has a built-in proof worker, so it needs no custom bundle name:
 }
 ```
 
-For another subset, add the companion bundle to the app and name it:
+Any other set gets a worker generated from the set — it imports only those capabilities' SDKs
+and allowlists every method a page can call on them (the methods each `web-sdk/<id>` page lists;
+`presigned_upload.putFile` only when `files` is in the set too, since it reads the files substrate):
 
 ```json
 {
   "webSdk": {
-    "bundle": "customer-page-capabilities",
     "capabilities": ["camera", "share"],
     "permissionCopy": {
       "camera": "Take a photo to attach it to your request."
@@ -103,6 +105,10 @@ For another subset, add the companion bundle to the app and name it:
 }
 ```
 
+Preparing the customer build (`npm run prepare:customer`) writes and builds it; for local
+previews, run `npm run web-sdk:companion` first. To expose fewer methods, write your own
+companion and name it in `bundle` — a named bundle is used as is.
+
 Brandy accepts capabilities `himi dist` can add to an extensible shell. Capabilities requiring
 app-specific boot wiring remain refused until that shell supplies the wiring. Base44 is accepted
 only when the same Brandy contract contains a Base44 binding.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1311.0",
+  "version": "0.1312.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": "105e0572efcdcccbc0bea292e6e88354813e2abb6f818908beff3f79"
+  "falconPackageHash": "780fb2ce1d71508d01c3075d8f29dc587c79a5f5064c526a60dcb0b0"
 }

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

@@ -10085,7 +10085,7 @@ const SCREENS = runtimeSetting({
                                                                     "modifiers": {
                                                                       "width": 44,
                                                                       "height": 44,
-                                                                      "accessibilityLabel": "Item actions"
+                                                                      "accessibilityLabel": "$item.collectionActionsLabel"
                                                                     }
                                                                   },
                                                                   "items": [
@@ -10365,7 +10365,7 @@ const SCREENS = runtimeSetting({
                                                                     "modifiers": {
                                                                       "width": 44,
                                                                       "height": 44,
-                                                                      "accessibilityLabel": "Item actions"
+                                                                      "accessibilityLabel": "$item.collectionActionsLabel"
                                                                     }
                                                                   },
                                                                   "items": [
@@ -10655,7 +10655,7 @@ const SCREENS = runtimeSetting({
                                                                     "modifiers": {
                                                                       "width": 44,
                                                                       "height": 44,
-                                                                      "accessibilityLabel": "Item actions"
+                                                                      "accessibilityLabel": "$item.collectionActionsLabel"
                                                                     }
                                                                   },
                                                                   "items": [
@@ -10935,7 +10935,7 @@ const SCREENS = runtimeSetting({
                                                                     "modifiers": {
                                                                       "width": 44,
                                                                       "height": 44,
-                                                                      "accessibilityLabel": "Item actions"
+                                                                      "accessibilityLabel": "$item.collectionActionsLabel"
                                                                     }
                                                                   },
                                                                   "items": [
@@ -11540,7 +11540,7 @@ const SCREENS = runtimeSetting({
                                                           "modifiers": {
                                                             "width": 44,
                                                             "height": 44,
-                                                            "accessibilityLabel": "Item actions"
+                                                            "accessibilityLabel": "$item.collectionActionsLabel"
                                                           }
                                                         },
                                                         "items": [
@@ -12652,7 +12652,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -13008,7 +13008,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -13327,7 +13327,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -13683,7 +13683,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -14343,7 +14343,7 @@ const SCREENS = runtimeSetting({
                                                                   "modifiers": {
                                                                     "width": 44,
                                                                     "height": 44,
-                                                                    "accessibilityLabel": "Item actions"
+                                                                    "accessibilityLabel": "$item.collectionActionsLabel"
                                                                   }
                                                                 },
                                                                 "items": [
@@ -15560,7 +15560,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -15901,7 +15901,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -16172,7 +16172,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -16513,7 +16513,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -17139,7 +17139,7 @@ const SCREENS = runtimeSetting({
                                                                   "modifiers": {
                                                                     "width": 44,
                                                                     "height": 44,
-                                                                    "accessibilityLabel": "Item actions"
+                                                                    "accessibilityLabel": "$item.collectionActionsLabel"
                                                                   }
                                                                 },
                                                                 "items": [
@@ -18353,7 +18353,7 @@ const SCREENS = runtimeSetting({
                                                                     "modifiers": {
                                                                       "width": 44,
                                                                       "height": 44,
-                                                                      "accessibilityLabel": "Item actions"
+                                                                      "accessibilityLabel": "$item.collectionActionsLabel"
                                                                     }
                                                                   },
                                                                   "items": [
@@ -18707,7 +18707,7 @@ const SCREENS = runtimeSetting({
                                                                     "modifiers": {
                                                                       "width": 44,
                                                                       "height": 44,
-                                                                      "accessibilityLabel": "Item actions"
+                                                                      "accessibilityLabel": "$item.collectionActionsLabel"
                                                                     }
                                                                   },
                                                                   "items": [
@@ -18981,7 +18981,7 @@ const SCREENS = runtimeSetting({
                                                                     "modifiers": {
                                                                       "width": 44,
                                                                       "height": 44,
-                                                                      "accessibilityLabel": "Item actions"
+                                                                      "accessibilityLabel": "$item.collectionActionsLabel"
                                                                     }
                                                                   },
                                                                   "items": [
@@ -19335,7 +19335,7 @@ const SCREENS = runtimeSetting({
                                                                     "modifiers": {
                                                                       "width": 44,
                                                                       "height": 44,
-                                                                      "accessibilityLabel": "Item actions"
+                                                                      "accessibilityLabel": "$item.collectionActionsLabel"
                                                                     }
                                                                   },
                                                                   "items": [
@@ -19934,7 +19934,7 @@ const SCREENS = runtimeSetting({
                                                           "modifiers": {
                                                             "width": 44,
                                                             "height": 44,
-                                                            "accessibilityLabel": "Item actions"
+                                                            "accessibilityLabel": "$item.collectionActionsLabel"
                                                           }
                                                         },
                                                         "items": [
@@ -21849,7 +21849,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -22196,7 +22196,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -22486,7 +22486,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -22833,7 +22833,7 @@ const SCREENS = runtimeSetting({
                                                                             "modifiers": {
                                                                               "width": 44,
                                                                               "height": 44,
-                                                                              "accessibilityLabel": "Item actions"
+                                                                              "accessibilityLabel": "$item.collectionActionsLabel"
                                                                             }
                                                                           },
                                                                           "items": [
@@ -23474,7 +23474,7 @@ const SCREENS = runtimeSetting({
                                                                   "modifiers": {
                                                                     "width": 44,
                                                                     "height": 44,
-                                                                    "accessibilityLabel": "Item actions"
+                                                                    "accessibilityLabel": "$item.collectionActionsLabel"
                                                                   }
                                                                 },
                                                                 "items": [

package/templates/beauty-salon/tier5-src/_shared/collection-contract.ts

@@ -58,6 +58,13 @@ export interface CollectionConfig {
 /** At or below this many records, with no query/filter narrowing them and no further
  * page, the list/grid toggle, Refine, chips, search and count are noise. */
 export const COLLECTION_CHROME_MIN_ITEMS = 4;
+/** The accessible name of a row's overflow menu: `template` with `{title}` filled, or the
+ *  generic `fallback` for a record with no title. */
+export function collectionActionsLabel(title: string, template: string, fallback: string): string {
+  const t = title.trim();
+  return t ? template.replace('{title}', () => t) : fallback;
+}
+
 export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiStoreShop: { rows: 'results', title: 'name', subtitle: 'subtitle', image: 'image', view: 'grid', backendQuery: true, countNoun: ['product', 'products'], favoriteToggle: true },
   himiBookingServices: { rows: 'results', title: 'name', subtitle: 'subtitle', image: 'image', filter: 'category', view: 'grid', backendQuery: true, searchPlaceholder: 'Search services', countNoun: ['service', 'services'], primaryVerb: { label: 'Book', screenId: 'himi_time' } },
@@ -184,6 +191,9 @@ export function projectCollection(source: CollectionRow[], config: CollectionCon
       collectionSelectLabel: prefs.selectedIds.includes(collectionId(row)) ? 'Selected' : 'Select',
       // The save toggle names the action it WILL take (the service localizes it).
       collectionSaveLabel: prefs.savedIds.includes(collectionId(row)) ? 'Remove from saved' : 'Save',
+      // The row's overflow menu, named for its record: out of context (a rotor, a voice
+      // command) a list of identical "Item actions" cannot be told apart.
+      collectionActionsLabel: collectionActionsLabel(collectionTitle(row, config), 'Actions for {title}', 'Item actions'),
       collectionSubtitle: scalar(row[config.subtitle ?? '']) || scalar(row.subtitle) || scalar(row.description) || scalar(row.meta),
       collectionImage: scalar(row[config.image ?? '']), collectionNoImage: !scalar(row[config.image ?? '']), collectionHasImage: !!scalar(row[config.image ?? '']),
       collectionSaved: prefs.savedIds.includes(collectionId(row)), collectionNotSaved: !prefs.savedIds.includes(collectionId(row)), collectionSelected: prefs.selectedIds.includes(collectionId(row)),

package/templates/beauty-salon/tier5-src/_shared/collection-service.ts

@@ -1,5 +1,5 @@
 import { defineService as register, type ServiceDefinition } from '@himalaya/state';
-import { COLLECTIONS, COLLECTION_CHROME_MIN_ITEMS, initialCollection, normalizeCollection, projectCollection, collectionId, type CollectionRow } from './collection-contract.js';
+import { COLLECTIONS, COLLECTION_CHROME_MIN_ITEMS, initialCollection, normalizeCollection, projectCollection, collectionId, collectionActionsLabel, type CollectionRow } from './collection-contract.js';
 import { localPreferences, type PreferenceRuntime } from './local-preferences.js';
 import { copyParam, stashCopy } from './himi-copy.js';
 import { createCollectionQuery, type CollectionQuerySource, type CollectionQueryState } from './collection-query.js';
@@ -130,6 +130,8 @@ export function decorateCollection(name: string, def: { state: State; actions?:
       // the save toggle names the action it WILL take for this row. The
       // old static "Save / unsave" made the owner work out the row's state.
       row.collectionSaveLabel = row.collectionSaved ? copyParam('collection.unsave', 'Remove from saved') : copyParam('collection.save', 'Save');
+      row.collectionActionsLabel = collectionActionsLabel(String(row.collectionTitle ?? ''),
+        copyParam('collection.itemActionsFor', 'Actions for {title}'), copyParam('collection.itemActions', 'Item actions'));
     });
     if (previewId && !rows.some(row => collectionId(row) === previewId)) previewId = '';
     const filterChoices = [{ id: 'all', label: copyParam('collection.all', 'All') }, { id: 'saved', label: copyParam('collection.saved', 'Saved') },