@wix/himalaya-cli 0.1582.0 → 0.1583.0

package/guides/component-reference.json

@@ -39,9 +39,10 @@
       "category": "Core",
       "propsType": "LazyListProps",
       "bindings": [
-        "itemsPath"
+        "itemsPath",
+        "scrollToItemPath"
       ],
-      "propsSource": "export interface LazyListProps {\n  items: Component[];\n  horizontal?: boolean;\n  spacing?: number;\n  /** Motion grammar (Batch 1) — staggered entrance: each child's enter\n   *  transition/appear is delayed by index × staggerMs (ms). 0/absent = no\n   *  stagger. Gated by reduced motion.\n   *\n   *  Honored on every renderer, on BOTH the static `items` and the service-bound\n   *  `itemsPath` paths. The delay modulates an ENTRANCE, so it only cascades a row\n   *  that carries a `transition`/`appear` — a delay on a row with no entrance\n   *  animates nothing. */\n  staggerMs?: number;\n  /** List enrichments. */\n  onPullToRefresh?: Action;\n  pagination?: Pagination;\n  stickyHeader?: Component;\n  rowSwipeActions?: SwipeActionSet;\n  /**\n   * Tier-5 service-bound list: a `$service:`-style path to an array in the\n   * worker's state (e.g. \"ownerSites.sites\"). When set, `items[0]` is the row\n   * TEMPLATE — instantiated once per array element with `$item.<field>`\n   * substitution (ServiceBoundList). Requires a serviceProvider at render.\n   */\n  itemsPath?: string;\n  /** Motion grammar (Phase-3, layout animation) — animate item insert/remove/reorder\n   *  as the list's contents change (needs stable `Component.id`s). Reduced-motion gated. */\n  animateItems?: boolean;\n  /**\n   * #1054 (WS-3 scroll) — bottom-anchored / reversed layout. When true the list\n   * lays out from the BOTTOM (item[0] at the bottom, later items stacking upward)\n   * and rests scrolled to the bottom — a chat transcript / live caption that\n   * pins to the latest without the 180°-rotation hack. Vertical lists only; not\n   * combined with a `stickyHeader`.\n   */\n  reverseLayout?: boolean;\n  /**\n   * #1054 (WS-3 scroll) — content insets (points): pad the scroll CONTENT at the\n   * top/bottom while the scroller still paints edge-to-edge, so rows scroll\n   * *under* floating chrome (a translucent header/footer) instead of being\n   * clipped. 0/absent ⇒ no inset.\n   */\n  contentInsetTop?: number;\n  contentInsetBottom?: number;\n}"
+      "propsSource": "export interface LazyListProps {\n  items: Component[];\n  horizontal?: boolean;\n  spacing?: number;\n  /** Motion grammar (Batch 1) — staggered entrance: each child's enter\n   *  transition/appear is delayed by index × staggerMs (ms). 0/absent = no\n   *  stagger. Gated by reduced motion.\n   *\n   *  Honored on every renderer, on BOTH the static `items` and the service-bound\n   *  `itemsPath` paths. The delay modulates an ENTRANCE, so it only cascades a row\n   *  that carries a `transition`/`appear` — a delay on a row with no entrance\n   *  animates nothing. */\n  staggerMs?: number;\n  /** List enrichments. */\n  onPullToRefresh?: Action;\n  pagination?: Pagination;\n  stickyHeader?: Component;\n  rowSwipeActions?: SwipeActionSet;\n  /**\n   * Tier-5 service-bound list: a `$service:`-style path to an array in the\n   * worker's state (e.g. \"ownerSites.sites\"). When set, `items[0]` is the row\n   * TEMPLATE — instantiated once per array element with `$item.<field>`\n   * substitution (ServiceBoundList). Requires a serviceProvider at render.\n   */\n  itemsPath?: string;\n  /** Motion grammar (Phase-3, layout animation) — animate item insert/remove/reorder\n   *  as the list's contents change (needs stable `Component.id`s). Reduced-motion gated. */\n  animateItems?: boolean;\n  /**\n   * #1054 (WS-3 scroll) — bottom-anchored / reversed layout. When true the list\n   * lays out from the BOTTOM (item[0] at the bottom, later items stacking upward)\n   * and rests scrolled to the bottom — a chat transcript / live caption that\n   * pins to the latest without the 180°-rotation hack. Vertical lists only; not\n   * combined with a `stickyHeader`.\n   */\n  reverseLayout?: boolean;\n  /**\n   * #1054 (WS-3 scroll) — content insets (points): pad the scroll CONTENT at the\n   * top/bottom while the scroller still paints edge-to-edge, so rows scroll\n   * *under* floating chrome (a translucent header/footer) instead of being\n   * clipped. 0/absent ⇒ no inset.\n   */\n  contentInsetTop?: number;\n  contentInsetBottom?: number;\n  /**\n   * Jump to a row of a bound (`itemsPath`) list: a `$service:` path whose value names a row by\n   * its item's `id`. When the value CHANGES to a non-empty one, the row's top is brought to the\n   * top of the visible area (the list's scroll, or the screen's when the list sits in it).\n   * Only the part before the first \"|\" is the id, so a worker can re-trigger the same row\n   * (\"cat:yoga|2\"). Unknown id ⇒ nothing.\n   */\n  scrollToItemPath?: string;\n  /**\n   * Fired with args `{ id }` when the bound row at the top of the visible area changes because\n   * the user scrolled: on a change only, after the scroll settles, never for a\n   * `scrollToItemPath` jump, not on first render. Rows with no `id` are skipped.\n   */\n  onTopItemChange?: Action;\n}"
     },
     {
       "name": "Grid",
@@ -1257,7 +1258,7 @@
         "eventsPath",
         "scrollToDatePath"
       ],
