@wix/himalaya-cli 0.1556.0 → 0.1558.0

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

@@ -1,6 +1,6 @@
 import { defineService } from "../_shared/collection-service.js";
 import { queryGroups, type WixGroup } from "@himalaya/wix-groups";
-import { wixMediaUrl } from "@himalaya/wix-media";
+import { groupImage } from "../_shared/himi-media.js";
 import { copyParam, stashCopy } from "../_shared/himi-copy.js";
 import { getAll, upsert, type DbEntity } from "@himalaya/local-db";
 
@@ -45,23 +45,10 @@ interface State {
   noEmpty: boolean;
 }
 
-/** Social Groups stores a cover as `coverImage.image.mediaId` and returns NO url —
- *  the documented Image type has mediaId/width/height/preset only. Probing just
- *  `.url` therefore left every real cover unrendered (accent band + initials).
- *  Keep the url probes for other shapes, then derive from the media id. */
-function coverImage(group: WixGroup): string {
-  const cover = group.coverImage as
-    | { url?: string; image?: { url?: string; mediaId?: string; id?: string } }
-    | undefined;
-  return wixMediaUrl(
-    cover?.image?.url ?? cover?.url ?? cover?.image?.mediaId ?? cover?.image?.id,
-  );
-}
-
 function groupRow(group: WixGroup): GroupRow {
   const title = (group.name || copyParam("groups.groupFallbackName", "Group")).trim();
   const count = group.membersCount ?? group.memberCount;
-  const image = coverImage(group);
+  const image = groupImage(group);
   return {
     id: group.id || title,
     title,

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

@@ -24,6 +24,7 @@ import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-save
 import { loadStoreCategories, type StoreCategoryCard } from "../_shared/himi-store-categories.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { groupImage, programImage } from "../_shared/himi-media.js";
 import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
 import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
@@ -676,8 +677,7 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
         const nestedTitle = desc && typeof desc === "object" ? (desc as { title?: string }).title : undefined;
         const nestedDetails = desc && typeof desc === "object" ? (desc as { details?: string }).details : undefined;
         const name = cleanTitle(p.settings?.title ?? nestedTitle ?? p.title) || copyParam("home.programFallbackName", "Program");
-        const cover = (p as { coverImage?: unknown }).coverImage;
-        const image = (typeof cover === "string" ? cover : (cover as { url?: string } | undefined)?.url) || p.image || "";
+        const image = programImage(p);
         const details = (p.settings?.description ?? nestedDetails ?? (typeof desc === "string" ? desc : "") ?? "")
           .replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
         return {
@@ -732,8 +732,7 @@ function homeTimeLabel(value?: string): string {
 function groupCard(group: WixGroup): GroupCard {
   const title = (group.name || copyParam("home.groupFallbackTitle", "Group")).trim();
   const count = group.membersCount ?? group.memberCount;
-  const cover = group.coverImage as { url?: string; image?: { url?: string } } | undefined;
-  const image = cover?.image?.url ?? cover?.url ?? "";
+  const image = groupImage(group);
   return {
     id: group.id || title,
     title,

package/templates/gym-fitness/tier5-src/_shared/himi-media.ts

@@ -0,0 +1,29 @@
+// Cover selection is shared by list, detail and home so the same Wix object never
+// loses its image on navigation. Relative SDK imports are rewritten by the template generator.
+import { wixMediaUrl, WIX_LIST_IMAGE, type WixImageSize } from "@himalaya/wix-media";
+import type { WixGroup } from "@himalaya/wix-groups";
+import type { WixProgram } from "@himalaya/wix-online-programs";
+
+function firstImage(references: unknown[], size: WixImageSize): string {
+  for (const reference of references) {
+    const image = wixMediaUrl(reference, size);
+    if (image) return image;
+  }
+  return "";
+}
+
+export function groupImage(group: WixGroup, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = group.coverImage as {
+    url?: unknown;
+    image?: { url?: unknown; fileUrl?: unknown; mediaId?: unknown; id?: unknown };
+  } | undefined;
+  return firstImage([cover?.image?.url, cover?.image?.fileUrl, cover?.url, cover?.image?.mediaId, cover?.image?.id], size);
+}
+
+export function programImage(program: WixProgram, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = (program as { coverImage?: unknown }).coverImage;
+  const coverUrl = typeof cover === "string" ? cover : (cover as { url?: unknown } | undefined)?.url;
+  const description = (program as { description?: unknown }).description;
+  const nested = description && typeof description === "object" ? (description as { image?: { url?: unknown; id?: unknown } }).image : undefined;
+  return firstImage([coverUrl, program.image, nested?.url, nested?.id], size);
+}

package/templates/gym-fitness/tier5-src/himi-branded-lite-home/index.ts

@@ -24,6 +24,7 @@ import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-save
 import { loadStoreCategories, type StoreCategoryCard } from "../_shared/himi-store-categories.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { groupImage, programImage } from "../_shared/himi-media.js";
 import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
 import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
@@ -676,8 +677,7 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
         const nestedTitle = desc && typeof desc === "object" ? (desc as { title?: string }).title : undefined;
         const nestedDetails = desc && typeof desc === "object" ? (desc as { details?: string }).details : undefined;
         const name = cleanTitle(p.settings?.title ?? nestedTitle ?? p.title) || copyParam("home.programFallbackName", "Program");
-        const cover = (p as { coverImage?: unknown }).coverImage;
-        const image = (typeof cover === "string" ? cover : (cover as { url?: string } | undefined)?.url) || p.image || "";
+        const image = programImage(p);
         const details = (p.settings?.description ?? nestedDetails ?? (typeof desc === "string" ? desc : "") ?? "")
           .replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
         return {
@@ -732,8 +732,7 @@ function homeTimeLabel(value?: string): string {
 function groupCard(group: WixGroup): GroupCard {
   const title = (group.name || copyParam("home.groupFallbackTitle", "Group")).trim();
   const count = group.membersCount ?? group.memberCount;
-  const cover = group.coverImage as { url?: string; image?: { url?: string } } | undefined;
-  const image = cover?.image?.url ?? cover?.url ?? "";
+  const image = groupImage(group);
   return {
     id: group.id || title,
     title,

package/templates/nonprofit-cause/tier5-src/_shared/himi-media.ts

@@ -0,0 +1,29 @@
+// Cover selection is shared by list, detail and home so the same Wix object never
+// loses its image on navigation. Relative SDK imports are rewritten by the template generator.
+import { wixMediaUrl, WIX_LIST_IMAGE, type WixImageSize } from "@himalaya/wix-media";
+import type { WixGroup } from "@himalaya/wix-groups";
+import type { WixProgram } from "@himalaya/wix-online-programs";
+
+function firstImage(references: unknown[], size: WixImageSize): string {
+  for (const reference of references) {
+    const image = wixMediaUrl(reference, size);
+    if (image) return image;
+  }
+  return "";
+}
+
+export function groupImage(group: WixGroup, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = group.coverImage as {
+    url?: unknown;
+    image?: { url?: unknown; fileUrl?: unknown; mediaId?: unknown; id?: unknown };
+  } | undefined;
+  return firstImage([cover?.image?.url, cover?.image?.fileUrl, cover?.url, cover?.image?.mediaId, cover?.image?.id], size);
+}
+
+export function programImage(program: WixProgram, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = (program as { coverImage?: unknown }).coverImage;
+  const coverUrl = typeof cover === "string" ? cover : (cover as { url?: unknown } | undefined)?.url;
+  const description = (program as { description?: unknown }).description;
+  const nested = description && typeof description === "object" ? (description as { image?: { url?: unknown; id?: unknown } }).image : undefined;
+  return firstImage([coverUrl, program.image, nested?.url, nested?.id], size);
+}

package/templates/nonprofit-cause/tier5-src/himi-branded-lite-group/index.ts

@@ -4,6 +4,8 @@ import { getGroup, joinGroup, leaveGroup, queryMembers as queryGroupMembers, typ
 import { getMember } from "@himalaya/wix-members";
 import { signedInEmail } from "../_shared/himi-account";
 import { initials } from "../_shared/himi-text.js";
+import { groupImage } from "../_shared/himi-media.js";
+import { WIX_DETAIL_IMAGE } from "@himalaya/wix-media";
 import { copyParam, stashCopy } from "../_shared/himi-copy.js";
 import { get as dbGet, upsert as dbUpsert, type DbEntity } from "@himalaya/local-db";
 import { isOfflineFailure, writeMayHaveLanded } from "../_shared/owner-load-error";
@@ -87,11 +89,6 @@ function inputId(): string {
   return input?.screenId?.startsWith("himi_group_") ? input.screenId.slice("himi_group_".length) : "";
 }
 
-function coverImage(group: WixGroup): string {
-  const cover = group.coverImage as { url?: string; image?: { url?: string } } | undefined;
-  return cover?.image?.url ?? cover?.url ?? "";
-}
-
 function membershipState(state: State, joined: boolean, signedIn: boolean): State {
   const isPublic = state.privacy === "Public" || state.privacy === "Unknown";
   return {
@@ -176,7 +173,7 @@ const svc = defineService<State, {
         const response = await getGroup(id);
         const group = ((response as unknown as { group?: WixGroup }).group ?? response) as WixGroup;
         const name = (group.name || copyParam("group.groupFallbackName", "Group")).trim();
-        const image = coverImage(group);
+        const image = groupImage(group, WIX_DETAIL_IMAGE);
         const count = group.membersCount ?? group.memberCount;
         const privacy = (group.privacyStatus || "UNKNOWN").toLowerCase();
         const privacyLabel = privacy[0].toUpperCase() + privacy.slice(1);

package/templates/nonprofit-cause/tier5-src/himi-branded-lite-groups/index.ts

@@ -1,6 +1,6 @@
 import { defineService } from "../_shared/collection-service.js";
 import { queryGroups, type WixGroup } from "@himalaya/wix-groups";
-import { wixMediaUrl } from "@himalaya/wix-media";
+import { groupImage } from "../_shared/himi-media.js";
 import { copyParam, stashCopy } from "../_shared/himi-copy.js";
 import { getAll, upsert, type DbEntity } from "@himalaya/local-db";
 
@@ -45,23 +45,10 @@ interface State {
   noEmpty: boolean;
 }
 
-/** Social Groups stores a cover as `coverImage.image.mediaId` and returns NO url —
- *  the documented Image type has mediaId/width/height/preset only. Probing just
- *  `.url` therefore left every real cover unrendered (accent band + initials).
- *  Keep the url probes for other shapes, then derive from the media id. */
-function coverImage(group: WixGroup): string {
-  const cover = group.coverImage as
-    | { url?: string; image?: { url?: string; mediaId?: string; id?: string } }
-    | undefined;
-  return wixMediaUrl(
-    cover?.image?.url ?? cover?.url ?? cover?.image?.mediaId ?? cover?.image?.id,
-  );
-}
-
 function groupRow(group: WixGroup): GroupRow {
   const title = (group.name || copyParam("groups.groupFallbackName", "Group")).trim();
   const count = group.membersCount ?? group.memberCount;
-  const image = coverImage(group);
+  const image = groupImage(group);
   return {
     id: group.id || title,
     title,

package/templates/nonprofit-cause/tier5-src/himi-branded-lite-home/index.ts

@@ -24,6 +24,7 @@ import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-save
 import { loadStoreCategories, type StoreCategoryCard } from "../_shared/himi-store-categories.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { groupImage, programImage } from "../_shared/himi-media.js";
 import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
 import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
@@ -676,8 +677,7 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
         const nestedTitle = desc && typeof desc === "object" ? (desc as { title?: string }).title : undefined;
         const nestedDetails = desc && typeof desc === "object" ? (desc as { details?: string }).details : undefined;
         const name = cleanTitle(p.settings?.title ?? nestedTitle ?? p.title) || copyParam("home.programFallbackName", "Program");
-        const cover = (p as { coverImage?: unknown }).coverImage;
-        const image = (typeof cover === "string" ? cover : (cover as { url?: string } | undefined)?.url) || p.image || "";
+        const image = programImage(p);
         const details = (p.settings?.description ?? nestedDetails ?? (typeof desc === "string" ? desc : "") ?? "")
           .replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
         return {
@@ -732,8 +732,7 @@ function homeTimeLabel(value?: string): string {
 function groupCard(group: WixGroup): GroupCard {
   const title = (group.name || copyParam("home.groupFallbackTitle", "Group")).trim();
   const count = group.membersCount ?? group.memberCount;
-  const cover = group.coverImage as { url?: string; image?: { url?: string } } | undefined;
-  const image = cover?.image?.url ?? cover?.url ?? "";
+  const image = groupImage(group);
   return {
     id: group.id || title,
     title,

package/templates/podcast-creator/tier5-src/_shared/himi-media.ts

@@ -0,0 +1,29 @@
+// Cover selection is shared by list, detail and home so the same Wix object never
+// loses its image on navigation. Relative SDK imports are rewritten by the template generator.
+import { wixMediaUrl, WIX_LIST_IMAGE, type WixImageSize } from "@himalaya/wix-media";
+import type { WixGroup } from "@himalaya/wix-groups";
+import type { WixProgram } from "@himalaya/wix-online-programs";
+
+function firstImage(references: unknown[], size: WixImageSize): string {
+  for (const reference of references) {
+    const image = wixMediaUrl(reference, size);
+    if (image) return image;
+  }
+  return "";
+}
+
+export function groupImage(group: WixGroup, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = group.coverImage as {
+    url?: unknown;
+    image?: { url?: unknown; fileUrl?: unknown; mediaId?: unknown; id?: unknown };
+  } | undefined;
+  return firstImage([cover?.image?.url, cover?.image?.fileUrl, cover?.url, cover?.image?.mediaId, cover?.image?.id], size);
+}
+
+export function programImage(program: WixProgram, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = (program as { coverImage?: unknown }).coverImage;
+  const coverUrl = typeof cover === "string" ? cover : (cover as { url?: unknown } | undefined)?.url;
+  const description = (program as { description?: unknown }).description;
+  const nested = description && typeof description === "object" ? (description as { image?: { url?: unknown; id?: unknown } }).image : undefined;
+  return firstImage([coverUrl, program.image, nested?.url, nested?.id], size);
+}

package/templates/podcast-creator/tier5-src/himi-branded-lite-home/index.ts

@@ -24,6 +24,7 @@ import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-save
 import { loadStoreCategories, type StoreCategoryCard } from "../_shared/himi-store-categories.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { groupImage, programImage } from "../_shared/himi-media.js";
 import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
 import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
@@ -676,8 +677,7 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
         const nestedTitle = desc && typeof desc === "object" ? (desc as { title?: string }).title : undefined;
         const nestedDetails = desc && typeof desc === "object" ? (desc as { details?: string }).details : undefined;
         const name = cleanTitle(p.settings?.title ?? nestedTitle ?? p.title) || copyParam("home.programFallbackName", "Program");
-        const cover = (p as { coverImage?: unknown }).coverImage;
-        const image = (typeof cover === "string" ? cover : (cover as { url?: string } | undefined)?.url) || p.image || "";
+        const image = programImage(p);
         const details = (p.settings?.description ?? nestedDetails ?? (typeof desc === "string" ? desc : "") ?? "")
           .replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
         return {
@@ -732,8 +732,7 @@ function homeTimeLabel(value?: string): string {
 function groupCard(group: WixGroup): GroupCard {
   const title = (group.name || copyParam("home.groupFallbackTitle", "Group")).trim();
   const count = group.membersCount ?? group.memberCount;
-  const cover = group.coverImage as { url?: string; image?: { url?: string } } | undefined;
-  const image = cover?.image?.url ?? cover?.url ?? "";
+  const image = groupImage(group);
   return {
     id: group.id || title,
     title,

package/templates/portfolio-creative/tier5-src/_shared/himi-media.ts

@@ -0,0 +1,29 @@
+// Cover selection is shared by list, detail and home so the same Wix object never
+// loses its image on navigation. Relative SDK imports are rewritten by the template generator.
+import { wixMediaUrl, WIX_LIST_IMAGE, type WixImageSize } from "@himalaya/wix-media";
+import type { WixGroup } from "@himalaya/wix-groups";
+import type { WixProgram } from "@himalaya/wix-online-programs";
+
+function firstImage(references: unknown[], size: WixImageSize): string {
+  for (const reference of references) {
+    const image = wixMediaUrl(reference, size);
+    if (image) return image;
+  }
+  return "";
+}
+
+export function groupImage(group: WixGroup, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = group.coverImage as {
+    url?: unknown;
+    image?: { url?: unknown; fileUrl?: unknown; mediaId?: unknown; id?: unknown };
+  } | undefined;
+  return firstImage([cover?.image?.url, cover?.image?.fileUrl, cover?.url, cover?.image?.mediaId, cover?.image?.id], size);
+}
+
+export function programImage(program: WixProgram, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = (program as { coverImage?: unknown }).coverImage;
+  const coverUrl = typeof cover === "string" ? cover : (cover as { url?: unknown } | undefined)?.url;
+  const description = (program as { description?: unknown }).description;
+  const nested = description && typeof description === "object" ? (description as { image?: { url?: unknown; id?: unknown } }).image : undefined;
+  return firstImage([coverUrl, program.image, nested?.url, nested?.id], size);
+}

package/templates/portfolio-creative/tier5-src/himi-branded-lite-home/index.ts

@@ -24,6 +24,7 @@ import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-save
 import { loadStoreCategories, type StoreCategoryCard } from "../_shared/himi-store-categories.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { groupImage, programImage } from "../_shared/himi-media.js";
 import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
 import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
@@ -676,8 +677,7 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
         const nestedTitle = desc && typeof desc === "object" ? (desc as { title?: string }).title : undefined;
         const nestedDetails = desc && typeof desc === "object" ? (desc as { details?: string }).details : undefined;
         const name = cleanTitle(p.settings?.title ?? nestedTitle ?? p.title) || copyParam("home.programFallbackName", "Program");
-        const cover = (p as { coverImage?: unknown }).coverImage;
-        const image = (typeof cover === "string" ? cover : (cover as { url?: string } | undefined)?.url) || p.image || "";
+        const image = programImage(p);
         const details = (p.settings?.description ?? nestedDetails ?? (typeof desc === "string" ? desc : "") ?? "")
           .replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
         return {
@@ -732,8 +732,7 @@ function homeTimeLabel(value?: string): string {
 function groupCard(group: WixGroup): GroupCard {
   const title = (group.name || copyParam("home.groupFallbackTitle", "Group")).trim();
   const count = group.membersCount ?? group.memberCount;
-  const cover = group.coverImage as { url?: string; image?: { url?: string } } | undefined;
-  const image = cover?.image?.url ?? cover?.url ?? "";
+  const image = groupImage(group);
   return {
     id: group.id || title,
     title,

package/templates/restaurant/tier5-src/_shared/himi-media.ts

@@ -0,0 +1,29 @@
+// Cover selection is shared by list, detail and home so the same Wix object never
+// loses its image on navigation. Relative SDK imports are rewritten by the template generator.
+import { wixMediaUrl, WIX_LIST_IMAGE, type WixImageSize } from "@himalaya/wix-media";
+import type { WixGroup } from "@himalaya/wix-groups";
+import type { WixProgram } from "@himalaya/wix-online-programs";
+
+function firstImage(references: unknown[], size: WixImageSize): string {
+  for (const reference of references) {
+    const image = wixMediaUrl(reference, size);
+    if (image) return image;
+  }
+  return "";
+}
+
+export function groupImage(group: WixGroup, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = group.coverImage as {
+    url?: unknown;
+    image?: { url?: unknown; fileUrl?: unknown; mediaId?: unknown; id?: unknown };
+  } | undefined;
+  return firstImage([cover?.image?.url, cover?.image?.fileUrl, cover?.url, cover?.image?.mediaId, cover?.image?.id], size);
+}
+
+export function programImage(program: WixProgram, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = (program as { coverImage?: unknown }).coverImage;
+  const coverUrl = typeof cover === "string" ? cover : (cover as { url?: unknown } | undefined)?.url;
+  const description = (program as { description?: unknown }).description;
+  const nested = description && typeof description === "object" ? (description as { image?: { url?: unknown; id?: unknown } }).image : undefined;
+  return firstImage([coverUrl, program.image, nested?.url, nested?.id], size);
+}

package/templates/restaurant/tier5-src/himi-branded-lite-home/index.ts

@@ -24,6 +24,7 @@ import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-save
 import { loadStoreCategories, type StoreCategoryCard } from "../_shared/himi-store-categories.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { groupImage, programImage } from "../_shared/himi-media.js";
 import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
 import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
@@ -676,8 +677,7 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
         const nestedTitle = desc && typeof desc === "object" ? (desc as { title?: string }).title : undefined;
         const nestedDetails = desc && typeof desc === "object" ? (desc as { details?: string }).details : undefined;
         const name = cleanTitle(p.settings?.title ?? nestedTitle ?? p.title) || copyParam("home.programFallbackName", "Program");
-        const cover = (p as { coverImage?: unknown }).coverImage;
-        const image = (typeof cover === "string" ? cover : (cover as { url?: string } | undefined)?.url) || p.image || "";
+        const image = programImage(p);
         const details = (p.settings?.description ?? nestedDetails ?? (typeof desc === "string" ? desc : "") ?? "")
           .replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
         return {
@@ -732,8 +732,7 @@ function homeTimeLabel(value?: string): string {
 function groupCard(group: WixGroup): GroupCard {
   const title = (group.name || copyParam("home.groupFallbackTitle", "Group")).trim();
   const count = group.membersCount ?? group.memberCount;
-  const cover = group.coverImage as { url?: string; image?: { url?: string } } | undefined;
-  const image = cover?.image?.url ?? cover?.url ?? "";
+  const image = groupImage(group);
   return {
     id: group.id || title,
     title,

package/templates/retail-store/tier5-src/_shared/himi-media.ts

@@ -0,0 +1,29 @@
+// Cover selection is shared by list, detail and home so the same Wix object never
+// loses its image on navigation. Relative SDK imports are rewritten by the template generator.
+import { wixMediaUrl, WIX_LIST_IMAGE, type WixImageSize } from "@himalaya/wix-media";
+import type { WixGroup } from "@himalaya/wix-groups";
+import type { WixProgram } from "@himalaya/wix-online-programs";
+
+function firstImage(references: unknown[], size: WixImageSize): string {
+  for (const reference of references) {
+    const image = wixMediaUrl(reference, size);
+    if (image) return image;
+  }
+  return "";
+}
+
+export function groupImage(group: WixGroup, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = group.coverImage as {
+    url?: unknown;
+    image?: { url?: unknown; fileUrl?: unknown; mediaId?: unknown; id?: unknown };
+  } | undefined;
+  return firstImage([cover?.image?.url, cover?.image?.fileUrl, cover?.url, cover?.image?.mediaId, cover?.image?.id], size);
+}
+
+export function programImage(program: WixProgram, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = (program as { coverImage?: unknown }).coverImage;
+  const coverUrl = typeof cover === "string" ? cover : (cover as { url?: unknown } | undefined)?.url;
+  const description = (program as { description?: unknown }).description;
+  const nested = description && typeof description === "object" ? (description as { image?: { url?: unknown; id?: unknown } }).image : undefined;
+  return firstImage([coverUrl, program.image, nested?.url, nested?.id], size);
+}

package/templates/retail-store/tier5-src/himi-branded-lite-home/index.ts

@@ -24,6 +24,7 @@ import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-save
 import { loadStoreCategories, type StoreCategoryCard } from "../_shared/himi-store-categories.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { groupImage, programImage } from "../_shared/himi-media.js";
 import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
 import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
@@ -676,8 +677,7 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
         const nestedTitle = desc && typeof desc === "object" ? (desc as { title?: string }).title : undefined;
         const nestedDetails = desc && typeof desc === "object" ? (desc as { details?: string }).details : undefined;
         const name = cleanTitle(p.settings?.title ?? nestedTitle ?? p.title) || copyParam("home.programFallbackName", "Program");
-        const cover = (p as { coverImage?: unknown }).coverImage;
-        const image = (typeof cover === "string" ? cover : (cover as { url?: string } | undefined)?.url) || p.image || "";
+        const image = programImage(p);
         const details = (p.settings?.description ?? nestedDetails ?? (typeof desc === "string" ? desc : "") ?? "")
           .replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
         return {
@@ -732,8 +732,7 @@ function homeTimeLabel(value?: string): string {
 function groupCard(group: WixGroup): GroupCard {
   const title = (group.name || copyParam("home.groupFallbackTitle", "Group")).trim();
   const count = group.membersCount ?? group.memberCount;
-  const cover = group.coverImage as { url?: string; image?: { url?: string } } | undefined;
-  const image = cover?.image?.url ?? cover?.url ?? "";
+  const image = groupImage(group);
   return {
     id: group.id || title,
     title,

package/templates/yoga-studio/tier5-src/_shared/himi-media.ts

@@ -0,0 +1,29 @@
+// Cover selection is shared by list, detail and home so the same Wix object never
+// loses its image on navigation. Relative SDK imports are rewritten by the template generator.
+import { wixMediaUrl, WIX_LIST_IMAGE, type WixImageSize } from "@himalaya/wix-media";
+import type { WixGroup } from "@himalaya/wix-groups";
+import type { WixProgram } from "@himalaya/wix-online-programs";
+
+function firstImage(references: unknown[], size: WixImageSize): string {
+  for (const reference of references) {
+    const image = wixMediaUrl(reference, size);
+    if (image) return image;
+  }
+  return "";
+}
+
+export function groupImage(group: WixGroup, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = group.coverImage as {
+    url?: unknown;
+    image?: { url?: unknown; fileUrl?: unknown; mediaId?: unknown; id?: unknown };
+  } | undefined;
+  return firstImage([cover?.image?.url, cover?.image?.fileUrl, cover?.url, cover?.image?.mediaId, cover?.image?.id], size);
+}
+
+export function programImage(program: WixProgram, size: WixImageSize = WIX_LIST_IMAGE): string {
+  const cover = (program as { coverImage?: unknown }).coverImage;
+  const coverUrl = typeof cover === "string" ? cover : (cover as { url?: unknown } | undefined)?.url;
+  const description = (program as { description?: unknown }).description;
+  const nested = description && typeof description === "object" ? (description as { image?: { url?: unknown; id?: unknown } }).image : undefined;
+  return firstImage([coverUrl, program.image, nested?.url, nested?.id], size);
+}

package/templates/yoga-studio/tier5-src/himi-branded-lite-home/index.ts

@@ -24,6 +24,7 @@ import { readSavedProducts, type SavedProduct } from "../_shared/himi-store-save
 import { loadStoreCategories, type StoreCategoryCard } from "../_shared/himi-store-categories.js";
 import { readSavedIds } from "../_shared/himi-blog-saved.js";
 import { wixMediaUrl } from "@himalaya/wix-media";
+import { groupImage, programImage } from "../_shared/himi-media.js";
 import { isWixVideoWebRefusal, listLatestVideos, videoCard, type WixVideoCard } from "@himalaya/wix-video";
 import { videoCaptionOf, withCaption, type CaptionFlags } from "../_shared/video-caption.js";
 
@@ -676,8 +677,7 @@ async function fetchHomePrograms(): Promise<ProgramCard[]> {
         const nestedTitle = desc && typeof desc === "object" ? (desc as { title?: string }).title : undefined;
         const nestedDetails = desc && typeof desc === "object" ? (desc as { details?: string }).details : undefined;
         const name = cleanTitle(p.settings?.title ?? nestedTitle ?? p.title) || copyParam("home.programFallbackName", "Program");
-        const cover = (p as { coverImage?: unknown }).coverImage;
-        const image = (typeof cover === "string" ? cover : (cover as { url?: string } | undefined)?.url) || p.image || "";
+        const image = programImage(p);
         const details = (p.settings?.description ?? nestedDetails ?? (typeof desc === "string" ? desc : "") ?? "")
           .replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
         return {
@@ -732,8 +732,7 @@ function homeTimeLabel(value?: string): string {
 function groupCard(group: WixGroup): GroupCard {
   const title = (group.name || copyParam("home.groupFallbackTitle", "Group")).trim();
   const count = group.membersCount ?? group.memberCount;
-  const cover = group.coverImage as { url?: string; image?: { url?: string } } | undefined;
-  const image = cover?.image?.url ?? cover?.url ?? "";
+  const image = groupImage(group);
   return {
     id: group.id || title,
     title,

package/templates/yoga-studio/tier5-src/himi-branded-lite-program/index.ts

@@ -21,6 +21,8 @@ import { withOnlineWrites } from "../_shared/online-actions.js";
 // offers Get access in place of Enrol and sells only through the shared checkout, never through the
 // Wix payment rail.
 import { defineService as registerService } from "@himalaya/state";
+import { programImage } from "../_shared/himi-media.js";
+import { WIX_DETAIL_IMAGE } from "@himalaya/wix-media";
 import {
   getProgram,
   joinProgram,
@@ -122,14 +124,6 @@ function detailsOf(p: WixProgram): string {
     .trim();
 }
 
-function imageOf(p: WixProgram): string {
-  const desc = (p as { description?: unknown }).description;
-  const nested = desc && typeof desc === "object" ? (desc as { image?: { url?: string } }).image?.url : undefined;
-  const cover = (p as { coverImage?: unknown }).coverImage;
-  const coverUrl = typeof cover === "string" ? cover : (cover as { url?: string } | undefined)?.url;
-  return (coverUrl || p.image || nested || "").trim();
-}
-
 function metaOf(p: WixProgram): string {
   const summary = (p as { contentSummary?: { stepCount?: number; sectionCount?: number } }).contentSummary;
   const bits: string[] = [];
@@ -160,7 +154,7 @@ function ready(state: State, p: WixProgram | undefined): State {
     return derive({ ...state, status: "ready", name: "", description: "", meta: "", priceLine: "", image: "", initial: "", emptyText: copyParam("program.emptyText", "This program is no longer available.") });
   }
   const name = titleOf(p);
-  const image = imageOf(p);
+  const image = programImage(p, WIX_DETAIL_IMAGE);
   return derive({
     ...state,
     status: "ready",

package/templates/yoga-studio/tier5-src/himi-branded-lite-programs/index.ts

@@ -14,7 +14,7 @@ import { decorateCollection } from "../_shared/collection-service.js";
 import { queryPrograms, type WixProgram } from "@himalaya/wix-online-programs";
 import { iapPriceFields, onlineProgramItem, type IapPollDirective } from "@himalaya/iap";
 import { createIapCommerce } from "@himalaya/iap-checkout";
-import { wixMediaUrl } from "@himalaya/wix-media";
+import { programImage } from "../_shared/himi-media.js";
 import { cleanTitle, initials } from "../_shared/himi-text.js";
 import { copyParam, stashCopy } from "../_shared/himi-copy.js";
 import { iapPriceCopy, resetUnhydratedKeysOnOlderRuntime } from "../_shared/iap-worker.js";
@@ -86,14 +86,6 @@ function programDetails(p: WixProgram): string {
   return raw.length > 140 ? `${raw.slice(0, 139).trimEnd()}…` : raw;
 }
 
-function programImage(p: WixProgram): string {
-  const desc = (p as { description?: unknown }).description;
-  const nested = desc && typeof desc === "object" ? (desc as { image?: { url?: string } }).image?.url : undefined;
-  const cover = (p as { coverImage?: unknown }).coverImage;
-  const coverUrl = typeof cover === "string" ? cover : (cover as { url?: string } | undefined)?.url;
-  return wixMediaUrl(coverUrl || p.image || nested);
-}
-
 function programMeta(p: WixProgram): string {
   const summary = (p as { contentSummary?: { stepCount?: number; sectionCount?: number } }).contentSummary;
   const bits: string[] = [];