@octanejs/aria 0.0.40 → 0.0.41

package/LICENSE-APACHE-2.0

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2019 Adobe
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -2,20 +2,32 @@
 
 React Aria for the [octane](https://github.com/octanejs/octane) renderer — a
 faithful port of Adobe's [React Aria](https://react-spectrum.adobe.com/react-aria/)
-(`react-aria`, `react-stately`, and eventually `react-aria-components`) onto
+(`react-aria`, `react-stately`, and `react-aria-components`) onto
 octane's hooks and native event system.
 
 - `@octanejs/aria` — the `react-aria` behavior-hook surface.
 - `@octanejs/aria/stately` — the `react-stately` state-hook surface.
-- `@octanejs/aria/components` — the `react-aria-components` surface (planned).
+- `@octanejs/aria/components` — the complete public export surface of
+  `react-aria-components@1.19.0`.
 
-Ported from the pinned `adobe/react-spectrum` checkout at the commit publishing
-`react-aria@3.50.0` / `react-stately@3.48.0` / `react-aria-components@1.19.0`,
-and proven by differential parity: the same fixture runs through
-`@octanejs/aria` and the real React packages, asserting byte-identical DOM.
+Ported from the pinned `adobe/react-spectrum` checkout at commit
+`1c84a49a1faf50b571c84e00bcf9c60b22ddd03e`, which publishes
+`react-aria@3.50.0`, `react-stately@3.48.0`, and
+`react-aria-components@1.19.0`. The components entry point has an exact checked
+crosswalk: all 280 runtime exports and all 313 type exports match the pinned
+package, with no missing or extra names. Existing families retain differential
+tests against React; calendar/date, color, drag and drop, file, data, toast, and
+layout additions have focused public-behavior coverage.
 
 Status, supported surface, and known divergences: `status.json` (rendered into
-`docs/bindings-status.md`). Plan and progress: `docs/aria-migration-plan.md`.
+`docs/bindings-status.md`). Source provenance and refresh instructions:
+`UPSTREAM.md`.
+
+Verify the pinned public surface with:
+
+```bash
+pnpm --filter @octanejs/aria exports:check
+```
 
 ## Notable divergences
 
@@ -24,3 +36,4 @@ Status, supported surface, and known divergences: `status.json` (rendered into
   inputs). React Aria's public value-level `onChange(value)` callbacks are
   unchanged.
 - `forwardRef` becomes octane's ref-as-prop (React 19 style).
+- React Server Components are not part of the Octane binding.

package/UPSTREAM.md

