@wix/himalaya-cli 0.1292.0 → 0.1294.0

package/guides/importable-sdks.md

@@ -59,6 +59,7 @@ package in one greppable file) or `GET /v1/sdk/<name>` over HTTP; in the CLI,
 - `@himalaya/time` — Tier-5 temporal helpers.
 - `@himalaya/ui` — Tier-5 typed binding to the platform's imperative popup capability.
 - `@himalaya/webview` — Tier-5 typed binding for the page ↔ worker message channel of a worker-backed webview screen (Part 2 / RFC 0025 composition).
+- `@himalaya/webview-page` — browser-side SDK for a trusted page hosted by a worker-backed Himalaya WebView.
 - `@himalaya/widget` — Tier-5 logic-bundle widget surface.
 - `@himalaya/wix-llm` — narrow Tier-5 binding for Wix LLM text generation.
 - `@himalaya/wix-platform` — Wix Platform SDK (RFC 0042), worker-facing bindings.

package/guides/index.json

@@ -89,6 +89,12 @@
       "category": "Workers & SDKs",
       "file": "importable-sdks.md"
     },
+    {
+      "id": "webview-page-sdk",
+      "title": "Use native capabilities from a WebView page",
+      "category": "Workers & SDKs",
+      "file": "webview-page-sdk.md"
+    },
     {
       "id": "component-reference",
       "title": "Component reference",

package/guides/sdk-reference.json

@@ -4073,6 +4073,85 @@
         "jsdoc": "/**\n * Register a handler for messages the page posts via `window.HimalayaWorker.post(msg)`.\n * The latest registered handler wins. Call this once during the bundle's setup.\n */",
         "decl": "export function onPageMessage(cb: (msg: unknown) => void): void;"
       },
