@synopackageland/ui 0.25.15 → 0.25.17

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 ## Unreleased
 
+## 0.25.17 (2026-11-14)
+
+### Grid
+
+- **A click on the row number opens the record.** In `@synopackageland/ui/grid`, a mouse click on the row header outside its controls now emits `row-expand(row)`, the event the expand control and Space already send. The cursor there is a pointer. The checkbox keeps toggling the selection and never opens.
+  - Only when a `row-expand` listener is bound. Without one, the click keeps the old behaviour (nothing opens, the selection stays), so Apps that do not open records are unaffected.
+  - With only a `checkbox` control, the checkbox covers the number, so a click there still selects.
+  - `GridHostController` takes an optional `canExpandRow()` hook, asked at click time.
+  - Touch is unchanged: a tap on the row header follows the finger rules.
+
+## 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)
 
 ### Tags

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>;

package/dist/grid/host/controller.d.ts

@@ -48,6 +48,13 @@ export interface GridHostHooks {
     clearRequest: (selection: GridSelectionState) => void;
     /** Open the row's record. `columnIndex`: the tapped field, on a phone (scroll the record to it). */
     rowExpand: (rowIndex: number, columnIndex?: number) => void;
+    /**
+     * Whether anyone opens records (`GridHost`: a `row-expand` listener is
+     * bound). True: a click on the row header outside its controls (on the row
+     * number) opens the record. False or absent: that click selects nothing and
+     * opens nothing, as before.
+     */
+    canExpandRow?: () => boolean;
     headerMenu: (columnIndex: number, rect: GridRect) => void;
     columnResize: (columnIndex: number, width: number, done: boolean) => void;
     reorder: (kind: 'columns' | 'rows', ranges: readonly GridRange[], dropIndex: number) => void;
@@ -158,6 +165,8 @@ export declare class GridHostController {
     private get isFillEnabled();
     /** No resize handle on touch: a 5 px edge is no finger target. */
     private get isResizeEnabled();
+    /** A click on the row number opens the record (someone listens for `rowExpand`). */
+    private get canExpandRow();
     /** True while the fill handle is dragged. */
     get isFilling(): boolean;
     /**