@wix/himalaya-cli 0.1438.0 → 0.1440.0

package/guides/designing-himi-screens.md

@@ -252,7 +252,11 @@ scroll. *Reach for `SegmentedControl` for 2–4 in-content modes; `Tabs`/tab-bar
 **Feedback & overlays** — `Banner` for a persistent inline message (with a retry action on error);
 `Snackbar` for a transient confirmation; `AlertDialog` for a blocking decision; `BottomSheet` for
 contextual actions/detail; `Tooltip`/`Popover` for a small anchored hint. *Reach for `Snackbar`, not
-`AlertDialog`, to confirm a completed action — don't block on success.*
+`AlertDialog`, to confirm a completed action — don't block on success.* The `Snackbar` COMPONENT draws
+inline where you place it; for a transient toast that floats at the bottom of the screen — an app
+error after a failed action, say — use the `snackbar` presentation verb or `ui.snackbar({ message,
+tone: "danger" })` from a worker: it floats above the tab bar, animates in and out, queues, honours
+`durationMs`, and is announced to screen readers on every platform.
 
 **Status & data-viz** — `Badge`/`Tag`/`Chip` for compact labels; `Rating` for stars (`size: "sm"` in a
 dense row); `ProgressBar` for determinate progress, `ActivityIndicator` for indeterminate; `Gauge` for

package/guides/hhp.md

@@ -54,11 +54,15 @@ payloads retain native fields and normalize selection values into `event.value`.
 Nested scalar paths are checked and updated immutably. Two-way value binding owns
 the component's change callback. Explicit `on:change` is used for custom reducers.
 Boolean `bind:hidden` and existing declared property bindings are available.
+`bind:error` on a text field takes **string** state: the error message, where an
+empty string means valid (a boolean flag is a lint error).
 Read-only controls such as Gauge and ActivityIndicator accept one-way value
 bindings without generating a change action.
 
 Keyed lists use `each="items" key="id"` on a Grid/LazyList and one row template.
-Initial items require unique string ids. Row text uses `{{$item.title}}`. Compute
+Initial items require unique string ids. Row text uses `{{$item.title}}`; mixed
+row text such as `“{{$item.text}}”` is projected by the controller. `$item` bindings
+are typed from the initial rows: `bind:hidden="$item.done"` needs a boolean field. Compute
 expressions in controllers; interpolation accepts paths, not executable expressions.
 Direct `application/himalaya-service` scripts retain `defineService` authoring.
 
@@ -76,6 +80,14 @@ props; `slot="primary"` and `slot="detail"` supply SplitView slots. Structured p
 use a child `script type="application/himalaya-props"` containing JSON.
 `on:<native-action-property>` exposes declared events; click/change/submit have
 ordinary-control aliases. Explicit modifiers use `data-mod-*` or `himi-mod-*`.
+A `…-path` modifier (`data-mod-hidden-path="full"`, `data-mod-background-color-path`)
+names controller state exactly like `bind:*`, or `$item.<field>` in a row; an unknown
+path is a lint error. `onMeasure` keys name the renderer's measure store instead.
+`style` and `title` are HTML globals: `style` is always CSS, so a native `style`
+variant uses `variant="primary"`; `title="…"` sets a component's `title` field. CSS
+`font` applies only to text components (Text, Label, Marquee). The profile's
+handler list holds only router actions every renderer implements (`himi.open`);
+tab switching from content is not supported yet.
 
 The profile is the intersection of enabled deployment surfaces. It retains field
 eligibility and reports web support independently. Placeholder renderer cases,

package/guides/sdk-reference.json

