@synopackageland/ui 0.25.15 → 0.25.16

package/CHANGELOG.md

@@ -1,6 +1,17 @@
 # Changelog
 
-## Unreleased
+## 0.25.16 (2026-11-14)
+
+### Phone shell
+
+- **Home in the browser launcher too, and drawn as Home.** Inside the Package Land launcher, the button now shows in the browser build as well as in the phone app.
+  - The browser launcher names the App's frame `synopkg-shell:1:close`, and a tap posts `{ v: 1, type: 'close' }` to the parent at the page's own origin.
+  - The button is now a home icon labelled Home, matching the launcher's own bars. It was a back arrow labelled "Back to apps".
+- **Inside the launcher, every page leads with Home; Back is the system one.**
+  - A sub-page (AppLayout `back`, a `PageHeader` with `back`, a pushed page) shows Home before its title instead of the Back arrow.
+  - Each sub-page is a history entry of the App, so the system Back steps through sub-pages before the launcher leaves the App. Android's back and the browser's back or swipe both work this way.
+  - A pushed page keeps its single entry.
+  - Outside the launcher, sub-pages keep their Back arrow and take no entry.
 
 ## 0.25.15 (2026-11-13)
 

package/dist/components/app/app-layout/pageTitle.d.ts

@@ -15,6 +15,11 @@ interface PageTitleEntry {
      * AppLayout's own `title` says: the page and its way back are one row.
      */
     back?: () => void;
+    /**
+     * The sub-page already owns a history entry (a pushed page), so the
+     * browser's Back reaches it without another one from the layout.
+     */
+    history?: boolean;
 }
 /**
  * The bar's page title (the phone bar, or the bar of a short screen). A
@@ -75,6 +80,7 @@ export declare function createPageTitleHost(main: Readonly<Ref<HTMLElement | nul
 export declare function usePageTitle(element: Readonly<Ref<HTMLElement | null>>, title: () => string, options?: {
     back?: () => (() => void) | undefined;
     when?: () => boolean;
+    history?: boolean;
 }): ComputedRef<boolean>;
 /**
  * Where a component's actions render on a phone: the phone bar or the FAB

package/dist/components/app/app-layout/shellBack.d.ts

@@ -1,14 +1,14 @@
 import { ComputedRef, InjectionKey, Ref } from 'vue';
 /**
- * Back to the phone app's App list (docs/mobile-native.md, "Back to the App
- * list"). On a root page AppLayout leads its phone bar with it. When that bar
+ * Home in the Package Land launcher, the phone app or its browser build
+ * (docs/adaptive-layout.md). On a root page AppLayout leads its phone bar with it. When that bar
  * is not drawn (a tab page with `phone-bar-title="none"` and nothing else in
  * the bar), the page's first row takes it instead: the first PageToolbar,
  * SectionTabs row or PageHeader in the page, in document order, so it costs
  * no row of its own. With no such row the bar is drawn for it.
  */
 export interface ShellBackHost {
-    /** The page's first row should lead with Back. */
+    /** The page's first row should lead with Home. */
     readonly wanted: Readonly<Ref<boolean>>;
     /** The row that holds Back now (its registration), if any. */
     readonly owner: Readonly<Ref<symbol | undefined>>;
@@ -19,5 +19,5 @@ export interface ShellBackHost {
 export declare const APP_SHELL_BACK_KEY: InjectionKey<ShellBackHost>;
 /** AppLayout's side: the rows that could hold Back, and the one that does. */
 export declare function createShellBackHost(wanted: Readonly<Ref<boolean>>): ShellBackHost;
-/** A row's side: true while this row leads with Back. */
+/** A row's side: true while this row leads with Home. */
 export declare function useShellBackRow(element: () => HTMLElement | null | undefined): ComputedRef<boolean>;