@synopackageland/ui 0.20.18 → 0.20.19

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 0.20.19 (2026-11-06)
+
+- The phone navigation drawer returns focus to its opener inside the shell (the menu button or a More tab) after Escape, Close, a navigation pick, Back or a swipe. If a touch tap left focus on the host page outside the shell, it falls back to the menu button instead of returning focus to the host. It waits until the drawer has left and the background is no longer inert
+- Dialog, Sheet, BottomSheet, RecordPanel and notifications remember focus only inside their AppRoot (including its floating dialog host). A touch-opened overlay ignores the host page's focused element and returns to the pressed control inside the app; existing closeAutoFocus overrides still take precedence
+
 ## 0.20.18 (2026-11-06)
 
 - `Callout` takes `dismissScope`. `persistent` (the default) keeps today's behaviour: a closed callout stays closed after a reload until what it says changes. `occurrence` is for a notice about a passing state (reconnecting, an error, a stalled capture) that the App shows with `v-if` while the state lasts: closing hides this appearance only, nothing is stored, and the dismissal is forgotten when the Callout unmounts, so the next time the state starts the notice shows again. `dismissalKey` and `forgetDismissal` are exported: `forgetDismissal(dismissalKey('reconnecting'))` shows the callout with that `dismissKey` again (docs/callout.md, "Closing")

package/dist/composables/focusOwner.d.ts

@@ -0,0 +1,4 @@
+import { InjectionKey, Ref } from 'vue';
+export declare const APP_FOCUS_ROOT_KEY: InjectionKey<Ref<HTMLElement | null>>;
+/** Remember only this app's controls, including its viewport portal. */
+export declare function useFocusOwner(): (element: HTMLElement) => boolean;

package/dist/composables/openerFocus.d.ts

@@ -6,7 +6,8 @@ export declare const OPENER_FOCUS_FRAMES = 120;
  * an element that had focus when the content mounted, so a bottom sheet, and
  * a dialog opened by a click that did not focus its button (Safari, touch),
  * left focus on <body> when Escape or the Close button shut it. The opener is
- * the focused element when `open` turns true, else the control just pressed.
+ * the focused element inside the app when `open` turns true, else the control
+ * just pressed inside the app, else the supplied fallback trigger.
  *
  * The returned handler, called from the content's `closeAutoFocus` after the
  * consumer's own listener, runs when the overlay starts to close: its content
@@ -21,4 +22,7 @@ export declare const OPENER_FOCUS_FRAMES = 120;
  * document. A consumer that prevents the default
  * keeps full control.
  */
-export declare function useOpenerFocus(open: () => boolean): (event: Event) => void;
+export declare function useOpenerFocus(open: () => boolean, options?: {
+    contains?: (element: HTMLElement) => boolean;
+    fallback?: () => HTMLElement | null;
+}): (event: Event) => void;