@jskit-ai/users-web 0.2.18 → 0.2.20

package/CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Unreleased
 
+- The account-settings pattern ships the account surface's layout, `src/pages/account.vue` (`ShellLayout` around `<RouterView />`, `meta.jskit.surface: "account"`), so the settings page's title, Up arrow and Done action show in the top app bar, with no navigation bar, rail or drawer on a surface that has no navigation. An app whose account page renders under no layout copies it; until then `jskit check` reports `nav/missing-shell-layout` on the page.
 - The account settings page and the account-settings pattern's sections sit directly on the page, without bordered sheets, and the section list has no extra border or tint.
 - The account settings page has no in-page title or Back button: it gives the shell's top app bar its title (`useShellPageTitle`) and a Done action (`ShellPageAction`) that returns to `returnTo`, another of the app's origins included, as Back did. Message keys: `jskit.users.accountSettings.back` is removed and `jskit.users.accountSettings.done` ("Done") is new. The pattern's section buttons no longer set a fixed height; they are Material 3's 40dp buttons inside material-web's 48dp touch target.
 - Account settings text uses Vuetify 4's Material 3 type classes (`text-body-medium`, `text-title-large`, ...) instead of Material 2 ones, which Vuetify 4 no longer styles, and the account settings page pattern declares its title and its parent (the home surface's root). Upgrading: see the guide's [Move an app to the Material 3 defaults](https://mobily-enterprises.github.io/jskit-ai/guide/app-setup/material-3-migration).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/users-web",
-  "version": "0.2.18",
+  "version": "0.2.20",
   "type": "module",
   "scripts": {
     "test": "node --test --test-concurrency=1"
@@ -17,11 +17,11 @@
     "@jskit-ai/users-core": "0.2.12"
   },
   "peerDependencies": {
-    "@jskit-ai/auth-web": "0.2.13",
+    "@jskit-ai/auth-web": "0.2.15",
     "@jskit-ai/http-runtime": "0.2.10",
-    "@jskit-ai/http-web": "0.2.16",
+    "@jskit-ai/http-web": "0.2.18",
     "@jskit-ai/kernel": "0.2.10",
-    "@jskit-ai/shell-web": "0.2.11",
+    "@jskit-ai/shell-web": "0.2.13",
     "@tanstack/vue-query": "^5.90.5",
     "vue": "^3.5.13",
     "vue-router": "^5.0.4",
@@ -230,6 +230,6 @@
     }
   },
   "devDependencies": {
-    "@jskit-ai/material-web": "0.1.0"
+    "@jskit-ai/material-web": "0.1.2"
   }
 }

package/patterns/account-settings/PATTERN.md

@@ -57,10 +57,15 @@ provider offers provider linking (`providerLinking` in its capabilities).
 - Loading uses layout-stable skeletons, never an indeterminate spinner.
 - Pending controls keep stable labels and prevent duplicate submission.
 - The route and placement owner agree.
+- The account surface renders in its own layout, `src/pages/account.vue`
+  (`ShellLayout` around `<RouterView />`, `meta.jskit.surface: "account"`), so
+  the settings page's title, Up arrow and Done action are in the top app bar.
+  With no navigation items, the surface shows no navigation bar, rail or drawer.
 
 ## Example files
 
-`example/` contains an account route and four concrete settings sections.
+`example/` contains the account surface's layout, an account route and four
+concrete settings sections.
 Adapt their fields and copy while retaining the shared account runtime.
 
 ## Variation points

package/patterns/account-settings/example/src/pages/account.vue

@@ -0,0 +1,22 @@
+<route lang="json">
+{
+  "meta": {
+    "jskit": {
+      "surface": "account"
+    }
+  }
+}
+</route>
+
+<script setup>
+// The account surface's layout: the shell's top app bar carries the settings page's title, its Up arrow back to home
+// and its Done action. The surface has no navigation items, so the shell draws no navigation bar, rail or drawer.
+import ShellLayout from "@/components/ShellLayout.vue";
+import { RouterView } from "vue-router";
+</script>
+
+<template>
+  <ShellLayout title="" subtitle="">
+    <RouterView />
+  </ShellLayout>
+</template>