@jskit-ai/jskit-catalog 0.2.30 → 0.2.31

package/catalog/packages.json

@@ -6,54 +6,54 @@
   "release": {
     "packages": {
       "@jskit-ai/agent": "0.1.1",
-      "@jskit-ai/agent-docs": "0.1.278",
+      "@jskit-ai/agent-docs": "0.1.279",
       "@jskit-ai/agent-runtime": "0.1.2",
       "@jskit-ai/architecture-inspector": "0.1.8",
-      "@jskit-ai/assistant-core": "0.2.23",
-      "@jskit-ai/assistant-runtime": "0.2.25",
-      "@jskit-ai/assistant-voice": "0.2.25",
-      "@jskit-ai/assistant-voice-sherpa": "0.1.72",
+      "@jskit-ai/assistant-core": "0.2.24",
+      "@jskit-ai/assistant-runtime": "0.2.26",
+      "@jskit-ai/assistant-voice": "0.2.26",
+      "@jskit-ai/assistant-voice-sherpa": "0.1.73",
       "@jskit-ai/auth-core": "0.2.10",
-      "@jskit-ai/auth-provider-local-core": "0.2.12",
-      "@jskit-ai/auth-provider-local-db-core": "0.1.153",
-      "@jskit-ai/auth-provider-oidc-core": "0.2.16",
+      "@jskit-ai/auth-provider-local-core": "0.2.13",
+      "@jskit-ai/auth-provider-local-db-core": "0.1.154",
+      "@jskit-ai/auth-provider-oidc-core": "0.2.17",
       "@jskit-ai/auth-provider-supabase-core": "0.2.12",
-      "@jskit-ai/auth-web": "0.2.14",
+      "@jskit-ai/auth-web": "0.2.15",
       "@jskit-ai/config-eslint": "0.1.245",
       "@jskit-ai/connector-google-calendar": "0.2.11",
       "@jskit-ai/connectors-catalog": "0.2.11",
       "@jskit-ai/connectors-core": "0.2.11",
       "@jskit-ai/connectors-web": "0.2.11",
       "@jskit-ai/console-core": "0.2.12",
-      "@jskit-ai/console-web": "0.1.236",
+      "@jskit-ai/console-web": "0.1.237",
       "@jskit-ai/crud-core": "0.2.11",
       "@jskit-ai/database-runtime": "0.1.259",
       "@jskit-ai/database-runtime-mysql": "0.1.257",
       "@jskit-ai/database-runtime-postgres": "0.1.256",
       "@jskit-ai/http-runtime": "0.2.10",
-      "@jskit-ai/http-web": "0.2.17",
-      "@jskit-ai/jskit-catalog": "0.2.30",
+      "@jskit-ai/http-web": "0.2.18",
+      "@jskit-ai/jskit-catalog": "0.2.31",
       "@jskit-ai/json-rest-api-core": "0.2.11",
       "@jskit-ai/kernel": "0.2.10",
-      "@jskit-ai/material-web": "0.1.1",
-      "@jskit-ai/mobile-capacitor": "0.2.12",
-      "@jskit-ai/oidc-issuer-core": "0.1.17",
+      "@jskit-ai/material-web": "0.1.2",
+      "@jskit-ai/mobile-capacitor": "0.2.13",
+      "@jskit-ai/oidc-issuer-core": "0.1.18",
       "@jskit-ai/payments-core": "0.2.1",
       "@jskit-ai/payments-web": "0.2.10",
-      "@jskit-ai/realtime": "0.2.15",
+      "@jskit-ai/realtime": "0.2.16",
       "@jskit-ai/release": "0.1.9",
       "@jskit-ai/resource-core": "0.1.201",
       "@jskit-ai/resource-crud-core": "0.1.201",
       "@jskit-ai/rewarded-core": "0.2.12",
-      "@jskit-ai/rewarded-web": "0.2.14",
-      "@jskit-ai/shell-web": "0.2.12",
+      "@jskit-ai/rewarded-web": "0.2.15",
+      "@jskit-ai/shell-web": "0.2.13",
       "@jskit-ai/storage-runtime": "0.1.256",
       "@jskit-ai/uploads-image-web": "0.2.10",
       "@jskit-ai/uploads-runtime": "0.2.10",
       "@jskit-ai/users-core": "0.2.12",
-      "@jskit-ai/users-web": "0.2.19",
+      "@jskit-ai/users-web": "0.2.20",
       "@jskit-ai/workspaces-core": "0.2.12",
-      "@jskit-ai/workspaces-web": "0.2.19"
+      "@jskit-ai/workspaces-web": "0.2.20"
     },
     "singletonPackages": [
       "@jskit-ai/assistant-runtime",
@@ -179,7 +179,7 @@
     },
     {
       "packageId": "@jskit-ai/assistant-core",
-      "version": "0.2.23",
+      "version": "0.2.24",
       "description": "Reusable assistant client/server/shared primitives without surface-specific routes or settings ownership.",
       "jskit": {
         "kind": "runtime",
@@ -364,7 +364,7 @@
     },
     {
       "packageId": "@jskit-ai/assistant-runtime",
-      "version": "0.2.25",
+      "version": "0.2.26",
       "description": "Capability-based assistant runtime with per-surface chat, transcripts, settings, and action tools.",
       "jskit": {
         "kind": "runtime",
@@ -458,15 +458,15 @@
       },
       "packageJson": {
         "dependencies": {
-          "@jskit-ai/assistant-core": "0.2.23",
+          "@jskit-ai/assistant-core": "0.2.24",
           "json-rest-schema": "^1.0.17"
         },
         "peerDependencies": {
           "@jskit-ai/http-runtime": "0.2.10",
-          "@jskit-ai/http-web": "0.2.17",
+          "@jskit-ai/http-web": "0.2.18",
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/realtime": "0.2.15",
-          "@jskit-ai/shell-web": "0.2.12",
+          "@jskit-ai/realtime": "0.2.16",
+          "@jskit-ai/shell-web": "0.2.13",
           "@tanstack/vue-query": "^5.90.5",
           "vue": "^3.5.13",
           "vuetify": "^4.0.0",
@@ -476,7 +476,7 @@
     },
     {
       "packageId": "@jskit-ai/assistant-voice",
-      "version": "0.2.25",
+      "version": "0.2.26",
       "description": "Duplex voice conversations with application-owned targets, authorization and speech services.",
       "jskit": {
         "kind": "runtime",
@@ -518,7 +518,7 @@
       },
       "packageJson": {
         "dependencies": {
-          "@jskit-ai/assistant-core": "0.2.23",
+          "@jskit-ai/assistant-core": "0.2.24",
           "ws": "^8.20.1"
         },
         "peerDependencies": {
@@ -530,7 +530,7 @@
     },
     {
       "packageId": "@jskit-ai/assistant-voice-sherpa",
-      "version": "0.1.72",
+      "version": "0.1.73",
       "description": "Optional native Sherpa speech engine and explicit model preparation for assistant voice.",
       "jskit": {
         "kind": "runtime",
@@ -568,7 +568,7 @@
       },
       "packageJson": {
         "dependencies": {
-          "@jskit-ai/assistant-voice": "0.2.25",
+          "@jskit-ai/assistant-voice": "0.2.26",
           "sherpa-onnx-node": "1.13.6"
         }
       }
@@ -664,7 +664,7 @@
     },
     {
       "packageId": "@jskit-ai/auth-provider-local-core",
-      "version": "0.2.12",
+      "version": "0.2.13",
       "description": "Local auth provider with a file backend default, no database requirement, and optional Google, Microsoft and GitHub sign-in.",
       "jskit": {
         "kind": "runtime",
@@ -729,7 +729,7 @@
     },
     {
       "packageId": "@jskit-ai/auth-provider-local-db-core",
-      "version": "0.1.153",
+      "version": "0.1.154",
       "description": "Database-backed local auth storage backend for JSKIT local auth.",
       "jskit": {
         "kind": "runtime",
@@ -804,7 +804,7 @@
       },
       "packageJson": {
         "dependencies": {
-          "@jskit-ai/auth-provider-local-core": "0.2.12",
+          "@jskit-ai/auth-provider-local-core": "0.2.13",
           "@jskit-ai/database-runtime": "0.1.259"
         },
         "peerDependencies": {
@@ -814,7 +814,7 @@
     },
     {
       "packageId": "@jskit-ai/auth-provider-oidc-core",
-      "version": "0.2.16",
+      "version": "0.2.17",
       "description": "Sign in through any OpenID Connect issuer: self-registration or a static client, app-owned sessions, and back-channel logout.",
       "jskit": {
         "kind": "runtime",
@@ -953,7 +953,7 @@
     },
     {
       "packageId": "@jskit-ai/auth-web",
-      "version": "0.2.14",
+      "version": "0.2.15",
       "description": "Auth web module: Fastify auth routes plus web login/sign-out scaffolds.",
       "jskit": {
         "kind": "runtime",
@@ -1228,7 +1228,7 @@
           "@jskit-ai/auth-core": "0.2.10",
           "@jskit-ai/http-runtime": "0.2.10",
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/shell-web": "0.2.12",
+          "@jskit-ai/shell-web": "0.2.13",
           "@tanstack/vue-query": "^5.90.5",
           "pinia": "^4.0.3",
           "vue": "^3.5.44",
@@ -1480,7 +1480,7 @@
     },
     {
       "packageId": "@jskit-ai/console-web",
-      "version": "0.1.236",
+      "version": "0.1.237",
       "description": "Authenticated console surface scaffold and surface policy wiring.",
       "jskit": {
         "kind": "runtime",
@@ -1585,8 +1585,8 @@
           "@jskit-ai/console-core": "0.2.12"
         },
         "peerDependencies": {
-          "@jskit-ai/auth-web": "0.2.14",
-          "@jskit-ai/shell-web": "0.2.12"
+          "@jskit-ai/auth-web": "0.2.15",
+          "@jskit-ai/shell-web": "0.2.13"
         }
       }
     },
@@ -1842,7 +1842,7 @@
     },
     {
       "packageId": "@jskit-ai/http-web",
-      "version": "0.2.17",
+      "version": "0.2.18",
       "description": "Neutral Vue request, command, resource, and CRUD UI runtime for JSKIT web applications.",
       "jskit": {
         "kind": "runtime",
@@ -1921,8 +1921,8 @@
         "peerDependencies": {
           "@jskit-ai/http-runtime": "0.2.10",
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/realtime": "0.2.15",
-          "@jskit-ai/shell-web": "0.2.12",
+          "@jskit-ai/realtime": "0.2.16",
+          "@jskit-ai/shell-web": "0.2.13",
           "@tanstack/vue-query": "^5.90.5",
           "vue": "^3.5.13",
           "vue-router": "^5.0.4",
@@ -1986,7 +1986,7 @@
     },
     {
       "packageId": "@jskit-ai/material-web",
-      "version": "0.1.1",
+      "version": "0.1.2",
       "description": "Exact Material 3 for JSKIT Vuetify apps: seed-generated light and dark schemes, Material Symbols Rounded icon aliases, Roboto Flex and Material 3 component defaults.",
       "jskit": {
         "kind": "runtime",
@@ -2015,7 +2015,7 @@
     },
     {
       "packageId": "@jskit-ai/mobile-capacitor",
-      "version": "0.2.12",
+      "version": "0.2.13",
       "description": "Thin Capacitor client integration for JSKIT mobile-shell launch routing and auth callback completion.",
       "jskit": {
         "kind": "runtime",
@@ -2067,13 +2067,13 @@
         },
         "peerDependencies": {
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/shell-web": "0.2.12"
+          "@jskit-ai/shell-web": "0.2.13"
         }
       }
     },
     {
       "packageId": "@jskit-ai/oidc-issuer-core",
-      "version": "0.1.17",
+      "version": "0.1.18",
       "description": "OpenID Connect accounts hub: one sign-in for all of an owner's apps, with approval of every production app.",
       "jskit": {
         "kind": "runtime",
@@ -2258,7 +2258,7 @@
     },
     {
       "packageId": "@jskit-ai/realtime",
-      "version": "0.2.15",
+      "version": "0.2.16",
       "description": "Thin, generic realtime runtime wrappers for socket.io server and client.",
       "jskit": {
         "kind": "runtime",
@@ -2582,7 +2582,7 @@
     },
     {
       "packageId": "@jskit-ai/rewarded-web",
-      "version": "0.2.14",
+      "version": "0.2.15",
       "description": "Rewarded gate client workflow with explicitly composed application delivery.",
       "jskit": {
         "kind": "runtime",
@@ -2636,14 +2636,14 @@
         "peerDependencies": {
           "@jskit-ai/http-runtime": "0.2.10",
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/shell-web": "0.2.12",
+          "@jskit-ai/shell-web": "0.2.13",
           "vue": "^3.5.13"
         }
       }
     },
     {
       "packageId": "@jskit-ai/shell-web",
-      "version": "0.2.12",
+      "version": "0.2.13",
       "description": "Web shell layout runtime with outlet-based placement contributions.",
       "jskit": {
         "kind": "runtime",
@@ -3404,7 +3404,7 @@
     },
     {
       "packageId": "@jskit-ai/users-web",
-      "version": "0.2.19",
+      "version": "0.2.20",
       "description": "Users web module with account, profile, and user-specific shell UI.",
       "jskit": {
         "kind": "runtime",
@@ -3613,11 +3613,11 @@
           "@jskit-ai/users-core": "0.2.12"
         },
         "peerDependencies": {
-          "@jskit-ai/auth-web": "0.2.14",
+          "@jskit-ai/auth-web": "0.2.15",
           "@jskit-ai/http-runtime": "0.2.10",
-          "@jskit-ai/http-web": "0.2.17",
+          "@jskit-ai/http-web": "0.2.18",
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/shell-web": "0.2.12",
+          "@jskit-ai/shell-web": "0.2.13",
           "@tanstack/vue-query": "^5.90.5",
           "vue": "^3.5.13",
           "vue-router": "^5.0.4",
@@ -3814,7 +3814,7 @@
     },
     {
       "packageId": "@jskit-ai/workspaces-web",
-      "version": "0.2.19",
+      "version": "0.2.20",
       "description": "Workspace web module: workspace selector, tools widget, workspace surfaces, members UI, and settings hosts.",
       "jskit": {
         "kind": "runtime",
@@ -4066,11 +4066,11 @@
           "@jskit-ai/workspaces-core": "0.2.12"
         },
         "peerDependencies": {
-          "@jskit-ai/auth-web": "0.2.14",
-          "@jskit-ai/http-web": "0.2.17",
+          "@jskit-ai/auth-web": "0.2.15",
+          "@jskit-ai/http-web": "0.2.18",
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/shell-web": "0.2.12",
-          "@jskit-ai/users-web": "0.2.19",
+          "@jskit-ai/shell-web": "0.2.13",
+          "@jskit-ai/users-web": "0.2.20",
           "@tanstack/vue-query": "^5.90.5",
           "vue": "^3.5.13",
           "vue-router": "^5.0.4",
@@ -4102,7 +4102,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/assistant-runtime",
-      "packageVersion": "0.2.25",
+      "packageVersion": "0.2.26",
       "documentPath": "patterns/assistant-surface/PATTERN.md",
       "examplePath": "patterns/assistant-surface/example",
       "files": [
@@ -4134,7 +4134,7 @@
         "@jskit-ai/oidc-issuer-core"
       ],
       "packageId": "@jskit-ai/oidc-issuer-core",
-      "packageVersion": "0.1.17",
+      "packageVersion": "0.1.18",
       "documentPath": "patterns/accounts-hub/PATTERN.md",
       "examplePath": "patterns/accounts-hub/example",
       "files": [
@@ -4164,7 +4164,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/auth-web",
-      "packageVersion": "0.2.14",
+      "packageVersion": "0.2.15",
       "documentPath": "patterns/auth-surface/PATTERN.md",
       "examplePath": "patterns/auth-surface/example",
       "files": [
@@ -4202,7 +4202,7 @@
         "@jskit-ai/auth-web"
       ],
       "packageId": "@jskit-ai/auth-provider-oidc-core",
-      "packageVersion": "0.2.16",
+      "packageVersion": "0.2.17",
       "documentPath": "patterns/oidc-sign-in/PATTERN.md",
       "examplePath": "patterns/oidc-sign-in/example",
       "files": [
@@ -4673,7 +4673,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/console-web",
-      "packageVersion": "0.1.236",
+      "packageVersion": "0.1.237",
       "documentPath": "patterns/console-surface/PATTERN.md",
       "examplePath": "patterns/console-surface/example",
       "files": [
@@ -4706,7 +4706,7 @@
         "@jskit-ai/resource-crud-core"
       ],
       "packageId": "@jskit-ai/http-web",
-      "packageVersion": "0.2.17",
+      "packageVersion": "0.2.18",
       "documentPath": "patterns/crud-screen-set/PATTERN.md",
       "examplePath": "patterns/crud-screen-set/example",
       "files": [
@@ -4850,7 +4850,7 @@
         "@jskit-ai/mobile-capacitor"
       ],
       "packageId": "@jskit-ai/mobile-capacitor",
-      "packageVersion": "0.2.12",
+      "packageVersion": "0.2.13",
       "documentPath": "patterns/android-application/PATTERN.md",
       "examplePath": "patterns/android-application/example",
       "files": [
@@ -4874,7 +4874,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/realtime",
-      "packageVersion": "0.2.15",
+      "packageVersion": "0.2.16",
       "documentPath": "patterns/realtime-application/PATTERN.md",
       "examplePath": "patterns/realtime-application/example",
       "files": [
@@ -4898,7 +4898,7 @@
         "@jskit-ai/rewarded-web"
       ],
       "packageId": "@jskit-ai/rewarded-web",
-      "packageVersion": "0.2.14",
+      "packageVersion": "0.2.15",
       "documentPath": "patterns/google-rewarded/PATTERN.md",
       "examplePath": "patterns/google-rewarded/example",
       "files": [
@@ -4925,7 +4925,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/shell-web",
-      "packageVersion": "0.2.12",
+      "packageVersion": "0.2.13",
       "documentPath": "patterns/application-shell/PATTERN.md",
       "examplePath": "patterns/application-shell/example",
       "files": [
@@ -4970,7 +4970,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/shell-web",
-      "packageVersion": "0.2.12",
+      "packageVersion": "0.2.13",
       "documentPath": "patterns/page-and-placement/PATTERN.md",
       "examplePath": "patterns/page-and-placement/example",
       "files": [
@@ -5006,7 +5006,7 @@
         "@jskit-ai/users-web"
       ],
       "packageId": "@jskit-ai/users-web",
-      "packageVersion": "0.2.19",
+      "packageVersion": "0.2.20",
       "documentPath": "patterns/account-settings/PATTERN.md",
       "examplePath": "patterns/account-settings/example",
       "files": [
@@ -5014,7 +5014,8 @@
         "src/components/account/settings/AccountSettingsPreferencesSection.vue",
         "src/components/account/settings/AccountSettingsProfileSection.vue",
         "src/components/account/settings/AccountSettingsSignInMethodsSection.vue",
-        "src/pages/account/index.vue"
+        "src/pages/account/index.vue",
+        "src/pages/account.vue"
       ]
     },
     {
@@ -5102,7 +5103,7 @@
         "@jskit-ai/workspaces-web"
       ],
       "packageId": "@jskit-ai/workspaces-web",
-      "packageVersion": "0.2.19",
+      "packageVersion": "0.2.20",
       "documentPath": "patterns/workspace-surfaces/PATTERN.md",
       "examplePath": "patterns/workspace-surfaces/example",
       "files": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/jskit-catalog",
-  "version": "0.2.30",
+  "version": "0.2.31",
   "description": "Published metadata catalog for JSKIT package metadata.",
   "type": "module",
   "files": [

package/scripts/material3.mjs

@@ -7,7 +7,8 @@ import {
   checkLinkAttribute,
   checkNavigationCode,
   checkPageParents,
-  checkScriptBackNames
+  checkScriptBackNames,
+  readTitledFiles
 } from "./navigation.mjs";
 import {
   HEX_COLOUR,
@@ -52,6 +53,10 @@ const SKIPPED_DIRECTORIES = new Set([
 const SKIPPED_FILE = /\.(?:test|spec)\.[cm]?[jt]s$|\.d\.ts$/u;
 // The generated colour scheme is the one home of hex values.
 const THEME_DIRECTORY = "theme";
+// Colours that are content, not UI, keep one value in both schemes, so they are not theme colours (which are toned per
+// scheme): they are named hex exports of src/theme/palettes.js, which this check, like all of src/theme/, reads as
+// the place for hex values.
+const CONTENT_COLOUR = "A content colour (an identity palette, artwork, a brand mark, a chart series) is a named export of src/theme/palettes.js, used as it is.";
 const WHOLE_APP_ROOTS = Object.freeze(["src", "packages"]);
 
 const hexPattern = () => new RegExp(HEX_COLOUR, "gu");
@@ -67,6 +72,7 @@ const GENERATED_SCHEMES = /\bcreateMaterialVuetifyOptions\s*\(/u;
 const PINNED_LIGHT = /\bdefaultTheme\s*:\s*["']light["']/u;
 const SHELL_PACKAGE = "@jskit-ai/shell-web";
 const isNavigationRule = (rule) => rule.startsWith("nav/");
+const SMALLER_BUTTON = "A smaller button is size=\"small\" or \"x-small\", which keeps the touch target.";
 
 function isSkippedDirectory(name) {
   return SKIPPED_DIRECTORIES.has(name);
@@ -156,7 +162,7 @@ function createReporter(file, source, { navigationOnly = false } = {}) {
 function checkCode(code, offset, { report, themed }) {
   if (!themed) {
     for (const match of code.matchAll(quotedHex())) {
-      report("m3/raw-hex", offset + match.index, `Raw colour ${match[2]}. Use a theme colour role; hex values live only in the generated scheme under src/theme/.`);
+      report("m3/raw-hex", offset + match.index, `Raw colour ${match[2]}. Use a theme colour role. ${CONTENT_COLOUR}`);
     }
   }
   checkNavigationCode(code, offset, report);
@@ -190,12 +196,12 @@ function checkDeclaration(declaration, context) {
   const { report, themed } = context;
   if (!themed) {
     for (const match of declaration.value.matchAll(hexPattern())) {
-      report("m3/raw-hex", declaration.valueOffset + match.index, `Raw colour ${match[0]}. Use rgb(var(--v-theme-<role>)); hex values live only in the generated scheme under src/theme/.`);
+      report("m3/raw-hex", declaration.valueOffset + match.index, `Raw colour ${match[0]}. Use rgb(var(--v-theme-<role>)). ${CONTENT_COLOUR}`);
     }
   }
   const buttonRule = declaration.selectors.some((selector) => /\.v-btn\b/u.test(selector));
   if (buttonRule && ["height", "min-height", "--v-btn-height"].includes(declaration.property)) {
-    report("m3/fixed-button-height", declaration.offset, `A fixed ${declaration.property} on buttons. JSKIT ships the 40dp button with its 48dp touch target; remove it.`);
+    report("m3/fixed-button-height", declaration.offset, `A fixed ${declaration.property} on buttons. JSKIT ships the 40dp button with its 48dp touch target; remove it. ${SMALLER_BUTTON}`);
   }
 }
 
@@ -220,7 +226,7 @@ function checkTemplate(template, context) {
     if (tag.name === "h1") {
       headings += 1;
       if (headings > 1) report("m3/duplicate-h1", tag.offset, "A second h1 in one template. A page has one title, carried by the top app bar.");
-      else if (context.shell) report("m3/duplicate-h1", tag.offset, "An in-page h1. The top app bar carries the page title; use a title role (text-title-large) for a section title.");
+      else if (context.titled) report("m3/duplicate-h1", tag.offset, "An in-page h1 under the top app bar, which carries the page title; use a title role (text-title-large) for a section title.");
     }
   }
 }
@@ -234,7 +240,7 @@ function checkAttribute(tag, entry, context) {
       checkDeclaration({ ...declaration, selectors: tag.name === "v-btn" ? [".v-btn"] : [] }, context);
     }
   } else if (!themed && exactHex.test(entry.value.trim())) {
-    report("m3/raw-hex", entry.valueOffset, `Raw colour ${entry.value.trim()}. Use a theme colour role such as color="primary".`);
+    report("m3/raw-hex", entry.valueOffset, `Raw colour ${entry.value.trim()}. Use a theme colour role such as color="primary". ${CONTENT_COLOUR}`);
   }
   checkLinkAttribute(tag, entry, context.report);
 }
@@ -253,7 +259,7 @@ function checkSurface(tag, report) {
 function checkButtonSize(tag, report) {
   for (const name of ["height", "min-height"]) {
     const entry = attribute(tag, name);
-    if (entry) report("m3/fixed-button-height", entry.offset, `A fixed ${name} on v-btn. JSKIT ships the 40dp button with its 48dp touch target; remove it.`);
+    if (entry) report("m3/fixed-button-height", entry.offset, `A fixed ${name} on v-btn. JSKIT ships the 40dp button with its 48dp touch target; remove it. ${SMALLER_BUTTON}`);
   }
 }
 
@@ -320,11 +326,15 @@ async function checkMaterial3({ projectRoot = process.cwd(), paths = [], navigat
   const root = path.resolve(projectRoot);
   const { files, missing } = await collectFiles(root, paths);
   const appFiles = paths.length === 0 ? files : (await collectFiles(root, [])).files;
-  const context = { shell: usesShell(await readProjectManifest(root)), navigationOnly };
+  const context = { navigationOnly };
+  // Only a page under the shell's top app bar has its title there; one without a bar has its own h1.
+  const titledFiles = usesShell(await readProjectManifest(root))
+    ? await readTitledFiles({ root, appFiles: [...new Set([...appFiles, ...files])] })
+    : new Set();
   const findings = [];
   const exceptions = [];
   for (const file of files) {
-    const checked = checkFile(file, await readFile(path.join(root, file), "utf8"), context);
+    const checked = checkFile(file, await readFile(path.join(root, file), "utf8"), { ...context, titled: titledFiles.has(file) });
     findings.push(...checked.findings);
     exceptions.push(...checked.exceptions);
   }

package/scripts/navigation.mjs

@@ -13,7 +13,9 @@ const RULES = Object.freeze({
   "nav/raw-link": "forbidden-in-app-code",
   "nav/back-control": "forbidden-in-app-code",
   "nav/missing-parent": "what-an-app-declares",
-  "nav/top-level-parent": "what-an-app-declares"
+  "nav/top-level-parent": "what-an-app-declares",
+  "nav/placement-data": "what-an-app-declares",
+  "nav/missing-shell-layout": "what-an-app-declares"
 });
 
 const HISTORY_CALL = /(?<![\w$.])(?:(?:window|globalThis)\s*\.\s*)?history\s*\.\s*(?:back|go|forward|pushState|replaceState)\s*\(/gu;
@@ -60,6 +62,7 @@ const MAIN_NAV_TARGET = /\btarget\s*:\s*["']shell\.(?:primary|secondary)-nav["']
 // draws its own bar renders shell-web's Up control in it.
 const SHELL_LAYOUT_IMPORT = /\bfrom\s*["'](?:@\/components\/ShellLayout|@jskit-ai\/shell-web\/client\/components\/ShellLayout)(?:\.vue)?["']/u;
 const SHELL_UP_TAG = /<\s*(?:ShellUpButton|shell-up-button)\b/u;
+const SHELL_TITLE_TAG = /<\s*(?:ShellPageTitle|shell-page-title)\b/u;
 const LOCAL_IMPORT = /\bfrom\s*["']((?:@\/|\.{1,2}\/)[^"']+)["']/gu;
 const ROUTER_VIEW_TAG = /<\s*(?:RouterView|router-view)\b/u;
 
@@ -247,21 +250,47 @@ function enclosingObject(text, offset) {
 
 const stringValue = (text, key) => new RegExp(`\\b${key}\\s*:\\s*(["'\\u0060])([^"'\\u0060]*)\\1`, "u").exec(text)?.[2];
 
-// Main-navigation destinations, by surface: every main-navigation placement's suffixes.
+// Main-navigation destinations, by surface: every main-navigation placement's suffixes. A link that names its
+// surface (props.surface) leads to that surface's page wherever it shows, so it is a destination of that surface only;
+// one that names none leads to the page on each surface it shows on. A placement is literal data; one whose suffixes or
+// surface are computed (built by a helper, spread or interpolated) can't be read, and is returned as unreadable.
 function readMainNavigation(sources) {
   const destinations = [];
-  for (const source of sources) {
+  const unreadable = [];
+  for (const { file, source } of sources) {
     for (const match of source.matchAll(MAIN_NAV_TARGET)) {
       const placement = enclosingObject(source, match.index)?.text || "";
-      const surfaces = [stringValue(placement, "surface"), ...(/\bsurfaces\s*:\s*\[([^\]]*)\]/u.exec(placement)?.[1] || "")
-        .split(",").map((entry) => entry.trim().replace(/^["'`]|["'`]$/gu, ""))].filter(Boolean);
+      const computed = computedPlacementPart(placement);
+      if (computed) {
+        unreadable.push({ file, source, offset: match.index, computed });
+        continue;
+      }
+      const surface = stringValue(placement, "surface");
+      const surfaces = surface ? [surface] : (/\bsurfaces\s*:\s*\[([^\]]*)\]/u.exec(placement)?.[1] || "")
+        .split(",").map((entry) => entry.trim().replace(/^["'`]|["'`]$/gu, "")).filter(Boolean);
       for (const key of ["scopedSuffix", "unscopedSuffix"]) {
         const suffix = stringValue(placement, key);
         if (suffix !== undefined) destinations.push({ suffix: normalisePath(suffix.split(/[?#]/u)[0]), surfaces });
       }
     }
   }
-  return destinations;
+  return { destinations, unreadable };
+}
+
+// What makes a placement computed rather than literal data, or "": a spread, props that aren't an object literal, or
+// a link key that isn't a plain string (or a list of strings, for surfaces), such as a variable, a call or an
+// interpolated template.
+function computedPlacementPart(placement) {
+  if (/[{,]\s*\.\.\./u.test(placement)) return "it spreads another object";
+  if (/(?<=[{,]\s*)props\s*:(?!\s*\{)/u.test(placement)) return "its props are computed";
+  for (const key of ["scopedSuffix", "unscopedSuffix", "surface", "to"]) {
+    // The key as a property, `key: value` or shorthand `key`, whose value is not a quoted string without ${}.
+    const property = new RegExp(`(?<=[{,]\\s*)${key}\\s*(?::(?!\\s*(["'\\u0060])[^"'\\u0060$]*\\1)|(?=[,}]))`, "u");
+    if (property.test(placement)) return `its ${key} is computed`;
+  }
+  const surfaces = /(?<=[{,]\s*)surfaces\s*:\s*(\[[^\]]*\])?/u.exec(placement);
+  if (surfaces && !/^\[\s*(?:(["'`])[^"'`$]*\1\s*,?\s*)*\]$/u.test(surfaces[1] || "")) return "its surfaces are computed";
+  return "";
 }
 
 function normalisePath(value) {
@@ -333,15 +362,16 @@ function readPage(file, source) {
 }
 
 // Whether a component draws the shell's top app bar, and with it Up: it, or a component it imports from the app,
-// renders ShellLayout (directly or through the app's wrapper) or shell-web's ShellUpButton in a bar of its own.
-function createShellBarReader(appFiles, read) {
+// renders ShellLayout (directly or through the app's wrapper) or shell-web's ShellUpButton in a bar of its own (or,
+// given SHELL_TITLE_TAG, the bar's page title).
+function createShellBarReader(appFiles, read, tag = SHELL_UP_TAG) {
   const known = new Set(appFiles);
   const verdicts = new Map();
   async function drawsShellBar(file) {
     if (verdicts.has(file)) return verdicts.get(file);
     verdicts.set(file, false);
     const source = await read(file);
-    let verdict = SHELL_LAYOUT_IMPORT.test(source) || SHELL_UP_TAG.test(splitVue(source).template?.text || "");
+    let verdict = SHELL_LAYOUT_IMPORT.test(source) || tag.test(splitVue(source).template?.text || "");
     for (const match of source.matchAll(LOCAL_IMPORT)) {
       if (verdict) break;
       const imported = localComponent(file, match[1], known);
@@ -353,6 +383,59 @@ function createShellBarReader(appFiles, read) {
   return drawsShellBar;
 }
 
+/**
+ * The app's .vue files that render under the shell's page title, where an in-page h1 would be a second one: a file
+ * that shows the title (ShellLayout's bar, or ShellPageTitle in a bar of its own), a page a layout showing it renders,
+ * and a component such a file imports. A component no .vue file imports (routed or placed from JavaScript) counts
+ * too, as where it renders can't be read; App.vue counts only when it shows the title itself.
+ * @param {{ root: string, appFiles: string[] }} options
+ */
+async function readTitledFiles({ root, appFiles }) {
+  const sources = new Map();
+  const read = async (file) => {
+    if (!sources.has(file)) sources.set(file, await readFile(path.join(root, file), "utf8"));
+    return sources.get(file);
+  };
+  const known = new Set(appFiles);
+  const vueFiles = appFiles.filter((file) => file.endsWith(".vue"));
+  const showsTitle = createShellBarReader(appFiles, read, SHELL_TITLE_TAG);
+  const importers = new Map();
+  for (const file of vueFiles) {
+    for (const match of (await read(file)).matchAll(LOCAL_IMPORT)) {
+      const imported = localComponent(file, match[1], known);
+      if (imported) importers.set(imported, [...(importers.get(imported) || []), file]);
+    }
+  }
+  const verdicts = new Map();
+  async function titled(file) {
+    if (verdicts.has(file)) return verdicts.get(file);
+    verdicts.set(file, false);
+    let verdict = await showsTitle(file);
+    if (!verdict && isPageFile(file)) {
+      // The layouts that render the page: src/pages/home/settings.vue renders home/settings/*.
+      const segments = pageKey(file).split("/");
+      for (let length = segments.length - 1; length > 0 && !verdict; length -= 1) {
+        const layout = `src/pages/${segments.slice(0, length).join("/")}.vue`;
+        if (known.has(layout) && ROUTER_VIEW_TAG.test(splitVue(await read(layout)).template?.text || "")) {
+          verdict = await showsTitle(layout);
+        }
+      }
+    } else if (!verdict && path.posix.basename(file) !== "App.vue") {
+      const users = importers.get(file) || [];
+      verdict = users.length === 0;
+      for (const user of users) {
+        if (verdict) break;
+        verdict = await titled(user);
+      }
+    }
+    verdicts.set(file, verdict);
+    return verdict;
+  }
+  const result = new Set();
+  for (const file of vueFiles) if (await titled(file)) result.add(file);
+  return result;
+}
+
 // The app's .vue file an import names: "@/components/Bar.vue" is src/components/Bar.vue; "./Bar" is beside the file.
 function localComponent(file, specifier, known) {
   const base = specifier.startsWith("@/")
@@ -383,10 +466,16 @@ async function checkPageParents({ root, appFiles, pageFiles, report }) {
   }
   const surfaces = readSurfaces(configSource, [...pages.values()].map(({ file }) => routeOf(file)));
   const scripts = appFiles.filter((file) => /\.(?:[cm]?[jt]s|vue)$/u.test(file));
-  const navigation = readMainNavigation(await Promise.all(scripts.map(async (file) => blankJsComments(await read(file)))));
+  const navigation = readMainNavigation(await Promise.all(scripts.map(async (file) => ({ file, source: blankJsComments(await read(file)) }))));
+  for (const { file, source, offset, computed } of navigation.unreadable) {
+    if (!pageFiles.includes(file)) continue;
+    report({ rule: "nav/placement-data", file, ...lineIndex(source)(offset), message: `A main-navigation placement that isn't literal data: ${computed}. Declare each placement literally, with plain string suffixes and surface, so its destination can be read; until then no page is judged for nav/missing-parent.` });
+  }
   const surfacePath = (file, surface) => normalisePath(routePattern(routeOf(file).slice(surface.pagesRoot.length)));
-  const isDestination = (relative, surface) => navigation.some(({ suffix, surfaces: owners }) =>
+  const isDestination = (relative, surface) => navigation.destinations.some(({ suffix, surfaces: owners }) =>
     suffix === relative && (owners.length === 0 || owners.includes(surface.id) || owners.includes("*")));
+  // An App.vue that wraps every page in the shell's bar leaves no page outside it.
+  const appShell = appFiles.includes("src/App.vue") && await drawsShellBar("src/App.vue");
   const judged = [];
   for (const file of pageFiles.filter(isPageFile)) {
     const page = pages.get(pageKey(file));
@@ -396,11 +485,19 @@ async function checkPageParents({ root, appFiles, pageFiles, report }) {
     const segments = pageKey(file).split("/");
     const layouts = segments.slice(1).map((_, index) => pages.get(segments.slice(0, segments.length - 1 - index).join("/")))
       .filter((entry) => entry?.layout);
-    // Up lives in the shell's top app bar, so only pages a shell layout renders have one.
-    if (!layouts.some((entry) => entry.shell)) continue;
     const relative = surfacePath(file, surface);
-    const destination = isDestination(relative, surface);
     const position = lineIndex(page.source);
+    // Up lives in the shell's top app bar, so only pages a shell layout renders have one. A page that declares a
+    // parent expects that bar, with its title, Up and page actions; under no shell layout it shows none of them.
+    if (!layouts.some((entry) => entry.shell)) {
+      if (page.parent && !appShell && !await drawsShellBar(file)) {
+        const at = position(page.parent.offset + PARENT_KEY.exec(page.parent.text).index);
+        const layout = surface.pagesRoot ? `, src/pages/${surface.pagesRoot}.vue` : "";
+        report({ rule: "nav/missing-shell-layout", file, ...at, message: `${relative} of ${surface.id} declares a parent, but no layout that draws the shell's top app bar renders it, so its title, Up and page actions never show. Give the surface its layout${layout}: ShellLayout around <RouterView />, with meta.jskit.surface "${surface.id}".` });
+      }
+      continue;
+    }
+    const destination = isDestination(relative, surface);
     if (destination && page.parent) {
       const at = position(page.parent.offset + PARENT_KEY.exec(page.parent.text).index);
       report({ rule: "nav/top-level-parent", file, ...at, message: `${relative} is a main-navigation destination of ${surface.id}, so it declares no parent: choosing it starts a fresh trail.` });
@@ -415,7 +512,7 @@ async function checkPageParents({ root, appFiles, pageFiles, report }) {
     const inherited = chain.find((entry) => entry.parent);
     const topLevel = destination || relative === "/" || chain.some((entry) => isDestination(surfacePath(entry.file, surface), surface));
     judged.push({ file, route: relative, surface: surface.id, topLevel, parent: page.parent ? "own" : inherited ? "inherited" : null });
-    if (!topLevel && !page.parent && !inherited) {
+    if (!topLevel && !page.parent && !inherited && navigation.unreadable.length === 0) {
       const at = position(page.declarations[0]?.offset ?? 0);
       report({ rule: "nav/missing-parent", file, ...at, message: `Inner page ${relative} of ${surface.id} has no parent. Declare it once in the page's route meta (or its layout's, for tabs), so Up works after a direct entry.` });
     }
@@ -441,5 +538,6 @@ export {
   checkPageParents,
   checkScriptBackNames,
   isInAppPath,
-  isPageFile
+  isPageFile,
+  readTitledFiles
 };