forty-cdk 0.3.0 → 0.4.0

package/listbox/README.md

@@ -153,6 +153,30 @@ Drag an option past a small threshold to reorder; a short press without movement
 | `[forListboxReorder]` | `data-dragging` | present \| absent | On the container while any drag (pointer or keyboard) is in flight. |
 | `[forListboxOption]`  | `data-dragging` | present \| absent | On the lifted option for the duration of the drag.                  |
 
+### Localizing reorder announcements
+
+While a reorder is in flight, `[forListboxReorder]` announces lift / move / drop / cancel through an off-screen live region. The phrasing is English by default; override it per injector scope with `provideForListboxDefaults` so screen readers speak the consumer's language. `index` / `total` are 1-based.
+
+```ts
+import { provideForListboxDefaults } from 'forty-cdk/listbox';
+
+provideForListboxDefaults({
+  reorderAnnounceLift: (label, index, total) => `${label} levantado. ${index} de ${total}.`,
+  reorderAnnounceMove: (label, index, total) =>
+    `${label} movido a la posición ${index} de ${total}.`,
+  reorderAnnounceDrop: (label, index, total) =>
+    `${label} soltado en la posición ${index} de ${total}.`,
+  reorderAnnounceCancel: (label) => `Movimiento de ${label} cancelado.`,
+});
+```
+
+| Default                 | Type                                                      | Description                                     |
+| ----------------------- | --------------------------------------------------------- | ----------------------------------------------- |
+| `reorderAnnounceLift`   | `(label: string, index: number, total: number) => string` | Announced when an option is lifted for reorder. |
+| `reorderAnnounceMove`   | `(label: string, index: number, total: number) => string` | Announced when the drop position changes.       |
+| `reorderAnnounceDrop`   | `(label: string, index: number, total: number) => string` | Announced on a committed drop.                  |
+| `reorderAnnounceCancel` | `(label: string) => string`                               | Announced when the reorder is cancelled.        |
+
 ## Object values
 
 Real apps usually have richer option models — `{ id, name, ... }` — where the comparison key differs from what you'd serialize for a form. `[forListbox]` is generic over `T` to support that without forcing the consumer to stringify and re-hydrate.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forty-cdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Headless / styleless UI primitives for Angular with WAI-ARIA accessibility built in.",
   "keywords": [
     "angular",

package/tree/README.md

@@ -706,3 +706,30 @@ Pair it with the root's `--for-tree-drop-level` (the resolved depth) to indent t
 Advanced consumers can read the same resolved position programmatically: `[forTreeNodeDrag]` exposes a read-only `dropIndicator: Signal<ForTreeDropIndicator | null>` on `ForTreeNodeDragContext` (`{ anchor, position, level }`, `null` when idle).
 
 On lift the dragged node's subtree is collapsed (and restored on drop / cancel). This keeps the drop geometry tractable and structurally prevents dropping a node into its own descendant; `[canDrop]` adds consumer-defined vetoes on top.
+
+### Localizing drag announcements
+
+While a drag is in flight, `[forTreeNodeDrag]` announces lift / move / drop / cancel / invalid-drop through an off-screen live region. The phrasing is English by default; override it per injector scope with `provideForTreeDefaults` so screen readers speak the consumer's language. `position` / `total` are 1-based, and `parentLabel` is `null` when the node lands at the root — phrase the root-vs-parent distinction in your own language.
+
+```ts
+import { provideForTreeDefaults } from 'forty-cdk/tree';
+
+provideForTreeDefaults({
+  dragAnnounceLift: (label) =>
+    `${label} levantado. Usa las flechas para mover, Espacio para soltar, Escape para cancelar.`,
+  dragAnnounceMove: (label, parentLabel, position, total) =>
+    `${label}: ${parentLabel ? `dentro de ${parentLabel}, ` : 'en la raíz, '}posición ${position} de ${total}.`,
+  dragAnnounceDrop: (label, parentLabel, position, total) =>
+    `${label} soltado ${parentLabel ? `dentro de ${parentLabel}, ` : 'en la raíz, '}posición ${position} de ${total}.`,
+  dragAnnounceCancel: (label) => `Cancelado. ${label} vuelve a su posición original.`,
+  dragAnnounceInvalid: (label) => `No se puede soltar ${label} aquí.`,
+});
+```
+
+| Default               | Type                                                                                      | Description                                                        |
+| --------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| `dragAnnounceLift`    | `(label: string) => string`                                                               | Announced when a node is picked up for drag.                       |
+| `dragAnnounceMove`    | `(label: string, parentLabel: string \| null, position: number, total: number) => string` | Announced on each intermediate move while a node is lifted.        |
+| `dragAnnounceDrop`    | `(label: string, parentLabel: string \| null, position: number, total: number) => string` | Announced when a node is committed to its new position.            |
+| `dragAnnounceCancel`  | `(label: string) => string`                                                               | Announced when a lift is cancelled and the node returns to origin. |
+| `dragAnnounceInvalid` | `(label: string) => string`                                                               | Announced when a `canDrop` veto rejects the attempted drop.        |

package/types/forty-cdk-checkbox.d.ts

@@ -61,7 +61,7 @@ declare class ForCheckbox extends FormUiControlBase implements FormCheckboxContr
      * `'indeterminate'`. Exposed so `ForCheckboxIndicator` can mirror it without
      * re-deriving the same mapping.
      */
-    readonly dataState: _angular_core.Signal<"checked" | "indeterminate" | "unchecked">;
+    readonly dataState: _angular_core.Signal<"checked" | "unchecked" | "indeterminate">;
     constructor();
     protected onClick(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ForCheckbox, never>;

package/types/forty-cdk-combobox.d.ts

@@ -902,7 +902,7 @@ declare class ForComboboxOption<T = string> {
     /** True when this option is the current activedescendant. Reflected as `data-highlighted`. */
     readonly highlighted: _angular_core.Signal<boolean>;
     readonly effectiveDisabled: _angular_core.Signal<boolean>;
-    protected readonly ariaSelected: _angular_core.Signal<"true" | "false">;
+    protected readonly ariaSelected: _angular_core.Signal<"false" | "true">;
     /** Reflects `aria-posinset` (1-based) when virtualizing. Falls back to DOM order otherwise. */
     protected readonly ariaPosInSet: _angular_core.Signal<string | null>;
     /** Reflects `aria-setsize` when the consumer wires up `[totalCount]`. */

package/types/forty-cdk-core.d.ts

@@ -1497,6 +1497,32 @@ interface PlayFlipConfig {
  */
 declare function playFlip(config: PlayFlipConfig): void;
 
+/**
+ * Per-directive pointer drag-start guard shared by `ForDraggable` and
+ * `ForFreeDrag`: tracks `[forDragHandle]` elements, decides whether a
+ * `pointerdown` may begin a drag (left mouse button only; if any handle is
+ * registered the press must originate inside one), and derives the
+ * `touch-action` style that suppresses native scrolling on a handle-less host.
+ */
+interface PointerHandleGuard {
+    /** `'none'` while the host should suppress native touch scrolling, else `null`. */
+    readonly touchAction: Signal<'none' | null>;
+    /** Register a `[forDragHandle]` element. */
+    register(el: HTMLElement): void;
+    /** Unregister a previously registered handle element. */
+    unregister(el: HTMLElement): void;
+    /** Whether a `pointerdown` event is allowed to start a drag. */
+    canStart(event: PointerEvent): boolean;
+}
+/**
+ * Builds a {@link PointerHandleGuard}. Call from a directive's injection
+ * context (field initializer or constructor) so `touchAction`'s `computed`
+ * registers correctly.
+ *
+ * @param disabled Signal reporting whether dragging is currently disabled.
+ */
+declare function createPointerHandleGuard(disabled: Signal<boolean>): PointerHandleGuard;
+
 /**
  * Shared keyboard resolvers for container-level drag-reorder coordinators
  * (`ForTreeNodeDrag`, `ForListboxReorder`). Framework-free and unit-testable in
@@ -5770,5 +5796,5 @@ interface WindowReorderResult {
  */
 declare function translateWindowReorder(windowIndices: readonly number[], previousIndex: number, currentIndex: number): WindowReorderResult;
 
-export { ANCHORED_POSITIONING_DEFAULTS, BodyScrollLock, CloseReasonState, Collection, DEFAULT_POINTER_SUPPRESSION_MS, DRAG_DEAD_ZONE_PX, DismissableLayer, DismissableLayerStack, FLIP_ANIMATING_ATTR, FOR_DATE_ADAPTER, FOR_FIELDSET_CONTEXT, FOR_FIELD_CONTEXT, FOR_HOST_ROVING_CONTEXT, FOR_ID_SALT, FOR_MENU_CONTEXT, FOR_TIME_VALUE_SOURCE, ForDateTimeLiteralBase, ForDateTimeSegmentBase, ForDrawerScaleCoordinator, ForDrawerStack, ForVisuallyHidden, FormUiControlBase, IdGenerator, InertSiblingsStack, InitialFocusState, ListboxOverlayController, LiveAnnouncer, MENU_POSITIONING_DEFAULTS, MODAL_PEER_ATTRIBUTE, MenuItemList, MenuOverlay, MenuOverlayHost, OverlayContextInjector, OverlayManagerCore, OverlayRef, PreviewController, RovingTabindex, SegmentEditor, SelectionModel, SkipDelayCoordinator, TextValueControlBase, Typeahead, VISUALLY_HIDDEN_STYLE, VirtualizedNavigator, adoptHostId, assertTimeCapable, attachPointerGrace, attachSwipeDismiss, buildDragSlots, buildSubmenuGracePolygon, clamp, clampPreviewPosition, clampToBounds, clampToRange, compareDateOf, composeWithTime, computeFlatHierarchy, computeScrollVelocity, createAutoScroller, createDebouncedAction, createDefaults, createDragPreview, createHoverIntent, createKeyboardDragMediator, createMenuItemList, createMenuOverlay, createPointerDragSession, createPointerSuppression, createTemplatePreview, createVetoableEvent, createVetoableNativeEvent, dayPeriodNames, defaultItemToFormValue, emitVetoableEvent, emitVetoableNativeEvent, fencePlaceholderIndex, findScrollContainer, findTypeaheadMatch, firstEnabledHost, flipDelta, foldSnapshotOnTotalCountTransition, forceCloseWhenDisabled, from12, gapFromPointerY, hostId, indexOfSlot, injectDateAdapter, injectDismissableLayer, injectElementSize, injectFieldWiring, injectFloating, injectFocusVisible, injectHasFocusableContent, injectHiddenInput, injectHovered, injectMediaQuery, injectMenuContext, injectModalShell, injectOverlayShell, injectPauseController, injectPortal, injectPrefersReducedMotion, injectPressed, injectTextDirection, injectTypeahead, isDragLiftKey, isInArray, isPointInPolygon, isRequiredInputUnset, isScrollableAtEdge, levelFromPointerX, localeSeparators, mirrorUnfocusedValue, moveGridIndex, moveIndex, nextEnabledHandle, parseLocaleNumber, placeholderInsertion, playFlip, provideForIdSalt, tryReadHandle as readEntryGuarded, reconcileRovingActive, reflectDisabled, registerA11yDescription, registerA11yName, registerCollectionHandle, registerHandle, resolveConfigClass, resolveDropIndicator, resolveDropTarget, resolveGraceSide, resolveGridNavigation, resolveHostId, resolveHourCycle, resolveLiftedDragControl, resolveListNavigation, resolveSnapTarget, resolveTreeDrop, resolveTreeExpandCollapse, resolveTreegridExpandCollapse, roundToStepPrecision, secondsOfDay, serializeISODate, serializeISOTime, singleSelected, snapToStep, startPointerResize, stepSlot, timeSentinel, to12, toFloatingPositioner, toggleInArray, translateWindowReorder, tryReadHandle, wrapPreview };
-export type { A11yDescriptionOwner, A11yLabelOwner, AnchoredPositioningContext, AutoScrollVelocity, AutoScroller, AutoScrollerConfig, CollectionHandle, DateAdapter, DateSegmentType, DateSerializeGranularity, DebouncedAction, DisableableHandle, DismissableLayerActivateOptions, DragPreview, DragRect, DragSlot, DrawerStackHandle, DrawerStackNode, DropContainerGeometry, DropTarget, EditableSpec, ElementBox, ExpandCollapseAction, FieldControlHandle, FieldSegment, FieldSpec, FlipDelta, FlipRect, FloatingAlign, FloatingConfig, FloatingSide, ForDrawerScaleConfig, ForDrawerSide, ForFieldContext, ForFieldsetContext, ForMenuCloseReason, ForMenuContext, ForMenuItemHandle, ForceCloseWhenDisabledOptions, GraceRect, GridNavigationAction, GridNavigationOptions, HiddenInputConfig, HostRovingContext, HostRovingItemHandle, HoverIntentCoordinator, HoverIntentOptions, HoverIntentScheduler, HoveredOptions, InertSiblingsHandle, KeyboardDragMediatorConfig, ListNavigationAction, ListNavigationOptions, ListOrientation, ListboxOverlayControllerDeps, ListboxOverlayEmitTargets, ListboxOverlayOptionHandle, LiteralSpec, LocaleSeparators, MenuActivationModality, MenuItemHandle, MenuOverlayCloseReason, MenuOverlayHooks, MenuOverlayItemHandle, MenuSiblingNavigator, ModalShellConfig, ModalShellDismissConfig, ModalShellHandle, ModalShellInitialFocusConfig, MoveGridIndexOptions, MoveIndexOptions, NextEnabledHandleOptions, OverlayManagerConfig, OverlayManagerEntry, OverlayManagerOutlet, OverlayManagerOutletHost, OverlayShellConfig, OverlayShellDismissConfig, OverlayShellInitialFocusConfig, OverlayShellInitialFocusMove, OverlayShellPositionerConfig, OverlayShellReturnFocusConfig, PauseController, PauseControllerOptions, PlaceholderInsertion, PlayFlipConfig, Point, PointerDragSession, PointerDragSessionOptions, PointerResizeConfig, PointerSuppression, Polygon, PortalConfig, PressedOptions, PreviewControllerOptions, PreviewPoint, PreviewSize, RegistrationScheduling, ResolveSnapTargetOptions, SegmentEditorContext, SegmentEditorHost, SegmentHandle, SegmentParts, SegmentType, SelectionModelOptions, SkipDelayCoordinatorDefaults, SnapResolution, SwipeDirection, SwipeDismissOptions, SwipeEventDetail, TimeCapableDateAdapter, TimeSegmentType, TimeSerializeGranularity, TimeValueSource, TreeDropIndicator, TreeDropRow, TreeDropTarget, TreeExpandCollapseOptions, TypeaheadMatchQuery, TypeaheadOptions, VetoableEvent, VetoableNativeEvent, VirtualizedNavigatorAccessors, VirtualizedNavigatorDeps, VirtualizedNavigatorEntry, VirtualizedNavigatorOptions, WindowReorderResult, WritingDirection };
+export { ANCHORED_POSITIONING_DEFAULTS, BodyScrollLock, CloseReasonState, Collection, DEFAULT_POINTER_SUPPRESSION_MS, DRAG_DEAD_ZONE_PX, DismissableLayer, DismissableLayerStack, FLIP_ANIMATING_ATTR, FOR_DATE_ADAPTER, FOR_FIELDSET_CONTEXT, FOR_FIELD_CONTEXT, FOR_HOST_ROVING_CONTEXT, FOR_ID_SALT, FOR_MENU_CONTEXT, FOR_TIME_VALUE_SOURCE, ForDateTimeLiteralBase, ForDateTimeSegmentBase, ForDrawerScaleCoordinator, ForDrawerStack, ForVisuallyHidden, FormUiControlBase, IdGenerator, InertSiblingsStack, InitialFocusState, ListboxOverlayController, LiveAnnouncer, MENU_POSITIONING_DEFAULTS, MODAL_PEER_ATTRIBUTE, MenuItemList, MenuOverlay, MenuOverlayHost, OverlayContextInjector, OverlayManagerCore, OverlayRef, PreviewController, RovingTabindex, SegmentEditor, SelectionModel, SkipDelayCoordinator, TextValueControlBase, Typeahead, VISUALLY_HIDDEN_STYLE, VirtualizedNavigator, adoptHostId, assertTimeCapable, attachPointerGrace, attachSwipeDismiss, buildDragSlots, buildSubmenuGracePolygon, clamp, clampPreviewPosition, clampToBounds, clampToRange, compareDateOf, composeWithTime, computeFlatHierarchy, computeScrollVelocity, createAutoScroller, createDebouncedAction, createDefaults, createDragPreview, createHoverIntent, createKeyboardDragMediator, createMenuItemList, createMenuOverlay, createPointerDragSession, createPointerHandleGuard, createPointerSuppression, createTemplatePreview, createVetoableEvent, createVetoableNativeEvent, dayPeriodNames, defaultItemToFormValue, emitVetoableEvent, emitVetoableNativeEvent, fencePlaceholderIndex, findScrollContainer, findTypeaheadMatch, firstEnabledHost, flipDelta, foldSnapshotOnTotalCountTransition, forceCloseWhenDisabled, from12, gapFromPointerY, hostId, indexOfSlot, injectDateAdapter, injectDismissableLayer, injectElementSize, injectFieldWiring, injectFloating, injectFocusVisible, injectHasFocusableContent, injectHiddenInput, injectHovered, injectMediaQuery, injectMenuContext, injectModalShell, injectOverlayShell, injectPauseController, injectPortal, injectPrefersReducedMotion, injectPressed, injectTextDirection, injectTypeahead, isDragLiftKey, isInArray, isPointInPolygon, isRequiredInputUnset, isScrollableAtEdge, levelFromPointerX, localeSeparators, mirrorUnfocusedValue, moveGridIndex, moveIndex, nextEnabledHandle, parseLocaleNumber, placeholderInsertion, playFlip, provideForIdSalt, tryReadHandle as readEntryGuarded, reconcileRovingActive, reflectDisabled, registerA11yDescription, registerA11yName, registerCollectionHandle, registerHandle, resolveConfigClass, resolveDropIndicator, resolveDropTarget, resolveGraceSide, resolveGridNavigation, resolveHostId, resolveHourCycle, resolveLiftedDragControl, resolveListNavigation, resolveSnapTarget, resolveTreeDrop, resolveTreeExpandCollapse, resolveTreegridExpandCollapse, roundToStepPrecision, secondsOfDay, serializeISODate, serializeISOTime, singleSelected, snapToStep, startPointerResize, stepSlot, timeSentinel, to12, toFloatingPositioner, toggleInArray, translateWindowReorder, tryReadHandle, wrapPreview };
+export type { A11yDescriptionOwner, A11yLabelOwner, AnchoredPositioningContext, AutoScrollVelocity, AutoScroller, AutoScrollerConfig, CollectionHandle, DateAdapter, DateSegmentType, DateSerializeGranularity, DebouncedAction, DisableableHandle, DismissableLayerActivateOptions, DragPreview, DragRect, DragSlot, DrawerStackHandle, DrawerStackNode, DropContainerGeometry, DropTarget, EditableSpec, ElementBox, ExpandCollapseAction, FieldControlHandle, FieldSegment, FieldSpec, FlipDelta, FlipRect, FloatingAlign, FloatingConfig, FloatingSide, ForDrawerScaleConfig, ForDrawerSide, ForFieldContext, ForFieldsetContext, ForMenuCloseReason, ForMenuContext, ForMenuItemHandle, ForceCloseWhenDisabledOptions, GraceRect, GridNavigationAction, GridNavigationOptions, HiddenInputConfig, HostRovingContext, HostRovingItemHandle, HoverIntentCoordinator, HoverIntentOptions, HoverIntentScheduler, HoveredOptions, InertSiblingsHandle, KeyboardDragMediatorConfig, ListNavigationAction, ListNavigationOptions, ListOrientation, ListboxOverlayControllerDeps, ListboxOverlayEmitTargets, ListboxOverlayOptionHandle, LiteralSpec, LocaleSeparators, MenuActivationModality, MenuItemHandle, MenuOverlayCloseReason, MenuOverlayHooks, MenuOverlayItemHandle, MenuSiblingNavigator, ModalShellConfig, ModalShellDismissConfig, ModalShellHandle, ModalShellInitialFocusConfig, MoveGridIndexOptions, MoveIndexOptions, NextEnabledHandleOptions, OverlayManagerConfig, OverlayManagerEntry, OverlayManagerOutlet, OverlayManagerOutletHost, OverlayShellConfig, OverlayShellDismissConfig, OverlayShellInitialFocusConfig, OverlayShellInitialFocusMove, OverlayShellPositionerConfig, OverlayShellReturnFocusConfig, PauseController, PauseControllerOptions, PlaceholderInsertion, PlayFlipConfig, Point, PointerDragSession, PointerDragSessionOptions, PointerHandleGuard, PointerResizeConfig, PointerSuppression, Polygon, PortalConfig, PressedOptions, PreviewControllerOptions, PreviewPoint, PreviewSize, RegistrationScheduling, ResolveSnapTargetOptions, SegmentEditorContext, SegmentEditorHost, SegmentHandle, SegmentParts, SegmentType, SelectionModelOptions, SkipDelayCoordinatorDefaults, SnapResolution, SwipeDirection, SwipeDismissOptions, SwipeEventDetail, TimeCapableDateAdapter, TimeSegmentType, TimeSerializeGranularity, TimeValueSource, TreeDropIndicator, TreeDropRow, TreeDropTarget, TreeExpandCollapseOptions, TypeaheadMatchQuery, TypeaheadOptions, VetoableEvent, VetoableNativeEvent, VirtualizedNavigatorAccessors, VirtualizedNavigatorDeps, VirtualizedNavigatorEntry, VirtualizedNavigatorOptions, WindowReorderResult, WritingDirection };

package/types/forty-cdk-listbox.d.ts

@@ -465,6 +465,26 @@ interface ForListboxDefaults {
      * focus.
      */
     selectionFollowsFocus: boolean;
+    /**
+     * `[forListboxReorder]` announcement when an option is lifted for reorder.
+     * `index` and `total` are 1-based. Override to localize.
+     */
+    reorderAnnounceLift: (label: string, index: number, total: number) => string;
+    /**
+     * `[forListboxReorder]` announcement when the reorder drop position changes.
+     * `index` and `total` are 1-based. Override to localize.
+     */
+    reorderAnnounceMove: (label: string, index: number, total: number) => string;
+    /**
+     * `[forListboxReorder]` announcement on a committed reorder drop. `index` and
+     * `total` are 1-based. Override to localize.
+     */
+    reorderAnnounceDrop: (label: string, index: number, total: number) => string;
+    /**
+     * `[forListboxReorder]` announcement when a reorder is cancelled. Override to
+     * localize.
+     */
+    reorderAnnounceCancel: (label: string) => string;
 }
 /** Token holding the resolved listbox defaults for the current scope. */
 declare const FOR_LISTBOX_DEFAULTS: _angular_core.InjectionToken<ForListboxDefaults>;

package/types/forty-cdk-table.d.ts

@@ -1,7 +1,7 @@
 import * as forty_cdk_core from 'forty-cdk/core';
 import { WritingDirection } from 'forty-cdk/core';
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Signal, Provider } from '@angular/core';
+import { InjectionToken, Signal, ElementRef, Provider } from '@angular/core';
 import * as forty_cdk_table from 'forty-cdk/table';
 import * as i1 from 'forty-cdk/drag-drop';
 
@@ -371,6 +371,13 @@ declare class ForTableRow implements ForTableRowContext {
  */
 declare class ForTableHeaderCell {
     protected readonly ctx: forty_cdk_table.ForTableContext;
+    /**
+     * The header cell's host element (`role="columnheader"`). Exposed so a descendant
+     * `[forTableColumnResizer]` can resolve the enclosing cell through DI to measure its
+     * base width — robust to `hostDirectives` composition, where the `[forTableHeaderCell]`
+     * selector attribute is not reflected onto the wrapper's host element.
+     */
+    readonly el: ElementRef<HTMLElement>;
     /** Column identifier, reflected as `data-column`. Required by later phases (sort, resize, reorder). */
     readonly name: _angular_core.InputSignal<string>;
     /**

package/types/forty-cdk-tree.d.ts

@@ -504,6 +504,34 @@ interface ForTreeDefaults {
      * unless the UX truly benefits from selection following focus.
      */
     selectionFollowsFocus: boolean;
+    /**
+     * `[forTreeNodeDrag]` announcement when a node is picked up for drag
+     * (assertive). Override to localize.
+     */
+    dragAnnounceLift: (label: string) => string;
+    /**
+     * `[forTreeNodeDrag]` announcement on each intermediate move while a node is
+     * lifted (polite). `position` / `total` are 1-based; `parentLabel` is `null`
+     * at the root, so the consumer phrases the root-vs-parent distinction in
+     * their own language. Override to localize.
+     */
+    dragAnnounceMove: (label: string, parentLabel: string | null, position: number, total: number) => string;
+    /**
+     * `[forTreeNodeDrag]` announcement when a node is committed to its new
+     * position (assertive). `position` / `total` are 1-based; `parentLabel` is
+     * `null` at the root. Override to localize.
+     */
+    dragAnnounceDrop: (label: string, parentLabel: string | null, position: number, total: number) => string;
+    /**
+     * `[forTreeNodeDrag]` announcement when a lift is cancelled and the node
+     * returns to its origin (assertive). Override to localize.
+     */
+    dragAnnounceCancel: (label: string) => string;
+    /**
+     * `[forTreeNodeDrag]` announcement when a `canDrop` veto rejects the
+     * attempted drop (assertive). Override to localize.
+     */
+    dragAnnounceInvalid: (label: string) => string;
 }
 /** Token holding the resolved tree defaults for the current scope. */
 declare const FOR_TREE_DEFAULTS: _angular_core.InjectionToken<ForTreeDefaults>;