@lekoala/date-picker 0.1.0

package/dist/types/locales/tr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tr.d.ts","sourceRoot":"","sources":["../../../src/locales/tr.js"],"names":[],"mappings":";IACE,UAAU;IACV,UAAU;IACV,aAAa;IACb,SAAS;IACT,KAAK;IACL,IAAI;IACJ,QAAQ;IACR,WAAW;IACX,WAAW;IACX,eAAe;IACf,UAAU;IACV,IAAI;IACJ,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,eAAe;IACf,aAAa"}

package/dist/types/locales/zh-CN.d.ts

@@ -0,0 +1,22 @@
+declare const _default: {
+    chooseDate: string;
+    changeDate: string;
+    previousMonth: string;
+    nextMonth: string;
+    month: string;
+    year: string;
+    calendar: string;
+    unavailable: string;
+    invalidDate: string;
+    unavailableDate: string;
+    formatHint: string;
+    week: string;
+    rangeStart: string;
+    rangeInRange: string;
+    rangeEnd: string;
+    rangeSingle: string;
+    rangeOrderStart: string;
+    rangeOrderEnd: string;
+};
+export default _default;
+//# sourceMappingURL=zh-CN.d.ts.map

package/dist/types/locales/zh-CN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh-CN.d.ts","sourceRoot":"","sources":["../../../src/locales/zh-CN.js"],"names":[],"mappings":";IACE,UAAU;IACV,UAAU;IACV,aAAa;IACb,SAAS;IACT,KAAK;IACL,IAAI;IACJ,QAAQ;IACR,WAAW;IACX,WAAW;IACX,eAAe;IACf,UAAU;IACV,IAAI;IACJ,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,eAAe;IACf,aAAa"}

package/dist/types/messages.d.ts

@@ -0,0 +1,43 @@
+export declare const DEFAULT_MESSAGES: {
+    chooseDate: string;
+    changeDate: string;
+    previousMonth: string;
+    nextMonth: string;
+    month: string;
+    year: string;
+    calendar: string;
+    unavailable: string;
+    invalidDate: string;
+    unavailableDate: string;
+    formatHint: string;
+    week: string;
+    rangeStart: string;
+    rangeInRange: string;
+    rangeEnd: string;
+    rangeSingle: string;
+    rangeOrderStart: string;
+    rangeOrderEnd: string;
+};
+export declare function getDefaultMessages(): {
+    chooseDate: string;
+    changeDate: string;
+    previousMonth: string;
+    nextMonth: string;
+    month: string;
+    year: string;
+    calendar: string;
+    unavailable: string;
+    invalidDate: string;
+    unavailableDate: string;
+    formatHint: string;
+    week: string;
+    rangeStart: string;
+    rangeInRange: string;
+    rangeEnd: string;
+    rangeSingle: string;
+    rangeOrderStart: string;
+    rangeOrderEnd: string;
+};
+/** @param {Partial<typeof DEFAULT_MESSAGES>} messages */
+export declare function setDefaultMessages(messages: Partial<typeof DEFAULT_MESSAGES>): void;
+//# sourceMappingURL=messages.d.ts.map

package/dist/types/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/messages.js"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;IAC3B,UAAU;IACV,UAAU;IACV,aAAa;IACb,SAAS;IACT,KAAK;IACL,IAAI;IACJ,QAAQ;IACR,WAAW;IACX,WAAW;IACX,eAAe;IACf,UAAU;IACV,IAAI;IACJ,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,eAAe;IACf,aAAa;CACd,CAAC;AAIF,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;EAEjC;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,QAAQ,EAD/B,OAAO,CAAC,OAAO,gBAAgB,CACA,QAE1C"}

package/dist/types/source.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Normalize source payloads to a Map keyed by canonical date.
+ * Accepted shapes: { dates: {...} }, { "YYYY-MM-DD": {...} }, or [{date,...}].
+ * @param {unknown} payload
+ * @returns {Map<string, Record<string, unknown>>}
+ */
+export declare function normalizeDateStates(payload: unknown): Map<string, Record<string, unknown>>;
+/**
+ * Small fetch adapter for legacy/configUrl-like endpoints.
+ * @param {string | URL} url
+ * @param {{map?:(payload:unknown)=>unknown, params?:(range:{start:string,end:string})=>Record<string,string>}} [options]
+ */
+export declare function createFetchSource(url: string | URL, options?: {
+    map?: (payload: unknown) => unknown;
+    params?: (range: {
+        start: string;
+        end: string;
+    }) => Record<string, string>;
+}): {
+    /** @param {{start:string,end:string}} range @param {{signal?:AbortSignal}} [context] */
+    load(range: {
+        start: string;
+        end: string;
+    }, context?: {
+        signal?: AbortSignal;
+    }): Promise<any>;
+};
+//# sourceMappingURL=source.d.ts.map

