ngx-kit 9.2.1 → 9.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-kit",
-  "version": "9.2.1",
+  "version": "9.2.3",
   "description": "Angular input components",
   "author": "Mohammadreza Samani <mr.samani1368@gmail.com>",
   "license": "MIT",

package/types/ngx-kit-drag-resize.d.ts

@@ -81,6 +81,8 @@ declare class DropListRef<T = any> {
     parentList: DropListRef<any> | null;
     readonly childLists: Set<DropListRef<any>>;
     private session;
+    /** Main axis of this list: the measured one while sorting, else a CSS-based guess. */
+    getAxis(): 'x' | 'y' | 'grid';
     private placeholder?;
     customPlaceholder?: PlaceHolderRef;
     private activeDrag;
@@ -306,6 +308,15 @@ declare class DragRef<T = unknown> {
     pointerDown(pointer: IPosition): void;
     startDrag(pointer: IPosition): void;
     dragMove(pointer: IPosition): void;
+    /**
+     * Keyboard sorting for list items: jump by whole SLOTS instead of pixels (an 8px step can
+     * never cross the centre of a 190px card), and hop to the neighbouring connected list when the
+     * edge of the current one is reached — Left/Right between kanban columns, Up/Down between
+     * the sections of a column. Returns `false` for free drags (use `nudge`).
+     */
+    nudgeToSlot(direction: 'up' | 'down' | 'left' | 'right'): boolean;
+    private neighbourSlot;
+    private neighbourList;
     nudge(dx: number, dy: number): void;
     endDrag(): void;
     cancelDrag(): void;
@@ -518,7 +529,12 @@ declare class NgxResizable implements OnDestroy {
     private beforeTransition;
     private beforeWidth;
     private beforeHeight;
-    private beforeTransform;
+    private beforeTranslate;
+    private baseComputedTranslate;
+    private keyboardBaseTranslate;
+    private keyboardBaseInlineTranslate;
+    private startMatrix;
+    private pointerInverse;
     private pointerId;
     private startWidth;
     private startHeight;
@@ -527,23 +543,29 @@ declare class NgxResizable implements OnDestroy {
     constructor(el: ElementRef<HTMLElement>);
     ngOnDestroy(): void;
     onPointerDown(e: PointerEvent): void;
-    onPointerMove(e: PointerEvent): void;
-    onPointerUp(e: PointerEvent): void;
-    onDocumentKeyDown(e: KeyboardEvent): void;
+    /** Entry point used by the typed NgxResizeHandle directive. */
+    beginResize(e: PointerEvent, direction: LogicalResizeDirection): void;
+    private onPointerMove;
+    private onPointerUp;
+    private onDocumentKeyDown;
     private onPointerCancel;
     private restoreBeforeResize;
+    /**
+     * Keyboard resizing respects the configured directions.
+     * The arrow keys move the active physical edge:
+     * - if only west is enabled, horizontal keys operate on west;
+     * - if only east is enabled, horizontal keys operate on east;
+     * - north/south follow the same rule vertically.
+     * Disabled axes are never modified.
+     */
     onHandleKeyDown(e: KeyboardEvent): void;
+    private chooseAxisEdge;
+    private keyboardDirection;
+    private isEditableTarget;
     private calculate;
     private apply;
-    /**
-     * `offsetWidth/Height` (what we measure and report) are BORDER-box sizes. The inline
-     * `width/height` we write are interpreted according to `box-sizing`: for the CSS default
-     * (`content-box`) writing the border-box number would make a padded/bordered block jump by
-     * its padding+border the instant a resize starts. Convert so the box is exactly the size
-     * reported in `IResizableOutput`.
-     */
     private toStyleSize;
-    private clampGrid;
+    private clampSize;
     private finish;
     private resolvedDirections;
     private hitDirection;
@@ -628,6 +650,18 @@ declare class NgxDragPreview {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgxDragPreview, "[ngxDragPreview]", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Typed handle API. Prefer ngxResizeHandle="se" in templates; the legacy
+ * data-ngx-resize-handle attribute remains available for backwards compatibility.
+ */
+declare class NgxResizeHandle {
+    readonly ngxResizeHandle: _angular_core.InputSignal<LogicalResizeDirection>;
+    private readonly parent;
+    onPointerDown(event: PointerEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxResizeHandle, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgxResizeHandle, "[ngxResizeHandle]", never, { "ngxResizeHandle": { "alias": "ngxResizeHandle"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * True when `element` sits inside a right-to-left context.
  *
@@ -674,7 +708,9 @@ declare function adjustForZoom(value: number, element?: HTMLElement): number;
  */
 declare class AutoScroller {
     private raf;
-    private container;
+    /** Nearest scroller per axis: a kanban column scrolls vertically while its BOARD scrolls horizontally. */
+    private containerX;
+    private containerY;
     private win?;
     /** Document the pointer coordinates (`update(x, y)`) are expressed in. */
     private pointerDoc?;
@@ -689,10 +725,15 @@ declare class AutoScroller {
     /** فقط container را عوض می‌کند بدون قطع حلقه‌ی در حال اجرا یا صفر کردن speed. */
     retarget(fromEl: HTMLElement): void;
     update(clientX: number, clientY: number): void;
+    private axisSpeed;
     stop(): void;
+    /** Scrolls one container by a speed measured in viewport pixels (carrying sub-pixel remainders). */
+    private scrollContainer;
     private tick;
 }
 declare function findScrollableAncestor(el: HTMLElement): HTMLElement | Window;
+/** Nearest ancestor that can scroll along ONE axis (`<html>`/`<body>` resolve to the window). */
+declare function findScrollableAncestorForAxis(el: HTMLElement, axis: 'x' | 'y'): HTMLElement | Window;
 declare function getScrollPosition(container: HTMLElement | Window): {
     left: number;
     top: number;
@@ -732,5 +773,5 @@ declare function stripEditorArtifacts(root: Element, options?: StripOptions): vo
 /** Serialised, editor-free HTML of `el`'s children (the canvas content). */
 declare function getCleanHtml(el: Element, options?: StripOptions): string;
 
-export { AutoScroller, DragDropService, DragRef, DropListGroupRef, DropListRef, NGX_DRAGGABLE, NGX_DRAG_PREVIEW, NGX_DROPLIST, NGX_DROPLIST_GROUP, NGX_PLACEHOLDER, NgxDragPreview, NgxDraggable, NgxDropList, NgxDropListGroup, NgxPlaceholder, NgxResizable, PlaceHolderRef, adjustForZoom, checkBoundX, checkBoundY, clampResizeWithinBoundary, copyArrayItem, findScrollableAncestor, getCleanHtml, getPageZoom, getScrollPosition, isRtl, moveItemInArray, resolveLogicalDirection, stripEditorArtifacts, transferArrayItem };
+export { AutoScroller, DragDropService, DragRef, DropListGroupRef, DropListRef, NGX_DRAGGABLE, NGX_DRAG_PREVIEW, NGX_DROPLIST, NGX_DROPLIST_GROUP, NGX_PLACEHOLDER, NgxDragPreview, NgxDraggable, NgxDropList, NgxDropListGroup, NgxPlaceholder, NgxResizable, NgxResizeHandle, PlaceHolderRef, adjustForZoom, checkBoundX, checkBoundY, clampResizeWithinBoundary, copyArrayItem, findScrollableAncestor, findScrollableAncestorForAxis, getCleanHtml, getPageZoom, getScrollPosition, isRtl, moveItemInArray, resolveLogicalDirection, stripEditorArtifacts, transferArrayItem };
 export type { DragAxis, IDropEvent, IPosition, IResizableOutput, LogicalResizeDirection, ResizeDirection, StripOptions };