-      "propsSource": "export interface AgendaProps {\n  events?: CalendarEvent[];\n  eventsPath?: string;\n  scrollToDate?: string;\n  /** Worker-driven jump target (a literal `scrollToDate` is frozen in the descriptor). */\n  scrollToDatePath?: string;\n  stickyHeaders?: boolean;\n  emptyText?: string;\n  onSelectEvent?: Action;\n  /** Per-event row body, `$item.*`-substituted per event. Closes the gap that made\n   *  `agendaList()` (the LazyList-backed PRESET, which takes a `rowTemplate`) more\n   *  expressive than this component. Absent ⇒ the built-in row. */\n  eventTemplate?: Component;\n  /** Newest-first. Absent/false ⇒ ascending. Applies to the day GROUPS and to the\n   *  events within each group. Without it a list whose default sort is \"Newest\"\n   *  (an owner's orders, recent activity) could not become an Agenda without\n   *  silently inverting itself — every arm sorted ascending unconditionally. */\n  descending?: boolean;\n}"
+      "propsSource": "export interface AgendaProps {\n  events?: CalendarEvent[];\n  eventsPath?: string;\n  scrollToDate?: string;\n  /** Worker-driven jump target (a literal `scrollToDate` is frozen in the descriptor). Either may be\n   *  \"YYYY-MM-DD|<anything>\": the day is the part before \"|\", and a change of the whole value jumps\n   *  again, also to the same day. A suffix-less value equal to the day last reported through\n   *  `onVisibleDateChange` is an echo of the user's own scroll and does not move the list. */\n  scrollToDatePath?: string;\n  stickyHeaders?: boolean;\n  emptyText?: string;\n  onSelectEvent?: Action;\n  /** Per-event row body, `$item.*`-substituted per event. Closes the gap that made\n   *  `agendaList()` (the LazyList-backed PRESET, which takes a `rowTemplate`) more\n   *  expressive than this component. Absent ⇒ the built-in row. */\n  eventTemplate?: Component;\n  /** Newest-first. Absent/false ⇒ ascending. Applies to the day GROUPS and to the\n   *  events within each group. Without it a list whose default sort is \"Newest\"\n   *  (an owner's orders, recent activity) could not become an Agenda without\n   *  silently inverting itself — every arm sorted ascending unconditionally. */\n  descending?: boolean;\n  /** Fired with args `{ date: \"YYYY-MM-DD\" }` when the day group at the top of the visible area\n   *  changes because the user scrolled (the agenda's own scroll, or the screen's): on a change\n   *  only, after the scroll settles, never for a `scrollToDate` jump, not on first render. Lets a\n   *  calendar above the list follow it. */\n  onVisibleDateChange?: Action;\n}"
     }
   ],
   "descriptor": {

package/guides/component-reference.md

@@ -30,7 +30,7 @@ See also **[Modifiers](#modifiers)** (the `modifiers` block) and **[Actions](#ac
 | `VStack` | Core | — |
 | `HStack` | Core | — |
 | `ZStack` | Core | — |
-| `LazyList` | Core | `itemsPath` |
+| `LazyList` | Core | `itemsPath`, `scrollToItemPath` |
 | `Grid` | Core | `itemsPath` |
 | `Card` | Core | — |
 | `SplitView` | Core | — |
@@ -296,6 +296,20 @@ export interface LazyListProps {
    */
   contentInsetTop?: number;
   contentInsetBottom?: number;
+  /**
+   * Jump to a row of a bound (`itemsPath`) list: a `$service:` path whose value names a row by
+   * its item's `id`. When the value CHANGES to a non-empty one, the row's top is brought to the
+   * top of the visible area (the list's scroll, or the screen's when the list sits in it).
+   * Only the part before the first "|" is the id, so a worker can re-trigger the same row
+   * ("cat:yoga|2"). Unknown id ⇒ nothing.
+   */
+  scrollToItemPath?: string;
+  /**
+   * Fired with args `{ id }` when the bound row at the top of the visible area changes because
+   * the user scrolled: on a change only, after the scroll settles, never for a
+   * `scrollToItemPath` jump, not on first render. Rows with no `id` are skipped.
+   */
+  onTopItemChange?: Action;
 }
 ```
 
@@ -2316,7 +2330,10 @@ export interface AgendaProps {
   events?: CalendarEvent[];
   eventsPath?: string;
   scrollToDate?: string;
-  /** Worker-driven jump target (a literal `scrollToDate` is frozen in the descriptor). */
+  /** Worker-driven jump target (a literal `scrollToDate` is frozen in the descriptor). Either may be
+   *  "YYYY-MM-DD|<anything>": the day is the part before "|", and a change of the whole value jumps
+   *  again, also to the same day. A suffix-less value equal to the day last reported through
+   *  `onVisibleDateChange` is an echo of the user's own scroll and does not move the list. */
   scrollToDatePath?: string;
   stickyHeaders?: boolean;
   emptyText?: string;
@@ -2330,6 +2347,11 @@ export interface AgendaProps {
    *  (an owner's orders, recent activity) could not become an Agenda without
    *  silently inverting itself — every arm sorted ascending unconditionally. */
   descending?: boolean;
+  /** Fired with args `{ date: "YYYY-MM-DD" }` when the day group at the top of the visible area
+   *  changes because the user scrolled (the agenda's own scroll, or the screen's): on a change
+   *  only, after the scroll settles, never for a `scrollToDate` jump, not on first render. Lets a
+   *  calendar above the list follow it. */
+  onVisibleDateChange?: Action;
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1582.0",
+  "version": "0.1583.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": [
@@ -72,5 +72,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "2d8efcab269fac658b0596662ac44e3c7af42259f2294fa5db370d7d"
+  "falconPackageHash": "2447e780474e18ae289e6b340128ea20a1a5bd106c533fac79a5ed8e"
 }

package/templates/beauty-salon/config.ts

@@ -455,7 +455,7 @@ export default defineApp({
   // Your on-device database. It must declare every entity a worker reads or writes,
   // or those calls fail closed — keep it in step with `local_database` above.
   dataSchema: {
-    "version": 2,
+    "version": 3,
     "entities": [
       {
         "name": "products",
@@ -536,6 +536,25 @@ export default defineApp({
           }
         ]
       },
+      {
+        "name": "booking_prefs",
+        "encrypted": false,
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "locationId",
+            "type": "string"
+          },
+          {
+            "name": "locationLabel",
+            "type": "string"
+          }
+        ]
+      },
       {
         "name": "cms_collections",
         "encrypted": false,