package/dist/types/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/source.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAHhC,OAGgC,GAF9B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBhD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAH1B,MAAM,GAAG,GAGiB,EAAE,OAAO,AAF3C,CAAsH,EAA9G;IAAC,GAAG,CAAC,EAAC,CAAC,OAAO,EAAC,OAAO,KAAG,OAAO,CAAC;IAAC,MAAM,CAAC,EAAC,CAAC,KAAK,EAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,GAAG,EAAC,MAAM,CAAA;KAAC,KAAG,MAAM,CAAC,MAAM,EAAC,MAAM,CAAC,CAAA;CAE1D;IAE/C,wFAAwF;IAClF,IAAI,QADE;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,GAAG,EAAC,MAAM,CAAA;KAAC,YAAgB;QAAC,MAAM,CAAC,EAAC,WAAW,CAAA;KAAC;EAc7E"}

package/docs/ACCESSIBILITY.md

@@ -0,0 +1,128 @@
+# Accessibility
+
+Accessibility is part of the component contract, not a polish milestone.
+
+Reference patterns:
+
+- WAI-ARIA APG Date Picker Dialog: https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/examples/datepicker-dialog/
+- WAI-ARIA APG Date Picker Combobox: https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-datepicker/
+- Grid pattern: https://www.w3.org/WAI/ARIA/apg/patterns/grid/
+
+APG examples are examples, not drop-in production code. This implementation should be tested with real browser/assistive-technology combinations before 0.1.
+
+## Calendar grid
+
+The calendar renders a semantic `<table role="grid">`.
+
+Because the grid role is applied to a table, native `tr`, `th` and `td` elements provide row/column/gridcell semantics. Exactly one date cell has `tabindex="0"`; every other date cell has `tabindex="-1"`.
+
+Selection is represented with `aria-selected="true"` on the selected cell. Today uses `aria-current="date"`.
+
+A business-disabled date uses `aria-disabled="true"`, but remains focusable by arrow keys. This lets a user discover the date and hear its description instead of creating unexplained holes in keyboard navigation.
+
+Weekday headings use visible short labels plus a full `abbr` value.
+
+## Keyboard map
+
+| Key | Calendar action |
+| --- | --- |
+| Left | previous day |
+| Right | next day |
+| Up | previous week |
+| Down | next week |
+| Home | first day of current week |
+| End | last day of current week |
+| PageUp | same/clamped day in previous month |
+| PageDown | same/clamped day in next month |
+| Shift+PageUp | same/clamped day in previous year |
+| Shift+PageDown | same/clamped day in next year |
+| Enter / Space | activate focused date |
+
+Moving focus never changes selection.
+
+## Month/year controls
+
+The prototype deliberately uses native selects. They are easy to discover, keyboard-operable, and do not require nested custom popovers.
+
+The year select is a moving window around the displayed year when no hard min/max exists. Navigating past the current window causes a normal re-render centered on the new year.
+
+## Date picker input
+
+The visible input remains a native text field. It owns:
+
+- focus;
+- label association;
+- required state;
+- browser validation UI;
+- typed text.
+
+The picker sets:
+
+- `role="combobox"`;
+- `aria-haspopup="dialog"`;
+- `aria-expanded`;
+- `aria-controls`;
+- a format hint through `aria-describedby`.
+
+The calendar button has its own accessible name and includes the selected long date when one exists.
+
+## Popup semantics
+
+The popup is a native manual Popover with `role="dialog"`.
+
+It is not currently modal: the implementation does not inert the rest of the page and does not claim `aria-modal="true"`.
+
+Open behavior:
+
+- the selected date is focused if present;
+- otherwise today is focused;
+- ArrowDown on the input opens the popup;
+- the calendar button opens the popup.
+
+Close behavior:
+
+- date activation commits and returns focus to the input;
+- Escape closes;
+- outside pointer activation closes.
+
+While the popover is open, `Tab` is **not** trapped: focus leaves the popover to the next focusable element in the page. The popup is non-modal (`aria-modal` absent, the rest of the page stays interactive), so capturing the focus the way a modal dialog does would be incoherent — `Escape` remains the predictable way to close and return focus to the field. This deliberately diverges from Duet Date Picker's internal Tab wrap-around.
+
+Decision for 0.1: the popup stays **non-modal** on every surface, including small/touch screens. A modal variant would need a separate design (focus trap, inert background, explicit close) and a proposal of its own.
+
+## Validation
+
+A typed invalid date uses `setCustomValidity()` on the visible input. A parsed but unavailable date uses a distinct message.
+
+The same resolved date state used by the grid is used for manual-entry validation.
+
+## Forced colors guard (selected day)
+
+Forced colors should not rely on the normal selected-day fill tokens.
+
+When `forced-colors: active`, the selected day switches to a border-based treatment:
+
+- `Canvas` background;
+- `CanvasText` foreground;
+- `Highlight` outer border;
+- an inner `CanvasText` ring.
+
+Today keeps the base 1px outline — `border-color: var(--dp-accent)` force-adjusts to `CanvasText` here, so it stays a thin `CanvasText` border. Selected and today therefore remain distinct through border color, width, the inner ring and weight (selected is `700`), not through a shared system key.
+
+This avoids relying on white text over a `Highlight` fill, which can become ambiguous when the active high-contrast theme resolves `Highlight` near-white or when small white digits rasterize poorly. The disabled state is `GrayText` at full opacity.
+
+Guard: re-run the `color-contrast` review and the forced-colors screenshot bundle whenever `--dp-*` styling or day-cell rendering changes.
+
+## Recommended manual test matrix
+
+Beyond what the automated suite covers, the following pairings should be exercised before a broad adoption of 0.1. Results are recorded in [AT-CHECKLIST.md](AT-CHECKLIST.md); the human rows there are still open:
+
+- Windows + Chrome + NVDA;
+- Windows + Firefox + NVDA;
+- macOS + Safari + VoiceOver;
+- iOS Safari + VoiceOver;
+- Android Chrome + TalkBack;
+- 200% zoom/reflow;
+- forced-colors/high contrast;
+- keyboard only;
+- French and English locale;
+- RTL spike before claiming RTL support.

