@keenmate/svelte-treeview 4.8.0 → 5.0.0-rc02

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.
Files changed (51) hide show
  1. package/README.md +106 -117
  2. package/ai/INDEX.txt +310 -0
  3. package/ai/advanced-patterns.txt +506 -0
  4. package/ai/basic-setup.txt +336 -0
  5. package/ai/context-menu.txt +349 -0
  6. package/ai/data-handling.txt +390 -0
  7. package/ai/drag-drop.txt +397 -0
  8. package/ai/events-callbacks.txt +382 -0
  9. package/ai/import-patterns.txt +271 -0
  10. package/ai/performance.txt +349 -0
  11. package/ai/search-features.txt +359 -0
  12. package/ai/styling-theming.txt +354 -0
  13. package/ai/tree-editing.txt +423 -0
  14. package/ai/typescript-types.txt +357 -0
  15. package/dist/components/Node.svelte +47 -40
  16. package/dist/components/Node.svelte.d.ts +1 -1
  17. package/dist/components/Tree.svelte +384 -1479
  18. package/dist/components/Tree.svelte.d.ts +30 -28
  19. package/dist/components/TreeProvider.svelte +28 -0
  20. package/dist/components/TreeProvider.svelte.d.ts +28 -0
  21. package/dist/constants.generated.d.ts +1 -1
  22. package/dist/constants.generated.js +1 -1
  23. package/dist/core/TreeController.svelte.d.ts +353 -0
  24. package/dist/core/TreeController.svelte.js +1503 -0
  25. package/dist/core/createTreeController.d.ts +9 -0
  26. package/dist/core/createTreeController.js +11 -0
  27. package/dist/global-api.d.ts +1 -1
  28. package/dist/global-api.js +5 -5
  29. package/dist/index.d.ts +10 -6
  30. package/dist/index.js +7 -3
  31. package/dist/logger.d.ts +7 -6
  32. package/dist/logger.js +0 -2
  33. package/dist/ltree/indexer.js +2 -4
  34. package/dist/ltree/ltree-node.svelte.d.ts +2 -1
  35. package/dist/ltree/ltree-node.svelte.js +1 -0
  36. package/dist/ltree/ltree.svelte.d.ts +1 -1
  37. package/dist/ltree/ltree.svelte.js +168 -175
  38. package/dist/ltree/types.d.ts +12 -8
  39. package/dist/perf-logger.d.ts +2 -1
  40. package/dist/perf-logger.js +0 -2
  41. package/dist/styles/main.scss +78 -78
  42. package/dist/styles.css +41 -41
  43. package/dist/styles.css.map +1 -1
  44. package/dist/vendor/loglevel/index.d.ts +55 -2
  45. package/dist/vendor/loglevel/prefix.d.ts +23 -2
  46. package/package.json +96 -95
  47. package/dist/ltree/ltree-demo.d.ts +0 -2
  48. package/dist/ltree/ltree-demo.js +0 -90
  49. package/dist/vendor/loglevel/loglevel-esm.d.ts +0 -2
  50. package/dist/vendor/loglevel/loglevel-plugin-prefix-esm.d.ts +0 -7
  51. package/dist/vendor/loglevel/loglevel-plugin-prefix.d.ts +0 -2
