@lilydesignsystem/angular-date-time-picker 0.1.2 → 0.2.1

package/README.md

@@ -10,7 +10,7 @@ order, 12- vs 24-hour clock and AM/PM names all come from `Intl`.
 
 Canonical contract: [spec/index.md](./spec/index.md). This package is the
 Angular port of the Svelte-canonical
-[`@lilydesignsystem/svelte-date-time-picker`](../../lily-design-system-svelte-helpers/lily-design-system-svelte-date-time-picker/).
+[`@lilydesignsystem/svelte-date-time-picker`](../lily-design-system-svelte-date-time-picker/).
 
 ## Install
 
@@ -62,11 +62,11 @@ export class BookingComponent {
 
 ## The value is always ISO
 
-| `mode` | `value` |
-| ------ | ------- |
-| `"date"` (default) | `"2026-03-15"` |
-| `"time"` | `"09:30"` |
-| `"datetime"` | `"2026-03-15T09:30"` |
+| `mode`             | `value`              |
+| ------------------ | -------------------- |
+| `"date"` (default) | `"2026-03-15"`       |
+| `"time"`           | `"09:30"`            |
+| `"datetime"`       | `"2026-03-15T09:30"` |
 
 Sortable as a string, unambiguous in every locale, and identical to what
 `<input type="date">` posts — so you can swap the native control in or out
@@ -193,10 +193,16 @@ once on open — hide it visually with your own CSS if you prefer.
 ### Replace the glyph
 
 ```html
-<lily-date-time-picker [label]="label" [labels]="labels">
-  <ng-template lilyDateTimePickerIcon let-args>
+<lily-date-time-picker
+  [label]="label"
+  [labels]="labels"
+>
+  <ng-template
+    lilyDateTimePickerIcon
+    let-args
+  >
     <my-calendar-icon [expanded]="args.open" />
-    <span class="visually-hidden">{{ args.display }}</span>
+    <span class="screen-reader-span">{{ args.display }}</span>
   </ng-template>
 </lily-date-time-picker>
 ```
@@ -269,13 +275,18 @@ nobody wants to page a calendar back forty years.
 - [`@lilydesignsystem/angular-locale-picker`](../lily-design-system-angular-locale-picker/)
 - [`@lilydesignsystem/angular-text-size-picker`](../lily-design-system-angular-text-size-picker/)
 - [`@lilydesignsystem/angular-share-picker`](../lily-design-system-angular-share-picker/)
-- [`@lilydesignsystem/svelte-date-time-picker`](../../lily-design-system-svelte-helpers/lily-design-system-svelte-date-time-picker/) — the canonical Svelte original.
+- [`@lilydesignsystem/svelte-date-time-picker`](../lily-design-system-svelte-date-time-picker/) — the canonical Svelte original.
 
 ## License
 
 MIT or Apache-2.0 or GPL-2.0 or GPL-3.0 or BSD-3-Clause. Contact
 joel@joelparkerhenderson.com for other terms.
 
+## Known limitations
+
+- **Week numbers are ISO 8601 only.** `showWeekNumbers` numbers weeks the ISO 8601 way: weeks start on Monday and week 1 is the week containing the year's first Thursday. Other systems are not available yet: the US, Canada and Japan number from a Sunday-first week containing 1 January, and some countries use a Saturday-first week. This is a documented gap against the worldwide target, not a decision; it is planned as `weekNumbering: "iso" | "us" | "locale"` (tasks.md P17-T4, worldwide audit (`spec/internationalization/worldwide-audit.md` in the monorepo) finding 4). Until then, leave week numbers off for an audience that does not use ISO weeks, or compute them yourself and show them in your own markup.
+- **The column header is yours.** The visible header (`labels.week`) and any accessible name for a week number are supplied by the app, never English defaults, so you can label the column "Wk", "KW" or "Week (ISO)" and make it clear which system is shown.
+
 ---
 
 Lily™ and Lily Design System™ are trademarks.