@featherk/composables 0.12.2 → 0.12.4

package/dist/menu/usePopupMenu.d.ts

@@ -12,6 +12,8 @@ export type PopupMenuAnchorOptions = {
     clipRoot?: MaybeRefOrGetter<Element | null>;
     /** Closes the menu after its trigger leaves the clipping container. */
     hideWhenAnchorClipped?: boolean;
+    /** Intersection ratio required to keep the anchor considered visible. Defaults to `0.5`. */
+    intersectionThreshold?: number | number[];
     /** Overrides the trigger rect for pointer-positioned menus. */
     getRect?: () => DOMRect | null;
 };

package/docs/menu/usePopupMenu.md

@@ -247,7 +247,7 @@ See [UsePopupMenu.vue](https://github.com/NantHealth/featherk/blob/integration/d
 - `manageMenuTriggerAria?: boolean`: Keeps `aria-expanded` in sync with `isOpen` on the resolved `triggerRef` element. Defaults to `true`. The consumer always owns the static `aria-haspopup="menu"` attribute and the baseline `aria-expanded="false"`; the composable only ever writes `aria-expanded` and never removes it. Set to `false` to own `aria-expanded` yourself too.
 - `menuLabel?: MaybeRefOrGetter<string | null | undefined>`: Optional accessible name applied as `aria-label` to the rendered `ul[role="menubar"]`. Empty labels remove the managed attribute.
 - `triggerMode: "button" | "row"`: Required. Declares the trigger semantics so a misrouted `triggerRef` (e.g. one that unexpectedly resolves to a `tr.k-table-row` while `triggerMode: "button"` is set) is never silently managed; a mismatch logs a `console.warn` and skips ARIA management for that resolution. Use `"row"` only when a `tr.k-table-row` owns the menu trigger. Neither mode adds `role`, `tabindex`, or keyboard behavior.
-- `anchor?: true | PopupMenuAnchorOptions`: Enables document-relative `offset` tracking for dynamically retargeted Popups. `true` uses the resolved trigger's rectangle and nearest scrollable ancestor. `PopupMenuAnchorOptions` accepts `clipRoot`, `hideWhenAnchorClipped`, and `getRect` for pointer-positioned menus. Internally, the anchor-hidden policy uses `useIntersectionObserver` with `threshold: 1`; a clipped trigger closes with `"anchor-hidden"` without restoring focus.
+- `anchor?: true | PopupMenuAnchorOptions`: Enables document-relative `offset` tracking for dynamically retargeted Popups. `true` uses the resolved trigger's rectangle and nearest scrollable ancestor. `PopupMenuAnchorOptions` accepts `clipRoot`, `hideWhenAnchorClipped`, `intersectionThreshold`, and `getRect` for pointer-positioned menus. The threshold defaults to `0.5`; use `intersectionThreshold: 0` when any partially visible trigger should remain open. A fully clipped trigger closes with `"anchor-hidden"` without restoring focus.
 
 `PopupMenuElementRef` accepts a normal `HTMLElement` ref or a Vue/Kendo component ref that exposes `$el`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featherk/composables",
-  "version": "0.12.2",
+  "version": "0.12.4",
   "main": "dist/featherk-composables.umd.js",
   "module": "dist/featherk-composables.es.js",
   "types": "dist/index.d.ts",
@@ -64,6 +64,11 @@
       "types": "./dist/id/index.d.ts",
       "import": "./dist/featherk-composables.es.js",
       "require": "./dist/featherk-composables.umd.js"
+    },
+    "./docs-manifest": {
+      "types": "./dist/docs-manifest.d.ts",
+      "import": "./dist/docs-manifest.js",
+      "default": "./dist/docs-manifest.js"
     }
   },
   "files": [
@@ -71,8 +76,9 @@
     "docs"
   ],
   "scripts": {
-    "build": "vite build && npm run build:types",
+    "build": "vite build && npm run build:types && npm run build:docs-manifest",
     "build:types": "vue-tsc --emitDeclarationOnly --declaration --declarationDir dist",
+    "build:docs-manifest": "node ../../scripts/generate-docs-manifest.mjs",
     "test": "vitest --config vitest.config.ts",
     "test:unit": "vitest run --config vitest.config.ts",
     "test:coverage": "vitest run --config vitest.config.ts --coverage",