package/ai/INDEX.txt ADDED
@@ -0,0 +1,310 @@
1
+ DOCUMENTATION INDEX
2
+ ===================
3
+
4
+ Quick reference for finding documentation on specific topics.
5
+
6
+ FILE OVERVIEW
7
+ -------------
8
+ basic-setup.txt - Installation, first component, Svelte 5 requirements
9
+ import-patterns.txt - How to import the component, types, styles
10
+ data-handling.txt - Path-based hierarchy, LTree data structure
11
+ drag-drop.txt - Drag and drop, positions, touch support, restrictions
12
+ search-features.txt - FlexSearch, async indexing, filtering
13
+ context-menu.txt - Callback-based and snippet-based menus
14
+ tree-editing.txt - addNode, moveNode, removeNode methods
15
+ styling-theming.txt - CSS variables, SCSS, classes
16
+ events-callbacks.txt - Events, callbacks, handlers
17
+ typescript-types.txt - Types and interfaces
18
+ performance.txt - Flat rendering, progressive render, optimization
19
+ advanced-patterns.txt - Complex use cases and patterns
20
+
21
+ KEYWORD INDEX
22
+ =============
23
+
24
+ A
25
+ -
26
+ addNode → tree-editing.txt
27
+ allowCopy → drag-drop.txt
28
+ applyChanges → tree-editing.txt
29
+ allowedDropPositions → drag-drop.txt
30
+ allowedDropPositionsMember → drag-drop.txt
31
+ Async indexing → search-features.txt, performance.txt
32
+
33
+ B
34
+ -
35
+ beforeDropCallback → drag-drop.txt, events-callbacks.txt
36
+ bodyClass → styling-theming.txt
37
+
38
+ C
39
+ -
40
+ Callbacks → events-callbacks.txt, data-handling.txt
41
+ closeContextMenu → context-menu.txt
42
+ collapseAll → basic-setup.txt, tree-editing.txt
43
+ collapseIconClass → styling-theming.txt
44
+ collapseNodes → basic-setup.txt
45
+ Context menu → context-menu.txt
46
+ contextMenuCallback → context-menu.txt, events-callbacks.txt
47
+ contextMenuXOffset → context-menu.txt
48
+ contextMenuYOffset → context-menu.txt
49
+ Copy operation → drag-drop.txt
50
+ CSS Variables → styling-theming.txt
51
+ Ctrl+drag → drag-drop.txt
52
+
53
+ D
54
+ -
55
+ data → basic-setup.txt, data-handling.txt
56
+ displayValueMember → data-handling.txt
57
+ dropPlaceholder → drag-drop.txt, basic-setup.txt
58
+ Drag and drop → drag-drop.txt
59
+ dragDropMode → drag-drop.txt
60
+ dragOverNodeClass → styling-theming.txt, drag-drop.txt
61
+ DropPosition → drag-drop.txt, typescript-types.txt
62
+ dropZoneLayout → drag-drop.txt
63
+ dropZoneMode → drag-drop.txt
64
+ dropZoneStart → drag-drop.txt
65
+
66
+ E
67
+ -
68
+ Events → events-callbacks.txt
69
+ expandAll → basic-setup.txt, tree-editing.txt
70
+ expandIconClass → styling-theming.txt
71
+ expandLevel → basic-setup.txt, data-handling.txt
72
+ expandNodes → basic-setup.txt
73
+
74
+ F
75
+ -
76
+ filterNodes → search-features.txt
77
+ Flat rendering → performance.txt
78
+ FlexSearch → search-features.txt
79
+
80
+ G
81
+ -
82
+ getAllData → tree-editing.txt
83
+ getAllowedDropPositionsCallback → drag-drop.txt
84
+ getChildren → tree-editing.txt
85
+ getDisplayValueCallback → data-handling.txt
86
+ getExpandedPaths → tree-editing.txt
87
+ getIsCollapsibleCallback → data-handling.txt
88
+ getIsDraggableCallback → drag-drop.txt, data-handling.txt
89
+ getNodeByPath → tree-editing.txt
90
+ getSearchValueCallback → search-features.txt, data-handling.txt
91
+ getSiblings → tree-editing.txt
92
+ Glow mode → drag-drop.txt, styling-theming.txt
93
+
94
+ H
95
+ -
96
+ hasChildrenMember → data-handling.txt
97
+ Hierarchy → data-handling.txt
98
+
99
+ I
100
+ -
101
+ idMember → data-handling.txt, basic-setup.txt
102
+ Import → import-patterns.txt
103
+ indexerBatchSize → search-features.txt, performance.txt
104
+ indexerTimeout → search-features.txt
105
+ initialBatchSize → performance.txt
106
+ insertResult → data-handling.txt
107
+ Installation → basic-setup.txt
108
+ isCollapsibleMember → data-handling.txt
109
+ isLoading → basic-setup.txt
110
+ isDraggableMember → drag-drop.txt, data-handling.txt
111
+ isDropAllowedMember → drag-drop.txt, data-handling.txt
112
+ isExpandedMember → data-handling.txt
113
+ isRendering → performance.txt
114
+ isSelectedMember → data-handling.txt
115
+ isSorted → data-handling.txt
116
+
117
+ K
118
+ -
119
+ Keyboard → basic-setup.txt
120
+
121
+ L
122
+ -
123
+ leafIconClass → styling-theming.txt
124
+ loadingPlaceholder → basic-setup.txt
125
+ levelMember → data-handling.txt
126
+ Logging → performance.txt, advanced-patterns.txt
127
+ LTree → data-handling.txt, typescript-types.txt
128
+ LTreeNode → typescript-types.txt, data-handling.txt
129
+
130
+ M
131
+ -
132
+ maxBatchSize → performance.txt
133
+ moveNode → tree-editing.txt
134
+
135
+ N
136
+ -
137
+ nodeTemplate → basic-setup.txt, styling-theming.txt
138
+
139
+ O
140
+ -
141
+ onNodeClicked → events-callbacks.txt
142
+ onRenderComplete → performance.txt
143
+ onRenderProgress → performance.txt
144
+ onRenderStart → performance.txt
145
+ onNodeDragOver → events-callbacks.txt, drag-drop.txt
146
+ onNodeDragStart → events-callbacks.txt, drag-drop.txt
147
+ onNodeDrop → events-callbacks.txt, drag-drop.txt
148
+ orderMember → drag-drop.txt, tree-editing.txt
149
+
150
+ P
151
+ -
152
+ parentPathMember → data-handling.txt
153
+ Path structure → data-handling.txt
154
+ pathMember → data-handling.txt, basic-setup.txt
155
+ Performance → performance.txt
156
+ Position restrictions → drag-drop.txt
157
+ Progressive rendering → performance.txt
158
+ progressiveRender → performance.txt
159
+
160
+ R
161
+ -
162
+ refreshNode → tree-editing.txt
163
+ refreshSiblings → tree-editing.txt
164
+ removeNode → tree-editing.txt
165
+ Root drop zone → drag-drop.txt
166
+
167
+ S
168
+ -
169
+ SCSS → styling-theming.txt, import-patterns.txt
170
+ setExpandedPaths → tree-editing.txt
171
+ scrollHighlightClass → styling-theming.txt
172
+ scrollHighlightTimeout → styling-theming.txt
173
+ scrollToPath → basic-setup.txt, tree-editing.txt
174
+ Search → search-features.txt
175
+ searchNodes → search-features.txt
176
+ searchText → search-features.txt, basic-setup.txt
177
+ searchValueMember → search-features.txt, data-handling.txt
178
+ selectedNode → basic-setup.txt, events-callbacks.txt
179
+ selectedNodeClass → styling-theming.txt
180
+ shouldDisplayDebugInformation → basic-setup.txt, performance.txt
181
+ shouldToggleOnNodeClick → basic-setup.txt
182
+ shouldUseInternalSearchIndex → search-features.txt
183
+ Snippets → basic-setup.txt, context-menu.txt
184
+ sortCallback → data-handling.txt, basic-setup.txt
185
+ $state.raw() → performance.txt
186
+ statistics → basic-setup.txt, performance.txt
187
+ Styles → styling-theming.txt
188
+ Svelte 5 → basic-setup.txt
189
+
190
+ T
191
+ -
192
+ Touch drag → drag-drop.txt
193
+ Tree → basic-setup.txt, typescript-types.txt
194
+ TreeController → basic-setup.txt, advanced-patterns.txt
195
+ TreeProvider → basic-setup.txt, advanced-patterns.txt
196
+ treeId → basic-setup.txt
197
+ treePathSeparator → data-handling.txt
198
+ TypeScript → typescript-types.txt
199
+
200
+ U
201
+ -
202
+ update() → basic-setup.txt, advanced-patterns.txt
203
+ updateNode → tree-editing.txt
204
+ useFlatRendering → performance.txt
205
+
206
+ V
207
+ -
208
+ virtualScroll → performance.txt
209
+ virtualRowHeight → performance.txt
210
+ virtualOverscan → performance.txt
211
+ virtualContainerHeight → performance.txt
212
+ Virtual scroll → performance.txt
213
+
214
+ COMMON QUESTIONS
215
+ ================
216
+
217
+ Q: How do I get started?
218
+ A: → basic-setup.txt
219
+
220
+ Q: How do I import the component?
221
+ A: → import-patterns.txt
222
+
223
+ Q: How do I structure my hierarchical data?
224
+ A: → data-handling.txt
225
+
226
+ Q: How do I enable drag and drop?
227
+ A: → drag-drop.txt
228
+
229
+ Q: How do I restrict where items can be dropped?
230
+ A: → drag-drop.txt (allowedDropPositions)
231
+
232
+ Q: How do I add search functionality?
233
+ A: → search-features.txt
234
+
235
+ Q: How do I add a right-click context menu?
236
+ A: → context-menu.txt
237
+
238
+ Q: How do I programmatically edit the tree?
239
+ A: → tree-editing.txt
240
+
241
+ Q: How do I change colors and styles?
242
+ A: → styling-theming.txt
243
+
244
+ Q: How do I listen to selection changes?
245
+ A: → events-callbacks.txt
246
+
247
+ Q: Where are the TypeScript types?
248
+ A: → typescript-types.txt
249
+
250
+ Q: My tree is slow with thousands of items
251
+ A: → performance.txt
252
+
253
+ Q: How do I copy nodes instead of move?
254
+ A: → drag-drop.txt (Ctrl+drag)
255
+
256
+ Q: How do I implement async drop validation?
257
+ A: → drag-drop.txt (beforeDropCallback)
258
+
259
+ Q: How do I handle trees with 10,000+ nodes?
260
+ A: → performance.txt (virtual scroll, $state.raw())
261
+
262
+ FEATURES BY CATEGORY
263
+ ====================
264
+
265
+ GETTING STARTED
266
+ - Installation and setup → basic-setup.txt
267
+ - Import methods → import-patterns.txt
268
+ - First component → basic-setup.txt
269
+
270
+ DATA & STRUCTURE
271
+ - Path-based hierarchy → data-handling.txt
272
+ - Custom separators → data-handling.txt
273
+ - Member properties → data-handling.txt
274
+ - Insert results → data-handling.txt
275
+
276
+ DRAG & DROP
277
+ - Basic drag/drop → drag-drop.txt
278
+ - Drop positions → drag-drop.txt
279
+ - Position restrictions → drag-drop.txt
280
+ - Touch support → drag-drop.txt
281
+ - Copy operations → drag-drop.txt
282
+
283
+ SEARCH & FILTERING
284
+ - FlexSearch integration → search-features.txt
285
+ - Async indexing → search-features.txt
286
+ - Filter vs search → search-features.txt
287
+
288
+ TREE EDITING
289
+ - Add nodes → tree-editing.txt
290
+ - Move nodes → tree-editing.txt
291
+ - Remove nodes → tree-editing.txt
292
+ - Order management → tree-editing.txt
293
+
294
+ CUSTOMIZATION
295
+ - CSS variables → styling-theming.txt
296
+ - SCSS → styling-theming.txt
297
+ - Node templates → basic-setup.txt, styling-theming.txt
298
+ - Context menus → context-menu.txt
299
+
300
+ INTEGRATION
301
+ - Events → events-callbacks.txt
302
+ - TypeScript → typescript-types.txt
303
+ - External updates → advanced-patterns.txt
304
+
305
+ PERFORMANCE
306
+ - Flat rendering → performance.txt
307
+ - Progressive render → performance.txt
308
+ - Virtual scroll → performance.txt
309
+ - $state.raw() → performance.txt
310
+ - Large datasets → performance.txt