@zengrid/core 1.0.1

package/dist/src/touch/touch-handler.d.ts

@@ -0,0 +1,167 @@
+import type { CellRef } from '../types';
+import type { EventEmitter } from '../events/event-emitter';
+import type { GridEvents } from '../events/grid-events';
+/**
+ * Touch gesture types
+ */
+export type TouchGesture = 'tap' | 'double-tap' | 'long-press' | 'swipe-left' | 'swipe-right' | 'swipe-up' | 'swipe-down' | 'pinch-zoom' | 'drag';
+/**
+ * Touch handler options
+ */
+export interface TouchHandlerOptions {
+    /**
+     * Grid container element
+     */
+    container: HTMLElement;
+    /**
+     * Event emitter for grid events
+     */
+    events?: EventEmitter<GridEvents>;
+    /**
+     * Callback to get cell at point
+     */
+    getCellAtPoint: (x: number, y: number) => CellRef | null;
+    /**
+     * Callback for tap gesture
+     */
+    onTap?: (cell: CellRef, event: TouchEvent) => void;
+    /**
+     * Callback for double-tap gesture
+     */
+    onDoubleTap?: (cell: CellRef, event: TouchEvent) => void;
+    /**
+     * Callback for long-press gesture
+     */
+    onLongPress?: (cell: CellRef, event: TouchEvent) => void;
+    /**
+     * Callback for drag gesture
+     */
+    onDrag?: (startCell: CellRef, currentCell: CellRef, event: TouchEvent) => void;
+    /**
+     * Double-tap delay (ms)
+     * @default 300
+     */
+    doubleTapDelay?: number;
+    /**
+     * Long-press delay (ms)
+     * @default 500
+     */
+    longPressDelay?: number;
+    /**
+     * Minimum swipe distance (px)
+     * @default 50
+     */
+    minSwipeDistance?: number;
+    /**
+     * Enable pinch zoom
+     * @default true
+     */
+    enablePinchZoom?: boolean;
+    /**
+     * Enable drag to select
+     * @default true
+     */
+    enableDragSelect?: boolean;
+    /**
+     * Prevent default scroll on touch
+     * @default true
+     */
+    preventDefaultScroll?: boolean;
+}
+/**
+ * TouchHandler - Manages touch interactions for mobile devices
+ *
+ * Handles touch gestures:
+ * - Tap: Single touch (cell click)
+ * - Double-tap: Quick double touch (start editing)
+ * - Long-press: Touch and hold (context menu)
+ * - Swipe: Fast directional movement (scroll)
+ * - Pinch zoom: Two-finger zoom
+ * - Drag: Touch and drag (range selection)
+ *
+ * @example
+ * ```typescript
+ * const touchHandler = new TouchHandler({
+ *   container: gridElement,
+ *   getCellAtPoint: (x, y) => hitTester.getCellAtPoint(x, y),
+ *   onTap: (cell) => {
+ *     console.log('Tapped cell:', cell);
+ *   },
+ *   onDoubleTap: (cell) => {
+ *     startEditing(cell);
+ *   },
+ *   onLongPress: (cell) => {
+ *     showContextMenu(cell);
+ *   },
+ * });
+ * ```
+ */
+export declare class TouchHandler {
+    private container;
+    private getCellAtPoint;
+    private onTap?;
+    private onDoubleTap?;
+    private onLongPress?;
+    private onDrag?;
+    private doubleTapDelay;
+    private longPressDelay;
+    private minSwipeDistance;
+    private enablePinchZoom;
+    private enableDragSelect;
+    private preventDefaultScroll;
+    private touchStart;
+    private lastTap;
+    private longPressTimer;
+    private isDragging;
+    private isPinching;
+    constructor(options: TouchHandlerOptions);
+    /**
+     * Attach touch event listeners
+     */
+    private attachEventListeners;
+    /**
+     * Handle touchstart event
+     */
+    private handleTouchStart;
+    /**
+     * Handle touchmove event
+     */
+    private handleTouchMove;
+    /**
+     * Handle touchend event
+     */
+    private handleTouchEnd;
+    /**
+     * Handle touchcancel event
+     */
+    private handleTouchCancel;
+    /**
+     * Handle tap gesture
+     */
+    private handleTapGesture;
+    /**
+     * Handle long-press gesture
+     */
+    private handleLongPress;
+    /**
+     * Handle swipe gesture
+     */
+    private handleSwipeGesture;
+    /**
+     * Cancel long-press timer
+     */
+    private cancelLongPress;
+    /**
+     * Get touch point with cell info
+     */
+    private getTouchPoint;
+    /**
+     * Calculate distance between two touches (for pinch)
+     * TODO: Uncomment when pinch zoom is implemented
+     */
+    /**
+     * Destroy touch handler
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=touch-handler.d.ts.map

package/dist/src/touch/touch-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch-handler.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/touch/touch-handler.ts"],"names":[],"mappings":"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"}

package/dist/src/types/index.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Core type definitions for ZenGrid
+ */
+/**
+ * Reference to a specific cell in the grid
+ */
+export interface CellRef {
+    row: number;
+    col: number;
+}
+/**
+ * A rectangular range of cells
+ */
+export interface CellRange {
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+}
+/**
+ * The currently visible range after virtual scrolling calculation
+ */
+export interface VisibleRange {
+    startRow: number;
+    endRow: number;
+    startCol: number;
+    endCol: number;
+}
+/**
+ * Cell position and dimensions (for absolute positioning)
+ */
+export interface CellPosition {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Sort direction
+ */
+export type SortDirection = 'asc' | 'desc' | null;
+/**
+ * Sort state for a column
+ */
+export interface SortState {
+    column: number;
+    direction: SortDirection;
+    sortIndex?: number;
+}
+/**
+ * Filter operator types
+ */
+export type FilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual' | 'blank' | 'notBlank';
+/**
+ * Filter condition
+ */
+export interface FilterCondition {
+    operator: FilterOperator;
+    value?: any;
+}
+/**
+ * Filter model for a column
+ */
+export interface FilterModel {
+    column: number;
+    conditions: FilterCondition[];
+    logic?: 'AND' | 'OR';
+}
+/**
+ * Column definition
+ */
+export interface ColumnDef {
+    field: string;
+    header: string;
+    width: number;
+    minWidth?: number;
+    maxWidth?: number;
+    resizable?: boolean;
+    sortable?: boolean;
+    filterable?: boolean;
+    editable?: boolean;
+    type?: 'text' | 'number' | 'date' | 'boolean';
+    renderer?: string;
+    editor?: string;
+    formatter?: (value: any) => string;
+    parser?: (value: string) => any;
+}
+/**
+ * Grid configuration options
+ */
+export interface GridOptions {
+    rowCount: number;
+    colCount: number;
+    columns?: ColumnDef[];
+    rowHeight: number | number[];
+    colWidth: number | number[];
+    headerHeight?: number;
+    enableSelection?: boolean;
+    enableMultiSelection?: boolean;
+    enableEditing?: boolean;
+    enableSorting?: boolean;
+    enableFiltering?: boolean;
+    enableKeyboardNavigation?: boolean;
+    enableA11y?: boolean;
+    locale?: string;
+    direction?: 'ltr' | 'rtl';
+    overscanRows?: number;
+    overscanCols?: number;
+    enableCellPooling?: boolean;
+    theme?: string;
+    customCSS?: string;
+    onCellClick?: (cell: CellRef) => void;
+    onCellDoubleClick?: (cell: CellRef) => void;
+    onCellChange?: (cell: CellRef, oldValue: any, newValue: any) => void;
+    onSelectionChange?: (ranges: CellRange[]) => void;
+    onScroll?: (scrollTop: number, scrollLeft: number) => void;
+}
+/**
+ * Grid state (internal)
+ */
+export interface GridState {
+    data: any[][];
+    selection: CellRange[];
+    activeCell: CellRef | null;
+    sortState: SortState[];
+    filterState: FilterModel[];
+    scrollPosition: {
+        top: number;
+        left: number;
+    };
+    editingCell: CellRef | null;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,aAAa,GACb,YAAY,GACZ,UAAU,GACV,aAAa,GACb,UAAU,GACV,oBAAoB,GACpB,iBAAiB,GACjB,OAAO,GACP,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAE1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IAGtB,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAGnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAG1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAG5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IACrE,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;IACd,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,cAAc,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B"}