@djangocfg/ui-tools 2.1.316 → 2.1.318

package/dist/index.d.cts

@@ -8,10 +8,11 @@ export { Language } from 'prism-react-renderer';
 import { RJSFSchema, UiSchema, WidgetProps, FieldTemplateProps, ObjectFieldTemplateProps, ArrayFieldTemplateProps, ArrayFieldItemTemplateProps, ErrorListProps } from '@rjsf/utils';
 import { FormProps, IChangeEvent } from '@rjsf/core';
 import { CommonExternalProps } from 'react-json-tree';
-import { TreeRootProps } from './tree/index.cjs';
-export { ChildCache, ChildEntry, ChildEntryStatus, DEFAULT_TREE_APPEARANCE, DEFAULT_TREE_LABELS, DemoNode, FlatRow, FlattenInput, PersistedTreeState, ResolvedAppearance, TreeRoot as Tree, TreeAccentIntensity, TreeAppearance, TreeChevron, TreeChevronProps, TreeContent, TreeContentProps, TreeContextMenuSlot, TreeContextValue, TreeDensity, TreeEmpty, TreeEmptyProps, TreeError, TreeErrorProps, TreeIcon, TreeIconProps, TreeIndentGuides, TreeIndentGuidesProps, TreeItemId, TreeLabel, TreeLabelProps, TreeLabels, TreeLoadChildren, TreeNode, TreeProvider, TreeProviderProps, TreeRadius, TreeRoot, TreeRow, TreeRowProps, TreeRowRenderProps, TreeRowSlot, TreeSearchInput, TreeSearchInputProps, TreeSelectionMode, TreeSkeleton, TreeSkeletonProps, UseTreeKeyboardOptions, UseTreeTypeAheadOptions, appearanceToStyle, clearTreeState, createChildCache, createDemoTree, flattenTree, loadTreeState, resolveAppearance, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead } from './tree/index.cjs';
+import { b as TreeRootProps } from './types-CevSbyfD.cjs';
+export { c as DEFAULT_TREE_APPEARANCE, D as DEFAULT_TREE_LABELS, F as FlatRow, R as ResolvedAppearance, m as TreeAccentIntensity, k as TreeAppearance, e as TreeContextMenuSlot, l as TreeDensity, f as TreeItemId, g as TreeLabels, j as TreeLoadChildren, T as TreeNode, n as TreeRadius, i as TreeRowRenderProps, a as TreeRowSlot, h as TreeSelectionMode, d as appearanceToStyle, r as resolveAppearance } from './types-CevSbyfD.cjs';
 import { MediaPlayerInstance } from '@vidstack/react';
 import * as monaco from 'monaco-editor';
+export { ChildCache, ChildEntry, ChildEntryStatus, DemoNode, FlattenInput, PersistedTreeState, TreeRoot as Tree, TreeChevron, TreeChevronProps, TreeContent, TreeContentProps, TreeContextValue, TreeEmpty, TreeEmptyProps, TreeError, TreeErrorProps, TreeIcon, TreeIconProps, TreeIndentGuides, TreeIndentGuidesProps, TreeLabel, TreeLabelProps, TreeProvider, TreeProviderProps, TreeRoot, TreeRow, TreeRowProps, TreeSearchInput, TreeSearchInputProps, TreeSkeleton, TreeSkeletonProps, UseTreeKeyboardOptions, UseTreeTypeAheadOptions, clearTreeState, createChildCache, createDemoTree, flattenTree, loadTreeState, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead } from './tree/index.cjs';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
 

package/dist/index.d.ts

@@ -8,10 +8,11 @@ export { Language } from 'prism-react-renderer';
 import { RJSFSchema, UiSchema, WidgetProps, FieldTemplateProps, ObjectFieldTemplateProps, ArrayFieldTemplateProps, ArrayFieldItemTemplateProps, ErrorListProps } from '@rjsf/utils';
 import { FormProps, IChangeEvent } from '@rjsf/core';
 import { CommonExternalProps } from 'react-json-tree';
