Skip to content

Latest commit

 

History

History

aria

README.md

@octanejs/aria

React Aria for the octane renderer — a faithful port of Adobe's React Aria (react-aria, react-stately, and react-aria-components) onto octane's hooks and native event system.

Installation

npm install @octanejs/aria
pnpm add @octanejs/aria
  • @octanejs/aria — the react-aria behavior-hook surface.
  • @octanejs/aria/stately — the react-stately state-hook surface.
  • @octanejs/aria/components — the complete public export surface of [email protected].

Ported from the pinned adobe/react-spectrum checkout at commit 5ecb3333001313e83898cd07644227897e3bae1f, which publishes [email protected], [email protected], and [email protected]. The components entry point has an exact checked crosswalk: all 286 runtime exports and all 327 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. The 1.20 release adds TokenField and PreviewTrigger, keyboard shortcut bindings, and context-menu triggers.

Status, supported surface, and known divergences: status.json (rendered into docs/bindings-status.md). Source provenance and refresh instructions: UPSTREAM.md.

Verify the pinned public surface with:

pnpm --filter @octanejs/aria exports:check

Notable divergences

  • Octane has no synthetic onChange; text-input DOM wiring uses native onInput (per keystroke — the same timing React's onChange has for text 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.