@octanejs/aria 0.0.4 → 0.0.6

package/src/grid/useGridRow.ts

@@ -0,0 +1,108 @@
+// Ported from react-aria (source: .react-spectrum/packages/react-aria/src/grid/useGridRow.ts).
+// octane adaptations:
+// - `GridState`/`IGridCollection`/`GridNode` come from the ported stately grid hooks;
+//   `DOMAttributes` is a local structural prop-bag alias.
+// - Public-hook slot threading (splitSlot/subSlot).
+import { chain } from '../utils/chain';
+
+import type { FocusableElement, RefObject } from '@react-types/shared';
+import type { IGridCollection as GridCollection, GridNode } from '../stately/grid/GridCollection';
+import { gridMap } from './utils';
+import type { GridState } from '../stately/grid/useGridState';
+import { SelectableItemStates, useSelectableItem } from '../selection/useSelectableItem';
+
+import { S, splitSlot, subSlot } from '../internal';
+
+// octane adaptation: minimal structural DOMAttributes (upstream's drags React's synthetic
+// handler types along).
+type DOMAttributes = Record<string, any>;
+
+export interface GridRowProps<T> {
+	/**
+	 * An object representing the grid row. Contains all the relevant information that makes up the
+	 * grid row.
+	 */
+	node: GridNode<T>;
+	/** Whether the grid row is contained in a virtual scroller. */
+	isVirtualized?: boolean;
+	/** Whether selection should occur on press up instead of press down. */
+	shouldSelectOnPressUp?: boolean;
+	/**
+	 * Handler that is called when a user performs an action on the row.
+	 * Please use onCellAction at the collection level instead.
+	 *
+	 * @deprecated
+	 */
+	onAction?: () => void;
+}
+
+export interface GridRowAria extends SelectableItemStates {
+	/** Props for the grid row element. */
+	rowProps: DOMAttributes;
+	/** Whether the row is currently in a pressed state. */
+	isPressed: boolean;
+}
+
+/**
+ * Provides the behavior and accessibility implementation for a row in a grid.
+ *
+ * @param props - Props for the row.
+ * @param state - State of the parent grid, as returned by `useGridState`.
+ */
+export function useGridRow<T, C extends GridCollection<T>, S extends GridState<T, C>>(
+	props: GridRowProps<T>,
+	state: S,
+	ref: RefObject<FocusableElement | null>,
+): GridRowAria;
+// Slot-threading form: sibling ported hooks pass their derived sub-slot as the trailing arg.
+export function useGridRow<T, C extends GridCollection<T>, S extends GridState<T, C>>(
+	props: GridRowProps<T>,
+	state: S,
+	ref: RefObject<FocusableElement | null>,
+	slot: symbol | undefined,
+): GridRowAria;
+export function useGridRow(...args: any[]): GridRowAria {
+	const [user, slotArg] = splitSlot(args);
+	const slot = slotArg ?? S('useGridRow');
+	const props = user[0] as GridRowProps<any>;
+	const state = user[1] as GridState<any, GridCollection<any>>;
+	const ref = user[2] as RefObject<FocusableElement | null>;
+
+	let { node, isVirtualized, shouldSelectOnPressUp, onAction } = props;
+
+	let { actions, shouldSelectOnPressUp: gridShouldSelectOnPressUp } = gridMap.get(state)!;
+	let onRowAction = actions.onRowAction ? () => actions.onRowAction?.(node.key) : onAction;
+	let { itemProps, ...states } = useSelectableItem(
+		{
+			selectionManager: state.selectionManager,
+			key: node.key,
+			ref,
+			isVirtualized,
+			shouldSelectOnPressUp: gridShouldSelectOnPressUp || shouldSelectOnPressUp,
+			onAction:
+				onRowAction || node?.props?.onAction
+					? chain(node?.props?.onAction, onRowAction)
+					: undefined,
+			isDisabled: state.collection.size === 0,
+		},
+		subSlot(slot, 'selectableItem'),
+	);
+
+	let isSelected = state.selectionManager.isSelected(node.key);
+
+	let rowProps: DOMAttributes = {
+		role: 'row',
+		'aria-selected': state.selectionManager.selectionMode !== 'none' ? isSelected : undefined,
+		'aria-disabled': states.isDisabled || undefined,
+		...itemProps,
+	};
+
+	if (isVirtualized) {
+		rowProps['aria-rowindex'] = node.index + 1; // aria-rowindex is 1 based
+	}
+
+	return {
+		rowProps,
+		...states,
+	};
+}

package/src/grid/useGridRowGroup.ts

