directix 1.2.0 → 1.3.0

package/dist/index.d.ts

@@ -39,6 +39,47 @@ export declare interface CapitalcaseOptions {
     onInput?: boolean;
 }
 
+/**
+ * Directive binding value type
+ */
+export declare type ClickDelayBinding = ClickDelayHandler | ClickDelayOptions;
+
+/**
+ * Click delay handler
+ */
+export declare type ClickDelayHandler = (event: MouseEvent | TouchEvent) => void;
+
+/**
+ * Click delay directive options
+ */
+export declare interface ClickDelayOptions {
+    /**
+     * Click handler
+     * @required
+     */
+    handler: ClickDelayHandler;
+    /**
+     * Delay time in milliseconds
+     * @default 300
+     */
+    delay?: number;
+    /**
+     * Whether to disable
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * CSS class to add during delay
+     * @default 'v-click-delay--pending'
+     */
+    pendingClass?: string;
+    /**
+     * Whether to show visual feedback
+     * @default true
+     */
+    feedback?: boolean;
+}
+
 /**
  * Directive binding value type
  */
@@ -137,6 +178,91 @@ export declare interface CopyOptions {
  */
 export declare type CopySuccessCallback = (text: string) => void;
 
+/**
+ * Directive binding value type
+ */
+export declare type CountdownBinding = CountdownOptions | Date | number | string;
+
+/**
+ * Countdown complete callback
+ */
+export declare type CountdownCompleteCallback = () => void;
+
+/**
+ * Countdown format function
+ */
+export declare type CountdownFormatFunction = (time: CountdownTime) => string;
+
+/**
+ * Countdown directive options
+ */
+export declare interface CountdownOptions {
+    /**
+     * Target time (Date object, timestamp, or ISO string)
+     * @required
+     */
+    target: Date | number | string;
+    /**
+     * Format string or custom format function
+     * - 'dd:hh:mm:ss' - Days:Hours:Minutes:Seconds
+     * - 'hh:mm:ss' - Hours:Minutes:Seconds
+     * - 'mm:ss' - Minutes:Seconds
+     * - 'ss' - Seconds only
+     * @default 'hh:mm:ss'
+     */
+    format?: string | CountdownFormatFunction;
+    /**
+     * Callback when countdown completes
+     */
+    onComplete?: CountdownCompleteCallback;
+    /**
+     * Callback on each tick
+     */
+    onTick?: CountdownTickCallback;
+    /**
+     * Update interval in milliseconds
+     * @default 1000
+     */
+    interval?: number;
+    /**
+     * Whether to show milliseconds
+     * @default false
+     */
+    showMilliseconds?: boolean;
+    /**
+     * Whether to auto-start
+     * @default true
+     */
+    autoStart?: boolean;
+    /**
+     * Custom labels for i18n
+     */
+    labels?: {
+        days?: string;
+        hours?: string;
+        minutes?: string;
+        seconds?: string;
+        milliseconds?: string;
+    };
+}
+
+/**
+ * Countdown tick callback
+ */
+export declare type CountdownTickCallback = (time: CountdownTime) => void;
+
+/**
+ * Countdown time object
+ */
+export declare interface CountdownTime {
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+    total: number;
+}
+
 /**
  * Vue 2 directive adapter
  * @returns Vue 2 directive object with bind/inserted/update/unbind hooks
@@ -370,6 +496,40 @@ export declare interface DraggableOptions {
     }, event: MouseEvent | TouchEvent) => void;
 }
 
+/**
+ * Directive binding value type
+ */
+export declare type EllipsisBinding = number | EllipsisOptions;
+
+/**
+ * Ellipsis directive options
+ */
+export declare interface EllipsisOptions {
+    /**
+     * Number of lines to show before truncating
+     * @default 1
+     */
+    lines?: number;
+    /**
+     * Custom ellipsis string
+     * @default '...'
+     */
+    ellipsis?: string;
+    /**
+     * Whether to expand on click
+     * @default false
+     */
+    expandable?: boolean;
+    /**
+     * Title attribute behavior
+     * - 'auto': Show full text as title only when truncated
+     * - 'always': Always show full text as title
+     * - 'none': Don't show title
+     * @default 'auto'
+     */
+    titleBehavior?: 'auto' | 'always' | 'none';
+}
+
 /**
  * Directive binding value type
  */
@@ -420,6 +580,20 @@ export declare function getPermissionConfig(): PermissionConfig | null;
  */
 export declare function getVueVersion(): VueVersion;
 
+export declare type HotkeyBinding = HotkeyHandler | HotkeyDefinition | HotkeyDefinition[] | Record<string, HotkeyHandler | HotkeyDefinition>;
+
+export declare interface HotkeyDefinition {
+    key: string;
+    modifiers?: ModifierKey[];
+    handler: HotkeyHandler;
+    prevent?: boolean;
+    stop?: boolean;
+    disabled?: boolean;
+    global?: boolean;
+}
+
+export declare type HotkeyHandler = (event: KeyboardEvent) => void;
+
 /**
  * Directive binding value type
  */
@@ -671,6 +845,11 @@ export declare function isVue27(): boolean;
  */
 export declare function isVue3(): boolean;
 
+/**
+ * Virtual list item size function
+ */
+export declare type ItemSizeFunction = (index: number) => number;
+
 /**
  * Directive binding value type
  */
@@ -892,6 +1071,8 @@ export declare interface MaskOptions {
     onComplete?: (value: string) => void;
 }
 
+export declare type ModifierKey = 'ctrl' | 'alt' | 'shift' | 'meta';
+
 export declare type MoneyBinding = string | MoneyOptions;
 
 /**
@@ -1046,6 +1227,91 @@ export declare interface PermissionOptions {
     onChange?: (hasPermission: boolean) => void;
 }
 
+/**
+ * Print before callback
+ */
+export declare type PrintBeforeCallback = () => boolean | void;
+
+/**
+ * Directive binding value type
+ */
+export declare type PrintBinding = PrintOptions | boolean;
+
+/**
+ * Print complete callback
+ */
+export declare type PrintCompleteCallback = () => void;
+
+/**
+ * Print directive options
+ */
+export declare interface PrintOptions {
+    /**
+     * Title for the printed document
+     */
+    title?: string;
+    /**
+     * Additional CSS styles to inject
+     */
+    styles?: string | string[];
+    /**
+     * Additional CSS URLs to include
+     */
+    cssUrls?: string[];
+    /**
+     * Callback before printing
+     * Return false to cancel printing
+     */
+    onBeforePrint?: PrintBeforeCallback;
+    /**
+     * Callback after printing
+     */
+    onAfterPrint?: PrintCompleteCallback;
+    /**
+     * Whether to print immediately on mount
+     * @default false
+     */
+    immediate?: boolean;
+    /**
+     * Print target selector
+     * If not specified, prints the element itself
+     */
+    target?: string;
+    /**
+     * Whether to print in a new window
+     * @default false
+     */
+    newWindow?: boolean;
+    /**
+     * Custom class for print container
+     */
+    printClass?: string;
+}
+
+export declare type PullRefreshBinding = PullRefreshHandler | PullRefreshOptions;
+
+export declare type PullRefreshHandler = () => Promise<void> | void;
+
+export declare interface PullRefreshOptions {
+    handler: PullRefreshHandler;
+    distance?: number;
+    maxDistance?: number;
+    disabled?: boolean;
+    indicator?: {
+        idle?: string;
+        pulling?: string;
+        ready?: string;
+        loading?: string;
+        success?: string;
+        error?: string;
+    };
+    successDuration?: number;
+    errorDuration?: number;
+    onStateChange?: (state: PullRefreshState) => void;
+}
+
+export declare type PullRefreshState = 'idle' | 'pulling' | 'ready' | 'loading' | 'success' | 'error';
+
 /**
  * Reset Vue version (useful for testing)
  */
@@ -1330,10 +1596,30 @@ export declare const supportsPassive: () => boolean;
  */
 export declare const supportsResizeObserver: () => boolean;
 
+export declare type SwipeBinding = SwipeHandler | SwipeOptions;
+
+export declare type SwipeDirection = 'left' | 'right' | 'up' | 'down';
+
 /**
  * Swipe direction
  */
-export declare type SwipeDirection = 'left' | 'right' | 'up' | 'down';
+declare type SwipeDirection_2 = 'left' | 'right' | 'up' | 'down';
+
+export declare type SwipeHandler = (direction: SwipeDirection, event: Event) => void;
+
+export declare interface SwipeOptions {
+    handler?: SwipeHandler;
+    threshold?: number;
+    maxTime?: number;
+    directions?: SwipeDirection[];
+    preventScrollOnSwipe?: boolean;
+    disabled?: boolean;
+    mouse?: boolean;
+    onLeft?: () => void;
+    onRight?: () => void;
+    onUp?: () => void;
+    onDown?: () => void;
+}
 
 /**
  * Directive binding value type
@@ -1455,7 +1741,7 @@ export declare interface TouchOptions {
     longPressTimeout?: number;
     /** Enable mouse event simulation for desktop @default true */
     enableMouse?: boolean;
-    onSwipe?: (direction: SwipeDirection, event: TouchEvent | MouseEvent) => void;
+    onSwipe?: (direction: SwipeDirection_2, event: TouchEvent | MouseEvent) => void;
     onSwipeLeft?: (event: TouchEvent | MouseEvent) => void;
     onSwipeRight?: (event: TouchEvent | MouseEvent) => void;
     onSwipeUp?: (event: TouchEvent | MouseEvent) => void;
@@ -1588,6 +1874,31 @@ declare const vCapitalcase: Directive;
 export { vCapitalcase as capitalcase }
 export { vCapitalcase }
 
+/**
+ * v-click-delay directive
+ *
+ * Prevents repeated clicks within a specified time period.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <!-- Basic usage -->
+ *   <button v-click-delay="handleClick">Click Me</button>
+ *
+ *   <!-- With delay time -->
+ *   <button v-click-delay:500="handleClick">Click Me (500ms)</button>
+ *
+ *   <!-- With options -->
+ *   <button v-click-delay="{ handler: handleClick, delay: 1000 }">
+ *     Click Me (1s)
+ *   </button>
+ * </template>
+ * ```
+ */
+declare const vClickDelay: Directive;
+export { vClickDelay as clickDelay }
+export { vClickDelay }
+
 /**
  * v-click-outside directive
  *
@@ -1618,6 +1929,39 @@ declare const vCopy: Directive;
 export { vCopy as copy }
 export { vCopy }
 
+/**
+ * v-countdown directive
+ *
+ * Displays a countdown timer.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <!-- Basic usage -->
+ *   <span v-countdown="targetDate"></span>
+ *
+ *   <!-- With timestamp -->
+ *   <span v-countdown="Date.now() + 60000"></span>
+ *
+ *   <!-- With options -->
+ *   <span v-countdown="{
+ *     target: targetDate,
+ *     format: 'dd:hh:mm:ss',
+ *     onComplete: handleComplete
+ *   }"></span>
+ *
+ *   <!-- With custom format function -->
+ *   <span v-countdown="{
+ *     target: targetDate,
+ *     format: (time) => `${time.days} days ${time.hours}:${time.minutes}:${time.seconds}`
+ *   }"></span>
+ * </template>
+ * ```
+ */
+declare const vCountdown: Directive;
+export { vCountdown as countdown }
+export { vCountdown }
+
 /**
  * v-debounce directive
  *
@@ -1663,6 +2007,31 @@ declare const vDraggable: Directive;
 export { vDraggable as draggable }
 export { vDraggable }
 
+/**
+ * v-ellipsis directive
+ *
+ * Truncates text with ellipsis, supports single and multi-line truncation.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <!-- Single line ellipsis -->
+ *   <p v-ellipsis>Long text here...</p>
+ *
+ *   <!-- Multi-line ellipsis (3 lines) -->
+ *   <p v-ellipsis="3">Long text here...</p>
+ *
+ *   <!-- With options -->
+ *   <p v-ellipsis="{ lines: 2, expandable: true }">
+ *     Click to expand long text...
+ *   </p>
+ * </template>
+ * ```
+ */
+declare const vEllipsis: Directive;
+export { vEllipsis as ellipsis }
+export { vEllipsis }
+
 /**
  * v-focus directive
  *
@@ -1678,6 +2047,10 @@ declare const vFocus: Directive;
 export { vFocus as focus }
 export { vFocus }
 
+declare const vHotkey: Directive;
+export { vHotkey as hotkey }
+export { vHotkey }
+
 /**
  * v-hover directive
  *
@@ -1748,6 +2121,60 @@ declare const vIntersect: Directive;
 export { vIntersect as intersect }
 export { vIntersect }
 
+/**
+ * Directive binding value type
+ */
+export declare type VirtualListBinding<T = any> = VirtualListOptions<T> | T[];
+
+/**
+ * Virtual list directive options
+ */
+export declare interface VirtualListOptions<T = any> {
+    /**
+     * Array of items to render
+     * @required
+     */
+    items: T[];
+    /**
+     * Height of each item (in pixels)
+     * Can be a fixed number or a function
+     * @default 50
+     */
+    itemSize?: number | ItemSizeFunction;
+    /**
+     * Height of the container (in pixels)
+     * @default 400
+     */
+    height?: number | string;
+    /**
+     * Number of extra items to render above/below visible area
+     * @default 3
+     */
+    overscan?: number;
+    /**
+     * Custom render function
+     */
+    render?: VirtualListRenderFunction;
+    /**
+     * Key field name for items
+     * @default 'id'
+     */
+    keyField?: string;
+    /**
+     * Callback when scroll position changes
+     */
+    onScroll?: (scrollTop: number) => void;
+    /**
+     * Callback when visible range changes
+     */
+    onVisibleChange?: (startIndex: number, endIndex: number) => void;
+}
+
+/**
+ * Virtual list render function
+ */
+export declare type VirtualListRenderFunction = (item: any, index: number) => string;
+
 /**
  * Directive binding value type
  */
@@ -1926,6 +2353,38 @@ declare const vPermission: Directive;
 export { vPermission as permission }
 export { vPermission }
 
+/**
+ * v-print directive
+ *
+ * Prints the element content when clicked or immediately.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <!-- Print on click -->
+ *   <button v-print>Print Page</button>
+ *
+ *   <!-- Print specific element -->
+ *   <button v-print="{ target: '#content' }">Print Content</button>
+ *
+ *   <!-- Print with custom title -->
+ *   <button v-print="{ title: 'My Document', styles: 'body { font-size: 12px }' }">
+ *     Print
+ *   </button>
+ *
+ *   <!-- Print immediately on mount -->
+ *   <div v-print="{ immediate: true }">Auto print</div>
+ * </template>
+ * ```
+ */
+declare const vPrint: Directive;
+export { vPrint as print }
+export { vPrint }
+
+declare const vPullRefresh: Directive;
+export { vPullRefresh as pullRefresh }
+export { vPullRefresh }
+
 /**
  * v-resize directive
  *
@@ -2002,6 +2461,10 @@ declare const vSticky: Directive;
 export { vSticky as sticky }
 export { vSticky }
 
+declare const vSwipe: Directive;
+export { vSwipe as swipe }
+export { vSwipe }
+
 /**
  * v-throttle directive
  *
@@ -2125,6 +2588,30 @@ declare const vUppercase: Directive;
 export { vUppercase as uppercase }
 export { vUppercase }
 
+/**
+ * v-virtual-list directive
+ *
+ * Renders a large list efficiently using virtualization.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <div v-virtual-list="{ items: largeList, itemSize: 50 }"></div>
+ *
+ *   <div v-virtual-list="{
+ *     items: largeList,
+ *     itemSize: (index) => index % 10 === 0 ? 100 : 50,
+ *     height: 600,
+ *     overscan: 5,
+ *     render: (item, index) => `<div class="item">${item.name}</div>`
+ *   }"></div>
+ * </template>
+ * ```
+ */
+declare const vVirtualList: Directive;
+export { vVirtualList }
+export { vVirtualList as virtualList }
+
 /**
  * v-visible directive
  *
@@ -2141,4 +2628,108 @@ declare const vVisible: Directive;
 export { vVisible }
 export { vVisible as visible }
 
+/**
+ * v-watermark directive
+ *
+ * Adds a watermark layer to an element.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <!-- Simple watermark -->
+ *   <div v-watermark="'Confidential'">Protected content</div>
+ *
+ *   <!-- Multi-line watermark -->
+ *   <div v-watermark="{ content: ['Company Name', 'User: John'] }">
+ *     Protected content
+ *   </div>
+ *
+ *   <!-- Customized watermark -->
+ *   <div v-watermark="{
+ *     content: 'DRAFT',
+ *     fontSize: 24,
+ *     color: 'rgba(255, 0, 0, 0.2)',
+ *     rotate: -30,
+ *     gap: 50
+ *   }">
+ *     Draft document
+ *   </div>
+ * </template>
+ * ```
+ */
+declare const vWatermark: Directive;
+export { vWatermark }
+export { vWatermark as watermark }
+
+/**
+ * Directive binding value type
+ */
+export declare type WatermarkBinding = string | WatermarkOptions;
+
+/**
+ * Watermark options
+ */
+export declare interface WatermarkOptions {
+    /**
+     * Watermark text content
+     * @required
+     */
+    content: string | string[];
+    /**
+     * Width of watermark canvas
+     * @default 300
+     */
+    width?: number;
+    /**
+     * Height of watermark canvas
+     * @default 200
+     */
+    height?: number;
+    /**
+     * Rotation angle in degrees
+     * @default -22
+     */
+    rotate?: number;
+    /**
+     * Font size in pixels
+     * @default 16
+     */
+    fontSize?: number;
+    /**
+     * Font family
+     * @default 'sans-serif'
+     */
+    fontFamily?: string;
+    /**
+     * Font weight
+     * @default 'normal'
+     */
+    fontWeight?: string | number;
+    /**
+     * Font color
+     * @default 'rgba(128, 128, 128, 0.15)'
+     */
+    color?: string;
+    /**
+     * Gap between watermarks in pixels
+     * @default [100, 100]
+     */
+    gap?: [number, number] | number;
+    /**
+     * Z-index of watermark layer
+     * @default 9999
+     */
+    zIndex?: number;
+    /**
+     * Whether to disable watermark (for dynamic control)
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Whether to prevent removal attempts
+     * @default true
+     */
+    protect?: boolean;
+}
+
 export { }