package/docs/API.md

@@ -0,0 +1,289 @@
+# API
+
+The public surface — flat event names, `selection` values, `--dp-*` styling tokens and the `dateactivate`/`renderDay()` seams — is frozen in [DECISIONS.md](DECISIONS.md). Everything else stays internal and is free to change within the same major version.
+
+## `<date-calendar>`
+
+### Attributes / properties
+
+| Name                | Type             | Default            | Meaning                                      |
+|---------------------|------------------|--------------------|----------------------------------------------|
+| `value`             | `YYYY-MM-DD`     | `""`               | Selected date.                               |
+| `display`           | `YYYY-MM`        | value/today month  | Month being rendered.                        |
+| `min`               | `YYYY-MM-DD`     | `""`               | Earliest activatable date.                   |
+| `max`               | `YYYY-MM-DD`     | `""`               | Latest activatable date.                     |
+| `first-day`         | `0..6`           | `1`                | First weekday; Sunday=0, Monday=1.           |
+| `locale`            | BCP 47 string    | document/navigator | `Intl` locale.                               |
+| `selection`         | `single \| none` | `single`           | Whether accepted activation updates `value`. |
+| `fixed-weeks`       | boolean          | false              | Render six rows; date math itself stays 4–6. |
+| `show-week-numbers` | boolean          | false              | Show ISO week numbers.                       |
+
+`focusedDate` and `highlightedRange` are properties rather than reflected attributes.
+
+### `highlightedRange`
+
+Presentation-only range band. It never changes `value`, `selection` or `focusedDate`. It accepts an ordered `{ start, end }` pair of `YYYY-MM-DD` values; `end` may be empty (range in progress), and a `start === end` range renders both endpoints with a dedicated label. `null` and `{ start: "", end: "" }` reset the band. Inverted ranges and `{ start: "", end: "…" }` throw a `TypeError` — the property never reorders or guesses. Styled spans render `data-range-start="true"`, `data-in-range="true"`, `data-range-end="true"` and extend each day's `aria-label` accordingly.
+
+### Callback properties
+
+```js
+calendar.isDateDisabled = (date) => boolean;
+calendar.dateState = (date, sourceState) => ({
+  disabled,
+  enabled, // true = explicit exception to generic disabled rules
+  description,
+  ...applicationMetadata
+});
+calendar.renderDay = (date, state) => Node | string | null;
+```
+
+`renderDay` decorates the day cell; it cannot replace the interactive cell. The returned node is placed inside a component-owned, non-interactive container that is `aria-hidden`. That container has no stable class name: style the nodes you return, not the component's internals (see [DECISIONS.md](DECISIONS.md#d3--css--dp--is-public--dp--is-not)).
+
+### Source
+
+```js
+calendar.source = async ({ start, end }, { signal }) => payload;
+```
+
+or:
+
+```js
+calendar.source = {
+  load({ start, end }, { signal }) { ... }
+};
+```
+
+### Methods
+
+```js
+calendar.previousMonth();
+calendar.nextMonth();
+calendar.focusDate("2026-09-10");
+calendar.focusGrid();
+calendar.getDateState("2026-09-10");
+await calendar.ensureDate("2026-09-10");
+await calendar.refreshSource();
+calendar.render();
+```
+
+### Events
+
+#### `dateactivate`
+
+Cancelable. Fired for an allowed date after explicit click / Enter / Space.
+
+```js
+calendar.addEventListener("dateactivate", (event) => {
+  console.log(event.detail.date, event.detail.state);
+});
+```
+
+Cancel it to refuse the activation before selection:
+
+```js
+calendar.addEventListener("dateactivate", (event) => {
+  if (applicationRule(event.detail.date)) event.preventDefault();
+});
+```
+
+#### `datechange`
+
+Fired when `selection="single"` changes `value`.
+
+#### `dateinvalid`
+
+Fired when the user tries to activate a disabled/out-of-range date.
+
+#### `displaychange`
+
+```js
+{
+  display: "2026-10",
+  start: "2026-09-28",
+  end: "2026-11-08"
+}
+```
+
+The range reflects rendered cells (and therefore includes six-row padding when enabled).
+
+#### Source lifecycle
+
+- `dateloadstart`
+- `dateloadend`
+- `dateloaderror`
+
+## `<date-picker>`
+
+Markup:
+
+```html
+<label for="arrival">Arrival</label>
+<date-picker value="2026-09-10" locale="en-GB">
+  <input id="arrival" name="arrival" required>
+</date-picker>
+```
+
+The direct child text input is required. On enhancement its original `name` moves to an internal hidden input that submits the canonical ISO value.
+
+### Attributes / properties
+
+- `value` — canonical selected date;
+- `locale`;
+- `min`;
+- `max`;
+- `open-on-focus` — boolean (default `true`): open the popover when the input receives focus without moving focus; `open-on-focus="false"` keeps focus alone passive;
+- `open` — read-only: whether the popover is shown;
+- `openOnFocus` — property form of `open-on-focus`.
+
+### Native form semantics
+
+- `disabled` — non-editable, popup cannot open, field is not submitted.
+- `readonly` — non-editable, value is still submitted, popup cannot open (the trigger is disabled).
+- Clearing the editable input clears the canonical value; the component does not render its own clear button.
+- `input.defaultValue` (or the input's `value` attribute) is the source of truth for the next `form.reset()`, which restores canonical + visible representations and revalidates.
+
+### Forwarded callback properties
+
+- `source`;
+- `dateState`;
+- `renderDay`;
+- `isDateDisabled`;
+- `messages`.
+
+### Read-only properties
+
+```js
+picker.input;
+picker.calendar;
+```
+
+### Methods
+
+```js
+picker.show();
+picker.hide();
+await picker.validate();
+```
+
+### Events
+
+- `valuechange` — canonical value changed;
+- `open`;
+- `close`.
+
+Calendar selection also dispatches normal bubbling `input` and `change` events on the visible input.
+
+## `<date-picker range>` — shared range surface
+
+```html
+<date-picker range>
+  <input data-range-start name="arrival" aria-label="Arrival">
+  <input data-range-end name="departure" aria-label="Departure">
+</date-picker>
+```
+
+Two editable fields share one calendar popup. The mode is fixed at connect time (`range` attribute + both marked direct child inputs); switching single/range at runtime is not supported in V1.
+
+### Strict API
+
+- `range` — atomic get/set of `{ start, end }` (canonical `YYYY-MM-DD`). The setter validates through `normalizeRange` (ISO-only, ordered; inverted throws) and applies both bounds, the visible fields and both hidden fields **before** one `rangechange` event — no intermediate new-start/old-end state is observable.
+- `value` — `undefined` in range mode; assigning throws a `TypeError`.
+- `input` — `undefined` in range mode; the authored inputs remain the consumer-facing fields.
+- `startValue` / `endValue` — deferred; do not exist yet.
+
+Each field keeps its own name, hidden ISO input and validation. There is no `rangeDrop`-style polymorphic pair.
+
+### `rangechange`
+
+```js
+picker.addEventListener("rangechange", (event) => {
+  console.log(event.detail); // { start, end } — may be incomplete or inverted
+});
+```
+
+The business range may be temporarily incomplete or inverted; `calendar.highlightedRange` only ever receives a displayable (ordered) range.
+
+### Interaction
+
+- When an ordered range is complete, picking before its start updates only the start; picking after its end updates only the end, regardless of the opening field. The popup closes after this update. An uneditable target bound refuses the activation.
+- Otherwise, opening through a field targets that bound (`activeEndpoint`). Picking from `start` commits it, moves the endpoint to `end` without closing, and a second pick commits and closes. Opening from `end` refuses a date before `start` (`dateinvalid`, nothing changes).
+- The shared trigger opens the last active bound, else `start`; it never auto-switches to a `readonly`/`disabled` bound.
+- Typing stays independent per field. Moving `start` past `end` keeps both values and flags the *modified* bound with `rangeOrderStart`; fixing either side revalidates both. Parse/source errors are never cleared by cross-bound revalidation.
+- A stale availability response resolving after the active endpoint changed (or after a newer selection) never commits; a field focus that switches the endpoint invalidates in-flight activations.
+
+## `linkDateRange(start, end)`
+
+```js
+const cleanup = linkDateRange(startPicker, endPicker);
+```
+
+Keeps effective start/end bounds synchronized and revalidates both inputs. Returns an idempotent-style cleanup function (call once to detach the relationship).
+
+## `normalizeRange` and `rangePosition`
+
+```js
+import { normalizeRange, rangePosition } from "@lekoala/date-picker";
+
+normalizeRange({ start: "2026-09-10", end: "2026-09-15" }); // { start, end }
+normalizeRange(null); // { start: "", end: "" }
+rangePosition("2026-09-12", range); // "start" | "in" | "end" | "single" | ""
+```
+
+`normalizeRange` validates an ordered displayable range and never reorders: an inversion or an `end` without a `start` throws. `rangePosition` classifies one day within a displayable range (see [`highlightedRange`](#highlightedrange)).
+
+## `createDateAdapter(locale)`
+
+Locale-aware editable numeric adapter:
+
+```js
+const adapter = createDateAdapter("fr-BE");
+adapter.placeholder;             // DD/MM/YYYY
+adapter.format("2026-09-06");    // 06/09/2026
+adapter.parse("06/09/2026");     // 2026-09-06
+```
+
+ISO input is accepted as a fallback even when the locale display is different.
+
+## Locales
+
+Control-message dictionaries ship per locale and can be attached through the `messages` property:
+
+```js
+import fr from "@lekoala/date-picker/locales/fr";
+calendar.messages = fr;
+```
+
+Available tags: `ar`, `de`, `en`, `es`, `fr`, `hi`, `id`, `it`, `ja`, `ko`, `nl`, `pl`, `pt-BR`, `pt-PT`, `ru`, `tr`, `zh-CN`. `en` mirrors the built-in defaults.
+
+Only the short control labels (choose/change date, month/year names, grid heading, validation messages, format hint, week heading) are locale data. Everything locale-shaped on screen — month/weekday names, the editable pattern and placeholder, parsing and digit normalization — comes from `Intl` via the `locale` attribute, so a dictionary is never required for a new language to display correctly.
+
+## `dates`
+
+Pure helpers are exported as a namespace:
+
+```js
+import { dates } from "@lekoala/date-picker";
+```
+
+Public helpers:
+
+- `isLeapYear`
+- `daysInMonth`
+- `parseDate`
+- `isDate`
+- `monthKey`
+- `toISODate`
+- `compareDates`
+- `addDays`
+- `addMonths`
+- `addYears`
+- `shiftMonth`
+- `startOfMonth`
+- `endOfMonth`
+- `dayOfWeek`
+- `startOfWeek`
+- `endOfWeek`
+- `getMonthWeeks`
+- `clampDate`
+- `todayISO`
+- `isoWeekNumber`