@wix/himalaya-cli 0.862.0 → 0.863.0

package/templates/podcast-creator/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/podcast-creator/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/podcast-creator-owner/dev/index.ts

@@ -49676,7 +49676,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiOwnerLiteHome.load",
           "params": {
             "copy": "{\"ownerHome.acrossBusiness\":\"Across the show\",\"ownerHome.briefCta\":\"Show me the desk\",\"ownerHome.briefSubtitle\":\"Which episode is still a draft, what merch is moving, and how the next live taping is filling up.\",\"ownerHome.briefTitle\":\"The show desk\",\"ownerHome.errorLabel\":\"Couldn’t load the show desk\",\"ownerHome.headerSubtitle\":\"Creator · the show desk\",\"ownerHome.openManage\":\"Open the show\",\"ownerHome.ordersDaily\":\"Merch sales · daily\",\"ownerHome.statEvents\":\"Live tapings ahead\",\"ownerHome.statOrders\":\"Merch orders\",\"ownerHome.statPosts\":\"Episodes\",\"ownerHome.statProducts\":\"Merch designs\",\"ownerHome.statRevenue\":\"Merch revenue\",\"ownerHome.statSites\":\"Shows\",\"ownerHome.switchBusiness\":\"Switch show\"}",
-            "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/podcast-creator-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/podcast-creator-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/portfolio-creative/dev/index.ts

@@ -1852,7 +1852,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiBrandedHome.refresh",
           "params": {
             "verticals": "[\"store\",\"portfolio\",\"events\",\"blog\"]",
-            "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\"},{\"id\":\"section_0\",\"label\":\"Selected work\",\"dataSource\":\"showcaseFirst.section0\"},{\"id\":\"section_1\",\"label\":\"Discover 2\",\"dataSource\":\"showcaseFirst.section1\"},{\"id\":\"section_2\",\"label\":\"Prints & editions\",\"dataSource\":\"showcaseFirst.section2\"},{\"id\":\"section_3\",\"label\":\"Exhibitions & fairs\",\"dataSource\":\"showcaseFirst.section3\"}]",
+            "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\",\"emptyWhen\":[\"noSavedContent\"]},{\"id\":\"section_0\",\"label\":\"Selected work\",\"dataSource\":\"showcaseFirst.section0\",\"emptyWhen\":[\"noPostCards\"]},{\"id\":\"section_1\",\"label\":\"Discover 2\",\"dataSource\":\"showcaseFirst.section1\"},{\"id\":\"section_2\",\"label\":\"Prints & editions\",\"dataSource\":\"showcaseFirst.section2\",\"emptyWhen\":[\"noFeaturedProducts\"]},{\"id\":\"section_3\",\"label\":\"Exhibitions & fairs\",\"dataSource\":\"showcaseFirst.section3\"}]",
             "ownerDefaultLayout": "showcaseFirst",
             "brandAccent": "#B0511F",
             "copy": "{\"home.aboutTitle\":\"About the studio\",\"home.contactCta\":\"Get in touch\",\"home.exhibitionsTitle\":\"Exhibitions & fairs\",\"home.onboardingBody\":\"Browse the latest work, pick up a print, and catch the next exhibition — all in one place.\",\"home.printsTitle\":\"Prints & editions\",\"home.viewWorkCta\":\"View all work\",\"home.workSubtitle\":\"The latest pieces, straight from the studio.\",\"home.workTitle\":\"Selected work\"}"

package/templates/portfolio-creative/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/portfolio-creative/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/portfolio-creative-owner/dev/index.ts

@@ -49676,7 +49676,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiOwnerLiteHome.load",
           "params": {
             "copy": "{\"ownerHome.acrossBusiness\":\"Across the practice\",\"ownerHome.briefCta\":\"Show me the studio\",\"ownerHome.briefSubtitle\":\"Which shoot is next, which print orders are waiting on the framer, and what’s still sitting unpublished in the journal.\",\"ownerHome.briefTitle\":\"In the studio today\",\"ownerHome.errorLabel\":\"Couldn’t load the studio\",\"ownerHome.headerSubtitle\":\"Studio · commissions and prints\",\"ownerHome.openManage\":\"Open the practice\",\"ownerHome.ordersDaily\":\"Print sales · daily\",\"ownerHome.statAppointments\":\"Sessions booked\",\"ownerHome.statOrders\":\"Print orders\",\"ownerHome.statPosts\":\"Journal entries\",\"ownerHome.statProducts\":\"Prints for sale\",\"ownerHome.statRevenue\":\"Earned\",\"ownerHome.statSites\":\"Studios\",\"ownerHome.switchBusiness\":\"Switch studio\"}",
-            "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/portfolio-creative-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/portfolio-creative-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/restaurant/dev/index.ts

@@ -1903,7 +1903,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiBrandedHome.refresh",
           "params": {
             "verticals": "[\"restaurants\",\"events\",\"blog\"]",
-            "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\"},{\"id\":\"section_0\",\"label\":\"__HIMI_APP_NAME__\",\"dataSource\":\"menuFirst.section0\"},{\"id\":\"section_1\",\"label\":\"Discover 2\",\"dataSource\":\"menuFirst.section1\"},{\"id\":\"section_2\",\"label\":\"Popular dishes\",\"dataSource\":\"menuFirst.section2\"},{\"id\":\"section_3\",\"label\":\"Find us\",\"dataSource\":\"menuFirst.section3\"}]",
+            "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\",\"emptyWhen\":[\"noSavedContent\"]},{\"id\":\"section_0\",\"label\":\"__HIMI_APP_NAME__\",\"dataSource\":\"menuFirst.section0\",\"emptyWhen\":[\"hasDishHeroImage\"]},{\"id\":\"section_1\",\"label\":\"Discover 2\",\"dataSource\":\"menuFirst.section1\",\"emptyWhen\":[\"noMenuCategories\"]},{\"id\":\"section_2\",\"label\":\"Popular dishes\",\"dataSource\":\"menuFirst.section2\",\"emptyWhen\":[\"noPopularDishes\"]},{\"id\":\"section_3\",\"label\":\"Find us\",\"dataSource\":\"menuFirst.section3\"}]",
             "ownerDefaultLayout": "menuFirst",
             "brandAccent": "#B8544A",
             "copy": "{\"home.eventsTitle\":\"Wine nights & events\",\"home.findUsTitle\":\"Find us\",\"home.hoursTitle\":\"Opening hours\",\"home.onboardingBody\":\"Browse the menu, reserve a table, and keep up with wine nights and kitchen news — all in one place.\",\"home.popularSubtitle\":\"The plates everyone keeps coming back for.\",\"home.popularTitle\":\"Popular dishes\",\"home.reserveCta\":\"Reserve a table\"}"

package/templates/restaurant/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/restaurant/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/restaurant-owner/dev/index.ts

@@ -49747,7 +49747,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiOwnerLiteHome.load",
           "params": {
             "copy": "{\"ownerHome.acrossBusiness\":\"Across the venue\",\"ownerHome.briefCta\":\"Show me service\",\"ownerHome.briefSubtitle\":\"Covers booked, online orders still open, what’s 86’d on the menu, and who’s coming to the next wine night.\",\"ownerHome.briefTitle\":\"Tonight’s service\",\"ownerHome.errorLabel\":\"Couldn’t load tonight’s service\",\"ownerHome.headerSubtitle\":\"Owner · tonight’s service\",\"ownerHome.openManage\":\"Open front of house\",\"ownerHome.ordersDaily\":\"Online orders · daily\",\"ownerHome.statAppointments\":\"Covers booked\",\"ownerHome.statEvents\":\"Wine nights ahead\",\"ownerHome.statOrders\":\"Online orders\",\"ownerHome.statPosts\":\"Kitchen notes\",\"ownerHome.statProducts\":\"Menu items\",\"ownerHome.statRevenue\":\"Takings\",\"ownerHome.statSites\":\"Venues\",\"ownerHome.switchBusiness\":\"Switch venue\"}",
-            "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\",\"events\",\"members\",\"reviews\",\"reservations\"]"
           }
         }

package/templates/restaurant-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/restaurant-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/retail-store/dev/index.ts

@@ -1390,7 +1390,7 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiBrandedHome.refresh",
           "params": {
             "verticals": "[\"store\",\"blog\"]",
-            "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\"},{\"id\":\"section_0\",\"label\":\"Shop the collection\",\"dataSource\":\"storeFirst.section0\"},{\"id\":\"section_1\",\"label\":\"Explore\",\"dataSource\":\"storeFirst.section1\"},{\"id\":\"section_2\",\"label\":\"Shop\",\"dataSource\":\"storeFirst.section2\"}]",
+            "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\",\"emptyWhen\":[\"noSavedContent\"]},{\"id\":\"section_0\",\"label\":\"Shop the collection\",\"dataSource\":\"storeFirst.section0\"},{\"id\":\"section_1\",\"label\":\"Explore\",\"dataSource\":\"storeFirst.section1\"},{\"id\":\"section_2\",\"label\":\"Shop\",\"dataSource\":\"storeFirst.section2\"}]",
             "ownerDefaultLayout": "storeFirst",
             "brandAccent": "#B4552D"
           }