@wix/himalaya-cli 0.861.0 → 0.863.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.861.0",
+  "version": "0.863.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": [
@@ -63,5 +63,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "2d77c6f215930baecdc2a1637d6fb8dd37e4a6ba32421c3a31e94a16"
+  "falconPackageHash": "c5d242935309a310e8916c1fc607f5bfc7aebc217e81fa9fbaa08ca7"
 }

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

@@ -2280,7 +2280,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiBrandedHome.refresh",
           "params": {
             "verticals": "[\"store\",\"bookings\",\"plans\",\"blog\"]",
-            "homeModules": "[{\"id\":\"member_progress\",\"label\":\"This week's schedule\",\"dataSource\":\"member.bookings.schedule\"},{\"id\":\"up_next\",\"label\":\"Up next\",\"dataSource\":\"member.bookings\"},{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\"},{\"id\":\"section_0\",\"label\":\"Discover 1\",\"dataSource\":\"salonLuxe.section0\"},{\"id\":\"section_1\",\"label\":\"__HIMI_APP_NAME__\",\"dataSource\":\"salonLuxe.section1\"}]",
+            "homeModules": "[{\"id\":\"member_progress\",\"label\":\"This week's schedule\",\"dataSource\":\"member.bookings.schedule\",\"emptyWhen\":[\"hideMemberProgress\"]},{\"id\":\"up_next\",\"label\":\"Up next\",\"dataSource\":\"member.bookings\",\"emptyWhen\":[\"hideNextBooking\",\"hidePersonalError\"]},{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\",\"emptyWhen\":[\"noSavedContent\"]},{\"id\":\"section_0\",\"label\":\"Discover 1\",\"dataSource\":\"salonLuxe.section0\",\"emptyWhen\":[\"hideHeroImage\"]},{\"id\":\"section_1\",\"label\":\"__HIMI_APP_NAME__\",\"dataSource\":\"salonLuxe.section1\"}]",
             "ownerDefaultLayout": "salonLuxe",
             "brandAccent": "#A65E58",
             "copy": "{\"home.bookVisitCta\":\"Book a visit\",\"home.featuredTitle\":\"Salon picks\",\"home.stylistsCaption\":\"Meet your stylists\",\"home.treatmentsSubtitle\":\"Book your favorite in a couple of taps.\",\"home.treatmentsTitle\":\"Signature treatments\"}"

package/templates/beauty-salon/tier5-src/_shared/home-modules.ts

@@ -1,7 +1,33 @@
 /** Bounded OTA home composition. Module ids, eligibility and defaults are
  * supplied by the signed descriptor; personal state cannot introduce content. */
-export interface HomeModule { id: string; label: string; dataSource: string; }
+/** `emptyWhen` — state keys that ALL have to be truthy for the module to have nothing
+ *  to paint. Derived from the descriptor's own `hiddenPath` gates (see
+ *  `emptyWhenOf` in home-modules-screen.ts), never hand-maintained.
+ *
+ *  It exists because "visible" had two independent meanings that never met: the user's
+ *  preference (this list) and the content's own `hiddenWhen` gates. A module the user
+ *  keeps but whose content self-hides still occupied a row, and the list's spacing is
+ *  applied per ROW — so a signed-out home left four empty rows and a ~95px hole above
+ *  the first real section. The same arithmetic runs in SwiftUI/Compose VStack spacing,
+ *  which is why this is filtered in the worker rather than patched in one renderer. */
+export interface HomeModule { id: string; label: string; dataSource: string; emptyWhen?: string[]; }
 export interface HomePreferences { order: string[]; hidden: string[]; pinned: string[]; }
+/** Mirror of the renderers' hidden-gate truthiness (`hiddenBool` on web,
+ *  `ReactiveHiddenGate.boolOf` on native): bool → itself; number ≠ 0; "true"/"1"
+ *  case-insensitively. Anything else — including undefined — is NOT hidden, so an
+ *  unknown key can only ever keep a module on screen. */
+export function hiddenFlag(v: unknown): boolean {
+  if (typeof v === 'boolean') return v;
+  if (typeof v === 'number') return v !== 0;
+  if (typeof v === 'string') { const l = v.trim().toLowerCase(); return l === 'true' || l === '1'; }
+  return false;
+}
+/** True when every one of the module's gates is currently hidden, i.e. it would render
+ *  an empty row. A module with no declared gates is never empty. */
+export function moduleIsEmpty(module: HomeModule, state: Record<string, unknown>): boolean {
+  const gates = module.emptyWhen;
+  return Array.isArray(gates) && gates.length > 0 && gates.every(key => hiddenFlag(state[key]));
+}
 export function normalizeHome(modules: HomeModule[], value?: Partial<HomePreferences>): HomePreferences {
   const ids = modules.map(module => module.id);
   const valid = (items: unknown): string[] => Array.isArray(items) ? [...new Set(items.filter((id): id is string => typeof id === 'string' && ids.includes(id)))] : [];

package/templates/beauty-salon/tier5-src/_shared/home-service.ts

@@ -1,5 +1,5 @@
 import { defineService as register, type ServiceDefinition } from '@himalaya/state';
-import { normalizeHome, visibleHome, type HomeModule, type HomePreferences } from './home-modules.js';
+import { normalizeHome, visibleHome, moduleIsEmpty, type HomeModule, type HomePreferences } from './home-modules.js';
 import { copyParam, stashCopy } from './himi-copy.js';
 import { localPreferences } from './local-preferences.js';
 type State = Record<string, unknown>;
@@ -18,8 +18,18 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
   let prefs: HomePreferences = normalizeHome([]);
   let presented = false;
   const derive = (s: State): State => {
+    // Two filters, and they answer different questions. `visibleHome` is what the USER
+    // chose to keep; `moduleIsEmpty` is whether the module has anything to paint right
+    // now. A row that passes the first and fails the second still costs the list its
+    // inter-row spacing on every renderer, which is the ~95px hole a signed-out home
+    // used to show. `slots` keeps the unfiltered order so a module that fills up later
+    // returns to the same place rather than jumping to the end.
     const order = visibleHome(prefs);
-    return { ...s, homeModules: { presented, visible: order.map(id => ({ id })),
+    const painted = order.filter(id => {
+      const module = modules.find(m => m.id === id);
+      return !module || !moduleIsEmpty(module, s);
+    });
+    return { ...s, homeModules: { presented, visible: painted.map(id => ({ id })),
       persistenceLabel: persisted.available ? copyParam('homeModules.onDevice', 'Saved on this device') : copyParam('homeModules.sessionOnly', 'Choices last for this session'),
       slots: Object.fromEntries(modules.map((_, i) => [`slot${i}`, order[i] ?? 'empty'])),
       choices: prefs.order.map(id => ({ ...modules.find(module => module.id === id),
@@ -35,7 +45,17 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
       try {
         const parsed: unknown = JSON.parse(arg.homeModules);
         if (Array.isArray(parsed)) {
-          modules = parsed.filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string').slice(0, 5);
+          modules = parsed
+            .filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string')
+            .slice(0, 5)
+            // Same shape rule as the ids above: a gate is a plain state key, never a
+            // path. Anything else is dropped, which can only leave a module ON screen.
+            .map(module => {
+              const gates = Array.isArray(module.emptyWhen)
+                ? module.emptyWhen.filter((k): k is string => typeof k === 'string' && /^[A-Za-z][A-Za-z0-9_]{0,60}$/.test(k))
+                : [];
+              return gates.length ? { ...module, emptyWhen: gates } : { ...module, emptyWhen: undefined };
+            });
           prefs = normalizeHome(modules, receivedRegistry ? prefs : restored);
           receivedRegistry = true;
         }

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

@@ -49676,7 +49676,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiOwnerLiteHome.load",
           "params": {
             "copy": "{\"ownerHome.acrossBusiness\":\"Across the salon\",\"ownerHome.briefCta\":\"Show me the chair\",\"ownerHome.briefSubtitle\":\"Who’s in the chair, where the gaps are, and which retail lines are down to the last tube.\",\"ownerHome.briefTitle\":\"Today at the salon\",\"ownerHome.errorLabel\":\"Couldn’t load today’s chair\",\"ownerHome.headerSubtitle\":\"Salon owner · today’s chair\",\"ownerHome.openManage\":\"Open the salon\",\"ownerHome.ordersDaily\":\"Retail sales · daily\",\"ownerHome.statAppointments\":\"Booked in\",\"ownerHome.statOrders\":\"Retail orders\",\"ownerHome.statPosts\":\"Salon notes\",\"ownerHome.statProducts\":\"Retail lines\",\"ownerHome.statRevenue\":\"Takings\",\"ownerHome.statSites\":\"Salons\",\"ownerHome.switchBusiness\":\"Switch salon\"}",
-            "homeModules": "[{\"id\":\"attention\",\"label\":\"Needs attention\",\"dataSource\":\"owner-today\"},{\"id\":\"schedule\",\"label\":\"Up next\",\"dataSource\":\"owner-schedule\"},{\"id\":\"shortcuts\",\"label\":\"Quick actions\",\"dataSource\":\"owner-actions\"},{\"id\":\"metrics\",\"label\":\"Business overview\",\"dataSource\":\"dashboard\"},{\"id\":\"brief\",\"label\":\"Daily brief\",\"dataSource\":\"brief\"}]",
+            "homeModules": "[{\"id\":\"attention\",\"label\":\"Needs attention\",\"dataSource\":\"owner-today\",\"emptyWhen\":[\"hideContent\"]},{\"id\":\"schedule\",\"label\":\"Up next\",\"dataSource\":\"owner-schedule\",\"emptyWhen\":[\"hideContent\"]},{\"id\":\"shortcuts\",\"label\":\"Quick actions\",\"dataSource\":\"owner-actions\"},{\"id\":\"metrics\",\"label\":\"Business overview\",\"dataSource\":\"dashboard\",\"emptyWhen\":[\"hideContent\"]},{\"id\":\"brief\",\"label\":\"Daily brief\",\"dataSource\":\"brief\"}]",
             "enabledSources": "[\"products\",\"posts\",\"sites\",\"orders\",\"bookings\",\"members\",\"reviews\",\"reservations\"]"
           }
         }

package/templates/beauty-salon-owner/tier5-src/_shared/home-modules.ts

@@ -1,7 +1,33 @@
 /** Bounded OTA home composition. Module ids, eligibility and defaults are
  * supplied by the signed descriptor; personal state cannot introduce content. */
-export interface HomeModule { id: string; label: string; dataSource: string; }
+/** `emptyWhen` — state keys that ALL have to be truthy for the module to have nothing
+ *  to paint. Derived from the descriptor's own `hiddenPath` gates (see
+ *  `emptyWhenOf` in home-modules-screen.ts), never hand-maintained.
+ *
+ *  It exists because "visible" had two independent meanings that never met: the user's
+ *  preference (this list) and the content's own `hiddenWhen` gates. A module the user
+ *  keeps but whose content self-hides still occupied a row, and the list's spacing is
+ *  applied per ROW — so a signed-out home left four empty rows and a ~95px hole above
+ *  the first real section. The same arithmetic runs in SwiftUI/Compose VStack spacing,
+ *  which is why this is filtered in the worker rather than patched in one renderer. */
+export interface HomeModule { id: string; label: string; dataSource: string; emptyWhen?: string[]; }
 export interface HomePreferences { order: string[]; hidden: string[]; pinned: string[]; }
+/** Mirror of the renderers' hidden-gate truthiness (`hiddenBool` on web,
+ *  `ReactiveHiddenGate.boolOf` on native): bool → itself; number ≠ 0; "true"/"1"
+ *  case-insensitively. Anything else — including undefined — is NOT hidden, so an
+ *  unknown key can only ever keep a module on screen. */
+export function hiddenFlag(v: unknown): boolean {
+  if (typeof v === 'boolean') return v;
+  if (typeof v === 'number') return v !== 0;
+  if (typeof v === 'string') { const l = v.trim().toLowerCase(); return l === 'true' || l === '1'; }
+  return false;
+}
+/** True when every one of the module's gates is currently hidden, i.e. it would render
+ *  an empty row. A module with no declared gates is never empty. */
+export function moduleIsEmpty(module: HomeModule, state: Record<string, unknown>): boolean {
+  const gates = module.emptyWhen;
+  return Array.isArray(gates) && gates.length > 0 && gates.every(key => hiddenFlag(state[key]));
+}
 export function normalizeHome(modules: HomeModule[], value?: Partial<HomePreferences>): HomePreferences {
   const ids = modules.map(module => module.id);
   const valid = (items: unknown): string[] => Array.isArray(items) ? [...new Set(items.filter((id): id is string => typeof id === 'string' && ids.includes(id)))] : [];

package/templates/beauty-salon-owner/tier5-src/_shared/home-service.ts

@@ -1,5 +1,5 @@
 import { defineService as register, type ServiceDefinition } from '@himalaya/state';
-import { normalizeHome, visibleHome, type HomeModule, type HomePreferences } from './home-modules.js';
+import { normalizeHome, visibleHome, moduleIsEmpty, type HomeModule, type HomePreferences } from './home-modules.js';
 import { copyParam, stashCopy } from './himi-copy.js';
 import { localPreferences } from './local-preferences.js';
 type State = Record<string, unknown>;
@@ -18,8 +18,18 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
   let prefs: HomePreferences = normalizeHome([]);
   let presented = false;
   const derive = (s: State): State => {
+    // Two filters, and they answer different questions. `visibleHome` is what the USER
+    // chose to keep; `moduleIsEmpty` is whether the module has anything to paint right
+    // now. A row that passes the first and fails the second still costs the list its
+    // inter-row spacing on every renderer, which is the ~95px hole a signed-out home
+    // used to show. `slots` keeps the unfiltered order so a module that fills up later
+    // returns to the same place rather than jumping to the end.
     const order = visibleHome(prefs);
-    return { ...s, homeModules: { presented, visible: order.map(id => ({ id })),
+    const painted = order.filter(id => {
+      const module = modules.find(m => m.id === id);
+      return !module || !moduleIsEmpty(module, s);
+    });
+    return { ...s, homeModules: { presented, visible: painted.map(id => ({ id })),
       persistenceLabel: persisted.available ? copyParam('homeModules.onDevice', 'Saved on this device') : copyParam('homeModules.sessionOnly', 'Choices last for this session'),
       slots: Object.fromEntries(modules.map((_, i) => [`slot${i}`, order[i] ?? 'empty'])),
       choices: prefs.order.map(id => ({ ...modules.find(module => module.id === id),
@@ -35,7 +45,17 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
       try {
         const parsed: unknown = JSON.parse(arg.homeModules);
         if (Array.isArray(parsed)) {
-          modules = parsed.filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string').slice(0, 5);
+          modules = parsed
+            .filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string')
+            .slice(0, 5)
+            // Same shape rule as the ids above: a gate is a plain state key, never a
+            // path. Anything else is dropped, which can only leave a module ON screen.
+            .map(module => {
+              const gates = Array.isArray(module.emptyWhen)
+                ? module.emptyWhen.filter((k): k is string => typeof k === 'string' && /^[A-Za-z][A-Za-z0-9_]{0,60}$/.test(k))
+                : [];
+              return gates.length ? { ...module, emptyWhen: gates } : { ...module, emptyWhen: undefined };
+            });
           prefs = normalizeHome(modules, receivedRegistry ? prefs : restored);
           receivedRegistry = true;
         }

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

@@ -2839,7 +2839,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiBrandedHome.refresh",
           "params": {
             "verticals": "[\"store\",\"bookings\",\"restaurants\",\"programs\",\"plans\",\"feed\",\"members\",\"forum\",\"coupons\",\"notifications\",\"loyalty\",\"reviews\",\"portfolio\",\"reservations\",\"invoices\",\"badges\",\"notifsettings\",\"events\",\"blog\",\"groups\",\"cms\",\"donations\",\"giftCards\",\"videos\",\"podcasts\",\"forms\",\"galleries\",\"inbox\",\"faq\"]",
-            "homeModules": "[{\"id\":\"member_progress\",\"label\":\"This week's schedule\",\"dataSource\":\"member.bookings.schedule\"},{\"id\":\"up_next\",\"label\":\"Up next\",\"dataSource\":\"member.bookings\"},{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\"},{\"id\":\"section_0\",\"label\":\"Discover 1\",\"dataSource\":\"classic.section0\"},{\"id\":\"section_1\",\"label\":\"Featured products\",\"dataSource\":\"classic.section1\"}]",
+            "homeModules": "[{\"id\":\"member_progress\",\"label\":\"This week's schedule\",\"dataSource\":\"member.bookings.schedule\",\"emptyWhen\":[\"hideMemberProgress\"]},{\"id\":\"up_next\",\"label\":\"Up next\",\"dataSource\":\"member.bookings\",\"emptyWhen\":[\"hideNextBooking\",\"hidePersonalError\"]},{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\",\"emptyWhen\":[\"noSavedContent\"]},{\"id\":\"section_0\",\"label\":\"Discover 1\",\"dataSource\":\"classic.section0\",\"emptyWhen\":[\"hideFeaturedSkeleton\"]},{\"id\":\"section_1\",\"label\":\"Featured products\",\"dataSource\":\"classic.section1\"}]",
             "ownerDefaultLayout": "",
             "brandAccent": "#0A66C2"
           }

package/templates/branded-lite/tier5-src/_shared/home-modules.ts

@@ -1,7 +1,33 @@
 /** Bounded OTA home composition. Module ids, eligibility and defaults are
  * supplied by the signed descriptor; personal state cannot introduce content. */
-export interface HomeModule { id: string; label: string; dataSource: string; }
+/** `emptyWhen` — state keys that ALL have to be truthy for the module to have nothing
+ *  to paint. Derived from the descriptor's own `hiddenPath` gates (see
+ *  `emptyWhenOf` in home-modules-screen.ts), never hand-maintained.
+ *
+ *  It exists because "visible" had two independent meanings that never met: the user's
+ *  preference (this list) and the content's own `hiddenWhen` gates. A module the user
+ *  keeps but whose content self-hides still occupied a row, and the list's spacing is
+ *  applied per ROW — so a signed-out home left four empty rows and a ~95px hole above
+ *  the first real section. The same arithmetic runs in SwiftUI/Compose VStack spacing,
+ *  which is why this is filtered in the worker rather than patched in one renderer. */
+export interface HomeModule { id: string; label: string; dataSource: string; emptyWhen?: string[]; }
 export interface HomePreferences { order: string[]; hidden: string[]; pinned: string[]; }
+/** Mirror of the renderers' hidden-gate truthiness (`hiddenBool` on web,
+ *  `ReactiveHiddenGate.boolOf` on native): bool → itself; number ≠ 0; "true"/"1"
+ *  case-insensitively. Anything else — including undefined — is NOT hidden, so an
+ *  unknown key can only ever keep a module on screen. */
+export function hiddenFlag(v: unknown): boolean {
+  if (typeof v === 'boolean') return v;
+  if (typeof v === 'number') return v !== 0;
+  if (typeof v === 'string') { const l = v.trim().toLowerCase(); return l === 'true' || l === '1'; }
+  return false;
+}
+/** True when every one of the module's gates is currently hidden, i.e. it would render
+ *  an empty row. A module with no declared gates is never empty. */
+export function moduleIsEmpty(module: HomeModule, state: Record<string, unknown>): boolean {
+  const gates = module.emptyWhen;
+  return Array.isArray(gates) && gates.length > 0 && gates.every(key => hiddenFlag(state[key]));
+}
 export function normalizeHome(modules: HomeModule[], value?: Partial<HomePreferences>): HomePreferences {
   const ids = modules.map(module => module.id);
   const valid = (items: unknown): string[] => Array.isArray(items) ? [...new Set(items.filter((id): id is string => typeof id === 'string' && ids.includes(id)))] : [];

package/templates/branded-lite/tier5-src/_shared/home-service.ts

@@ -1,5 +1,5 @@
 import { defineService as register, type ServiceDefinition } from '@himalaya/state';
-import { normalizeHome, visibleHome, type HomeModule, type HomePreferences } from './home-modules.js';
+import { normalizeHome, visibleHome, moduleIsEmpty, type HomeModule, type HomePreferences } from './home-modules.js';
 import { copyParam, stashCopy } from './himi-copy.js';
 import { localPreferences } from './local-preferences.js';
 type State = Record<string, unknown>;
@@ -18,8 +18,18 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
   let prefs: HomePreferences = normalizeHome([]);
   let presented = false;
   const derive = (s: State): State => {
+    // Two filters, and they answer different questions. `visibleHome` is what the USER
+    // chose to keep; `moduleIsEmpty` is whether the module has anything to paint right
+    // now. A row that passes the first and fails the second still costs the list its
+    // inter-row spacing on every renderer, which is the ~95px hole a signed-out home
+    // used to show. `slots` keeps the unfiltered order so a module that fills up later
+    // returns to the same place rather than jumping to the end.
     const order = visibleHome(prefs);
-    return { ...s, homeModules: { presented, visible: order.map(id => ({ id })),
+    const painted = order.filter(id => {
+      const module = modules.find(m => m.id === id);
+      return !module || !moduleIsEmpty(module, s);
+    });
+    return { ...s, homeModules: { presented, visible: painted.map(id => ({ id })),
       persistenceLabel: persisted.available ? copyParam('homeModules.onDevice', 'Saved on this device') : copyParam('homeModules.sessionOnly', 'Choices last for this session'),
       slots: Object.fromEntries(modules.map((_, i) => [`slot${i}`, order[i] ?? 'empty'])),
       choices: prefs.order.map(id => ({ ...modules.find(module => module.id === id),
@@ -35,7 +45,17 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
       try {
         const parsed: unknown = JSON.parse(arg.homeModules);
         if (Array.isArray(parsed)) {
-          modules = parsed.filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string').slice(0, 5);
+          modules = parsed
+            .filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string')
+            .slice(0, 5)
+            // Same shape rule as the ids above: a gate is a plain state key, never a
+            // path. Anything else is dropped, which can only leave a module ON screen.
+            .map(module => {
+              const gates = Array.isArray(module.emptyWhen)
+                ? module.emptyWhen.filter((k): k is string => typeof k === 'string' && /^[A-Za-z][A-Za-z0-9_]{0,60}$/.test(k))
+                : [];
+              return gates.length ? { ...module, emptyWhen: gates } : { ...module, emptyWhen: undefined };
+            });
           prefs = normalizeHome(modules, receivedRegistry ? prefs : restored);
           receivedRegistry = true;
         }

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

@@ -1917,7 +1917,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiBrandedHome.refresh",
           "params": {
             "verticals": "[\"feed\",\"events\",\"blog\",\"groups\",\"cms\"]",
-            "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\"},{\"id\":\"section_0\",\"label\":\"Discover 1\",\"dataSource\":\"communityPulse.section0\"},{\"id\":\"section_1\",\"label\":\"Announcement\",\"dataSource\":\"communityPulse.section1\"},{\"id\":\"section_2\",\"label\":\"Groups\",\"dataSource\":\"communityPulse.section2\"},{\"id\":\"section_3\",\"label\":\"Latest activity\",\"dataSource\":\"communityPulse.section3\"}]",
+            "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\",\"emptyWhen\":[\"noSavedContent\"]},{\"id\":\"section_0\",\"label\":\"Discover 1\",\"dataSource\":\"communityPulse.section0\",\"emptyWhen\":[\"noMemberAvatars\"]},{\"id\":\"section_1\",\"label\":\"Announcement\",\"dataSource\":\"communityPulse.section1\",\"emptyWhen\":[\"noAnnouncement\",\"noUpcomingEvents\"]},{\"id\":\"section_2\",\"label\":\"Groups\",\"dataSource\":\"communityPulse.section2\",\"emptyWhen\":[\"noGroupCards\"]},{\"id\":\"section_3\",\"label\":\"Latest activity\",\"dataSource\":\"communityPulse.section3\"}]",
             "ownerDefaultLayout": "communityPulse",
             "brandAccent": "#6C3FC4",
             "copy": "{\"home.activityTitle\":\"Latest activity\",\"home.announcementCaption\":\"Announcement\",\"home.eventsTitle\":\"Upcoming events\",\"home.groupsSubtitle\":\"Find your people.\",\"home.groupsTitle\":\"Groups\",\"home.membersCaption\":\"Our members\",\"home.onboardingBody\":\"Join groups, RSVP to events, and keep up with the community feed — all in one place.\"}"

package/templates/community-club/tier5-src/_shared/home-modules.ts

@@ -1,7 +1,33 @@
 /** Bounded OTA home composition. Module ids, eligibility and defaults are
  * supplied by the signed descriptor; personal state cannot introduce content. */
-export interface HomeModule { id: string; label: string; dataSource: string; }
+/** `emptyWhen` — state keys that ALL have to be truthy for the module to have nothing
+ *  to paint. Derived from the descriptor's own `hiddenPath` gates (see
+ *  `emptyWhenOf` in home-modules-screen.ts), never hand-maintained.
+ *
+ *  It exists because "visible" had two independent meanings that never met: the user's
+ *  preference (this list) and the content's own `hiddenWhen` gates. A module the user
+ *  keeps but whose content self-hides still occupied a row, and the list's spacing is
+ *  applied per ROW — so a signed-out home left four empty rows and a ~95px hole above
+ *  the first real section. The same arithmetic runs in SwiftUI/Compose VStack spacing,
+ *  which is why this is filtered in the worker rather than patched in one renderer. */
+export interface HomeModule { id: string; label: string; dataSource: string; emptyWhen?: string[]; }
 export interface HomePreferences { order: string[]; hidden: string[]; pinned: string[]; }
+/** Mirror of the renderers' hidden-gate truthiness (`hiddenBool` on web,
+ *  `ReactiveHiddenGate.boolOf` on native): bool → itself; number ≠ 0; "true"/"1"
+ *  case-insensitively. Anything else — including undefined — is NOT hidden, so an
+ *  unknown key can only ever keep a module on screen. */
+export function hiddenFlag(v: unknown): boolean {
+  if (typeof v === 'boolean') return v;
+  if (typeof v === 'number') return v !== 0;
+  if (typeof v === 'string') { const l = v.trim().toLowerCase(); return l === 'true' || l === '1'; }
+  return false;
+}
+/** True when every one of the module's gates is currently hidden, i.e. it would render
+ *  an empty row. A module with no declared gates is never empty. */
+export function moduleIsEmpty(module: HomeModule, state: Record<string, unknown>): boolean {
+  const gates = module.emptyWhen;
+  return Array.isArray(gates) && gates.length > 0 && gates.every(key => hiddenFlag(state[key]));
+}
 export function normalizeHome(modules: HomeModule[], value?: Partial<HomePreferences>): HomePreferences {
   const ids = modules.map(module => module.id);
   const valid = (items: unknown): string[] => Array.isArray(items) ? [...new Set(items.filter((id): id is string => typeof id === 'string' && ids.includes(id)))] : [];

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

@@ -1,5 +1,5 @@
 import { defineService as register, type ServiceDefinition } from '@himalaya/state';
-import { normalizeHome, visibleHome, type HomeModule, type HomePreferences } from './home-modules.js';
+import { normalizeHome, visibleHome, moduleIsEmpty, type HomeModule, type HomePreferences } from './home-modules.js';
 import { copyParam, stashCopy } from './himi-copy.js';
 import { localPreferences } from './local-preferences.js';
 type State = Record<string, unknown>;
@@ -18,8 +18,18 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
   let prefs: HomePreferences = normalizeHome([]);
   let presented = false;
   const derive = (s: State): State => {
+    // Two filters, and they answer different questions. `visibleHome` is what the USER
+    // chose to keep; `moduleIsEmpty` is whether the module has anything to paint right
+    // now. A row that passes the first and fails the second still costs the list its
+    // inter-row spacing on every renderer, which is the ~95px hole a signed-out home
+    // used to show. `slots` keeps the unfiltered order so a module that fills up later
+    // returns to the same place rather than jumping to the end.
     const order = visibleHome(prefs);
-    return { ...s, homeModules: { presented, visible: order.map(id => ({ id })),
+    const painted = order.filter(id => {
+      const module = modules.find(m => m.id === id);
+      return !module || !moduleIsEmpty(module, s);
+    });
+    return { ...s, homeModules: { presented, visible: painted.map(id => ({ id })),
       persistenceLabel: persisted.available ? copyParam('homeModules.onDevice', 'Saved on this device') : copyParam('homeModules.sessionOnly', 'Choices last for this session'),
       slots: Object.fromEntries(modules.map((_, i) => [`slot${i}`, order[i] ?? 'empty'])),
       choices: prefs.order.map(id => ({ ...modules.find(module => module.id === id),
@@ -35,7 +45,17 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
       try {
         const parsed: unknown = JSON.parse(arg.homeModules);
         if (Array.isArray(parsed)) {
-          modules = parsed.filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string').slice(0, 5);
+          modules = parsed
+            .filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string')
+            .slice(0, 5)
+            // Same shape rule as the ids above: a gate is a plain state key, never a
+            // path. Anything else is dropped, which can only leave a module ON screen.
+            .map(module => {
+              const gates = Array.isArray(module.emptyWhen)
+                ? module.emptyWhen.filter((k): k is string => typeof k === 'string' && /^[A-Za-z][A-Za-z0-9_]{0,60}$/.test(k))
+                : [];
+              return gates.length ? { ...module, emptyWhen: gates } : { ...module, emptyWhen: undefined };
+            });
           prefs = normalizeHome(modules, receivedRegistry ? prefs : restored);
           receivedRegistry = true;
         }

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

@@ -49676,7 +49676,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiOwnerLiteHome.load",
           "params": {
             "copy": "{\"ownerHome.acrossBusiness\":\"Across the club\",\"ownerHome.briefCta\":\"Show me the week\",\"ownerHome.briefSubtitle\":\"Who’s signed up for the next club night, what the kit shop owes, and which notice still needs writing.\",\"ownerHome.briefTitle\":\"This week at the club\",\"ownerHome.errorLabel\":\"Couldn’t load the committee view\",\"ownerHome.headerSubtitle\":\"Club committee · this week\",\"ownerHome.openManage\":\"Open the club\",\"ownerHome.ordersDaily\":\"Kit shop orders · daily\",\"ownerHome.statEvents\":\"Club nights ahead\",\"ownerHome.statOrders\":\"Kit orders\",\"ownerHome.statPosts\":\"Notices\",\"ownerHome.statProducts\":\"Kit items\",\"ownerHome.statRevenue\":\"Club funds\",\"ownerHome.statSites\":\"Clubs\",\"ownerHome.switchBusiness\":\"Switch club\"}",
-            "homeModules": "[{\"id\":\"attention\",\"label\":\"Needs attention\",\"dataSource\":\"owner-today\"},{\"id\":\"schedule\",\"label\":\"Up next\",\"dataSource\":\"owner-schedule\"},{\"id\":\"shortcuts\",\"label\":\"Quick actions\",\"dataSource\":\"owner-actions\"},{\"id\":\"metrics\",\"label\":\"Business overview\",\"dataSource\":\"dashboard\"},{\"id\":\"brief\",\"label\":\"Daily brief\",\"dataSource\":\"brief\"}]",
+            "homeModules": "[{\"id\":\"attention\",\"label\":\"Needs attention\",\"dataSource\":\"owner-today\",\"emptyWhen\":[\"hideContent\"]},{\"id\":\"schedule\",\"label\":\"Up next\",\"dataSource\":\"owner-schedule\",\"emptyWhen\":[\"hideContent\"]},{\"id\":\"shortcuts\",\"label\":\"Quick actions\",\"dataSource\":\"owner-actions\"},{\"id\":\"metrics\",\"label\":\"Business overview\",\"dataSource\":\"dashboard\",\"emptyWhen\":[\"hideContent\"]},{\"id\":\"brief\",\"label\":\"Daily brief\",\"dataSource\":\"brief\"}]",
             "enabledSources": "[\"products\",\"posts\",\"sites\",\"orders\",\"events\",\"members\",\"reviews\",\"reservations\"]"
           }
         }

package/templates/community-club-owner/tier5-src/_shared/home-modules.ts

@@ -1,7 +1,33 @@
 /** Bounded OTA home composition. Module ids, eligibility and defaults are
  * supplied by the signed descriptor; personal state cannot introduce content. */
-export interface HomeModule { id: string; label: string; dataSource: string; }
+/** `emptyWhen` — state keys that ALL have to be truthy for the module to have nothing
+ *  to paint. Derived from the descriptor's own `hiddenPath` gates (see
+ *  `emptyWhenOf` in home-modules-screen.ts), never hand-maintained.
+ *
+ *  It exists because "visible" had two independent meanings that never met: the user's
+ *  preference (this list) and the content's own `hiddenWhen` gates. A module the user
+ *  keeps but whose content self-hides still occupied a row, and the list's spacing is
+ *  applied per ROW — so a signed-out home left four empty rows and a ~95px hole above
+ *  the first real section. The same arithmetic runs in SwiftUI/Compose VStack spacing,
+ *  which is why this is filtered in the worker rather than patched in one renderer. */
+export interface HomeModule { id: string; label: string; dataSource: string; emptyWhen?: string[]; }
 export interface HomePreferences { order: string[]; hidden: string[]; pinned: string[]; }
+/** Mirror of the renderers' hidden-gate truthiness (`hiddenBool` on web,
+ *  `ReactiveHiddenGate.boolOf` on native): bool → itself; number ≠ 0; "true"/"1"
+ *  case-insensitively. Anything else — including undefined — is NOT hidden, so an
+ *  unknown key can only ever keep a module on screen. */
+export function hiddenFlag(v: unknown): boolean {
+  if (typeof v === 'boolean') return v;
+  if (typeof v === 'number') return v !== 0;
+  if (typeof v === 'string') { const l = v.trim().toLowerCase(); return l === 'true' || l === '1'; }
+  return false;
+}
+/** True when every one of the module's gates is currently hidden, i.e. it would render
+ *  an empty row. A module with no declared gates is never empty. */
+export function moduleIsEmpty(module: HomeModule, state: Record<string, unknown>): boolean {
+  const gates = module.emptyWhen;
+  return Array.isArray(gates) && gates.length > 0 && gates.every(key => hiddenFlag(state[key]));
+}
 export function normalizeHome(modules: HomeModule[], value?: Partial<HomePreferences>): HomePreferences {
   const ids = modules.map(module => module.id);
   const valid = (items: unknown): string[] => Array.isArray(items) ? [...new Set(items.filter((id): id is string => typeof id === 'string' && ids.includes(id)))] : [];

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

@@ -1,5 +1,5 @@
 import { defineService as register, type ServiceDefinition } from '@himalaya/state';
-import { normalizeHome, visibleHome, type HomeModule, type HomePreferences } from './home-modules.js';
+import { normalizeHome, visibleHome, moduleIsEmpty, type HomeModule, type HomePreferences } from './home-modules.js';
 import { copyParam, stashCopy } from './himi-copy.js';
 import { localPreferences } from './local-preferences.js';
 type State = Record<string, unknown>;
@@ -18,8 +18,18 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
   let prefs: HomePreferences = normalizeHome([]);
   let presented = false;
   const derive = (s: State): State => {
+    // Two filters, and they answer different questions. `visibleHome` is what the USER
+    // chose to keep; `moduleIsEmpty` is whether the module has anything to paint right
+    // now. A row that passes the first and fails the second still costs the list its
+    // inter-row spacing on every renderer, which is the ~95px hole a signed-out home
+    // used to show. `slots` keeps the unfiltered order so a module that fills up later
+    // returns to the same place rather than jumping to the end.
     const order = visibleHome(prefs);
-    return { ...s, homeModules: { presented, visible: order.map(id => ({ id })),
+    const painted = order.filter(id => {
+      const module = modules.find(m => m.id === id);
+      return !module || !moduleIsEmpty(module, s);
+    });
+    return { ...s, homeModules: { presented, visible: painted.map(id => ({ id })),
       persistenceLabel: persisted.available ? copyParam('homeModules.onDevice', 'Saved on this device') : copyParam('homeModules.sessionOnly', 'Choices last for this session'),
       slots: Object.fromEntries(modules.map((_, i) => [`slot${i}`, order[i] ?? 'empty'])),
       choices: prefs.order.map(id => ({ ...modules.find(module => module.id === id),
@@ -35,7 +45,17 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
       try {
         const parsed: unknown = JSON.parse(arg.homeModules);
         if (Array.isArray(parsed)) {
-          modules = parsed.filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string').slice(0, 5);
+          modules = parsed
+            .filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string')
+            .slice(0, 5)
+            // Same shape rule as the ids above: a gate is a plain state key, never a
+            // path. Anything else is dropped, which can only leave a module ON screen.
+            .map(module => {
+              const gates = Array.isArray(module.emptyWhen)
+                ? module.emptyWhen.filter((k): k is string => typeof k === 'string' && /^[A-Za-z][A-Za-z0-9_]{0,60}$/.test(k))
+                : [];
+              return gates.length ? { ...module, emptyWhen: gates } : { ...module, emptyWhen: undefined };
+            });
           prefs = normalizeHome(modules, receivedRegistry ? prefs : restored);
           receivedRegistry = true;
         }

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

@@ -2099,7 +2099,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiBrandedHome.refresh",
           "params": {
             "verticals": "[\"feed\",\"events\",\"blog\",\"groups\"]",
-            "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\"},{\"id\":\"section_0\",\"label\":\"Next up\",\"dataSource\":\"eventsFirst.section0\"},{\"id\":\"section_1\",\"label\":\"This season\",\"dataSource\":\"eventsFirst.section1\"},{\"id\":\"section_2\",\"label\":\"Discover 3\",\"dataSource\":\"eventsFirst.section2\"},{\"id\":\"section_3\",\"label\":\"Latest from the community\",\"dataSource\":\"eventsFirst.section3\"}]",
+            "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\",\"emptyWhen\":[\"noSavedContent\"]},{\"id\":\"section_0\",\"label\":\"Next up\",\"dataSource\":\"eventsFirst.section0\",\"emptyWhen\":[\"noNextEvent\"]},{\"id\":\"section_1\",\"label\":\"This season\",\"dataSource\":\"eventsFirst.section1\",\"emptyWhen\":[\"noUpcomingEvents\"]},{\"id\":\"section_2\",\"label\":\"Discover 3\",\"dataSource\":\"eventsFirst.section2\"},{\"id\":\"section_3\",\"label\":\"Latest from the community\",\"dataSource\":\"eventsFirst.section3\"}]",
             "ownerDefaultLayout": "eventsFirst",
             "brandAccent": "#5B3E96",
             "copy": "{\"home.activityTitle\":\"Latest from the community\",\"home.agendaTitle\":\"This season\",\"home.allEventsCta\":\"All events\",\"home.eventsTitle\":\"Upcoming events\",\"home.groupsSubtitle\":\"Find your crew.\",\"home.groupsTitle\":\"Groups\",\"home.membersCaption\":\"Who's coming\",\"home.nextUpCaption\":\"Next up\",\"home.onboardingBody\":\"See what's next, RSVP in a couple of taps, and keep up with the community between events — all in one place.\",\"home.recapsCaption\":\"Event recaps\",\"home.rsvpCta\":\"View event & RSVP\"}"

package/templates/events-meetups/tier5-src/_shared/home-modules.ts

@@ -1,7 +1,33 @@
 /** Bounded OTA home composition. Module ids, eligibility and defaults are
  * supplied by the signed descriptor; personal state cannot introduce content. */
-export interface HomeModule { id: string; label: string; dataSource: string; }
+/** `emptyWhen` — state keys that ALL have to be truthy for the module to have nothing
+ *  to paint. Derived from the descriptor's own `hiddenPath` gates (see
+ *  `emptyWhenOf` in home-modules-screen.ts), never hand-maintained.
+ *
+ *  It exists because "visible" had two independent meanings that never met: the user's
+ *  preference (this list) and the content's own `hiddenWhen` gates. A module the user
+ *  keeps but whose content self-hides still occupied a row, and the list's spacing is
+ *  applied per ROW — so a signed-out home left four empty rows and a ~95px hole above
+ *  the first real section. The same arithmetic runs in SwiftUI/Compose VStack spacing,
+ *  which is why this is filtered in the worker rather than patched in one renderer. */
+export interface HomeModule { id: string; label: string; dataSource: string; emptyWhen?: string[]; }
 export interface HomePreferences { order: string[]; hidden: string[]; pinned: string[]; }
+/** Mirror of the renderers' hidden-gate truthiness (`hiddenBool` on web,
+ *  `ReactiveHiddenGate.boolOf` on native): bool → itself; number ≠ 0; "true"/"1"
+ *  case-insensitively. Anything else — including undefined — is NOT hidden, so an
+ *  unknown key can only ever keep a module on screen. */
+export function hiddenFlag(v: unknown): boolean {
+  if (typeof v === 'boolean') return v;
+  if (typeof v === 'number') return v !== 0;
+  if (typeof v === 'string') { const l = v.trim().toLowerCase(); return l === 'true' || l === '1'; }
+  return false;
+}
+/** True when every one of the module's gates is currently hidden, i.e. it would render
+ *  an empty row. A module with no declared gates is never empty. */
+export function moduleIsEmpty(module: HomeModule, state: Record<string, unknown>): boolean {
+  const gates = module.emptyWhen;
+  return Array.isArray(gates) && gates.length > 0 && gates.every(key => hiddenFlag(state[key]));
+}
 export function normalizeHome(modules: HomeModule[], value?: Partial<HomePreferences>): HomePreferences {
   const ids = modules.map(module => module.id);
   const valid = (items: unknown): string[] => Array.isArray(items) ? [...new Set(items.filter((id): id is string => typeof id === 'string' && ids.includes(id)))] : [];

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

@@ -1,5 +1,5 @@
 import { defineService as register, type ServiceDefinition } from '@himalaya/state';
-import { normalizeHome, visibleHome, type HomeModule, type HomePreferences } from './home-modules.js';
+import { normalizeHome, visibleHome, moduleIsEmpty, type HomeModule, type HomePreferences } from './home-modules.js';
 import { copyParam, stashCopy } from './himi-copy.js';
 import { localPreferences } from './local-preferences.js';
 type State = Record<string, unknown>;
@@ -18,8 +18,18 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
   let prefs: HomePreferences = normalizeHome([]);
   let presented = false;
   const derive = (s: State): State => {
+    // Two filters, and they answer different questions. `visibleHome` is what the USER
+    // chose to keep; `moduleIsEmpty` is whether the module has anything to paint right
+    // now. A row that passes the first and fails the second still costs the list its
+    // inter-row spacing on every renderer, which is the ~95px hole a signed-out home
+    // used to show. `slots` keeps the unfiltered order so a module that fills up later
+    // returns to the same place rather than jumping to the end.
     const order = visibleHome(prefs);
-    return { ...s, homeModules: { presented, visible: order.map(id => ({ id })),
+    const painted = order.filter(id => {
+      const module = modules.find(m => m.id === id);
+      return !module || !moduleIsEmpty(module, s);
+    });
+    return { ...s, homeModules: { presented, visible: painted.map(id => ({ id })),
       persistenceLabel: persisted.available ? copyParam('homeModules.onDevice', 'Saved on this device') : copyParam('homeModules.sessionOnly', 'Choices last for this session'),
       slots: Object.fromEntries(modules.map((_, i) => [`slot${i}`, order[i] ?? 'empty'])),
       choices: prefs.order.map(id => ({ ...modules.find(module => module.id === id),
@@ -35,7 +45,17 @@ export function decorateHome(def: { state: State; actions?: Record<string, Actio
       try {
         const parsed: unknown = JSON.parse(arg.homeModules);
         if (Array.isArray(parsed)) {
-          modules = parsed.filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string').slice(0, 5);
+          modules = parsed
+            .filter((m): m is HomeModule => typeof m?.id === 'string' && /^[a-z][a-z0-9_-]{0,40}$/.test(m.id) && typeof m.label === 'string')
+            .slice(0, 5)
+            // Same shape rule as the ids above: a gate is a plain state key, never a
+            // path. Anything else is dropped, which can only leave a module ON screen.
+            .map(module => {
+              const gates = Array.isArray(module.emptyWhen)
+                ? module.emptyWhen.filter((k): k is string => typeof k === 'string' && /^[A-Za-z][A-Za-z0-9_]{0,60}$/.test(k))
+                : [];
+              return gates.length ? { ...module, emptyWhen: gates } : { ...module, emptyWhen: undefined };
+            });
           prefs = normalizeHome(modules, receivedRegistry ? prefs : restored);
           receivedRegistry = true;
         }