@keenmate/svelte-treeview 4.4.0 → 4.5.0

package/dist/components/Tree.svelte.d.ts

@@ -1,6 +1,8 @@
 import type { Index, SearchOptions } from 'flexsearch';
 import { type LTreeNode } from '../ltree/ltree-node.svelte.js';
-import { type InsertArrayResult, type ContextMenuItem } from '../ltree/types.js';
+import { type InsertArrayResult, type ContextMenuItem, type DropPosition, type DragDropMode, type DropOperation } from '../ltree/types.js';
+import { type RenderStats } from './RenderCoordinator.svelte.js';
+import '../global-api.js';
 declare function $$render<T>(): {
     props: {
         idMember: string;
@@ -17,6 +19,7 @@ declare function $$render<T>(): {
         getDisplayValueCallback?: (node: LTreeNode<T>) => string;
         searchValueMember?: string | null | undefined;
         getSearchValueCallback?: (node: LTreeNode<T>) => string;
+        orderMember?: string | null | undefined;
         treeId?: string | null | undefined;
         treePathSeparator?: string | null | undefined;
         sortCallback?: (items: LTreeNode<T>[]) => LTreeNode<T>[];
@@ -29,6 +32,8 @@ declare function $$render<T>(): {
         treeFooter?: any;
         noDataFound?: any;
         contextMenu?: any;
+        dropPlaceholder?: any;
+        loadingPlaceholder?: any;
         expandLevel?: number | null | undefined;
         shouldToggleOnNodeClick?: boolean | null | undefined;
         initializeIndexCallback?: () => Index;
@@ -38,10 +43,33 @@ declare function $$render<T>(): {
         indexerTimeout?: number | null | undefined;
         shouldDisplayDebugInformation?: boolean;
         shouldDisplayContextMenuInDebugMode?: boolean;
+        isLoading?: boolean;
+        progressiveRender?: boolean;
+        renderBatchSize?: number;
+        isRendering?: boolean;
+        onRenderStart?: () => void;
+        onRenderProgress?: (stats: RenderStats) => void;
+        onRenderComplete?: (stats: RenderStats) => void;
+        dragDropMode?: DragDropMode;
+        dropZoneMode?: "floating" | "glow";
+        dropZoneLayout?: "around" | "above" | "below" | "wave" | "wave2";
+        dropZoneStart?: number | string;
+        dropZoneMaxWidth?: number;
+        allowCopy?: boolean;
+        autoHandleCopy?: boolean;
         onNodeClicked?: (node: LTreeNode<T>) => void;
         onNodeDragStart?: (node: LTreeNode<T>, event: DragEvent) => void;
         onNodeDragOver?: (node: LTreeNode<T>, event: DragEvent) => void;
-        onNodeDrop?: (node: LTreeNode<T>, draggedNode: LTreeNode<T>, event: DragEvent) => void;
+        /**
+         * Called before a drop is processed. Return false to cancel the drop.
+         * Return { position, operation } to override the drop position or operation.
+         * Return true or undefined to proceed normally.
+         */
+        beforeDropCallback?: (dropNode: LTreeNode<T> | null, draggedNode: LTreeNode<T>, position: DropPosition, event: DragEvent | TouchEvent, operation: DropOperation) => boolean | {
+            position?: DropPosition;
+            operation?: DropOperation;
+        } | void;
+        onNodeDrop?: (dropNode: LTreeNode<T> | null, draggedNode: LTreeNode<T>, position: DropPosition, event: DragEvent | TouchEvent, operation: DropOperation) => void;
         contextMenuCallback?: (node: LTreeNode<T>, closeMenuCallback: () => void) => ContextMenuItem[];
         bodyClass?: string | null | undefined;
         selectedNodeClass?: string | null | undefined;
@@ -61,11 +89,47 @@ declare function $$render<T>(): {
         collapseAll: (nodePath?: string | null | undefined) => void;
         filterNodes: (searchText: string, searchOptions?: SearchOptions) => void;
         searchNodes: (searchText: string | null | undefined, searchOptions?: SearchOptions) => LTreeNode<T>[];
+        getChildren: (parentPath: string) => LTreeNode<T>[];
+        getSiblings: (path: string) => LTreeNode<T>[];
+        refreshSiblings: (parentPath: string) => void;
+        refreshNode: (path: string) => void;
+        getNodeByPath: (path: string) => LTreeNode<T> | null;
+        moveNode: (sourcePath: string, targetPath: string, position: "above" | "below" | "child") => {
+            success: boolean;
+            error?: string;
+        };
+        removeNode: (path: string, includeDescendants?: boolean) => {
+            success: boolean;
+            node?: LTreeNode<T>;
+            error?: string;
+        };
+        addNode: (parentPath: string, data: T, pathSegment?: string) => {
+            success: boolean;
+            node?: LTreeNode<T>;
+            error?: string;
+        };
+        updateNode: (path: string, dataUpdates: Partial<T>) => {
+            success: boolean;
+            node?: LTreeNode<T>;
+            error?: string;
+        };
+        applyChanges: (changes: import("../ltree/types").TreeChange<T>[]) => import("../ltree/types").ApplyChangesResult;
+        copyNodeWithDescendants: (sourceNode: LTreeNode<T>, targetParentPath: string, transformData: (data: T) => T) => {
+            success: boolean;
+            rootNode?: LTreeNode<T>;
+            count: number;
+            error?: string;
+        };
+        getExpandedPaths: () => string[];
+        setExpandedPaths: (paths: string[]) => void;
+        getAllData: () => T[];
         closeContextMenu: () => void;
         scrollToPath: (path: string, options?: {
             expand?: boolean;
             highlight?: boolean;
             scrollOptions?: ScrollIntoViewOptions;
+            /** Scroll only within the nearest scrollable container (prevents page scroll) */
+            containerScroll?: boolean;
         }) => Promise<boolean>;
         update: (updates: Partial<Pick<{
             idMember: string;
@@ -82,6 +146,7 @@ declare function $$render<T>(): {
             getDisplayValueCallback?: (node: LTreeNode<T>) => string;
             searchValueMember?: string | null | undefined;
             getSearchValueCallback?: (node: LTreeNode<T>) => string;
+            orderMember?: string | null | undefined;
             treeId?: string | null | undefined;
             treePathSeparator?: string | null | undefined;
             sortCallback?: (items: LTreeNode<T>[]) => LTreeNode<T>[];
@@ -94,6 +159,8 @@ declare function $$render<T>(): {
             treeFooter?: any;
             noDataFound?: any;
             contextMenu?: any;
+            dropPlaceholder?: any;
+            loadingPlaceholder?: any;
             expandLevel?: number | null | undefined;
             shouldToggleOnNodeClick?: boolean | null | undefined;
             initializeIndexCallback?: () => Index;
@@ -103,10 +170,33 @@ declare function $$render<T>(): {
             indexerTimeout?: number | null | undefined;
             shouldDisplayDebugInformation?: boolean;
             shouldDisplayContextMenuInDebugMode?: boolean;
+            isLoading?: boolean;
+            progressiveRender?: boolean;
+            renderBatchSize?: number;
+            isRendering?: boolean;
+            onRenderStart?: () => void;
+            onRenderProgress?: (stats: RenderStats) => void;
+            onRenderComplete?: (stats: RenderStats) => void;
+            dragDropMode?: DragDropMode;
+            dropZoneMode?: "floating" | "glow";
+            dropZoneLayout?: "around" | "above" | "below" | "wave" | "wave2";
+            dropZoneStart?: number | string;
+            dropZoneMaxWidth?: number;
+            allowCopy?: boolean;
+            autoHandleCopy?: boolean;
             onNodeClicked?: (node: LTreeNode<T>) => void;
             onNodeDragStart?: (node: LTreeNode<T>, event: DragEvent) => void;
             onNodeDragOver?: (node: LTreeNode<T>, event: DragEvent) => void;
-            onNodeDrop?: (node: LTreeNode<T>, draggedNode: LTreeNode<T>, event: DragEvent) => void;
+            /**
+             * Called before a drop is processed. Return false to cancel the drop.
+             * Return { position, operation } to override the drop position or operation.
+             * Return true or undefined to proceed normally.
+             */
+            beforeDropCallback?: (dropNode: LTreeNode<T> | null, draggedNode: LTreeNode<T>, position: DropPosition, event: DragEvent | TouchEvent, operation: DropOperation) => boolean | {
+                position?: DropPosition;
+                operation?: DropOperation;
+            } | void;
+            onNodeDrop?: (dropNode: LTreeNode<T> | null, draggedNode: LTreeNode<T>, position: DropPosition, event: DragEvent | TouchEvent, operation: DropOperation) => void;
             contextMenuCallback?: (node: LTreeNode<T>, closeMenuCallback: () => void) => ContextMenuItem[];
             bodyClass?: string | null | undefined;
             selectedNodeClass?: string | null | undefined;
@@ -118,9 +208,9 @@ declare function $$render<T>(): {
             scrollHighlightClass?: string | null | undefined;
             contextMenuXOffset?: number | null | undefined;
             contextMenuYOffset?: number | null | undefined;
-        }, "treeId" | "treePathSeparator" | "idMember" | "pathMember" | "parentPathMember" | "levelMember" | "hasChildrenMember" | "isExpandedMember" | "isSelectedMember" | "isDraggableMember" | "isDropAllowedMember" | "displayValueMember" | "getDisplayValueCallback" | "searchValueMember" | "getSearchValueCallback" | "isSorted" | "sortCallback" | "data" | "selectedNode" | "expandLevel" | "shouldToggleOnNodeClick" | "shouldUseInternalSearchIndex" | "initializeIndexCallback" | "searchText" | "indexerBatchSize" | "indexerTimeout" | "shouldDisplayDebugInformation" | "shouldDisplayContextMenuInDebugMode" | "onNodeClicked" | "onNodeDragStart" | "onNodeDragOver" | "onNodeDrop" | "contextMenuCallback" | "bodyClass" | "expandIconClass" | "collapseIconClass" | "leafIconClass" | "selectedNodeClass" | "dragOverNodeClass" | "scrollHighlightTimeout" | "scrollHighlightClass" | "contextMenuXOffset" | "contextMenuYOffset">>) => void;
+        }, "treeId" | "treePathSeparator" | "idMember" | "pathMember" | "parentPathMember" | "levelMember" | "hasChildrenMember" | "isExpandedMember" | "isSelectedMember" | "isDraggableMember" | "isDropAllowedMember" | "displayValueMember" | "getDisplayValueCallback" | "searchValueMember" | "getSearchValueCallback" | "orderMember" | "isSorted" | "sortCallback" | "data" | "selectedNode" | "expandLevel" | "shouldToggleOnNodeClick" | "shouldUseInternalSearchIndex" | "initializeIndexCallback" | "searchText" | "indexerBatchSize" | "indexerTimeout" | "shouldDisplayDebugInformation" | "shouldDisplayContextMenuInDebugMode" | "onNodeClicked" | "onNodeDragStart" | "onNodeDragOver" | "beforeDropCallback" | "onNodeDrop" | "contextMenuCallback" | "dragDropMode" | "dropZoneMode" | "bodyClass" | "expandIconClass" | "collapseIconClass" | "leafIconClass" | "selectedNodeClass" | "dragOverNodeClass" | "scrollHighlightTimeout" | "scrollHighlightClass" | "contextMenuXOffset" | "contextMenuYOffset">>) => void;
     };
-    bindings: "data" | "selectedNode" | "insertResult" | "searchText";
+    bindings: "data" | "selectedNode" | "insertResult" | "searchText" | "isRendering";
     slots: {};
     events: {};
 };
@@ -128,7 +218,7 @@ declare class __sveltets_Render<T> {
     props(): ReturnType<typeof $$render<T>>['props'];
     events(): ReturnType<typeof $$render<T>>['events'];
     slots(): ReturnType<typeof $$render<T>>['slots'];
-    bindings(): "data" | "selectedNode" | "insertResult" | "searchText";
+    bindings(): "data" | "selectedNode" | "insertResult" | "searchText" | "isRendering";
     exports(): {
         expandNodes: (nodePath: string) => Promise<void>;
         collapseNodes: (nodePath: string) => Promise<void>;
@@ -136,11 +226,47 @@ declare class __sveltets_Render<T> {
         collapseAll: (nodePath?: string | null | undefined) => void;
         filterNodes: (searchText: string, searchOptions?: SearchOptions) => void;
         searchNodes: (searchText: string | null | undefined, searchOptions?: SearchOptions) => LTreeNode<T>[];
+        getChildren: (parentPath: string) => LTreeNode<T>[];
+        getSiblings: (path: string) => LTreeNode<T>[];
+        refreshSiblings: (parentPath: string) => void;
+        refreshNode: (path: string) => void;
+        getNodeByPath: (path: string) => LTreeNode<T> | null;
+        moveNode: (sourcePath: string, targetPath: string, position: "above" | "below" | "child") => {
+            success: boolean;
+            error?: string;
+        };
+        removeNode: (path: string, includeDescendants?: boolean) => {
+            success: boolean;
+            node?: LTreeNode<T> | undefined;
+            error?: string;
+        };
+        addNode: (parentPath: string, data: T, pathSegment?: string) => {
+            success: boolean;
+            node?: LTreeNode<T> | undefined;
+            error?: string;
+        };
+        updateNode: (path: string, dataUpdates: Partial<T>) => {
+            success: boolean;
+            node?: LTreeNode<T> | undefined;
+            error?: string;
+        };
+        applyChanges: (changes: import("../ltree/types.js").TreeChange<T>[]) => import("../ltree/types").ApplyChangesResult;
+        copyNodeWithDescendants: (sourceNode: LTreeNode<T>, targetParentPath: string, transformData: (data: T) => T) => {
+            success: boolean;
+            rootNode?: LTreeNode<T> | undefined;
+            count: number;
+            error?: string;
+        };
+        getExpandedPaths: () => string[];
+        setExpandedPaths: (paths: string[]) => void;
+        getAllData: () => T[];
         closeContextMenu: () => void;
         scrollToPath: (path: string, options?: {
             expand?: boolean;
             highlight?: boolean;
             scrollOptions?: ScrollIntoViewOptions;
+            /** Scroll only within the nearest scrollable container (prevents page scroll) */
+            containerScroll?: boolean;
         } | undefined) => Promise<boolean>;
         update: (updates: Partial<Pick<{
             idMember: string;
@@ -157,6 +283,7 @@ declare class __sveltets_Render<T> {
             getDisplayValueCallback?: ((node: LTreeNode<T>) => string) | undefined;
             searchValueMember?: string | null | undefined;
             getSearchValueCallback?: ((node: LTreeNode<T>) => string) | undefined;
+            orderMember?: string | null | undefined;
             treeId?: string | null | undefined;
             treePathSeparator?: string | null | undefined;
             sortCallback?: ((items: LTreeNode<T>[]) => LTreeNode<T>[]) | undefined;
@@ -169,6 +296,8 @@ declare class __sveltets_Render<T> {
             treeFooter?: any;
             noDataFound?: any;
             contextMenu?: any;
+            dropPlaceholder?: any;
+            loadingPlaceholder?: any;
             expandLevel?: number | null | undefined;
             shouldToggleOnNodeClick?: boolean | null | undefined;
             initializeIndexCallback?: (() => Index) | undefined;
@@ -178,10 +307,33 @@ declare class __sveltets_Render<T> {
             indexerTimeout?: number | null | undefined;
             shouldDisplayDebugInformation?: boolean;
             shouldDisplayContextMenuInDebugMode?: boolean;
+            isLoading?: boolean;
+            progressiveRender?: boolean;
+            renderBatchSize?: number;
+            isRendering?: boolean;
+            onRenderStart?: (() => void) | undefined;
+            onRenderProgress?: ((stats: RenderStats) => void) | undefined;
+            onRenderComplete?: ((stats: RenderStats) => void) | undefined;
+            dragDropMode?: DragDropMode;
+            dropZoneMode?: "floating" | "glow";
+            dropZoneLayout?: "around" | "above" | "below" | "wave" | "wave2";
+            dropZoneStart?: number | string;
+            dropZoneMaxWidth?: number;
+            allowCopy?: boolean;
+            autoHandleCopy?: boolean;
             onNodeClicked?: ((node: LTreeNode<T>) => void) | undefined;
             onNodeDragStart?: ((node: LTreeNode<T>, event: DragEvent) => void) | undefined;
             onNodeDragOver?: ((node: LTreeNode<T>, event: DragEvent) => void) | undefined;
-            onNodeDrop?: ((node: LTreeNode<T>, draggedNode: LTreeNode<T>, event: DragEvent) => void) | undefined;
+            /**
+             * Called before a drop is processed. Return false to cancel the drop.
+             * Return { position, operation } to override the drop position or operation.
+             * Return true or undefined to proceed normally.
+             */
+            beforeDropCallback?: ((dropNode: LTreeNode<T> | null, draggedNode: LTreeNode<T>, position: DropPosition, event: DragEvent | TouchEvent, operation: DropOperation) => boolean | void | {
+                position?: DropPosition;
+                operation?: DropOperation;
+            }) | undefined;
+            onNodeDrop?: ((dropNode: LTreeNode<T> | null, draggedNode: LTreeNode<T>, position: DropPosition, event: DragEvent | TouchEvent, operation: DropOperation) => void) | undefined;
             contextMenuCallback?: ((node: LTreeNode<T>, closeMenuCallback: () => void) => ContextMenuItem[]) | undefined;
             bodyClass?: string | null | undefined;
             selectedNodeClass?: string | null | undefined;
@@ -193,7 +345,7 @@ declare class __sveltets_Render<T> {
             scrollHighlightClass?: string | null | undefined;
             contextMenuXOffset?: number | null | undefined;
             contextMenuYOffset?: number | null | undefined;
-        }, "treeId" | "data" | "onNodeClicked" | "onNodeDragStart" | "onNodeDragOver" | "onNodeDrop" | "shouldToggleOnNodeClick" | "expandIconClass" | "collapseIconClass" | "leafIconClass" | "selectedNodeClass" | "dragOverNodeClass" | "treePathSeparator" | "idMember" | "pathMember" | "parentPathMember" | "levelMember" | "hasChildrenMember" | "isExpandedMember" | "displayValueMember" | "getDisplayValueCallback" | "searchValueMember" | "getSearchValueCallback" | "isSorted" | "sortCallback" | "isDraggableMember" | "isDropAllowedMember" | "shouldDisplayDebugInformation" | "isSelectedMember" | "selectedNode" | "expandLevel" | "shouldUseInternalSearchIndex" | "initializeIndexCallback" | "searchText" | "indexerBatchSize" | "indexerTimeout" | "shouldDisplayContextMenuInDebugMode" | "contextMenuCallback" | "bodyClass" | "scrollHighlightTimeout" | "scrollHighlightClass" | "contextMenuXOffset" | "contextMenuYOffset">>) => void;
+        }, "treeId" | "data" | "onNodeClicked" | "onNodeDragStart" | "onNodeDragOver" | "onNodeDrop" | "shouldToggleOnNodeClick" | "expandIconClass" | "collapseIconClass" | "leafIconClass" | "selectedNodeClass" | "dragOverNodeClass" | "dropZoneMode" | "treePathSeparator" | "idMember" | "pathMember" | "parentPathMember" | "levelMember" | "hasChildrenMember" | "isExpandedMember" | "displayValueMember" | "getDisplayValueCallback" | "searchValueMember" | "getSearchValueCallback" | "orderMember" | "isSorted" | "sortCallback" | "isDraggableMember" | "isDropAllowedMember" | "shouldDisplayDebugInformation" | "isSelectedMember" | "selectedNode" | "expandLevel" | "shouldUseInternalSearchIndex" | "initializeIndexCallback" | "searchText" | "indexerBatchSize" | "indexerTimeout" | "shouldDisplayContextMenuInDebugMode" | "dragDropMode" | "beforeDropCallback" | "contextMenuCallback" | "bodyClass" | "scrollHighlightTimeout" | "scrollHighlightClass" | "contextMenuXOffset" | "contextMenuYOffset">>) => void;
     };
 }
 interface $$IsomorphicComponent {

package/dist/constants.generated.d.ts

@@ -0,0 +1,6 @@
+export declare const VERSION = "4.5.0";
+export declare const PACKAGE_NAME = "@keenmate/svelte-treeview";
+export declare const AUTHOR = "KeenMate";
+export declare const LICENSE = "MIT";
+export declare const REPOSITORY = "git+https://github.com/keenmate/svelte-treeview.git";
+export declare const HOMEPAGE = "https://github.com/keenmate/svelte-treeview#readme";

package/dist/constants.generated.js

@@ -0,0 +1,8 @@
+// Auto-generated file - do not edit manually
+// Generated by scripts/generate-constants.js
+export const VERSION = "4.5.0";
+export const PACKAGE_NAME = "@keenmate/svelte-treeview";
+export const AUTHOR = "KeenMate";
+export const LICENSE = "MIT";
+export const REPOSITORY = "git+https://github.com/keenmate/svelte-treeview.git";
+export const HOMEPAGE = "https://github.com/keenmate/svelte-treeview#readme";

package/dist/global-api.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Global API registration for runtime logging control
+ * This file is imported by Tree.svelte to ensure it runs when the component is used
+ */
+export interface GlobalTreeviewAPI {
+    version: () => string;
+    config: {
+        name: string;
+        version: string;
+        author: string;
+        license: string;
+        repository: string;
+        homepage: string;
+    };
+    logging: {
+        enableLogging: () => void;
+        disableLogging: () => void;
+        setLogLevel: (level: string) => void;
+        setCategoryLevel: (category: string, level: string) => void;
+        getCategories: () => string[];
+    };
+    perf: {
+        enable: () => void;
+        disable: () => void;
+        setThreshold: (ms: number) => void;
+        isEnabled: () => boolean;
+    };
+}
+declare global {
+    interface Window {
+        components?: {
+            'svelte-treeview'?: GlobalTreeviewAPI;
+        };
+    }
+}

package/dist/global-api.js

@@ -0,0 +1,36 @@
+/**
+ * Global API registration for runtime logging control
+ * This file is imported by Tree.svelte to ensure it runs when the component is used
+ */
+import { setLogLevel, enableLogging, disableLogging, setCategoryLevel, LOGGING_CATEGORIES } from './logger';
+import { enablePerfLogging, disablePerfLogging, setPerfThreshold, isPerfLoggingEnabled } from './perf-logger';
+// Import generated constants (created by scripts/generate-constants.js)
+import { VERSION, PACKAGE_NAME, AUTHOR, LICENSE, REPOSITORY, HOMEPAGE } from './constants.generated';
+// Initialize global API for runtime logging control
+if (typeof window !== 'undefined') {
+    window.components = window.components || {};
+    window.components['svelte-treeview'] = {
+        version: () => VERSION,
+        config: {
+            name: PACKAGE_NAME,
+            version: VERSION,
+            author: AUTHOR,
+            license: LICENSE,
+            repository: REPOSITORY,
+            homepage: HOMEPAGE
+        },
+        logging: {
+            enableLogging,
+            disableLogging,
+            setLogLevel,
+            setCategoryLevel,
+            getCategories: () => [...LOGGING_CATEGORIES]
+        },
+        perf: {
+            enable: enablePerfLogging,
+            disable: disablePerfLogging,
+            setThreshold: setPerfThreshold,
+            isEnabled: isPerfLoggingEnabled
+        }
+    };
+}

package/dist/index.d.ts

@@ -1,3 +1,8 @@
 export { default as Tree } from "./components/Tree.svelte";
 export type { LTreeNode, NodeId, VisualState } from "./ltree/ltree-node.svelte";
-export type { Ltree } from "./ltree/types";
+export type { Ltree, DropPosition, DragDropMode, DropOperation, ContextMenuItem, InsertArrayResult, TreeChange, ApplyChangesResult } from "./ltree/types";
+export type { RenderStats } from "./components/RenderCoordinator.svelte";
+export { enableLogging, disableLogging, setLogLevel, setCategoryLevel, LOGGING_CATEGORIES } from "./logger";
+export { enablePerfLogging, disablePerfLogging, setPerfThreshold, isPerfLoggingEnabled, perfStart, perfEnd, perfMeasure, perfSummary } from "./perf-logger";
+export type { GlobalTreeviewAPI } from "./global-api";
+import "./global-api";

package/dist/index.js

@@ -1,2 +1,7 @@
 // Reexport your entry components here
 export { default as Tree } from "./components/Tree.svelte";
+// Export logging utilities
+export { enableLogging, disableLogging, setLogLevel, setCategoryLevel, LOGGING_CATEGORIES } from "./logger";
+// Export performance logging utilities
+export { enablePerfLogging, disablePerfLogging, setPerfThreshold, isPerfLoggingEnabled, perfStart, perfEnd, perfMeasure, perfSummary } from "./perf-logger";
+import "./global-api";

package/dist/logger.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Logging configuration using loglevel with categorized loggers
+ *
+ * Categories:
+ * - LTREE:INIT: Tree initialization and configuration
+ * - LTREE:DATA: Data insertion, tree manipulation, node operations
+ * - LTREE:RENDER: Rendering, progressive rendering, coordinator
+ * - LTREE:INDEX: Search indexing operations
+ * - LTREE:DRAG: Drag and drop operations
+ *
+ * Usage:
+ * - By default, all logging is disabled (silent mode) for production
+ * - Enable logging in browser console:
+ *   ```javascript
+ *   import { enableLogging, setLogLevel, setCategoryLevel } from '@keenmate/svelte-treeview';
+ *
+ *   // Enable all logging at debug level
+ *   enableLogging();
+ *
+ *   // Or set a specific log level for all categories
+ *   setLogLevel('info');  // 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'silent'
+ *
+ *   // Or enable/disable specific categories
+ *   disableLogging();  // First disable all
+ *   setCategoryLevel('LTREE:RENDER', 'debug');  // Enable only render logs
+ *   setCategoryLevel('LTREE:INDEX', 'info');  // Enable only index logs at info level
+ *   ```
+ */
+import log from './vendor/loglevel/index.js';
+export declare const initLogger: any;
+export declare const dataLogger: any;
+export declare const renderLogger: any;
+export declare const indexLogger: any;
+export declare const dragLogger: any;
+export declare const uiLogger: any;
+export default log;
+/**
+ * List of all logging categories
+ */
+export declare const LOGGING_CATEGORIES: string[];
+/**
+ * Enable logging for all loggers
+ */
+export declare const setLogLevel: (level: "trace" | "debug" | "info" | "warn" | "error" | "silent") => void;
+/**
+ * Enable all logging (set to debug level)
+ */
+export declare const enableLogging: () => void;
+/**
+ * Disable all logging (set to silent level)
+ */
+export declare const disableLogging: () => void;
+/**
+ * Set log level for a specific category
+ */
+export declare const setCategoryLevel: (category: "LTREE:INIT" | "LTREE:DATA" | "LTREE:RENDER" | "LTREE:INDEX" | "LTREE:DRAG" | "LTREE:UI", level?: "trace" | "debug" | "info" | "warn" | "error" | "silent") => void;

package/dist/logger.js

@@ -0,0 +1,159 @@
+/**
+ * Logging configuration using loglevel with categorized loggers
+ *
+ * Categories:
+ * - LTREE:INIT: Tree initialization and configuration
+ * - LTREE:DATA: Data insertion, tree manipulation, node operations
+ * - LTREE:RENDER: Rendering, progressive rendering, coordinator
+ * - LTREE:INDEX: Search indexing operations
+ * - LTREE:DRAG: Drag and drop operations
+ *
+ * Usage:
+ * - By default, all logging is disabled (silent mode) for production
+ * - Enable logging in browser console:
+ *   ```javascript
+ *   import { enableLogging, setLogLevel, setCategoryLevel } from '@keenmate/svelte-treeview';
+ *
+ *   // Enable all logging at debug level
+ *   enableLogging();
+ *
+ *   // Or set a specific log level for all categories
+ *   setLogLevel('info');  // 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'silent'
+ *
+ *   // Or enable/disable specific categories
+ *   disableLogging();  // First disable all
+ *   setCategoryLevel('LTREE:RENDER', 'debug');  // Enable only render logs
+ *   setCategoryLevel('LTREE:INDEX', 'info');  // Enable only index logs at info level
+ *   ```
+ */
+// Import vendored libraries via ES module wrappers
+// @ts-ignore - Vendored library without type definitions
+import log from './vendor/loglevel/index.js';
+// @ts-ignore - Vendored library without type definitions
+import prefix from './vendor/loglevel/prefix.js';
+// Define color scheme
+const COLORS = {
+    trace: '#9ca3af', // Gray
+    debug: '#0ea5e9', // Blue
+    info: '#10b981', // Green
+    warn: '#f59e0b', // Orange
+    error: '#ef4444' // Red
+};
+// Logger categories documentation:
+// - LTREE:INIT: Tree initialization and configuration
+// - LTREE:DATA: Data insertion, tree manipulation, node operations
+// - LTREE:RENDER: Rendering, progressive rendering, coordinator
+// - LTREE:INDEX: Search indexing operations
+// - LTREE:DRAG: Drag and drop operations
+// - LTREE:UI: User interactions (click, expand/collapse, selection)
+// Register prefix plugin with the root logger
+prefix.reg(log);
+// Set default log level to silent (production mode)
+log.setLevel('silent');
+// Prefix format options that include %c markers
+const prefixOptions = {
+    format(level, name, timestamp) {
+        return `%c[${timestamp}]%c %c[${level.toUpperCase()}]%c %c[${name}]%c`;
+    },
+    timestampFormatter(date) {
+        return date.toTimeString().split(' ')[0] + '.' + date.getMilliseconds().toString().padStart(3, '0');
+    }
+};
+/**
+ * Create a color-aware method factory that intercepts %c codes and adds CSS styles
+ */
+function createColorMethodFactory(originalFactory) {
+    return function (methodName, logLevel, loggerName) {
+        const rawMethod = originalFactory(methodName, logLevel, loggerName);
+        return function (...args) {
+            // If first arg contains %c color codes, inject the color styles
+            if (args.length > 0 && typeof args[0] === 'string' && args[0].includes('%c')) {
+                const color = COLORS[methodName] || '#666';
+                // Count how many %c markers we have (should be 6 for our format)
+                const numMarkers = (args[0].match(/%c/g) || []).length;
+                const colorStyles = [];
+                for (let i = 0; i < numMarkers; i++) {
+                    // Alternate between color and reset
+                    colorStyles.push(i % 2 === 0 ? `color: ${color}; font-weight: bold;` : 'color: inherit;');
+                }
+                rawMethod(args[0], ...colorStyles, ...args.slice(1));
+            }
+            else {
+                rawMethod(...args);
+            }
+        };
+    };
+}
+// Create category-specific loggers
+export const initLogger = log.getLogger('LTREE:INIT');
+export const dataLogger = log.getLogger('LTREE:DATA');
+export const renderLogger = log.getLogger('LTREE:RENDER');
+export const indexLogger = log.getLogger('LTREE:INDEX');
+export const dragLogger = log.getLogger('LTREE:DRAG');
+export const uiLogger = log.getLogger('LTREE:UI');
+// Apply prefix and color styling to all category loggers
+const allLoggers = [
+    initLogger,
+    dataLogger,
+    renderLogger,
+    indexLogger,
+    dragLogger,
+    uiLogger
+];
+allLoggers.forEach(logger => {
+    // First wrap the methodFactory with color injection
+    // This needs to happen BEFORE prefix.apply so the prefix plugin's
+    // output (which contains %c codes) goes through our color handler
+    const originalFactory = logger.methodFactory;
+    logger.methodFactory = createColorMethodFactory(originalFactory);
+    // Now apply prefix - it will wrap our color-aware methodFactory
+    prefix.apply(logger, prefixOptions);
+    // Set level to rebuild methods
+    logger.setLevel('silent');
+});
+// Export the default logger
+export default log;
+/**
+ * List of all logging categories
+ */
+export const LOGGING_CATEGORIES = [
+    'LTREE:INIT',
+    'LTREE:DATA',
+    'LTREE:RENDER',
+    'LTREE:INDEX',
+    'LTREE:DRAG',
+    'LTREE:UI'
+];
+/**
+ * Enable logging for all loggers
+ */
+export const setLogLevel = (level) => {
+    log.setLevel(level);
+    allLoggers.forEach(logger => logger.setLevel(level));
+};
+/**
+ * Enable all logging (set to debug level)
+ */
+export const enableLogging = () => {
+    setLogLevel('debug');
+};
+/**
+ * Disable all logging (set to silent level)
+ */
+export const disableLogging = () => {
+    setLogLevel('silent');
+};
+/**
+ * Set log level for a specific category
+ */
+export const setCategoryLevel = (category, level = 'debug') => {
+    const loggerMap = {
+        'LTREE:INIT': initLogger,
+        'LTREE:DATA': dataLogger,
+        'LTREE:RENDER': renderLogger,
+        'LTREE:INDEX': indexLogger,
+        'LTREE:DRAG': dragLogger,
+        'LTREE:UI': uiLogger
+    };
+    loggerMap[category]?.setLevel(level);
+};

package/dist/ltree/indexer.d.ts

@@ -8,7 +8,6 @@ export declare class Indexer<T> {
     private searchIndex;
     private isProcessing;
     private shouldCalculateSearchValue;
-    private shouldDisplayDebugInformation;
     private searchValueMember?;
     private getSearchValueCallback?;
     private onProgressCallback?;