@@ -4715,19 +4715,19 @@
       {
         "name": "SnackbarTone",
         "kind": "type",
-        "jsdoc": "/** Snackbar tone — maps to the app's tone background tokens. */",
+        "jsdoc": "/** Snackbar tone — maps to the app's tone background tokens (`info` → textPrimary, `success`,\n *  `warning`, `danger`). Use `danger` for errors; the hosts also accept `error` as an alias of it. */",
         "decl": "export type SnackbarTone = \"info\" | \"success\" | \"warning\" | \"danger\";"
       },
       {
         "name": "SnackbarOptions",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface SnackbarOptions {\n  message: string;\n  /** Default \"info\". */\n  tone?: SnackbarTone;\n  /** Auto-dismiss delay. Default 3000. Ignored on web (fixed-duration there). */\n  durationMs?: number;\n}"
+        "decl": "export interface SnackbarOptions {\n  message: string;\n  /** Default \"info\". */\n  tone?: SnackbarTone;\n  /** Auto-dismiss delay in ms, on every host. Default 3000; 0 or less also means 3000. */\n  durationMs?: number;\n}"
       },
       {
         "name": "snackbar",
         "kind": "function",
-        "jsdoc": "/** Show a transient snackbar toast. Resolves once it is PRESENTED (not after it\n *  auto-dismisses). Rejects with `no_ui_host` if no presenter is attached. */",
+        "jsdoc": "/** Show a transient snackbar toast: it floats above the tab bar, slides and fades in and out\n *  (fades only under reduced motion), queues behind one that is already showing, and is read\n *  by VoiceOver / TalkBack. Resolves once it is PRESENTED (not after it auto-dismisses).\n *  Rejects with `no_ui_host` if no presenter is attached. */",
         "decl": "export async function snackbar(options: SnackbarOptions): Promise<void>;"
       },
       {

package/guides/tier-5-add-a-screen.md

@@ -479,6 +479,17 @@ This is what makes the fail-closed capability gates readable. `local_database: e
 "X" is not declared in the app's dataSchema` is a message written to be read — before
 #2288 an author only ever saw an eternal spinner.
 
+**A persisted snapshot only hydrates the bundle that wrote it.** The cold-boot
+snapshot is stamped with the writing bundle's integrity hash (a reserved
+`__himalaya_snapshot` key beside the services) and restored only into that exact bundle.
+Ship a new bundle and the first cold boot starts every service from its declared `state`;
+the old snapshot is deleted and reported once per service as `worker_state_discarded`
+(`{ service, reason: "bundle_mismatch" | "unstamped", bundleHash, storedBundleHash }`).
+Snapshots written before stamping existed count as `unstamped`, which also means they are
+dropped once. So you never have to defend a reducer against last release's state shape —
+but a bundle change costs one cold boot of last-known content. Carrying state across bundle
+versions (`stateVersion` + `migrate`) is not supported yet.
+
 ### Show App Store prices for catalog items
 
 A screen that shows or sells a program, product or plan that may be an App Store in-app purchase

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1438.0",
+  "version": "0.1440.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": "ecadfa529dda6d1f49570340c04988f711cb239a5209ce8c69e31e86"
+  "falconPackageHash": "99935bae3ae7704f52450cbbbd84c04eb179c2bc315f759898441180"
 }

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

