@featherk/composables 0.6.19 → 0.7.2

package/README.md

@@ -6,6 +6,8 @@ Vue 3 composables that improve Kendo UI for Vue behavior and accessibility.
 
 - **Grid**: `useGridA11y` — Accessible row-level navigation and column menu keyboard support.
   - Guide: [docs/grid/useGridA11y.md](https://github.com/NantHealth/featherk/blob/integration/packages/composables/docs/grid/useGridA11y.md)
+- **Grid**: `useGridActiveFilter` — Reactive header class resolver that marks filtered columns as `"active"`.
+  - Guide: [docs/grid/useGridActiveFilter.md](https://github.com/NantHealth/featherk/blob/integration/packages/composables/docs/grid/useGridActiveFilter.md)
 - **Date**: `useMaskedDateInput` — Masked single-date input with steppers and validation.
   - Guide: [docs/date/useMaskedDateInput.md](https://github.com/NantHealth/featherk/blob/integration/packages/composables/docs/date/useMaskedDateInput.md)
 - **Range**: `useMaskedDateRangeInput` — Masked date range input with validation, clamp, and optional popup coordination.
@@ -23,7 +25,7 @@ Subpath imports (recommended for clarity):
 
 ```ts
 // Grid
-import { useGridA11y } from '@featherk/composables/grid';
+import { useGridA11y, useGridActiveFilter } from '@featherk/composables/grid';
 
 // Date input
 import { useMaskedDateInput, type DateChangePayload } from '@featherk/composables/date';
@@ -42,6 +44,8 @@ Root imports (types are aliased to avoid name collisions):
 
 ```ts
 import {
+  useGridA11y,
+  useGridActiveFilter,
   useMaskedDateInput,
   type DateChangePayload,
   useMaskedDateRangeInput,
@@ -52,51 +56,16 @@ import {
 } from '@featherk/composables';
 ```
 
-> I am getting build failures requesting libraries @vueuse/core @vueuse/integrations and focus-trap, when using only useGridA11y composable.
-> useGridA11y currently does not use useFocusTrap composable, but has its own internal method for maintaining focus trap.  useGridA11y does not require the @vueuse or focus-trap libraries.
-
-**Why this happens:**
-
-- If a dependency is imported or required anywhere in the package entry points (even if not used by your code), your bundler or Node will try to resolve it.
-- In index.ts, all composables are exported from a single file, so importing from `@featherk/composables` pulls in all submodules, including those that import `@vueuse/core`, `@vueuse/integrations`, and `focus-trap`.
-
-**Workarounds:**
-
-1. **Use subpath imports**
-
-   Import only what you need, e.g.:
-
-   ```ts
-   import { useGridA11y } from '@featherk/composables/grid';
-   ```
-
-   This avoids loading the popup/focus-trap code.
-
-2. **Install the dependencies**
-   If you must use the root import, you need to install all peer dependencies:
-
-   ```bash
-   npm install @vueuse/core @vueuse/integrations focus-trap
-   ```
-
-**Recommendation:**
-Prefer subpath imports for tree-shaking and to avoid unnecessary dependencies, as described in the README.
-
-If you think this should be improved, consider opening an issue or PR to make `focus-trap` and VueUse truly optional by moving their imports inside the `usePopupTrap` function or using dynamic imports.
+`usePopupTrap` depends on VueUse integrations and focus-trap internally. Those runtime packages are shipped as regular dependencies of `@featherk/composables`, so consumers do not need to install them separately.
 
 ## Peer Dependencies
 
 - Required: `vue`
-- Optional (for `usePopupTrap`): `@vueuse/core`, `@vueuse/integrations`, `focus-trap`
 
 ```bash
 npm install vue
-# If you use usePopupTrap, or any of the date/time based composables
-npm install @vueuse/core @vueuse/integrations focus-trap
 ```
 
-> Note: VueUse and focus-trap are declared as optional peer dependencies so apps that don’t use `usePopupTrap` aren’t forced to install them. They are present as devDependencies in this repo to enable local type-checking and builds.
-
 ## Notes
 
-- The runtime file `useGridA11y.ts` currently lives at the package root for compatibility. It may move to `src/grid` in a future release, but root exports will remain to avoid breaking imports.
+- The runtime files for `useGridA11y` and `useGridActiveFilter` live in `src/grid/`. Both are re-exported from the package root and from `@featherk/composables/grid` — no import path changes are needed by consumers.

package/dist/__tests__/fixtures.d.ts

@@ -0,0 +1,9 @@
+type FixtureResult = {
+    root: HTMLElement;
+    input: HTMLInputElement;
+    cleanup: () => void;
+};
+export declare const createDatePickerFixture: (id: string) => FixtureResult;
+export declare const createTimePickerFixture: (id: string) => FixtureResult;
+export declare const createDateRangeFixture: (id: string) => FixtureResult;
+export {};

package/dist/__tests__/withSetupHarness.d.ts

@@ -0,0 +1,9 @@
+import { type ComponentPublicInstance } from "vue";
+import { type VueWrapper } from "@vue/test-utils";
+type SetupFactory<T> = () => T;
+export declare function withSetupHarness<T>(factory: SetupFactory<T>): Promise<{
+    api: T;
+    wrapper: VueWrapper<ComponentPublicInstance>;
+    unmount: () => void;
+}>;
+export {};

package/dist/date/useMaskedDateInput.test.d.ts

@@ -0,0 +1 @@
+export {};