@progress/kendo-angular-toolbar 25.4.0-develop.2 → 25.4.0-develop.3

package/fesm2022/progress-kendo-angular-toolbar.mjs

@@ -26,8 +26,8 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1791978902,
-    version: '25.4.0-develop.2',
+    publishDate: 1792066342,
+    version: '25.4.0-develop.3',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
@@ -5674,7 +5674,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImpo
         }], ctorParameters: () => [{ type: i1.LocalizationService }] });
 
 /**
- * Arguments for the `dragStart` event of the FloatingToolBar.
+ * Specifies the arguments for the `dragStart` event of the FloatingToolBar.
  */
 class FloatingToolBarDragStartEvent extends PreventableEvent {
     sender;
@@ -5694,7 +5694,7 @@ class FloatingToolBarDragStartEvent extends PreventableEvent {
     }
 }
 /**
- * Arguments for the `move` event of the FloatingToolBar.
+ * Specifies the arguments for the `move` event of the FloatingToolBar.
  */
 class FloatingToolBarMoveEvent {
     sender;
@@ -5707,7 +5707,7 @@ class FloatingToolBarMoveEvent {
     }
 }
 /**
- * Arguments for the `dragEnd` event of the FloatingToolBar.
+ * Specifies the arguments for the `dragEnd` event of the FloatingToolBar.
  */
 class FloatingToolBarDragEndEvent {
     sender;
@@ -5849,6 +5849,17 @@ const resolvePopupPosition = (options) => {
  *      <kendo-toolbar-button text="Button"></kendo-toolbar-button>
  * </kendo-floatingtoolbar>
  * ```
+ *
+ * @remarks
+ * Supported children components are:
+ * {@link ToolBarButtonComponent},
+ * {@link ToolBarButtonGroupComponent},
+ * {@link ToolBarDropDownButtonComponent},
+ * {@link ToolBarSplitButtonComponent},
+ * {@link ToolBarSeparatorComponent},
+ * {@link ToolBarSpacerComponent},
+ * {@link ToolBarToolComponent},
+ * {@link FloatingToolBarCustomMessagesComponent}
  */
 class FloatingToolBarComponent {
     hostElement;
@@ -5865,6 +5876,7 @@ class FloatingToolBarComponent {
     /**
      * Sets the element the FloatingToolBar is positioned against. When not set, the component
      * is positioned within its containing element based on the `containerAlign` option.
+     * Setting a different anchor resets the position set by dragging.
      */
     set anchor(value) {
         if (resolveAnchorElement(this._anchor()) === resolveAnchorElement(value)) {
@@ -5933,12 +5945,13 @@ class FloatingToolBarComponent {
     set fillMode(value) { this._fillMode.set(value); }
     get fillMode() { return this._fillMode(); }
     /**
-     * Controls whether the user can reposition the FloatingToolBar with the pointer or the keyboard. When enabled, the
-    * component renders a drag handle before the hosted Toolbar.
-    *
-    * Press `M` while a Toolbar tool or the drag handle has focus to enter move mode. Focus moves
-    * to the drag handle, where you can use the arrow keys to move the FloatingToolBar by 10 pixels at a time.
-    * Press `Enter` or `Space`, or move focus away from the drag handle, to finish, or press `Escape` to restore the starting position.
+     * Controls whether the user can reposition the FloatingToolBar with the pointer or the keyboard.
+     * When enabled, the component renders a drag handle before the hosted ToolBar.
+     *
+     * Drag the handle with a pointer to reposition the FloatingToolBar.
+     * To use the keyboard, press `M` while a ToolBar tool or the drag handle has focus. Focus moves to the drag handle,
+     * where you can use the arrow keys to move the FloatingToolBar by 10 pixels at a time.
+     * Press `Enter` or `Space`, or move focus away from the drag handle, to finish the move. Press `Escape` to restore the starting position.
      *
      * @default false
      */
@@ -5961,10 +5974,12 @@ class FloatingToolBarComponent {
     dragStart = new EventEmitter();
     /**
      * Fires when the user moves the FloatingToolBar with the pointer or the keyboard.
+     * When a keyboard move is canceled, fires with the starting position.
      */
     move = new EventEmitter();
     /**
      * Fires when a pointer drag ends or the keyboard move mode is committed or canceled.
+     * Also fires when an active drag stops because `anchor` changes, `draggable` is set to `false`, or the component is destroyed.
      */
     dragEnd = new EventEmitter();
     /**
@@ -6063,7 +6078,7 @@ class FloatingToolBarComponent {
         this.subscriptions.unsubscribe();
     }
     /**
-     * Moves the focus into the FloatingToolBar at its current roving tabindex position.
+     * Moves the focus to the first focusable tool that is not in the overflow menu.
      */
     focus() {
         this.toolbarComponent?.element.nativeElement.focus();
@@ -6071,6 +6086,7 @@ class FloatingToolBarComponent {
     /**
      * Sets the FloatingToolBar position using the provided `top` and `left` coordinates.
      * The position is clamped to the viewport.
+     * Does not emit the `move` event.
      */
     setPosition(position) {
         const popupElement = this.popupComponent?.container.nativeElement;

package/index.d.ts

@@ -1634,7 +1634,7 @@ declare class ToolbarCustomMessagesComponent extends ToolbarMessages {
 }
 
 /**
- * Arguments for the `dragStart` event of the FloatingToolBar.
+ * Specifies the arguments for the `dragStart` event of the FloatingToolBar.
  */
 declare class FloatingToolBarDragStartEvent extends PreventableEvent {
     sender: FloatingToolBarComponent;
@@ -1647,7 +1647,7 @@ declare class FloatingToolBarDragStartEvent extends PreventableEvent {
     preventDefault(): void;
 }
 /**
- * Arguments for the `move` event of the FloatingToolBar.
+ * Specifies the arguments for the `move` event of the FloatingToolBar.
  */
 declare class FloatingToolBarMoveEvent {
     sender: FloatingToolBarComponent;
@@ -1656,7 +1656,7 @@ declare class FloatingToolBarMoveEvent {
     constructor(sender: FloatingToolBarComponent, top: number, left: number);
 }
 /**
- * Arguments for the `dragEnd` event of the FloatingToolBar.
+ * Specifies the arguments for the `dragEnd` event of the FloatingToolBar.
  */
 declare class FloatingToolBarDragEndEvent {
     sender: FloatingToolBarComponent;
@@ -1670,18 +1670,13 @@ declare class FloatingToolBarDragEndEvent {
  */
 type FloatingToolBarPosition = 'top' | 'bottom' | 'left' | 'right';
 /**
- * Sets how the FloatingToolBar renders tools when their total size is greater than the available width.
- *
- * @remarks
- * Narrower than the ToolBar's own `OverflowMode` — `'section'` is intentionally excluded. The shared
- * spec does not define a section-list overflow presentation for the FloatingToolBar.
+ * Specifies how the FloatingToolBar renders tools when their total size is greater than the available width.
+ * The `'section'` mode of the ToolBar is not available in the FloatingToolBar.
  */
 type FloatingToolBarOverflowMode = 'scroll' | 'menu' | 'none';
 /**
  * Configures the overflow behavior of the FloatingToolBar in detail.
- *
- * @remarks
- * Narrower than the ToolBar's own `ToolbarOverflowSettings` — `mode` cannot be set to `'section'`.
+ * Unlike the ToolBar, the `mode` property does not accept `'section'`.
  */
 type FloatingToolBarOverflowSettings = Omit<ToolbarOverflowSettings, 'mode'> & {
     mode?: FloatingToolBarOverflowMode;
@@ -1718,6 +1713,17 @@ interface PopupPosition {
  *      <kendo-toolbar-button text="Button"></kendo-toolbar-button>
  * </kendo-floatingtoolbar>
  * ```
+ *
+ * @remarks
+ * Supported children components are:
+ * {@link ToolBarButtonComponent},
+ * {@link ToolBarButtonGroupComponent},
+ * {@link ToolBarDropDownButtonComponent},
+ * {@link ToolBarSplitButtonComponent},
+ * {@link ToolBarSeparatorComponent},
+ * {@link ToolBarSpacerComponent},
+ * {@link ToolBarToolComponent},
+ * {@link FloatingToolBarCustomMessagesComponent}
  */
 declare class FloatingToolBarComponent implements OnInit, AfterViewInit, OnDestroy {
     private hostElement;
@@ -1733,6 +1739,7 @@ declare class FloatingToolBarComponent implements OnInit, AfterViewInit, OnDestr
     /**
      * Sets the element the FloatingToolBar is positioned against. When not set, the component
      * is positioned within its containing element based on the `containerAlign` option.
+     * Setting a different anchor resets the position set by dragging.
      */
     set anchor(value: ElementRef | HTMLElement);
     get anchor(): ElementRef | HTMLElement;
@@ -1788,12 +1795,13 @@ declare class FloatingToolBarComponent implements OnInit, AfterViewInit, OnDestr
     set fillMode(value: ToolbarFillMode);
     get fillMode(): ToolbarFillMode;
     /**
-     * Controls whether the user can reposition the FloatingToolBar with the pointer or the keyboard. When enabled, the
-    * component renders a drag handle before the hosted Toolbar.
-    *
-    * Press `M` while a Toolbar tool or the drag handle has focus to enter move mode. Focus moves
-    * to the drag handle, where you can use the arrow keys to move the FloatingToolBar by 10 pixels at a time.
-    * Press `Enter` or `Space`, or move focus away from the drag handle, to finish, or press `Escape` to restore the starting position.
+     * Controls whether the user can reposition the FloatingToolBar with the pointer or the keyboard.
+     * When enabled, the component renders a drag handle before the hosted ToolBar.
+     *
+     * Drag the handle with a pointer to reposition the FloatingToolBar.
+     * To use the keyboard, press `M` while a ToolBar tool or the drag handle has focus. Focus moves to the drag handle,
+     * where you can use the arrow keys to move the FloatingToolBar by 10 pixels at a time.
+     * Press `Enter` or `Space`, or move focus away from the drag handle, to finish the move. Press `Escape` to restore the starting position.
      *
      * @default false
      */
@@ -1811,10 +1819,12 @@ declare class FloatingToolBarComponent implements OnInit, AfterViewInit, OnDestr
     dragStart: EventEmitter<FloatingToolBarDragStartEvent>;
     /**
      * Fires when the user moves the FloatingToolBar with the pointer or the keyboard.
+     * When a keyboard move is canceled, fires with the starting position.
      */
     move: EventEmitter<FloatingToolBarMoveEvent>;
     /**
      * Fires when a pointer drag ends or the keyboard move mode is committed or canceled.
+     * Also fires when an active drag stops because `anchor` changes, `draggable` is set to `false`, or the component is destroyed.
      */
     dragEnd: EventEmitter<FloatingToolBarDragEndEvent>;
     /**
@@ -1858,12 +1868,13 @@ declare class FloatingToolBarComponent implements OnInit, AfterViewInit, OnDestr
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     /**
-     * Moves the focus into the FloatingToolBar at its current roving tabindex position.
+     * Moves the focus to the first focusable tool that is not in the overflow menu.
      */
     focus(): void;
     /**
      * Sets the FloatingToolBar position using the provided `top` and `left` coordinates.
      * The position is clamped to the viewport.
+     * Does not emit the `move` event.
      */
     setPosition(position: Offset): void;
     protected messageFor(key: string): string;

package/package-metadata.mjs

@@ -7,7 +7,7 @@ export const packageMetadata = {
   "productCodes": [
     "KENDOUIANGULAR"
   ],
-  "publishDate": 1791978902,
-  "version": "25.4.0-develop.2",
+  "publishDate": 1792066342,
+  "version": "25.4.0-develop.3",
   "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-toolbar",
-  "version": "25.4.0-develop.2",
+  "version": "25.4.0-develop.3",
   "description": "Kendo UI Angular Toolbar component - a single UI element that organizes buttons and other navigation elements",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -43,7 +43,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1791978902,
+      "publishDate": 1792066342,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -53,17 +53,17 @@
     "@angular/core": "20 - 22",
     "@angular/platform-browser": "20 - 22",
     "@progress/kendo-licensing": "^1.11.0",
-    "@progress/kendo-angular-buttons": "25.4.0-develop.2",
-    "@progress/kendo-angular-common": "25.4.0-develop.2",
-    "@progress/kendo-angular-l10n": "25.4.0-develop.2",
-    "@progress/kendo-angular-icons": "25.4.0-develop.2",
-    "@progress/kendo-angular-indicators": "25.4.0-develop.2",
-    "@progress/kendo-angular-popup": "25.4.0-develop.2",
+    "@progress/kendo-angular-buttons": "25.4.0-develop.3",
+    "@progress/kendo-angular-common": "25.4.0-develop.3",
+    "@progress/kendo-angular-l10n": "25.4.0-develop.3",
+    "@progress/kendo-angular-icons": "25.4.0-develop.3",
+    "@progress/kendo-angular-indicators": "25.4.0-develop.3",
+    "@progress/kendo-angular-popup": "25.4.0-develop.3",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "25.4.0-develop.2"
+    "@progress/kendo-angular-schematics": "25.4.0-develop.3"
   },
   "schematics": "./schematics/collection.json",
   "module": "fesm2022/progress-kendo-angular-toolbar.mjs",