@aiquants/directory-tree 3.5.1 → 3.6.1

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
@@ -405,6 +405,19 @@ export type DirectoryTreeProps = {
405
405
  * コンテナ用のオプションのインラインスタイル。
406
406
  */
407
407
  style?: CSSProperties;
408
+ /**
409
+ * Accessible name for the tree as a whole (`aria-label` on the tree/treegrid element).
410
+ * ツリー全体のアクセシブル名 (tree/treegrid 要素の `aria-label`)。
411
+ *
412
+ * 支援技術にとって、ページ内に複数のツリーがある場合これが唯一の識別手段になる。
413
+ * 可視の見出しがある場合は `ariaLabelledBy` の方が望ましい。
414
+ */
415
+ ariaLabel?: string;
416
+ /**
417
+ * `id` of a visible element naming the tree (`aria-labelledby`). Takes precedence over `ariaLabel`.
418
+ * ツリーを説明する可視要素の `id` (`aria-labelledby`)。`ariaLabel` より優先。
419
+ */
420
+ ariaLabelledBy?: string;
408
421
  /**
409
422
  * Line color for tree connections.
410
423
  * ツリーラインの色。
@@ -555,6 +568,8 @@ export type DirectoryEntryItemProps = {
555
568
  * こちらを用いる (支援技術へ伝えるのは見た目のずれではなく実際の階層)。
556
569
  */
557
570
  depth: number;
571
+ /** True when this row is part of the item-selection set (`aria-selected`). / 選択集合に含まれるか。 */
572
+ isSelectedForAria: boolean;
558
573
  /** 1-based position among its siblings (`aria-posinset`). / 兄弟内の位置 (1 始まり)。 */
559
574
  positionInSet: number;
560
575
  /** 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.5.1",
3
+ "version": "3.6.1",
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,7 @@
4
4
 
5
5
  | Version | Date | Author | Reviewer | Approver | Summary of Changes |
6
6
  | :--- | :--- | :--- | :--- | :--- | :--- |
7
+ | 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. |
7
8
  | 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. |
8
9
  | 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). |
9
10
  | 3.4.0 | 2026-08-08 | Claude Opus 5 | | | Add the optional top-level `sort` prop (`DirectoryEntryComparator`), applied to every sibling group inside `collectTreeData` immediately before flattening. Only a shallow copy of each sibling array is sorted, so every `DirectoryEntry` object and every `children` array keeps its identity and consumer-side memoization (row memo, reference-preserving decorators, hydration caches) survives a re-sort; the caller's `entries` arrays are never mutated. `isLastChild` and the ancestor chain derive from the loop index, so connector geometry follows the sorted order automatically, in grid mode too. Ordering is deliberately a top-level prop rather than a `visual` member because it changes row semantics rather than presentation. Also fixes a latent defect exposed by any reordering: `virtualScroll.getItemKey` was accepted by the type but never destructured or forwarded, so `VirtualScroll` fell back to index keying and every row whose index-to-entry mapping changed was unmounted and remounted; it is now forwarded, defaulting to `entry.absolutePath`. |
@@ -142,6 +143,7 @@ The `DirectoryTree` component accepts the following props:
142
143
  | `expansion` | `object` | Yes | - | Configuration for tree expansion state and behavior. ツリーの展開状態と動作の設定。 |
143
144
  | `selection` | `object` | Yes | - | Configuration for item selection. アイテム選択の設定。 |
144
145
  | `visual` | `object` | No | - | Visual customization options. 表示のカスタマイズオプション。 |
146
+ | `visual.ariaLabel` / `visual.ariaLabelledBy` | `string` | No | - | Accessible name for the tree as a whole. `ariaLabelledBy` (id of a visible naming element) takes precedence. ツリー全体のアクセシブル名。`ariaLabelledBy` が優先。 |
145
147
  | `virtualScroll` | `DirectoryTreeVirtualScrollOptions` | No | - | Additional options for VirtualScroll integration. Includes `viewportHeightOverride` and `preserveScrollAnchor` (opt-in, default `false`: keeps the first visible row visually stationary across row-list mutations such as streaming insertions above the viewport; inactive at scroll 0; falls back to pixel-position when the anchored row vanished). VirtualScroll の設定を上書きするオプション。`preserveScrollAnchor` (既定 `false`) を有効化すると、行リスト変異時に先頭可視行を画面上で静止させる (最上部では不作動、アンカー行消失時はピクセル位置維持へフォールバック)。 |
146
148
  | `grid` | `DirectoryTreeGrid` | No | - | TreeGrid (columns) mode. When present, renders a frozen name column + aligned data columns with header/footer and a horizontally scrollable numeric region. See §3.2.4. TreeGrid(列)モード。指定時は凍結名前列+整列データ列を描画する(§3.2.4)。 |
147
149
  | `sort` | `DirectoryEntryComparator` | No | - | Comparator applied to every sibling group before flattening. Only a shallow copy of each sibling array is sorted, so entry objects and their `children` arrays keep identity. Omit to render in the given order. **Stable reference required.** See §3.2.5. フラット化前に各兄弟グループへ適用する比較関数。兄弟配列の浅いコピーのみを並べ替えるため、エントリと `children` の identity は保持される。省略時は与えられた順序のまま。**参照安定必須**(§3.2.5)。 |
@@ -530,6 +532,9 @@ guards). Run `pnpm run test:coverage`.
530
532
  * **`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.
531
533
  * **Pass-through**: `virtualScroll.testId` and `virtualScroll.contentProps` actually reach `VirtualScroll` (regression gate for the typed-but-dropped class of defect).
532
534
 
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.
536
+ * **Accessible name**: `visual.ariaLabel` names the tree; `visual.ariaLabelledBy` takes precedence and suppresses `aria-label`.
537
+
533
538
  ### 9.6. Pure helpers
534
539
 
535
540
  * **[gridUtils.test.ts](../tests/gridUtils.test.ts)**: `buildNumericTemplate`, `computeGridMetrics`, `clampHScroll`, `flattenAllEntries` (incl. default/invalid widths, zero-width viewport, NaN clamp).
@@ -338,6 +338,7 @@ const DirectoryEntryItem = memo<DirectoryEntryItemProps>(
338
338
  depth,
339
339
  positionInSet,
340
340
  setSize,
341
+ isSelectedForAria,
341
342
  rowHeight,
342
343
  isDirOpen,
343
344
  parentIsLast,
@@ -452,6 +453,7 @@ const DirectoryEntryItem = memo<DirectoryEntryItemProps>(
452
453
  aria-level={depth + 1}
453
454
  aria-posinset={positionInSet}
454
455
  aria-setsize={setSize}
456
+ aria-selected={selectionMode === "none" ? undefined : isSelectedForAria}
455
457
  aria-label={`${entry.name} (${isDirectory ? "directory" : "file"})`}>
456
458
  {(showExpandIcons || useCanvasExpandIcons) && <span className={expandIconClasses}>{expandIconContent}</span>}
457
459
  {(isDirectory ? showDirectoryIcons : showFileIcons) && (
@@ -482,6 +484,7 @@ const DirectoryEntryItem = memo<DirectoryEntryItemProps>(
482
484
  depth={depth + 1}
483
485
  positionInSet={index + 1}
484
486
  setSize={childrenToRender.length}
487
+ isSelectedForAria={Boolean(selectedItems?.has(child.absolutePath))}
485
488
  // 非仮想化の再帰描画では親行の高さを一様に流用する (DirectoryTree は renderChildren=false のため通常この経路は通らない)。
486
489
  rowHeight={rowHeight}
487
490
  isDirOpen={isDirOpen}
@@ -526,6 +529,7 @@ const DirectoryEntryItem = memo<DirectoryEntryItemProps>(
526
529
  prev.depth === next.depth &&
527
530
  prev.positionInSet === next.positionInSet &&
528
531
  prev.setSize === next.setSize &&
532
+ prev.isSelectedForAria === next.isSelectedForAria &&
529
533
  prev.rowHeight === next.rowHeight &&
530
534
  prevExpanded === nextExpanded &&
531
535
  prev.selection.selectedPath === next.selection.selectedPath &&
@@ -587,6 +591,8 @@ export const DirectoryTree = ({
587
591
  visual: {
588
592
  className,
589
593
  style,
594
+ ariaLabel,
595
+ ariaLabelledBy,
590
596
  lineColor = "#A0AEC0",
591
597
  showTreeLines = true,
592
598
  showExpandIcons = true,
@@ -940,7 +946,7 @@ export const DirectoryTree = ({
940
946
  contentInsets={virtualScrollContentInsets}
941
947
  scrollBarOptions={scrollBarOptions}
942
948
  behaviorOptions={behaviorOptions}>
943
- {(item) => {
949
+ {(item, index) => {
944
950
  if (!item) return null
945
951
  if (isGrid && grid && gridMetrics) {
946
952
  return (
@@ -950,6 +956,8 @@ export const DirectoryTree = ({
950
956
  indentLevel={item.indentLevel}
951
957
  positionInSet={item.positionInSet}
952
958
  setSize={item.setSize}
959
+ rowIndex={index + ((grid.showHeader ?? true) ? 2 : 1)}
960
+ isSelectedForAria={Boolean(selectedItems?.has(item.entry.absolutePath))}
953
961
  rowHeight={item.rowHeight}
954
962
  isDirOpen={safeIsExpanded}
955
963
  columns={grid.columns}
@@ -971,6 +979,7 @@ export const DirectoryTree = ({
971
979
  depth={item.depth}
972
980
  positionInSet={item.positionInSet}
973
981
  setSize={item.setSize}
982
+ isSelectedForAria={Boolean(selectedItems?.has(item.entry.absolutePath))}
974
983
  rowHeight={item.rowHeight}
975
984
  isDirOpen={safeIsExpanded}
976
985
  parentIsLast={item.parentIsLast}
@@ -1054,7 +1063,7 @@ export const DirectoryTree = ({
1054
1063
 
1055
1064
  if (!(grid && gridMetrics)) {
1056
1065
  return (
1057
- <div ref={containerRef} className={containerClasses} style={containerStyle} role="tree">
1066
+ <div ref={containerRef} className={containerClasses} style={containerStyle} role="tree" aria-label={ariaLabelledBy ? undefined : ariaLabel} aria-labelledby={ariaLabelledBy} aria-multiselectable={selectionMode === "multiple" ? true : undefined}>
1058
1067
  {virtualScrollElement}
1059
1068
  </div>
1060
1069
  )
@@ -1065,7 +1074,15 @@ export const DirectoryTree = ({
1065
1074
  const gridContainerStyle = { ...containerStyle, "--dt-hscroll": `${hscroll}px` } as CSSProperties
1066
1075
 
1067
1076
  return (
1068
- <div ref={containerRef} className={twMerge(containerClasses, "dt-grid")} style={gridContainerStyle} role="treegrid">
1077
+ <div
1078
+ ref={containerRef}
1079
+ className={twMerge(containerClasses, "dt-grid")}
1080
+ style={gridContainerStyle}
1081
+ role="treegrid"
1082
+ aria-label={ariaLabelledBy ? undefined : ariaLabel}
1083
+ aria-labelledby={ariaLabelledBy}
1084
+ aria-multiselectable={selectionMode === "multiple" ? true : undefined}
1085
+ aria-rowcount={virtualItems.length + ((grid.showHeader ?? true) ? 1 : 0)}>
1069
1086
  {showHeader && <DirectoryTreeGridHeaderRow columns={grid.columns} numericTemplate={numericTemplate} numericTotal={gridMetrics.numericTotal} nameWidth={gridMetrics.nameWidth} scrollBarWidth={gridScrollBarWidth} className={grid.headerClassName} />}
1070
1087
  <div ref={bodyRef} className="dt-grid-body">
1071
1088
  {virtualScrollElement}
@@ -48,6 +48,10 @@ export type DirectoryTreeGridRowProps = {
48
48
  positionInSet: number
49
49
  /** 同一グループの兄弟数。`aria-setsize` として出力する。 */
50
50
  setSize: number
51
+ /** treegrid 全体での 1 始まりの行番号 (`aria-rowindex`)。ヘッダ行を 1 とする。 */
52
+ rowIndex: number
53
+ /** 選択集合に含まれるか (`aria-selected`)。 */
54
+ isSelectedForAria: boolean
51
55
  rowHeight: number
52
56
  isDirOpen: (path: string) => boolean
53
57
  columns: DirectoryTreeColumn[]
@@ -81,6 +85,8 @@ export const DirectoryTreeGridRow = memo<DirectoryTreeGridRowProps>(
81
85
  indentLevel,
82
86
  positionInSet,
83
87
  setSize,
88
+ rowIndex,
89
+ isSelectedForAria,
84
90
  rowHeight,
85
91
  isDirOpen,
86
92
  columns,
@@ -142,6 +148,8 @@ export const DirectoryTreeGridRow = memo<DirectoryTreeGridRowProps>(
142
148
  aria-level={indentLevel + 1}
143
149
  aria-posinset={positionInSet}
144
150
  aria-setsize={setSize}
151
+ aria-rowindex={rowIndex}
152
+ aria-selected={selectionMode === "none" ? undefined : isSelectedForAria}
145
153
  {...toDataAttributes(entry.data)}
146
154
  data-entry-type={isDirectory ? "directory" : "file"}
147
155
  data-entry-expanded={isDirectory ? String(isExpanded) : undefined}
@@ -181,6 +189,8 @@ export const DirectoryTreeGridRow = memo<DirectoryTreeGridRowProps>(
181
189
  prev.indentLevel === next.indentLevel &&
182
190
  prev.positionInSet === next.positionInSet &&
183
191
  prev.setSize === next.setSize &&
192
+ prev.rowIndex === next.rowIndex &&
193
+ prev.isSelectedForAria === next.isSelectedForAria &&
184
194
  prev.rowHeight === next.rowHeight &&
185
195
  prevExpanded === nextExpanded &&
186
196
  prev.columns === next.columns &&
package/src/types.ts CHANGED
@@ -422,6 +422,19 @@ export type DirectoryTreeProps = {
422
422
  * コンテナ用のオプションのインラインスタイル。
423
423
  */
424
424
  style?: CSSProperties
425
+ /**
426
+ * Accessible name for the tree as a whole (`aria-label` on the tree/treegrid element).
427
+ * ツリー全体のアクセシブル名 (tree/treegrid 要素の `aria-label`)。
428
+ *
429
+ * 支援技術にとって、ページ内に複数のツリーがある場合これが唯一の識別手段になる。
430
+ * 可視の見出しがある場合は `ariaLabelledBy` の方が望ましい。
431
+ */
432
+ ariaLabel?: string
433
+ /**
434
+ * `id` of a visible element naming the tree (`aria-labelledby`). Takes precedence over `ariaLabel`.
435
+ * ツリーを説明する可視要素の `id` (`aria-labelledby`)。`ariaLabel` より優先。
436
+ */
437
+ ariaLabelledBy?: string
425
438
  /**
426
439
  * Line color for tree connections.
427
440
  * ツリーラインの色。
@@ -577,6 +590,8 @@ export type DirectoryEntryItemProps = {
577
590
  * こちらを用いる (支援技術へ伝えるのは見た目のずれではなく実際の階層)。
578
591
  */
579
592
  depth: number
593
+ /** True when this row is part of the item-selection set (`aria-selected`). / 選択集合に含まれるか。 */
594
+ isSelectedForAria: boolean
580
595
  /** 1-based position among its siblings (`aria-posinset`). / 兄弟内の位置 (1 始まり)。 */
581
596
  positionInSet: number
582
597
  /** Number of siblings in the same group (`aria-setsize`). / 同一グループの兄弟数。 */