@@ -0,0 +1,108 @@
+# React Aria upstream ledger
+
+`@octanejs/aria` targets the coordinated React Spectrum release at commit
+`1c84a49a1faf50b571c84e00bcf9c60b22ddd03e`:
+
+| Package | Version | Verified tag | npm SHA-256 | npm integrity |
+| --- | --- | --- | --- | --- |
+| `react-aria` | `3.50.0` | `react-aria@3.50.0` | `bcab487177dba271a36f247531043c3c940579cacc201e31bbdbba29ef2d2a7c` | `sha512-S0Os6QZk33fzUAKu1QLT9afoUaCBt1ZNdoiq0n2YMVgKIdNIQS8zxiZ8O9hYE6QyDkHKjD6q39LQZ+qaSAIgjw==` |
+| `react-aria-components` | `1.19.0` | `react-aria-components@1.19.0` | `d63da4e2ab794d3a86a16ba17b719f22a256d9c0c5fd22c057d228e0f05932a1` | `sha512-2smSS5nqJ8cGYMQezuUXveZm7eMyHCqTN6mDpylQBYLYbdF5dxCCuW1DHn1VKLe1DybSfPvX/cZtJlDmvFfn8A==` |
+| `react-stately` | `3.48.0` | `react-stately@3.48.0` | `55f38303d09112619b9adc754032ba3caadc7e5a0b7fbc74bfc5636369674dd4` | `sha512-ImicSAG+lTotAe5izcs1fz49Zk48w7pDusqYg04WaPhCoej8BJ24soMu3iLXIrsi273s4P1gZrYGrqReMfgEEA==` |
+
+All three signed registry artifacts record the same `gitHead`, and all three tags resolve to
+that commit. The ordered composite SHA-256 of the three npm tarballs is
+`dcad3293f0f7438705f72cdd7df03351476aeaba7d0d2743c7ad6d8130aff56f`.
+The supported range is these exact coordinated versions; upgrades require a new crosswalk.
+
+## Source and test boundary
+
+- Canonical repository: `https://github.com/adobe/react-spectrum.git`
+- Source roots: `packages/react-aria/src`, `packages/react-aria-components/src`, and
+  `packages/react-stately/src`
+- Public entry points: each package's `exports/index.ts`
+- Test roots: each package's `test` directory
+- License: Apache-2.0; the pinned root `LICENSE` SHA-256 is
+  `7dfe6526888bac51759c99f9a51262ba2711a8c12a067f2181609dd9a4066b84`
+- React oracle: `react@19.2.7` and `react-dom@19.2.7`
+
+The monorepo source and suites are not vendored in this retrofit because the three package
+trees contain more than two thousand source/support files. The immutable external checkout
+can be reproduced with:
+
+```sh
+git clone --depth 1 --branch react-aria@3.50.0 --filter=blob:none --sparse \
+  https://github.com/adobe/react-spectrum.git react-spectrum-aria-3.50.0
+git -C react-spectrum-aria-3.50.0 sparse-checkout set --skip-checks \
+  packages/react-aria packages/react-aria-components packages/react-stately LICENSE
+```
+
+`audit/upstream-crosswalk.json` records all 1,294 public entry-point exports and all 185
+test-root artifacts from that checkout. It currently classifies 998 exports as
+`surface-present-unverified`, with per-symbol entry-point evidence, and 296 as explicit gaps.
+Surface presence is not a behavioral parity claim. The upstream suites contain 177 runtime
+test files, one type test, and seven support artifacts. They are present but have not been
+adapted case-by-case, so this binding remains `recorded-unverified`.
+
+## React Aria Components public surface
+
+The `@octanejs/aria/components` entry point separately claims complete named-export parity
+with the pinned `react-aria-components@1.19.0` package. The completed inventory is 280 runtime
+exports and 313 type exports, including calendar/date/time, color, drag-and-drop,
+DropZone/FileTrigger, toast, data hooks, Virtualizer, and layout classes.
+
+`scripts/check-react-aria-components-exports.mjs` parses the installed pinned declaration
+barrel and `src/components/index.ts`, keeps runtime and type-only exports in separate lanes,
+and rejects missing or extra names in either direction:
+
+```sh
+pnpm --filter @octanejs/aria exports:check
+```
+
+This components-entry claim does not convert the broader `react-aria` and `react-stately`
+crosswalk into a full-export or full-upstream-suite claim.
+
+## Refreshing the advanced source staging tree
+
+The sparse `.react-spectrum` checkout must point at the exact coordinated commit above.
+`scripts/port-advanced-source.mjs` creates a reviewable staging tree, rewrites package
+boundaries to the local Octane adapters, copies locale dictionaries, and records provenance.
+It must not target `packages/aria`, because reviewed Octane adaptations must not be
+overwritten mechanically.
+
+```sh
+node packages/aria/scripts/port-advanced-source.mjs \
+  --output-root /tmp/octane-aria-upstream
+```
+
+Review the staged diff against `packages/aria`, preserve native-event, ref-as-prop,
+hook-slot, and compiler adaptations, then run the export audit, `tsrx-tsc`, and the Aria
+test projects. Updating the pin requires reviewing the upstream source and export diffs
+together. Newly adapted Adobe source retains its Apache-2.0 header; the required license
+text is shipped as `LICENSE-APACHE-2.0`.
+
+## Executable evidence
+
+The only React-parity-owned executable lane today is the bounded differential project. It
+compiles the same `.tsrx` fixtures once for Octane and once for the pinned React packages,
+covering interaction hooks, form-field event wiring, collections, Select, ComboBox, React Aria
+Components render props, keyed collection updates, and Tree/Table state.
+
+That lane is representative evidence only. Declaring the upstream runtime and type suites
+`present` records that the coordinated checkout contains those suites; it is not a claim that
+this binding has completed pristine full-suite, one-for-one adapted, or type-lane execution.
+The export/test crosswalk and Octane-only divergence/framework contracts remain ordinary-shard
+coverage until those required lanes and inventories exist.
+
+## Intentional divergences
+
+- Native text editing uses Octane `onInput` wiring while public value callbacks retain their
+  upstream `onChange(value)` names.
+- React `forwardRef` wrappers become Octane ref-as-prop components.
+- The i18n server serializer keeps generated identifiers valid after 26 hoisted strings,
+  correcting invalid JavaScript emitted by the pinned upstream algorithm.
+- Server locale direction is derived from the injected locale, including RTL locales, rather
+  than being hard-coded to `ltr`.
+
+`native-input-event-wiring` is linked to the differential case in `audit/react-parity.json`.
+The other divergences above remain documented package contracts with ordinary-shard tests; they
+are not counted as completed React-parity suite evidence until adapted upstream lanes exist.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@octanejs/aria",
-  "version": "0.0.40",
-  "license": "MIT",
+  "version": "0.0.41",
+  "license": "MIT AND Apache-2.0",
   "type": "module",
   "sideEffects": [
     "./src/index.ts",
@@ -36,7 +36,9 @@
   "types": "src/index.ts",
   "files": [
     "src",
-    "README.md"
+    "README.md",
+    "UPSTREAM.md",
+    "LICENSE-APACHE-2.0"
   ],
   "exports": {
     ".": "./src/index.ts",
@@ -51,20 +53,22 @@
     "clsx": "^2.1.1"
   },
   "peerDependencies": {
-    "octane": "0.1.46"
+    "octane": "0.1.47"
   },
   "devDependencies": {
-    "@tsrx/react": "^0.2.58",
+    "@tsrx/react": "^0.2.61",
     "esbuild": "^0.28.1",
     "react": "^19.2.7",
     "react-aria": "3.50.0",
     "react-aria-components": "1.19.0",
     "react-dom": "^19.2.7",
     "react-stately": "3.48.0",
+    "typescript": "^5.9.3",
     "vitest": "^4.1.10",
-    "octane": "0.1.46"
+    "octane": "0.1.47"
   },
   "scripts": {
+    "exports:check": "node scripts/check-react-aria-components-exports.mjs",
     "test": "vitest run"
   }
 }