-import { TreeRootProps } from './tree/index.js';
-export { ChildCache, ChildEntry, ChildEntryStatus, DEFAULT_TREE_APPEARANCE, DEFAULT_TREE_LABELS, DemoNode, FlatRow, FlattenInput, PersistedTreeState, ResolvedAppearance, TreeRoot as Tree, TreeAccentIntensity, TreeAppearance, TreeChevron, TreeChevronProps, TreeContent, TreeContentProps, TreeContextMenuSlot, TreeContextValue, TreeDensity, TreeEmpty, TreeEmptyProps, TreeError, TreeErrorProps, TreeIcon, TreeIconProps, TreeIndentGuides, TreeIndentGuidesProps, TreeItemId, TreeLabel, TreeLabelProps, TreeLabels, TreeLoadChildren, TreeNode, TreeProvider, TreeProviderProps, TreeRadius, TreeRoot, TreeRow, TreeRowProps, TreeRowRenderProps, TreeRowSlot, TreeSearchInput, TreeSearchInputProps, TreeSelectionMode, TreeSkeleton, TreeSkeletonProps, UseTreeKeyboardOptions, UseTreeTypeAheadOptions, appearanceToStyle, clearTreeState, createChildCache, createDemoTree, flattenTree, loadTreeState, resolveAppearance, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead } from './tree/index.js';
+import { b as TreeRootProps } from './types-CevSbyfD.js';
+export { c as DEFAULT_TREE_APPEARANCE, D as DEFAULT_TREE_LABELS, F as FlatRow, R as ResolvedAppearance, m as TreeAccentIntensity, k as TreeAppearance, e as TreeContextMenuSlot, l as TreeDensity, f as TreeItemId, g as TreeLabels, j as TreeLoadChildren, T as TreeNode, n as TreeRadius, i as TreeRowRenderProps, a as TreeRowSlot, h as TreeSelectionMode, d as appearanceToStyle, r as resolveAppearance } from './types-CevSbyfD.js';
 import { MediaPlayerInstance } from '@vidstack/react';
 import * as monaco from 'monaco-editor';
+export { ChildCache, ChildEntry, ChildEntryStatus, DemoNode, FlattenInput, PersistedTreeState, TreeRoot as Tree, TreeChevron, TreeChevronProps, TreeContent, TreeContentProps, TreeContextValue, TreeEmpty, TreeEmptyProps, TreeError, TreeErrorProps, TreeIcon, TreeIconProps, TreeIndentGuides, TreeIndentGuidesProps, TreeLabel, TreeLabelProps, TreeProvider, TreeProviderProps, TreeRoot, TreeRow, TreeRowProps, TreeSearchInput, TreeSearchInputProps, TreeSkeleton, TreeSkeletonProps, UseTreeKeyboardOptions, UseTreeTypeAheadOptions, clearTreeState, createChildCache, createDemoTree, flattenTree, loadTreeState, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead } from './tree/index.js';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
 

package/dist/index.mjs

@@ -1,3 +1,4 @@
+export { ArrayFieldItemTemplate, ArrayFieldTemplate, BaseInputTemplate, CheckboxWidget, ColorWidget, ErrorListTemplate, FieldTemplate, JsonSchemaForm, NumberWidget, ObjectFieldTemplate, SelectWidget, SliderWidget, SwitchWidget, TextWidget, getRequiredFields, hasRequiredFields, mergeDefaults, normalizeFormData, safeJsonParse, safeJsonStringify, validateRequiredFields, validateSchema } from './chunk-JUGQNNDC.mjs';
 export { useLottie } from './chunk-6JTB2X72.mjs';
 export { Player as AudioPlayer } from './chunk-FX2QFYWF.mjs';
 export { NativeProvider, StreamProvider, VideoControls, VideoErrorFallback, VideoPlayer, VideoPlayerProvider, VidstackProvider, createVideoErrorFallback, isSimpleStreamSource, resolveFileSource, resolvePlayerMode, resolveStreamSource, useVideoPlayerContext } from './chunk-EUADAUBQ.mjs';
