@jskit-ai/shell-web 0.1.64 → 0.1.66

package/test/provider.test.js

@@ -1,7 +1,10 @@
 import assert from "node:assert/strict";
 import test from "node:test";
 import { createPinia } from "pinia";
-import { ShellWebClientProvider } from "../src/client/providers/ShellWebClientProvider.js";
+import {
+  ShellWebClientProvider,
+  resolveAppPlacementTopologyExport
+} from "../src/client/providers/ShellWebClientProvider.js";
 import { useShellErrorPresentationStore } from "../src/client/stores/useShellErrorPresentationStore.js";
 const CLIENT_APP_CONFIG_GLOBAL_KEY = "__JSKIT_CLIENT_APP_CONFIG__";
 
@@ -14,7 +17,7 @@ function setClientAppConfig(source = {}) {
   return normalized;
 }
 
-function createAppDouble({ surfaceRuntime = null } = {}) {
+function createAppDouble({ surfaceRuntime = null, queryClient = null } = {}) {
   const singletons = new Map();
   const singletonInstances = new Map();
   const provided = [];
@@ -61,6 +64,9 @@ function createAppDouble({ surfaceRuntime = null } = {}) {
       if (token === "jskit.client.surface.runtime") {
         return Boolean(surfaceRuntime);
       }
+      if (token === "jskit.client.query-client") {
+        return Boolean(queryClient);
+      }
       return singletons.has(token) || singletonInstances.has(token);
     },
     make(token) {
@@ -73,6 +79,9 @@ function createAppDouble({ surfaceRuntime = null } = {}) {
       if (token === "jskit.client.surface.runtime" && surfaceRuntime) {
         return surfaceRuntime;
       }
+      if (token === "jskit.client.query-client" && queryClient) {
+        return queryClient;
+      }
       if (singletonInstances.has(token)) {
         return singletonInstances.get(token);
       }
@@ -125,6 +134,32 @@ async function withFetchImplementation(fetchImplementation, callback) {
   }
 }
 
+test("shell web client provider preserves append-only placement topology object exports", () => {
+  const warnings = [];
+  const topology = {
+    placements: [
+      {
+        id: "shell.primary-nav",
+        surfaces: ["*"],
+        variants: {
+          compact: { outlet: "shell-layout:primary-menu" },
+          medium: { outlet: "shell-layout:primary-menu" },
+          expanded: { outlet: "shell-layout:primary-menu" }
+        }
+      }
+    ]
+  };
+
+  const resolved = resolveAppPlacementTopologyExport(topology, {
+    warn(payload, message) {
+      warnings.push({ payload, message });
+    }
+  });
+
+  assert.equal(resolved, topology);
+  assert.deepEqual(warnings, []);
+});
+
 test("shell web client provider binds runtime and injects it into Vue app", async () => {
   await withFetchStub({ surfaceAccess: {} }, async () => {
     const app = createAppDouble();
@@ -134,15 +169,15 @@ test("shell web client provider binds runtime and injects it into Vue app", asyn
     assert.equal(app.singletons.has("runtime.web-placement.client"), true);
     assert.equal(app.singletons.has("runtime.web-error.client"), true);
     assert.equal(app.singletons.has("runtime.web-error.presentation-store.client"), true);
+    assert.equal(app.singletons.has("runtime.web-refresh.client"), true);
 
     await provider.boot(app);
-    assert.equal(app.plugins.length, 1);
-    assert.equal(typeof app.plugins[0].plugin.install, "function");
-    assert.equal(typeof app.plugins[0].options?.queryClient, "object");
+    assert.equal(app.plugins.length, 0);
 
     const providedByKey = new Map(app.provided.map((entry) => [entry.key, entry.value]));
 
     assert.equal(providedByKey.has("jskit.shell-web.runtime.web-placement.client"), true);
+    assert.equal(providedByKey.has("jskit.shell-web.runtime.web-refresh.client"), true);
     assert.equal(providedByKey.has("jskit.shell-web.runtime.web-error.client"), true);
     assert.equal(providedByKey.has("jskit.shell-web.runtime.web-error.presentation-store.client"), true);
 
@@ -156,6 +191,9 @@ test("shell web client provider binds runtime and injects it into Vue app", asyn
     assert.equal(typeof errorRuntime.report, "function");
     assert.equal(typeof errorRuntime.configure, "function");
 
+    const refreshRuntime = providedByKey.get("jskit.shell-web.runtime.web-refresh.client");
+    assert.equal(typeof refreshRuntime.refresh, "function");
+
     const errorStore = providedByKey.get("jskit.shell-web.runtime.web-error.presentation-store.client");
     assert.equal(typeof errorStore.getState, "function");
     assert.equal(typeof errorStore.present, "function");
@@ -168,6 +206,60 @@ test("shell web client provider binds runtime and injects it into Vue app", asyn
   });
 });
 
+test("shell refresh runtime refreshes bootstrap and active queries by default", async () => {
+  await withFetchStub({ surfaceAccess: { home: true } }, async () => {
+    const refetchCalls = [];
+    const queryClient = {
+      async refetchQueries(filters = {}, options = {}) {
+        refetchCalls.push({ filters, options });
+      }
+    };
+    const app = createAppDouble({ queryClient });
+    const provider = new ShellWebClientProvider();
+    provider.register(app);
+
+    const refreshRuntime = app.make("runtime.web-refresh.client");
+    const result = await refreshRuntime.refresh("test-refresh");
+
+    assert.equal(result.reason, "test-refresh");
+    assert.equal(result.bootstrapRefreshed, true);
+    assert.equal(result.queriesRefetched, true);
+    assert.equal(refetchCalls.length, 1);
+    assert.equal(refetchCalls[0].filters.type, "active");
+    assert.equal(refetchCalls[0].options.throwOnError, false);
+    assert.equal(refetchCalls[0].filters.predicate({}), true);
+    assert.equal(refetchCalls[0].filters.predicate({ meta: {} }), true);
+    assert.equal(refetchCalls[0].filters.predicate({ meta: { jskit: { refreshOnPull: true } } }), true);
+    assert.equal(refetchCalls[0].filters.predicate({ meta: { jskitRefresh: "pull" } }), true);
+    assert.equal(refetchCalls[0].filters.predicate({ meta: { jskit: { refreshOnPull: false } } }), false);
+    assert.equal(refetchCalls[0].filters.predicate({ meta: { jskitRefresh: false } }), false);
+  });
+});
+
+test("shell refresh runtime reports recoverable retry errors as banners", async () => {
+  await withFetchStub({ surfaceAccess: { home: true } }, async () => {
+    const queryClient = {
+      async refetchQueries() {
+        throw new Error("Network unavailable");
+      }
+    };
+    const app = createAppDouble({ queryClient });
+    const provider = new ShellWebClientProvider();
+    provider.register(app);
+
+    const refreshRuntime = app.make("runtime.web-refresh.client");
+    const result = await refreshRuntime.refresh("test-refresh");
+
+    assert.equal(result.error instanceof Error, true);
+
+    const errorStore = app.make("runtime.web-error.presentation-store.client");
+    const state = errorStore.getState();
+    assert.equal(state.channels.banner.length, 1);
+    assert.equal(state.channels.banner[0].message, "Unable to refresh. Check the connection and try again.");
+    assert.equal(state.channels.banner[0].action.label, "Retry");
+  });
+});
+
 test("shell web client provider resolves surface config from client app config", async () => {
   setClientAppConfig({
     tenancyMode: "workspaces",

package/test/settingsPlacementContract.test.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import test from "node:test";
 import { readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
+import { assertGeneratedUiSourceContract } from "@jskit-ai/kernel/shared/support/generatedUiContract";
 import descriptor from "../package.descriptor.mjs";
 
 const TEST_DIRECTORY = path.dirname(fileURLToPath(import.meta.url));
@@ -24,6 +25,18 @@ function readContributions(target = "") {
     : [];
 }
 
+function readTopology(id = "", owner = "") {
+  const placements = descriptor?.metadata?.ui?.placements?.topology?.placements;
+  const normalizedId = String(id || "").trim();
+  const normalizedOwner = String(owner || "").trim();
+  return Array.isArray(placements)
+    ? placements.filter((entry) =>
+        String(entry?.id || "").trim() === normalizedId &&
+        String(entry?.owner || "").trim() === normalizedOwner
+      )
+    : [];
+}
+
 function findFileMutation(id) {
   const files = descriptor?.mutations?.files;
   return Array.isArray(files)
@@ -35,10 +48,121 @@ test("shell-web home settings template exposes surface-derived settings outlets"
   const source = await readFile(path.join(PACKAGE_DIR, "templates", "src", "pages", "home", "settings.vue"), "utf8");
 
   assert.match(source, /target="home-settings:primary-menu"/);
-  assert.match(source, /default-link-component-token="local\.main\.ui\.surface-aware-menu-link-item"/);
+  assert.match(source, /generated-ui-screen generated-ui-screen--settings settings-shell/);
+  assert.match(source, /--generated-ui-screen-title-size/);
+  assert.doesNotMatch(source, /default-link-component-token/);
   assert.match(source, /<RouterView \/>/);
 });
 
+test("shell-web shell layout registers navigation at the app layout level", async () => {
+  const source = await readFile(path.join(PACKAGE_DIR, "src", "client", "components", "ShellLayout.vue"), "utf8");
+
+  assert.doesNotMatch(source, /<v-layout\b/);
+  assert.doesNotMatch(source, /overflow-hidden/);
+  assert.doesNotMatch(source, /min-height:\s*72vh/);
+  assert.match(source, /ShellRouteTransition/);
+  assert.match(source, /<ShellRouteTransition>[\s\S]*<slot \/>[\s\S]*<\/ShellRouteTransition>/);
+  assert.match(source, /data-testid="jskit-shell-app-bar"/);
+  assert.match(source, /:density="isCompactLayout \? 'compact' : 'comfortable'"/);
+  assert.match(source, /shell-layout__surface-label/);
+  assert.doesNotMatch(source, /shell-layout__surface-chip/);
+  assert.doesNotMatch(source, /<v-chip[^>]*resolvedSurfaceLabel/);
+  assert.match(source, /shell-layout__top-right[\s\S]*max-width:\s*min\(45vw, 18rem\)/);
+  assert.match(source, /<v-bottom-navigation[\s\S]*target="shell-layout:primary-bottom-nav"/);
+  assert.match(source, /<v-bottom-sheet[\s\S]*target="shell-layout:supporting-bottom-sheet"/);
+  assert.match(source, /target="shell-layout:supporting-side-panel"/);
+  assert.match(source, /data-testid="jskit-shell-supporting-bottom-sheet"/);
+  assert.match(source, /data-testid="jskit-shell-supporting-side-panel"/);
+  assert.match(source, /inject\("jskit\.shell-web\.runtime\.web-refresh\.client", null\)/);
+  assert.match(source, /window\.addEventListener\("pointerdown", handlePullPointerDown/);
+  assert.match(source, /window\.addEventListener\("touchmove", handlePullTouchMove/);
+  assert.match(source, /refreshRuntime\.refresh\("pull-to-refresh"\)/);
+  assert.match(source, /data-testid="jskit-shell-pull-refresh"/);
+  assert.match(source, /target="shell-layout:primary-menu"[\s\S]*default/);
+  assert.doesNotMatch(source, /target="shell-layout:primary-bottom-nav"[\s\S]*default/);
+  assert.match(source, /data-testid="jskit-shell-drawer"/);
+  assert.match(source, /data-testid="jskit-shell-bottom-nav"/);
+  assert.match(source, /padding:\s*0\.75rem 1rem calc\(1rem \+ env\(safe-area-inset-bottom, 0px\)\)/);
+
+  const template = await readFile(path.join(PACKAGE_DIR, "templates", "src", "components", "ShellLayout.vue"), "utf8");
+
+  assert.match(template, /PackageShellLayout from "@jskit-ai\/shell-web\/client\/components\/ShellLayout"/);
+  assert.match(template, /h\(PackageShellLayout, attrs, slots\)/);
+  assert.doesNotMatch(template, /ShellOutlet|ShellRouteTransition|useShellLayoutState|pointerdown|v-navigation-drawer|v-bottom-navigation/);
+});
+
+test("shell-web error host uses one explicit close affordance for banner errors", async () => {
+  const source = await readFile(path.join(PACKAGE_DIR, "src", "client", "components", "ShellErrorHost.vue"), "utf8");
+
+  assert.match(source, /function resolveSeverityIcon/);
+  assert.match(source, /mdi-alert-outline/);
+  assert.match(source, /:icon="resolveSeverityIcon\(entry\.severity\)"/);
+  assert.match(source, /closable[\s\S]*@click:close="dismiss\(entry\)"/);
+  assert.doesNotMatch(source, /mdi-close/);
+});
+
+test("shell-web error host keeps snackbar color stable while closing", async () => {
+  const source = await readFile(path.join(PACKAGE_DIR, "src", "client", "components", "ShellErrorHost.vue"), "utf8");
+
+  assert.match(source, /displayedSnackbarEntry/);
+  assert.match(source, /@after-leave="onSnackbarAfterLeave"/);
+  assert.match(source, /:color="displayedSnackbarEntry \? resolveSeverityColor\(displayedSnackbarEntry\.severity\) : undefined"/);
+  assert.doesNotMatch(source, /resolveSeverityColor\(snackbarEntry\?\.severity\)/);
+});
+
+test("shell-web error template uses intent-driven default presentation", async () => {
+  const source = await readFile(path.join(PACKAGE_DIR, "templates", "src", "error.js"), "utf8");
+
+  assert.match(source, /resourceLoadChannel:\s*"silent"/);
+  assert.match(source, /actionFeedbackChannel:\s*"snackbar"/);
+  assert.match(source, /appRecoverableChannel:\s*"banner"/);
+  assert.match(source, /blockingChannel:\s*"dialog"/);
+});
+
+test("shell-web installs generated adaptive shell Playwright smoke coverage", async () => {
+  const source = await readFile(path.join(PACKAGE_DIR, "templates", "tests", "e2e", "adaptive-shell.spec.ts"), "utf8");
+  const helperSource = await readFile(path.join(PACKAGE_DIR, "src", "test", "adaptiveShellSmoke.js"), "utf8");
+
+  assertGeneratedUiSourceContract(helperSource, {
+    profile: "responsive-smoke",
+    sourceName: "adaptiveShellSmoke.js"
+  });
+  assert.match(source, /runAdaptiveShellSmoke/);
+  assert.match(source, /@jskit-ai\/shell-web\/test\/adaptiveShellSmoke/);
+  assert.match(helperSource, /generated adaptive shell smoke/);
+  assert.match(helperSource, /390/);
+  assert.match(helperSource, /768/);
+  assert.match(helperSource, /1280/);
+  assert.match(helperSource, /jskit-shell-bottom-nav/);
+  assert.match(helperSource, /jskit-shell-drawer/);
+  assert.match(helperSource, /scrollWidth/);
+  assert.match(helperSource, /toBeGreaterThanOrEqual\(48\)/);
+
+  const packageJson = JSON.parse(await readFile(path.join(PACKAGE_DIR, "package.json"), "utf8"));
+  assert.equal(packageJson?.exports?.["./test/adaptiveShellSmoke"], "./src/test/adaptiveShellSmoke.js");
+});
+
+test("shell-web route transition keeps mobile route motion placement-driven", async () => {
+  const source = await readFile(
+    path.join(PACKAGE_DIR, "src", "client", "components", "ShellRouteTransition.vue"),
+    "utf8"
+  );
+
+  assert.match(source, /target:\s*\{[\s\S]*default:\s*"shell-layout:primary-bottom-nav"/);
+  assert.match(source, /semanticTarget:\s*\{[\s\S]*default:\s*"shell\.primary-nav"/);
+  assert.match(source, /placementRuntime\s*\.\s*getPlacements/);
+  assert.match(source, /useRouter\(\)/);
+  assert.match(source, /swipeEnabled:\s*\{[\s\S]*default:\s*true/);
+  assert.match(source, /window\.addEventListener\("pointerdown", handlePointerDown/);
+  assert.match(source, /document\.documentElement\.classList\.toggle\("shell-route-swipe-enabled", enabled\)/);
+  assert.match(source, /navigateBySwipe\(deltaX < 0 \? 1 : -1\)/);
+  assert.match(source, /router\.push\(nextEntry\.href\)/);
+  assert.match(source, /isSwipeIgnoredTarget/);
+  assert.match(source, /touch-action:\s*pan-y/);
+  assert.match(source, /transitionDirection\.value = nextIndex > previousIndex \? "forward" : "reverse"/);
+  assert.match(source, /prefers-reduced-motion:\s*reduce/);
+});
+
 test("shell-web settings landing page redirects to the starter child page", async () => {
   const source = await readFile(path.join(PACKAGE_DIR, "templates", "src", "pages", "home", "settings", "index.vue"), "utf8");
 
@@ -47,24 +171,28 @@ test("shell-web settings landing page redirects to the starter child page", asyn
   assert.match(source, /redirectToChild\("general"\)/);
 });
 
-test("shell-web settings general child page exposes a tiny browser-local drawer preference", async () => {
+test("shell-web settings general child page exposes an adaptive drawer preference", async () => {
   const source = await readFile(
     path.join(PACKAGE_DIR, "templates", "src", "pages", "home", "settings", "general", "index.vue"),
     "utf8"
   );
 
   assert.match(source, /useShellLayoutState/);
+  assert.match(source, /generated-ui-screen generated-ui-screen--settings settings-general-screen/);
   assert.match(source, /drawerDefaultOpen/);
   assert.match(source, /setDrawerDefaultOpen/);
-  assert.match(source, /Open navigation drawer by default/);
-  assert.match(source, /live in this browser only/);
+  assert.match(source, /Phone layouts keep primary navigation in the bottom bar/);
+  assert.match(source, /Open drawer by default on wider screens/);
+  assert.match(source, /min-height:\s*48px/);
+  assert.doesNotMatch(source, /live in this browser only|tiny example|starter settings/);
 });
 
-test("shell-web placement template seeds default Home and Settings drawer navigation", async () => {
+test("shell-web placement template seeds default Home and Settings adaptive navigation", async () => {
   const source = await readFile(path.join(PACKAGE_DIR, "templates", "src", "placement.js"), "utf8");
 
   assert.match(source, /id: "shell-web\.home\.menu\.home"/);
-  assert.match(source, /target: "shell-layout:primary-menu"/);
+  assert.match(source, /target: "shell\.primary-nav"/);
+  assert.match(source, /kind: "link"/);
   assert.match(source, /surfaces: \["home"\]/);
   assert.match(source, /label: "Home"/);
   assert.match(source, /unscopedSuffix: "\/"/);
@@ -72,19 +200,64 @@ test("shell-web placement template seeds default Home and Settings drawer naviga
   assert.match(source, /label: "Settings"/);
   assert.match(source, /unscopedSuffix: "\/settings"/);
   assert.match(source, /id: "shell-web\.home\.settings\.general"/);
-  assert.match(source, /target: "home-settings:primary-menu"/);
+  assert.match(source, /target: "page\.section-nav"/);
+  assert.match(source, /owner: "home-settings"/);
   assert.match(source, /label: "General"/);
   assert.match(source, /unscopedSuffix: "\/settings\/general"/);
   assert.doesNotMatch(source, /to: "\.\/general"/);
 });
 
-test("shell-web descriptor metadata advertises home settings outlets, default drawer links, and installs the scaffold page", () => {
+test("shell-web placement topology seeds global actions as a semantic shell placement", async () => {
+  const source = await readFile(path.join(PACKAGE_DIR, "templates", "src", "placementTopology.js"), "utf8");
+
+  assert.match(source, /id: "shell\.global-actions"/);
+  assert.match(source, /description: "Global surface actions that should stay outside primary navigation\."/);
+  assert.match(source, /outlet: "shell-layout:top-right"/);
+  assert.match(source, /renderers: menuLinkRenderers/);
+  assert.match(source, /id: "page\.supporting-content"/);
+  assert.match(source, /outlet: "shell-layout:supporting-bottom-sheet"/);
+  assert.match(source, /outlet: "shell-layout:supporting-side-panel"/);
+});
+
+test("shell-web descriptor metadata advertises adaptive shell outlets, default links, and installs the scaffold page", () => {
+  assert.deepEqual(
+    readOutlets("shell-layout:primary-bottom-nav"),
+    [
+      {
+        target: "shell-layout:primary-bottom-nav",
+        surfaces: ["*"],
+        source: "src/client/components/ShellLayout.vue"
+      }
+    ]
+  );
+
+  assert.deepEqual(
+    readOutlets("shell-layout:supporting-bottom-sheet"),
+    [
+      {
+        target: "shell-layout:supporting-bottom-sheet",
+        surfaces: ["*"],
+        source: "src/client/components/ShellLayout.vue"
+      }
+    ]
+  );
+
+  assert.deepEqual(
+    readOutlets("shell-layout:supporting-side-panel"),
+    [
+      {
+        target: "shell-layout:supporting-side-panel",
+        surfaces: ["*"],
+        source: "src/client/components/ShellLayout.vue"
+      }
+    ]
+  );
+
   assert.deepEqual(
     readOutlets("home-settings:primary-menu"),
     [
       {
         target: "home-settings:primary-menu",
-        defaultLinkComponentToken: "local.main.ui.surface-aware-menu-link-item",
         surfaces: ["home"],
         source: "templates/src/pages/home/settings.vue"
       }
@@ -92,41 +265,66 @@ test("shell-web descriptor metadata advertises home settings outlets, default dr
   );
 
   assert.deepEqual(
-    readContributions("shell-layout:primary-menu"),
+    readContributions("shell.primary-nav"),
     [
       {
         id: "shell-web.home.menu.home",
-        target: "shell-layout:primary-menu",
+        target: "shell.primary-nav",
+        kind: "link",
         surfaces: ["home"],
         order: 50,
-        componentToken: "local.main.ui.surface-aware-menu-link-item",
         source: "templates/src/placement.js"
       },
       {
         id: "shell-web.home.menu.settings",
-        target: "shell-layout:primary-menu",
+        target: "shell.primary-nav",
+        kind: "link",
         surfaces: ["home"],
         order: 100,
-        componentToken: "local.main.ui.surface-aware-menu-link-item",
         source: "templates/src/placement.js"
       }
     ]
   );
 
   assert.deepEqual(
-    readContributions("home-settings:primary-menu"),
+    readContributions("page.section-nav"),
     [
       {
         id: "shell-web.home.settings.general",
-        target: "home-settings:primary-menu",
+        target: "page.section-nav",
+        owner: "home-settings",
+        kind: "link",
         surfaces: ["home"],
         order: 100,
-        componentToken: "local.main.ui.surface-aware-menu-link-item",
         source: "templates/src/placement.js"
       }
     ]
   );
 
+  assert.equal(readTopology("shell.primary-nav").length, 1);
+  assert.equal(readTopology("shell.primary-nav")[0]?.variants?.compact?.outlet, "shell-layout:primary-bottom-nav");
+  assert.equal(
+    readTopology("shell.primary-nav")[0]?.variants?.compact?.renderers?.link,
+    "local.main.ui.tab-link-item"
+  );
+  assert.equal(readTopology("shell.primary-nav")[0]?.variants?.medium?.outlet, "shell-layout:primary-menu");
+  assert.equal(readTopology("shell.global-actions").length, 1);
+  assert.equal(readTopology("shell.global-actions")[0]?.variants?.compact?.outlet, "shell-layout:top-right");
+  assert.equal(
+    readTopology("shell.global-actions")[0]?.variants?.compact?.renderers?.link,
+    "local.main.ui.surface-aware-menu-link-item"
+  );
+  assert.equal(readTopology("page.section-nav", "home-settings").length, 1);
+  assert.equal(readTopology("page.supporting-content").length, 1);
+  assert.equal(
+    readTopology("page.supporting-content")[0]?.variants?.compact?.outlet,
+    "shell-layout:supporting-bottom-sheet"
+  );
+  assert.equal(
+    readTopology("page.supporting-content")[0]?.variants?.expanded?.outlet,
+    "shell-layout:supporting-side-panel"
+  );
+
   assert.deepEqual(findFileMutation("shell-web-page-home-settings-shell"), {
     from: "templates/src/pages/home/settings.vue",
     toSurface: "home",
@@ -156,13 +354,29 @@ test("shell-web descriptor metadata advertises home settings outlets, default dr
     category: "shell-web",
     id: "shell-web-page-home-settings-general"
   });
+
+  assert.deepEqual(findFileMutation("shell-web-test-adaptive-shell-smoke"), {
+    from: "templates/tests/e2e/adaptive-shell.spec.ts",
+    to: "tests/e2e/adaptive-shell.spec.ts",
+    ownership: "app",
+    reason: "Install compact/medium/expanded Playwright smoke coverage for the adaptive shell.",
+    category: "shell-web",
+    id: "shell-web-test-adaptive-shell-smoke"
+  });
 });
 
-test("shell-web home starter page relies on drawer navigation instead of dead feature buttons", async () => {
+test("shell-web home starter page relies on adaptive shell navigation instead of dead feature buttons", async () => {
   const source = await readFile(path.join(PACKAGE_DIR, "templates", "src", "pages", "home", "index.vue"), "utf8");
 
-  assert.match(source, /Use the navigation drawer to move around the shell\./);
-  assert.doesNotMatch(source, /\/home\/settings/);
+  assertGeneratedUiSourceContract(source, {
+    profile: "shell-home",
+    sourceName: "shell-web home/index.vue"
+  });
+  assert.match(source, /generated-ui-screen generated-ui-screen--app home-surface-screen/);
+  assert.match(source, /--generated-ui-screen-title-size/);
+  assert.match(source, /Core services are available\./);
+  assert.match(source, /to="\/home\/settings\/general"/);
+  assert.doesNotMatch(source, /Use bottom navigation|Replace this content|Main public surface/);
   assert.doesNotMatch(source, /\/console/);
   assert.doesNotMatch(source, /\/auth\/signout/);
 });

package/test/useShellLayoutState.test.js

@@ -65,3 +65,22 @@ test("shell layout store keeps drawer state and default preference in sync", ()
   store.setDrawerOpen(false);
   assert.equal(store.drawerOpen, false);
 });
+
+test("shell layout store keeps supporting content closed until explicitly opened", () => {
+  const pinia = createPinia();
+  const store = useShellLayoutStore(pinia);
+
+  assert.equal(store.supportingContentOpen, false);
+  assert.equal(store.supportingContentTitle, "");
+
+  store.openSupportingContent({ title: "Customer details" });
+  assert.equal(store.supportingContentOpen, true);
+  assert.equal(store.supportingContentTitle, "Customer details");
+
+  store.setSupportingContentOpen(false);
+  assert.equal(store.supportingContentOpen, false);
+  assert.equal(store.supportingContentTitle, "Customer details");
+
+  store.closeSupportingContent();
+  assert.equal(store.supportingContentOpen, false);
+});