package/src/calendar/useCalendar.tsx

@@ -0,0 +1,36 @@
+/** @jsxImportSource octane */
+// Ported from adobe/react-spectrum@1c84a49a1faf50b571c84e00bcf9c60b22ddd03e (packages/react-aria/src/calendar/useCalendar.ts).
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { AriaLabelingProps, DOMProps } from '@react-types/shared';
+import { CalendarAria, useCalendarBase } from './useCalendarBase';
+import {
+	CalendarProps,
+	CalendarSelectionMode,
+	CalendarState,
+	DateValue,
+} from '../upstream-exports/react-stately/useCalendarState';
+
+export interface AriaCalendarProps<T extends DateValue, M extends CalendarSelectionMode = 'single'>
+	extends CalendarProps<T, M>, DOMProps, AriaLabelingProps {}
+
+/**
+ * Provides the behavior and accessibility implementation for a calendar component.
+ * A calendar displays one or more date grids and allows users to select a single date.
+ */
+export function useCalendar<T extends DateValue, M extends CalendarSelectionMode = 'single'>(
+	props: AriaCalendarProps<T, M>,
+	state: CalendarState<M>,
+): CalendarAria {
+	return useCalendarBase(props, state);
+}

package/src/calendar/useCalendarBase.tsx

@@ -0,0 +1,142 @@
+/** @jsxImportSource octane */
+// Ported from adobe/react-spectrum@1c84a49a1faf50b571c84e00bcf9c60b22ddd03e (packages/react-aria/src/calendar/useCalendarBase.ts).
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { announce } from '../live-announcer/LiveAnnouncer';
+import { AriaButtonProps } from '../button/useButton';
+import { AriaLabelingProps, DOMAttributes, DOMProps } from '@react-types/shared';
+import {
+	CalendarPropsBase,
+	CalendarSelectionMode,
+	CalendarState,
+} from '../upstream-exports/react-stately/useCalendarState';
+import { filterDOMProps } from '../utils/filterDOMProps';
+import { hookData, useSelectedDateDescription, useVisibleRangeDescription } from './utils';
+import intlMessages from '../intl/calendar/index';
+import { mergeProps } from '../utils/mergeProps';
+import { RangeCalendarState } from '../upstream-exports/react-stately/useRangeCalendarState';
+import { useLabels } from '../utils/useLabels';
+import { useLocalizedStringFormatter } from '../i18n/useLocalizedStringFormatter';
+import { useSlotId } from '../utils/useId';
+import { useState } from '../compat/react';
+import { useUpdateEffect } from '../utils/useUpdateEffect';
+
+export interface CalendarAria {
+	/** Props for the calendar grouping element. */
+	calendarProps: DOMAttributes;
+	/** Props for the next button. */
+	nextButtonProps: AriaButtonProps;
+	/** Props for the previous button. */
+	prevButtonProps: AriaButtonProps;
+	/** Props for the error message element, if any. */
+	errorMessageProps: DOMAttributes;
+	/** A description of the visible date range, for use in the calendar title. */
+	title: string;
+}
+
+export function useCalendarBase(
+	props: CalendarPropsBase & DOMProps & AriaLabelingProps,
+	state: CalendarState<CalendarSelectionMode> | RangeCalendarState,
+): CalendarAria {
+	let stringFormatter = useLocalizedStringFormatter(intlMessages, '@react-aria/calendar');
+	let domProps = filterDOMProps(props);
+
+	let title = useVisibleRangeDescription(
+		state.visibleRange.start,
+		state.visibleRange.end,
+		state.timeZone,
+		false,
+	);
+	let visibleRangeDescription = useVisibleRangeDescription(
+		state.visibleRange.start,
+		state.visibleRange.end,
+		state.timeZone,
+		true,
+	);
+
+	// Announce when the visible date range changes
+	useUpdateEffect(() => {
+		// only when pressing the Previous or Next button
+		if (!state.isFocused) {
+			announce(visibleRangeDescription);
+		}
+	}, [visibleRangeDescription]);
+
+	// Announce when the selected value changes
+	let selectedDateDescription = useSelectedDateDescription(state);
+	useUpdateEffect(() => {
+		if (selectedDateDescription) {
+			announce(selectedDateDescription, 'polite', 4000);
+		}
+		// handle an update to the caption that describes the currently selected range, to announce the new value
+	}, [selectedDateDescription]);
+
+	let errorMessageId = useSlotId([
+		Boolean(props.errorMessage),
+		props.isInvalid,
+		props.validationState,
+	]);
+
+	// Pass the label to the child grid elements.
+	hookData.set(state, {
+		ariaLabel: props['aria-label'],
+		ariaLabelledBy: props['aria-labelledby'],
+		errorMessageId,
+		selectedDateDescription,
+	});
+
+	// If the next or previous buttons become disabled while they are focused, move focus to the calendar body.
+	let [nextFocused, setNextFocused] = useState(false);
+	let nextDisabled = props.isDisabled || state.isNextVisibleRangeInvalid();
+	if (nextDisabled && nextFocused) {
+		setNextFocused(false);
+		state.setFocused(true);
+	}
+
+	let [previousFocused, setPreviousFocused] = useState(false);
+	let previousDisabled = props.isDisabled || state.isPreviousVisibleRangeInvalid();
+	if (previousDisabled && previousFocused) {
+		setPreviousFocused(false);
+		state.setFocused(true);
+	}
+
+	let labelProps = useLabels({
+		id: props['id'],
+		'aria-label': [props['aria-label'], visibleRangeDescription].filter(Boolean).join(', '),
+		'aria-labelledby': props['aria-labelledby'],
+	});
+
+	return {
+		calendarProps: mergeProps(domProps, labelProps, {
+			role: 'application',
+			'aria-details': props['aria-details'] || undefined,
+			'aria-describedby': props['aria-describedby'] || undefined,
+		}),
+		nextButtonProps: {
+			onPress: () => state.focusNextPage(),
+			'aria-label': stringFormatter.format('next'),
+			isDisabled: nextDisabled,
+			onFocusChange: setNextFocused,
+		},
+		prevButtonProps: {
+			onPress: () => state.focusPreviousPage(),
+			'aria-label': stringFormatter.format('previous'),
+			isDisabled: previousDisabled,
+			onFocusChange: setPreviousFocused,
+		},
+		errorMessageProps: {
+			id: errorMessageId,
+		},
+		title,
+	};
+}