@jskit-ai/shell-web 0.1.120 → 0.1.123

package/package.descriptor.mjs

@@ -1,7 +1,7 @@
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/shell-web",
-  version: "0.1.120",
+  version: "0.1.123",
   kind: "runtime",
   description: "Web shell layout runtime with outlet-based placement contributions.",
   dependsOn: [],
@@ -311,9 +311,11 @@ export default Object.freeze({
     dependencies: {
       runtime: {
         "@mdi/js": "^7.4.47",
-        "@jskit-ai/kernel": "0.1.121"
+        "@jskit-ai/kernel": "0.1.122"
       },
-      dev: {}
+      dev: {
+        "@playwright/test": "1.61.1"
+      }
     },
     packageJson: {
       scripts: {
@@ -456,7 +458,11 @@ export default Object.freeze({
         expectedExistingFrom: "templates/expected-existing/src/pages/home.vue",
         reason: "Install shell-driven home wrapper page.",
         category: "shell-web",
-        id: "shell-web-page-home-wrapper"
+        id: "shell-web-page-home-wrapper",
+        when: {
+          config: "surfaceDefinitions.home.enabled",
+          equals: "true"
+        }
       },
       {
         from: "templates/src/pages/home/index.vue",
@@ -466,7 +472,11 @@ export default Object.freeze({
         expectedExistingFrom: "templates/expected-existing/src/pages/home/index.vue",
         reason: "Install shell-driven home surface starter page.",
         category: "shell-web",
-        id: "shell-web-page-home"
+        id: "shell-web-page-home",
+        when: {
+          config: "surfaceDefinitions.home.enabled",
+          equals: "true"
+        }
       },
       {
         from: "templates/src/pages/home/settings.vue",
@@ -475,7 +485,11 @@ export default Object.freeze({
         ownership: "app",
         reason: "Install shell-driven home settings shell route with section navigation.",
         category: "shell-web",
-        id: "shell-web-page-home-settings-shell"
+        id: "shell-web-page-home-settings-shell",
+        when: {
+          config: "surfaceDefinitions.home.enabled",
+          equals: "true"
+        }
       },
       {
         from: "templates/src/pages/home/settings/index.vue",
@@ -484,7 +498,11 @@ export default Object.freeze({
         ownership: "app",
         reason: "Install shell-driven home settings redirect so the starter settings shell lands on a real child page.",
         category: "shell-web",
-        id: "shell-web-page-home-settings"
+        id: "shell-web-page-home-settings",
+        when: {
+          config: "surfaceDefinitions.home.enabled",
+          equals: "true"
+        }
       },
       {
         from: "templates/src/pages/home/settings/general/index.vue",
@@ -493,7 +511,11 @@ export default Object.freeze({
         ownership: "app",
         reason: "Install shell-driven general settings child page with a tiny browser-local shell preference example.",
         category: "shell-web",
-        id: "shell-web-page-home-settings-general"
+        id: "shell-web-page-home-settings-general",
+        when: {
+          config: "surfaceDefinitions.home.enabled",
+          equals: "true"
+        }
       },
       {
         from: "templates/tests/e2e/adaptive-shell.spec.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/shell-web",
-  "version": "0.1.120",
+  "version": "0.1.123",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@mdi/js": "^7.4.47",
-    "@jskit-ai/kernel": "0.1.121"
+    "@jskit-ai/kernel": "0.1.122"
   },
   "peerDependencies": {
     "pinia": "^3.0.4",

package/src/test/adaptiveShellSmoke.js

@@ -1,4 +1,3 @@
-const DEFAULT_BASE_URL = String(process.env.PLAYWRIGHT_BASE_URL || "http://127.0.0.1:5173").replace(/\/+$/u, "");
 const DEFAULT_SMOKE_PATH = String(process.env.JSKIT_PLAYWRIGHT_SMOKE_PATH || "/home");
 const DEFAULT_VIEWPORTS = Object.freeze([
   Object.freeze({ name: "compact", width: 390, height: 844 }),
@@ -72,7 +71,6 @@ async function isElementVisibleInViewport(page, testId) {
 function runAdaptiveShellSmoke({
   test,
   expect,
-  baseUrl = DEFAULT_BASE_URL,
   smokePath = DEFAULT_SMOKE_PATH,
   viewports = DEFAULT_VIEWPORTS
 } = {}) {
@@ -84,7 +82,7 @@ function runAdaptiveShellSmoke({
     for (const viewport of viewports) {
       test(`${viewport.name} layout has reachable navigation and no horizontal overflow`, async ({ page }) => {
         await page.setViewportSize({ width: viewport.width, height: viewport.height });
-        await page.goto(`${baseUrl}${smokePath}`);
+        await page.goto(smokePath);
         await expect(page.locator("body")).toBeVisible();
         await expectGeneratedScreenContract(page, expect);
         await expectNoHorizontalOverflow(page, expect);

package/test/bootstrapClaimContract.test.js

@@ -34,7 +34,11 @@ test("shell-web claims starter shell files as app-owned scaffolds", () => {
     expectedExistingFrom: "templates/expected-existing/src/pages/home.vue",
     reason: "Install shell-driven home wrapper page.",
     category: "shell-web",
-    id: "shell-web-page-home-wrapper"
+    id: "shell-web-page-home-wrapper",
+    when: {
+      config: "surfaceDefinitions.home.enabled",
+      equals: "true"
+    }
   });
   assert.deepEqual(findFileMutation("shell-web-page-home"), {
     from: "templates/src/pages/home/index.vue",
@@ -44,7 +48,11 @@ test("shell-web claims starter shell files as app-owned scaffolds", () => {
     expectedExistingFrom: "templates/expected-existing/src/pages/home/index.vue",
     reason: "Install shell-driven home surface starter page.",
     category: "shell-web",
-    id: "shell-web-page-home"
+    id: "shell-web-page-home",
+    when: {
+      config: "surfaceDefinitions.home.enabled",
+      equals: "true"
+    }
   });
 });
 

package/test/playwrightContract.test.js

@@ -0,0 +1,26 @@
+import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+test("shell-web owns the exact Playwright dependency used by its generated smoke", async () => {
+  const descriptor = (await import(`${path.join(PACKAGE_ROOT, "package.descriptor.mjs")}?test=${Date.now()}`)).default;
+  const rootPackage = JSON.parse(await readFile(path.resolve(PACKAGE_ROOT, "../../package.json"), "utf8"));
+
+  assert.equal(descriptor.mutations.dependencies.dev["@playwright/test"], "1.61.1");
+  assert.equal(
+    descriptor.mutations.dependencies.dev["@playwright/test"],
+    rootPackage.devDependencies["@playwright/test"]
+  );
+});
+
+test("adaptive shell smoke navigates through Playwright baseURL", async () => {
+  const source = await readFile(path.join(PACKAGE_ROOT, "src/test/adaptiveShellSmoke.js"), "utf8");
+
+  assert.match(source, /page\.goto\(smokePath\)/u);
+  assert.doesNotMatch(source, /PLAYWRIGHT_BASE_URL/u);
+  assert.doesNotMatch(source, /http:\/\/127\.0\.0\.1/u);
+});

package/test/settingsPlacementContract.test.js

@@ -359,6 +359,20 @@ test("shell-web descriptor pre-optimizes package subpaths reached only through d
 });
 
 test("shell-web descriptor metadata advertises adaptive shell outlets, default links, and installs the scaffold page", () => {
+  const homePageMutationIds = [
+    "shell-web-page-home-wrapper",
+    "shell-web-page-home",
+    "shell-web-page-home-settings-shell",
+    "shell-web-page-home-settings",
+    "shell-web-page-home-settings-general"
+  ];
+  for (const mutationId of homePageMutationIds) {
+    assert.deepEqual(findFileMutation(mutationId)?.when, {
+      config: "surfaceDefinitions.home.enabled",
+      equals: "true"
+    });
+  }
+
   assert.deepEqual(readClientContainerTokens(), [
     "runtime.web-placement.client",
     "runtime.web-bootstrap.client",
@@ -481,7 +495,11 @@ test("shell-web descriptor metadata advertises adaptive shell outlets, default l
     ownership: "app",
     reason: "Install shell-driven home settings shell route with section navigation.",
     category: "shell-web",
-    id: "shell-web-page-home-settings-shell"
+    id: "shell-web-page-home-settings-shell",
+    when: {
+      config: "surfaceDefinitions.home.enabled",
+      equals: "true"
+    }
   });
 
   assert.deepEqual(findFileMutation("shell-web-page-home-settings"), {
@@ -491,7 +509,11 @@ test("shell-web descriptor metadata advertises adaptive shell outlets, default l
     ownership: "app",
     reason: "Install shell-driven home settings redirect so the starter settings shell lands on a real child page.",
     category: "shell-web",
-    id: "shell-web-page-home-settings"
+    id: "shell-web-page-home-settings",
+    when: {
+      config: "surfaceDefinitions.home.enabled",
+      equals: "true"
+    }
   });
 
   assert.deepEqual(findFileMutation("shell-web-page-home-settings-general"), {
@@ -501,7 +523,11 @@ test("shell-web descriptor metadata advertises adaptive shell outlets, default l
     ownership: "app",
     reason: "Install shell-driven general settings child page with a tiny browser-local shell preference example.",
     category: "shell-web",
-    id: "shell-web-page-home-settings-general"
+    id: "shell-web-page-home-settings-general",
+    when: {
+      config: "surfaceDefinitions.home.enabled",
+      equals: "true"
+    }
   });
 
   assert.deepEqual(findFileMutation("shell-web-test-adaptive-shell-smoke"), {