@@ -5,12 +6,11 @@ export { ImageViewer } from './chunk-GGKGH5PM.mjs';
 export { generateContentKey, useAudioCache, useBlobUrlCleanup, useImageCache, useMediaCacheStore, useVideoCache, useVideoPlayerSettings } from './chunk-5LBDYFWH.mjs';
 export { CronSchedulerProvider, CustomInput, DayChips, MonthDayGrid, SchedulePreview, ScheduleTypeSelector, TimeSelector, buildCron, humanizeCron, isValidCron, parseCron, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays } from './chunk-PZKAH7WQ.mjs';
 export { TreeError, TreeSkeleton, createDemoTree } from './chunk-KR6B3LVY.mjs';
-export { DEFAULT_TREE_APPEARANCE, DEFAULT_TREE_LABELS, TreeRoot as Tree, TreeChevron, TreeContent, TreeEmpty, TreeIcon, TreeIndentGuides, TreeLabel, TreeProvider, TreeRoot, TreeRow, TreeSearchInput, appearanceToStyle, clearTreeState, createChildCache, flattenTree, loadTreeState, resolveAppearance, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead } from './chunk-NFIMVYJU.mjs';
+export { DEFAULT_TREE_APPEARANCE, DEFAULT_TREE_LABELS, TreeRoot as Tree, TreeChevron, TreeContent, TreeEmpty, TreeIcon, TreeIndentGuides, TreeLabel, TreeProvider, TreeRoot, TreeRow, TreeSearchInput, appearanceToStyle, clearTreeState, createChildCache, flattenTree, loadTreeState, resolveAppearance, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead } from './chunk-MOME6KYD.mjs';
 import { PlaygroundProvider } from './chunk-GBLQTHWT.mjs';
 export { MarkdownMessage, Mermaid_default as Mermaid, PrettyCode_default as PrettyCode, extractTextFromChildren, useCollapsibleContent } from './chunk-GBLQTHWT.mjs';
 export { JsonTree_default as JsonTree } from './chunk-LFWQ36LJ.mjs';
 import './chunk-SSUOENAZ.mjs';
-export { ArrayFieldItemTemplate, ArrayFieldTemplate, BaseInputTemplate, CheckboxWidget, ColorWidget, ErrorListTemplate, FieldTemplate, JsonSchemaForm, NumberWidget, ObjectFieldTemplate, SelectWidget, SliderWidget, SwitchWidget, TextWidget, getRequiredFields, hasRequiredFields, mergeDefaults, normalizeFormData, safeJsonParse, safeJsonStringify, validateRequiredFields, validateSchema } from './chunk-JUGQNNDC.mjs';
 import { __name } from './chunk-CGILA3WO.mjs';
 import * as React from 'react';
 import { lazy, forwardRef, useRef, useState, useCallback, useImperativeHandle, useEffect, createContext, Suspense, useContext, useMemo } from 'react';
@@ -338,7 +338,7 @@ var LazyCronScheduler = createLazyComponent(
   }
 );
 var LazyTree = createLazyComponent(
-  () => import('./TreeRoot-HBRJEHBH.mjs'),
+  () => import('./TreeRoot-A3J65L6F.mjs'),
   {
     displayName: "LazyTree",
     fallback: /* @__PURE__ */ jsx(LoadingFallback, { minHeight: 200, text: "Loading tree\u2026" })

package/dist/tree/index.cjs

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var chunkYXBOAGIM_cjs = require('../chunk-YXBOAGIM.cjs');
-var chunk4CEOJDMB_cjs = require('../chunk-4CEOJDMB.cjs');
+var chunk3Z3A7FHA_cjs = require('../chunk-3Z3A7FHA.cjs');
 require('../chunk-WGEGR3DF.cjs');
 
 
@@ -22,131 +22,131 @@ Object.defineProperty(exports, "createDemoTree", {
 });
 Object.defineProperty(exports, "DEFAULT_TREE_APPEARANCE", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.DEFAULT_TREE_APPEARANCE; }
+  get: function () { return chunk3Z3A7FHA_cjs.DEFAULT_TREE_APPEARANCE; }
 });
 Object.defineProperty(exports, "DEFAULT_TREE_LABELS", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.DEFAULT_TREE_LABELS; }
