@jskit-ai/jskit-catalog 0.2.28 → 0.2.30

package/catalog/packages.json

@@ -6,54 +6,54 @@
   "release": {
     "packages": {
       "@jskit-ai/agent": "0.1.1",
-      "@jskit-ai/agent-docs": "0.1.276",
+      "@jskit-ai/agent-docs": "0.1.278",
       "@jskit-ai/agent-runtime": "0.1.2",
       "@jskit-ai/architecture-inspector": "0.1.8",
-      "@jskit-ai/assistant-core": "0.2.22",
-      "@jskit-ai/assistant-runtime": "0.2.24",
-      "@jskit-ai/assistant-voice": "0.2.24",
-      "@jskit-ai/assistant-voice-sherpa": "0.1.71",
+      "@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/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.15",
+      "@jskit-ai/auth-provider-oidc-core": "0.2.16",
       "@jskit-ai/auth-provider-supabase-core": "0.2.12",
-      "@jskit-ai/auth-web": "0.2.13",
+      "@jskit-ai/auth-web": "0.2.14",
       "@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.235",
+      "@jskit-ai/console-web": "0.1.236",
       "@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.16",
-      "@jskit-ai/jskit-catalog": "0.2.28",
+      "@jskit-ai/http-web": "0.2.17",
+      "@jskit-ai/jskit-catalog": "0.2.30",
       "@jskit-ai/json-rest-api-core": "0.2.11",
       "@jskit-ai/kernel": "0.2.10",
-      "@jskit-ai/material-web": "0.1.0",
-      "@jskit-ai/mobile-capacitor": "0.2.11",
+      "@jskit-ai/material-web": "0.1.1",
+      "@jskit-ai/mobile-capacitor": "0.2.12",
       "@jskit-ai/oidc-issuer-core": "0.1.17",
       "@jskit-ai/payments-core": "0.2.1",
       "@jskit-ai/payments-web": "0.2.10",
-      "@jskit-ai/realtime": "0.2.14",
+      "@jskit-ai/realtime": "0.2.15",
       "@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.13",
-      "@jskit-ai/shell-web": "0.2.11",
+      "@jskit-ai/rewarded-web": "0.2.14",
+      "@jskit-ai/shell-web": "0.2.12",
       "@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.18",
+      "@jskit-ai/users-web": "0.2.19",
       "@jskit-ai/workspaces-core": "0.2.12",
-      "@jskit-ai/workspaces-web": "0.2.18"
+      "@jskit-ai/workspaces-web": "0.2.19"
     },
     "singletonPackages": [
       "@jskit-ai/assistant-runtime",
@@ -179,7 +179,7 @@
     },
     {
       "packageId": "@jskit-ai/assistant-core",
-      "version": "0.2.22",
+      "version": "0.2.23",
       "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.24",
+      "version": "0.2.25",
       "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.22",
+          "@jskit-ai/assistant-core": "0.2.23",
           "json-rest-schema": "^1.0.17"
         },
         "peerDependencies": {
           "@jskit-ai/http-runtime": "0.2.10",
-          "@jskit-ai/http-web": "0.2.16",
+          "@jskit-ai/http-web": "0.2.17",
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/realtime": "0.2.14",
-          "@jskit-ai/shell-web": "0.2.11",
+          "@jskit-ai/realtime": "0.2.15",
+          "@jskit-ai/shell-web": "0.2.12",
           "@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.24",
+      "version": "0.2.25",
       "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.22",
+          "@jskit-ai/assistant-core": "0.2.23",
           "ws": "^8.20.1"
         },
         "peerDependencies": {
@@ -530,7 +530,7 @@
     },
     {
       "packageId": "@jskit-ai/assistant-voice-sherpa",
-      "version": "0.1.71",
+      "version": "0.1.72",
       "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.24",
+          "@jskit-ai/assistant-voice": "0.2.25",
           "sherpa-onnx-node": "1.13.6"
         }
       }
@@ -814,7 +814,7 @@
     },
     {
       "packageId": "@jskit-ai/auth-provider-oidc-core",
-      "version": "0.2.15",
+      "version": "0.2.16",
       "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.13",
+      "version": "0.2.14",
       "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.11",
+          "@jskit-ai/shell-web": "0.2.12",
           "@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.235",
+      "version": "0.1.236",
       "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.13",
-          "@jskit-ai/shell-web": "0.2.11"
+          "@jskit-ai/auth-web": "0.2.14",
+          "@jskit-ai/shell-web": "0.2.12"
         }
       }
     },
