@aiquants/directory-tree 3.6.1 → 3.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/types.d.ts CHANGED
@@ -570,6 +570,14 @@ export type DirectoryEntryItemProps = {
570
570
  depth: number;
571
571
  /** True when this row is part of the item-selection set (`aria-selected`). / 選択集合に含まれるか。 */
572
572
  isSelectedForAria: boolean;
573
+ /** Index of this row in the flattened (visible) list. / フラット化後 (可視) リスト内の位置。 */
574
+ flatIndex: number;
575
+ /** True when this row is the single tab stop of the tree (roving tabindex). / ツリー内で唯一のタブ停止点か。 */
576
+ isActive: boolean;
577
+ /** Registers the row element so the tree can move focus to it. / フォーカス移動のために行要素を登録する。 */
578
+ registerRowRef: (index: number, node: HTMLDivElement | null) => void;
579
+ /** Handles tree-level navigation keys. / ツリー全体のナビゲーションキーを処理する。 */
580
+ onNavigationKeyDown: (event: import('react').KeyboardEvent<HTMLDivElement>, index: number) => void;
573
581
  /** 1-based position among its siblings (`aria-posinset`). / 兄弟内の位置 (1 始まり)。 */
574
582
  positionInSet: number;
575
583
  /** Number of siblings in the same group (`aria-setsize`). / 同一グループの兄弟数。 */
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aiquants/directory-tree",
3
- "version": "3.6.1",
3
+ "version": "3.7.0",
4
4
  "description": "High-performance directory tree component for React with virtual scrolling and file selection",
5
5
  "sideEffects": [
6
6
  "**/*.css"
@@ -4,6 +4,8 @@
4
4
 
5
5
  | Version | Date | Author | Reviewer | Approver | Summary of Changes |
6
6
  | :--- | :--- | :--- | :--- | :--- | :--- |
7
+ | 3.7.0 | 2026-08-08 | Claude Opus 5 | | | Implement the WAI-ARIA tree keyboard contract and complete the grid's ARIA structure — the two gaps 3.6.0 recorded as outstanding. Rows now use a **roving tabindex**: exactly one row is a tab stop, so tabbing past a 500-row tree costs one keystroke instead of 500. `ArrowUp`/`ArrowDown` move between visible rows, `Home`/`End` jump to either end, `ArrowRight` opens a collapsed directory or descends into an open one, `ArrowLeft` closes an open directory or returns to the parent, and `Space` activates a row alongside `Enter`. Because rows outside the render window do not exist in the DOM, navigation first calls `virtualScroll.scrollToIndex` and focuses the row when it registers, so movement works across the whole tree rather than only the rendered window. In grid mode the header, body and footer rows are now wrapped in `role="rowgroup"` elements — the body group is applied to the scroll-pane content element through the `contentProps` seam added in 3.5.0, which is where the `@aiquants/virtualscroll` contract says a composite role belongs. |
8
+ | 3.6.1 | 2026-08-08 | Claude Opus 5 | | | Fix `aria-selected` to reflect `selection.selectedItems` in **every** mode. 3.6.0 read `selectedPath` in single mode, but `selectedPath` is the *currently-open* row highlight, a separate concept from the selection set that `selection.mode` governs — so a row the user had not selected was announced as selected. |
7
9
  | 3.6.0 | 2026-08-08 | Claude Opus 5 | | | Expose selection and identity to assistive tech. Rows emit `aria-selected` whenever `selection.mode` is not `"none"` (single mode reflects `selectedPath`, multiple reflects `selectedItems`), and the tree/treegrid emits `aria-multiselectable` in multiple mode — previously selection was conveyed only by background colour, so a non-sighted user could not tell what was selected or that multi-select was even available. New `visual.ariaLabel` / `visual.ariaLabelledBy` give the tree an accessible name; with several trees on a page it was previously unnameable through the public API. Grid mode additionally emits `aria-rowcount` on the container and `aria-rowindex` on each row, which a virtualized `treegrid` requires once only a window of rows is in the DOM. **Known remaining gap (pre-existing, not addressed here):** in grid mode the body rows sit below five roleless wrapper divs with no `rowgroup` / `presentation`, so the grid axis is still non-conforming; grid mode currently has no consumer in this repository. Row keyboard navigation (roving tabindex + arrow keys) is likewise still outstanding — every row remains a tab stop. |
8
10
  | 3.5.1 | 2026-08-08 | Claude Opus 5 | | | Hardening of the 3.5.0 `data` API after adversarial review. `null` / `undefined` values now omit the attribute entirely instead of rendering `data-x="undefined"` — the type forbids them, but a dynamic or JS-side value can still produce one, and a consumer testing attribute *presence* would read that as a real state. The key-conversion contract is also corrected: it lowercases and inserts a dash before a capital that follows a lowercase letter or digit, which is **not** identical to the DOM `dataset` reverse mapping (`aBC` becomes `a-bc`, not `a-b-c`) and is **not injective** (`panelCount` and `panel-count` collapse to the same attribute; within one object the later key wins). 3.5.0 documented these as equivalent, which was wrong. Tests added for the nullish case and for grid-mode `data-*` + position output. |
9
11
  | 3.5.0 | 2026-08-08 | Claude Opus 5 | | | Rows now declare their position in the tree: `aria-level` (1-based **logical** depth, so `visual.removeRootIndent` no longer misreports the hierarchy it only shifts visually), `aria-posinset` and `aria-setsize`, taken from the **post-sort** sibling order so the announced position always matches the rendered one. Grid rows gain `aria-posinset` / `aria-setsize` alongside the `aria-level` they already had. New `DirectoryEntry.data` renders extra `data-*` attributes on the row so consumers can expose state as attributes instead of CSS classes (class names are a styling contract and break silently under utility refactors); keys are given without the `data-` prefix and camelCase is converted to kebab-case exactly as the DOM `dataset` API does, since React otherwise drops the attribute with only a warning. The component's own `data-entry-*` attributes cannot be overridden. Also completes the pass-through audit started in 3.4.0: `virtualScroll.testId` and `virtualScroll.contentProps` were accepted by the type but never forwarded, and are now forwarded (they target the scroll pane, a different element from the `role="tree"` container this component owns, so there is no ARIA conflict). |
@@ -532,7 +534,8 @@ guards). Run `pnpm run test:coverage`.
532
534
  * **`entry.data`**: rendered as `data-*`; camelCase converted to kebab-case; absent/empty `data` adds no attributes; the component's own `data-entry-*` cannot be overridden.
533
535
  * **Pass-through**: `virtualScroll.testId` and `virtualScroll.contentProps` actually reach `VirtualScroll` (regression gate for the typed-but-dropped class of defect).
534
536
 
535
- * **Selection semantics**: `aria-selected` is absent when `selection.mode` is `"none"`, reflects `selectedPath` in single mode and `selectedItems` in multiple mode; `aria-multiselectable` appears only in multiple mode.
537
+ * **Keyboard contract** ([DirectoryTree.keyboard.test.tsx](../tests/DirectoryTree.keyboard.test.tsx)): exactly one tab stop at all times and it follows the active row; Arrow/Home/End movement including the no-op at both ends; `ArrowRight` opening a collapsed directory vs. descending into an open one; `ArrowLeft` closing vs. returning to the parent; `Enter` and `Space` both activating.
538
+ * **Selection semantics**: `aria-selected` is absent when `selection.mode` is `"none"` and otherwise reflects `selectedItems` in every mode (never `selectedPath`, which is the open-row highlight rather than a selection); `aria-multiselectable` appears only in multiple mode.
536
539
  * **Accessible name**: `visual.ariaLabel` names the tree; `visual.ariaLabelledBy` takes precedence and suppresses `aria-label`.
537
540
 
538
541
  ### 9.6. Pure helpers
@@ -339,6 +339,10 @@ const DirectoryEntryItem = memo<DirectoryEntryItemProps>(
339
339
  positionInSet,
340
340
  setSize,
341
341
  isSelectedForAria,
342
+ flatIndex,
343
+ isActive,
344
+ registerRowRef,
345
+ onNavigationKeyDown,
342
346
  rowHeight,
343
347
  isDirOpen,
344
348
  parentIsLast,
@@ -446,8 +450,18 @@ const DirectoryEntryItem = memo<DirectoryEntryItemProps>(
446
450
  onClick={handleInteraction}
447
451
  onMouseEnter={() => setIsHovered(true)}
448
452
  onMouseLeave={() => setIsHovered(false)}
449
- onKeyDown={(e) => e.key === "Enter" && handleInteraction(e as unknown as MouseEvent<HTMLDivElement>)}
450
- tabIndex={0}
453
+ ref={(node) => registerRowRef(flatIndex, node)}
454
+ onKeyDown={(e) => {
455
+ if (e.key === "Enter" || e.key === " ") {
456
+ e.preventDefault()
457
+ handleInteraction(e as unknown as MouseEvent<HTMLDivElement>)
458
+ return
459
+ }
460
+ onNavigationKeyDown(e, flatIndex)
461
+ }}
462
+ // roving tabindex: ツリー全体で 1 つだけがタブ停止点。全行を停止点にすると
463
+ // 大きなツリーではタブキーだけで抜けるのに数百回の打鍵が要る
464
+ tabIndex={isActive ? 0 : -1}
451
465
  role="treeitem"
452
466
  aria-expanded={isDirectory ? isExpanded : undefined}
453
467
  aria-level={depth + 1}
@@ -485,6 +499,11 @@ const DirectoryEntryItem = memo<DirectoryEntryItemProps>(
485
499
  positionInSet={index + 1}
486
500
  setSize={childrenToRender.length}
487
501
  isSelectedForAria={Boolean(selectedItems?.has(child.absolutePath))}
502
+ // この再帰経路は仮想化により到達しない。キーボード制御はツリー本体が持つため無効値を渡す
503
+ flatIndex={-1}
504
+ isActive={false}
505
+ registerRowRef={registerRowRef}
506
+ onNavigationKeyDown={onNavigationKeyDown}
488
507
  // 非仮想化の再帰描画では親行の高さを一様に流用する (DirectoryTree は renderChildren=false のため通常この経路は通らない)。
489
508
  rowHeight={rowHeight}
490
509
  isDirOpen={isDirOpen}
@@ -530,6 +549,8 @@ const DirectoryEntryItem = memo<DirectoryEntryItemProps>(
530
549
  prev.positionInSet === next.positionInSet &&
531
550
  prev.setSize === next.setSize &&
532
551
  prev.isSelectedForAria === next.isSelectedForAria &&
552
+ prev.flatIndex === next.flatIndex &&
553
+ prev.isActive === next.isActive &&
533
554
  prev.rowHeight === next.rowHeight &&
534
555
  prevExpanded === nextExpanded &&
535
556
  prev.selection.selectedPath === next.selection.selectedPath &&
@@ -648,6 +669,11 @@ export const DirectoryTree = ({
648
669
  contentProps,
649
670
  }: DirectoryTreeVirtualScrollOptions = virtualScrollOptions ?? {}
650
671
 
672
+ // 合成ウィジェットのロールは行だけを直接所有するコンテンツ要素へ置く (VirtualScroll の契約)。
673
+ // grid モードでは本体行をまとめる rowgroup がここに当たる。利用側指定を土台にし、
674
+ // role は利用側が明示した場合のみ譲る
675
+ const resolvedContentProps = useMemo(() => (isGrid ? { role: "rowgroup", ...contentProps } : contentProps), [isGrid, contentProps])
676
+
651
677
  const [scrollPosition, setScrollPosition] = useState(typeof initialScrollOffset === "number" ? initialScrollOffset : 0)
652
678
  // アンカー補正用の最新スクロール位置 (effect の依存に scrollPosition を入れないための鏡)
653
679
  const scrollPositionRef = useRef(typeof initialScrollOffset === "number" ? initialScrollOffset : 0)
@@ -796,6 +822,109 @@ export const DirectoryTree = ({
796
822
  const defaultGetItemKey = useCallback((index: number) => virtualItems[index]?.entry.absolutePath ?? index, [virtualItems])
797
823
  const resolvedGetItemKey = userGetItemKey ?? defaultGetItemKey
798
824
 
825
+ // ハンドラの identity を安定させるための鏡。依存に直接入れると毎レンダーで全行の memo が壊れる
826
+ const flatItemsRef = useRef(flatItems)
827
+ flatItemsRef.current = flatItems
828
+ const safeIsExpandedRef = useRef(safeIsExpanded)
829
+ safeIsExpandedRef.current = safeIsExpanded
830
+ const toggleRef = useRef(toggle)
831
+ toggleRef.current = toggle
832
+
833
+ // --- キーボードナビゲーション (WAI-ARIA tree パターン) ---
834
+ // 仮想化のため目的の行が DOM に無いことがある。まず scrollToIndex で描画ウィンドウへ入れ、
835
+ // 行が現れてからフォーカスする (pendingFocusRef が「まだ掴めていない行」を保持する)
836
+ const [activeIndex, setActiveIndex] = useState(0)
837
+ const rowRefs = useRef(new Map<number, HTMLDivElement>())
838
+ const pendingFocusRef = useRef<number | null>(null)
839
+
840
+ const registerRowRef = useCallback((index: number, node: HTMLDivElement | null) => {
841
+ if (node) {
842
+ rowRefs.current.set(index, node)
843
+ if (pendingFocusRef.current === index) {
844
+ pendingFocusRef.current = null
845
+ node.focus()
846
+ }
847
+ } else {
848
+ rowRefs.current.delete(index)
849
+ }
850
+ }, [])
851
+
852
+ const focusRowAt = useCallback((index: number) => {
853
+ setActiveIndex(index)
854
+ const node = rowRefs.current.get(index)
855
+ if (node) {
856
+ node.focus()
857
+ return
858
+ }
859
+ // 未描画ならスクロールして、登録時にフォーカスする
860
+ pendingFocusRef.current = index
861
+ virtualScrollRef.current?.scrollToIndex(index)
862
+ }, [])
863
+
864
+ // 行数が減ったとき (折り畳みなど) に活性行が範囲外へ出ないようにする
865
+ useEffect(() => {
866
+ setActiveIndex((previous) => (flatItems.length === 0 ? 0 : Math.min(previous, flatItems.length - 1)))
867
+ }, [flatItems.length])
868
+
869
+ const handleNavigationKeyDown = useCallback(
870
+ (event: React.KeyboardEvent<HTMLDivElement>, index: number) => {
871
+ const items = flatItemsRef.current
872
+ const lastIndex = items.length - 1
873
+ if (lastIndex < 0) return
874
+
875
+ const current = items[index]
876
+ const isDirectoryRow = current?.entry.children !== undefined
877
+ const isExpandedRow = isDirectoryRow && safeIsExpandedRef.current(current.entry.absolutePath)
878
+
879
+ switch (event.key) {
880
+ case "ArrowDown":
881
+ event.preventDefault()
882
+ focusRowAt(Math.min(index + 1, lastIndex))
883
+ break
884
+ case "ArrowUp":
885
+ event.preventDefault()
886
+ focusRowAt(Math.max(index - 1, 0))
887
+ break
888
+ case "Home":
889
+ event.preventDefault()
890
+ focusRowAt(0)
891
+ break
892
+ case "End":
893
+ event.preventDefault()
894
+ focusRowAt(lastIndex)
895
+ break
896
+ case "ArrowRight":
897
+ event.preventDefault()
898
+ // 折り畳み中のディレクトリは開く。既に開いているなら最初の子へ進む
899
+ if (isDirectoryRow && !isExpandedRow) {
900
+ toggleRef.current(current.entry.absolutePath)
901
+ } else if (isDirectoryRow && index < lastIndex) {
902
+ focusRowAt(index + 1)
903
+ }
904
+ break
905
+ case "ArrowLeft": {
906
+ event.preventDefault()
907
+ // 開いているディレクトリは閉じる。それ以外は親へ戻る
908
+ if (isDirectoryRow && isExpandedRow) {
909
+ toggleRef.current(current.entry.absolutePath)
910
+ break
911
+ }
912
+ const currentDepth = current?.depth ?? 0
913
+ for (let candidate = index - 1; candidate >= 0; candidate--) {
914
+ if (items[candidate].depth < currentDepth) {
915
+ focusRowAt(candidate)
916
+ break
917
+ }
918
+ }
919
+ break
920
+ }
921
+ default:
922
+ break
923
+ }
924
+ },
925
+ [focusRowAt],
926
+ )
927
+
799
928
  const treeLineGeometry = useMemo(
800
929
  () => (!showTreeLines || lineItems.length === 0 ? { segmentsByItem: [], glyphsByItem: [] } : buildTreeLineGeometry(lineItems, itemHeights, itemOffsets, INDENT_SIZE, showTreeLines, expandIconSize ?? EXPAND_GLYPH_SIZE)),
801
930
  [lineItems, itemHeights, itemOffsets, showTreeLines, expandIconSize],
@@ -919,7 +1048,7 @@ export const DirectoryTree = ({
919
1048
  getItemHeight={getItemHeight}
920
1049
  getItemKey={resolvedGetItemKey}
921
1050
  testId={testId}
922
- contentProps={contentProps}
1051
+ contentProps={resolvedContentProps}
923
1052
  viewportSize={viewportHeight}
924
1053
  overscanCount={userOverscanCount}
925
1054
  onScroll={handleVirtualScroll}
@@ -980,6 +1109,10 @@ export const DirectoryTree = ({
980
1109
  positionInSet={item.positionInSet}
981
1110
  setSize={item.setSize}
982
1111
  isSelectedForAria={Boolean(selectedItems?.has(item.entry.absolutePath))}
1112
+ flatIndex={index}
1113
+ isActive={index === activeIndex}
1114
+ registerRowRef={registerRowRef}
1115
+ onNavigationKeyDown={handleNavigationKeyDown}
983
1116
  rowHeight={item.rowHeight}
984
1117
  isDirOpen={safeIsExpanded}
985
1118
  parentIsLast={item.parentIsLast}
@@ -1014,7 +1147,10 @@ export const DirectoryTree = ({
1014
1147
  getItemHeight,
1015
1148
  resolvedGetItemKey,
1016
1149
  testId,
1017
- contentProps,
1150
+ resolvedContentProps,
1151
+ activeIndex,
1152
+ registerRowRef,
1153
+ handleNavigationKeyDown,
1018
1154
  viewportHeight,
1019
1155
  userOverscanCount,
1020
1156
  handleVirtualScroll,
@@ -1083,7 +1219,13 @@ export const DirectoryTree = ({
1083
1219
  aria-labelledby={ariaLabelledBy}
1084
1220
  aria-multiselectable={selectionMode === "multiple" ? true : undefined}
1085
1221
  aria-rowcount={virtualItems.length + ((grid.showHeader ?? true) ? 1 : 0)}>
1086
- {showHeader && <DirectoryTreeGridHeaderRow columns={grid.columns} numericTemplate={numericTemplate} numericTotal={gridMetrics.numericTotal} nameWidth={gridMetrics.nameWidth} scrollBarWidth={gridScrollBarWidth} className={grid.headerClassName} />}
1222
+ {/* treegrid が直接所有するのは rowgroup。行を裸で置くと所有関係が壊れる */}
1223
+ {showHeader && (
1224
+ // biome-ignore lint/a11y/useSemanticElements: 仮想スクロールの treegrid は絶対配置行を使うため native table 要素にできない。ARIA ロールで意味を提供する
1225
+ <div role="rowgroup">
1226
+ <DirectoryTreeGridHeaderRow columns={grid.columns} numericTemplate={numericTemplate} numericTotal={gridMetrics.numericTotal} nameWidth={gridMetrics.nameWidth} scrollBarWidth={gridScrollBarWidth} className={grid.headerClassName} />
1227
+ </div>
1228
+ )}
1087
1229
  <div ref={bodyRef} className="dt-grid-body">
1088
1230
  {virtualScrollElement}
1089
1231
  </div>
@@ -1107,7 +1249,10 @@ export const DirectoryTree = ({
1107
1249
  </div>
1108
1250
  )}
1109
1251
  {showFooter && (
1110
- <DirectoryTreeGridFooterRow columns={grid.columns} numericTemplate={numericTemplate} numericTotal={gridMetrics.numericTotal} nameWidth={gridMetrics.nameWidth} scrollBarWidth={gridScrollBarWidth} allEntries={allEntriesFlat} className={grid.footerClassName} />
1252
+ // biome-ignore lint/a11y/useSemanticElements: 同上 (フッタ行も絶対配置レイアウトの一部)
1253
+ <div role="rowgroup">
1254
+ <DirectoryTreeGridFooterRow columns={grid.columns} numericTemplate={numericTemplate} numericTotal={gridMetrics.numericTotal} nameWidth={gridMetrics.nameWidth} scrollBarWidth={gridScrollBarWidth} allEntries={allEntriesFlat} className={grid.footerClassName} />
1255
+ </div>
1111
1256
  )}
1112
1257
  </div>
1113
1258
  )
package/src/types.ts CHANGED
@@ -592,6 +592,14 @@ export type DirectoryEntryItemProps = {
592
592
  depth: number
593
593
  /** True when this row is part of the item-selection set (`aria-selected`). / 選択集合に含まれるか。 */
594
594
  isSelectedForAria: boolean
595
+ /** Index of this row in the flattened (visible) list. / フラット化後 (可視) リスト内の位置。 */
596
+ flatIndex: number
597
+ /** True when this row is the single tab stop of the tree (roving tabindex). / ツリー内で唯一のタブ停止点か。 */
598
+ isActive: boolean
599
+ /** Registers the row element so the tree can move focus to it. / フォーカス移動のために行要素を登録する。 */
600
+ registerRowRef: (index: number, node: HTMLDivElement | null) => void
601
+ /** Handles tree-level navigation keys. / ツリー全体のナビゲーションキーを処理する。 */
602
+ onNavigationKeyDown: (event: import("react").KeyboardEvent<HTMLDivElement>, index: number) => void
595
603
  /** 1-based position among its siblings (`aria-posinset`). / 兄弟内の位置 (1 始まり)。 */
596
604
  positionInSet: number
597
605
  /** Number of siblings in the same group (`aria-setsize`). / 同一グループの兄弟数。 */