@featherk/composables 0.9.6 → 0.9.8

package/docs/address/useUSAddress.md

@@ -121,11 +121,18 @@ Optional feedback semantics are exposed separately from required validation:
 - `optionalPartialInvalid`: optional mode has some address input, but the address
   is not fully valid.
 - `optionalFeedbackActive`: optional partial-invalid state is currently eligible
-  for UX messaging (after fieldset blur or failed submit attempt).
+  for UX messaging (after the fieldset is blurred following the latest address
+  edit, or after a failed submit attempt). This avoids showing partial-address
+  feedback immediately while the user is still editing inside the fieldset.
 - `optionalMissingRequiredFields`: optional mode is missing Address 1, City,
   and/or State while partial input exists.
 - `optionalZipInvalid`: optional mode has address input and ZIP is not exactly
   5 or 9 digits (including empty ZIP).
 
+Address 2 is included when detecting whether optional address input exists, but
+it is excluded from the completeness requirement. Entering only Address 2 is
+therefore treated as a partial optional address after fieldset blur or failed
+submit.
+
 If required toggles from `false` to `true`, validation remains dormant until the
 next submit or fieldset focusout.

package/docs/date/useMaskedDateInput.md

@@ -160,12 +160,14 @@ Creates a controller for a masked single-date input.
 ## Behavior Details
 
 - **Mask and parsing**: Expects `00/00/0000`. Parsing requires the input to be complete (10 chars including slashes, 8 digits) and form a real calendar date (e.g., Feb 29 checks).
+- **Minimum year**: The masked input supports four-digit years from `1000` onward. Dates earlier than `1000`, including zero-filled years such as `0001`, `0035`, and `0850`, are treated as invalid dates.
 - **Emission policy**: Emits `Date` only when the raw is complete, valid, and within `min`/`max`. Otherwise emits `null`. Empty input emits `null`.
 - **Min/Max validation**: If provided, dates outside bounds are considered invalid (`isValid=false`) and produce a range `validationMessage`.
 - **Steppers**: ArrowUp/ArrowDown and mouse wheel increment/decrement the focused part (`mm`, `dd`, `yyyy`) with wrapping (months and days). If raw is incomplete/invalid, steppers initialize to today, emit that date (if in range), and restore caret.
 - **Caret persistence**: After programmatic updates (including steppers), the caret is restored to the prior position to preserve typing flow.
 - **Space key**: The input consumes Space and calls `onShowCalendar` to open the DatePicker popup without inserting a space into `raw`.
 - **External sync**: When `externalValue` is set to a valid date, `raw` mirrors it (e.g., from a calendar selection). If external becomes null/invalid, `raw` is preserved to avoid clobbering in-progress text.
+- **DatePicker bounds**: Kendo `DatePicker` has its own `min`/`max` range, with a default minimum of `01/01/1900`. When using the masked slot with historical dates before 1900, pass a matching `min` to `DatePicker`; otherwise the composable can accept the typed date while the popup calendar still displays a clamped or previous calendar value.
 - **Styling hook**: On mount, adds `fk-datepicker` class to the parent of the closest `.k-datepicker` element for theming. The composable also exposes `initStyling()` so consumers can re-run styling when needed (for example, after Kendo performs DOM updates). `initStyling()` is safe to call repeatedly — it is idempotent.
 
 ## Integration Patterns

package/package.json

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