@knime/kds-components 0.28.10 → 0.29.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @knime/kds-components
 
+## 0.29.0
+
+### Minor Changes
+
+- 6d7510a: Add KdsFileExplorer component
+
+  Migration guide:
+  - Most props are still named the same way
+  - Drag behavior remains the same, as well as emitted drag events
+  - The `mode` prop doesn't exist anymore. Instead a new `size` prop was introduced, but unlike the `mode` prop, the `size` controls the sizes of the items as opposed to the whole FileExplorer
+  - The `virtual` prop was removed. Virtualization is the default behavior now and it's always used.
+    - Keep in mind that if the component's wrapper height is not restricted, the virtualization won't have effect as the component will just grow the document's overflow
+  - Slots removed:
+    - `itemContent` -> This used to control the item's `name` rendering. Now the name is always rendered and cannot be customized. If you need extra columns you can still use the dynamic content column slot
+    - `itemIcon` -> The icon is specified now as part of each item in the `items` prop
+    - `contextMenu` -> See next section
+  - ContextMenu changes:
+    - No longer controlled by a slot
+    - A new `contextMenuBuilder` prop is introduced. This takes a function that produces the items that should be rendered on the menu. The function receives as parameters: the `anchor` (item the menu was opened on) as a well as a list of the items that are selected when the context menu is opened (`selectedItems`)
+  - Default rename behavior was removed
+    - This used to be tightly coupled to the context menu slot. Now the rename behavior is completely controlled by the component consumer. You can use the v-model `activeRenameItemId` to fully control the rename item.
+    - The rename event is still present
+    - The property `canBeRenamed` present on each FileExplorerItem's data model was removed
+  - Default delete behavior was removed
+    - This used to be tightly coupled to the context menu slot. Now the delete behavior is completely controlled by the component consumer.
+    - When items are deleted, the `items` prop will naturally update on the consumer's context, leading to an update in the FileExplorer's state/UI
+    - The `delete-items` event was removed.
+    - The property `canBeDeleted` present on each FileExplorerItem's data model was removed
+  - The `openFile` event was changed.
+    - Now, all non-directory items emit this event. It's up to the consumer to determine what to do
+    - The `isOpenableFile` present on each FileExplorerItem's data model was removed
+
+### Patch Changes
+
+- 8ce48b8: Fix `KdsAccordion` items spacing.
+  - @knime/kds-styles@0.29.0
+
 ## 0.28.10
 
 ### Patch Changes