@@ -0,0 +1,29 @@
+// Ported from react-aria (source: .react-spectrum/packages/react-aria/src/grid/useGridRowGroup.ts).
+// octane adaptations: `DOMAttributes` is a local structural prop-bag alias. The hook
+// composes no base hooks, so the optional trailing slot is accepted (uniform calling
+// convention) and unused.
+import { splitSlot } from '../internal';
+
+// octane adaptation: minimal structural DOMAttributes (upstream's drags React's synthetic
+// handler types along).
+type DOMAttributes = Record<string, any>;
+
+export interface GridRowGroupAria {
+	/** Props for the row group element. */
+	rowGroupProps: DOMAttributes;
+}
+
+/**
+ * Provides the accessibility implementation for a row group in a grid.
+ */
+export function useGridRowGroup(): GridRowGroupAria;
+// Slot-threading form: sibling ported hooks pass their derived sub-slot as the trailing arg.
+export function useGridRowGroup(slot: symbol | undefined): GridRowGroupAria;
+export function useGridRowGroup(...args: any[]): GridRowGroupAria {
+	splitSlot(args);
+	return {
+		rowGroupProps: {
+			role: 'rowgroup',
+		},
+	};
+}

package/src/grid/utils.ts

@@ -0,0 +1,24 @@
+// Ported from react-aria (source: .react-spectrum/packages/react-aria/src/grid/utils.ts).
+// octane adaptations: `GridState`/`IGridCollection` types come from the ported stately
+// grid hooks.
+import type { IGridCollection as GridCollection } from '../stately/grid/GridCollection';
+
+import type { GridState } from '../stately/grid/useGridState';
+import type { Key, KeyboardDelegate } from '@react-types/shared';
+
+interface GridMapShared {
+	keyboardDelegate: KeyboardDelegate;
+	actions: {
+		onRowAction?: (key: Key) => void;
+		onCellAction?: (key: Key) => void;
+	};
+	shouldSelectOnPressUp?: boolean;
+}
+
+// Used to share:
+// keyboard delegate between useGrid and useGridCell
+// onRowAction/onCellAction across hooks
+export const gridMap: WeakMap<
+	GridState<unknown, GridCollection<unknown>>,
+	GridMapShared
+> = new WeakMap<GridState<unknown, GridCollection<unknown>>, GridMapShared>();

package/src/index.ts

@@ -318,3 +318,41 @@ export type {
 // combobox — mirrors the @react-aria/combobox shim surface.
 export { useComboBox } from './combobox/useComboBox';
 export type { AriaComboBoxProps, AriaComboBoxOptions, ComboBoxAria } from './combobox/useComboBox';
+
+// tree — mirrors the @react-aria/tree shim surface.
+export { useTree } from './tree/useTree';
+export { useTreeItem } from './tree/useTreeItem';
+export type { AriaTreeOptions, AriaTreeProps, TreeAria, TreeProps } from './tree/useTree';
+export type { AriaTreeItemOptions, TreeItemAria } from './tree/useTreeItem';
+
+// table — mirrors the @react-aria/table shim surface.
+export { useTable } from './table/useTable';
+export { useTableColumnHeader } from './table/useTableColumnHeader';
+export { useTableRow } from './table/useTableRow';
+export { useTableHeaderRow } from './table/useTableHeaderRow';
+export { useTableCell } from './table/useTableCell';
+export {
+	useTableSelectionCheckbox,
+	useTableSelectAllCheckbox,
+} from './table/useTableSelectionCheckbox';
+export { useTableColumnResize } from './table/useTableColumnResize';
+export { useTableRowGroup } from './table/useTableRowGroup';
+export type { AriaTableProps } from './table/useTable';
+export type {
+	AriaTableColumnHeaderProps,
+	TableColumnHeaderAria,
+} from './table/useTableColumnHeader';
+export type { TableRowAria } from './table/useTableRow';
+export type { TableHeaderRowAria } from './table/useTableHeaderRow';
+export type { AriaTableCellProps, TableCellAria } from './table/useTableCell';
+export type {
+	AriaTableSelectionCheckboxProps,
+	TableSelectionCheckboxAria,
+	TableSelectAllCheckboxAria,
+} from './table/useTableSelectionCheckbox';
+export type {
+	AriaTableColumnResizeProps,
+	TableColumnResizeAria,
+} from './table/useTableColumnResize';
+export type { GridAria, GridProps } from './grid/useGrid';
+export type { GridRowAria, GridRowProps } from './grid/useGridRow';

package/src/intl/autocomplete/ar-AE.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "مقترحات"
+}

package/src/intl/autocomplete/bg-BG.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Предложения"
+}

