@vc-shell/framework 2.6.0-rc.0-pr353.bd5718a → 2.6.0-rc.0-pr356.4dee172

package/dist/core/utilities/focus.d.ts

@@ -1,3 +1,26 @@
+/**
+ * Focuses `getTarget()` — but only if nothing meaningful holds focus by then.
+ *
+ * Use it where the shell changes context (a route change, a panel opening, a control
+ * being replaced) and focus would otherwise be left on `<body>`, making the next Tab
+ * restart from the top of the document (WCAG 2.4.3 Focus Order).
+ *
+ * Two details make this a shared helper rather than an inline `focus()` call:
+ *
+ * - **The check must happen after the DOM is patched.** At call time the node the
+ *   user interacted with is usually still focused *and still connected*, and only
+ *   becomes detached during the patch that follows. Testing "was focus lost?" any
+ *   earlier answers "no", so the call is skipped — and focus drops to `<body>` a tick
+ *   later.
+ * - **It must decline when focus is held.** A view that autofocuses a field keeps it,
+ *   and a user who has already moved on is not interrupted. This repairs lost focus;
+ *   it does not dictate focus.
+ *
+ * For deliberately taking focus (opening a menu, entering an editor) call `focus()`
+ * directly — this helper will refuse.
+ *
+ * `getTarget` is a callback because the target often does not exist yet at call time.
+ */
 export declare function focusIfLoose(getTarget: () => HTMLElement | null | undefined): void;
 /**
  * The region focus falls back to when nothing more specific is available —

package/dist/core/utilities/focus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../../core/utilities/focus.ts"],"names":[],"mappings":"AAwCA,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CASlF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,GAAG,IAAI,CAExD"}
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../../core/utilities/focus.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAWlF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,GAAG,IAAI,CAExD"}