@jskit-ai/shell-web 0.1.24 → 0.1.27

package/package.descriptor.mjs

@@ -1,7 +1,7 @@
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/shell-web",
-  version: "0.1.24",
+  version: "0.1.27",
   kind: "runtime",
   description: "Web shell layout runtime with outlet-based placement contributions.",
   dependsOn: [],
@@ -77,6 +77,18 @@ export default Object.freeze({
             position: "secondary-menu",
             surfaces: ["*"],
             source: "src/client/components/ShellLayout.vue"
+          },
+          {
+            host: "home-settings",
+            position: "primary-menu",
+            surfaces: ["home"],
+            source: "templates/src/pages/home/settings/index.vue"
+          },
+          {
+            host: "home-settings",
+            position: "forms",
+            surfaces: ["home"],
+            source: "templates/src/pages/home/settings/index.vue"
           }
         ],
         contributions: []
@@ -87,7 +99,7 @@ export default Object.freeze({
     dependencies: {
       runtime: {
         "@tanstack/vue-query": "^5.90.5",
-        "@jskit-ai/kernel": "0.1.25",
+        "@jskit-ai/kernel": "0.1.28",
         "vuetify": "^4.0.0"
       },
       dev: {}
@@ -146,6 +158,14 @@ export default Object.freeze({
         category: "shell-web",
         id: "shell-web-page-home"
       },
+      {
+        from: "templates/src/pages/home/settings/index.vue",
+        toSurface: "home",
+        toSurfacePath: "settings/index.vue",
+        reason: "Install shell-driven home settings page scaffold with surface-derived settings outlets.",
+        category: "shell-web",
+        id: "shell-web-page-home-settings"
+      },
       {
         from: "templates/src/pages/console.vue",
         toSurface: "console",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/shell-web",
-  "version": "0.1.24",
+  "version": "0.1.27",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -18,7 +18,7 @@
   },
   "dependencies": {
     "@tanstack/vue-query": "^5.90.5",
-    "@jskit-ai/kernel": "0.1.25",
+    "@jskit-ai/kernel": "0.1.28",
     "vuetify": "^4.0.0"
   }
 }

package/templates/src/pages/home/index.vue

@@ -46,6 +46,7 @@ const health = computed(() => {
         This is your primary landing page. Replace this content with your actual product home.
       </p>
       <div class="d-flex flex-wrap ga-3">
+        <v-btn color="primary" variant="flat" to="/home/settings">Open settings</v-btn>
         <v-btn color="primary" variant="flat" to="/console">Open console surface</v-btn>
         <v-btn color="secondary" variant="outlined" to="/auth/signout">Sign out</v-btn>
       </div>

package/templates/src/pages/home/settings/index.vue

@@ -0,0 +1,17 @@
+<template>
+  <section class="settings-page">
+    <ShellOutlet host="home-settings" position="primary-menu" />
+    <ShellOutlet host="home-settings" position="forms" />
+  </section>
+</template>
+
+<script setup>
+import ShellOutlet from "@jskit-ai/shell-web/client/components/ShellOutlet";
+</script>
+
+<style scoped>
+.settings-page {
+  display: grid;
+  gap: 1rem;
+}
+</style>

package/test/settingsPlacementContract.test.js

@@ -0,0 +1,65 @@
+import assert from "node:assert/strict";
+import path from "node:path";
+import test from "node:test";
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import descriptor from "../package.descriptor.mjs";
+
+const TEST_DIRECTORY = path.dirname(fileURLToPath(import.meta.url));
+const PACKAGE_DIR = path.resolve(TEST_DIRECTORY, "..");
+
+function readSettingsOutlets() {
+  const outlets = descriptor?.metadata?.ui?.placements?.outlets;
+  return Array.isArray(outlets)
+    ? outlets.filter((entry) => String(entry?.host || "").trim() === "home-settings")
+    : [];
+}
+
+function findFileMutation(id) {
+  const files = descriptor?.mutations?.files;
+  return Array.isArray(files)
+    ? files.find((entry) => String(entry?.id || "").trim() === id) || null
+    : null;
+}
+
+test("shell-web home settings template exposes surface-derived settings outlets", async () => {
+  const source = await readFile(path.join(PACKAGE_DIR, "templates", "src", "pages", "home", "settings", "index.vue"), "utf8");
+
+  assert.match(source, /<ShellOutlet host="home-settings" position="primary-menu" \/>/);
+  assert.match(source, /<ShellOutlet host="home-settings" position="forms" \/>/);
+});
+
+test("shell-web descriptor metadata advertises home settings outlets and installs the scaffold page", () => {
+  assert.deepEqual(
+    readSettingsOutlets(),
+    [
+      {
+        host: "home-settings",
+        position: "primary-menu",
+        surfaces: ["home"],
+        source: "templates/src/pages/home/settings/index.vue"
+      },
+      {
+        host: "home-settings",
+        position: "forms",
+        surfaces: ["home"],
+        source: "templates/src/pages/home/settings/index.vue"
+      }
+    ]
+  );
+
+  assert.deepEqual(findFileMutation("shell-web-page-home-settings"), {
+    from: "templates/src/pages/home/settings/index.vue",
+    toSurface: "home",
+    toSurfacePath: "settings/index.vue",
+    reason: "Install shell-driven home settings page scaffold with surface-derived settings outlets.",
+    category: "shell-web",
+    id: "shell-web-page-home-settings"
+  });
+});
+
+test("shell-web home starter page links to the home settings scaffold", async () => {
+  const source = await readFile(path.join(PACKAGE_DIR, "templates", "src", "pages", "home", "index.vue"), "utf8");
+
+  assert.match(source, /to="\/home\/settings"/);
+});