package/src/intl/autocomplete/cs-CZ.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Návrhy"
+}

package/src/intl/autocomplete/da-DK.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Forslag"
+}

package/src/intl/autocomplete/de-DE.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Empfehlungen"
+}

package/src/intl/autocomplete/el-GR.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Προτάσεις"
+}

package/src/intl/autocomplete/en-US.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Suggestions"
+}

package/src/intl/autocomplete/es-ES.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Sugerencias"
+}

package/src/intl/autocomplete/et-EE.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Soovitused"
+}

package/src/intl/autocomplete/fi-FI.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Ehdotukset"
+}

package/src/intl/autocomplete/fr-FR.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Suggestions"
+}

package/src/intl/autocomplete/he-IL.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "הצעות"
+}

package/src/intl/autocomplete/hr-HR.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Prijedlozi"
+}

package/src/intl/autocomplete/hu-HU.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Javaslatok"
+}

package/src/intl/autocomplete/index.ts

@@ -0,0 +1,82 @@
+// Generated locale-dictionary index for the autocomplete area — the octane equivalent of
+// upstream's Parcel glob import (`import intlMessages from '../../intl/autocomplete/*.json'`).
+// The JSON files are copied VERBATIM from .react-spectrum/packages/react-aria/intl/autocomplete/;
+// refresh them from the pinned checkout on version bumps, never hand-edit.
+//
+// Upstream's Parcel build additionally compiles each message through
+// @internationalized/string-compiler, so `{variable}` placeholders and plural/select
+// ICU arguments become message FUNCTIONS (LocalizedStringFormatter interpolates only
+// function messages — plain strings are returned verbatim). `compileDictionaries`
+// applies the equivalent compile step here at module init.
+import { compileDictionaries } from '../compileMessages';
+import ar_AE from './ar-AE.json';
+import bg_BG from './bg-BG.json';
+import cs_CZ from './cs-CZ.json';
+import da_DK from './da-DK.json';
+import de_DE from './de-DE.json';
+import el_GR from './el-GR.json';
+import en_US from './en-US.json';
+import es_ES from './es-ES.json';
+import et_EE from './et-EE.json';
+import fi_FI from './fi-FI.json';
+import fr_FR from './fr-FR.json';
+import he_IL from './he-IL.json';
+import hr_HR from './hr-HR.json';
+import hu_HU from './hu-HU.json';
+import it_IT from './it-IT.json';
+import ja_JP from './ja-JP.json';
+import ko_KR from './ko-KR.json';
+import lt_LT from './lt-LT.json';
+import lv_LV from './lv-LV.json';
+import nb_NO from './nb-NO.json';
+import nl_NL from './nl-NL.json';
+import pl_PL from './pl-PL.json';
+import pt_BR from './pt-BR.json';
+import pt_PT from './pt-PT.json';
+import ro_RO from './ro-RO.json';
+import ru_RU from './ru-RU.json';
+import sk_SK from './sk-SK.json';
+import sl_SI from './sl-SI.json';
+import sr_SP from './sr-SP.json';
+import sv_SE from './sv-SE.json';
+import tr_TR from './tr-TR.json';
+import uk_UA from './uk-UA.json';
+import zh_CN from './zh-CN.json';
+import zh_TW from './zh-TW.json';
+
+export default compileDictionaries({
+	'ar-AE': ar_AE,
+	'bg-BG': bg_BG,
+	'cs-CZ': cs_CZ,
+	'da-DK': da_DK,
+	'de-DE': de_DE,
+	'el-GR': el_GR,
+	'en-US': en_US,
+	'es-ES': es_ES,
+	'et-EE': et_EE,
+	'fi-FI': fi_FI,
+	'fr-FR': fr_FR,
+	'he-IL': he_IL,
+	'hr-HR': hr_HR,
+	'hu-HU': hu_HU,
+	'it-IT': it_IT,
+	'ja-JP': ja_JP,
+	'ko-KR': ko_KR,
+	'lt-LT': lt_LT,
+	'lv-LV': lv_LV,
+	'nb-NO': nb_NO,
+	'nl-NL': nl_NL,
+	'pl-PL': pl_PL,
+	'pt-BR': pt_BR,
+	'pt-PT': pt_PT,
+	'ro-RO': ro_RO,
+	'ru-RU': ru_RU,
+	'sk-SK': sk_SK,
+	'sl-SI': sl_SI,
+	'sr-SP': sr_SP,
+	'sv-SE': sv_SE,
+	'tr-TR': tr_TR,
+	'uk-UA': uk_UA,
+	'zh-CN': zh_CN,
+	'zh-TW': zh_TW,
+});

