@featherk/composables 0.5.0 → 0.5.2

package/README.md

@@ -2,6 +2,19 @@
 
 Vue 3 composables that improve Kendo UI for Vue behavior and accessibility.
 
+## Composables Overview
+
+- **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)
+- **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.
+  - Guide: [docs/range/useMaskedDateRangeInput.md](https://github.com/NantHealth/featherk/blob/integration/packages/composables/docs/range/useMaskedDateRangeInput.md)
+- **Time**: `useMaskedTimeInput` — Masked single-time input with AM/PM conveniences and bounds.
+  - Guide: [docs/time/useMaskedTimeInput.md](https://github.com/NantHealth/featherk/blob/integration/packages/composables/docs/time/useMaskedTimeInput.md)
+- **Trap**: `usePopupTrap` — Focus trap + Escape/Outside click close behavior for popups.
+  - Guide: [docs/trap/usePopupTrap.md](https://github.com/NantHealth/featherk/blob/integration/packages/composables/docs/trap/usePopupTrap.md)
+
 ## Importing Composables
 
 You can import directly from subpaths or from the package root.
@@ -9,14 +22,17 @@ You can import directly from subpaths or from the package root.
 Subpath imports (recommended for clarity):
 
 ```ts
+// Grid
+import { useGridA11y } from '@featherk/composables/grid';
+
 // Date input
-import { useMaskedDateInput, DateChangePayload } from '@featherk/composables/date';
+import { useMaskedDateInput, type DateChangePayload } from '@featherk/composables/date';
 
 // Date range input
-import { useMaskedDateRangeInput, RangeChangePayload } from '@featherk/composables/range';
+import { useMaskedDateRangeInput, type RangeChangePayload } from '@featherk/composables/range';
 
 // Time input
-import { useMaskedTimeInput, TimeChangePayload } from '@featherk/composables/time';
+import { useMaskedTimeInput, type TimeChangePayload } from '@featherk/composables/time';
 
 // Popup focus trap utilities
 import { usePopupTrap } from '@featherk/composables/trap';
@@ -27,50 +43,11 @@ Root imports (types are aliased to avoid name collisions):
 ```ts
 import {
   useMaskedDateInput,
-  DateChangePayload,
-  useMaskedDateRangeInput,
-  RangeChangePayload,
-  useMaskedTimeInput,
-  TimeChangePayload,
-  usePopupTrap,
-} from '@featherk/composables';
-```
-
-## useGridA11y — Integration Quick Reference
-
-## Composables Overview
-
-- **Grid**: `useGridA11y` — Accessible row-level navigation and column menu keyboard support.
-  - Guide: [docs/grid/useGridA11y.md](./docs/grid/useGridA11y.md)
-- **Date**: `useMaskedDateInput` — Masked single-date input with steppers and validation.
-  - Guide: [docs/date/useMaskedDateInput.md](./docs/date/useMaskedDateInput.md)
-- **Range**: `useMaskedDateRangeInput` — Masked date range input with validation, clamp, and optional popup coordination.
-  - Guide: [docs/range/useMaskedDateRangeInput.md](./docs/range/useMaskedDateRangeInput.md)
-- **Time**: `useMaskedTimeInput` — Masked single-time input with AM/PM conveniences and bounds.
-  - Guide: [docs/time/useMaskedTimeInput.md](./docs/time/useMaskedTimeInput.md)
-- **Trap**: `usePopupTrap` — Focus trap + Escape/Outside click close behavior for popups.
-  - Guide: [docs/trap/usePopupTrap.md](./docs/trap/usePopupTrap.md)
-
-## Importing
-
-Subpath imports (recommended):
-
-```ts
-import { useGridA11y } from '@featherk/composables/grid';
-import { useMaskedDateInput } from '@featherk/composables/date';
-import { useMaskedDateRangeInput } from '@featherk/composables/range';
-import { useMaskedTimeInput } from '@featherk/composables/time';
-import { usePopupTrap } from '@featherk/composables/trap';
-```
-
-Root import (types are aliased to avoid collisions):
-
-```ts
-import {
-  useGridA11y,
-  useMaskedDateInput,
+  type DateChangePayload,
   useMaskedDateRangeInput,
+  type RangeChangePayload,
   useMaskedTimeInput,
+  type TimeChangePayload,
   usePopupTrap,
 } from '@featherk/composables';
 ```

package/docs/date/useMaskedDateInput.md

@@ -1,6 +1,6 @@
 # useMaskedDateInput
 
-[← Back to Composables README](../../README.md)
+[← Back to Composables README](https://github.com/NantHealth/featherk/blob/integration/packages/composables/README.md)
 
 Composable for a masked single-date input that pairs naturally with Kendo Vue `MaskedTextBox`, and optionally coordinates with a `DatePicker`. It handles typed input in the mask `MM/DD/YYYY`, keyboard steppers (ArrowUp/ArrowDown), wheel steppers, caret persistence, min/max range validation, and clean emission only when the input is complete and valid.
 

package/docs/grid/useGridA11y.md

@@ -1,6 +1,6 @@
 # useGridA11y
 
-[← Back to Composables README](../../README.md)
+[← Back to Composables README](https://github.com/NantHealth/featherk/blob/integration/packages/composables/README.md)
 
 Composable that augments a Kendo Vue Grid with accessible keyboard navigation, focus management, and custom behaviors for column header menus (filter/sort).
 
@@ -10,7 +10,7 @@ Composable that augments a Kendo Vue Grid with accessible keyboard navigation, f
 - `@progress/kendo-vue-grid`
 - `@featherk/composables`
 
-Install (if needed):
+Install:
 
 ```bash
 npm install @featherk/composables

package/docs/range/useMaskedDateRangeInput.md

@@ -1,6 +1,6 @@
 # useMaskedDateRangeInput
 
-[← Back to Composables README](../../README.md)
+[← Back to Composables README](https://github.com/NantHealth/featherk/blob/integration/packages/composables/README.md)
 
 Composable for a masked date range input that pairs naturally with Kendo Vue `MaskedTextBox` and `Calendar`. It handles typed input in the mask `MM/DD/YYYY - MM/DD/YYYY`, keyboard steppers (ArrowUp/ArrowDown), wheel steppers, caret persistence, min/max clamping, ordered range validation, span calculation, and optional popup-close coordination when the calendar sets the value.
 

package/docs/time/useMaskedTimeInput.md

@@ -1,6 +1,6 @@
 # useMaskedTimeInput
 
-[← Back to Composables README](../../README.md)
+[← Back to Composables README](https://github.com/NantHealth/featherk/blob/integration/packages/composables/README.md)
 
 Composable for a masked single-time input that pairs naturally with Kendo Vue `MaskedTextBox`, and optionally coordinates with a `TimePicker`. It handles typed input in the mask `hh:mm AM`, keyboard steppers (ArrowUp/ArrowDown), wheel steppers, caret persistence, minute step granularity, min/max time validation, and clean emission only when the input is complete and valid.
 

package/docs/trap/usePopupTrap.md

@@ -1,6 +1,6 @@
 # usePopupTrap
 
-[← Back to Composables README](../../README.md)
+[← Back to Composables README](https://github.com/NantHealth/featherk/blob/integration/packages/composables/README.md)
 
 Composable for managing focus trapping and close behavior for popup UIs (e.g., Kendo `Popup`, `DatePicker`, `TimePicker` dropdowns). It provides focus trapping via `@vueuse/integrations/useFocusTrap`, Escape/OutsideClick to close, automatic popup element discovery, and optional return-to-trigger focus.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featherk/composables",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "main": "dist/featherk-composables.umd.js",
   "module": "dist/featherk-composables.es.js",
   "types": "dist/index.d.ts",