@@ -1842,7 +1842,7 @@
     },
     {
       "packageId": "@jskit-ai/http-web",
-      "version": "0.2.16",
+      "version": "0.2.17",
       "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.14",
-          "@jskit-ai/shell-web": "0.2.11",
+          "@jskit-ai/realtime": "0.2.15",
+          "@jskit-ai/shell-web": "0.2.12",
           "@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.0",
+      "version": "0.1.1",
       "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.11",
+      "version": "0.2.12",
       "description": "Thin Capacitor client integration for JSKIT mobile-shell launch routing and auth callback completion.",
       "jskit": {
         "kind": "runtime",
@@ -2067,7 +2067,7 @@
         },
         "peerDependencies": {
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/shell-web": "0.2.11"
+          "@jskit-ai/shell-web": "0.2.12"
         }
       }
     },
@@ -2258,7 +2258,7 @@
     },
     {
       "packageId": "@jskit-ai/realtime",
-      "version": "0.2.14",
+      "version": "0.2.15",
       "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.13",
+      "version": "0.2.14",
       "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.11",
+          "@jskit-ai/shell-web": "0.2.12",
           "vue": "^3.5.13"
         }
       }
     },
     {
       "packageId": "@jskit-ai/shell-web",
-      "version": "0.2.11",
+      "version": "0.2.12",
       "description": "Web shell layout runtime with outlet-based placement contributions.",
       "jskit": {
         "kind": "runtime",
@@ -2680,6 +2680,7 @@
                 "@jskit-ai/shell-web/client/navigation/useSurfaceRouteContext",
                 "@jskit-ai/shell-web/client/navigation/useShellNavigation",
                 "@jskit-ai/shell-web/client/navigation/documentNavigation",
+                "@jskit-ai/shell-web/client/composables/useShellAppBar",
                 "@jskit-ai/shell-web/client/composables/useShellLayoutState",
                 "@jskit-ai/shell-web/client/composables/useShellPageTitle",
                 "@jskit-ai/shell-web/client/composables/useShellWindowSizeClass",
@@ -3403,7 +3404,7 @@
     },
     {
       "packageId": "@jskit-ai/users-web",
-      "version": "0.2.18",
+      "version": "0.2.19",
       "description": "Users web module with account, profile, and user-specific shell UI.",
       "jskit": {
         "kind": "runtime",
@@ -3612,11 +3613,11 @@
           "@jskit-ai/users-core": "0.2.12"
         },
         "peerDependencies": {
-          "@jskit-ai/auth-web": "0.2.13",
+          "@jskit-ai/auth-web": "0.2.14",
           "@jskit-ai/http-runtime": "0.2.10",
-          "@jskit-ai/http-web": "0.2.16",
+          "@jskit-ai/http-web": "0.2.17",
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/shell-web": "0.2.11",
+          "@jskit-ai/shell-web": "0.2.12",
           "@tanstack/vue-query": "^5.90.5",
           "vue": "^3.5.13",
           "vue-router": "^5.0.4",
@@ -3813,7 +3814,7 @@
     },
     {
       "packageId": "@jskit-ai/workspaces-web",
-      "version": "0.2.18",
+      "version": "0.2.19",
       "description": "Workspace web module: workspace selector, tools widget, workspace surfaces, members UI, and settings hosts.",
       "jskit": {
         "kind": "runtime",
@@ -4065,11 +4066,11 @@
           "@jskit-ai/workspaces-core": "0.2.12"
         },
         "peerDependencies": {
-          "@jskit-ai/auth-web": "0.2.13",
-          "@jskit-ai/http-web": "0.2.16",
+          "@jskit-ai/auth-web": "0.2.14",
+          "@jskit-ai/http-web": "0.2.17",
           "@jskit-ai/kernel": "0.2.10",
-          "@jskit-ai/shell-web": "0.2.11",
-          "@jskit-ai/users-web": "0.2.18",
+          "@jskit-ai/shell-web": "0.2.12",
+          "@jskit-ai/users-web": "0.2.19",
           "@tanstack/vue-query": "^5.90.5",
           "vue": "^3.5.13",
           "vue-router": "^5.0.4",
@@ -4101,7 +4102,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/assistant-runtime",
-      "packageVersion": "0.2.24",
+      "packageVersion": "0.2.25",
       "documentPath": "patterns/assistant-surface/PATTERN.md",
       "examplePath": "patterns/assistant-surface/example",
       "files": [
@@ -4163,7 +4164,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/auth-web",
-      "packageVersion": "0.2.13",
+      "packageVersion": "0.2.14",
       "documentPath": "patterns/auth-surface/PATTERN.md",
       "examplePath": "patterns/auth-surface/example",
       "files": [
@@ -4201,7 +4202,7 @@
         "@jskit-ai/auth-web"
       ],
       "packageId": "@jskit-ai/auth-provider-oidc-core",
-      "packageVersion": "0.2.15",
+      "packageVersion": "0.2.16",
       "documentPath": "patterns/oidc-sign-in/PATTERN.md",
       "examplePath": "patterns/oidc-sign-in/example",
       "files": [
@@ -4672,7 +4673,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/console-web",
-      "packageVersion": "0.1.235",
+      "packageVersion": "0.1.236",
       "documentPath": "patterns/console-surface/PATTERN.md",
       "examplePath": "patterns/console-surface/example",
       "files": [
@@ -4705,7 +4706,7 @@
         "@jskit-ai/resource-crud-core"
       ],
       "packageId": "@jskit-ai/http-web",
-      "packageVersion": "0.2.16",
+      "packageVersion": "0.2.17",
       "documentPath": "patterns/crud-screen-set/PATTERN.md",
       "examplePath": "patterns/crud-screen-set/example",
       "files": [
@@ -4849,7 +4850,7 @@
         "@jskit-ai/mobile-capacitor"
       ],
       "packageId": "@jskit-ai/mobile-capacitor",
-      "packageVersion": "0.2.11",
+      "packageVersion": "0.2.12",
       "documentPath": "patterns/android-application/PATTERN.md",
       "examplePath": "patterns/android-application/example",
       "files": [
@@ -4873,7 +4874,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/realtime",
-      "packageVersion": "0.2.14",
+      "packageVersion": "0.2.15",
       "documentPath": "patterns/realtime-application/PATTERN.md",
       "examplePath": "patterns/realtime-application/example",
       "files": [
@@ -4897,7 +4898,7 @@
         "@jskit-ai/rewarded-web"
       ],
       "packageId": "@jskit-ai/rewarded-web",
-      "packageVersion": "0.2.13",
+      "packageVersion": "0.2.14",
       "documentPath": "patterns/google-rewarded/PATTERN.md",
       "examplePath": "patterns/google-rewarded/example",
       "files": [
@@ -4924,7 +4925,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/shell-web",
-      "packageVersion": "0.2.11",
+      "packageVersion": "0.2.12",
       "documentPath": "patterns/application-shell/PATTERN.md",
       "examplePath": "patterns/application-shell/example",
       "files": [
@@ -4969,7 +4970,7 @@
         "@jskit-ai/shell-web"
       ],
       "packageId": "@jskit-ai/shell-web",
-      "packageVersion": "0.2.11",
+      "packageVersion": "0.2.12",
       "documentPath": "patterns/page-and-placement/PATTERN.md",
       "examplePath": "patterns/page-and-placement/example",
       "files": [
@@ -5005,7 +5006,7 @@
         "@jskit-ai/users-web"
       ],
       "packageId": "@jskit-ai/users-web",
-      "packageVersion": "0.2.18",
+      "packageVersion": "0.2.19",
       "documentPath": "patterns/account-settings/PATTERN.md",
       "examplePath": "patterns/account-settings/example",
       "files": [
@@ -5101,7 +5102,7 @@
         "@jskit-ai/workspaces-web"
       ],
       "packageId": "@jskit-ai/workspaces-web",
-      "packageVersion": "0.2.18",
+      "packageVersion": "0.2.19",
       "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.28",
+  "version": "0.2.30",
   "description": "Published metadata catalog for JSKIT package metadata.",
   "type": "module",
   "files": [

package/scripts/material3.mjs

@@ -216,7 +216,7 @@ function checkTemplate(template, context) {
     }
     if (SURFACE_TAGS.has(tag.name)) checkSurface(tag, report);
     if (tag.name === "v-btn") checkButtonSize(tag, report);
-    checkBackControl(tag, report);
+    checkBackControl(tag, report, context.script);
     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.");
@@ -263,7 +263,9 @@ function checkFile(file, source, context) {
   const extension = path.extname(file);
   if (extension === ".vue") {
     const { template, scripts, styles } = splitVue(source);
-    if (template) checkTemplate({ offset: template.offset, text: blankHtmlComments(template.text) }, fileContext);
+    // The template's handlers are defined in the component's script.
+    const script = scripts.map((block) => blankJsComments(block.text)).join("\n");
+    if (template) checkTemplate({ offset: template.offset, text: blankHtmlComments(template.text) }, { ...fileContext, script });
     for (const block of scripts) checkScript(blankJsComments(block.text), block.offset, fileContext);
     for (const block of styles) checkCss(blankCssComments(block.text), block.offset, fileContext);
   } else if (extension === ".css" || extension === ".scss") {

package/scripts/navigation.mjs

@@ -29,7 +29,7 @@ const BOUND_PATH = /^\s*(?:\{\s*path\s*:\s*)?(["'`])(\/[^"'`]*)/u;
 // A back handler or back component: goBack, onBack, handleBackClick, useBackNavigation, PageBackButton, backToList.
 const BACK_NAME = String.raw`(?:[A-Za-z][\w$]*Back(?:[A-Z][\w$]*)?|Back[A-Z][\w$]*|back(?:To[A-Z][\w$]*)?)`;
 const BACK_IDENTIFIER = new RegExp(String.raw`(?<![\w$])${BACK_NAME}(?![\w$])`, "u");
-const BACK_DEFINITION = new RegExp(String.raw`\b(?:function\s*\*?\s*|const\s+|let\s+|var\s+|import\s+)(${BACK_NAME})(?![\w$])|\bimport\s*\{[^}]*?(?<![\w$])(${BACK_NAME})(?![\w$])[^}]*\}`, "gu");
+const BACK_DEFINITION = new RegExp(String.raw`\b(?:function\s*\*?\s*|const\s+|let\s+|var\s+)(${BACK_NAME})(?![\w$])`, "gu");
 const BACK_TEXT = /^\s*(?:[←‹«]|(?:go\s+)?back\b|return to\b)|\bback to\b/iu;
 const BACK_KEY = /\bback(?:To)?\b/iu;
 const ARROW_ICON = /arrow[-_]?back|arrow[-_]?left|keyboard[-_]?backspace|keyboard[-_]?return/iu;
@@ -40,10 +40,27 @@ const LABEL_ATTRIBUTES = new Set(["aria-label", "title", "label", "text"]);
 const ICON_ATTRIBUTES = new Set(["icon", "prepend-icon", "append-icon"]);
 const LINK_ATTRIBUTES = new Set(["to", "href"]);
 const NAVIGATES = /(?<![\w$])(?:[\w$]*router|useRouter\(\s*\))\s*\.\s*(?:push|replace)\s*\(|\.page\s*\(|resolve\w*Url\s*\(/iu;
+// App navigation in a handler or a function: the router, JSKIT paths, the shell's up() and finish(), a RouterLink's
+// navigate(), and the browser's own history and location.
+const APP_NAVIGATION = new RegExp([
+  NAVIGATES.source,
+  ROUTER_HISTORY_CALL.source,
+  HISTORY_CALL.source,
+  LOCATION_WRITE.source,
+  String.raw`(?<![\w$])(?:up|finish|navigate)\s*\(`,
+  String.raw`\.\s*(?:up|finish)\s*\(`
+].join("|"), "iu");
+// An embedded frame's history and location (a preview browser's Back and Forward) are the frame's, not the app's.
+const FRAME_NAVIGATION = /\bcontentWindow\s*\??\.\s*(?:history|location)(?:\s*\??\.\s*[\w$]+)*/gu;
+const CALLED_NAME = /(?<![\w$.])([A-Za-z_$][\w$]*)\s*\(/gu;
+const UP_OWNER = "Up belongs to the shell's top app bar: ShellLayout's, or ShellUpButton in a bar the layout draws itself";
 // Main navigation: the navigation bar, rail and drawer render shell.primary-nav and shell.secondary-nav links.
 const MAIN_NAV_TARGET = /\btarget\s*:\s*["']shell\.(?:primary|secondary)-nav["']/gu;
-// A layout that imports the app's ShellLayout wrapper or shell-web's ShellLayout renders the top app bar.
+// A layout that imports the app's ShellLayout wrapper or shell-web's ShellLayout renders the top app bar; one that
+// 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 LOCAL_IMPORT = /\bfrom\s*["']((?:@\/|\.{1,2}\/)[^"']+)["']/gu;
 const ROUTER_VIEW_TAG = /<\s*(?:RouterView|router-view)\b/u;
 
 function isInAppPath(value) {
@@ -84,13 +101,68 @@ function isPlacementLink(code, offset) {
   return Boolean(placement) && /\btarget\s*:\s*["'`][\w.-]+["'`]/u.test(placement.text) && /\bkind\s*:/u.test(placement.text);
 }
 
+// A back-named function that navigates the app; a variable, an import or an in-component step is not back logic.
 function checkScriptBackNames(code, offset, report) {
   for (const match of code.matchAll(BACK_DEFINITION)) {
-    const name = match[1] || match[2];
-    report("nav/back-control", offset + match.index, `${name} is back logic in the app. Up belongs to the shell; delete it and declare the page's parent.`);
+    if (!navigatesApp(definitionOf(code, match[1]), code)) continue;
+    report("nav/back-control", offset + match.index, `${match[1]} navigates back in the app. ${UP_OWNER}; delete it and declare the page's parent.`);
   }
 }
 
+// The text of a local function's definition: function name(...) { ... }, or const name = ... to its end.
+function definitionOf(script, name) {
+  const escaped = name.replace(/\$/gu, "\\$");
+  const declaration = new RegExp(String.raw`\bfunction\s*\*?\s*${escaped}\s*\(`, "u").exec(script);
+  if (declaration) {
+    const parameters = balancedFrom(script, declaration.index + declaration[0].length - 1, "(", ")");
+    return parameters ? balancedFrom(script, parameters.end)?.text || "" : "";
+  }
+  const binding = new RegExp(String.raw`\b(?:const|let|var)\s+${escaped}\s*=`, "u").exec(script);
+  return binding ? statementFrom(script, binding.index + binding[0].length) : "";
+}
+
+// An initialiser up to its statement's end: a semicolon or a line break outside brackets that ends the expression.
+function statementFrom(text, start) {
+  let depth = 0;
+  for (let index = start; index < text.length; index += 1) {
+    const char = text[index];
+    if ("([{".includes(char)) depth += 1;
+    else if (")]}".includes(char)) {
+      if (depth === 0) return text.slice(start, index);
+      depth -= 1;
+    } else if (depth === 0 && (char === ";" || char === "\n")) {
+      const sofar = text.slice(start, index);
+      if (char === ";" || (sofar.trim() && !/(?:=>|[=(,?:&|+*/-])\s*$/u.test(sofar))) return sofar;
+    }
+  }
+  return text.slice(start);
+}
+
+// Whether code navigates the app, directly or through the functions it calls that the component defines.
+function navigatesApp(code, script, seen = new Set()) {
+  const own = code.replace(FRAME_NAVIGATION, "");
+  if (APP_NAVIGATION.test(own)) return true;
+  for (const match of own.matchAll(CALLED_NAME)) {
+    if (seen.has(match[1])) continue;
+    seen.add(match[1]);
+    const definition = definitionOf(script, match[1]);
+    if (definition && navigatesApp(definition, script, seen)) return true;
+  }
+  return false;
+}
+
+// A control navigates the app when it links into it (to, or an in-app href) or one of its handlers navigates; a bare
+// handler name is a call. "Back to top" (href="#top") scrolls the page.
+function navigatesFromControl(tag, script) {
+  return tag.attributes.some((entry) => {
+    if (entry.name === "to") return true;
+    if (entry.name === "href") return entry.bound || isInAppPath(entry.value);
+    if (!entry.event) return false;
+    const handler = entry.value.trim();
+    return navigatesApp(/^[\w$.]+$/u.test(handler) ? `${handler}()` : handler, script);
+  });
+}
+
 function attribute(tag, name) {
   return tag.attributes.find((entry) => entry.name === name);
 }
@@ -108,33 +180,35 @@ function looksLikeBack(tag) {
   const mustaches = [...tag.inner.matchAll(/\{\{([\s\S]*?)\}\}/gu)].map((match) => match[1]);
   const labels = tag.attributes.filter((entry) => LABEL_ATTRIBUTES.has(entry.name));
   const icons = tag.attributes.filter((entry) => ICON_ATTRIBUTES.has(entry.name)).map((entry) => entry.value);
-  const navigates = tag.attributes.some((entry) => LINK_ATTRIBUTES.has(entry.name) || (entry.event && NAVIGATES.test(entry.value)));
   const iconText = [...icons, tag.inner].join(" ");
   return BACK_TEXT.test(visibleText(tag.inner)) ||
     mustaches.some((expression) => BACK_KEY.test(expression)) ||
     labels.some((entry) => (entry.bound ? BACK_KEY : BACK_TEXT).test(entry.value)) ||
     ARROW_ICON.test(iconText) ||
-    (navigates && CHEVRON_ICON.test(iconText));
+    CHEVRON_ICON.test(iconText);
 }
 
-// Every back control but the shell's Up arrow: "Back to X", arrows and navigating chevrons, breadcrumbs, back
-// components and back handlers.
-function checkBackControl(tag, report) {
+// Every back control but the shell's Up arrow: a control that navigates the app and reads as back ("Back to X", an
+// arrow or chevron, a back component or handler), and breadcrumbs. Prose, a variable, an in-component step and an
+// embedded frame's own Back and Forward navigate nothing in the app. `script` is the component's script, where its
+// handlers are defined.
+function checkBackControl(tag, report, script = "") {
   if (BREADCRUMB_TAGS.has(tag.name)) {
     report("nav/back-control", tag.offset, "Breadcrumbs navigate back up the hierarchy. The shell's Up arrow does that; the app bar title says where the person is.");
     return;
   }
+  if (!navigatesFromControl(tag, script)) return;
   if (isBackTag(tag)) {
-    report("nav/back-control", tag.offset, `<${tag.name}> is a back control. Up belongs to the shell; remove it and declare the page's parent.`);
+    report("nav/back-control", tag.offset, `<${tag.name}> is a back control. ${UP_OWNER}; remove it and declare the page's parent.`);
     return;
   }
   const handler = tag.attributes.find((entry) => entry.event && BACK_IDENTIFIER.test(entry.value));
   if (handler) {
-    report("nav/back-control", handler.offset, `${handler.raw}="${handler.value.trim()}" is a back handler. Up belongs to the shell; remove the control and declare the page's parent.`);
+    report("nav/back-control", handler.offset, `${handler.raw}="${handler.value.trim()}" is a back handler. ${UP_OWNER}; remove the control and declare the page's parent.`);
     return;
   }
   if (CLICKABLE_TAGS.has(tag.name) && looksLikeBack(tag)) {
-    report("nav/back-control", tag.offset, "A back control in the page. Up appears once, in the top app bar, from the trail or the declared parent; remove this one.");
+    report("nav/back-control", tag.offset, `A back control in the page. ${UP_OWNER}, from the trail or the declared parent; remove this one.`);
   }
 }
 
@@ -254,10 +328,39 @@ function readPage(file, source) {
     redirect: REDIRECT_KEY.test(meta),
     parent: declarations.find(({ text }) => PARENT_KEY.test(text)),
     surfaceRoot: SURFACE_KEY.test(meta.replace(PARENT_OBJECT, "")),
-    shell: SHELL_LAYOUT_IMPORT.test(source)
+    shell: false
   };
 }
 
+// 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) {
+  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 || "");
+    for (const match of source.matchAll(LOCAL_IMPORT)) {
+      if (verdict) break;
+      const imported = localComponent(file, match[1], known);
+      verdict = Boolean(imported) && await drawsShellBar(imported);
+    }
+    verdicts.set(file, verdict);
+    return verdict;
+  }
+  return drawsShellBar;
+}
+
+// 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("@/")
+    ? path.posix.join("src", specifier.slice(2))
+    : path.posix.join(path.posix.dirname(file), specifier);
+  return [base, `${base}.vue`].find((candidate) => candidate.endsWith(".vue") && known.has(candidate)) || null;
+}
+
 /**
  * The page rules: an inner page of a shell surface has a parent, its own or its layout's; a main-navigation
  * destination declares none.
@@ -274,6 +377,10 @@ async function checkPageParents({ root, appFiles, pageFiles, report }) {
   }
   const pages = new Map();
   for (const file of appFiles.filter(isPageFile)) pages.set(pageKey(file), readPage(file, await read(file)));
+  const drawsShellBar = createShellBarReader(appFiles, read);
+  for (const page of pages.values()) {
+    if (page.layout) page.shell = await drawsShellBar(page.file);
+  }
   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)))));