package/src/intl/autocomplete/it-IT.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Suggerimenti"
+}

package/src/intl/autocomplete/ja-JP.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "候補"
+}

package/src/intl/autocomplete/ko-KR.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "제안"
+}

package/src/intl/autocomplete/lt-LT.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Pasiūlymai"
+}

package/src/intl/autocomplete/lv-LV.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Ieteikumi"
+}

package/src/intl/autocomplete/nb-NO.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Forslag"
+}

package/src/intl/autocomplete/nl-NL.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Suggesties"
+}

package/src/intl/autocomplete/pl-PL.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Sugestie"
+}

package/src/intl/autocomplete/pt-BR.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Sugestões"
+}

package/src/intl/autocomplete/pt-PT.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Sugestões"
+}

package/src/intl/autocomplete/ro-RO.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Sugestii"
+}

package/src/intl/autocomplete/ru-RU.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Предложения"
+}

package/src/intl/autocomplete/sk-SK.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Návrhy"
+}

package/src/intl/autocomplete/sl-SI.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Predlogi"
+}

package/src/intl/autocomplete/sr-SP.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Predlozi"
+}

package/src/intl/autocomplete/sv-SE.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Förslag"
+}

package/src/intl/autocomplete/tr-TR.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Öneriler"
+}

package/src/intl/autocomplete/uk-UA.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "Пропозиції"
+}

package/src/intl/autocomplete/zh-CN.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "建议"
+}

package/src/intl/autocomplete/zh-TW.json

@@ -0,0 +1,3 @@
+{
+  "collectionLabel": "建議"
+}

package/src/intl/breadcrumbs/index.ts

@@ -2,6 +2,13 @@
 // upstream's Parcel glob import (`import intlMessages from '../../intl/breadcrumbs/*.json'`).
 // The JSON files are copied VERBATIM from .react-spectrum/packages/react-aria/intl/breadcrumbs/;
 // refresh them from the pinned checkout on version bumps, never hand-edit.
+//
+// Upstream's Parcel build additionally compiles each message through
+// @internationalized/string-compiler, so `{variable}` placeholders and plural/select
+// ICU arguments become message FUNCTIONS (LocalizedStringFormatter interpolates only
+// function messages — plain strings are returned verbatim). `compileDictionaries`
+// applies the equivalent compile step here at module init.
+import { compileDictionaries } from '../compileMessages';
 import ar_AE from './ar-AE.json';
 import bg_BG from './bg-BG.json';
 import cs_CZ from './cs-CZ.json';
@@ -37,7 +44,7 @@ import uk_UA from './uk-UA.json';
 import zh_CN from './zh-CN.json';
 import zh_TW from './zh-TW.json';
 
-export default {
+export default compileDictionaries({
 	'ar-AE': ar_AE,
 	'bg-BG': bg_BG,
 	'cs-CZ': cs_CZ,
@@ -72,4 +79,4 @@ export default {
 	'uk-UA': uk_UA,
 	'zh-CN': zh_CN,
 	'zh-TW': zh_TW,
-} as Record<string, Record<string, string>>;
+});

package/src/intl/combobox/index.ts

@@ -2,6 +2,13 @@
 // upstream's Parcel glob import (`import intlMessages from '../../intl/combobox/*.json'`).
 // The JSON files are copied VERBATIM from .react-spectrum/packages/react-aria/intl/combobox/;
 // refresh them from the pinned checkout on version bumps, never hand-edit.
+//
+// Upstream's Parcel build additionally compiles each message through
+// @internationalized/string-compiler, so `{variable}` placeholders and plural/select
+// ICU arguments become message FUNCTIONS (LocalizedStringFormatter interpolates only
+// function messages — plain strings are returned verbatim). `compileDictionaries`
+// applies the equivalent compile step here at module init.
+import { compileDictionaries } from '../compileMessages';
 import ar_AE from './ar-AE.json';
 import bg_BG from './bg-BG.json';
 import cs_CZ from './cs-CZ.json';
@@ -37,7 +44,7 @@ import uk_UA from './uk-UA.json';
 import zh_CN from './zh-CN.json';
 import zh_TW from './zh-TW.json';
 
-export default {
+export default compileDictionaries({
 	'ar-AE': ar_AE,
 	'bg-BG': bg_BG,
 	'cs-CZ': cs_CZ,
@@ -72,4 +79,4 @@ export default {
 	'uk-UA': uk_UA,
 	'zh-CN': zh_CN,
 	'zh-TW': zh_TW,
-} as Record<string, Record<string, string>>;
+});