From 39e90c12f802b03d7d7ad9f0e427540c05dfa299 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
<41898282+github-actions[bot]@users.noreply.github.com>
Date: Wed, 15 Jul 2026 23:43:15 +0000
Subject: [PATCH 1/2] docs: add firstDayOfWeek to DateFieldProps table
The date-field-keyboard-shortcuts changeset extended DateField
with a firstDayOfWeek prop (previously DatePicker-only) so the
w/k week-start/end shortcuts respect a consumer-specified week
start. Document this in the DateFieldProps table.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
docs/components/date-picker.md | 9 +++++----
1 file changed, 5 insertions(+), 4 deletions(-)
diff --git a/docs/components/date-picker.md b/docs/components/date-picker.md
index a91d84f0..48c5d7c0 100644
--- a/docs/components/date-picker.md
+++ b/docs/components/date-picker.md
@@ -127,10 +127,11 @@ The tables below list props this variant **actually implements** for v1 (date gr
| `isRequired` | `boolean` | Sets `aria-required` on the segments (no visual required indicator yet) |
| `placeholderValue` | `DateValue` | Seeds unset segments (increment start + segment order) |
| `autoFocus` | `boolean` | Focus the first segment on mount |
-| `locale` | `string` | BCP-47 locale override (defaults to the AppShell formatting locale) |
-| `name` | `string` | Emits a hidden `` with the ISO value for form submission |
-| `aria-label` | `string` | Accessible name when there's no visible `label` (e.g. compact filters) |
-| `className` | `string` | Root element class |
+| `locale` | `string` | BCP-47 locale override (defaults to the AppShell formatting locale) |
+| `name` | `string` | Emits a hidden `` with the ISO value for form submission |
+| `firstDayOfWeek` | `"sun" \| "mon" \| "tue" \| "wed" \| "thu" \| "fri" \| "sat"` | Override the locale's week start for the `w`/`k` keyboard shortcuts; omit to follow the locale |
+| `aria-label` | `string` | Accessible name when there's no visible `label` (e.g. compact filters) |
+| `className` | `string` | Root element class |
> `DateField` has no calendar, so `minValue` / `maxValue` / `isDateUnavailable` don't apply to it — they're honoured by `DatePicker` and `Calendar` below.
From dadca1d92559784c05913702e55989f9db04f709 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 16 Jul 2026 07:32:05 +0000
Subject: [PATCH 2/2] fix(docs): reformat date-picker.md table to pass oxfmt
check
Co-authored-by: IzumiSy <982850+IzumiSy@users.noreply.github.com>
---
docs/components/date-picker.md | 30 +++++++++++++++---------------
1 file changed, 15 insertions(+), 15 deletions(-)
diff --git a/docs/components/date-picker.md b/docs/components/date-picker.md
index 48c5d7c0..2dc2598d 100644
--- a/docs/components/date-picker.md
+++ b/docs/components/date-picker.md
@@ -116,22 +116,22 @@ The tables below list props this variant **actually implements** for v1 (date gr
### DateFieldProps
-| Prop | Type | Description |
-| ----------------------------------------- | -------------------------------- | ----------------------------------------------------------------------- |
-| `label` | `LocalizedString` | Field label |
-| `description` | `LocalizedString` | Helper text below the field |
-| `errorMessage` | `LocalizedString` | Error text; also sets the invalid state |
-| `value` / `defaultValue` | `DateValue \| null` | Controlled / uncontrolled value (`CalendarDate` at date granularity) |
-| `onChange` | `(v: DateValue \| null) => void` | Fires on a complete, valid value; `null` when cleared |
-| `isDisabled` / `isReadOnly` / `isInvalid` | `boolean` | State flags |
-| `isRequired` | `boolean` | Sets `aria-required` on the segments (no visual required indicator yet) |
-| `placeholderValue` | `DateValue` | Seeds unset segments (increment start + segment order) |
-| `autoFocus` | `boolean` | Focus the first segment on mount |
-| `locale` | `string` | BCP-47 locale override (defaults to the AppShell formatting locale) |
-| `name` | `string` | Emits a hidden `` with the ISO value for form submission |
+| Prop | Type | Description |
+| ----------------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `label` | `LocalizedString` | Field label |
+| `description` | `LocalizedString` | Helper text below the field |
+| `errorMessage` | `LocalizedString` | Error text; also sets the invalid state |
+| `value` / `defaultValue` | `DateValue \| null` | Controlled / uncontrolled value (`CalendarDate` at date granularity) |
+| `onChange` | `(v: DateValue \| null) => void` | Fires on a complete, valid value; `null` when cleared |
+| `isDisabled` / `isReadOnly` / `isInvalid` | `boolean` | State flags |
+| `isRequired` | `boolean` | Sets `aria-required` on the segments (no visual required indicator yet) |
+| `placeholderValue` | `DateValue` | Seeds unset segments (increment start + segment order) |
+| `autoFocus` | `boolean` | Focus the first segment on mount |
+| `locale` | `string` | BCP-47 locale override (defaults to the AppShell formatting locale) |
+| `name` | `string` | Emits a hidden `` with the ISO value for form submission |
| `firstDayOfWeek` | `"sun" \| "mon" \| "tue" \| "wed" \| "thu" \| "fri" \| "sat"` | Override the locale's week start for the `w`/`k` keyboard shortcuts; omit to follow the locale |
-| `aria-label` | `string` | Accessible name when there's no visible `label` (e.g. compact filters) |
-| `className` | `string` | Root element class |
+| `aria-label` | `string` | Accessible name when there's no visible `label` (e.g. compact filters) |
+| `className` | `string` | Root element class |
> `DateField` has no calendar, so `minValue` / `maxValue` / `isDateUnavailable` don't apply to it — they're honoured by `DatePicker` and `Calendar` below.