+  get: function () { return chunk3Z3A7FHA_cjs.DEFAULT_TREE_LABELS; }
 });
 Object.defineProperty(exports, "Tree", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeRoot; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeRoot; }
 });
 Object.defineProperty(exports, "TreeChevron", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeChevron; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeChevron; }
 });
 Object.defineProperty(exports, "TreeContent", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeContent; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeContent; }
 });
 Object.defineProperty(exports, "TreeEmpty", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeEmpty; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeEmpty; }
 });
 Object.defineProperty(exports, "TreeIcon", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeIcon; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeIcon; }
 });
 Object.defineProperty(exports, "TreeIndentGuides", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeIndentGuides; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeIndentGuides; }
 });
 Object.defineProperty(exports, "TreeLabel", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeLabel; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeLabel; }
 });
 Object.defineProperty(exports, "TreeProvider", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeProvider; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeProvider; }
 });
 Object.defineProperty(exports, "TreeRoot", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeRoot; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeRoot; }
 });
 Object.defineProperty(exports, "TreeRow", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeRow; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeRow; }
 });
 Object.defineProperty(exports, "TreeSearchInput", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeSearchInput; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeSearchInput; }
 });
 Object.defineProperty(exports, "appearanceToStyle", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.appearanceToStyle; }
+  get: function () { return chunk3Z3A7FHA_cjs.appearanceToStyle; }
 });
 Object.defineProperty(exports, "clearTreeState", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.clearTreeState; }
+  get: function () { return chunk3Z3A7FHA_cjs.clearTreeState; }
 });
 Object.defineProperty(exports, "createChildCache", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.createChildCache; }
+  get: function () { return chunk3Z3A7FHA_cjs.createChildCache; }
 });
 Object.defineProperty(exports, "default", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.TreeRoot_default; }
+  get: function () { return chunk3Z3A7FHA_cjs.TreeRoot_default; }
 });
 Object.defineProperty(exports, "flattenTree", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.flattenTree; }
+  get: function () { return chunk3Z3A7FHA_cjs.flattenTree; }
 });
 Object.defineProperty(exports, "loadTreeState", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.loadTreeState; }
+  get: function () { return chunk3Z3A7FHA_cjs.loadTreeState; }
 });
 Object.defineProperty(exports, "resolveAppearance", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.resolveAppearance; }
+  get: function () { return chunk3Z3A7FHA_cjs.resolveAppearance; }
 });
 Object.defineProperty(exports, "resolveChildren", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.resolveChildren; }
+  get: function () { return chunk3Z3A7FHA_cjs.resolveChildren; }
 });
 Object.defineProperty(exports, "saveTreeState", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.saveTreeState; }
+  get: function () { return chunk3Z3A7FHA_cjs.saveTreeState; }
 });
 Object.defineProperty(exports, "useTreeActions", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.useTreeActions; }
+  get: function () { return chunk3Z3A7FHA_cjs.useTreeActions; }
 });
 Object.defineProperty(exports, "useTreeContext", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.useTreeContext; }
+  get: function () { return chunk3Z3A7FHA_cjs.useTreeContext; }
 });
 Object.defineProperty(exports, "useTreeExpansion", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.useTreeExpansion; }
+  get: function () { return chunk3Z3A7FHA_cjs.useTreeExpansion; }
 });
 Object.defineProperty(exports, "useTreeFocus", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.useTreeFocus; }