+      {
+        "name": "PageCapabilityRequest",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface PageCapabilityRequest {\n  v: 1;\n  id: string;\n  capability: string;\n  method: string;\n  args: unknown[];\n}"
+      },
+      {
+        "name": "PageCapabilityResponse",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface PageCapabilityResponse {\n  v: 1;\n  id: string;\n  ok: boolean;\n  result?: unknown;\n  error?: { message: string; code?: string };\n}"
+      },
+      {
+        "name": "ExposedPageCapability",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface ExposedPageCapability {\n  module: Record<string, unknown>;\n  methods: readonly string[];\n}"
+      },
+      {
+        "name": "exposeCapabilitiesToPage",
+        "kind": "function",
+        "jsdoc": "/**\n * Expose selected typed @himalaya/* modules to the hosting page.\n *\n * The worker author must pass both the imported module and its explicit verb allowlist:\n *\n *   import * as health from \"@himalaya/health\";\n *   exposeCapabilitiesToPage({\n *     health: { module: health, methods: [\"availability\", \"query\"] },\n *   });\n *\n * The bundle still has to declare `webview` plus every exposed capability. Importing only\n * selected modules keeps native permissions and `himi dist` additions opt-in.\n */",
+        "decl": "export function exposeCapabilitiesToPage(\n  capabilities: Readonly<Record<string, ExposedPageCapability>>,\n): void;"
+      },
+      {
+        "name": "version",
+        "kind": "const",
+        "jsdoc": "",
+        "decl": "export const version = 1;"
+      }
+    ]
+  },
+  {
+    "name": "@himalaya/webview-page",
+    "source": "core/sdk/webview-page/src/index.ts",
+    "description": "browser-side SDK for a trusted page hosted by a worker-backed Himalaya WebView.",
+    "api": [
+      {
+        "name": "\"./capabilities.generated.js\"",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export type { HimalayaPageCapabilities, HimalayaPageSdk } from \"./capabilities.generated.js\";"
+      },
+      {
+        "name": "WebViewPageRequest",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WebViewPageRequest {\n  v: 1;\n  id: string;\n  capability: string;\n  method: string;\n  args: unknown[];\n}"
+      },
+      {
+        "name": "WebViewPageError",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WebViewPageError {\n  message: string;\n  code?: string;\n}"
+      },
+      {
+        "name": "WebViewPageResponse",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface WebViewPageResponse {\n  v: 1;\n  id: string;\n  ok: boolean;\n  result?: unknown;\n  error?: WebViewPageError;\n}"
+      },
+      {
+        "name": "call",
+        "kind": "function",
+        "jsdoc": "/** Invoke one method through the companion worker. Primarily useful to generated bindings. */",
+        "decl": "export function call<T>(\n  capability: string,\n  method: string,\n  args: unknown[] = [],\n  timeoutMs = 30_000,\n): Promise<T>;"
+      },
+      {
+        "name": "himalaya",
+        "kind": "const",
+        "jsdoc": "/**\n * Typed SDK proxy for every request/response capability in CAPABILITY_REGISTRY.\n * A namespace is usable only when this screen's companion worker explicitly imported and\n * exposed it and the bundle + host both declared it.\n */",
+        "decl": "export const himalaya = new Proxy({ version: 1 as const }, {\n  get(target, property) {\n    if (property === \"version\") return target.version;\n    if (typeof property !== \"string\" || property === \"then\") return undefined;\n    return pageMember(property, []);\n  },\n}) as HimalayaPageSdk;"
+      },
+      {
+        "name": "health",
+        "kind": "const",
+        "jsdoc": "/** Convenience named export; equivalent to `himalaya.health`. */",
+        "decl": "export const health = himalaya.health;"
+      },
       {
         "name": "version",
         "kind": "const",

package/guides/webview-page-sdk.md

@@ -0,0 +1,132 @@
+# Himalaya SDK for hosted WebView pages
+
+Use `@wix/himalaya/webview-page` when a trusted webpage hosted inside Brandy (or another
+worker-backed Himalaya WebView) needs an explicitly selected native capability. The webpage never
+talks directly to native code:
+
+```
+page → window.HimalayaWorker → companion Tier-5 worker → @himalaya/* → native registry
+```
+
+The same bundle declaration and host policy that protect an ordinary Tier-5 screen protect the
+page. A namespace present in TypeScript is not authority: the companion worker must import and
+allowlist it, its `logicBundle.declaredCapabilities` must name it, and the binary must serve it.
+
+## Page
+
+Install the published umbrella package and import its page entry:
+
+```ts
+import { himalaya } from "@wix/himalaya/webview-page";
+
+const available = await himalaya.health.availability();
+if (available.available) {
+  await himalaya.health.requestPermission({ read: ["steps"], write: ["workouts"] });
+  const result = await himalaya.health.query({
+    type: "steps",
+    from: new Date("2026-10-11T00:00:00Z").toISOString(),
+    to: new Date().toISOString(),
+  });
+  console.log(result.samples);
+}
+```
+
+The generated `himalaya` type includes every package represented by
+`CAPABILITY_REGISTRY`, including nested APIs such as `himalaya.base44.auth.*`. Calls made in an
+ordinary browser fail immediately with a clear “not inside a worker-backed Himalaya WebView”
+error.
+
+## Companion worker
+
+Import only what this website is allowed to use and allowlist only the methods it needs:
+
+```ts
+import * as health from "@himalaya/health";
+import { exposeCapabilitiesToPage } from "@himalaya/webview";
+
+exposeCapabilitiesToPage({
+  health: {
+    module: health,
+    methods: ["availability", "requestPermission", "getPermissionStatus", "query", "saveWorkout"],
+  },
+});
+```
+
+Build it like any other Tier-5 bundle. Its descriptor must declare both the transport and the
+selected capabilities:
+
+```ts
+logicBundle: {
+  url,
+  integrity,
+  declaredCapabilities: ["webview", "health"],
+}
+```
+
+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.
+
+## Brandy
+
+Health has a built-in proof worker, so it needs no custom bundle name:
+
+```json
+{
+  "webSdk": {
+    "capabilities": ["health"],
+    "permissionCopy": {
+      "health": "Show your activity and save completed workouts."
+    }
+  }
+}
+```
+
+For another subset, add the companion bundle to the app and name it:
+
+```json
+{
+  "webSdk": {
+    "bundle": "customer-page-capabilities",
+    "capabilities": ["camera", "share"],
+    "permissionCopy": {
+      "camera": "Take a photo to attach it to your request."
+    }
+  }
+}
+```
+
+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.
+
+## Security and current transport boundary
+
+- Only the trusted main-frame origin receives `HimalayaWorker`; redirects and cross-origin frames
+  cannot use it.
+- The worker accepts JSON-compatible arguments and results, caps argument count, validates request
+  identifiers and resolves only own properties on an explicit method allowlist.
+- Errors preserve a typed `code` when the SDK provides one.
+- The page cannot use raw `capability.*` messages: Brandy site descriptors keep
+  `capabilitiesRequired: []`; native calls go through the companion worker.
+- v1 is request/response. SDK helpers returning `AsyncIterable`, accepting JavaScript callbacks,
+  or depending on worker action names need a page-specific adapter built from their lower-level
+  start/next/stop verbs. Do not expose such a helper unchanged.
+
+The package source includes complete `health-page.ts` and `health-worker.ts` examples matching the
+snippets above.
+
+## Demo app regression page
+
+The demo app hosts a page that calls every capability its iOS and Android boots already
+register. Open it with:
+
+```
+himalaya-demo-app://screen/demo_app_webview_sdk
+```
+
+The page is served at `/web/webview-sdk.html`. Its companion worker is
+`demo-app-webview-sdk`, which carries the catalog of allowlisted methods and read-only
+probes. Safe probes run on load.
+Verbs that prompt, write, or open system UI stay allowlisted and are not called. Streaming
+helpers that return a live object stay on the worker.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1292.0",
+  "version": "0.1294.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": [
@@ -70,5 +70,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "f2cddbdb94ceba1e08a45fef82f62b1e3debb12f1c9fa20e0984d0c3"
+  "falconPackageHash": "09e12b3c3f8e23efc26c5fee02873fd0f086030be36e989ccb20d835"
 }

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

@@ -24242,6 +24242,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_order(?:[_/](.+))?$", display: "himi_order[_{id}]", template: {

package/templates/branded-lite/dev/index.ts

@@ -80521,6 +80521,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_order(?:[_/](.+))?$", display: "himi_order[_{id}]", template: {

package/templates/community-club/dev/index.ts

@@ -17012,6 +17012,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_event(?:[_/](.+))?$", display: "himi_event[_{id}]", liveSeed: {"path":"/events/v3/events/query","body":{"query":{"paging":{"limit":50}}},"listKey":"events","prefix":"himi_event_"}, template: {

package/templates/events-meetups/dev/index.ts

@@ -15010,6 +15010,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_event(?:[_/](.+))?$", display: "himi_event[_{id}]", liveSeed: {"path":"/events/v3/events/query","body":{"query":{"paging":{"limit":50}}},"listKey":"events","prefix":"himi_event_"}, template: {

package/templates/gym-fitness/dev/index.ts

@@ -28843,6 +28843,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_order(?:[_/](.+))?$", display: "himi_order[_{id}]", template: {

package/templates/nonprofit-cause/dev/index.ts

@@ -18297,6 +18297,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_event(?:[_/](.+))?$", display: "himi_event[_{id}]", liveSeed: {"path":"/events/v3/events/query","body":{"query":{"paging":{"limit":50}}},"listKey":"events","prefix":"himi_event_"}, template: {

package/templates/podcast-creator/dev/index.ts

@@ -18650,6 +18650,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_event(?:[_/](.+))?$", display: "himi_event[_{id}]", liveSeed: {"path":"/events/v3/events/query","body":{"query":{"paging":{"limit":50}}},"listKey":"events","prefix":"himi_event_"}, template: {

package/templates/portfolio-creative/dev/index.ts

@@ -21025,6 +21025,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_order(?:[_/](.+))?$", display: "himi_order[_{id}]", template: {

package/templates/restaurant/dev/index.ts

@@ -15374,6 +15374,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_menu_item(?:[_/](.+))?$", display: "himi_menu_item[_{id}]", liveSeed: {"path":"/restaurants/menus/v1/items/query","body":{"paging":{"limit":50}},"listKey":"items","prefix":"himi_menu_item_"}, template: {

package/templates/retail-store/dev/index.ts

@@ -14040,6 +14040,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_order(?:[_/](.+))?$", display: "himi_order[_{id}]", template: {

package/templates/yoga-studio/dev/index.ts

@@ -23895,6 +23895,25 @@ const SCREENS = runtimeSetting({
   },
 }) as Record<string, unknown>;
 
+// The language destination stays registered for deep links and future translations. Keep its
+// account entry out of a single-language app; adding a locale to config.locale.translations
+// makes the same entry visible after the app config reloads.
+const localeConfig = config.locale as { default?: string; translations?: readonly string[] } | undefined;
+const configuredLocales = new Set([localeConfig?.default ?? "en", ...(localeConfig?.translations ?? [])]);
+if (localeConfig && configuredLocales.size <= 1) {
+  const removeLanguageEntry = (value: unknown): unknown => {
+    if (Array.isArray(value)) return value.flatMap((child) => {
+      const next = removeLanguageEntry(child);
+      return next === undefined ? [] : [next];
+    });
+    if (!value || typeof value !== "object") return value;
+    const node = value as Record<string, unknown>;
+    if (node.id === "himi_account.language") return undefined;
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, removeLanguageEntry(child)]));
+  };
+  const account = SCREENS["himi_account"] as { payload?: unknown } | undefined;
+  if (account?.payload) account.payload = removeLanguageEntry(account.payload);
+}
 interface LiveSeed { path: string; body: unknown; listKey: string; prefix: string; limit?: number }
 const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; staticSeedIds?: string[]; template: unknown }[] = [
   { pattern: "^himi_service(?:[_/](.+))?$", display: "himi_service[_{id}]", liveSeed: {"path":"/bookings/v2/services/query","body":{"query":{"paging":{"limit":50}}},"listKey":"services","prefix":"himi_service_"}, template: {