@wix/himalaya-cli 0.1529.0 → 0.1531.0

package/templates/community-club/tier5-src/_shared/collection-service.ts

@@ -12,11 +12,15 @@ export interface CollectionSaving {
 type State = Record<string, unknown>;
 interface BackendCollection {
   restorePagesOnLoad?: boolean;
-  /** Sees the load action's argument (the screen's onAppear params) BEFORE the query runs. */
-  onLoad?(arg: unknown): void;
+  /** Sees the load action's argument (the screen's onAppear params) BEFORE the query runs. A returned
+   *  `{ filter, sort }` resets the criteria for that load (a screen that always opens on one view). */
+  onLoad?(arg: unknown): CollectionCriteriaReset | void;
   controller: ReturnType<typeof createCollectionQuery<CollectionRow>>;
   apply(state: State, page: CollectionQueryState<CollectionRow>): State;
 }
+/** A filter and a sort set together (`collectionCriteria`, `onLoad`). Values the collection's contract does
+ *  not list are ignored. */
+export interface CollectionCriteriaReset { filter?: string; sort?: string; query?: string }
 type Reducer = (s: State, ...args: unknown[]) => State | undefined | Promise<State | undefined>;
 const object = (x: unknown): State => x && typeof x === 'object' && !Array.isArray(x) ? x as State : {};
 const str = (arg: unknown, key: string): string => typeof arg === 'string' ? arg : String(object(arg)[key] ?? '');
@@ -262,6 +266,16 @@ export function decorateCollection(name: string, def: { state: State; actions?:
     if (backend && config.backendQuery && criteriaBefore !== criteriaKey()) return backend.controller.query(criteria()).then(() => undefined);
     return derive(s);
   };
+  /** Filter and sort in ONE criteria change, so a tab that sets both runs one query, not two. */
+  const setCriteria = (arg: unknown): void => {
+    const input = object(arg);
+    const sort = String(input.sort ?? '');
+    if (sort === 'default' || sort === 'az' || sort === 'za') prefs.sort = sort;
+    const filter = String(input.filter ?? '');
+    if (filter === 'all' || (filter.startsWith('value:') && (config.filterValues ?? []).includes(filter.slice(6)))) prefs.filter = filter;
+    // A screen with no search field clears a query an older screen persisted, or it narrows every view for good.
+    if (typeof input.query === 'string') prefs.query = input.query.slice(0, 256);
+  };
   const criteria = () => ({ query: prefs.query, sort: prefs.sort, filter: prefs.filter, savedIds: prefs.filter === 'saved' ? prefs.savedIds : [] });
   const criteriaKey = () => JSON.stringify(criteria());
   actions.collectionDismissFilters = change(() => { filtersPresented = false; });
@@ -273,6 +287,7 @@ export function decorateCollection(name: string, def: { state: State; actions?:
   actions.collectionSort = change(arg => { const value = str(arg, 'selectedId'); if (value === 'default' || value === 'az' || value === 'za') prefs.sort = value; });
   actions.collectionFilter = change(arg => { const values = object(arg).selectedIds; prefs.filter = Array.isArray(values) && typeof values[0] === 'string' ? values[0] : 'all'; });
   actions.collectionSearch = change(arg => { prefs.query = str(arg, 'value').slice(0, 256); });
+  actions.collectionCriteria = change(arg => setCriteria(arg));
   actions.collectionViewName = change(arg => { viewName = str(arg, 'value').slice(0, 40); viewMessage = ''; });
   actions.collectionRememberView = change(() => {
     const name = viewName.trim();
@@ -305,7 +320,8 @@ export function decorateCollection(name: string, def: { state: State; actions?:
     actions.collectionDataChanged = s => derive(backend.apply(s, backend.controller.getState()));
     actions.load = (_s, arg) => {
       stashCopy(arg); syncSaved(); applyNavigationCriteria(arg, _s);
-      backend.onLoad?.(arg);
+      const reset = backend.onLoad?.(arg);
+      if (reset) { setCriteria(reset); persisted.write(prefs); }
       // A load of what the screen already shows is the screen coming back: it revalidates behind its rows.
       return backend.controller.query(criteria(), backend.restorePagesOnLoad, true).then(() => undefined);
     };
@@ -334,11 +350,13 @@ export function defineBackendCollection<S extends object, Row extends object>(na
   register?: typeof register;
   /** Explicit mutation preflight; unrelated collection services keep their current reducers. */
   onlineWrites?: boolean;
+  /** Where the offline refusal is written (default `actionMessage`) — the field the screen shows next to the action. */
+  onlineWriteMessageFields?: readonly string[];
   /** Revalidate already opened pages on navigation return; explicit refresh resets. */
   restorePagesOnLoad?: boolean;
   /** The load action's argument (onAppear params beyond `copy`), before the query runs — for a
    *  domain setting that rides the descriptor, e.g. My Bookings' `weeklyGoal`. */
-  onLoad?(arg: unknown): void;
+  onLoad?(arg: unknown): CollectionCriteriaReset | void;
   state: S;
   source: CollectionQuerySource<Row>;
   apply(state: S, page: CollectionQueryState<Row>): S;
@@ -353,7 +371,7 @@ export function defineBackendCollection<S extends object, Row extends object>(na
     controller: controller as unknown as BackendCollection['controller'],
     apply: (state, page) => options.apply(state as S, page as unknown as CollectionQueryState<Row>) as State,
   });
-  const registerService = options.onlineWrites ? withOnlineWrites(options.register ?? register, ['confirmCancel', 'confirmOperation', 'retryOperation', 'commitWrite'], { messageFields: ['actionMessage'] }) : (options.register ?? register);
+  const registerService = options.onlineWrites ? withOnlineWrites(options.register ?? register, ['confirmCancel', 'confirmOperation', 'retryOperation', 'commitWrite'], { messageFields: options.onlineWriteMessageFields ?? ['actionMessage'] }) : (options.register ?? register);
   const handle = registerService(name, definition);
   // Registration restored the state a cold boot saved: the page it showed is this run's, before the first load. Only
   // when the service's own rows came back with it: a bundle that keeps them out of the restore (its `notHydrated`)

package/templates/community-club/tier5-src/_shared/engine-intl.ts

@@ -108,6 +108,24 @@ export function formatMonthDayLong(date: Date, locale = "en-US", timeZone?: stri
   return `${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
 }
 
+const WEEKDAYS_LONG = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"] as const;
+
+/** `{ weekday: "short", month: "short", day: "numeric" }` — "Mon, Jan 5". */
+export function formatWeekdayMonthDay(date: Date, locale = "en-US", timeZone?: string): string {
+  if (hasIntl()) {
+    return dateFormat(locale, { weekday: "short", month: "short", day: "numeric" }, timeZone).format(date);
+  }
+  return `${WEEKDAYS_SHORT[date.getDay()]}, ${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}`;
+}
+
+/** `{ weekday: "long", month: "long", day: "numeric" }` — "Monday, January 5". */
+export function formatWeekdayMonthDayLong(date: Date, locale = "en-US", timeZone?: string): string {
+  if (hasIntl()) {
+    return dateFormat(locale, { weekday: "long", month: "long", day: "numeric" }, timeZone).format(date);
+  }
+  return `${WEEKDAYS_LONG[date.getDay()]}, ${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
+}
+
 /** `{ weekday: "short", month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }`
  *  — "Mon, Jan 5, 3:07 PM". */
 export function formatWeekdayDateTime(date: Date, locale = "en-US", timeZone?: string): string {

package/templates/community-club/tier5-src/_shared/member-bookings.ts

@@ -6,27 +6,69 @@ import { copyParam } from "./himi-copy.js";
 import { formatWeekdayDateTime } from "./engine-intl.js";
 import { dayKey } from "@himalaya/time";
 
+/** The statuses that put a booking in the Canceled tab. Upcoming and Past exclude them, so each
+ *  booking is in exactly one tab. */
+export const CANCELLED_STATUSES = ["CANCELED", "CANCELLED", "DECLINED"];
+
 export interface MemberBookingRow {
   id: string; title: string; subtitle: string; status: string; revision: string;
   start: string; end: string; day: string; serviceId: string;
   canCancel: boolean; cannotCancel: boolean; cannotRebook: boolean;
+  // Added for the My Bookings redesign. Each is "" / 0 / false when the record has nothing for it.
+  /** The staff member (the slot's resource), "" when the booking names none. */
+  staff: string;
+  /** The location's name, else its address. */
+  placeName: string;
+  /** The location's formatted address. */
+  placeAddress: string;
+  /** `BUSINESS`, `CUSTOM` or `CUSTOMER` (the client's place), upper case. */
+  placeType: string;
+  participants: number;
+  /** Wix's raw payment status, upper case (`PAID`, `NOT_PAID`, …). */
+  paymentStatus: string;
+  /** Wix's raw booking status, upper case (`CONFIRMED`, `WAITING_LIST`, …). */
+  statusKey: string;
+  /** A course booking: it books a schedule, not a slot. */
+  isCourse: boolean;
+  courseStart: string;
+  courseEnd: string;
 }
 export function bookingStart(booking: WixBooking): string {
   // Top-level instants are UTC. Slot dates may be LOCAL to slot.timezone.
   const value = booking.startDate || booking.bookedEntity?.slot?.startDate || "";
   return /(?:Z|[+-]\d{2}:?\d{2})$/i.test(value) && Number.isFinite(Date.parse(value)) ? value : "";
 }
+const instant = (value: unknown): string =>
+  typeof value === "string" && /(?:Z|[+-]\d{2}:?\d{2})$/i.test(value) && Number.isFinite(Date.parse(value)) ? value : "";
+const word = (value: unknown): string => typeof value === "string" ? value.trim() : "";
 export function memberBookingRow(booking: WixBooking): MemberBookingRow {
   const start = bookingStart(booking);
   const entity = booking.bookedEntity;
+  const slot = entity?.slot, schedule = entity?.schedule;
   const status = (booking.status || "").toUpperCase();
   const revision = String((booking as WixBooking & { revision?: string | number }).revision ?? "");
-  const serviceId = entity?.slot?.serviceId || "";
-  const canCancel = !!booking.id && !!revision && Date.parse(start) > Date.now() && !["CANCELED", "CANCELLED", "DECLINED"].includes(status);
+  // A course booking carries a schedule, not a slot: its service id is on the schedule.
+  const serviceId = slot?.serviceId || schedule?.serviceId || "";
+  const canCancel = !!booking.id && !!revision && Date.parse(start) > Date.now() && !CANCELLED_STATUSES.includes(status);
+  const location = slot?.location ?? schedule?.location;
+  const placeAddress = word(location?.formattedAddress);
+  const participants = Number(booking.totalParticipants);
   return { id: booking.id, title: entity?.title || copyParam("bookings.booking", "Booking"),
     subtitle: start ? formatWeekdayDateTime(new Date(start)) : copyParam("bookings.timeUnavailable", "Time unavailable"),
-    status: status.replace(/_/g, " "), revision, start, end: booking.endDate || "", day: start ? dayKey(new Date(start)) : "",
-    serviceId, canCancel, cannotCancel: !canCancel, cannotRebook: !serviceId };
+    status: status.replace(/_/g, " "), revision, start,
+    // Wix may carry the end only on the slot (same instant rule as the start).
+    end: booking.endDate || instant(slot?.endDate), day: start ? dayKey(new Date(start)) : "",
+    serviceId, canCancel, cannotCancel: !canCancel, cannotRebook: !serviceId,
+    staff: word(slot?.resource?.name),
+    placeName: word(location?.name) || placeAddress,
+    placeAddress,
+    placeType: word(location?.locationType).toUpperCase(),
+    participants: Number.isFinite(participants) && participants > 0 ? Math.floor(participants) : 0,
+    paymentStatus: word(booking.paymentStatus).toUpperCase(),
+    statusKey: status,
+    isCourse: !slot && !!schedule,
+    courseStart: instant(schedule?.firstSessionStart),
+    courseEnd: instant(schedule?.lastSessionEnd) };
 }
 export async function fetchMemberBookings(criteria: CollectionQuery, cursor: string, now: string, expected?: MemberAccess) {
   const member = expected ?? await memberAccess();
@@ -37,9 +79,10 @@ export async function fetchMemberBookings(criteria: CollectionQuery, cursor: str
   const filter: Record<string, unknown> = { "contactDetails.email": { $eq: member.email } };
   if (criteria.query) filter.id = { $eq: criteria.query };
   if (criteria.filter === "saved") filter.id = criteria.query ? { $in: criteria.savedIds.filter(id => id === criteria.query) } : { $in: criteria.savedIds };
-  if (criteria.filter === "value:Upcoming") { filter.startDate = { $gte: now }; filter.status = { $nin: ["CANCELED", "CANCELLED", "DECLINED"] }; }
-  if (criteria.filter === "value:Past") filter.startDate = { $lt: now };
-  if (criteria.filter === "value:Cancelled") filter.status = { $in: ["CANCELED", "CANCELLED"] };
+  if (criteria.filter === "value:Upcoming") { filter.startDate = { $gte: now }; filter.status = { $nin: CANCELLED_STATUSES }; }
+  // Past is what took place: a canceled or declined booking is in the Canceled tab only.
+  if (criteria.filter === "value:Past") { filter.startDate = { $lt: now }; filter.status = { $nin: CANCELLED_STATUSES }; }
+  if (criteria.filter === "value:Cancelled") filter.status = { $in: CANCELLED_STATUSES };
   const response = await queryBookings({ query: { filter, paging: { limit: 50, offset: Number(cursor || 0) },
     sort: [{ fieldName: "startDate", order: criteria.sort === "za" ? "DESC" : "ASC" }, { fieldName: "id", order: "ASC" }] } });
   await assertMemberAccess(member);

package/templates/community-club-owner/tier5-src/_shared/collection-service.ts

@@ -12,11 +12,15 @@ export interface CollectionSaving {
 type State = Record<string, unknown>;
 interface BackendCollection {
   restorePagesOnLoad?: boolean;
-  /** Sees the load action's argument (the screen's onAppear params) BEFORE the query runs. */
-  onLoad?(arg: unknown): void;
+  /** Sees the load action's argument (the screen's onAppear params) BEFORE the query runs. A returned
+   *  `{ filter, sort }` resets the criteria for that load (a screen that always opens on one view). */
+  onLoad?(arg: unknown): CollectionCriteriaReset | void;
   controller: ReturnType<typeof createCollectionQuery<CollectionRow>>;
   apply(state: State, page: CollectionQueryState<CollectionRow>): State;
 }
+/** A filter and a sort set together (`collectionCriteria`, `onLoad`). Values the collection's contract does
+ *  not list are ignored. */
+export interface CollectionCriteriaReset { filter?: string; sort?: string; query?: string }
 type Reducer = (s: State, ...args: unknown[]) => State | undefined | Promise<State | undefined>;
 const object = (x: unknown): State => x && typeof x === 'object' && !Array.isArray(x) ? x as State : {};
 const str = (arg: unknown, key: string): string => typeof arg === 'string' ? arg : String(object(arg)[key] ?? '');
@@ -262,6 +266,16 @@ export function decorateCollection(name: string, def: { state: State; actions?:
     if (backend && config.backendQuery && criteriaBefore !== criteriaKey()) return backend.controller.query(criteria()).then(() => undefined);
     return derive(s);
   };
+  /** Filter and sort in ONE criteria change, so a tab that sets both runs one query, not two. */
+  const setCriteria = (arg: unknown): void => {
+    const input = object(arg);
+    const sort = String(input.sort ?? '');
+    if (sort === 'default' || sort === 'az' || sort === 'za') prefs.sort = sort;
+    const filter = String(input.filter ?? '');
+    if (filter === 'all' || (filter.startsWith('value:') && (config.filterValues ?? []).includes(filter.slice(6)))) prefs.filter = filter;
+    // A screen with no search field clears a query an older screen persisted, or it narrows every view for good.
+    if (typeof input.query === 'string') prefs.query = input.query.slice(0, 256);
+  };
   const criteria = () => ({ query: prefs.query, sort: prefs.sort, filter: prefs.filter, savedIds: prefs.filter === 'saved' ? prefs.savedIds : [] });
   const criteriaKey = () => JSON.stringify(criteria());
   actions.collectionDismissFilters = change(() => { filtersPresented = false; });
@@ -273,6 +287,7 @@ export function decorateCollection(name: string, def: { state: State; actions?:
   actions.collectionSort = change(arg => { const value = str(arg, 'selectedId'); if (value === 'default' || value === 'az' || value === 'za') prefs.sort = value; });
   actions.collectionFilter = change(arg => { const values = object(arg).selectedIds; prefs.filter = Array.isArray(values) && typeof values[0] === 'string' ? values[0] : 'all'; });
   actions.collectionSearch = change(arg => { prefs.query = str(arg, 'value').slice(0, 256); });
+  actions.collectionCriteria = change(arg => setCriteria(arg));
   actions.collectionViewName = change(arg => { viewName = str(arg, 'value').slice(0, 40); viewMessage = ''; });
   actions.collectionRememberView = change(() => {
     const name = viewName.trim();
@@ -305,7 +320,8 @@ export function decorateCollection(name: string, def: { state: State; actions?:
     actions.collectionDataChanged = s => derive(backend.apply(s, backend.controller.getState()));
     actions.load = (_s, arg) => {
       stashCopy(arg); syncSaved(); applyNavigationCriteria(arg, _s);
-      backend.onLoad?.(arg);
+      const reset = backend.onLoad?.(arg);
+      if (reset) { setCriteria(reset); persisted.write(prefs); }
       // A load of what the screen already shows is the screen coming back: it revalidates behind its rows.
       return backend.controller.query(criteria(), backend.restorePagesOnLoad, true).then(() => undefined);
     };
@@ -334,11 +350,13 @@ export function defineBackendCollection<S extends object, Row extends object>(na
   register?: typeof register;
   /** Explicit mutation preflight; unrelated collection services keep their current reducers. */
   onlineWrites?: boolean;
+  /** Where the offline refusal is written (default `actionMessage`) — the field the screen shows next to the action. */
+  onlineWriteMessageFields?: readonly string[];
   /** Revalidate already opened pages on navigation return; explicit refresh resets. */
   restorePagesOnLoad?: boolean;
   /** The load action's argument (onAppear params beyond `copy`), before the query runs — for a
    *  domain setting that rides the descriptor, e.g. My Bookings' `weeklyGoal`. */
-  onLoad?(arg: unknown): void;
+  onLoad?(arg: unknown): CollectionCriteriaReset | void;
   state: S;
   source: CollectionQuerySource<Row>;
   apply(state: S, page: CollectionQueryState<Row>): S;
@@ -353,7 +371,7 @@ export function defineBackendCollection<S extends object, Row extends object>(na
     controller: controller as unknown as BackendCollection['controller'],
     apply: (state, page) => options.apply(state as S, page as unknown as CollectionQueryState<Row>) as State,
   });
-  const registerService = options.onlineWrites ? withOnlineWrites(options.register ?? register, ['confirmCancel', 'confirmOperation', 'retryOperation', 'commitWrite'], { messageFields: ['actionMessage'] }) : (options.register ?? register);
+  const registerService = options.onlineWrites ? withOnlineWrites(options.register ?? register, ['confirmCancel', 'confirmOperation', 'retryOperation', 'commitWrite'], { messageFields: options.onlineWriteMessageFields ?? ['actionMessage'] }) : (options.register ?? register);
   const handle = registerService(name, definition);
   // Registration restored the state a cold boot saved: the page it showed is this run's, before the first load. Only
   // when the service's own rows came back with it: a bundle that keeps them out of the restore (its `notHydrated`)

package/templates/community-club-owner/tier5-src/_shared/engine-intl.ts

@@ -108,6 +108,24 @@ export function formatMonthDayLong(date: Date, locale = "en-US", timeZone?: stri
   return `${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
 }
 
+const WEEKDAYS_LONG = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"] as const;
+
+/** `{ weekday: "short", month: "short", day: "numeric" }` — "Mon, Jan 5". */
+export function formatWeekdayMonthDay(date: Date, locale = "en-US", timeZone?: string): string {
+  if (hasIntl()) {
+    return dateFormat(locale, { weekday: "short", month: "short", day: "numeric" }, timeZone).format(date);
+  }
+  return `${WEEKDAYS_SHORT[date.getDay()]}, ${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}`;
+}
+
+/** `{ weekday: "long", month: "long", day: "numeric" }` — "Monday, January 5". */
+export function formatWeekdayMonthDayLong(date: Date, locale = "en-US", timeZone?: string): string {
+  if (hasIntl()) {
+    return dateFormat(locale, { weekday: "long", month: "long", day: "numeric" }, timeZone).format(date);
+  }
+  return `${WEEKDAYS_LONG[date.getDay()]}, ${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
+}
+
 /** `{ weekday: "short", month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }`
  *  — "Mon, Jan 5, 3:07 PM". */
 export function formatWeekdayDateTime(date: Date, locale = "en-US", timeZone?: string): string {

package/templates/events-meetups/tier5-src/_shared/collection-service.ts

@@ -12,11 +12,15 @@ export interface CollectionSaving {
 type State = Record<string, unknown>;
 interface BackendCollection {
   restorePagesOnLoad?: boolean;
-  /** Sees the load action's argument (the screen's onAppear params) BEFORE the query runs. */
-  onLoad?(arg: unknown): void;
+  /** Sees the load action's argument (the screen's onAppear params) BEFORE the query runs. A returned
+   *  `{ filter, sort }` resets the criteria for that load (a screen that always opens on one view). */
+  onLoad?(arg: unknown): CollectionCriteriaReset | void;
   controller: ReturnType<typeof createCollectionQuery<CollectionRow>>;
   apply(state: State, page: CollectionQueryState<CollectionRow>): State;
 }
+/** A filter and a sort set together (`collectionCriteria`, `onLoad`). Values the collection's contract does
+ *  not list are ignored. */
+export interface CollectionCriteriaReset { filter?: string; sort?: string; query?: string }
 type Reducer = (s: State, ...args: unknown[]) => State | undefined | Promise<State | undefined>;
 const object = (x: unknown): State => x && typeof x === 'object' && !Array.isArray(x) ? x as State : {};
 const str = (arg: unknown, key: string): string => typeof arg === 'string' ? arg : String(object(arg)[key] ?? '');
@@ -262,6 +266,16 @@ export function decorateCollection(name: string, def: { state: State; actions?:
     if (backend && config.backendQuery && criteriaBefore !== criteriaKey()) return backend.controller.query(criteria()).then(() => undefined);
     return derive(s);
   };
+  /** Filter and sort in ONE criteria change, so a tab that sets both runs one query, not two. */
+  const setCriteria = (arg: unknown): void => {
+    const input = object(arg);
+    const sort = String(input.sort ?? '');
+    if (sort === 'default' || sort === 'az' || sort === 'za') prefs.sort = sort;
+    const filter = String(input.filter ?? '');
+    if (filter === 'all' || (filter.startsWith('value:') && (config.filterValues ?? []).includes(filter.slice(6)))) prefs.filter = filter;
+    // A screen with no search field clears a query an older screen persisted, or it narrows every view for good.
+    if (typeof input.query === 'string') prefs.query = input.query.slice(0, 256);
+  };
   const criteria = () => ({ query: prefs.query, sort: prefs.sort, filter: prefs.filter, savedIds: prefs.filter === 'saved' ? prefs.savedIds : [] });
   const criteriaKey = () => JSON.stringify(criteria());
   actions.collectionDismissFilters = change(() => { filtersPresented = false; });
@@ -273,6 +287,7 @@ export function decorateCollection(name: string, def: { state: State; actions?:
   actions.collectionSort = change(arg => { const value = str(arg, 'selectedId'); if (value === 'default' || value === 'az' || value === 'za') prefs.sort = value; });
   actions.collectionFilter = change(arg => { const values = object(arg).selectedIds; prefs.filter = Array.isArray(values) && typeof values[0] === 'string' ? values[0] : 'all'; });
   actions.collectionSearch = change(arg => { prefs.query = str(arg, 'value').slice(0, 256); });
+  actions.collectionCriteria = change(arg => setCriteria(arg));
   actions.collectionViewName = change(arg => { viewName = str(arg, 'value').slice(0, 40); viewMessage = ''; });
   actions.collectionRememberView = change(() => {
     const name = viewName.trim();
@@ -305,7 +320,8 @@ export function decorateCollection(name: string, def: { state: State; actions?:
     actions.collectionDataChanged = s => derive(backend.apply(s, backend.controller.getState()));
     actions.load = (_s, arg) => {
       stashCopy(arg); syncSaved(); applyNavigationCriteria(arg, _s);
-      backend.onLoad?.(arg);
+      const reset = backend.onLoad?.(arg);
+      if (reset) { setCriteria(reset); persisted.write(prefs); }
       // A load of what the screen already shows is the screen coming back: it revalidates behind its rows.
       return backend.controller.query(criteria(), backend.restorePagesOnLoad, true).then(() => undefined);
     };
@@ -334,11 +350,13 @@ export function defineBackendCollection<S extends object, Row extends object>(na
   register?: typeof register;
   /** Explicit mutation preflight; unrelated collection services keep their current reducers. */
   onlineWrites?: boolean;
+  /** Where the offline refusal is written (default `actionMessage`) — the field the screen shows next to the action. */
+  onlineWriteMessageFields?: readonly string[];
   /** Revalidate already opened pages on navigation return; explicit refresh resets. */
   restorePagesOnLoad?: boolean;
   /** The load action's argument (onAppear params beyond `copy`), before the query runs — for a
    *  domain setting that rides the descriptor, e.g. My Bookings' `weeklyGoal`. */
-  onLoad?(arg: unknown): void;
+  onLoad?(arg: unknown): CollectionCriteriaReset | void;
   state: S;
   source: CollectionQuerySource<Row>;
   apply(state: S, page: CollectionQueryState<Row>): S;
@@ -353,7 +371,7 @@ export function defineBackendCollection<S extends object, Row extends object>(na
     controller: controller as unknown as BackendCollection['controller'],
     apply: (state, page) => options.apply(state as S, page as unknown as CollectionQueryState<Row>) as State,
   });
-  const registerService = options.onlineWrites ? withOnlineWrites(options.register ?? register, ['confirmCancel', 'confirmOperation', 'retryOperation', 'commitWrite'], { messageFields: ['actionMessage'] }) : (options.register ?? register);
+  const registerService = options.onlineWrites ? withOnlineWrites(options.register ?? register, ['confirmCancel', 'confirmOperation', 'retryOperation', 'commitWrite'], { messageFields: options.onlineWriteMessageFields ?? ['actionMessage'] }) : (options.register ?? register);
   const handle = registerService(name, definition);
   // Registration restored the state a cold boot saved: the page it showed is this run's, before the first load. Only
   // when the service's own rows came back with it: a bundle that keeps them out of the restore (its `notHydrated`)

package/templates/events-meetups/tier5-src/_shared/engine-intl.ts

@@ -108,6 +108,24 @@ export function formatMonthDayLong(date: Date, locale = "en-US", timeZone?: stri
   return `${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
 }
 
+const WEEKDAYS_LONG = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"] as const;
+
+/** `{ weekday: "short", month: "short", day: "numeric" }` — "Mon, Jan 5". */
+export function formatWeekdayMonthDay(date: Date, locale = "en-US", timeZone?: string): string {
+  if (hasIntl()) {
+    return dateFormat(locale, { weekday: "short", month: "short", day: "numeric" }, timeZone).format(date);
+  }
+  return `${WEEKDAYS_SHORT[date.getDay()]}, ${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}`;
+}
+
+/** `{ weekday: "long", month: "long", day: "numeric" }` — "Monday, January 5". */
+export function formatWeekdayMonthDayLong(date: Date, locale = "en-US", timeZone?: string): string {
+  if (hasIntl()) {
+    return dateFormat(locale, { weekday: "long", month: "long", day: "numeric" }, timeZone).format(date);
+  }
+  return `${WEEKDAYS_LONG[date.getDay()]}, ${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
+}
+
 /** `{ weekday: "short", month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }`
  *  — "Mon, Jan 5, 3:07 PM". */
 export function formatWeekdayDateTime(date: Date, locale = "en-US", timeZone?: string): string {

package/templates/events-meetups/tier5-src/_shared/member-bookings.ts

@@ -6,27 +6,69 @@ import { copyParam } from "./himi-copy.js";
 import { formatWeekdayDateTime } from "./engine-intl.js";
 import { dayKey } from "@himalaya/time";
 
+/** The statuses that put a booking in the Canceled tab. Upcoming and Past exclude them, so each
+ *  booking is in exactly one tab. */
+export const CANCELLED_STATUSES = ["CANCELED", "CANCELLED", "DECLINED"];
+
 export interface MemberBookingRow {
   id: string; title: string; subtitle: string; status: string; revision: string;
   start: string; end: string; day: string; serviceId: string;
   canCancel: boolean; cannotCancel: boolean; cannotRebook: boolean;
+  // Added for the My Bookings redesign. Each is "" / 0 / false when the record has nothing for it.
+  /** The staff member (the slot's resource), "" when the booking names none. */
+  staff: string;
+  /** The location's name, else its address. */
+  placeName: string;
+  /** The location's formatted address. */
+  placeAddress: string;
+  /** `BUSINESS`, `CUSTOM` or `CUSTOMER` (the client's place), upper case. */
+  placeType: string;
+  participants: number;
+  /** Wix's raw payment status, upper case (`PAID`, `NOT_PAID`, …). */
+  paymentStatus: string;
+  /** Wix's raw booking status, upper case (`CONFIRMED`, `WAITING_LIST`, …). */
+  statusKey: string;
+  /** A course booking: it books a schedule, not a slot. */
+  isCourse: boolean;
+  courseStart: string;
+  courseEnd: string;
 }
 export function bookingStart(booking: WixBooking): string {
   // Top-level instants are UTC. Slot dates may be LOCAL to slot.timezone.
   const value = booking.startDate || booking.bookedEntity?.slot?.startDate || "";
   return /(?:Z|[+-]\d{2}:?\d{2})$/i.test(value) && Number.isFinite(Date.parse(value)) ? value : "";
 }
+const instant = (value: unknown): string =>
+  typeof value === "string" && /(?:Z|[+-]\d{2}:?\d{2})$/i.test(value) && Number.isFinite(Date.parse(value)) ? value : "";
+const word = (value: unknown): string => typeof value === "string" ? value.trim() : "";
 export function memberBookingRow(booking: WixBooking): MemberBookingRow {
   const start = bookingStart(booking);
   const entity = booking.bookedEntity;
+  const slot = entity?.slot, schedule = entity?.schedule;
   const status = (booking.status || "").toUpperCase();
   const revision = String((booking as WixBooking & { revision?: string | number }).revision ?? "");
-  const serviceId = entity?.slot?.serviceId || "";
-  const canCancel = !!booking.id && !!revision && Date.parse(start) > Date.now() && !["CANCELED", "CANCELLED", "DECLINED"].includes(status);
+  // A course booking carries a schedule, not a slot: its service id is on the schedule.
+  const serviceId = slot?.serviceId || schedule?.serviceId || "";
+  const canCancel = !!booking.id && !!revision && Date.parse(start) > Date.now() && !CANCELLED_STATUSES.includes(status);
+  const location = slot?.location ?? schedule?.location;
+  const placeAddress = word(location?.formattedAddress);
+  const participants = Number(booking.totalParticipants);
   return { id: booking.id, title: entity?.title || copyParam("bookings.booking", "Booking"),
     subtitle: start ? formatWeekdayDateTime(new Date(start)) : copyParam("bookings.timeUnavailable", "Time unavailable"),
-    status: status.replace(/_/g, " "), revision, start, end: booking.endDate || "", day: start ? dayKey(new Date(start)) : "",
-    serviceId, canCancel, cannotCancel: !canCancel, cannotRebook: !serviceId };
+    status: status.replace(/_/g, " "), revision, start,
+    // Wix may carry the end only on the slot (same instant rule as the start).
+    end: booking.endDate || instant(slot?.endDate), day: start ? dayKey(new Date(start)) : "",
+    serviceId, canCancel, cannotCancel: !canCancel, cannotRebook: !serviceId,
+    staff: word(slot?.resource?.name),
+    placeName: word(location?.name) || placeAddress,
+    placeAddress,
+    placeType: word(location?.locationType).toUpperCase(),
+    participants: Number.isFinite(participants) && participants > 0 ? Math.floor(participants) : 0,
+    paymentStatus: word(booking.paymentStatus).toUpperCase(),
+    statusKey: status,
+    isCourse: !slot && !!schedule,
+    courseStart: instant(schedule?.firstSessionStart),
+    courseEnd: instant(schedule?.lastSessionEnd) };
 }
 export async function fetchMemberBookings(criteria: CollectionQuery, cursor: string, now: string, expected?: MemberAccess) {
   const member = expected ?? await memberAccess();
@@ -37,9 +79,10 @@ export async function fetchMemberBookings(criteria: CollectionQuery, cursor: str
   const filter: Record<string, unknown> = { "contactDetails.email": { $eq: member.email } };
   if (criteria.query) filter.id = { $eq: criteria.query };
   if (criteria.filter === "saved") filter.id = criteria.query ? { $in: criteria.savedIds.filter(id => id === criteria.query) } : { $in: criteria.savedIds };
-  if (criteria.filter === "value:Upcoming") { filter.startDate = { $gte: now }; filter.status = { $nin: ["CANCELED", "CANCELLED", "DECLINED"] }; }
-  if (criteria.filter === "value:Past") filter.startDate = { $lt: now };
-  if (criteria.filter === "value:Cancelled") filter.status = { $in: ["CANCELED", "CANCELLED"] };
+  if (criteria.filter === "value:Upcoming") { filter.startDate = { $gte: now }; filter.status = { $nin: CANCELLED_STATUSES }; }
+  // Past is what took place: a canceled or declined booking is in the Canceled tab only.
+  if (criteria.filter === "value:Past") { filter.startDate = { $lt: now }; filter.status = { $nin: CANCELLED_STATUSES }; }
+  if (criteria.filter === "value:Cancelled") filter.status = { $in: CANCELLED_STATUSES };
   const response = await queryBookings({ query: { filter, paging: { limit: 50, offset: Number(cursor || 0) },
     sort: [{ fieldName: "startDate", order: criteria.sort === "za" ? "DESC" : "ASC" }, { fieldName: "id", order: "ASC" }] } });
   await assertMemberAccess(member);

package/templates/events-meetups-owner/tier5-src/_shared/collection-service.ts

@@ -12,11 +12,15 @@ export interface CollectionSaving {
 type State = Record<string, unknown>;
 interface BackendCollection {
   restorePagesOnLoad?: boolean;
-  /** Sees the load action's argument (the screen's onAppear params) BEFORE the query runs. */
-  onLoad?(arg: unknown): void;
+  /** Sees the load action's argument (the screen's onAppear params) BEFORE the query runs. A returned
+   *  `{ filter, sort }` resets the criteria for that load (a screen that always opens on one view). */
+  onLoad?(arg: unknown): CollectionCriteriaReset | void;
   controller: ReturnType<typeof createCollectionQuery<CollectionRow>>;
   apply(state: State, page: CollectionQueryState<CollectionRow>): State;
 }
+/** A filter and a sort set together (`collectionCriteria`, `onLoad`). Values the collection's contract does
+ *  not list are ignored. */
+export interface CollectionCriteriaReset { filter?: string; sort?: string; query?: string }
 type Reducer = (s: State, ...args: unknown[]) => State | undefined | Promise<State | undefined>;
 const object = (x: unknown): State => x && typeof x === 'object' && !Array.isArray(x) ? x as State : {};
 const str = (arg: unknown, key: string): string => typeof arg === 'string' ? arg : String(object(arg)[key] ?? '');
@@ -262,6 +266,16 @@ export function decorateCollection(name: string, def: { state: State; actions?:
     if (backend && config.backendQuery && criteriaBefore !== criteriaKey()) return backend.controller.query(criteria()).then(() => undefined);
     return derive(s);
   };
+  /** Filter and sort in ONE criteria change, so a tab that sets both runs one query, not two. */
+  const setCriteria = (arg: unknown): void => {
+    const input = object(arg);
+    const sort = String(input.sort ?? '');
+    if (sort === 'default' || sort === 'az' || sort === 'za') prefs.sort = sort;
+    const filter = String(input.filter ?? '');
+    if (filter === 'all' || (filter.startsWith('value:') && (config.filterValues ?? []).includes(filter.slice(6)))) prefs.filter = filter;
+    // A screen with no search field clears a query an older screen persisted, or it narrows every view for good.
+    if (typeof input.query === 'string') prefs.query = input.query.slice(0, 256);
+  };
   const criteria = () => ({ query: prefs.query, sort: prefs.sort, filter: prefs.filter, savedIds: prefs.filter === 'saved' ? prefs.savedIds : [] });
   const criteriaKey = () => JSON.stringify(criteria());
   actions.collectionDismissFilters = change(() => { filtersPresented = false; });
@@ -273,6 +287,7 @@ export function decorateCollection(name: string, def: { state: State; actions?:
   actions.collectionSort = change(arg => { const value = str(arg, 'selectedId'); if (value === 'default' || value === 'az' || value === 'za') prefs.sort = value; });
   actions.collectionFilter = change(arg => { const values = object(arg).selectedIds; prefs.filter = Array.isArray(values) && typeof values[0] === 'string' ? values[0] : 'all'; });
   actions.collectionSearch = change(arg => { prefs.query = str(arg, 'value').slice(0, 256); });
+  actions.collectionCriteria = change(arg => setCriteria(arg));
   actions.collectionViewName = change(arg => { viewName = str(arg, 'value').slice(0, 40); viewMessage = ''; });
   actions.collectionRememberView = change(() => {
     const name = viewName.trim();
@@ -305,7 +320,8 @@ export function decorateCollection(name: string, def: { state: State; actions?:
     actions.collectionDataChanged = s => derive(backend.apply(s, backend.controller.getState()));
     actions.load = (_s, arg) => {
       stashCopy(arg); syncSaved(); applyNavigationCriteria(arg, _s);
-      backend.onLoad?.(arg);
+      const reset = backend.onLoad?.(arg);
+      if (reset) { setCriteria(reset); persisted.write(prefs); }
       // A load of what the screen already shows is the screen coming back: it revalidates behind its rows.
       return backend.controller.query(criteria(), backend.restorePagesOnLoad, true).then(() => undefined);
     };
@@ -334,11 +350,13 @@ export function defineBackendCollection<S extends object, Row extends object>(na
   register?: typeof register;
   /** Explicit mutation preflight; unrelated collection services keep their current reducers. */
   onlineWrites?: boolean;
+  /** Where the offline refusal is written (default `actionMessage`) — the field the screen shows next to the action. */
+  onlineWriteMessageFields?: readonly string[];
   /** Revalidate already opened pages on navigation return; explicit refresh resets. */
   restorePagesOnLoad?: boolean;
   /** The load action's argument (onAppear params beyond `copy`), before the query runs — for a
    *  domain setting that rides the descriptor, e.g. My Bookings' `weeklyGoal`. */
-  onLoad?(arg: unknown): void;
+  onLoad?(arg: unknown): CollectionCriteriaReset | void;
   state: S;
   source: CollectionQuerySource<Row>;
   apply(state: S, page: CollectionQueryState<Row>): S;
@@ -353,7 +371,7 @@ export function defineBackendCollection<S extends object, Row extends object>(na
     controller: controller as unknown as BackendCollection['controller'],
     apply: (state, page) => options.apply(state as S, page as unknown as CollectionQueryState<Row>) as State,
   });
-  const registerService = options.onlineWrites ? withOnlineWrites(options.register ?? register, ['confirmCancel', 'confirmOperation', 'retryOperation', 'commitWrite'], { messageFields: ['actionMessage'] }) : (options.register ?? register);
+  const registerService = options.onlineWrites ? withOnlineWrites(options.register ?? register, ['confirmCancel', 'confirmOperation', 'retryOperation', 'commitWrite'], { messageFields: options.onlineWriteMessageFields ?? ['actionMessage'] }) : (options.register ?? register);
   const handle = registerService(name, definition);
   // Registration restored the state a cold boot saved: the page it showed is this run's, before the first load. Only
   // when the service's own rows came back with it: a bundle that keeps them out of the restore (its `notHydrated`)

package/templates/events-meetups-owner/tier5-src/_shared/engine-intl.ts

@@ -108,6 +108,24 @@ export function formatMonthDayLong(date: Date, locale = "en-US", timeZone?: stri
   return `${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
 }
 
+const WEEKDAYS_LONG = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"] as const;
+
+/** `{ weekday: "short", month: "short", day: "numeric" }` — "Mon, Jan 5". */
+export function formatWeekdayMonthDay(date: Date, locale = "en-US", timeZone?: string): string {
+  if (hasIntl()) {
+    return dateFormat(locale, { weekday: "short", month: "short", day: "numeric" }, timeZone).format(date);
+  }
+  return `${WEEKDAYS_SHORT[date.getDay()]}, ${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}`;
+}
+
+/** `{ weekday: "long", month: "long", day: "numeric" }` — "Monday, January 5". */
+export function formatWeekdayMonthDayLong(date: Date, locale = "en-US", timeZone?: string): string {
+  if (hasIntl()) {
+    return dateFormat(locale, { weekday: "long", month: "long", day: "numeric" }, timeZone).format(date);
+  }
+  return `${WEEKDAYS_LONG[date.getDay()]}, ${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
+}
+
 /** `{ weekday: "short", month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }`
  *  — "Mon, Jan 5, 3:07 PM". */
 export function formatWeekdayDateTime(date: Date, locale = "en-US", timeZone?: string): string {