@@ -3691,7 +3691,7 @@ const SCREENS = runtimeSetting({
                         "onTap": {
                           "actionId": "himi.open",
                           "params": {
-                            "screenId": "himi_view_profile"
+                            "screenId": "himi_account_settings"
                           }
                         },
                         "pressFeedback": "scale",
@@ -3773,95 +3773,6 @@ const SCREENS = runtimeSetting({
                 "hiddenPath": "$service:himiStoreAccount.notMember"
               }
             },
-            {
-              "id": "himi_account.settings",
-              "body": {
-                "package": "himalaya",
-                "type": "HStack",
-                "props": {
-                  "spacing": 12,
-                  "children": [
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Icon",
-                        "props": {
-                          "name": "settings",
-                          "size": 18,
-                          "tint": "accentPrimary"
-                        }
-                      },
-                      "modifiers": {
-                        "accessibilityRole": "decorative"
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Text",
-                        "props": {
-                          "text": "My Account",
-                          "style": "bodyEmphasis"
-                        }
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Spacer",
-                        "props": {}
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Icon",
-                        "props": {
-                          "name": "chevron_right",
-                          "size": 16,
-                          "tint": "textTertiary"
-                        }
-                      },
-                      "modifiers": {
-                        "accessibilityRole": "decorative"
-                      }
-                    }
-                  ]
-                }
-              },
-              "modifiers": {
-                "background": {
-                  "token": "surfaceElevated"
-                },
-                "border": {
-                  "width": 1,
-                  "color": {
-                    "token": "border"
-                  }
-                },
-                "cornerRadius": 8,
-                "padding": {
-                  "leading": 14,
-                  "trailing": 14,
-                  "top": 13,
-                  "bottom": 13
-                },
-                "onTap": {
-                  "actionId": "himi.open",
-                  "params": {
-                    "screenId": "himi_account_settings"
-                  }
-                },
-                "pressFeedback": "scale",
-                "haptic": "light",
-                "accessibilityLabel": "My Account",
-                "hiddenPath": "$service:himiStoreAccount.notMember"
-              }
-            },
             {
               "id": "himi_account.subscriptions_guest",
               "body": {

package/templates/beauty-salon/tier5-src/himi-branded-lite-account-settings/index.ts

@@ -9,7 +9,7 @@ import { generateMemberPhotoUploadUrl } from "@himalaya/wix-site-media";
 import { memberAccess } from "../_shared/member-access.js";
 import { memberAccountRoutes } from "../_shared/member-account-routes.js";
 import { copyParam, stashCopy } from "../_shared/himi-copy.js";
-import "./blocked-members.js";
+import { svc as blockedMembers } from "./blocked-members.js";
 
 interface ProfileValues {
   displayName: string;
@@ -641,6 +641,9 @@ const svc = defineService<S, {
       const version = ++accountLoadVersion;
       photoUploadVersion += 1;
       stashCopy(arg);
+      // The blocked-members section also loads from its own nested onAppear on a device; starting it
+      // here too makes the root onAppear — the only one `himi test` fires — settle it. Re-entry-guarded.
+      void blockedMembers.load(arg).catch(() => undefined);
       try {
         const { email, scope, siteUrl, member } = await fetchMember((arg as { siteUrl?: unknown } | undefined)?.siteUrl);
         const current = await memberAccess();

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

@@ -5033,7 +5033,7 @@ const SCREENS = runtimeSetting({
                         "onTap": {
                           "actionId": "himi.open",
                           "params": {
-                            "screenId": "himi_view_profile"
+                            "screenId": "himi_account_settings"
                           }
                         },
                         "pressFeedback": "scale",
@@ -5115,95 +5115,6 @@ const SCREENS = runtimeSetting({
                 "hiddenPath": "$service:himiStoreAccount.notMember"
               }
             },
-            {
-              "id": "himi_account.settings",
-              "body": {
-                "package": "himalaya",
-                "type": "HStack",
-                "props": {
-                  "spacing": 12,
-                  "children": [
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Icon",
-                        "props": {
-                          "name": "settings",
-                          "size": 18,
-                          "tint": "accentPrimary"
-                        }
-                      },
-                      "modifiers": {
-                        "accessibilityRole": "decorative"
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Text",
-                        "props": {
-                          "text": "My Account",
-                          "style": "bodyEmphasis"
-                        }
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Spacer",
-                        "props": {}
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Icon",
-                        "props": {
-                          "name": "chevron_right",
-                          "size": 16,
-                          "tint": "textTertiary"
-                        }
-                      },
-                      "modifiers": {
-                        "accessibilityRole": "decorative"
-                      }
-                    }
-                  ]
-                }
-              },
-              "modifiers": {
-                "background": {
-                  "token": "surfaceElevated"
-                },
-                "border": {
-                  "width": 1,
-                  "color": {
-                    "token": "border"
-                  }
-                },
-                "cornerRadius": 8,
-                "padding": {
-                  "leading": 14,
-                  "trailing": 14,
-                  "top": 13,
-                  "bottom": 13
-                },
-                "onTap": {
-                  "actionId": "himi.open",
-                  "params": {
-                    "screenId": "himi_account_settings"
-                  }
-                },
-                "pressFeedback": "scale",
-                "haptic": "light",
-                "accessibilityLabel": "My Account",
-                "hiddenPath": "$service:himiStoreAccount.notMember"
-              }
-            },
             {
               "id": "himi_account.subscriptions_guest",
               "body": {

package/templates/branded-lite/tier5-src/himi-branded-lite-account-settings/index.ts

@@ -9,7 +9,7 @@ import { generateMemberPhotoUploadUrl } from "@himalaya/wix-site-media";
 import { memberAccess } from "../_shared/member-access.js";
 import { memberAccountRoutes } from "../_shared/member-account-routes.js";
 import { copyParam, stashCopy } from "../_shared/himi-copy.js";
-import "./blocked-members.js";
+import { svc as blockedMembers } from "./blocked-members.js";
 
 interface ProfileValues {
   displayName: string;
@@ -641,6 +641,9 @@ const svc = defineService<S, {
       const version = ++accountLoadVersion;
       photoUploadVersion += 1;
       stashCopy(arg);
+      // The blocked-members section also loads from its own nested onAppear on a device; starting it
+      // here too makes the root onAppear — the only one `himi test` fires — settle it. Re-entry-guarded.
+      void blockedMembers.load(arg).catch(() => undefined);
       try {
         const { email, scope, siteUrl, member } = await fetchMember((arg as { siteUrl?: unknown } | undefined)?.siteUrl);
         const current = await memberAccess();

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

@@ -2875,7 +2875,7 @@ const SCREENS = runtimeSetting({
                         "onTap": {
                           "actionId": "himi.open",
                           "params": {
-                            "screenId": "himi_view_profile"
+                            "screenId": "himi_account_settings"
                           }
                         },
                         "pressFeedback": "scale",
@@ -2957,95 +2957,6 @@ const SCREENS = runtimeSetting({
                 "hiddenPath": "$service:himiStoreAccount.notMember"
               }
             },
-            {
-              "id": "himi_account.settings",
-              "body": {
-                "package": "himalaya",
-                "type": "HStack",
-                "props": {
-                  "spacing": 12,
-                  "children": [
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Icon",
-                        "props": {
-                          "name": "settings",
-                          "size": 18,
-                          "tint": "accentPrimary"
-                        }
-                      },
-                      "modifiers": {
-                        "accessibilityRole": "decorative"
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Text",
-                        "props": {
-                          "text": "My Account",
-                          "style": "bodyEmphasis"
-                        }
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Spacer",
-                        "props": {}
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Icon",
-                        "props": {
-                          "name": "chevron_right",
-                          "size": 16,
-                          "tint": "textTertiary"
-                        }
-                      },
-                      "modifiers": {
-                        "accessibilityRole": "decorative"
-                      }
-                    }
-                  ]
-                }
-              },
-              "modifiers": {
-                "background": {
-                  "token": "surfaceElevated"
-                },
-                "border": {
-                  "width": 1,
-                  "color": {
-                    "token": "border"
-                  }
-                },
-                "cornerRadius": 8,
-                "padding": {
-                  "leading": 14,
-                  "trailing": 14,
-                  "top": 13,
-                  "bottom": 13
-                },
-                "onTap": {
-                  "actionId": "himi.open",
-                  "params": {
-                    "screenId": "himi_account_settings"
-                  }
-                },
-                "pressFeedback": "scale",
-                "haptic": "light",
-                "accessibilityLabel": "My Account",
-                "hiddenPath": "$service:himiStoreAccount.notMember"
-              }
-            },
             {
               "id": "",
               "body": {

package/templates/community-club/tier5-src/himi-branded-lite-account-settings/index.ts

@@ -9,7 +9,7 @@ import { generateMemberPhotoUploadUrl } from "@himalaya/wix-site-media";
 import { memberAccess } from "../_shared/member-access.js";
 import { memberAccountRoutes } from "../_shared/member-account-routes.js";
 import { copyParam, stashCopy } from "../_shared/himi-copy.js";
-import "./blocked-members.js";
+import { svc as blockedMembers } from "./blocked-members.js";
 
 interface ProfileValues {
   displayName: string;
@@ -641,6 +641,9 @@ const svc = defineService<S, {
       const version = ++accountLoadVersion;
       photoUploadVersion += 1;
       stashCopy(arg);
+      // The blocked-members section also loads from its own nested onAppear on a device; starting it
+      // here too makes the root onAppear — the only one `himi test` fires — settle it. Re-entry-guarded.
+      void blockedMembers.load(arg).catch(() => undefined);
       try {
         const { email, scope, siteUrl, member } = await fetchMember((arg as { siteUrl?: unknown } | undefined)?.siteUrl);
         const current = await memberAccess();

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

@@ -3059,7 +3059,7 @@ const SCREENS = runtimeSetting({
                         "onTap": {
                           "actionId": "himi.open",
                           "params": {
-                            "screenId": "himi_view_profile"
+                            "screenId": "himi_account_settings"
                           }
                         },
                         "pressFeedback": "scale",
@@ -3141,95 +3141,6 @@ const SCREENS = runtimeSetting({
                 "hiddenPath": "$service:himiStoreAccount.notMember"
               }
             },
-            {
-              "id": "himi_account.settings",
-              "body": {
-                "package": "himalaya",
-                "type": "HStack",
-                "props": {
-                  "spacing": 12,
-                  "children": [
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Icon",
-                        "props": {
-                          "name": "settings",
-                          "size": 18,
-                          "tint": "accentPrimary"
-                        }
-                      },
-                      "modifiers": {
-                        "accessibilityRole": "decorative"
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Text",
-                        "props": {
-                          "text": "My Account",
-                          "style": "bodyEmphasis"
-                        }
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Spacer",
-                        "props": {}
-                      }
-                    },
-                    {
-                      "id": "",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Icon",
-                        "props": {
-                          "name": "chevron_right",
-                          "size": 16,
-                          "tint": "textTertiary"
-                        }
-                      },
-                      "modifiers": {
-                        "accessibilityRole": "decorative"
-                      }
-                    }
-                  ]
-                }
-              },
-              "modifiers": {
-                "background": {
-                  "token": "surfaceElevated"
-                },
-                "border": {
-                  "width": 1,
-                  "color": {
-                    "token": "border"
-                  }
-                },
-                "cornerRadius": 8,
-                "padding": {
-                  "leading": 14,
-                  "trailing": 14,
-                  "top": 13,
-                  "bottom": 13
-                },
-                "onTap": {
-                  "actionId": "himi.open",
-                  "params": {
-                    "screenId": "himi_account_settings"
-                  }
-                },
-                "pressFeedback": "scale",
-                "haptic": "light",
-                "accessibilityLabel": "My Account",
-                "hiddenPath": "$service:himiStoreAccount.notMember"
-              }
-            },
             {
               "id": "",
               "body": {

package/templates/events-meetups/tier5-src/himi-branded-lite-account-settings/index.ts

@@ -9,7 +9,7 @@ import { generateMemberPhotoUploadUrl } from "@himalaya/wix-site-media";
 import { memberAccess } from "../_shared/member-access.js";
 import { memberAccountRoutes } from "../_shared/member-account-routes.js";
 import { copyParam, stashCopy } from "../_shared/himi-copy.js";
-import "./blocked-members.js";
+import { svc as blockedMembers } from "./blocked-members.js";
 
 interface ProfileValues {
   displayName: string;
@@ -641,6 +641,9 @@ const svc = defineService<S, {
       const version = ++accountLoadVersion;
       photoUploadVersion += 1;
       stashCopy(arg);
+      // The blocked-members section also loads from its own nested onAppear on a device; starting it
+      // here too makes the root onAppear — the only one `himi test` fires — settle it. Re-entry-guarded.
+      void blockedMembers.load(arg).catch(() => undefined);
       try {
         const { email, scope, siteUrl, member } = await fetchMember((arg as { siteUrl?: unknown } | undefined)?.siteUrl);
         const current = await memberAccess();