@neo4j-ndl/react 4.21.2 → 4.22.0

package/lib/types/next/tree-view/TreeView.d.ts

@@ -20,7 +20,7 @@
  */
 import { type CommonProps, type TooltipObjectProps } from '../../_common/types';
 import { Menu } from '../../menu';
-type SelectionMode = 'single' | 'multiple';
+import { type SelectionMode } from './selection';
 type RootProps = {
     /** The aria-label for the tree. Required for accessibility, unless using ariaLabelledby. Pass null to omit. */
     ariaLabel: string | null;
@@ -28,8 +28,14 @@ type RootProps = {
     ariaLabelledby?: string;
     /** The children of the tree. Should be TreeView.Item components or TreeView.SkeletonItem components only. */
     children?: React.ReactNode;
+    /** Initially selected item ids for an uncontrolled root-managed selection. */
+    defaultSelectedIds?: string[];
+    /** Selected item ids. Makes the tree manage selection itself, instead of each item managing its own. */
+    selectedIds?: string[];
     /** Selection mode for the tree. Defaults to "single". */
     selectionMode?: SelectionMode;
+    /** Callback called with the complete next selection whenever the tree manages selection. Fires once per interaction. */
+    onSelectedIdsChange?: (selectedIds: string[]) => void;
 };
 type ItemProps = {
     /** Nested TreeView.Item or TreeView.SkeletonItem elements rendered as sub-items in a collapsible group. */
@@ -40,6 +46,8 @@ type ItemProps = {
     defaultExpanded?: boolean;
     /** Whether the item has children. Decides if the item should render a chevron for expansion. Needed for lazy loading. */
     hasChildren?: boolean;
+    /** Identifies the item. Required when the tree manages selection via `selectedIds`. */
+    id?: string;
     /** Whether the item is disabled */
     isDisabled?: boolean;
     /** Whether the item is expanded. Makes the item controlled. */
@@ -48,7 +56,9 @@ type ItemProps = {
     isIndeterminate?: boolean;
     /** Whether the item is loading. Applies aria-busy="true" to the item. */
     isLoading?: boolean;
-    /** Whether the item is selected */
+    /** Whether the item can be selected. Defaults to true when the tree manages selection, and otherwise to whether `onSelectedChange` is set. */
+    isSelectable?: boolean;
+    /** Whether the item is selected. Ignored when the tree manages selection via `selectedIds`. */
     isSelected?: boolean;
     /** Leading visual for the item. */
     leadingVisual?: React.ReactNode;
@@ -64,15 +74,29 @@ type ItemProps = {
     tooltipProps?: TooltipObjectProps;
     /** Callback called when the item is expanded/collapsed. */
     onExpandedChange?: (isExpanded: boolean) => void;
-    /** Callback called when the item is selected/deselected. */
+    /** Callback called when the item is selected/deselected. Receives the new selected state. Ignored when the tree manages selection via `selectedIds`. */
     onSelectedChange?: (isSelected: boolean) => void;
 };
 type SkeletonItemProps = {
     /** The number of rows to render. */
     rows?: number;
 };
-declare const TreeView: (({ children, selectionMode, ariaLabel, ariaLabelledby, className, style, htmlAttributes, ref, ...restProps }: CommonProps<"div", RootProps>) => import("react/jsx-runtime").JSX.Element) & {
-    Item: ({ actionMenuItems, children, defaultExpanded, hasChildren: hasChildrenProp, isDisabled, isExpanded: isExpandedProp, isIndeterminate, isLoading, isSelected, leadingVisual, title, tooltipContent, tooltipProps, trailingContent, onExpandedChange, onSelectedChange, actionMenuProps, className, style, htmlAttributes, ref, ...restProps }: CommonProps<"div", ItemProps>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * @remarks
+ * Selection can be managed per item, with `isSelected` and `onSelectedChange`
+ * on each `TreeView.Item`, or by the tree itself, by passing `selectedIds` (or
+ * `defaultSelectedIds`) together with `onSelectedIdsChange`. When the tree
+ * manages selection, every item needs an `id`, and each item's own
+ * `isSelected` and `onSelectedChange` are ignored.
+ *
+ * The available selection modes are:
+ *
+ * - `single` — one item at a time. An unmodified click selects the clicked item and never clears it.
+ * - `multiple` — multi-select with checkboxes. An unmodified click toggles an item, and `Shift` repeats that across a range without clearing anything outside it.
+ * - `multiple-replace` — multi-select without checkboxes. An unmodified click selects only that item, `Cmd`/`Ctrl` toggles it and moves the anchor, and `Shift` extends from that anchor while retaining its selection snapshot. `Shift` + arrow extends the range.
+ */
+declare const TreeView: (({ children, defaultSelectedIds, selectedIds: selectedIdsProp, selectionMode, ariaLabel, ariaLabelledby, className, style, htmlAttributes, onSelectedIdsChange, ref, ...restProps }: CommonProps<"div", RootProps>) => import("react/jsx-runtime").JSX.Element) & {
+    Item: ({ actionMenuItems, children, defaultExpanded, hasChildren: hasChildrenProp, id: idProp, isDisabled, isExpanded: isExpandedProp, isIndeterminate, isLoading, isSelectable: isSelectableProp, isSelected: isSelectedProp, leadingVisual, title, tooltipContent, tooltipProps, trailingContent, onExpandedChange, onSelectedChange, actionMenuProps, className, style, htmlAttributes, ref, ...restProps }: CommonProps<"div", ItemProps>) => import("react/jsx-runtime").JSX.Element;
     SkeletonItem: ({ rows, className, style, htmlAttributes, ref, ...restProps }: CommonProps<"div", SkeletonItemProps>) => import("react/jsx-runtime").JSX.Element;
 };
 export { TreeView };

package/lib/types/next/tree-view/TreeView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../../../src/next/tree-view/TreeView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAgBH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAOhF,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIlC,KAAK,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAiE3C,KAAK,SAAS,GAAG;IACf,+GAA+G;IAC/G,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8GAA8G;IAC9G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,yDAAyD;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AA2MF,KAAK,SAAS,GAAG;IACf,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,+CAA+C;IAG/C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yHAAyH;IACzH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mCAAmC;IACnC,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,0FAA0F;IAC1F,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC,wHAAwH;IACxH,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC,uEAAuE;IACvE,eAAe,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,IAAI,CAAC,CAAC;IACpD,4FAA4F;IAC5F,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACjC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD,CAAC;AAoWF,KAAK,iBAAiB,GAAG;IACvB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AA0CF,QAAA,MAAM,QAAQ,iHArmBX,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC;wVAmQ7B,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC;kFAgV7B,WAAW,CAAC,KAAK,EAAE,iBAAiB,CAAC;CAkBoB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../../../src/next/tree-view/TreeView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAoBH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAShF,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGlC,OAAO,EAQL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AA8KrB,KAAK,SAAS,GAAG;IACf,+GAA+G;IAC/G,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8GAA8G;IAC9G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,wGAAwG;IACxG,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yDAAyD;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,wHAAwH;IACxH,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACvD,CAAC;AAoeF,KAAK,SAAS,GAAG;IACf,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,+CAA+C;IAG/C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yHAAyH;IACzH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uFAAuF;IACvF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8IAA8I;IAC9I,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mCAAmC;IACnC,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,0FAA0F;IAC1F,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC,wHAAwH;IACxH,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC,uEAAuE;IACvE,eAAe,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,IAAI,CAAC,CAAC;IACpD,4FAA4F;IAC5F,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACjC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,wJAAwJ;IACxJ,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD,CAAC;AAyZF,KAAK,iBAAiB,GAAG;IACvB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AA0CF;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,QAAQ,wLAl8BX,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC;oZA+hB7B,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC;kFAmY7B,WAAW,CAAC,KAAK,EAAE,iBAAiB,CAAC;CAgCoB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/lib/types/next/tree-view/selection.d.ts

@@ -0,0 +1,78 @@
+/**
+ *
+ *  Copyright (c) "Neo4j"
+ *  Neo4j Sweden AB [http://neo4j.com]
+ *
+ *  This file is part of Neo4j.
+ *
+ *  Neo4j is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+export type SelectionMode = 'single' | 'multiple' | 'multiple-replace';
+export type SelectionEdge = 'top' | 'middle' | 'bottom';
+/** Modifier keys resolved from a pointer or keyboard event. */
+export type SelectionIntent = {
+    /** Shift: extend from the anchor to the target. */
+    isRange: boolean;
+    /**
+     * Cmd on Apple platforms, Ctrl elsewhere. Ignored in `multiple`, where an
+     * unmodified click already toggles.
+     */
+    isToggle: boolean;
+};
+/**
+ * Where a range is measured from.
+ *
+ * `baseSelectedIds` is the selection as it stood immediately after the anchor
+ * was placed. A `multiple-replace` range unions its visible members with the
+ * range so it can be grown and shrunk without losing earlier picks.
+ * `isSelected` is the state the anchor row was placed into, which a `multiple`
+ * range paints across its members.
+ */
+export type SelectionAnchor = {
+    baseSelectedIds: ReadonlySet<string>;
+    id: string;
+    isSelected: boolean;
+} | null;
+type ComputeNextSelectionInput = {
+    anchor: SelectionAnchor;
+    intent: SelectionIntent;
+    /** Ids of every selectable, non-disabled item, visible or not. */
+    selectableIds: ReadonlySet<string>;
+    /** Currently selected ids, including items inside collapsed groups. */
+    selectedIds: ReadonlySet<string>;
+    selectionMode: SelectionMode;
+    targetId: string;
+    /** Ids of the items the user can currently see, in visual order. */
+    visibleIds: readonly string[];
+    /** Maps an item id to the id of the item that owns its group. */
+    parentIdById: ReadonlyMap<string, string>;
+};
+type ComputeNextSelectionResult = {
+    anchor: SelectionAnchor;
+    selectedIds: Set<string>;
+};
+/**
+ * Resolves a selection gesture into the complete next selection. Pure: the
+ * caller supplies the current state and applies the result.
+ */
+export declare function computeNextSelection({ anchor, intent, parentIdById, selectableIds, selectedIds, selectionMode, targetId, visibleIds, }: ComputeNextSelectionInput): ComputeNextSelectionResult;
+/**
+ * Marks each selected item's position within its run of adjacent selected
+ * items, so a run can be styled as one block.
+ */
+export declare function computeSelectionEdges(visibleIds: readonly string[], selectedIds: ReadonlySet<string>): Map<string, SelectionEdge>;
+export declare function countChangedIds(previous: ReadonlySet<string>, next: ReadonlySet<string>): number;
+export declare function formatSelectionAnnouncement(selectedCount: number): string;
+export {};
+//# sourceMappingURL=selection.d.ts.map

package/lib/types/next/tree-view/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../../src/next/tree-view/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG;IAC5B,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,IAAI,CAAC;AAET,KAAK,yBAAyB,GAAG;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,kEAAkE;IAClE,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,uEAAuE;IACvE,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iEAAiE;IACjE,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B,CAAC;AA2EF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,MAAM,EACN,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,QAAQ,EACR,UAAU,GACX,EAAE,yBAAyB,GAAG,0BAA0B,CAiExD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAC/B,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAmB5B;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,MAAM,CAaR;AAED,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAQzE"}

package/lib/types/next/tree-view/stories/index.d.ts

@@ -18,18 +18,24 @@
  *  You should have received a copy of the GNU General Public License
  *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
+export { default as TreeViewLarge } from './tree-view-large.story';
 export { default as TreeViewLazyLoading } from './tree-view-lazy.story';
 export { default as TreeViewMultiSelect } from './tree-view-multi.story';
+export { default as TreeViewMultipleReplace } from './tree-view-multiple-replace.story';
 export { default as TreeViewNonSelectableFolders } from './tree-view-non-selectable-folders.story';
+export { default as TreeViewRootSelection } from './tree-view-root-selection.story';
 export { default as TreeViewSingleSelect } from './tree-view-single.story';
 export { default as TreeViewWithActions } from './tree-view-actions.story';
 export { default as TreeViewUncontrolledExpansion } from './tree-view-uncontrolled.story';
 export { default as TreeViewWithTrailingContent } from './tree-view-trailing.story';
 export { default as TreeViewWithTooltip } from './tree-view-tooltip.story';
 export declare const TreeViewActionsSrc: string;
+export declare const TreeViewLargeSrc: string;
 export declare const TreeViewLazyLoadingSrc: string;
 export declare const TreeViewMultiSelectSrc: string;
+export declare const TreeViewMultipleReplaceSrc: string;
 export declare const TreeViewNonSelectableFoldersSrc: string;
+export declare const TreeViewRootSelectionSrc: string;
 export declare const TreeViewSingleSelectSrc: string;
 export declare const TreeViewTrailingContentSrc: string;
 export declare const TreeViewTooltipSrc: string;

package/lib/types/next/tree-view/stories/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACnG,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAY3E,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAC7E,eAAO,MAAM,sBAAsB,QAElC,CAAC;AACF,eAAO,MAAM,sBAAsB,QAElC,CAAC;AACF,eAAO,MAAM,+BAA+B,QAE3C,CAAC;AACF,eAAO,MAAM,uBAAuB,QAEnC,CAAC;AACF,eAAO,MAAM,0BAA0B,QAEtC,CAAC;AACF,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAC7E,eAAO,MAAM,gCAAgC,QAE5C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACnG,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAe3E,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAC7E,eAAO,MAAM,gBAAgB,QAA2C,CAAC;AACzE,eAAO,MAAM,sBAAsB,QAElC,CAAC;AACF,eAAO,MAAM,sBAAsB,QAElC,CAAC;AACF,eAAO,MAAM,0BAA0B,QAEtC,CAAC;AACF,eAAO,MAAM,+BAA+B,QAE3C,CAAC;AACF,eAAO,MAAM,wBAAwB,QAEpC,CAAC;AACF,eAAO,MAAM,uBAAuB,QAEnC,CAAC;AACF,eAAO,MAAM,0BAA0B,QAEtC,CAAC;AACF,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAC7E,eAAO,MAAM,gCAAgC,QAE5C,CAAC"}

package/lib/types/next/tree-view/stories/tree-view-large.story.d.ts

@@ -0,0 +1,24 @@
+/**
+ *
+ *  Copyright (c) "Neo4j"
+ *  Neo4j Sweden AB [http://neo4j.com]
+ *
+ *  This file is part of Neo4j.
+ *
+ *  Neo4j is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import '@neo4j-ndl/base/lib/neo4j-ds-styles.css';
+declare const Component: () => import("react/jsx-runtime").JSX.Element;
+export default Component;
+//# sourceMappingURL=tree-view-large.story.d.ts.map

package/lib/types/next/tree-view/stories/tree-view-large.story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-view-large.story.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/tree-view-large.story.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,yCAAyC,CAAC;AAqCjD,QAAA,MAAM,SAAS,+CAoCd,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/lib/types/next/tree-view/stories/tree-view-lazy.story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree-view-lazy.story.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/tree-view-lazy.story.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,yCAAyC,CAAC;AA0LjD,QAAA,MAAM,SAAS,+CAcd,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"tree-view-lazy.story.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/tree-view-lazy.story.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,yCAAyC,CAAC;AA+LjD,QAAA,MAAM,SAAS,+CAcd,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/lib/types/next/tree-view/stories/tree-view-multi.story.d.ts

@@ -19,6 +19,16 @@
  *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 import '@neo4j-ndl/base/lib/neo4j-ds-styles.css';
+/**
+ * Every row owns its own checkbox: `onSelectedChange` reports the state the row
+ * should end up in, and the story stores exactly that. Folders are ordinary
+ * selectable rows here, unrelated to what sits inside them.
+ *
+ * Deriving a folder's state from its children instead needs the tree to own the
+ * selection, since a Shift range moves several rows at once and a cascade has
+ * to be applied to the whole set in one pass. See the root-managed selection
+ * story for that.
+ */
 declare const Component: () => import("react/jsx-runtime").JSX.Element;
 export default Component;
 //# sourceMappingURL=tree-view-multi.story.d.ts.map

package/lib/types/next/tree-view/stories/tree-view-multi.story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree-view-multi.story.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/tree-view-multi.story.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,yCAAyC,CAAC;AAmCjD,QAAA,MAAM,SAAS,+CAsGd,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"tree-view-multi.story.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/tree-view-multi.story.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,yCAAyC,CAAC;AAUjD;;;;;;;;;GASG;AACH,QAAA,MAAM,SAAS,+CAsFd,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/lib/types/next/tree-view/stories/tree-view-multiple-replace.story.d.ts

@@ -0,0 +1,29 @@
+/**
+ *
+ *  Copyright (c) "Neo4j"
+ *  Neo4j Sweden AB [http://neo4j.com]
+ *
+ *  This file is part of Neo4j.
+ *
+ *  Neo4j is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import '@neo4j-ndl/base/lib/neo4j-ds-styles.css';
+/**
+ * Letting the tree own the selection keeps the items declarative: they carry an
+ * `id` and nothing else, and a Shift range that moves several rows at once
+ * arrives as a single `onSelectedIdsChange`.
+ */
+declare const Component: () => import("react/jsx-runtime").JSX.Element;
+export default Component;
+//# sourceMappingURL=tree-view-multiple-replace.story.d.ts.map

package/lib/types/next/tree-view/stories/tree-view-multiple-replace.story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-view-multiple-replace.story.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/tree-view-multiple-replace.story.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,yCAAyC,CAAC;AAUjD;;;;GAIG;AACH,QAAA,MAAM,SAAS,+CA6Dd,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/lib/types/next/tree-view/stories/tree-view-non-selectable-folders.story.d.ts

@@ -19,6 +19,11 @@
  *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 import '@neo4j-ndl/base/lib/neo4j-ds-styles.css';
+/**
+ * Folders here are pure containers: `isSelectable={false}` makes them expand on
+ * click without ever becoming part of the selection, and screen readers
+ * announce them as non-selectable rather than as unselected rows.
+ */
 declare const Component: () => import("react/jsx-runtime").JSX.Element;
 export default Component;
 //# sourceMappingURL=tree-view-non-selectable-folders.story.d.ts.map

package/lib/types/next/tree-view/stories/tree-view-non-selectable-folders.story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree-view-non-selectable-folders.story.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/tree-view-non-selectable-folders.story.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,yCAAyC,CAAC;AAMjD,QAAA,MAAM,SAAS,+CAiEd,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"tree-view-non-selectable-folders.story.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/tree-view-non-selectable-folders.story.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,yCAAyC,CAAC;AAMjD;;;;GAIG;AACH,QAAA,MAAM,SAAS,+CA4Dd,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/lib/types/next/tree-view/stories/tree-view-root-selection.story.d.ts

@@ -0,0 +1,24 @@
+/**
+ *
+ *  Copyright (c) "Neo4j"
+ *  Neo4j Sweden AB [http://neo4j.com]
+ *
+ *  This file is part of Neo4j.
+ *
+ *  Neo4j is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+import '@neo4j-ndl/base/lib/neo4j-ds-styles.css';
+declare const Component: () => import("react/jsx-runtime").JSX.Element;
+export default Component;
+//# sourceMappingURL=tree-view-root-selection.story.d.ts.map

package/lib/types/next/tree-view/stories/tree-view-root-selection.story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-view-root-selection.story.d.ts","sourceRoot":"","sources":["../../../../../src/next/tree-view/stories/tree-view-root-selection.story.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,yCAAyC,CAAC;AAqEjD,QAAA,MAAM,SAAS,+CAuEd,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neo4j-ndl/react",
-  "version": "4.21.2",
+  "version": "4.22.0",
   "sideEffects": false,
   "description": "React implementation of Neo4j Design System",
   "keywords": [
@@ -404,7 +404,7 @@
     "@tanstack/react-table": "8.21.3",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
-    "@neo4j-ndl/base": "^4.20.2"
+    "@neo4j-ndl/base": "^4.21.0"
   },
   "dependencies": {
     "@dnd-kit/core": "6.3.1",

package/skills/ndl-react/SKILL.md

@@ -198,7 +198,7 @@ Next-generation components, imported from the `@neo4j-ndl/react/next` subpath. A
 
 | Component | Docs | Accessibility | Examples |
 |-----------|------|---------------|----------|
-| `TreeView` | [components/next/tree-view.md](components/next/tree-view.md) | ✅ | 8 |
+| `TreeView` | [components/next/tree-view.md](components/next/tree-view.md) | ✅ | 10 |
 
 ## AI components