+  get: function () { return chunk3Z3A7FHA_cjs.useTreeFocus; }
 });
 Object.defineProperty(exports, "useTreeKeyboard", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.useTreeKeyboard; }
+  get: function () { return chunk3Z3A7FHA_cjs.useTreeKeyboard; }
 });
 Object.defineProperty(exports, "useTreeLabels", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.useTreeLabels; }
+  get: function () { return chunk3Z3A7FHA_cjs.useTreeLabels; }
 });
 Object.defineProperty(exports, "useTreeRows", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.useTreeRows; }
+  get: function () { return chunk3Z3A7FHA_cjs.useTreeRows; }
 });
 Object.defineProperty(exports, "useTreeSearch", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.useTreeSearch; }
+  get: function () { return chunk3Z3A7FHA_cjs.useTreeSearch; }
 });
 Object.defineProperty(exports, "useTreeSelection", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.useTreeSelection; }
+  get: function () { return chunk3Z3A7FHA_cjs.useTreeSelection; }
 });
 Object.defineProperty(exports, "useTreeTypeAhead", {
   enumerable: true,
-  get: function () { return chunk4CEOJDMB_cjs.useTreeTypeAhead; }
+  get: function () { return chunk3Z3A7FHA_cjs.useTreeTypeAhead; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/tree/index.d.cts

@@ -1,172 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { b as TreeRootProps, f as TreeItemId, T as TreeNode, F as FlatRow, o as TreeActivateOptions, g as TreeLabels, R as ResolvedAppearance, h as TreeSelectionMode, p as TreeActivationMode, a as TreeRowSlot, e as TreeContextMenuSlot } from '../types-CevSbyfD.cjs';
+export { c as DEFAULT_TREE_APPEARANCE, D as DEFAULT_TREE_LABELS, m as TreeAccentIntensity, k as TreeAppearance, l as TreeDensity, j as TreeLoadChildren, n as TreeRadius, i as TreeRowRenderProps, d as appearanceToStyle, r as resolveAppearance } from '../types-CevSbyfD.cjs';
 import * as React$1 from 'react';
-import { CSSProperties, ReactNode } from 'react';
-
-type TreeDensity = 'compact' | 'cozy' | 'comfortable';
-type TreeAccentIntensity = 'subtle' | 'default' | 'strong';
-type TreeRadius = 'none' | 'sm' | 'md';
-/**
- * Cosmetic configuration. Every field is optional; missing values fall
- * back to the `cozy` preset (a comfortable VSCode-Explorer-like density).
- *
- * Customize the look without re-implementing slots.
- */
-interface TreeAppearance {
-    /** Built-in size preset. Default: `'cozy'`. */
-    density?: TreeDensity;
-    /** Override row height in px (wins over density). */
-    rowHeight?: number;
-    /** Override icon + chevron size in px (wins over density). */
-    iconSize?: number;
-    /** Lucide stroke width for icon + chevron. Default: 1.5. */
-    iconStrokeWidth?: number;
-    /** Override label font size in px (wins over density). */
-    fontSize?: number;
-    /** Pixels between chevron / icon / label. Default depends on density. */
-    gap?: number;
-    /** Pixels between nesting levels. Default: 16. */
-    indent?: number;
-    /** Hover / selected highlight intensity. Default: `'default'`. */
-    accent?: TreeAccentIntensity;
-    /** Row corner radius. Default: `'sm'`. */
-    radius?: TreeRadius;
-    /** Indent-guide line opacity (0..1). Default: 0.4. */
-    indentGuideOpacity?: number;
-    /**
-     * Show a 2px primary-tinted bar on the left of the selected row.
-     * Mimics the VSCode active-tab indicator. Default: `true`.
-     */
-    showActiveIndicator?: boolean;
-}
-interface ResolvedAppearance {
-    density: TreeDensity;
-    rowHeight: number;
-    iconSize: number;
-    iconStrokeWidth: number;
-    fontSize: number;
-    gap: number;
-    indent: number;
-    accent: TreeAccentIntensity;
-    radius: TreeRadius;
-    indentGuideOpacity: number;
-    showActiveIndicator: boolean;
-}
-declare const DEFAULT_TREE_APPEARANCE: ResolvedAppearance;
-/**
- * Merge a partial appearance with the default + density preset.
- *
- * Explicit numeric overrides (e.g. `rowHeight`) win over the density preset.
- */
-declare function resolveAppearance(input?: TreeAppearance, 
-/** Outer `indent` prop (kept on TreeRoot for back-compat). */
-outerIndent?: number): ResolvedAppearance;
-/**
- * Build the `style` object that exposes the resolved appearance to any
- * descendant via CSS variables. Set on `<TreeRoot>`'s outer div.
- */
-declare function appearanceToStyle(a: ResolvedAppearance): CSSProperties;
-
-type TreeItemId = string;
-/** A single node in the consumer's tree data. Generic over your payload. */
-interface TreeNode<T = unknown> {
-    id: TreeItemId;
-    data: T;
-    /** Inline children. Omit (and provide a `loadChildren`) for async loading. */
-    children?: TreeNode<T>[];
-    /**
-     * Set to `true` to mark a node as a folder even when its `children` array
-     * is empty (e.g. an unloaded async folder). Default: derived from
-     * `Array.isArray(children)`.
-     */
-    isFolder?: boolean;
-    /** Disable interaction. */
-    disabled?: boolean;
-}
-interface TreeLabels {
-    loading: string;
-    empty: string;
-    error: string;
-    searchPlaceholder: string;
-    searchMatches: (count: number) => string;
-    ariaLabel: string;
-}
-declare const DEFAULT_TREE_LABELS: TreeLabels;
-type TreeSelectionMode = 'none' | 'single' | 'multiple';
-/**
- * Async loader: called the first time a folder is expanded with no inline
- * `children`. Result is cached; concurrent expansions are de-duplicated.
- */
-type TreeLoadChildren<T> = (node: TreeNode<T>) => Promise<TreeNode<T>[]>;
-interface TreeRowRenderProps<T> {
-    node: TreeNode<T>;
-    level: number;
-    isSelected: boolean;
-    isExpanded: boolean;
-    isFocused: boolean;
-    isFolder: boolean;
-    isLoading: boolean;
-    isMatchingSearch: boolean;
-}
-type TreeRowSlot<T> = (props: TreeRowRenderProps<T>) => ReactNode;
-type TreeContextMenuSlot<T> = (props: TreeRowRenderProps<T>, trigger: ReactNode) => ReactNode;
-interface TreeRootProps<T> {
-    /** Root nodes. Top-level items are rendered directly (no synthetic root). */
-    data: TreeNode<T>[];
-    /** Returns the human-readable name for a node (used by search/type-ahead). */
-    getItemName: (node: TreeNode<T>) => string;
-    /** Async loader for folders without inline `children`. */
-    loadChildren?: TreeLoadChildren<T>;
-    /** Selection behaviour. Default: `'single'`. */
-    selectionMode?: TreeSelectionMode;
-    /** Initially expanded ids. */
-    initialExpandedIds?: TreeItemId[];
-    /** Initially selected ids. */
-    initialSelectedIds?: TreeItemId[];
-    /** Pixels of indent per nesting level. Default: 16. (Shortcut for `appearance.indent`.) */
-    indent?: number;
-    /** Cosmetic configuration: density, sizes, accent intensity, radius. */
-    appearance?: TreeAppearance;
-    /** Triggered when selection changes. */
-    onSelectionChange?: (selectedIds: TreeItemId[]) => void;
-    /** Triggered when expanded set changes. */
-    onExpansionChange?: (expandedIds: TreeItemId[]) => void;
-    /** Enter / dblclick on a node. */
-    onActivate?: (node: TreeNode<T>) => void;
-    /** Show built-in search input. Default: false. */
-    enableSearch?: boolean;
-    /** Type printable letters to jump to a matching name. Default: true. */
-    enableTypeAhead?: boolean;
-    /** Render vertical indent guides under expanded folders. Default: false. */
-    showIndentGuides?: boolean;
-    /** Custom row renderer. Falls back to the default <TreeRow />. */
-    renderRow?: TreeRowSlot<T>;
-    /** Replace default folder/file icon. */
-    renderIcon?: TreeRowSlot<T>;
-    /** Replace default label rendering. */
-    renderLabel?: TreeRowSlot<T>;
-    /** Right-side actions slot (per row). */
-    renderActions?: TreeRowSlot<T>;
-    /** Wrap each row in a context menu (right-click). Receives the row meta + trigger element. */
-    renderContextMenu?: TreeContextMenuSlot<T>;
-    /** Override built-in copy in your locale. */
-    labels?: Partial<TreeLabels>;
-    /** Persist expanded + (optional) selected ids in localStorage under this key. */
-    persistKey?: string;
-    /** Persist selection alongside expansion. Default: false. */
-    persistSelection?: boolean;
-    className?: string;
-    style?: React.CSSProperties;
-}
-/** Internal flat-row representation used by the renderer + keyboard nav. */
-interface FlatRow<T> {
-    node: TreeNode<T>;
-    level: number;
-    parentId: TreeItemId | null;
-    isFolder: boolean;
-    isExpanded: boolean;
-    isLoading: boolean;
-    hasError: boolean;
-}
 
 /**
  * High-level entry point. Wraps Provider + (optional) search bar + content.
@@ -218,13 +53,14 @@ interface TreeContextValue<T> {
     setQuery: (q: string) => void;
     refresh: (id: TreeItemId) => Promise<void>;
     refreshAll: () => Promise<void>;
-    activate: (node: TreeNode<T>) => void;
+    activate: (node: TreeNode<T>, opts?: TreeActivateOptions) => void;
     labels: TreeLabels;
     /** Resolved cosmetic config — never null. */
     appearance: ResolvedAppearance;
     /** Convenience alias for `appearance.indent`. */
     indent: number;
     selectionMode: TreeSelectionMode;
+    activationMode: TreeActivationMode;
     enableSearch: boolean;
     showIndentGuides: boolean;
     getItemName: (node: TreeNode<T>) => string;
@@ -234,7 +70,7 @@ interface TreeContextValue<T> {
     renderContextMenu?: TreeContextMenuSlot<T>;
 }
 declare function useTreeContext<T>(): TreeContextValue<T>;
-interface TreeProviderProps<T> extends Pick<TreeRootProps<T>, 'data' | 'getItemName' | 'loadChildren' | 'selectionMode' | 'initialExpandedIds' | 'initialSelectedIds' | 'indent' | 'appearance' | 'onSelectionChange' | 'onExpansionChange' | 'onActivate' | 'enableSearch' | 'showIndentGuides' | 'renderIcon' | 'renderLabel' | 'renderActions' | 'renderContextMenu' | 'labels' | 'persistKey' | 'persistSelection'> {
+interface TreeProviderProps<T> extends Pick<TreeRootProps<T>, 'data' | 'getItemName' | 'loadChildren' | 'selectionMode' | 'activationMode' | 'initialExpandedIds' | 'initialSelectedIds' | 'indent' | 'appearance' | 'onSelectionChange' | 'onExpansionChange' | 'onActivate' | 'filterNode' | 'enableSearch' | 'showIndentGuides' | 'renderIcon' | 'renderLabel' | 'renderActions' | 'renderContextMenu' | 'labels' | 'persistKey' | 'persistSelection'> {
     children: React$1.ReactNode;
 }
 declare function TreeProvider<T>(props: TreeProviderProps<T>): react_jsx_runtime.JSX.Element;
@@ -276,7 +112,7 @@ declare function useTreeActions<T>(): {
     collapseAll: () => void;
     refresh: (id: TreeItemId) => Promise<void>;
     refreshAll: () => Promise<void>;
-    activate: (node: TreeNode<T>) => void;
+    activate: (node: TreeNode<T>, opts?: TreeActivateOptions) => void;
 };
 
 interface UseTreeTypeAheadOptions<T> {
@@ -405,6 +241,8 @@ interface FlattenInput<T> {
     roots: TreeNode<T>[];
     expandedIds: ReadonlySet<TreeItemId>;
     cache: ChildCache<T>;
+    /** Optional predicate. Nodes returning `false` (and their descendants) are excluded. */
+    filterNode?: (node: TreeNode<T>) => boolean;
 }
 /**
  * Walk the tree top-to-bottom and produce a flat list of visible rows.
@@ -413,7 +251,7 @@ interface FlattenInput<T> {
  * `expandedIds`. The output is ordered exactly as it should render,
  * which keeps keyboard navigation (next/prev row) trivial.
  */
-declare function flattenTree<T>({ roots, expandedIds, cache }: FlattenInput<T>): FlatRow<T>[];
+declare function flattenTree<T>({ roots, expandedIds, cache, filterNode, }: FlattenInput<T>): FlatRow<T>[];
 
 interface PersistedTreeState {
     expandedItems: TreeItemId[];
@@ -439,4 +277,4 @@ declare function createDemoTree({ depth, breadth, rootPrefix, }?: {
     rootPrefix?: string;
 }): TreeNode<DemoNode>[];
 
-export { type ChildCache, type ChildEntry, type ChildEntryStatus, DEFAULT_TREE_APPEARANCE, DEFAULT_TREE_LABELS, type DemoNode, type FlatRow, type FlattenInput, type PersistedTreeState, type ResolvedAppearance, TreeRoot as Tree, type TreeAccentIntensity, type TreeAppearance, TreeChevron, type TreeChevronProps, TreeContent, type TreeContentProps, type TreeContextMenuSlot, type TreeContextValue, type TreeDensity, TreeEmpty, type TreeEmptyProps, TreeError, type TreeErrorProps, TreeIcon, type TreeIconProps, TreeIndentGuides, type TreeIndentGuidesProps, type TreeItemId, TreeLabel, type TreeLabelProps, type TreeLabels, type TreeLoadChildren, type TreeNode, TreeProvider, type TreeProviderProps, type TreeRadius, TreeRoot, type TreeRootProps, TreeRow, type TreeRowProps, type TreeRowRenderProps, type TreeRowSlot, TreeSearchInput, type TreeSearchInputProps, type TreeSelectionMode, TreeSkeleton, type TreeSkeletonProps, type UseTreeKeyboardOptions, type UseTreeTypeAheadOptions, appearanceToStyle, clearTreeState, createChildCache, createDemoTree, TreeRoot as default, flattenTree, loadTreeState, resolveAppearance, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead };
+export { type ChildCache, type ChildEntry, type ChildEntryStatus, type DemoNode, FlatRow, type FlattenInput, type PersistedTreeState, ResolvedAppearance, TreeRoot as Tree, TreeActivateOptions, TreeActivationMode, TreeChevron, type TreeChevronProps, TreeContent, type TreeContentProps, TreeContextMenuSlot, type TreeContextValue, TreeEmpty, type TreeEmptyProps, TreeError, type TreeErrorProps, TreeIcon, type TreeIconProps, TreeIndentGuides, type TreeIndentGuidesProps, TreeItemId, TreeLabel, type TreeLabelProps, TreeLabels, TreeNode, TreeProvider, type TreeProviderProps, TreeRoot, TreeRootProps, TreeRow, type TreeRowProps, TreeRowSlot, TreeSearchInput, type TreeSearchInputProps, TreeSelectionMode, TreeSkeleton, type TreeSkeletonProps, type UseTreeKeyboardOptions, type UseTreeTypeAheadOptions, clearTreeState, createChildCache, createDemoTree, TreeRoot as default, flattenTree, loadTreeState, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead };